@jeger-ai/opengantry 2.2.2 → 2.2.4

package/README.md

@@ -4,6 +4,8 @@
 
 It is **not** a real-time conversational agent wrapper. Use OpenGantry when you need auditable, mission-scoped repository work with explicit Teacher approval and forensic trace.
 
+> **Not [Gantry.io](https://gantry.io)?** **Open Source Gantry** is the **`gantry` CLI** for **local-first**, **vendor-neutral**, **git-native governance** in your repository — not a hosted observability dashboard. If you are looking for infrastructure monitoring, see [Gantry.io](https://gantry.io).
+
 Use OpenGantry when you need:
 
 - **Agent-assisted product delivery without silent scope creep:** keep velocity while forcing explicit mission scope and path boundaries.
@@ -13,10 +15,21 @@ Use OpenGantry when you need:
 ### What you get in production
 
 - **Review before run:** workers do not complete the loop until a human-approved mission defines scope, gates, and trace rows.
-- **No silent governance edits:** hooks and `gapman verify` fail closed on law, manifest, and mission paths without a Teacher `[MSN-XXXX]` commit.
+- **No silent governance edits:** hooks and `gantry verify` fail closed on law, manifest, and mission paths without a Teacher `[MSN-XXXX]` commit.
 - **Audit in Git:** `git log --grep='MSN-0042'` plus `WORKER_LOG.md` quotes that verifiers must cite verbatim.
 
-**Protocol (implementers):** under the hood, **GXT (Git-native eXecution and Trace)** binds law, Foreman routing, deterministic gates, and trace mapping to `WORKER_LOG.md`. This repository is both the **specimen** and the **template**. Run **`gapman init`** (or **`gapman init --tutorial`**) in your repo and adapt it.
+**Protocol (implementers):** under the hood, **GXT (Git-native eXecution and Trace)** binds law, Foreman routing, deterministic gates, and trace mapping to `WORKER_LOG.md`. This repository is both the **specimen** and the **template**. Run **`gantry init`** (or **`gantry init --tutorial`**) in your repo and adapt it.
+
+## Gantry CLI — local-first governance
+
+**Open Source Gantry** ships as the **Gantry CLI** (`npm install -g @jeger-ai/opengantry`). Governance runs **in your repo** — missions, deterministic gates, and **Gantry Git hook** enforcement (`.githooks/`, IDE hooks) — without routing agent work through a vendor cloud dashboard.
+
+| Goal | Read first |
+|------|------------|
+| **Install + first mission** | [Install](#install) → [`docs/ADOPTION.md`](docs/ADOPTION.md) → [`docs/KATA.md`](docs/KATA.md) |
+| **Gantry CLI command reference** | [gantry CLI](#gantry-cli) |
+| **Git hooks + enforcement** | [Enforcement boundary](#enforcement-boundary) · [`docs/ADOPTION.md`](docs/ADOPTION.md) § Prevent unreviewed edits |
+| **Wire IDE agents** | [`docs/INTEGRATIONS.md`](docs/INTEGRATIONS.md) |
 
 ## Install
 
@@ -24,7 +37,7 @@ Requires **Node.js 24+**.
 
 ```bash
 npm install -g @jeger-ai/opengantry
-gapman init --tutorial
+gantry init --tutorial
 ```
 
 Or without a global install:
@@ -33,7 +46,7 @@ Or without a global install:
 npx @jeger-ai/opengantry init --tutorial
 ```
 
-Developing this repository from source: `npm ci && npm run build` — see [gapman CLI](#gapman-cli) and [`docs/DEVELOPMENT.md`](docs/DEVELOPMENT.md).
+Developing this repository from source: `npm ci && npm run build` — see [gantry CLI](#gantry-cli) and [`docs/DEVELOPMENT.md`](docs/DEVELOPMENT.md).
 
 *Want to see the ROI? Run `npm run examples:benchmark` to compare an orchestrator specimen (improvised agent glue) against OpenGantry's TMVC protocol.* (Requires clone + `npm run build` — see [`docs/ADOPTION.md`](docs/ADOPTION.md).)
 
@@ -41,6 +54,7 @@ Developing this repository from source: `npm ci && npm run build` — see [gapma
 
 | Goal | Read first |
 |------|------------|
+| **Gantry CLI + local governance** | [Gantry CLI — local-first governance](#gantry-cli--local-first-governance) → [gantry CLI](#gantry-cli) |
 | **Adopt in your repo (5 min)** | This README → [`docs/ADOPTION.md`](docs/ADOPTION.md) → [`docs/KATA.md`](docs/KATA.md) |
 | **See benchmark ROI (3 min)** | [`examples/benchmark-agent/`](examples/benchmark-agent/) → [`docs/ADOPTION.md`](docs/ADOPTION.md) |
 | **Wire IDE agents** | [`docs/INTEGRATIONS.md`](docs/INTEGRATIONS.md) |
@@ -54,30 +68,32 @@ Developing this repository from source: `npm ci && npm run build` — see [gapma
 
 | Outcome | How OpenGantry delivers it |
 |---------|---------------------------|
-| **Lower onboarding friction** | `gapman init --tutorial`, `gapman onboarding`, `gapman start "<intent>"`, `gapman status --json` |
+| **Lower onboarding friction** | `gantry init --tutorial`, `gantry onboarding`, `gantry start "<intent>"`, `gantry status --json` |
 | **No unreviewed agent scope** | Teacher reviews mission YAML **before** `runtime env` / worker execution; TMVC roots + forbidden zones enforce paths |
 | **Audit-ready evidence** | `[MSN-XXXX]` commit subjects; verifier PASS requires a verbatim quote from `WORKER_LOG.md` |
 | **Regulated / ISO-aligned workflows** | SOD, mission authorization, and Git-native trace — see [`docs/COMPLIANCE-ISO.md`](docs/COMPLIANCE-ISO.md) (27001 change control, 42001 AI governance) |
-| **Faster recovery from failure** | Stable `GXT_*` error codes, `gapman verify --fix`, role output via `--audience worker\|teacher\|verifier` |
+| **Faster recovery from failure** | Stable `GXT_*` error codes, `gantry verify --fix`, role output via `--audience worker\|teacher\|verifier` |
 
-**Protocol maturity:** substrate law **v0.5.0**; **`gapman` v2.2.2** — Time-to-Scaffold public benchmark, measured LOC matrix. Current npm publish: **v2.2.2**. See [.gitagent/teacher/RUNTIME.md](.gitagent/teacher/RUNTIME.md).
+**Protocol maturity:** substrate law **v0.5.0**; **`gantry` v2.2.4** — unified CLI naming (`gantry` primary; legacy `gapman` alias). Current npm publish: **v2.2.4**. See [.gitagent/teacher/RUNTIME.md](.gitagent/teacher/RUNTIME.md).
 
 ## Release timeline (latest first)
 
-Current npm release in this repository: **`gapman` v2.2.2**. Use [`docs/ADOPTION.md`](docs/ADOPTION.md) for the ordered runbook.
+Current npm release in this repository: **`gantry` v2.2.4**. Use [`docs/ADOPTION.md`](docs/ADOPTION.md) for the ordered runbook.
 
 | Release | Highlights |
 |---------|------------|
+| **v2.2.4** | Unified gantry naming cutover ([#94](https://github.com/jeger-ai/opengantry/issues/94)); docs positioning — Gantry.io disambiguation, long-tail SEO (`Open Source Gantry`, `Gantry CLI`, `Gantry Git hook`), vendor-neutral local governance framing ([#95](https://github.com/jeger-ai/opengantry/issues/95)–[#97](https://github.com/jeger-ai/opengantry/issues/97)) |
+| **v2.2.3** | Declarative `trusted_automation` policy in `.gitagent/config.json` — repository-legislated bot maintenance bypass with `max_net_loc <= 5` ([#92](https://github.com/jeger-ai/opengantry/issues/92)) |
 | **v2.2.2** | Time-to-Scaffold benchmark — `npm run examples:benchmark`, measured LOC matrix, adoption discovery ([#79](https://github.com/jeger-ai/opengantry/issues/79)) |
 | **v2.2.1** | Thermo remediation — unified `NormalizedVerifyFailure` contract across JSON/human/context-feed; race-safe remediation snapshot writes; canonical `verify-presentation` entrypoint |
-| **v2.2.0** | `gapman context-feed`, `gapman audit-rigor`, `virtual_capture` ephemeral virtualization ([#68](https://github.com/jeger-ai/opengantry/issues/68)), product positioning, docs quality ([#66](https://github.com/jeger-ai/opengantry/issues/66)–[#69](https://github.com/jeger-ai/opengantry/issues/69), [#76](https://github.com/jeger-ai/opengantry/issues/76)) |
+| **v2.2.0** | `gantry context-feed`, `gantry audit-rigor`, `virtual_capture` ephemeral virtualization ([#68](https://github.com/jeger-ai/opengantry/issues/68)), product positioning, docs quality ([#66](https://github.com/jeger-ai/opengantry/issues/66)–[#69](https://github.com/jeger-ai/opengantry/issues/69), [#76](https://github.com/jeger-ai/opengantry/issues/76)) |
 | **v2.1.0** | Import-layer Code Surgeon (`check-import-layers.mjs --json`, AST quarantine, `GXT_IMPORT_LAYER_VIOLATION`); workspace-resolved optional TypeScript for surgeons |
-| **v2.0.0** | `gapman scan` + KPI gate, `register`, `check-imports`, `perimeter`; BYO `llm_verifiers`; KPI stale binding on `--pre-push`/`--ci` |
+| **v2.0.0** | `gantry scan` + KPI gate, `register`, `check-imports`, `perimeter`; BYO `llm_verifiers`; KPI stale binding on `--pre-push`/`--ci` |
 | **v1.1.2** | Verify pipeline close-out (MSN-0034–0035); typed verify phases, trace status at parse boundary |
 | **v1.1.1** | Lib/command boundary, unified `runVerifyCore`, typed remediation, CommandReporter, mission YAML emitter |
 | **v1.1.0** | Stale trace evidence, mission purity PR lock, CI target lock, `verify --json`, doctor substrate drift warn |
-| **v1.0.0** | `gapman init --tutorial`, global `--audience` / `GXT_AUDIENCE`, adoption-first README + runbook |
-| **v0.9.0** | `gapman start`, `verify --fix`, `status --json`, `onboarding`, GXT error codes |
+| **v1.0.0** | `gantry init --tutorial`, global `--audience` / `GXT_AUDIENCE`, adoption-first README + runbook |
+| **v0.9.0** | `gantry start`, `verify --fix`, `status --json`, `onboarding`, GXT error codes |
 
 ## What you get
 
@@ -87,10 +103,10 @@ Current npm release in this repository: **`gapman` v2.2.2**. Use [`docs/ADOPTION
 | **Routing map** (skills, roots, forbidden zones, path risks) | [`.gitagent/foreman/MANIFEST.json`](.gitagent/foreman/MANIFEST.json) |
 | **Foreman** (cheap, manifest-only triage) | [`.gitagent/foreman/SOUL.md`](.gitagent/foreman/SOUL.md) |
 | **Worker Runtime Contract** (env exports for IDE agents / scripts) | [`.gitagent/teacher/RUNTIME.md`](.gitagent/teacher/RUNTIME.md) |
-| **Bootstrap** (zero-friction substrate install) | `gapman init` + packaged [`templates/`](templates/) |
+| **Bootstrap** (zero-friction substrate install) | `gantry init` + packaged [`templates/`](templates/) |
 | **Architecture pointer** (where agents find code layout) | [`.gitagent/ARCHITECTURE.pointer.json`](.gitagent/ARCHITECTURE.pointer.json), [ARCHITECTURE-DISCOVERY.md](.gitagent/teacher/ARCHITECTURE-DISCOVERY.md) |
-| **Work order + commit receipt** | YAML via `gapman legislate` + [`.gitagent/teacher/MISSION.example.yaml`](.gitagent/teacher/MISSION.example.yaml); Markdown reference: [`.gitagent/teacher/MISSION.template.md`](.gitagent/teacher/MISSION.template.md), [`.gitagent/teacher/commit-template.md`](.gitagent/teacher/commit-template.md) |
-| **gapman CLI** | `npm install -g @jeger-ai/opengantry` or `npx @jeger-ai/opengantry` — see [gapman](#gapman-cli) |
+| **Work order + commit receipt** | YAML via `gantry legislate` + [`.gitagent/teacher/MISSION.example.yaml`](.gitagent/teacher/MISSION.example.yaml); Markdown reference: [`.gitagent/teacher/MISSION.template.md`](.gitagent/teacher/MISSION.template.md), [`.gitagent/teacher/commit-template.md`](.gitagent/teacher/commit-template.md) |
+| **gantry CLI** | `npm install -g @jeger-ai/opengantry` or `npx @jeger-ai/opengantry` — see [gantry](#gantry-cli) |
 | **Full orientation + workflow diagram** | [`.gitagent/README.md`](.gitagent/README.md) |
 
 Core behaviors in plain language:
@@ -104,9 +120,9 @@ Core behaviors in plain language:
 ## Start here (5 minutes)
 
 ```bash
-gapman init --tutorial    # or: gapman init && gapman onboarding
-gapman teacher set "$(git config user.email)"
-gapman start "Your first change" --msn MSN-0001 --skill-key <manifest-key>
+gantry init --tutorial    # or: gantry init && gantry onboarding
+gantry teacher set "$(git config user.email)"
+gantry start "Your first change" --msn MSN-0001 --skill-key <manifest-key>
 # Teacher: review mission scope/gates, then commit [MSN-0001] including the mission file
 git log --grep='MSN-' --oneline
 ```
@@ -121,29 +137,29 @@ Treat the following as a **portable kit** you can drop into any Git repository (
 
 ### Enforcement boundary
 
-**Prevents unreviewed edits where it matters.** IDE Agent Write/Edit is advisory TMVC; hard boundaries live in `runtime exec`, `gapman verify`, and hooks.
+**Prevents unreviewed edits where it matters.** IDE Agent Write/Edit is advisory TMVC; hard boundaries live in `runtime exec`, `gantry verify`, and hooks.
 
 | Tier | Mechanism | Enterprise control |
 |------|-----------|-------------------|
-| **Process-boundary** | `gapman runtime exec` | Agent cannot touch forbidden paths during orchestrated runs |
+| **Process-boundary** | `gantry runtime exec` | Agent cannot touch forbidden paths during orchestrated runs |
 | **Deterministic hook** | Cursor `beforeShellExecution`, pre-push verify | Shell/hook writes to governance files require mission + verify |
 | **Advisory** | IDE rules, `AGENTS.md`, sessionStart context | IDE suggestions alone do not count as approval |
 
 Per-tool recipes: [`docs/INTEGRATIONS.md`](docs/INTEGRATIONS.md) (see **Enforcement boundary**).
 
-### 1. Bootstrap with `gapman init` (recommended)
+### 1. Bootstrap with `gantry init` (recommended)
 
-From a built OpenGantry tree (or after copying the `gapman` CLI + `templates/` into your toolchain):
+From a built OpenGantry tree (or after copying the `gantry` CLI + `templates/` into your toolchain):
 
 ```bash
-npm ci && npm run build   # in the OpenGantry repo, or use a globally linked gapman
-gapman init --tutorial    # recommended first run; or gapman init (wizard / --yes)
-gapman teacher set "$(git config user.email)"             # repo-local (recommended)
-gapman doctor
+npm ci && npm run build   # in the OpenGantry repo, or use a globally linked gantry
+gantry init --tutorial    # recommended first run; or gantry init (wizard / --yes)
+gantry teacher set "$(git config user.email)"             # repo-local (recommended)
+gantry doctor
 git config core.hooksPath .githooks
 ```
 
-`gapman init` bootstraps a target git repository from packaged templates:
+`gantry init` bootstraps a target git repository from packaged templates:
 
 - **TTY:** interactive wizard (`@clack/prompts`) — select IDE/agent integrations, doc path, skills preset, hooks, CI, architecture pointer.
 - **Non-TTY / CI:** auto-applies default profile (core + Cursor + hooks + CI) — no hang.
@@ -155,7 +171,7 @@ Asset lifecycles:
 - `scaffold_only` files (for example `MANIFEST.json`, `RULES.md`, `skills/*.md`, IDE pointer files) are created when missing and preserved when customized.
 - `managed_strict` runtime assets (workflow, validate script, hooks, schema/rules pointers) prompt before overwrite in an interactive terminal; use `--force` to skip the prompt.
 
-Init also composes **`docs/INTEGRATIONS.md`** (or your chosen path) from `templates/integrations/compatibility.json`, scaffolds **`.gitagent/ARCHITECTURE.pointer.json`**, and installs runtime scripts (`gxt-runtime-env.sh`, `gxt-pin-mission.sh`, …). Store local tokens for protected architecture sources with **`gapman arch cred set`** (stdin only; git-ignored under `.gitagent/history/credentials/`).
+Init also composes **`docs/INTEGRATIONS.md`** (or your chosen path) from `templates/integrations/compatibility.json`, scaffolds **`.gitagent/ARCHITECTURE.pointer.json`**, and installs runtime scripts (`gxt-runtime-env.sh`, `gxt-pin-mission.sh`, …). Store local tokens for protected architecture sources with **`gantry arch cred set`** (stdin only; git-ignored under `.gitagent/history/credentials/`).
 
 After `init`, customize your manifest and skills, then legislate. See [`docs/ADOPTION.md`](docs/ADOPTION.md) for the exact ordered runbook.
 
@@ -165,7 +181,7 @@ After `init`, customize your manifest and skills, then legislate. See [`docs/ADO
   Set `path_risks`, `risk_keywords`, and each skill's `tmvc_roots`, `forbidden_zones`, and `trust_threshold` to match **your** directories and risk appetite.
 - Align **[`.gitagent/teacher/RULES.md`](.gitagent/teacher/RULES.md)** with your review policy (tiers, who counts as "human audit", merge gates).
 - Point **deterministic gates** in missions at **your** stack (`npm test`, `pytest`, `cargo test`, etc.).
-- Store mission files you intend to **`gapman verify`** under **`.gitagent/missions/`** and configure **Teacher allowlist** per repo (`gapman teacher set`, `.gitagent/foreman/TEACHER.allowlist.local`, or `git config gapman.teacherEmails`).
+- Store mission files you intend to **`gantry verify`** under **`.gitagent/missions/`** and configure **Teacher allowlist** per repo (`gantry teacher set`, `.gitagent/foreman/TEACHER.allowlist.local`, or `git config gantry.teacherEmails`).
 
 **Concrete gate example** (YAML fields in a mission file; adjust paths and commands):
 
@@ -174,11 +190,13 @@ gate_command: "npm test -- src/components/Button.test.tsx"
 gate_success_substring: "Tests:       1 passed"
 ```
 
-The gate is whatever command **fails closed** for your repo (lint, typecheck, integration suite). One explicit command beats a vague "run tests somewhere." Primary reference: [`.gitagent/teacher/MISSION.example.yaml`](.gitagent/teacher/MISSION.example.yaml). Markdown missions remain supported (`gapman verify` parses both); [`.gitagent/teacher/MISSION.template.md`](.gitagent/teacher/MISSION.template.md) is a human-readable reference, not the `legislate` default.
+The gate is whatever command **fails closed** for your repo (lint, typecheck, integration suite). One explicit command beats a vague "run tests somewhere." Primary reference: [`.gitagent/teacher/MISSION.example.yaml`](.gitagent/teacher/MISSION.example.yaml). Markdown missions remain supported (`gantry verify` parses both); [`.gitagent/teacher/MISSION.template.md`](.gitagent/teacher/MISSION.template.md) is a human-readable reference, not the `legislate` default.
+
+### gantry CLI
 
-### gapman CLI
+The **Gantry CLI** (`gantry`) is the primary interface for **Open Source Gantry** — local, vendor-neutral, git-native governance in your repository.
 
-Requires **Node.js 24+** (Active LTS line). Published as **`@jeger-ai/opengantry`** on npm; the `gapman` binary is registered via `package.json` `bin` (see [`package.json`](package.json)). From source: `npm ci && npm run build` → `dist/cli/index.js`.
+Requires **Node.js 24+** (Active LTS line). Published as **`@jeger-ai/opengantry`** on npm; the `gantry` binary is registered via `package.json` `bin` (see [`package.json`](package.json)). The legacy `gapman` command remains a compatibility alias. Config namespaces: `GANTRY_*` env vars and `git config gantry.*` (legacy `GAPMAN_*` / `gapman.*` values are still read silently). From source: `npm ci && npm run build` → `dist/cli/index.js`.
 
 **Developing OpenGantry:** dogfood the full stack — [`docs/DEVELOPMENT.md`](docs/DEVELOPMENT.md) (missions, hooks, verify, `npm run validate`). Layer rules: [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md). Adopters: [`docs/ADOPTION.md`](docs/ADOPTION.md). Roadmap: [`docs/BACKLOG.md`](docs/BACKLOG.md) · [Project board](https://github.com/orgs/jeger-ai/projects/2).
 
@@ -186,54 +204,54 @@ Requires **Node.js 24+** (Active LTS line). Published as **`@jeger-ai/opengantry
 
 | Step | Command | Outcome |
 |------|---------|---------|
-| Onboard | `gapman init --tutorial` or `gapman onboarding` | Feel Teacher stamp + verify loop (~3 min) |
-| Scope + approve | `gapman start` → Teacher `[MSN-…]` commit | Unreviewed stub cannot pass full verify |
-| Prove work | `gapman verify` | Gate + log quotes + greppable history |
+| Onboard | `gantry init --tutorial` or `gantry onboarding` | Feel Teacher stamp + verify loop (~3 min) |
+| Scope + approve | `gantry start` → Teacher `[MSN-…]` commit | Unreviewed stub cannot pass full verify |
+| Prove work | `gantry verify` | Gate + log quotes + greppable history |
 
-**Global output:** `gapman --audience worker\|teacher\|verifier\|platform <cmd>` (or `GXT_AUDIENCE=verifier` in CI — silence unless `[GXT_*]` errors).
+**Global output:** `gantry --audience worker\|teacher\|verifier\|platform <cmd>` (or `GXT_AUDIENCE=verifier` in CI — silence unless `[GXT_*]` errors).
 
 | Command | Purpose |
 |--------|---------|
-| `gapman init` | Bootstrap substrate + IDE packs + hooks + CI. `--tutorial` runs guided first loop after scaffold. |
-| `gapman upgrade` | Plan substrate updates (`gapman upgrade plan` / `--dry-run` for preview JSON). Stage with `gapman upgrade`; `gapman upgrade apply --mission …` after Teacher commit. |
-| `gapman check` | Validate `MANIFEST.json` shape + **Rule 4.4** sync: every `manifest.skills` key must have `skills/<key>.md`, with no orphan skill files. |
-| `gapman status` | GXT readiness dashboard (`--json`, `--verbose`, `--audience worker\|teacher\|verifier\|platform`). |
-| `gapman start "<intent>"` | Goal-first orchestration: triage → legislate stub → runtime next steps (`--msn`, `--skill-key`, `--json`). |
-| `gapman onboarding` | Interactive walkthrough of the strict mission loop. Blocks on corrupt configured integration state; allows pristine uninitialized repos. |
-| `gapman doctor` | Active readiness check (manifest, Teacher email, bypass secret match, hooks, architecture pointer, integration staleness). Warnings exit 0. `--audience` tailors next steps. |
-| `gapman triage "<intent>"` | Foreman-style routing ([`SOUL.md`](.gitagent/foreman/SOUL.md)). `--json` for machine output (may include non-binding `adr_hints` from [`.gitagent/out-of-scope/`](.gitagent/out-of-scope/README.md)). `--emit-mission --msn MSN-0007` writes `.gitagent/missions/ACTIVE_MISSION.md` by default on **DIRECT_EXECUTION** only. |
-| `gapman teacher show\|set` | Repo-local Teacher git-proof allowlist (`.gitagent/foreman/TEACHER.allowlist.local`; avoids global `GAPMAN_TEACHER_EMAILS` leaking across projects). |
-| `gapman legislate "<intent>" --msn MSN-0007` | Emit stub **YAML** mission under `.gitagent/missions/` with explicit MSN (`--skill-key` when triage would escalate; `--gate-command` / `--gate-success-substring` for one-click handoff). Teacher still **`git commit`**-legislates from an allowlisted email. |
-| `gapman mission validate --file <path>` | Validate a mission `.md` or `.yaml` (YAML checked against [`.gitagent/teacher/MISSION.schema.yaml`](.gitagent/teacher/MISSION.schema.yaml)). |
-| `gapman mission snapshot --file <path>` | Write start-state JSON under `.gitagent/history/` (git HEAD, branch, dirty flag, manifest hash, hashes of files under the mission skill's `tmvc_roots`). |
-| `gapman runtime env --mission <path>` | Worker Runtime Contract: emit `GXT_REPO_ROOT`, `GXT_MISSION_FILE`, `GXT_MSN_ID`, `GXT_SKILL_KEY`, `GXT_TMVC_ROOTS`, `GXT_FORBIDDEN_ZONES`, `GXT_WORKER_LOG`. Default: POSIX `export …` lines; `--json` for scripts. [.gitagent/teacher/RUNTIME.md](.gitagent/teacher/RUNTIME.md). |
-| `gapman runtime exec --mission <path> -- <cmd…>` | Run worker command with mission env, telemetry capture, and forbidden-zone scan (strongest TMVC trap). |
-| `gapman context-request --path <p…> --reason <text>` | Append a PENDING Context Request to `WORKER_LOG.md` (RULES §4 TMVC expansion). Uses pinned mission or `--mission`. `--stage-worker-log` opt-in stages the log. |
-| `gapman tmvc guard [--strict]` | Pre-commit TMVC path guard: advisory warnings on staged paths outside mission `tmvc_roots` (stderr; exit 0). `--strict` or `GXT_TMVC_GUARD_STRICT=1` blocks. Skips when no pinned mission. |
-| `gapman mcp serve` | Stdio MCP server exposing `gxt_*` tools (legislation, pin, runtime env, verify with `fix_hints`, `gxt_start_orchestration`, exec). `gxt_verify` uses the flat `--json` envelope — see [ADOPTION.md § MCP verify envelope](docs/ADOPTION.md). Configure via `.cursor/mcp.json`. |
-| `gapman verify --mission <path>` | Teacher-approved mission commit + gate + trace. **`--json`** structured output (`status`, `phase`, `error_code`, `fix_hints`). **`--fix`** guided repair; when a **Code Surgeon** applies a quarantine mutation, logs `[SURGEON-MUTATION]` to `WORKER_LOG.md` and reruns full verify with fix disabled (never auto-PASS). CI: `--audience verifier` (errors only). Failures emit **`GXT_*`** codes. Optional **`kpi_gate`** phase reads committed [KPI report](.gitagent/teacher/KPI-REPORT.schema.yaml) (after gate, before trace). **`--ci`** / **`--pre-push`**: fail-closed on stale KPI evidence. |
-| `gapman scan --mission <path>` | Run mission `llm_verifiers` (BYO commands) and write namespaced KPI report JSON for `kpi_gate`. |
-| `gapman register <dir>` | AST discovery: propose skill scope from folder imports/exports (does not mutate `MANIFEST.json`). |
-| `gapman check-imports <dir> --ban <spec…>` | Deterministic banned-import scan (usable as `gate_command`; no LLM). |
-| `gapman perimeter [--base-ref <ref>] [--ci]` | Protected governance paths: local advisory; **`--ci`** requires verified commit signatures. |
-| `gapman arch pointer` | Print architecture pointer summary for agents (`.gitagent/ARCHITECTURE.pointer.json`). |
-| `gapman arch cred status\|set\|unset` | Git-ignored credential slots for authenticated external architecture sources (secrets via stdin only). |
-| `gapman metrics [--json] [--ref main]` | Git-native governance rollup (`--json` includes `gxt_extension_metadata`). See [`docs/ADOPTION.md`](docs/ADOPTION.md). |
-| `gapman context-feed [--json] [--clear]` | Read or atomically clear the latest verify remediation snapshot (`.gitagent/tmp/NEXT_REMEDIATION.json`) for IDE repair loops. |
-| `gapman audit-rigor [--json] [--strict]` | Meta-governance audit: TypeScript strictness, coverage artifacts, MANIFEST wildcard hygiene. |
+| `gantry init` | Bootstrap substrate + IDE packs + hooks + CI. `--tutorial` runs guided first loop after scaffold. |
+| `gantry upgrade` | Plan substrate updates (`gantry upgrade plan` / `--dry-run` for preview JSON). Stage with `gantry upgrade`; `gantry upgrade apply --mission …` after Teacher commit. |
+| `gantry check` | Validate `MANIFEST.json` shape + **Rule 4.4** sync: every `manifest.skills` key must have `skills/<key>.md`, with no orphan skill files. |
+| `gantry status` | GXT readiness dashboard (`--json`, `--verbose`, `--audience worker\|teacher\|verifier\|platform`). |
+| `gantry start "<intent>"` | Goal-first orchestration: triage → legislate stub → runtime next steps (`--msn`, `--skill-key`, `--json`). |
+| `gantry onboarding` | Interactive walkthrough of the strict mission loop. Blocks on corrupt configured integration state; allows pristine uninitialized repos. |
+| `gantry doctor` | Active readiness check (manifest, Teacher email, bypass secret match, hooks, architecture pointer, integration staleness). Warnings exit 0. `--audience` tailors next steps. |
+| `gantry triage "<intent>"` | Foreman-style routing ([`SOUL.md`](.gitagent/foreman/SOUL.md)). `--json` for machine output (may include non-binding `adr_hints` from [`.gitagent/out-of-scope/`](.gitagent/out-of-scope/README.md)). `--emit-mission --msn MSN-0007` writes `.gitagent/missions/ACTIVE_MISSION.md` by default on **DIRECT_EXECUTION** only. |
+| `gantry teacher show\|set` | Repo-local Teacher git-proof allowlist (`.gitagent/foreman/TEACHER.allowlist.local`; avoids global `GANTRY_TEACHER_EMAILS` leaking across projects). |
+| `gantry legislate "<intent>" --msn MSN-0007` | Emit stub **YAML** mission under `.gitagent/missions/` with explicit MSN (`--skill-key` when triage would escalate; `--gate-command` / `--gate-success-substring` for one-click handoff). Teacher still **`git commit`**-legislates from an allowlisted email. |
+| `gantry mission validate --file <path>` | Validate a mission `.md` or `.yaml` (YAML checked against [`.gitagent/teacher/MISSION.schema.yaml`](.gitagent/teacher/MISSION.schema.yaml)). |
+| `gantry mission snapshot --file <path>` | Write start-state JSON under `.gitagent/history/` (git HEAD, branch, dirty flag, manifest hash, hashes of files under the mission skill's `tmvc_roots`). |
+| `gantry runtime env --mission <path>` | Worker Runtime Contract: emit `GXT_REPO_ROOT`, `GXT_MISSION_FILE`, `GXT_MSN_ID`, `GXT_SKILL_KEY`, `GXT_TMVC_ROOTS`, `GXT_FORBIDDEN_ZONES`, `GXT_WORKER_LOG`. Default: POSIX `export …` lines; `--json` for scripts. [.gitagent/teacher/RUNTIME.md](.gitagent/teacher/RUNTIME.md). |
+| `gantry runtime exec --mission <path> -- <cmd…>` | Run worker command with mission env, telemetry capture, and forbidden-zone scan (strongest TMVC trap). |
+| `gantry context-request --path <p…> --reason <text>` | Append a PENDING Context Request to `WORKER_LOG.md` (RULES §4 TMVC expansion). Uses pinned mission or `--mission`. `--stage-worker-log` opt-in stages the log. |
+| `gantry tmvc guard [--strict]` | Pre-commit TMVC path guard: advisory warnings on staged paths outside mission `tmvc_roots` (stderr; exit 0). `--strict` or `GXT_TMVC_GUARD_STRICT=1` blocks. Skips when no pinned mission. |
+| `gantry mcp serve` | Stdio MCP server exposing `gxt_*` tools (legislation, pin, runtime env, verify with `fix_hints`, `gxt_start_orchestration`, exec). `gxt_verify` uses the flat `--json` envelope — see [ADOPTION.md § MCP verify envelope](docs/ADOPTION.md). Configure via `.cursor/mcp.json`. |
+| `gantry verify --mission <path>` | Teacher-approved mission commit + gate + trace. **`--json`** structured output (`status`, `phase`, `error_code`, `fix_hints`). **`--fix`** guided repair; when a **Code Surgeon** applies a quarantine mutation, logs `[SURGEON-MUTATION]` to `WORKER_LOG.md` and reruns full verify with fix disabled (never auto-PASS). CI: `--audience verifier` (errors only). Failures emit **`GXT_*`** codes. Optional **`kpi_gate`** phase reads committed [KPI report](.gitagent/teacher/KPI-REPORT.schema.yaml) (after gate, before trace). **`--ci`** / **`--pre-push`**: fail-closed on stale KPI evidence. |
+| `gantry scan --mission <path>` | Run mission `llm_verifiers` (BYO commands) and write namespaced KPI report JSON for `kpi_gate`. |
+| `gantry register <dir>` | AST discovery: propose skill scope from folder imports/exports (does not mutate `MANIFEST.json`). |
+| `gantry check-imports <dir> --ban <spec…>` | Deterministic banned-import scan (usable as `gate_command`; no LLM). |
+| `gantry perimeter [--base-ref <ref>] [--ci]` | Protected governance paths: local advisory; **`--ci`** requires verified commit signatures. |
+| `gantry arch pointer` | Print architecture pointer summary for agents (`.gitagent/ARCHITECTURE.pointer.json`). |
+| `gantry arch cred status\|set\|unset` | Git-ignored credential slots for authenticated external architecture sources (secrets via stdin only). |
+| `gantry metrics [--json] [--ref main]` | Git-native governance rollup (`--json` includes `gxt_extension_metadata`). See [`docs/ADOPTION.md`](docs/ADOPTION.md). |
+| `gantry context-feed [--json] [--clear]` | Read or atomically clear the latest verify remediation snapshot (`.gitagent/tmp/NEXT_REMEDIATION.json`) for IDE repair loops. |
+| `gantry audit-rigor [--json] [--strict]` | Meta-governance audit: TypeScript strictness, coverage artifacts, MANIFEST wildcard hygiene. |
 
 **Who can approve missions (Teacher allowlist):** only allowlisted identities can legislate missions that verify accepts. Precedence:
 
 1. `.gitagent/foreman/TEACHER.allowlist` (+ optional gitignored `.local` merge)
-2. `git config gapman.teacherEmails "a@x.com,b@y.com"`
-3. `GAPMAN_TEACHER_EMAILS` env (CI escape hatch only)
+2. `git config gantry.teacherEmails "a@x.com,b@y.com"`
+3. `GANTRY_TEACHER_EMAILS` env (CI escape hatch only)
 4. implicit `git config user.email` when nothing else is set
 
-Use **`gapman teacher set "$(git config user.email)"`** after clone — do not rely on a global shell export when you work across multiple projects.
+Use **`gantry teacher set "$(git config user.email)"`** after clone — do not rely on a global shell export when you work across multiple projects.
 
 ### Worker Runtime quickstart
 
-Agents (Cursor, Junie, local scripts) should not guess TMVC roots — read them from **`gapman runtime env`**.
+Agents (Cursor, Junie, local scripts) should not guess TMVC roots — read them from **`gantry runtime env`**.
 
 Each `--mission` path must refer to **an existing mission file** (ENOENT means the YAML or Markdown mission is missing). Split these into separate shell steps if you paste from docs.
 
@@ -250,7 +268,7 @@ node dist/cli/index.js runtime env --mission .gitagent/missions/example.verify.y
 node dist/cli/index.js runtime exec --mission .gitagent/missions/example.verify.yaml -- <your-agent-command>
 ```
 
-Inspect `GXT_TMVC_ROOTS`, `GXT_FORBIDDEN_ZONES`, and `GXT_WORKER_LOG`; write forensic trace quotes to **`WORKER_LOG.md`** (or `--worker-log` at verify time), then **`gapman verify`** as usual.
+Inspect `GXT_TMVC_ROOTS`, `GXT_FORBIDDEN_ZONES`, and `GXT_WORKER_LOG`; write forensic trace quotes to **`WORKER_LOG.md`** (or `--worker-log` at verify time), then **`gantry verify`** as usual.
 
 **Legislate a stub mission (Teacher edits + commits — then wire `runtime env` to that file path):**
 
@@ -264,16 +282,16 @@ Details and variable semantics: [.gitagent/teacher/RUNTIME.md](.gitagent/teacher
 
 ### 3. Wire agents (and optionally CI)
 
-- **[`docs/INTEGRATIONS.md`](docs/INTEGRATIONS.md)** — closed-loop agent integrations (enforcement boundary, remote handoff, per-tool recipes for Cursor, Claude Code, OpenAI Codex CLI, OpenCode, Junie, Antigravity, Cline, Aider, OpenHands). Installed by `gapman init`.
+- **[`docs/INTEGRATIONS.md`](docs/INTEGRATIONS.md)** — closed-loop agent integrations (enforcement boundary, remote handoff, per-tool recipes for Cursor, Claude Code, OpenAI Codex CLI, OpenCode, Junie, Antigravity, Cline, Aider, OpenHands). Installed by `gantry init`.
 - **[`AGENTS.md`](AGENTS.md)** tells agents to read **RULES** + **MANIFEST** before acting.
 - **[`.cursor/rules/opengantry-gxt-substrate.mdc`](.cursor/rules/opengantry-gxt-substrate.mdc)** does the same for Cursor with `alwaysApply: true`.
 - **CI:** this repo includes **[`.github/workflows/gxt-validate.yml`](.github/workflows/gxt-validate.yml)**:
   - **PR governance (PR only):** mission PRs must target the **default branch** (`main` in this repo; `github.event.repository.default_branch` in init template, overridable via `GXT_INTEGRATION_BRANCH`) — prevents stacked mission merges.
-  - **gapman:** `npm ci` / `npm run build`, then `gapman check`, `gapman doctor`, and unit tests.
+  - **gantry:** `npm ci` / `npm run build`, then `gantry check`, `gantry doctor`, and unit tests.
   - **Manifest (jq parity):** validates [`.gitagent/foreman/MANIFEST.json`](.gitagent/foreman/MANIFEST.json) via [`scripts/validate-gxt.sh`](scripts/validate-gxt.sh) `manifest`.
   - **Changed-code quality (PR only):** ESLint complexity, import layers, line budgets on touched `src/cli/**/*.ts`.
   - **MSN (PR only, path-scoped):** on **pull_request** only, any **non-merge** commit in the PR range that touches `.gitagent/`, repo-root `WORKER_LOG.md`, `.githooks/`, or [`.github/workflows/gxt-validate.yml`](.github/workflows/gxt-validate.yml) must have a subject starting with **`[MSN-NNNN]`** (four digits). Other paths (e.g. root `README.md` only) do not trigger this check.
-  - **Mission purity (PR only):** [`scripts/verify-pr-missions.sh`](scripts/verify-pr-missions.sh) requires exactly one `[MSN-NNNN]` in `${base}..${head}` commit subjects before full `gapman verify` on changed missions.
+  - **Mission purity (PR only):** [`scripts/verify-pr-missions.sh`](scripts/verify-pr-missions.sh) requires exactly one `[MSN-NNNN]` in `${base}..${head}` commit subjects before full `gantry verify` on changed missions.
 - **Local (full stack):** [`scripts/dev-validate.sh`](scripts/dev-validate.sh) / `npm run validate` — superset of CI (includes changed-code + MSN vs `origin/main`).
 
 ```bash
@@ -294,10 +312,10 @@ Details and the workflow diagram: **[`.gitagent/README.md`](.gitagent/README.md)
 
 ### Advanced: manual vendoring
 
-If you cannot run `gapman init`, copy at least:
+If you cannot run `gantry init`, copy at least:
 
 - `.gitagent/` (entire tree)
-- `skills/` (optional in minimal vendoring, but **required** for Rule 4.4: one `skills/<skill-key>.md` per manifest skill — enforced by `gapman check`)
+- `skills/` (optional in minimal vendoring, but **required** for Rule 4.4: one `skills/<skill-key>.md` per manifest skill — enforced by `gantry check`)
 - `.githooks/` (optional: creates an empty repo-root `WORKER_LOG.md` when you check out a feature branch)
 - `AGENTS.md` (or merge its bullets into your existing agent instructions)
 - Optionally `.cursor/rules/opengantry-gxt-substrate.mdc` if you use Cursor
@@ -317,10 +335,10 @@ Add to your **`.gitignore`** (if not already present):
 
 ```bash
 npm install @jeger-ai/opengantry@latest
-gapman upgrade
+gantry upgrade
 # Review .gitagent/.upgrade-tmp/; Teacher-commit the upgrade mission YAML
-gapman upgrade --apply --mission .gitagent/missions/MSN-9001.upgrade-vX.Y.Z.yaml
-gapman doctor
+gantry upgrade --apply --mission .gitagent/missions/MSN-9001.upgrade-vX.Y.Z.yaml
+gantry doctor
 ```
 
 See [`docs/ADOPTION.md`](docs/ADOPTION.md) and [`docs/DEVELOPMENT.md`](docs/DEVELOPMENT.md#substrate-upgrade-loop-adopters--dogfood).
@@ -360,7 +378,8 @@ Always **review the diff** before commit; never bulk-overwrite a customized `MAN
 
 | Pattern | Typical shape | Audit / production readiness |
 |---------|----------------|------------------------------|
-| **GXT / OpenGantry** | Git-native missions, manifest routing, deterministic gates, auditable log mapped to **`WORKER_LOG.md`**, human `[MSN-XXXX]` approval + SOD ([`RULES.md`](.gitagent/teacher/RULES.md)) | **Autonomous Repository Engineering** — scoped missions, not always-on chat. Greppable missions + gate output + log quotes. |
+| **GXT / OpenGantry** | Git-native missions, manifest routing, deterministic gates, auditable log mapped to **`WORKER_LOG.md`**, human `[MSN-XXXX]` approval + SOD ([`RULES.md`](.gitagent/teacher/RULES.md)) | **Autonomous Repository Engineering** — scoped missions, not always-on chat. Greppable missions + gate output + log quotes. **Local-first**, **vendor-neutral** governance engine in your repo. |
+| Cloud observability / agent dashboards | Hosted UI for metrics, traces, or agent session visibility | Strong for **fleet visibility**; per-repo change authorization and Git-native audit artifacts are typically layered separately |
 | Agent "swarm" / choreography layers | Orchestrates model calls across services; emphasizes throughput and parallelism | Strong on **coverage** of tasks; lineage and per-change evidence depends on tooling above the swarm |
 | Unstructured desktop assistants | Reactive help in-editor or OS-wide; informal plans | Lightweight for exploration; weakest default for **reproducible** production sign-off without additional discipline |
 
@@ -368,7 +387,7 @@ GXT deliberately trades "always-on improvisation" for a **narrow, inspectable en
 
 ## Relationship to this repository
 
-**jeger-ai/opengantry** is the **canonical reference tree** for **GXT** (manifest `schema_version` **v0.5.0** law + **`gapman` v2.2.2** CLI). Install the CLI with `npm install -g @jeger-ai/opengantry`, or fork this repo and run `gapman init` in your project.
+**jeger-ai/opengantry** is the **canonical reference tree** for **GXT** (manifest `schema_version` **v0.5.0** law + **`gantry` v2.2.4** CLI). Install the CLI with `npm install -g @jeger-ai/opengantry`, or fork this repo and run `gantry init` in your project.
 
 ## Security
 

package/dist/cli/commands/arch.js

@@ -8,7 +8,7 @@ export function runArchPointer(options = {}) {
         repoRoot = getRepoRoot(options.cwd);
     }
     catch (e) {
-        logError(e instanceof Error ? e.message.replace("gapman: ", "") : String(e));
+        logError(e instanceof Error ? e.message.replace("gantry: ", "") : String(e));
         setExitCode(2);
         return;
     }
@@ -44,7 +44,7 @@ export async function runArchCredSet(options) {
     try {
         const values = parseCredentialValuesFromStdin(options.kind, stdin);
         writeArchitectureCredential(repoRoot, options.slot, options.kind, values);
-        logInfo(`gapman arch cred: stored slot=${options.slot} kind=${options.kind}`);
+        logInfo(`gantry arch cred: stored slot=${options.slot} kind=${options.kind}`);
     }
     catch (e) {
         logError(errorMessage(e));
@@ -63,11 +63,11 @@ export function runArchCredUnset(options) {
         return;
     }
     if (!removeArchitectureCredential(repoRoot, options.slot)) {
-        logError(`gapman arch cred: slot ${options.slot} not found`);
+        logError(`gantry arch cred: slot ${options.slot} not found`);
         setExitCode(2);
         return;
     }
-    logInfo(`gapman arch cred: removed slot=${options.slot}`);
+    logInfo(`gantry arch cred: removed slot=${options.slot}`);
 }
 export function runArchCredStatus(options = {}) {
     let repoRoot;

package/dist/cli/commands/check-imports.js

@@ -3,7 +3,7 @@ import { logError, setExitCode } from "../lib/cli-io.js";
 import { loadWorkspace } from "../lib/workspace.js";
 export function runCheckImports(options) {
     if (options.ban.length === 0) {
-        logError("gapman check-imports: provide at least one --ban specifier");
+        logError("gantry check-imports: provide at least one --ban specifier");
         setExitCode(2);
         return;
     }

package/dist/cli/commands/onboarding.js

@@ -23,7 +23,7 @@ async function resolveOnboardingMissionPath(p, root, intent) {
         logInfo(`  ${onboardingVerifyHint(EXAMPLE_MISSION)}`);
         return { missionPath, useExample };
     }
-    p.log.step("Step 3 — Scaffold mission (gapman start)");
+    p.log.step("Step 3 — Scaffold mission (gantry start)");
     const result = runStartOrchestration({
         intent: intent.trim(),
         writeMission: true,
@@ -59,7 +59,7 @@ export async function runOnboarding(options = {}) {
     const { root } = loadWorkspace();
     const manifestPath = path.join(root, ".gitagent", "foreman", "MANIFEST.json");
     if (!fs.existsSync(manifestPath)) {
-        logError("Run gapman init first — substrate not found.");
+        logError("Run gantry init first — substrate not found.");
         setExitCode(2);
         p.outro("Onboarding aborted");
         return;
@@ -74,7 +74,7 @@ export async function runOnboarding(options = {}) {
         p.log.step("Integration health");
         for (const msg of blockers)
             logWarn(`  ${msg}`);
-        logError("Integration issues detected — run gapman doctor or pass --force to continue.");
+        logError("Integration issues detected — run gantry doctor or pass --force to continue.");
         setExitCode(2);
         p.outro("Onboarding aborted (integration gates)");
         return;
@@ -88,8 +88,8 @@ export async function runOnboarding(options = {}) {
         return;
     }
     p.log.step("Step 1 — Teacher allowlist");
-    logInfo('  gapman teacher set "$(git config user.email)"');
-    p.log.step("Step 2 — Declare intent (gapman start)");
+    logInfo('  gantry teacher set "$(git config user.email)"');
+    p.log.step("Step 2 — Declare intent (gantry start)");
     const intent = await p.text({
         message: "What do you want to build?",
         placeholder: "Fix login spinner on checkout",

package/dist/cli/commands/perimeter.js

@@ -36,10 +36,10 @@ export function runPerimeter(options) {
             return;
         }
         if (result.violations.length > 0 && options.ci !== true) {
-            logInfo("gapman perimeter: advisory-only mode — no hard failures locally");
+            logInfo("gantry perimeter: advisory-only mode — no hard failures locally");
         }
         else {
-            logInfo("gapman perimeter: OK");
+            logInfo("gantry perimeter: OK");
         }
     }
     catch (e) {

package/dist/cli/commands/runtime.js

@@ -31,7 +31,7 @@ export function runRuntimeEnv(options) {
     catch (e) {
         const errno = typeof e === "object" && e !== null ? e.code : undefined;
         if (errno === "ENOENT") {
-            logError(`runtime env: mission file not found: ${options.mission} (ENOENT). Use an existing mission path — e.g. .gitagent/missions/example.verify.yaml — or run gapman legislate first, then pass that YAML path.`);
+            logError(`runtime env: mission file not found: ${options.mission} (ENOENT). Use an existing mission path — e.g. .gitagent/missions/example.verify.yaml — or run gantry legislate first, then pass that YAML path.`);
         }
         else {
             logError(errorMessage(e));

package/dist/cli/commands/scan.js

@@ -4,7 +4,7 @@ import { logError, logInfo, setExitCode } from "../lib/cli-io.js";
 import { loadWorkspace } from "../lib/workspace.js";
 export function runScan(options) {
     if (!options.mission) {
-        logError("gapman scan: --mission is required");
+        logError("gantry scan: --mission is required");
         setExitCode(2);
         return;
     }
@@ -16,7 +16,7 @@ export function runScan(options) {
             process.stdout.write(`${JSON.stringify({ status: "ok", report_path: result.reportPath, report: result.report }, null, 2)}\n`);
             return;
         }
-        logInfo(`gapman scan: wrote ${result.reportPath}`);
+        logInfo(`gantry scan: wrote ${result.reportPath}`);
         logInfo(`metrics: ${Object.keys(result.report.metrics).length}`);
     }
     catch (e) {

package/dist/cli/commands/teacher.js

@@ -19,7 +19,7 @@ export function runTeacherShow(options = {}) {
     }
     if (resolved.emails.length === 0) {
         logInfo(`${CLI_NAME} teacher: no allowlist configured`);
-        logInfo(`  Run: gapman teacher set "$(git config user.email)"`);
+        logInfo(`  Run: gantry teacher set "$(git config user.email)"`);
         return;
     }
     logInfo(`${CLI_NAME} teacher: ${resolved.emails.join(", ")}`);

package/dist/cli/commands/verify.js

@@ -33,12 +33,12 @@ async function runVerifyChangedMissions(options) {
     const baseRef = resolveChangedMissionsBaseRef(root, options.baseRef);
     const missions = discoverChangedMissionFiles(root, baseRef);
     if (missions.length === 0) {
-        logInfo(`gapman verify: no changed mission files vs ${baseRef}`);
+        logInfo(`gantry verify: no changed mission files vs ${baseRef}`);
         return;
     }
     let worstExit = 0;
     for (const mission of missions) {
-        logInfo(`gapman verify: ${mission} (changed vs ${baseRef})`);
+        logInfo(`gantry verify: ${mission} (changed vs ${baseRef})`);
         const result = await runVerifyCore({ ...options, mission, changedMissions: false });
         if (!result.ok && result.exitCode > worstExit) {
             worstExit = result.exitCode;
@@ -78,7 +78,7 @@ export async function runVerify(options) {
         return;
     }
     if (!options.mission) {
-        logError("gapman verify: --mission is required (or use --changed-missions)");
+        logError("gantry verify: --mission is required (or use --changed-missions)");
         setExitCode(2);
         return;
     }

package/dist/cli/lib/architecture-credential.js

@@ -6,7 +6,7 @@ const SLOT_PATTERN = /^[a-z0-9][a-z0-9/_-]{0,63}$/;
 const VALID_KINDS = new Set(["bearer", "api_key", "basic", "custom"]);
 export function parseArchitectureCredentialKind(raw) {
     if (!VALID_KINDS.has(raw)) {
-        throw new Error(`gapman arch cred: kind must be one of ${[...VALID_KINDS].join(", ")}`);
+        throw new Error(`gantry arch cred: kind must be one of ${[...VALID_KINDS].join(", ")}`);
     }
     return raw;
 }

package/dist/cli/lib/architecture-pointer.js

@@ -132,7 +132,7 @@ export function validateArchitecturePointer(raw) {
 export function loadArchitecturePointer(repoRoot) {
     const abs = architecturePointerPath(repoRoot);
     if (!fs.existsSync(abs)) {
-        throw new Error(`${REL_ARCHITECTURE_POINTER} missing — run gapman init or add the pointer manually`);
+        throw new Error(`${REL_ARCHITECTURE_POINTER} missing — run gantry init or add the pointer manually`);
     }
     let parsed;
     try {

package/dist/cli/lib/ast-discovery.js

@@ -44,7 +44,7 @@ function walkTypeScriptFiles(absDir) {
 export function discoverFolderSignature(repoRoot, targetDir) {
     const absDir = path.isAbsolute(targetDir) ? targetDir : path.join(repoRoot, targetDir);
     if (!fs.existsSync(absDir) || !fs.statSync(absDir).isDirectory()) {
-        throw new Error(`gapman register: not a directory: ${targetDir}`);
+        throw new Error(`gantry register: not a directory: ${targetDir}`);
     }
     const folderRel = toPosixRel(repoRoot, absDir);
     const allImports = new Set();

package/dist/cli/lib/audience-output.js

@@ -36,23 +36,23 @@ export function formatAudienceNextStep(step, audience) {
     return step;
 }
 const DEFAULT_NEXT_STEPS = [
-    { audience: "teacher", step: 'gapman legislate "<intent>" --msn MSN-0001 --skill-key <key>' },
+    { audience: "teacher", step: 'gantry legislate "<intent>" --msn MSN-0001 --skill-key <key>' },
     { audience: "teacher", step: "Teacher: git commit -m \"[MSN-0001] legislate …\" including mission file" },
-    { audience: "worker", step: "eval \"$(gapman runtime env --mission .gitagent/missions/<file>.yaml)\"" },
+    { audience: "worker", step: "eval \"$(gantry runtime env --mission .gitagent/missions/<file>.yaml)\"" },
     { audience: "worker", step: "Append gate evidence to WORKER_LOG.md" },
-    { audience: "verifier", step: "gapman verify --mission .gitagent/missions/<file>.yaml" },
-    { audience: "platform", step: "git config core.hooksPath .githooks && gapman doctor" },
+    { audience: "verifier", step: "gantry verify --mission .gitagent/missions/<file>.yaml" },
+    { audience: "platform", step: "git config core.hooksPath .githooks && gantry doctor" },
 ];
 function stepMatchesAudience(step, audience) {
     switch (audience) {
         case "teacher":
             return /legislate|Teacher:|git commit -m "\[MSN-/i.test(step);
         case "worker":
-            return /runtime env|WORKER_LOG|gate evidence|eval "\$\(gapman runtime|execute worker/i.test(step);
+            return /runtime env|WORKER_LOG|gate evidence|eval "\$\(gantry runtime|execute worker/i.test(step);
         case "verifier":
-            return /gapman verify/i.test(step);
+            return /gantry verify/i.test(step);
         case "platform":
-            return /hooksPath|gapman doctor|gapman init/i.test(step);
+            return /hooksPath|gantry doctor|gantry init/i.test(step);
         default: {
             const _exhaustive = audience;
             return _exhaustive;