@esneiderbravo/speclaw 1.0.1 → 2.0.1

package/dist/modules/foundation/assets/workflows/speclaw.yml

@@ -18,7 +18,7 @@ jobs:
         with:
           fetch-depth: 0
       - name: ⚖️ Verify
-        uses: esneiderbravo/speclaw@v1
+        uses: esneiderbravo/speclaw@v2
       - name: 🛡️ Upload SARIF
         uses: github/codeql-action/upload-sarif@v4
         if: always()

package/dist/modules/foundation/context-budget.js

@@ -1,4 +1,5 @@
 import { registerCompass } from "../compass/register.js";
+import { registerCortex } from "../cortex/register.js";
 import { registerSpec } from "../lawbook/register.js";
 import { registerTools } from "../tools/register.js";
 import { registerFoundationCore } from "./register-core.js";
@@ -25,6 +26,7 @@ export function collectRegisteredTools(minimal) {
     registerFoundationCore(stub, opts);
     registerSpec(stub, opts);
     registerCompass(stub, opts);
+    registerCortex(stub, opts);
     registerTools(stub, opts);
     return tools;
 }

package/dist/modules/foundation/setup-tool.js

@@ -64,12 +64,13 @@ export function handleSpeclawSetup(args) {
             return {
                 instructions: [
                     "1. Analyze the repository at projectPath and fill profile fields from the real codebase.",
-                    "2. Call speclaw_setup with action configure-agent / add-pack as needed.",
+                    "2. Call speclaw_setup with action configure-agent as needed (packs catalog may be empty).",
                     "3. Run lawbook_change action init and compass_index when scaffold completes via CLI if needed.",
+                    "4. Non-trivial work uses Cortex: cortex skill / speclaw cortex (MCP tool cortex).",
                 ],
                 profileFields: profileFieldHelp,
                 packs: loadPacks(),
-                note: "Full scaffold runs via CLI: speclaw init — not MCP.",
+                note: "Full scaffold runs via CLI: speclaw init — not MCP. Role agents install with the lawbook workflow.",
             };
         case "configure-agent": {
             if (!args.agent)

package/dist/modules/lawbook/assets/agents/archiver.md

@@ -0,0 +1,19 @@
+---
+name: archiver
+description: Reconcile specs, sync, and archive a change when Cortex stage is archiving. No new feature implementation.
+tools: Read, Grep, Glob, Write, Edit, Bash, CallMcpTool, mcp__speclaw__compass_explore, mcp__speclaw__lawbook_change, mcp__speclaw__lawbook_validate, mcp__speclaw__lawbook_sync, mcp__speclaw__lawbook_archive, mcp__speclaw__cortex
+---
+
+You are the **archiver** role in speclaw's **Cortex** (One brain. Many agents.).
+
+## Goal
+
+Follow the `sync` then `archive` skills: reconcile delta specs to built code,
+`lawbook_change` action sync when needed, then archive. Advance Cortex to
+`done` after a successful archive.
+
+## Hard constraints
+
+- Do **not** start new feature work outside reconciliation.
+- If archive is gated, report blockers to the coordinator — do not bypass the
+  engine.

package/dist/modules/lawbook/assets/agents/explorer.md

@@ -0,0 +1,24 @@
+---
+name: explorer
+description: Read-only codebase investigation for a lawbook change. Use when the Cortex stage is exploring (or investigate for bugs). Compass-first; writes nothing under lawbook/ or src/.
+tools: Read, Grep, Glob, CallMcpTool, mcp__speclaw__compass_explore, mcp__speclaw__compass_find, mcp__speclaw__compass_impact, mcp__speclaw__compass_trace, mcp__speclaw__compass_index, mcp__speclaw__lawbook_investigate
+disallowedTools: Write, Edit, MultiEdit, Bash, NotebookEdit
+---
+
+You are the **explorer** role in speclaw's **Cortex** (One brain. Many agents.).
+
+## Goal
+
+Investigate the idea or bug with Compass **before** any grep/read. Produce a
+short brief for the planner: relevant symbols, blast radius, risks, and open
+questions. Do **not** draft change artifacts or edit source.
+
+## Skill
+
+Follow the `explore` skill (or `investigate` when `changeType` is bug).
+
+## Hard constraints
+
+- No Write / StrReplace / git writes / draft / archive / Cortex advance to
+  implementing.
+- When finished, return the brief to the coordinator and stop.

package/dist/modules/lawbook/assets/agents/implementer.md

@@ -0,0 +1,20 @@
+---
+name: implementer
+description: Implement drafted lawbook tasks in source and tests. Use when Cortex stage is implementing. Does not run final quality gates, review, sync, or archive.
+tools: Read, Grep, Glob, Write, Edit, Bash, CallMcpTool, mcp__speclaw__compass_explore, mcp__speclaw__compass_find, mcp__speclaw__compass_impact, mcp__speclaw__compass_index, mcp__speclaw__lawbook_change, mcp__speclaw__cortex
+disallowedTools: NotebookEdit
+---
+
+You are the **implementer** role in speclaw's **Cortex** (One brain. Many agents.).
+
+## Goal
+
+Work `tasks.md` in order using the `build` skill through implementation only.
+Keep code and delta specs in agreement. Check off completed tasks.
+
+## Hard constraints
+
+- Do **not** archive, push, or `laws accept`.
+- Do **not** skip the reviewer by "quietly fixing" after a FAIL — wait for
+  Cortex `rework` from the coordinator.
+- Stop after implementation hand-off; tester owns gates and discipline reports.

package/dist/modules/lawbook/assets/agents/planner.md

@@ -0,0 +1,27 @@
+---
+name: planner
+description: Draft lawbook change artifacts and ceremony level. Use when Cortex stage is planning. Asks clarifying questions via the coordinator; never edits src/.
+tools: Read, Grep, Glob, Write, Edit, CallMcpTool, mcp__speclaw__compass_explore, mcp__speclaw__compass_find, mcp__speclaw__lawbook_change, mcp__speclaw__lawbook_level
+disallowedTools: Bash, NotebookEdit
+---
+
+You are the **planner** role in speclaw's **Cortex** (One brain. Many agents.).
+
+## Goal
+
+Turn the explorer brief + user intent into a reviewable change under
+`lawbook/changes/<name>/` at the confirmed ceremony level. Prefer `draft` /
+`quick` skills.
+
+## Questions
+
+If anything material is ambiguous, **stop**. Return numbered questions to the
+coordinator (do not invent answers). The coordinator advances Cortex with
+`pauseForQuestions`. After human answers, continue drafting.
+
+## Hard constraints
+
+- May write only under `lawbook/changes/<name>/` (and related lawbook paths).
+- Do **not** edit `src/`, run archive, or implement code.
+- When the draft is complete, tell the coordinator to `cortex advance` toward
+  implementing.

package/dist/modules/lawbook/assets/agents/reviewer.md

@@ -0,0 +1,25 @@
+---
+name: reviewer
+description: Deep review of implemented change without patching code. Writes reports/review.md with PASS or FAIL. Use when Cortex stage is reviewing.
+tools: Read, Grep, Glob, Write, CallMcpTool, mcp__speclaw__compass_explore, mcp__speclaw__compass_find, mcp__speclaw__compass_impact, mcp__speclaw__compass_trace, mcp__speclaw__lawbook_change, mcp__speclaw__cortex
+disallowedTools: Edit, MultiEdit, Bash, NotebookEdit
+---
+
+You are the **reviewer** role in speclaw's **Cortex** (One brain. Many agents.).
+
+## Goal
+
+Review the branch/diff against proposal, tasks, delta specs, and
+`docs/standards/*`. Write `lawbook/changes/<name>/reports/review.md` with:
+
+- Verdict: `PASS` or `FAIL`
+- Findings anchored to file paths / symbols
+- Rework guidance if FAIL
+
+You may create/overwrite **only** `reports/review.md` (and read everything else).
+
+## Hard constraints
+
+- Do **not** patch application source to "make it pass".
+- Return the verdict to the coordinator for `cortex advance` (PASS) or
+  `cortex rework` (FAIL).

package/dist/modules/lawbook/assets/agents/tester.md

@@ -0,0 +1,21 @@
+---
+name: tester
+description: Run quality gates and manual verification; write discipline reports. Use when Cortex stage is testing. May add missing tests only — not features.
+tools: Read, Grep, Glob, Write, Edit, Bash, CallMcpTool, mcp__speclaw__compass_explore, mcp__speclaw__compass_affected_tests, mcp__speclaw__lawbook_change, mcp__speclaw__cortex
+---
+
+You are the **tester** role in speclaw's **Cortex** (One brain. Many agents.).
+
+## Goal
+
+Follow the `test` skill: quality gates, manual verification, discipline
+reports. Record verdict PASS or FAIL for the coordinator.
+
+You MAY add or fix **tests** that are missing for covered requirements. You
+MUST NOT implement new product features.
+
+## Hard constraints
+
+- Do not archive or sync.
+- On FAIL, return findings for Cortex `rework`; on PASS, coordinator advances
+  to archiving.

package/dist/modules/lawbook/assets/commands/cortex.md

@@ -0,0 +1,11 @@
+---
+description: Coordinate Cortex (One brain. Many agents.) for a lawbook change until archive.
+---
+
+Cortex the change: $ARGUMENTS
+
+Follow the `cortex` skill. You are the coordinator — spawn or adopt
+explorer → planner → implementer → reviewer → tester → archiver. Drive state
+with the `cortex` MCP tool (`status`/`start`/`advance`/`rework`/`brief`) or
+`speclaw cortex …`. Surface planner questions to the human. Do not implement
+product code yourself.

package/dist/modules/lawbook/assets/rules/spec-tasks-mandatory-steps.md

@@ -1,5 +1,5 @@
 ---
-description: Enforce the mandatory steps from lawbook/config.yaml when creating tasks.md, and ensure the agent executes all manual verification itself.
+description: Enforce the mandatory steps from lawbook/config.yaml when creating tasks.md, and ensure the tester role executes all manual verification itself.
 alwaysApply: true
 ---
 
@@ -19,7 +19,7 @@ steps, branch convention, and testing/documentation requirements.
 - Review and update the affected tests.
 - Run the quality gates and verify they pass
   (see `docs/standards/testing-standards.md`).
-- Perform manual verification of the behavior — **the agent executes this
+- Perform manual verification of the behavior — **the tester role executes this
   itself, never the user.**
 - Produce the discipline reports under `reports/` — one per discipline the change
   touched, from an open set (`backend.md`, `frontend.md`, `api.md`, `database.md`,
@@ -28,13 +28,13 @@ steps, branch convention, and testing/documentation requirements.
   for what the feature touched.
 - Update the technical documentation the change touches.
 - Archive the change within the same PR (the `archive` command / `lawbook_archive`
-  tool).
+  tool) after Cortex review/test PASS.
 
-## 3. Manual verification — the agent must execute it
+## 3. Manual verification — the tester must execute it
 
-The coding agent performs all manual testing itself (exercise the endpoint, UI,
-or CLI). Never delegate it to the user. A task that requires verification is
-not complete until the agent has verified it.
+Under Cortex, the **tester** role performs all manual testing
+(exercise the endpoint, UI, or CLI). Never delegate it to the user. A task that
+requires verification is not complete until the tester has verified it.
 
 ## 4. Archiving is part of the change
 
@@ -42,6 +42,7 @@ A change is not done until it is archived with `lawbook_archive` (never a manual
 `mv`). The archive lands in the same PR that implements the change.
 
 `lawbook_archive` is gated: it refuses to archive while any task is unchecked,
-while `reports/` has no discipline report, or while the delta specs are not yet
-synced into the canonical specs. Resolve those first — the gate is enforced in
-the engine, so a manual `mv` only hides an incomplete change.
+while `reports/` has no discipline report, while the delta specs are not yet
+synced into the canonical specs, or while harness review/test verdicts are not
+PASS. Resolve those first — the gate is enforced in the engine, so a manual `mv`
+only hides an incomplete change.

package/dist/modules/lawbook/assets/skills/build/steps/03-implement.md

@@ -8,4 +8,4 @@
   spec, update the spec in the change (not silently) — the two must agree.
 - Check off each task in `tasks.md` as you complete it.
 
-Next: read `steps/04-quality-gates.md` and do only what it says.
+Next: read `steps/04-hand-off.md` and do only what it says.

package/dist/modules/lawbook/assets/skills/build/steps/04-hand-off.md

@@ -0,0 +1,17 @@
+# Hand off to review / test
+
+Implementation for this role stops here. Do **not** run the full quality-gate
+suite, write discipline reports, sync, or archive — those belong to the
+**tester** and **archiver** roles under Cortex.
+
+Tell the coordinator:
+
+1. Which tasks are done
+2. Notable spec reconciliations still needed
+3. To `cortex advance` from `implementing` (→ reviewing at level ≥1, or
+   testing at level 0)
+
+The **tester** role follows the `test` skill for gates, manual verification,
+and discipline reports.
+
+No further steps remain — build workflow complete.

package/dist/modules/lawbook/assets/skills/cortex/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: cortex
+description: Coordinate Cortex — One brain. Many agents. Spawn or adopt explorer, planner, implementer, reviewer, tester, archiver until archive. Use for non-trivial work: "build X", "implement the change", "run cortex", "orchestrate X".
+---
+
+# Cortex — One brain. Many agents.
+
+You are the **coordinator**. Do not implement product code yourself.
+
+Drive state with the `cortex` MCP tool (`status` / `start` / `advance` /
+`rework` / `brief`) or `speclaw cortex …`. Command: `/lawbook/cortex`.
+
+Read `steps/01-load-or-start.md` and do only what it says.

package/dist/modules/lawbook/assets/skills/cortex/steps/01-load-or-start.md

@@ -0,0 +1,25 @@
+# Load or start Cortex
+
+- Confirm the change name with the user (or draft/quick first if none exists).
+- Run the `cortex` MCP tool with `action: status` (or
+  `speclaw cortex status --change <name>`). Prefer `action: brief` when you
+  need the role + skill hints for the current stage.
+- If missing, `action: start`.
+- Read `ai-specs/agents/<role>.md` for the current stage's permission contract.
+- If the host can spawn subagents (Claude Task / Cursor Task), spawn that role
+  with the contract in the prompt. If not, **adopt the role** in this session
+  but obey its allow/deny list strictly.
+
+Stage → role:
+
+| Stage | Role |
+|-------|------|
+| exploring | explorer (`explore` / `investigate` for bugs) |
+| planning / questions | planner (`draft` / `quick`); questions always go to the human |
+| implementing | implementer (`build` through implement hand-off) |
+| reviewing | reviewer |
+| testing | tester |
+| archiving | archiver (`sync` + `archive`) |
+| done | stop — report success |
+
+Next: read `steps/02-dispatch-loop.md` and do only what it says.

package/dist/modules/lawbook/assets/skills/cortex/steps/02-dispatch-loop.md

@@ -0,0 +1,19 @@
+# Dispatch loop
+
+For the current Cortex stage (`cortex` action `brief` or `status`):
+
+1. Dispatch (spawn or adopt) the matching role with a clear handoff brief.
+2. On role completion, call the matching Cortex op:
+   - exploring → `advance`
+   - planning with questions → `advance` + `pauseForQuestions` + `openQuestions`
+   - questions after human answers → `advance` (back to planning)
+   - planning complete → `advance` (to implementing)
+   - implementing done → `advance` (reviewing, or testing at level 0)
+   - reviewing PASS → `advance` + `verdict: PASS`; FAIL → `rework` + `verdict: FAIL`
+   - testing PASS → `advance` + `verdict: PASS`; FAIL → `rework` + `verdict: FAIL`
+   - archiving success → `advance` (to done)
+3. Max rework is 3; if the engine rejects further rework, **ask the human**.
+4. Coordinator never edits `src/`, never archives, never pushes, never runs
+   `laws accept`.
+
+Next: read `steps/03-complete.md` and do only what it says.

package/dist/modules/lawbook/assets/skills/cortex/steps/03-complete.md

@@ -0,0 +1,10 @@
+# Complete
+
+When Cortex stage is `done` (or the human stops the run), summarize:
+
+- Change name and final stage
+- Review/test verdicts and iteration count
+- Archive path if archived
+- Anything still open for the human
+
+No further steps remain — Cortex workflow complete.

package/dist/modules/lawbook/assets/skills/test/SKILL.md

@@ -0,0 +1,11 @@
+---
+name: test
+description: Run quality gates, manual verification, and discipline reports for a change. Used by the tester Cortex role after implementation. Use when Cortex stage is testing or the user asks to verify/test a change.
+---
+
+# test — Verify a change
+
+Run gates, manual verification, and write discipline reports. You may add
+missing tests; do not implement new features.
+
+Read `steps/01-quality-gates.md` and do only what it says.

package/dist/modules/lawbook/assets/skills/{build/steps/04-quality-gates.md → test/steps/01-quality-gates.md}

@@ -7,4 +7,4 @@ Run the repo's gates from `docs/standards/testing-standards.md`:
 
 Run them yourself and report real output. A red gate blocks completion.
 
-Next: read `steps/05-manual-verification.md` and do only what it says.
+Next: read `steps/02-manual-verification.md` and do only what it says.

package/dist/modules/lawbook/assets/skills/{build/steps/05-manual-verification.md → test/steps/02-manual-verification.md}

@@ -19,4 +19,4 @@ and proceed only after explicit authorization. A backup is not a substitute for
 authorization. Record in the report how verification stayed isolated (or the
 authorization you obtained).
 
-Next: read `steps/06-discipline-reports.md` and do only what it says.
+Next: read `steps/03-discipline-reports.md` and do only what it says.

package/dist/modules/lawbook/assets/skills/{build/steps/06-discipline-reports.md → test/steps/03-discipline-reports.md}

@@ -35,10 +35,13 @@ the evidence trustworthy and reproducible, rather than left to improvisation:
    change, with proof it is pre-existing (e.g. it reproduces with the change
    stashed) — or state "none".
 6. **Pending manual steps** — anything not automated, stated plainly — or "none".
-7. **Verdict** — one line.
+7. **Verdict** — one line (`PASS` or `FAIL` for Cortex).
 
 If a test kind does not yet apply (e.g. no unit runner), the report says so in
 place of that evidence and records the gates and manual verification that stood
 in.
 
-Next: read `steps/07-hand-off.md` and do only what it says.
+Tell the coordinator the Cortex verdict so they can `advance` (PASS) or
+`rework` (FAIL).
+
+No further steps remain — test workflow complete.

package/dist/modules/lawbook/change-tool.js

@@ -3,6 +3,7 @@ import { specInit, specValidate, specSync, specArchive, specList } from "./engin
 import { handleLevel } from "./quick.js";
 import { buildCoverageReport, loadCoverageConfig, renderCoverageAgent } from "./coverage.js";
 import { buildDriftReport, renderDriftAgent } from "./drift.js";
+import { handleHarness, harnessOps } from "../cortex/harness.js";
 export const lawbookChangeActions = [
     "init",
     "list",
@@ -12,6 +13,7 @@ export const lawbookChangeActions = [
     "level",
     "coverage",
     "drift",
+    "harness",
 ];
 export const lawbookChangeSchema = {
     projectPath: z.string(),
@@ -31,6 +33,11 @@ export const lawbookChangeSchema = {
     capability: z.string().optional(),
     includeReverse: z.boolean().optional(),
     maxItems: z.number().int().min(1).max(50).optional(),
+    harnessOp: z.enum(harnessOps).optional(),
+    verdict: z.enum(["PASS", "FAIL"]).optional(),
+    openQuestions: z.array(z.string()).optional(),
+    pauseForQuestions: z.boolean().optional(),
+    note: z.string().optional(),
 };
 function requireField(args, field) {
     const v = args[field];
@@ -84,6 +91,21 @@ export function handleLawbookChange(args) {
                 return report;
             return renderDriftAgent(report, args.maxItems ?? 10);
         }
+        case "harness": {
+            // Deprecated alias — prefer MCP tool `cortex` / `speclaw cortex`.
+            if (!args.harnessOp) {
+                throw new Error(`lawbook_change: action 'harness' requires 'harnessOp'`);
+            }
+            return handleHarness({
+                projectPath: args.projectPath,
+                change: requireField(args, "change"),
+                harnessOp: args.harnessOp,
+                verdict: args.verdict ?? null,
+                openQuestions: args.openQuestions,
+                pauseForQuestions: args.pauseForQuestions,
+                note: args.note ?? args.reason,
+            });
+        }
         default:
             throw new Error(`lawbook_change: unknown action '${String(args.action)}'`);
     }

package/dist/modules/lawbook/engine.js

@@ -5,6 +5,7 @@ import { sealCapability } from "./anchors.js";
 import { classifyEars, diagnoseEars, extractNormativeBody, loadEarsConfig, splitRequirementBlocks, } from "./ears.js";
 import { artifactNeeds, confirmedLevel, countUncheckedTasks, gatherSignals, hasDisciplineReport, loadCeremonyConfig, proposeLevel, readChangeType, readCeremonyRecord, } from "./levels.js";
 import { inferBugResolution, preventionRequiresDelta, validateBugfixContent } from "./bugfix.js";
+import { harnessArchiveBlockers } from "../cortex/harness.js";
 // speclaw's own spec-driven workflow engine. Inspired by OpenSpec's model
 // (proposals, delta specs, changes, archive) but implemented from scratch and
 // deliberately simpler: a change's specs/ holds the full intended spec for each
@@ -430,6 +431,9 @@ export function specArchivePreconditions(projectPath, change) {
     }
     // 4. Opt-in coverage gate: only when the change's delta specs declare ids.
     blockers.push(...coverageArchiveBlockers(projectPath, change));
+    // 5. Multi-agent harness: review/test PASS and stage archiving|done.
+    // Covers: req~harness-archive-gate~1
+    blockers.push(...harnessArchiveBlockers(projectPath, change));
     return blockers;
 }
 /**

package/dist/modules/lawbook/levels.js

@@ -462,7 +462,13 @@ export function hasDisciplineReport(changeDir) {
     const reportsDir = path.join(changeDir, "reports");
     if (!fs.existsSync(reportsDir))
         return false;
-    return fs
-        .readdirSync(reportsDir)
-        .some((n) => n.endsWith(".md") && n.toLowerCase() !== "readme.md");
+    return fs.readdirSync(reportsDir).some((n) => {
+        if (!n.endsWith(".md"))
+            return false;
+        const lower = n.toLowerCase();
+        // README scaffold and reviewer harness verdict are not discipline evidence.
+        if (lower === "readme.md" || lower === "review.md")
+            return false;
+        return true;
+    });
 }

package/dist/modules/lawbook/register.js

@@ -1,3 +1,4 @@
+import fs from "node:fs";
 import path from "node:path";
 import { z } from "zod";
 import { defineTool, defineAliasTool, text } from "../../shared/mcp.js";
@@ -17,6 +18,12 @@ export function installWorkflow(projectPath, vars, report, opts) {
     copyRendered(path.join(ASSETS, "skills"), path.join(aiSpecs, "skills"), vars, report, opts);
     copyRendered(path.join(ASSETS, "commands"), path.join(aiSpecs, "commands", "lawbook"), vars, report, opts);
     copyRendered(path.join(ASSETS, "rules"), path.join(aiSpecs, "rules"), vars, report, opts);
+    // Role agents (explorer/planner/implementer/reviewer/tester/archiver) — always on.
+    // Covers: req~role-agents-default~1
+    const agentsSrc = path.join(ASSETS, "agents");
+    if (fs.existsSync(agentsSrc)) {
+        copyRendered(agentsSrc, path.join(aiSpecs, "agents"), vars, report, opts);
+    }
 }
 /** Register the spec workflow MCP tools. */
 export function registerSpec(server, opts = {}) {

package/dist/modules/tools/assets/packs.json

@@ -1,6 +1 @@
-{
-  "agents": {
-    "description": "Subagent definitions rendered with the project profile: backend-developer, frontend-developer, product-strategy-analyst. They read the project's standards (docs/standards/*) for the stack, so they stay accurate as the standards are filled.",
-    "path": "agents"
-  }
-}
+{}

package/dist/server.js

@@ -1,10 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { registerCompass } from "./modules/compass/register.js";
+import { registerCortex } from "./modules/cortex/register.js";
 import { registerSpec } from "./modules/lawbook/register.js";
 import { registerFoundation } from "./modules/foundation/register.js";
 import { registerTools } from "./modules/tools/register.js";
 import { isMinimalMode } from "./shared/exposure.js";
+import { pkgVersion } from "./shared/version.js";
 /**
  * Build the speclaw MCP server with every module's tools registered.
  *
@@ -12,11 +14,12 @@ import { isMinimalMode } from "./shared/exposure.js";
  */
 export function buildServer(opts = {}) {
     const minimal = opts.minimal ?? isMinimalMode();
-    const server = new McpServer({ name: "speclaw", version: "0.1.0" });
+    const server = new McpServer({ name: "speclaw", version: pkgVersion() });
     const reg = { minimal };
     registerFoundation(server, reg);
     registerSpec(server, reg);
     registerCompass(server, reg);
+    registerCortex(server, reg);
     registerTools(server, reg);
     return server;
 }

package/dist/shared/agents.js

@@ -15,21 +15,21 @@ export const AGENTS = [
         id: "cursor",
         label: "Cursor",
         ideDir: ".cursor",
-        linkTargets: ["skills", "commands", "rules"],
+        linkTargets: ["skills", "commands", "rules", "agents"],
         mcpFile: ".cursor/mcp.json",
     },
     {
         id: "codex",
         label: "Codex",
         ideDir: ".codex",
-        linkTargets: ["skills", "commands"],
+        linkTargets: ["skills", "commands", "agents"],
         mcpFile: ".codex/mcp.json",
     },
     {
         id: "windsurf",
         label: "Windsurf",
         ideDir: ".windsurf",
-        linkTargets: ["skills", "commands"],
+        linkTargets: ["skills", "commands", "agents"],
         mcpFile: ".windsurf/mcp.json",
     },
     {

package/dist/shared/exposure.js

@@ -4,8 +4,8 @@ import { fileURLToPath } from "node:url";
 import { readManifest } from "./manifest.js";
 /**
  * Tools omitted when the exposure profile is `minimal`. Kept tools are the
- * discovery + law loop: compass_explore/find/diff_context, lawbook_change.
- * Deprecated aliases are never registered in minimal mode.
+ * discovery + law loop: compass_explore/find/diff_context, lawbook_change,
+ * cortex. Deprecated aliases are never registered in minimal mode.
  */
 export const MINIMAL_OMIT = new Set([
     "compass_index",

package/dist/shared/tool-catalog.js

@@ -4,12 +4,13 @@ export const CANONICAL_TOOLS = [
     "compass_find",
     "compass_diff_context",
     "compass_index",
+    "cortex",
     "lawbook_change",
     "lawbook_investigate",
     "speclaw_setup",
     "speclaw_check",
 ];
-export const MAX_CANONICAL_TOOLS = 8;
+export const MAX_CANONICAL_TOOLS = 9;
 /** Retired MCP names → canonical replacement hint for deprecation notices. */
 export const ALIAS_TARGETS = {
     compass_search: "compass_find (mode: exact)",
@@ -35,7 +36,7 @@ export const ALIAS_TARGETS = {
 };
 export const ALIAS_NAMES = Object.keys(ALIAS_TARGETS);
 const ALIAS_SET = new Set(ALIAS_NAMES);
-/** True when `name` is one of the eight canonical tools. */
+/** True when `name` is one of the nine canonical tools. */
 export function isCanonicalTool(name) {
     return CANONICAL_TOOLS.includes(name);
 }

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@esneiderbravo/speclaw",
-  "version": "1.0.1",
+  "version": "2.0.1",
   "publishConfig": {
     "access": "public"
   },
-  "description": "Where specs become law. A self-contained MCP suite that turns any repo into a spec-driven, agent-ready project: its own constitution (foundation), its own local code graph (Compass), its own spec-driven workflow (Lawbook), and opt-in skill packs (Tools). No external CLIs, no LLM to install.",
+  "description": "Where specs become law. A self-contained MCP suite that turns any repo into a spec-driven, multi-agent-ready project: its own constitution (Foundation), local code graph (Compass), spec workflow (Lawbook), and multi-agent brain (Cortex). No external CLIs, no LLM to install.",
   "keywords": [
     "mcp",
     "mcp-server",

package/dist/modules/lawbook/assets/skills/build/steps/07-hand-off.md

@@ -1,9 +0,0 @@
-# Hand off
-
-When every task is checked and gates are green, tell the user the change is
-ready to `sync` and `archive`. Keep the delta specs current as you build, but
-know that `sync` formally reconciles the delta specs against what was actually
-built — so behavior that drifted past the original spec is caught there, not
-left to chance.
-
-No further steps remain — build workflow complete.