Merge pull request #23 from pankaj4u4m/cc

Cc

Author: pankaj4u4m

.env.production.example

@@ -8,7 +8,6 @@ ATELIER_REQUIRE_AUTH=true
 ATELIER_API_KEY=replace-me
 ATELIER_SERVICE_URL=http://atelier:8787
 ATELIER_MCP_MODE=remote
-ATELIER_OPENMEMORY_ENABLED=false
 ATELIER_OPENMEMORY_MCP_SERVER_NAME=openmemory
 ATELIER_LESSON_PR_BOT_ENABLED=false
 GITHUB_TOKEN=

.githooks/pre-push

@@ -18,7 +18,7 @@ echo "📍 Checking Pushing $CURRENT_BRANCH to $REMOTE_BRANCH"
 # Skip session import + external reports — those are slow, code-independent, and
 # covered by tests; only host integrations need to be verified at push time.
 echo "🛠️ Running make install (host integrations only)..."
-if ! ATELIER_NO_IMPORT=1 ATELIER_STRICT=1 make install; then
+if ! ATELIER_STRICT=1 make install; then
     echo -e "\033[1;31m❌ make install failed. Push blocked.\033[0m"
     echo "   Fix the install error locally or use 'git push --no-verify' if you intentionally need to bypass the hook."
     exit 1

.gitignore

@@ -58,6 +58,8 @@ coverage.xml
 # Claude Code
 .codex/
 .claude/
+.antigravity/
+.antigravitycli/
 
 # Claude Desktop
 .claude/
@@ -68,9 +70,8 @@ coverage.xml
 # Gemini CLI
 .gemini/
 
-# Github copilot (generated by install, not source)
-.github/copilot-instructions.md*
-.github/chatmodes/
+# Github copilot workspace backups
+.github/copilot-instructions.md.atelier-backup.*
 
 # VSCode test
 .vscode-test/
@@ -141,6 +142,7 @@ results/
 *.sql
 !src/**/*.sql
 *.sqlite3
+vector_cache.sqlite
 dump.rdb
 *.rdb
 

AGENTS.md

@@ -15,9 +15,21 @@ This file is a thin entrypoint. The live source of truth lives in the linked doc
 
 ## Operating loop
 
-1. **Context** - read the relevant source of truth first and use `context` when the Atelier MCP surface is available.
-2. **Implement** - make the change, update directly related docs, and use `route` or `rescue` when needed.
-3. **Record** - record the outcome with `record` or the host alias that exposes the same capability.
+1. **Context** — call `mcp__atelier__context` with `task`, `files`, `domain` before touching any file.
+2. **Implement** — use Atelier tools for ALL file I/O and shell ops (see [Tool substitution](docs/agent-os/tool-substitution.md)). Use `route` to get model recommendations before expensive steps. Use `rescue` on repeated failures.
+3. **Record** — call `mcp__atelier__trace` at completion.
+
+## Tool substitution — mandatory
+
+| Use this | Instead of | Why |
+|---|---|---|
+| `mcp__atelier__read` | `Read` / `Bash(cat ...)` | outline-first, 80-95% fewer tokens on large files |
+| `mcp__atelier__search` | `Grep` / `Glob` / `Bash(grep/rg ...)` | ranked, budget-capped, ~280k tokens saved vs naive scan |
+| `mcp__atelier__edit` | `Edit` / `Write` | atomic multi-file, snapshot/rollback, diff recorded |
+| `mcp__atelier__shell` | `Bash(...)` | ANSI-stripped, line-truncated, token-compact |
+| `mcp__atelier__code op=search` | `Bash(grep -rn symbol ...)` | SCIP-indexed, zero subprocess cost |
+
+**Bash is only for git commands and process management.** Do NOT use `Bash(cat file)`, `Bash(grep ...)`, or `Bash(find ...)` — use the atelier equivalents above.
 
 ## Project-specific invariants
 

Makefile

@@ -33,13 +33,18 @@ uninstall: ## Remove all Atelier agent-host integrations, hooks, and bin wrapper
 status: ## Show Atelier installation status
 	@bash scripts/status.sh
 
-start: ## Start the service and frontend with Docker Compose
-	docker compose up --build -d
-	docker compose logs -f
-restart: ## Restart the service and frontend with Docker Compose
-	docker compose down
-	docker compose up --build -d
-	docker compose logs -f
+start: ## Start the service and frontend natively
+	@if [ -f .env.worktree ]; then set -a; . ./.env.worktree; set +a; fi; \
+	$(ATELIER_CMD) --root "$${ATELIER_STACK_ROOT:-$(ATELIER_STORE)}" stack start
+	@if [ -f .env.worktree ]; then set -a; . ./.env.worktree; set +a; fi; \
+	$(ATELIER_CMD) --root "$${ATELIER_STACK_ROOT:-$(ATELIER_STORE)}" stack logs -f
+restart: ## Restart the service and frontend natively
+	@if [ -f .env.worktree ]; then set -a; . ./.env.worktree; set +a; fi; \
+	$(ATELIER_CMD) --root "$${ATELIER_STACK_ROOT:-$(ATELIER_STORE)}" stack stop --force || true
+	@if [ -f .env.worktree ]; then set -a; . ./.env.worktree; set +a; fi; \
+	$(ATELIER_CMD) --root "$${ATELIER_STACK_ROOT:-$(ATELIER_STORE)}" stack start
+	@if [ -f .env.worktree ]; then set -a; . ./.env.worktree; set +a; fi; \
+	$(ATELIER_CMD) --root "$${ATELIER_STACK_ROOT:-$(ATELIER_STORE)}" stack logs -f
 
 # --------------------------------------------------------------------------- #
 # Development                                                                 #
@@ -107,10 +112,14 @@ pre-commit: format lint typecheck docs-check test ## Format, lint, typecheck, do
 benchmark: ## Run the full benchmark suite
 	LOCAL=1 atelier benchmark full --json
 
-bench-savings: ## Run the context-savings benchmark
-	LOCAL=1 uv run python -m benchmarks.swe.savings_bench --json
+# `bench-savings` (V2) was removed — it was deprecated for measurement and
+	# its percentage claims were not honored. Use `bench-ab` for real A/B numbers
+	# or `bench-savings-honest` for the V3 synthetic replay.
 
-bench-savings-honest: ## Run the V3 honest replay context-savings benchmark
+	bench-ab: ## Real A/B benchmarks: run Atelier tool + native equivalent on the same input, persist deltas to ~/.atelier/savings_calibration.jsonl
+	LOCAL=1 uv run pytest tests/benchmarks/ -v -m ab
+
+	bench-savings-honest: ## V3 honest replay (synthetic corpus, 50 prompts)
 	rm -rf /tmp/atelier-v3-savings-replay
 	ATELIER_ROOT=/tmp/atelier-v3-savings-replay LOCAL=1 uv run python -m benchmarks.swe.savings_replay --csv docs/benchmarks/v3-honest-savings-results.csv
 

README.md

@@ -40,7 +40,7 @@ The installer does four things by default:
 - installs `atelier` and `atelier-mcp` as user-level console commands in `~/.local/bin`
 - initializes the runtime store under `~/.atelier`
 - starts the detached `servicectl` background loop
-- attempts to start the optional visualization stack when Docker is available and `ATELIER_NO_STACK=1` is not set
+- attempts to start the optional visualization stack when npm is available and `ATELIER_NO_STACK=1` is not set
 - installs supported host integrations when the host CLI is found on `PATH`
 
 Check the installed runtime:
@@ -62,7 +62,7 @@ Atelier automatically registers itself with your OS background manager (**system
 - `atelier ...` works with no HTTP server.
 - `atelier-mcp` works with no HTTP server.
 - `atelier background ...` manages the OS-level services (controller + stack).
-- `atelier stack ...` manages the visualization containers manually.
+- `atelier stack ...` manages the optional API + frontend processes manually.
 
 Pure CLI mode still emits Atelier telemetry events unless you disable it with `atelier telemetry off` or `ATELIER_TELEMETRY=0`.
 
@@ -108,7 +108,7 @@ atelier tools call search --dev --args '{"query":"read after write verification"
 
 ## Optional UI Stack
 
-The UI is optional. The installer registers it as a background service by default if Docker is available. You can manage it alongside the controller:
+The UI is optional. The installer registers it as a background service by default when npm is available. You can manage it alongside the controller:
 
 ```bash
 # View logs for the visualization stack
@@ -156,7 +156,7 @@ The installer already attempts host integration when the relevant CLI is present
 - Codex CLI: MCP + AGENTS.md — [docs/hosts/codex-install.md](docs/hosts/codex-install.md)
 - Copilot: MCP + instructions — [docs/hosts/copilot-install.md](docs/hosts/copilot-install.md)
 - opencode: MCP — [docs/hosts/opencode-install.md](docs/hosts/opencode-install.md)
-- Gemini CLI: MCP — [docs/hosts/gemini-cli-install.md](docs/hosts/gemini-cli-install.md)
+- Antigravity: MCP — [docs/hosts/antigravity-install.md](docs/hosts/antigravity-install.md)
 
 → Full host overview: [docs/hosts/all-agent-clis.md](docs/hosts/all-agent-clis.md)
 
@@ -224,7 +224,7 @@ rescue = client.rescue_failure(
 Atelier is a context runtime, not an agent framework and not a general-purpose vector database.
 
 ```text
-Agent Host (Claude Code / Codex / Copilot / opencode / Gemini CLI)
+Agent Host (Claude Code / Codex / Copilot / opencode / Antigravity)
         |
         |  MCP stdio  (or CLI / Python SDK)
         v

docker-compose.yml

@@ -51,7 +51,7 @@ services:
       - "${ATELIER_FRONTEND_PORT:-3125}:3125"
     environment:
       - CHOKIDAR_USEPOLLING=true
-      - VITE_API_URL=${VITE_API_URL:-http://localhost:8787}
+      - VITE_API_URL=${VITE_API_URL:-http://atelier-service:8787}
     volumes:
       - ./frontend:/app
       - /app/node_modules

docs-site/sidebars.ts

@@ -55,7 +55,7 @@ const sidebars: SidebarsConfig = {
         },
         {
           type: "doc",
-          id: "hosts/gemini-cli-install",
+          id: "hosts/antigravity-install",
         },
         {
           type: "doc",

docs/README.md

@@ -57,7 +57,7 @@ Use these when wiring Atelier into an editor or agent CLI:
 | [hosts/copilot-install.md](hosts/copilot-install.md)         | Copilot                                 |
 | [hosts/codex-install.md](hosts/codex-install.md)             | Codex CLI                               |
 | [hosts/opencode-install.md](hosts/opencode-install.md)       | opencode                                |
-| [hosts/gemini-cli-install.md](hosts/gemini-cli-install.md)   | Gemini CLI                              |
+| [hosts/antigravity-install.md](hosts/antigravity-install.md) | Antigravity                             |
 | [integrations/host-matrix.md](integrations/host-matrix.md)   | Install-path and enforcement matrix     |
 
 ## SDK And API

docs/cli.md

@@ -31,7 +31,7 @@ optional visualization stack.
 | `atelier init`           | Initialize the runtime store under `--root`.            |
 | `atelier uninstall`      | Remove Atelier-managed host integrations and wrappers.  |
 | `atelier status`         | Show local plugin, auth, and subscription status.       |
-| `atelier stack ...`      | Start, stop, inspect, or log the optional UI/API stack. |
+| `atelier stack ...`      | Start, stop, inspect, or log the optional native UI/API stack. |
 | `atelier service ...`    | Manage the HTTP/API service surface.                    |
 | `atelier background ...` | Manage OS-level background services and auto-updates.   |
 | `atelier worker ...`     | Inspect, enqueue, and run worker jobs.                  |