@bradygaster/squad-cli 0.9.6-insider.2 → 0.10.0-insider.1

package/dist/cli/core/mcp-spec.js

@@ -0,0 +1,62 @@
+/**
+ * Shared helper for resolving the `squad_state` MCP launch spec.
+ *
+ * Used by BOTH `squad init` and `squad upgrade` so the runtime-MCP fallback
+ * behavior stays symmetric.
+ *
+ * Resolution order (iter-7, simplified to 2 tiers):
+ *   1. If `cliVersion` IS published on npm → `npx -y <pkg>@<version> state-mcp`
+ *      (clean cross-machine UX, the steady-state happy path).
+ *   2. Else → `npx -y <pkg>@insider state-mcp`. We do NOT probe the registry;
+ *      the `@insider` dist-tag is kept fresh by the publish flow and tier-2
+ *      is the de-facto fallback whenever a pinned preview version isn't yet
+ *      published. If it really isn't reachable at runtime, `npx` will fail
+ *      loudly — same observable behavior as pre-iter-5.
+ *
+ * Iter-6 had two additional tiers (a local-install path resolver and a hard
+ * error) that the smoke data showed never fired in practice: `@insider` is
+ * always current, so tier-2 always wins before tier-3 is reached. Deleted
+ * in iter-7 per the "verify you didn't add code that's no longer needed"
+ * mandate.
+ */
+const PACKAGE_NAME = '@bradygaster/squad-cli';
+/** Reset internal caches (test-only helper; retained for compat). */
+export function _resetMcpSpecCache() {
+    // no caches in the 2-tier resolver — kept as a no-op for backward compat
+    // with any test that still calls it.
+}
+/**
+ * Resolve the squad_state MCP launch spec given the running CLI version.
+ *
+ * Always returns a spec. If the pinned version is unpublished we fall back
+ * to `@insider`; if even that turns out to be unreachable at runtime, `npx`
+ * will fail visibly when Copilot launches the MCP server — same behavior
+ * as pre-iter-5.
+ */
+export async function resolveSquadStateMcpSpec(cliVersion, options = {}) {
+    // 1. Try the pinned version on the public registry. Skip for placeholder
+    //    versions ('', '0.0.0') and local/dev builds with build metadata ('+')
+    //    — the registry will obviously not have them (#1204).
+    if (cliVersion && cliVersion !== '0.0.0' && !cliVersion.includes('+')) {
+        const probe = options.publishedCheck ?? defaultPublishedCheck;
+        const published = await probe(cliVersion);
+        if (published) {
+            return {
+                command: 'npx',
+                args: ['-y', `${PACKAGE_NAME}@${cliVersion}`, 'state-mcp'],
+                source: 'pinned',
+            };
+        }
+    }
+    // 2. Fall back to the @insider dist-tag — always returned, never probed.
+    return {
+        command: 'npx',
+        args: ['-y', `${PACKAGE_NAME}@insider`, 'state-mcp'],
+        source: 'insider',
+    };
+}
+async function defaultPublishedCheck(version) {
+    const { isSquadCliVersionPublished } = await import('./npm-registry.js');
+    return await isSquadCliVersionPublished(version);
+}
+//# sourceMappingURL=mcp-spec.js.map

package/dist/cli/core/mcp-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-spec.js","sourceRoot":"","sources":["../../../src/cli/core/mcp-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAWH,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAU9C,qEAAqE;AACrE,MAAM,UAAU,kBAAkB;IAChC,yEAAyE;IACzE,qCAAqC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,UAAkB,EAClB,UAA2C,EAAE;IAE7C,yEAAyE;IACzE,2EAA2E;IAC3E,0DAA0D;IAC1D,IAAI,UAAU,IAAI,UAAU,KAAK,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtE,MAAM,KAAK,GAAG,OAAO,CAAC,cAAc,IAAI,qBAAqB,CAAC;QAC9D,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;QAC1C,IAAI,SAAS,EAAE,CAAC;YACd,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,YAAY,IAAI,UAAU,EAAE,EAAE,WAAW,CAAC;gBAC1D,MAAM,EAAE,QAAQ;aACjB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,OAAO;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,YAAY,UAAU,EAAE,WAAW,CAAC;QACpD,MAAM,EAAE,SAAS;KAClB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAC,OAAe;IAClD,MAAM,EAAE,0BAA0B,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACzE,OAAO,MAAM,0BAA0B,CAAC,OAAO,CAAC,CAAC;AACnD,CAAC"}

package/dist/cli/core/npm-registry.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Lightweight helper to check whether a specific package version exists in the
+ * public npm registry. Used by `ensureSquadStateMcpPinned` to avoid pinning a
+ * `squad_state` MCP launch spec to a version that `npx` cannot resolve
+ * (which would cause an ETARGET at session start and leave the bridge unwired).
+ *
+ * The result is cached per-process to avoid repeated lookups across the
+ * multi-pass upgrade flow. Network failures and non-200 responses are
+ * conservatively treated as "version not published" so that we fall back to
+ * the locally-installed binary rather than pinning a bad spec.
+ *
+ * See `.squad/files/validation/MCP-LOADER-ROOT-CAUSE.md` (data-15 Option A).
+ */
+/** Reset the cache (test-only helper). */
+export declare function _resetNpmRegistryCache(): void;
+/**
+ * Returns true if `@bradygaster/squad-cli@<version>` is reachable on the npm
+ * registry, false on any network failure / 404 / non-publishable response.
+ *
+ * Uses Node's built-in `https` so we don't pull in extra deps. Total budget
+ * is bounded by `timeoutMs` (default 2s) so a slow / offline registry can
+ * never block CLI startup.
+ */
+export declare function isSquadCliVersionPublished(version: string, timeoutMs?: number): Promise<boolean>;
+//# sourceMappingURL=npm-registry.d.ts.map

package/dist/cli/core/npm-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-registry.d.ts","sourceRoot":"","sources":["../../../src/cli/core/npm-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,0CAA0C;AAC1C,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,SAAS,SAAO,GACf,OAAO,CAAC,OAAO,CAAC,CAqClB"}

package/dist/cli/core/npm-registry.js

@@ -0,0 +1,65 @@
+/**
+ * Lightweight helper to check whether a specific package version exists in the
+ * public npm registry. Used by `ensureSquadStateMcpPinned` to avoid pinning a
+ * `squad_state` MCP launch spec to a version that `npx` cannot resolve
+ * (which would cause an ETARGET at session start and leave the bridge unwired).
+ *
+ * The result is cached per-process to avoid repeated lookups across the
+ * multi-pass upgrade flow. Network failures and non-200 responses are
+ * conservatively treated as "version not published" so that we fall back to
+ * the locally-installed binary rather than pinning a bad spec.
+ *
+ * See `.squad/files/validation/MCP-LOADER-ROOT-CAUSE.md` (data-15 Option A).
+ */
+const cache = new Map();
+/** Reset the cache (test-only helper). */
+export function _resetNpmRegistryCache() {
+    cache.clear();
+}
+/**
+ * Returns true if `@bradygaster/squad-cli@<version>` is reachable on the npm
+ * registry, false on any network failure / 404 / non-publishable response.
+ *
+ * Uses Node's built-in `https` so we don't pull in extra deps. Total budget
+ * is bounded by `timeoutMs` (default 2s) so a slow / offline registry can
+ * never block CLI startup.
+ */
+export async function isSquadCliVersionPublished(version, timeoutMs = 2000) {
+    if (!version || version === '0.0.0')
+        return false;
+    const cacheKey = version;
+    const cached = cache.get(cacheKey);
+    if (cached !== undefined)
+        return cached;
+    const url = `https://registry.npmjs.org/@bradygaster%2Fsquad-cli/${encodeURIComponent(version)}`;
+    const ok = await new Promise((resolve) => {
+        let settled = false;
+        const finish = (v) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(v);
+        };
+        const timer = setTimeout(() => finish(false), timeoutMs);
+        void import('node:https')
+            .then(({ request }) => {
+            const req = request(url, { method: 'GET' }, (res) => {
+                // Drain to free the socket.
+                res.resume();
+                finish(res.statusCode === 200);
+            });
+            req.on('error', () => finish(false));
+            req.on('timeout', () => {
+                req.destroy();
+                finish(false);
+            });
+            req.setTimeout(timeoutMs);
+            req.end();
+        })
+            .catch(() => finish(false))
+            .finally(() => clearTimeout(timer));
+    });
+    cache.set(cacheKey, ok);
+    return ok;
+}
+//# sourceMappingURL=npm-registry.js.map

package/dist/cli/core/npm-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-registry.js","sourceRoot":"","sources":["../../../src/cli/core/npm-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;AAEzC,0CAA0C;AAC1C,MAAM,UAAU,sBAAsB;IACpC,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAAe,EACf,SAAS,GAAG,IAAI;IAEhB,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,QAAQ,GAAG,OAAO,CAAC;IACzB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAExC,MAAM,GAAG,GAAG,uDAAuD,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;IACjG,MAAM,EAAE,GAAG,MAAM,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QAChD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,CAAU,EAAE,EAAE;YAC5B,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;QAEzD,KAAK,MAAM,CAAC,YAAY,CAAC;aACtB,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;YACpB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE;gBAClD,4BAA4B;gBAC5B,GAAG,CAAC,MAAM,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,CAAC,UAAU,KAAK,GAAG,CAAC,CAAC;YACjC,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACrC,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;gBACrB,GAAG,CAAC,OAAO,EAAE,CAAC;gBACd,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YAC1B,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aAC1B,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACxB,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/cli/core/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/cli/core/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,+BAA+B;AAC/B,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,YAAY,EA4Q3C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAWxC"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/cli/core/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,+BAA+B;AAC/B,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,YAAY,EA2V3C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAWxC"}

package/dist/cli/core/templates.js

@@ -22,6 +22,9 @@ export const TEMPLATE_MANIFEST = [
         description: 'Squad coordinator agent prompt',
     },
     // Casting system (squad-owned, overwrite on upgrade)
+    // NOTE: These JSON files are read at runtime by the SDK and many agent
+    // skills via their flat `.squad/casting-*.json` paths — do NOT route into
+    // a subdirectory without coordinated updates across the SDK + skill docs.
     {
         source: 'casting-history.json',
         destination: 'casting-history.json',
@@ -40,88 +43,108 @@ export const TEMPLATE_MANIFEST = [
         overwriteOnUpgrade: true,
         description: 'Universe-based character registry',
     },
-    // Template files (squad-owned, overwrite on upgrade)
+    // Template files (squad-owned, overwrite on upgrade) — routed to
+    // .squad/templates/ so upgrade doesn't dump ~20 generic *.md docs
+    // into the .squad/ root.
     {
         source: 'charter.md',
-        destination: 'charter.md',
+        destination: 'templates/charter.md',
         overwriteOnUpgrade: true,
         description: 'Agent charter template',
     },
     {
         source: 'constraint-tracking.md',
-        destination: 'constraint-tracking.md',
+        destination: 'templates/constraint-tracking.md',
         overwriteOnUpgrade: true,
         description: 'Constraint tracking template',
     },
     {
         source: 'copilot-instructions.md',
-        destination: 'copilot-instructions.md',
+        destination: 'templates/copilot-instructions.md',
         overwriteOnUpgrade: true,
         description: 'Copilot instructions template',
     },
     {
         source: 'history.md',
-        destination: 'history.md',
+        destination: 'templates/history.md',
         overwriteOnUpgrade: true,
         description: 'Agent history template',
     },
     {
         source: 'mcp-config.md',
-        destination: 'mcp-config.md',
+        destination: 'templates/mcp-config.md',
         overwriteOnUpgrade: true,
         description: 'MCP configuration template',
     },
     {
         source: 'multi-agent-format.md',
-        destination: 'multi-agent-format.md',
+        destination: 'templates/multi-agent-format.md',
         overwriteOnUpgrade: true,
         description: 'Multi-agent format specification',
     },
     {
         source: 'orchestration-log.md',
-        destination: 'orchestration-log.md',
+        destination: 'templates/orchestration-log.md',
         overwriteOnUpgrade: true,
         description: 'Orchestration log template',
     },
     {
         source: 'plugin-marketplace.md',
-        destination: 'plugin-marketplace.md',
+        destination: 'templates/plugin-marketplace.md',
         overwriteOnUpgrade: true,
         description: 'Plugin marketplace template',
     },
     {
         source: 'raw-agent-output.md',
-        destination: 'raw-agent-output.md',
+        destination: 'templates/raw-agent-output.md',
         overwriteOnUpgrade: true,
         description: 'Raw agent output template',
     },
     {
         source: 'roster.md',
-        destination: 'roster.md',
+        destination: 'templates/roster.md',
         overwriteOnUpgrade: true,
         description: 'Team roster template',
     },
     {
         source: 'run-output.md',
-        destination: 'run-output.md',
+        destination: 'templates/run-output.md',
         overwriteOnUpgrade: true,
         description: 'Run output template',
     },
     {
         source: 'scribe-charter.md',
-        destination: 'scribe-charter.md',
+        destination: 'templates/scribe-charter.md',
         overwriteOnUpgrade: true,
         description: 'Scribe charter template',
     },
+    {
+        source: 'Rai-charter.md',
+        destination: 'templates/Rai-charter.md',
+        overwriteOnUpgrade: true,
+        description: 'Rai RAI reviewer charter template',
+    },
+    {
+        source: 'rai-policy.md',
+        destination: 'templates/rai-policy.md',
+        overwriteOnUpgrade: true,
+        description: 'Default RAI policy template',
+    },
     {
         source: 'fact-checker-charter.md',
-        destination: 'fact-checker-charter.md',
+        destination: 'templates/fact-checker-charter.md',
         overwriteOnUpgrade: true,
         description: 'Fact checker charter template',
     },
+    {
+        source: 'fact-checker-policy.md',
+        destination: 'templates/fact-checker-policy.md',
+        overwriteOnUpgrade: true,
+        description: 'Fact checker policy template (verification + DA methodology)',
+    },
     {
         source: 'skill.md',
-        destination: 'skill.md',
+        destination: 'templates/skill.md',
         overwriteOnUpgrade: true,
         description: 'Skill definition template',
     },
@@ -154,59 +177,114 @@ export const TEMPLATE_MANIFEST = [
     // Issue lifecycle (squad-owned)
     {
         source: 'issue-lifecycle.md',
-        destination: 'issue-lifecycle.md',
+        destination: 'templates/issue-lifecycle.md',
         overwriteOnUpgrade: true,
         description: 'Issue lifecycle process template',
     },
     // Skills subdirectory (squad-owned)
     {
         source: 'skills/squad-conventions/SKILL.md',
-        destination: '../.copilot/skills/squad-conventions/SKILL.md',
+        destination: '../.github/skills/squad-conventions/SKILL.md',
         overwriteOnUpgrade: true,
         description: 'Squad conventions skill definition',
     },
     {
         source: 'skills/error-recovery/SKILL.md',
-        destination: '../.copilot/skills/error-recovery/SKILL.md',
+        destination: '../.github/skills/error-recovery/SKILL.md',
         overwriteOnUpgrade: true,
         description: 'Graceful error recovery patterns',
     },
     {
         source: 'skills/secret-handling/SKILL.md',
-        destination: '../.copilot/skills/secret-handling/SKILL.md',
+        destination: '../.github/skills/secret-handling/SKILL.md',
         overwriteOnUpgrade: true,
         description: 'Secrets management and credential safety',
     },
     {
         source: 'skills/git-workflow/SKILL.md',
-        destination: '../.copilot/skills/git-workflow/SKILL.md',
+        destination: '../.github/skills/git-workflow/SKILL.md',
         overwriteOnUpgrade: true,
         description: 'Git workflow conventions and branch management',
     },
     {
         source: 'skills/session-recovery/SKILL.md',
-        destination: '../.copilot/skills/session-recovery/SKILL.md',
+        destination: '../.github/skills/session-recovery/SKILL.md',
         overwriteOnUpgrade: true,
         description: 'Session checkpoint and recovery patterns',
     },
     {
         source: 'skills/reviewer-protocol/SKILL.md',
-        destination: '../.copilot/skills/reviewer-protocol/SKILL.md',
+        destination: '../.github/skills/reviewer-protocol/SKILL.md',
         overwriteOnUpgrade: true,
         description: 'Code review protocol and reviewer gate patterns',
     },
     {
         source: 'skills/test-discipline/SKILL.md',
-        destination: '../.copilot/skills/test-discipline/SKILL.md',
+        destination: '../.github/skills/test-discipline/SKILL.md',
         overwriteOnUpgrade: true,
         description: 'Test-first discipline and coverage expectations',
     },
     {
         source: 'skills/agent-collaboration/SKILL.md',
-        destination: '../.copilot/skills/agent-collaboration/SKILL.md',
+        destination: '../.github/skills/agent-collaboration/SKILL.md',
         overwriteOnUpgrade: true,
         description: 'Multi-agent collaboration and handoff patterns',
     },
+    {
+        source: 'skills/squad/SKILL.md',
+        destination: '../.github/skills/squad/SKILL.md',
+        overwriteOnUpgrade: true,
+        description: 'Squad command catalog — invokable via /squad slash command',
+    },
+    {
+        source: 'skills/squad-version-check/SKILL.md',
+        destination: '../.github/skills/squad-version-check/SKILL.md',
+        overwriteOnUpgrade: true,
+        description: 'Squad CLI internals — version stamping & upgrade mechanics',
+    },
+    {
+        source: 'skills/squad-help/SKILL.md',
+        destination: '../.github/skills/squad-help/SKILL.md',
+        overwriteOnUpgrade: true,
+        description: 'How to actually use Squad — agent vs skill vs slash command (#1297 redirect)',
+    },
+    {
+        source: 'skills/cross-squad-communication/SKILL.md',
+        destination: '../.github/skills/cross-squad-communication/SKILL.md',
+        overwriteOnUpgrade: true,
+        description: 'Cross-squad delegation — calling another squad as a sub-agent',
+    },
+    {
+        source: 'skills/tiered-memory/SKILL.md',
+        destination: '../.github/skills/tiered-memory/SKILL.md',
+        overwriteOnUpgrade: true,
+        description: 'Tiered-memory access patterns (hot/cold/wiki)',
+    },
+    {
+        source: 'skills/iterative-retrieval/SKILL.md',
+        destination: '../.github/skills/iterative-retrieval/SKILL.md',
+        overwriteOnUpgrade: true,
+        description: 'Iterative retrieval for long-running squad work',
+    },
+    {
+        source: 'skills/reflect/SKILL.md',
+        destination: '../.github/skills/reflect/SKILL.md',
+        overwriteOnUpgrade: true,
+        description: 'Reflection skill for capturing session learnings',
+    },
+    {
+        source: 'skills/cross-squad/SKILL.md',
+        destination: '../.github/skills/cross-squad/SKILL.md',
+        overwriteOnUpgrade: true,
+        description: 'Cross-squad discovery — finding peer squads via registry/upstream',
+    },
+    // Session init reference (squad-owned, coordinator reads at session start)
+    {
+        source: 'session-init-reference.md',
+        destination: 'templates/session-init-reference.md',
+        overwriteOnUpgrade: true,
+        description: 'Session init reference — coordinator procedures run at session start',
+    },
     // Workflows (squad-owned, overwrite on upgrade)
     {
         source: 'workflows/squad-ci.yml',

package/dist/cli/core/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/cli/core/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAE,CAAC;AAcxC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,mBAAmB;IACnB;QACE,MAAM,EAAE,yBAAyB;QACjC,WAAW,EAAE,kCAAkC;QAC/C,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,gCAAgC;KAC9C;IAED,qDAAqD;IACrD;QACE,MAAM,EAAE,sBAAsB;QAC9B,WAAW,EAAE,sBAAsB;QACnC,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,0BAA0B;KACxC;IACD;QACE,MAAM,EAAE,qBAAqB;QAC7B,WAAW,EAAE,qBAAqB;QAClC,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,8BAA8B;KAC5C;IACD;QACE,MAAM,EAAE,uBAAuB;QAC/B,WAAW,EAAE,uBAAuB;QACpC,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,mCAAmC;KACjD;IAED,qDAAqD;IACrD;QACE,MAAM,EAAE,YAAY;QACpB,WAAW,EAAE,YAAY;QACzB,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,wBAAwB;KACtC;IACD;QACE,MAAM,EAAE,wBAAwB;QAChC,WAAW,EAAE,wBAAwB;QACrC,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,8BAA8B;KAC5C;IACD;QACE,MAAM,EAAE,yBAAyB;QACjC,WAAW,EAAE,yBAAyB;QACtC,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,+BAA+B;KAC7C;IACD;QACE,MAAM,EAAE,YAAY;QACpB,WAAW,EAAE,YAAY;QACzB,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,wBAAwB;KACtC;IACD;QACE,MAAM,EAAE,eAAe;QACvB,WAAW,EAAE,eAAe;QAC5B,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,4BAA4B;KAC1C;IACD;QACE,MAAM,EAAE,uBAAuB;QAC/B,WAAW,EAAE,uBAAuB;QACpC,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,kCAAkC;KAChD;IACD;QACE,MAAM,EAAE,sBAAsB;QAC9B,WAAW,EAAE,sBAAsB;QACnC,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,4BAA4B;KAC1C;IACD;QACE,MAAM,EAAE,uBAAuB;QAC/B,WAAW,EAAE,uBAAuB;QACpC,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,6BAA6B;KAC3C;IACD;QACE,MAAM,EAAE,qBAAqB;QAC7B,WAAW,EAAE,qBAAqB;QAClC,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,2BAA2B;KACzC;IACD;QACE,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,WAAW;QACxB,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,sBAAsB;KACpC;IACD;QACE,MAAM,EAAE,eAAe;QACvB,WAAW,EAAE,eAAe;QAC5B,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,qBAAqB;KACnC;IACD;QACE,MAAM,EAAE,mBAAmB;QAC3B,WAAW,EAAE,mBAAmB;QAChC,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,yBAAyB;KACvC;IACD;QACE,MAAM,EAAE,yBAAyB;QACjC,WAAW,EAAE,yBAAyB;QACtC,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,+BAA+B;KAC7C;IACD;QACE,MAAM,EAAE,UAAU;QAClB,WAAW,EAAE,UAAU;QACvB,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,2BAA2B;KACzC;IAED,qCAAqC;IACrC;QACE,MAAM,EAAE,eAAe;QACvB,WAAW,EAAE,eAAe;QAC5B,kBAAkB,EAAE,KAAK;QACzB,WAAW,EAAE,+BAA+B;KAC7C;IACD;QACE,MAAM,EAAE,YAAY;QACpB,WAAW,EAAE,YAAY;QACzB,kBAAkB,EAAE,KAAK;QACzB,WAAW,EAAE,qBAAqB;KACnC;IAED,qCAAqC;IACrC;QACE,MAAM,EAAE,iBAAiB;QACzB,WAAW,EAAE,iBAAiB;QAC9B,kBAAkB,EAAE,KAAK;QACzB,WAAW,EAAE,qBAAqB;KACnC;IACD;QACE,MAAM,EAAE,oBAAoB;QAC5B,WAAW,EAAE,oBAAoB;QACjC,kBAAkB,EAAE,KAAK;QACzB,WAAW,EAAE,0BAA0B;KACxC;IAED,gCAAgC;IAChC;QACE,MAAM,EAAE,oBAAoB;QAC5B,WAAW,EAAE,oBAAoB;QACjC,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,kCAAkC;KAChD;IAED,oCAAoC;IACpC;QACE,MAAM,EAAE,mCAAmC;QAC3C,WAAW,EAAE,+CAA+C;QAC5D,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,oCAAoC;KAClD;IACD;QACE,MAAM,EAAE,gCAAgC;QACxC,WAAW,EAAE,4CAA4C;QACzD,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,kCAAkC;KAChD;IACD;QACE,MAAM,EAAE,iCAAiC;QACzC,WAAW,EAAE,6CAA6C;QAC1D,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,0CAA0C;KACxD;IACD;QACE,MAAM,EAAE,8BAA8B;QACtC,WAAW,EAAE,0CAA0C;QACvD,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,gDAAgD;KAC9D;IACD;QACE,MAAM,EAAE,kCAAkC;QAC1C,WAAW,EAAE,8CAA8C;QAC3D,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,0CAA0C;KACxD;IACD;QACE,MAAM,EAAE,mCAAmC;QAC3C,WAAW,EAAE,+CAA+C;QAC5D,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,iDAAiD;KAC/D;IACD;QACE,MAAM,EAAE,iCAAiC;QACzC,WAAW,EAAE,6CAA6C;QAC1D,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,iDAAiD;KAC/D;IACD;QACE,MAAM,EAAE,qCAAqC;QAC7C,WAAW,EAAE,iDAAiD;QAC9D,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,gDAAgD;KAC9D;IAED,gDAAgD;IAChD;QACE,MAAM,EAAE,wBAAwB;QAChC,WAAW,EAAE,mCAAmC;QAChD,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,mBAAmB;KACjC;IACD;QACE,MAAM,EAAE,0BAA0B;QAClC,WAAW,EAAE,qCAAqC;QAClD,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,qBAAqB;KACnC;IACD;QACE,MAAM,EAAE,+BAA+B;QACvC,WAAW,EAAE,0CAA0C;QACvD,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,0BAA0B;KACxC;IACD;QACE,MAAM,EAAE,qCAAqC;QAC7C,WAAW,EAAE,gDAAgD;QAC7D,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,gCAAgC;KAC9C;IACD;QACE,MAAM,EAAE,kCAAkC;QAC1C,WAAW,EAAE,6CAA6C;QAC1D,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,sCAAsC;KACpD;IACD;QACE,MAAM,EAAE,mCAAmC;QAC3C,WAAW,EAAE,8CAA8C;QAC3D,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,kCAAkC;KAChD;IACD;QACE,MAAM,EAAE,6BAA6B;QACrC,WAAW,EAAE,wCAAwC;QACrD,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,wBAAwB;KACtC;IACD;QACE,MAAM,EAAE,6BAA6B;QACrC,WAAW,EAAE,wCAAwC;QACrD,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,0BAA0B;KACxC;IACD;QACE,MAAM,EAAE,6BAA6B;QACrC,WAAW,EAAE,wCAAwC;QACrD,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,wBAAwB;KACtC;IACD;QACE,MAAM,EAAE,4BAA4B;QACpC,WAAW,EAAE,uCAAuC;QACpD,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,6BAA6B;KAC3C;IACD;QACE,MAAM,EAAE,iCAAiC;QACzC,WAAW,EAAE,4CAA4C;QACzD,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,2BAA2B;KACzC;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACzC,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QACpD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;AACnF,CAAC"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/cli/core/templates.ts"],"names":[],"mappings":"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"}

package/dist/cli/core/upgrade.d.ts

@@ -3,6 +3,15 @@
  * Zero-dep implementation using Node.js stdlib only
  * @module cli/core/upgrade
  */
+import { type SquadStateMcpSpec } from './mcp-spec.js';
+export { resolveSquadStateMcpSpec } from './mcp-spec.js';
+/**
+ * Returns true if the version looks like a local dev build or unpublished
+ * pre-release that cannot be resolved from the public npm registry.
+ * Guards against writing unresolvable version strings into MCP config
+ * (see #1204).
+ */
+export declare function isLocalOrUnpublishedVersion(version: string): boolean;
 export interface UpgradeOptions {
     migrateDirectory?: boolean;
     self?: boolean;
@@ -35,6 +44,26 @@ export declare function ensureDirectories(dest: string): string[];
  * available, falling back to inline JSON defaults.
  */
 export declare function ensureCastingDefaults(dest: string, templatesDir?: string): string[];
+/** Human-readable single-line description of an McpSpec for success() messages. */
+export declare function describeMcpSpec(spec: SquadStateMcpSpec): string;
+export declare function ensureMemoryGovernanceUpgradeDefaults(dest: string): string[];
+/**
+ * Scaffold always-on built-in agent charters (Rai, Fact Checker) that ship
+ * as templates but may be missing from older squads. Idempotent — only writes
+ * when the agent directory is absent. Never overwrites existing charters or
+ * history. Sources charter content from the shipped `templates/{name}-charter.md`
+ * files when available, falling back to a minimal placeholder otherwise.
+ *
+ * Scribe and Ralph are intentionally NOT scaffolded here — they should already
+ * exist in any squad that ran a prior init, and their charters are inlined in
+ * cast.ts (no shipped template file). Adding them here would risk overwriting
+ * customized versions on legacy squads.
+ *
+ * @param dest Root directory containing .squad/
+ * @param templatesDir Directory containing shipped charter templates
+ * @returns Paths (relative to dest) of created agent files
+ */
+export declare function ensureBuiltinAgents(dest: string, templatesDir: string): string[];
 /**
  * Run the upgrade command
  */

package/dist/cli/core/upgrade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../../src/cli/core/upgrade.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4BH,MAAM,WAAW,cAAc;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAyPD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAyB1D;AAkBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAUxD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CA+CnF;AAoGD;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAoKhG;AAMD,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAiBD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCpF"}
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../../src/cli/core/upgrade.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,EAA4B,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAczD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQpE;AAqGD,MAAM,WAAW,cAAc;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAyTD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAyB1D;AAkBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAUxD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CA+CnF;AA2ND,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAI/D;AAED,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAsC5E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAqDhF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAqKhG;AAMD,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAiBD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDpF"}