@rsaglobaltech/specgate 0.22.0 → 0.22.2

package/README.md

@@ -12,126 +12,111 @@
 
 </div>
 
-> Stop coding before requirements are operationally clear. Every requirement
-> maps to a scenario, a domain artefact, an implementation and a test — and the
-> gate fails when one is missing.
+Specgate keeps what your product must do in the repository, as numbered
+requirements with Gherkin scenarios, next to the code and the tests that prove
+them. A test that mentions a requirement's id (`REQ-007`) is the link, and the
+traceability matrix is generated from those mentions. The gate, `specgate check`,
+fails a pull request when a delivered requirement has no scenario or no test
+that names it, or when your test suite fails.
 
----
+## ⚡ Install
 
-## ⚡ Start
+You need **Node.js 22 or later**.
 
 ```bash
-npm i -g @rsaglobaltech/specgate   # or prefix every command with npx @rsaglobaltech/specgate@latest
-
-cd your-repo                       # or an empty directory
-specgate init                      # adopts the code that is there, touching none of it;
-                                   # scaffolds a new project where there is none
-specgate ci init                   # the gate as a CI job — GitHub, GitLab, Azure or Jenkins,
-                                   # detected from the repository
-specgate check                     # the gate, locally
+npm install --save-dev @rsaglobaltech/specgate   # in a project with a package.json
+npx specgate --help
 ```
 
-Requires **Node.js ≥ 22** — or none with Docker: `docker run --rm -v "$PWD:/workspace" ghcr.io/rsaglobaltech/specgate check`.
-The package is scoped, the binary is not ([ADR-0024](docs/specs/adr/0024-the-tool-is-renamed-the-format-is-not.md)).
+Without installing it (an empty folder, a Java or Python project), prefix each
+command with `npx @rsaglobaltech/specgate@latest` instead of `npx specgate`.
+With Docker and no Node.js: `docker run --rm -v "$PWD:/workspace" ghcr.io/rsaglobaltech/specgate check`.
 
-→ [Getting started](docs/getting-started.md) · [Your team's first pull request](docs/first-pr.md) · [Quickstart for joiners](docs/quickstart.md)
+Then run `init` once:
 
-## 🔁 The daily loop — four verbs
+- **In a repository that has code** (`package.json`, `pom.xml`, `go.mod`, …),
+  `specgate init` adopts it in place: it adds `spec.md`, `features/` and
+  `docs/specs/`, and changes no source file.
+- **In an empty folder**, `npx @rsaglobaltech/specgate@latest init` scaffolds a
+  new specification project. A wizard asks for the project's name, type, stack
+  and test toolchain, then creates it in a new sub-folder named after the
+  project, for example `./my-spec-driven-app/`. `--yes` takes every default
+  without asking. It writes the specification files, not application code.
+
+Step by step, with every output shown: [Getting started](docs/getting-started.md).
+
+## 🔁 The lifecycle — four verbs
 
 ```bash
-specgate propose add-pdf-invoices   # a change: proposal, tasks, a delta to write, REQ ids reserved
-# write REQ-007 and its scenario in the delta, a test that mentions REQ-007, the code
-specgate apply                      # the next requirement through the gate: Implemented when green
-specgate status                     # what is open, and the next command to run
+specgate propose add-pdf-invoices   # open a change: a proposal, a delta to write, REQ ids reserved
+# write REQ-007 and its scenario in the delta, a test that mentions REQ-007, then the code
+specgate apply REQ-007              # refused until a test names it and the gate passes; then Implemented
+specgate status                     # what is left, and the next command to run
 specgate archive add-pdf-invoices   # once every requirement in it is Implemented
 ```
 
-`specgate check` is the same gate for CI ([ADR-0035](docs/specs/adr/0035-four-verbs-one-lifecycle.md)).
-**A change is archived when its code is done**: while it is open its
-requirements already count — `status` lists them, `apply` and `check` judge the
-project as it will be after archive — and `archive` refuses one still pending.
-`apply` refuses a requirement no test names and writes nothing while the gate
-fails. **Mentioning `REQ-NNN` in a test is the link**; the matrix is generated.
-From a plan: `specgate propose --from-brief`. Old names (`draft`, `done`…) keep
-working; everything else is in `specgate --help --all`.
+`specgate check` runs the same gate before a pull request and in CI;
+`specgate ci init` writes the CI job for GitHub, GitLab, Azure or Jenkins.
+You archive a change on its branch, before the pull request, so the spec and
+the code reach review together.
 
-## 🪜 Adopt one level at a time
+## 📥 Where work comes from
 
-Each level is useful on its own and never requires the ones above it.
+Every piece of work enters the same lifecycle. Pick the entry that matches what
+you have:
 
-| Level  | You get                                          | Commands                     | Cost    |
-| ------ | ------------------------------------------------ | ---------------------------- | ------- |
-| **L1** | Traceable specs in your repo                     | `init`, `propose`, `apply`, `archive` | ~1 hour |
-| **L2** | A PR gate enforcing spec and test coverage       | `check`, `ci init`           | ~1 hour |
-| **L3** | Versioned, reusable domain requirements          | `specops add / sync / diff`  | ~1 day  |
-| **L4** | Agent-driven delivery, one requirement at a time | `agents init`, `harness run` | ~1 week |
+| You have | Run | Guide |
+| --- | --- | --- |
+| One behaviour to add or change | `specgate propose <change-id>` | [Propose one change](docs/start/existing-2-specify.md) |
+| A client brief, or a plan for a new product | `specgate propose --from-brief` | [From a client brief](docs/from-a-brief.md) |
+| A Jira story with acceptance criteria | `specgate propose --from-ticket <KEY>` | [From a Jira ticket](docs/from-a-ticket.md) |
 
 ## 🛠️ What it does
 
-**A gate that does not lie.** `specgate check` fails when a delivered
-requirement has no scenario, template steps, no test that mentions it, or
-points at a file that is gone. A Draft owes nothing yet: green on day one,
-stricter with every delivery. Given a test command, it runs your suite too.
-→ [Writing specs](docs/writing-specs.md) · [Validating](docs/validating.md) · [Command reference](docs/commands.md)
-
-**Reviews that read intent.** The reviewer reads the requirement, its
-scenario and the test that names it — the gate has already proved the
-mechanical part. A change is a reviewable delta: only what moves, never a
-copy. It is archived — merged into the spec tree, with its feature files —
-only once every requirement in it passed the gate, in the same pull request.
-→ [Your team's first pull request](docs/first-pr.md) · [Reviewing changes](docs/reviewing-changes.md)
-
-**From a brief, or from OpenSpec.** Save your plan as `docs/brief.md`, run
-`specgate propose --from-brief`: module by module, it briefs your agent and holds
-the draft to eleven rules — scenarios per actor and surface, sourced laws, every
-value in the brief or listed as an assumption, open questions that block, ids each
-actor can reach. Teams on OpenSpec keep it: `specgate verify` fails while
-a change claims a scenario no test names.
-→ [A new project, step by step](docs/new-project.md) · [From a client brief](docs/from-a-brief.md) · [Already on OpenSpec](docs/openspec.md)
-
-**Your agent works the same loop.** `specgate agents init` gives Claude Code, Cursor,
-Copilot, Windsurf, Aider, Gemini, Cline, Codex or Antigravity the loop as slash commands
-(`/specgate:propose`, `/specgate:apply`, …) from one definition. Every daily command speaks
-JSON with stable codes and a `fix` on each. MCP ships in the package: `specgate mcp install --client claude`.
-→ [Agents](docs/agents.md) · [The agent contract](docs/specs/agent-contract.md) · [Automation and MCP](docs/automation.md)
-
-**Domain knowledge as a dependency.** A pack is a versioned, schema-validated
-domain model. Install it, pin it, upgrade it deliberately — and review the
-upgrade as intent with `specops diff --as-change`, not as a file diff.
-→ [Domain packs: 7 proven in the pilots, 11 starter examples](docs/domain-packs.md) · [Supply chain](docs/supply-chain.md)
-
-**Unattended delivery.** `specgate harness run` drives plan → agent → verify →
-apply for every pending requirement, each in its own git worktree; it merges only
-with `--chain`, only what passed the gate. The agent is any shell command with
-`{prompt_file}`; `specgate studio` shows it at work, at `/live`. `specgate alm sync`
-keeps Jira, Azure Boards or GitHub Issues in step.
-→ [The harness](docs/harness.md) · [Jira, Azure Boards and GitHub Issues](docs/alm.md)
-
-**Tested as you install it.** Every release runs an end-to-end suite over every
-command, against the packed tarball, on Linux, macOS and Windows; releases
-since 0.14 come from building real products with it, from brief to running app.
+- **A gate that does not lie.** `check` fails when a delivered requirement has
+  no scenario, no test that names it, or points at a missing file. A `Draft`
+  owes nothing yet, so the gate is green on day one.
+  → [Validating](docs/validating.md)
+- **Reviews that read intent.** A change is a delta: only what moves. The
+  reviewer reads the requirement, its scenario and its test.
+  → [Your team's first pull request](docs/first-pr.md)
+- **Drafts held to their source.** A draft from a brief or a ticket is checked
+  against that text: every value it uses must come from the source or be listed
+  as an assumption. → [From a client brief](docs/from-a-brief.md)
+- **Your agent works the same loop.** `specgate agents init` installs the loop
+  as slash commands for Claude Code, Cursor, Copilot and other agent tools; an
+  MCP server ships in the package. → [Agent tools](docs/agents.md)
+- **Unattended delivery.** `specgate harness run` hands each pending requirement
+  to your coding agent in its own git worktree and keeps only what passes the
+  gate. → [The harness](docs/harness.md)
+- **Domain knowledge as a dependency.** Versioned domain packs install
+  requirements a team has already proved. → [Domain packs](docs/domain-packs.md)
+- **Already on OpenSpec?** `specgate verify` checks what OpenSpec calls done
+  against your tests. → [Already on OpenSpec](docs/openspec.md)
 
 ## 🆚 How it compares
 
-| Capability                             |        **this**        | [OpenSpec](https://github.com/Fission-AI/OpenSpec) | [spec-kit](https://github.com/github/spec-kit) | [Cursor rules](https://docs.cursor.com/context/rules-for-ai) | README only |
-| -------------------------------------- | :--------------------: | :------------------------------------------------: | :--------------------------------------------: | :----------------------------------------------------------: | :---------: |
-| Change lifecycle                       |           ✅           |                         ✅                         |                       ❌                       |                              ❌                              |     ❌      |
-| Versioned domain packs                 |           ✅           |                         ❌                         |                       ⚠️                       |                              ❌                              |     ❌      |
-| Traceability matrix + CI gate          |           ✅           |                         ❌                         |                       ⚠️                       |                              ❌                              |     ❌      |
-| Agent JSON contract                    |           ✅           |                         ✅                         |                       ❌                       |                              ❌                              |     ❌      |
-| Draft checklist from a brief           |           ✅           |                         ❌                         |                       ⚠️                       |                              ❌                              |     ❌      |
-| Proves OpenSpec's "done" against tests |      ✅ `verify`       |                         ❌                         |                       ❌                       |                              ❌                              |     ❌      |
-| Vendor-neutral                         |           ✅           |                         ✅                         |                       ✅                       |                              ❌                              |     ✅      |
-| Commands to learn before the first PR  | ✅ 6 (31 more, opt-in) |                         ✅                         |                       ✅                       |                              ✅                              |     ✅      |
+Specgate does each of the things below. What the closest alternatives cover:
+
+| Capability                    | [OpenSpec](https://github.com/Fission-AI/OpenSpec) | [spec-kit](https://github.com/github/spec-kit) | [Cursor rules](https://docs.cursor.com/context/rules-for-ai) |
+| ----------------------------- | :------------------------------------------------: | :--------------------------------------------: | :----------------------------------------------------------: |
+| Change lifecycle              |                         ✅                         |                       ❌                       |                              ❌                              |
+| Traceability matrix + CI gate |                         ❌                         |                       ⚠️                       |                              ❌                              |
+| Draft checked against a brief |                         ❌                         |                       ⚠️                       |                              ❌                              |
+| Work from Jira tickets        |                         ❌                         |                       ❌                       |                              ❌                              |
+| Versioned domain packs        |                         ❌                         |                       ⚠️                       |                              ❌                              |
+| Vendor-neutral                |                         ✅                         |                       ✅                       |                              ❌                              |
 
-OpenSpec is the closest tool: if you want the change loop without packs or an enforced matrix, it fits better.
-→ [Full matrix, trade-offs and migration paths](docs/comparisons.md)
+OpenSpec is the closest tool: if you want the change loop without an enforced
+gate, it fits better. → [Full comparison](docs/comparisons.md)
 
 ## 📚 Documentation
 
-- [Getting started](docs/getting-started.md) · [Your team's first pull request](docs/first-pr.md) · [Command reference](docs/commands.md)
-- [How-to guides](docs/how-to.md) · [Tutorial](docs/tutorial.md) · [Supply chain](docs/supply-chain.md) · [Architecture](docs/specs/architecture.md)
-- [Case study](docs/case-studies/case-1.md) · [ADRs](docs/specs/adr/README.md) · [Docs site](https://rsaglobaltech.github.io/specgate/) · [Spec coverage report](https://rsaglobaltech.github.io/specgate/report.html)
+- [Getting started](docs/getting-started.md) — install, pick your path, the four verbs
+- [From a Jira ticket](docs/from-a-ticket.md) · [From a client brief](docs/from-a-brief.md)
+- [Concepts](docs/concepts.md) — the ideas and vocabulary behind every command
+- [Commands](docs/commands.md) — every command and flag
+- [FAQ](docs/faq.md) · [Troubleshooting](docs/troubleshooting.md) · [Docs site](https://rsaglobaltech.github.io/specgate/)
 
 ## 🧰 Companion tools
 
@@ -140,8 +125,8 @@ OpenSpec is the closest tool: if you want the change loop without packs or an en
 
 ## 🤝 Contributing
 
-PRs welcome — see [CONTRIBUTING.md](CONTRIBUTING.md) (good first: templates, validator rules,
-domain packs) · [MAINTAINERS.md](MAINTAINERS.md) · [SECURITY.md](SECURITY.md) for private reports.
+PRs welcome — see [CONTRIBUTING.md](CONTRIBUTING.md) · [MAINTAINERS.md](MAINTAINERS.md) ·
+[SECURITY.md](SECURITY.md) for private reports.
 
 ## 📄 License
 

package/dist/packages/core/src/domain/CapabilitySpecMerge.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * Merge a capability spec requirement by requirement (REQ-166).
+ *
+ * Git merges `docs/specs/capabilities/<x>/spec.md` by lines. Two changes
+ * archived on two branches into the same capability — common once work is one
+ * change per ticket — meet as a conflict even when they add different
+ * requirements, and as an add/add conflict when the capability is new on both.
+ * The unit that two branches actually share or not is a requirement: the
+ * `### Requirement: REQ-nnn` heading and everything up to the next one.
+ *
+ * Per requirement, the usual three-way rule: a side that left it as in the
+ * base yields to the side that changed it; two equal changes are one; two
+ * different changes are a conflict on that requirement alone. Requirements are
+ * written in id order. Pure: three texts in, one text out.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requirementBlocks = requirementBlocks;
+exports.mergeCapabilitySpec = mergeCapabilitySpec;
+const HEADING = /^### Requirement: (REQ-[\w.]+)/m;
+function parse(text) {
+    const normal = text.replace(/\r\n/g, "\n");
+    const first = normal.search(HEADING);
+    if (first === -1)
+        return { preamble: normal, blocks: new Map() };
+    const blocks = new Map();
+    for (const part of normal.slice(first).split(/(?=^### Requirement: )/m)) {
+        const id = HEADING.exec(part)?.[1];
+        if (id)
+            blocks.set(id, part.replace(/\n*$/, "\n"));
+    }
+    return { preamble: normal.slice(0, first), blocks };
+}
+/** Each `### Requirement:` block of a capability spec, by id (REQ-168 reads them too). */
+function requirementBlocks(text) {
+    return parse(text).blocks;
+}
+const numeric = (id) => Number(/(\d+)/.exec(id)?.[1] ?? 0);
+/** Three-way choice for one unit; `null` when both sides changed it differently. */
+function choose(base, ours, theirs) {
+    if (ours === theirs)
+        return { value: ours };
+    if (ours === base)
+        return { value: theirs };
+    if (theirs === base)
+        return { value: ours };
+    return null;
+}
+const markers = (ours, theirs) => `<<<<<<< ours\n${ours ?? ""}=======\n${theirs ?? ""}>>>>>>> theirs\n`;
+function mergeCapabilitySpec(base, ours, theirs) {
+    const [b, o, t] = [parse(base), parse(ours), parse(theirs)];
+    if (b.blocks.size + o.blocks.size + t.blocks.size === 0) {
+        return { content: ours, conflicts: [], unparsable: true };
+    }
+    const conflicts = [];
+    // A capability new on both sides has no base: its heading is whichever side wrote one.
+    const pre = choose(b.preamble || undefined, o.preamble || undefined, t.preamble || undefined);
+    let preamble;
+    if (pre)
+        preamble = pre.value ?? "";
+    else if (!b.preamble)
+        preamble = o.preamble || t.preamble;
+    else {
+        preamble = markers(o.preamble, t.preamble);
+        conflicts.push("preamble");
+    }
+    const ids = [...new Set([...b.blocks.keys(), ...o.blocks.keys(), ...t.blocks.keys()])].sort((x, y) => numeric(x) - numeric(y) || x.localeCompare(y));
+    const parts = [];
+    for (const id of ids) {
+        const picked = choose(b.blocks.get(id), o.blocks.get(id), t.blocks.get(id));
+        if (picked) {
+            if (picked.value !== undefined)
+                parts.push(picked.value);
+            continue;
+        }
+        parts.push(markers(o.blocks.get(id), t.blocks.get(id)));
+        conflicts.push(id);
+    }
+    const body = parts.map((p) => p.replace(/\n*$/, "\n")).join("\n");
+    const head = preamble.replace(/\n*$/, "\n\n");
+    return { content: `${head}${body}`, conflicts };
+}
+//# sourceMappingURL=CapabilitySpecMerge.js.map

package/dist/packages/core/src/domain/CapabilitySpecMerge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapabilitySpecMerge.js","sourceRoot":"","sources":["../../../../../packages/core/src/domain/CapabilitySpecMerge.ts"],"names":[],"mappings":"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"}

package/dist/packages/core/test/unit/capability-spec-merge.test.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * The requirement-wise merge of a capability spec (REQ-166).
+ *
+ * Each case is a way two branches meet in `docs/specs/capabilities/<x>/spec.md`
+ * — and a requirement lost without a conflict is the outcome worse than one.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const assert = __importStar(require("node:assert/strict"));
+const CapabilitySpecMerge_1 = require("../../src/domain/CapabilitySpecMerge");
+const req = (n, text = "The system SHALL do it.") => [
+    `### Requirement: REQ-${n} — Rule ${n}`,
+    "",
+    text,
+    "",
+    `#### Scenario: SCN-${n} — Case`,
+    "",
+    "- GIVEN a",
+    "- WHEN b",
+    "- THEN c",
+    "",
+].join("\n");
+const spec = (...blocks) => ["# Owners", "", "## Requirements", "", ...blocks].join("\n");
+const ids = (content) => [...content.matchAll(/^### Requirement: (REQ-\d+)/gm)].map((m) => m[1]);
+(0, node_test_1.test)("REQ-166 SCN-166a: two sides adding to a capability that did not exist merge cleanly, in id order", () => {
+    const result = (0, CapabilitySpecMerge_1.mergeCapabilitySpec)("", spec(req("009")), spec(req("006"), req("007")));
+    assert.deepEqual(result.conflicts, []);
+    assert.deepEqual(ids(result.content), ["REQ-006", "REQ-007", "REQ-009"]);
+    assert.match(result.content, /^# Owners\n\n## Requirements\n\n### Requirement: REQ-006/);
+});
+(0, node_test_1.test)("REQ-166: a change on one side only is taken, the other side untouched", () => {
+    const base = spec(req("006"), req("007"));
+    const ours = spec(req("006", "The system SHALL ignore case."), req("007"));
+    const theirs = spec(req("006"), req("007"), req("008"));
+    const result = (0, CapabilitySpecMerge_1.mergeCapabilitySpec)(base, ours, theirs);
+    assert.deepEqual(result.conflicts, []);
+    assert.match(result.content, /SHALL ignore case/);
+    assert.deepEqual(ids(result.content), ["REQ-006", "REQ-007", "REQ-008"]);
+});
+(0, node_test_1.test)("REQ-166: a requirement removed on one side and untouched on the other is removed", () => {
+    const base = spec(req("006"), req("007"));
+    const result = (0, CapabilitySpecMerge_1.mergeCapabilitySpec)(base, spec(req("006")), base);
+    assert.deepEqual(result.conflicts, []);
+    assert.deepEqual(ids(result.content), ["REQ-006"]);
+});
+(0, node_test_1.test)("REQ-166: the same rewrite on both sides is no conflict", () => {
+    const base = spec(req("009"));
+    const both = spec(req("009", "The system SHALL accept + and 8 to 15 digits."));
+    const result = (0, CapabilitySpecMerge_1.mergeCapabilitySpec)(base, both, both);
+    assert.deepEqual(result.conflicts, []);
+    assert.match(result.content, /8 to 15 digits/);
+});
+(0, node_test_1.test)("REQ-166 SCN-166b: two different rewrites conflict on that requirement alone", () => {
+    const base = spec(req("006"), req("009"));
+    const ours = spec(req("006", "The system SHALL ignore case."), req("009", "International numbers are accepted."));
+    const theirs = spec(req("006"), req("009", "An empty telephone is accepted."));
+    const result = (0, CapabilitySpecMerge_1.mergeCapabilitySpec)(base, ours, theirs);
+    assert.deepEqual(result.conflicts, ["REQ-009"]);
+    assert.match(result.content, /SHALL ignore case/, "the other requirement is merged");
+    const markers = result.content.match(/^<<<<<<< ours$[\s\S]*?^>>>>>>> theirs$/m);
+    assert.ok(markers, result.content);
+    assert.match(markers[0], /International numbers/);
+    assert.match(markers[0], /An empty telephone/);
+    assert.doesNotMatch(markers[0], /REQ-006/);
+});
+(0, node_test_1.test)("REQ-166: a file that is not a capability spec is left to git", () => {
+    const result = (0, CapabilitySpecMerge_1.mergeCapabilitySpec)("a\n", "b\n", "c\n");
+    assert.equal(result.unparsable, true);
+});
+//# sourceMappingURL=capability-spec-merge.test.js.map

package/dist/packages/core/test/unit/capability-spec-merge.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-spec-merge.test.js","sourceRoot":"","sources":["../../../../../packages/core/test/unit/capability-spec-merge.test.ts"],"names":[],"mappings":"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"}

package/dist/packages/mcp-spec-driven/src/native-tools.js

@@ -95,7 +95,7 @@ function assertContractEditable(toolName, projectDir) {
         return;
     throw new Error(toolName +
         " writes files the specification contract protects, and no change is open." +
-        " Open one first: specgate change new <id>." +
+        " Open one first: specgate propose <id>." +
         ' To allow it permanently, set "mcpAllowContractEdits": true in .specgate/config.json.');
 }
 class ProjectHelper {

package/dist/packages/mcp-spec-driven/src/native-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"native-tools.js","sourceRoot":"","sources":["../../../../packages/mcp-spec-driven/src/native-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"native-tools.js","sourceRoot":"","sources":["../../../../packages/mcp-spec-driven/src/native-tools.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBH,sCASC;AAUD,oDAOC;AAGD,wDAQC;AAvDD,4CAA8B;AAC9B,gDAAkC;AAUlC;;;;;;GAMG;AACH,SAAgB,aAAa,CAAC,UAAkB;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,OAAO,EAAE;aACN,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aACzC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,oBAAoB,CAAC,UAAkB;IACrD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC;QACvF,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,qBAAqB,KAAK,IAAI,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,SAAgB,sBAAsB,CAAC,QAAgB,EAAE,UAAkB;IACzE,IAAI,aAAa,CAAC,UAAU,CAAC,IAAI,oBAAoB,CAAC,UAAU,CAAC;QAAE,OAAO;IAC1E,MAAM,IAAI,KAAK,CACb,QAAQ;QACN,2EAA2E;QAC3E,yCAAyC;QACzC,uFAAuF,CAC1F,CAAC;AACJ,CAAC;AAED,MAAM,aAAa;IACV,MAAM,CAAC,gBAAgB,CAAC,UAAmB;QAChD,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,8BAA8B,UAAU,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,2CAA2C,UAAU,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;CACF;AAED,MAAa,YAAY;IACP,IAAI,GAAG,WAAW,CAAC;IACnB,WAAW,GACzB,gFAAgF,CAAC;IACnE,WAAW,GAAG;QAC5B,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;aAC9D;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB,CAAC;IAEK,OAAO,CAAC,IAA6B;QAC1C,MAAM,GAAG,GAAG,aAAa,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;QAElE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC1E,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACjD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;IACzC,CAAC;CACF;AA/BD,oCA+BC;AAED,MAAa,oBAAoB;IACf,IAAI,GAAG,mBAAmB,CAAC;IAC3B,WAAW,GACzB,iFAAiF,CAAC;IACpE,WAAW,GAAG;QAC5B,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;aAC9D;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB,CAAC;IAEM,MAAM,CAAC,QAAQ,GAAG,mBAAmB,CAAC;IACtC,MAAM,CAAC,WAAW,GAAG,4CAA4C,CAAC;IAEnE,OAAO,CAAC,IAA6B;QAC1C,MAAM,GAAG,GAAG,aAAa,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG;YACd,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE;YACpD,EAAE,IAAI,EAAE,4BAA4B,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,4BAA4B,CAAC,EAAE;SAC3F,CAAC;QAEF,MAAM,YAAY,GAAG,IAAI,GAAG,EAGzB,CAAC;QACJ,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC1C,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,oBAAoB,CAAC,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC;gBAC5C,IAAI,KAAK,CAAC;gBACV,OAAO,CAAC,KAAK,GAAG,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;oBACnE,MAAM,EAAE,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;wBAC1B,IAAI,KAAK,GAAG,EAAE,CAAC;wBACf,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;wBAClE,IAAI,YAAY,IAAI,YAAY,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;4BAC3C,KAAK,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;wBACzC,CAAC;6BAAM,CAAC;4BACN,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;4BAC7B,KAAK,GAAG,IAAI;iCACT,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC;iCACtB,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;iCAC1B,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;iCACpB,IAAI,EAAE,CAAC;wBACZ,CAAC;wBACD,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;oBAClE,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACzF,CAAC;IACJ,CAAC;;AA5DH,oDA6DC;AAED,MAAa,sBAAsB;IACjB,IAAI,GAAG,qBAAqB,CAAC;IAC7B,WAAW,GAAG,sDAAsD,CAAC;IACrE,WAAW,GAAG;QAC5B,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;YAC5D,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;YACpE,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sDAAsD;aACpE;YACD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE;SACnF;QACD,QAAQ,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,CAAC;KAC7D,CAAC;IAEK,OAAO,CAAC,IAA6B;QAC1C,MAAM,GAAG,GAAG,aAAa,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5D,4EAA4E;QAC5E,2EAA2E;QAC3E,2EAA2E;QAC3E,4EAA4E;QAC5E,4EAA4E;QAC5E,+BAA+B;QAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,4BAA4B,CAAC,CAAC;QAC/D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,aAAa,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACtD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACnD,yEAAyE;QACzE,uDAAuD;QACvD,IAAI,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CACb,oFAAoF;gBAClF,oEAAoE,CACvE,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QACnD,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QAC1C,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAC7B,2IAA2I,CAC5I,CAAC;QACF,MAAM,GAAG,GAAG,MAAM;YAChB,CAAC,CAAC,KAAK,IAAI,CAAC,WAAW,MAAM,IAAI,CAAC,QAAQ,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,4CAA4C,IAAI,CAAC,MAAM,IAAI;YAClI,CAAC,CAAC,OAAO,IAAI,CAAC,OAAO,QAAQ,IAAI,CAAC,WAAW,MAAM,IAAI,CAAC,QAAQ,IAAI,KAAK,MAAM,IAAI,CAAC,MAAM,IAAI,CAAC;QAEjG,EAAE,CAAC,cAAc,CAAC,SAAS,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;QACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACzC,CAAC;CACF;AA5DD,wDA4DC"}

package/dist/scripts/agents/commands.js

@@ -32,15 +32,15 @@ exports.STEPS = [
         summary: "Turn the plan or brief into requirements, one module at a time.",
         when: "The project starts from a plan or brief (`docs/brief.md`), or the user names a module of it to specify.",
         argumentHint: "<module>",
-        run: ["specgate draft", "specgate draft <module>"],
+        run: ["specgate propose --from-brief", "specgate propose --from-brief <module>"],
         guidance: [
-            "No `docs/brief.md`: show the person what `specgate draft` prints about a brief, and stop — the brief is theirs to write (`specgate draft --new-brief` gives them one to fill in).",
-            "If `specgate draft` says the brief has no front matter, or that it needs fixes: follow `docs/specs/BRIEF-SETUP.md`. Write or fix only the front matter at the top of `docs/brief.md` — never a word below it — run `specgate draft` again, then **stop** and show the front matter to the person to review. Draft no module in the same turn.",
+            "No `docs/brief.md`: show the person what `specgate propose --from-brief` prints about a brief, and stop — the brief is theirs to write (`specgate propose --from-brief --new-brief` gives them one to fill in).",
+            "If `specgate propose --from-brief` says the brief has no front matter, or that it needs fixes: follow `docs/specs/BRIEF-SETUP.md`. Write or fix only the front matter at the top of `docs/brief.md` — never a word below it — run `specgate propose --from-brief` again, then **stop** and show the front matter to the person to review. Draft no module in the same turn.",
             "If the front matter is complete and the brief has no `## Module:` sections: follow `docs/specs/BRIEF-CARDS.md`. Add one section per module — Rules, Examples, Questions — from the brief's own text, keep every line already there, then **stop** and show the sections to the person.",
-            "Before a module is drafted, `specgate draft --check` must report no error: it checks the brief's fields, a section per module, and rules with examples. Its warnings are for the person to judge.",
-            "Without a module, `specgate draft` lists the brief's modules and names the next one. Draft that one.",
-            "`specgate draft <module>` opens the draft and writes `DRAFTING.md` inside it. Follow it exactly: it has the module's section of the brief, the values to use, the reserved ids, the actors and surfaces, and every format the checklist reads.",
-            "Write only inside `docs/specs/changes/draft-<module>/`. Then run `specgate draft <module>` again and fix every finding until it says **Ready to review**.",
+            "Before a module is drafted, `specgate propose --from-brief --check` must report no error: it checks the brief's fields, a section per module, and rules with examples. Its warnings are for the person to judge.",
+            "Without a module, `specgate propose --from-brief` lists the brief's modules and names the next one. Draft that one.",
+            "`specgate propose --from-brief <module>` opens the draft and writes `DRAFTING.md` inside it. Follow it exactly: it has the module's section of the brief, the values to use, the reserved ids, the actors and surfaces, and every format the checklist reads.",
+            "Write only inside `docs/specs/changes/draft-<module>/`. Then run `specgate propose --from-brief <module>` again and fix every finding until it says **Ready to review**.",
             "A `D6_unlisted_value` is a value the brief never gave: use the brief's value, list it in `assumptions.md`, or make it a question. Never invent a business rule — what only the client can decide goes in `questions.md`.",
             "Do not archive. End with the open questions for the person: they review the draft and answer what they can. Then each requirement is built test first and delivered with `specgate apply REQ-NNN`; a person runs `specgate archive draft-<module>` once all of them are applied.",
         ],

package/dist/scripts/agents/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../scripts/agents/commands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../scripts/agents/commands.ts"],"names":[],"mappings":"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"}

package/dist/scripts/agents/detect.js

@@ -60,6 +60,7 @@ const MARKERS = [
     ["cline", [".clinerules"]],
     ["codex", [".codex"]],
     ["antigravity", [".agents"]],
+    ["opencode", [".opencode", "opencode.json", "opencode.jsonc"]],
 ];
 function detectAgents(projectDir) {
     return MARKERS.filter(([tool, files]) => init_1.TOOLS[tool] && files.some((f) => fs.existsSync(path.join(projectDir, f)))).map(([tool]) => tool);

package/dist/scripts/agents/detect.js.map

@@ -1 +1 @@
-{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../../scripts/agents/detect.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBH,oCAIC;AAMD,sDA8BC;AAxDD,4CAA8B;AAC9B,gDAAkC;AAClC,iCAAgD;AAEhD,MAAM,OAAO,GAAsC;IACjD,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACpC,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IACvC,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC,CAAC;IAC9D,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IAC7C,CAAC,OAAO,EAAE,CAAC,iBAAiB,CAAC,CAAC;IAC9B,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACpC,CAAC,OAAO,EAAE,CAAC,aAAa,CAAC,CAAC;IAC1B,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;IACrB,CAAC,aAAa,EAAE,CAAC,SAAS,CAAC,CAAC;CAC7B,CAAC;AAEF,SAAgB,YAAY,CAAC,UAAkB;IAC7C,OAAO,OAAO,CAAC,MAAM,CACnB,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,YAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAC7F,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CACnC,UAAkB,EAClB,IAA0C,EAC1C,GAA0B;IAE1B,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO;IACtB,IAAI,KAAK,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,gEAAgE,CAAC,CAAC;QACtE,GAAG,CAAC,iFAAiF,CAAC,CAAC;QACvF,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAA,sBAAe,EAAC,UAAU,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACzF,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3D,GAAG,CACD,UAAU,MAAM,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,2BAA2B;YAC1F,KAAK,OAAO,CAAC,MAAM,WAAW,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,MAAM,4BAA4B,CAAC,CAAC,CAAC,EAAE,IAAI,CAC1G,CAAC;QACF,GAAG,CAAC,2EAA2E,CAAC,CAAC;IACnF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CACD,0CAA0C,GAAG,IAAK,GAAa,CAAC,OAAO,kCAAkC,CAC1G,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../../scripts/agents/detect.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmBH,oCAIC;AAMD,sDA8BC;AAzDD,4CAA8B;AAC9B,gDAAkC;AAClC,iCAAgD;AAEhD,MAAM,OAAO,GAAsC;IACjD,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACpC,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IACvC,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC,CAAC;IAC9D,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IAC7C,CAAC,OAAO,EAAE,CAAC,iBAAiB,CAAC,CAAC;IAC9B,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACpC,CAAC,OAAO,EAAE,CAAC,aAAa,CAAC,CAAC;IAC1B,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;IACrB,CAAC,aAAa,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC;CAC/D,CAAC;AAEF,SAAgB,YAAY,CAAC,UAAkB;IAC7C,OAAO,OAAO,CAAC,MAAM,CACnB,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,YAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAC7F,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CACnC,UAAkB,EAClB,IAA0C,EAC1C,GAA0B;IAE1B,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO;IACtB,IAAI,KAAK,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,gEAAgE,CAAC,CAAC;QACtE,GAAG,CAAC,iFAAiF,CAAC,CAAC;QACvF,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAA,sBAAe,EAAC,UAAU,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACzF,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3D,GAAG,CACD,UAAU,MAAM,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,2BAA2B;YAC1F,KAAK,OAAO,CAAC,MAAM,WAAW,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,MAAM,4BAA4B,CAAC,CAAC,CAAC,EAAE,IAAI,CAC1G,CAAC;QACF,GAAG,CAAC,2EAA2E,CAAC,CAAC;IACnF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CACD,0CAA0C,GAAG,IAAK,GAAa,CAAC,OAAO,kCAAkC,CAC1G,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/scripts/agents/init.js

@@ -334,6 +334,19 @@ exports.TOOLS = {
         label: "Codex",
         files: () => [{ path: "AGENTS.md", contents: instructionsBody("Agent instructions") }],
     },
+    opencode: {
+        label: "OpenCode",
+        // OpenCode reads AGENTS.md itself; its commands are Markdown files under
+        // `.opencode/commands/`, invoked by file name (`/specgate-draft`), with a
+        // `description` in the front matter and `$ARGUMENTS` for what follows.
+        files: () => [
+            ...commands_1.STEPS.map((s) => ({
+                path: path.join(".opencode", "commands", `${exports.AGENT_NAMESPACE}-${s.name}.md`),
+                contents: slashCommandBody(s).replace(`# /${exports.AGENT_NAMESPACE}:${s.name}`, `# /${exports.AGENT_NAMESPACE}-${s.name}`),
+            })),
+            { path: "AGENTS.md", contents: instructionsBody("Agent instructions") },
+        ],
+    },
     antigravity: {
         label: "Antigravity",
         // Two files, because Antigravity reads both halves of what Specgate offers: