@bradygaster/squad-cli 0.10.0 → 0.11.0

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

@@ -1 +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,yEAAyE;IACzE,IAAI,UAAU,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QACzC,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"}
+{"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/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,EAiT3C,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,EA6W3C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAWxC"}

package/dist/cli/core/templates.js

@@ -136,6 +136,12 @@ export const TEMPLATE_MANIFEST = [
         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: 'templates/skill.md',
@@ -178,64 +184,118 @@ export const TEMPLATE_MANIFEST = [
     // 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-commands/SKILL.md',
-        destination: '../.copilot/skills/squad-commands/SKILL.md',
+        source: 'skills/squad/SKILL.md',
+        destination: '../.github/skills/squad/SKILL.md',
         overwriteOnUpgrade: true,
-        description: 'In-chat command discovery — categorized menu of Squad operations',
+        description: 'Squad command catalog — invokable via /squad slash command',
     },
     {
         source: 'skills/squad-version-check/SKILL.md',
-        destination: '../.copilot/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',
+    },
+    {
+        source: 'skills/coordinator-source-of-truth/SKILL.md',
+        destination: '../.github/skills/coordinator-source-of-truth/SKILL.md',
+        overwriteOnUpgrade: true,
+        description: 'Squad file-by-file source-of-truth hierarchy (extracted from squad.agent.md, #1308)',
+    },
+    {
+        source: 'skills/coordinator-response-mode/SKILL.md',
+        destination: '../.github/skills/coordinator-response-mode/SKILL.md',
+        overwriteOnUpgrade: true,
+        description: 'Response Mode Selection (Direct/Lightweight/Standard/Full) — full decision table + Lightweight spawn template',
+    },
+    {
+        source: 'skills/coordinator-init-mode/SKILL.md',
+        destination: '../.github/skills/coordinator-init-mode/SKILL.md',
+        overwriteOnUpgrade: true,
+        description: 'Init Mode two-phase protocol — propose team (Phase 1) then create .squad/ scaffolding (Phase 2)',
+    },
     // Session init reference (squad-owned, coordinator reads at session start)
     {
         source: 'session-init-reference.md',

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

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

@@ -5,12 +5,21 @@
  */
 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;
     force?: boolean;
     /** When --self, install the insider (prerelease) tag instead of latest. */
     insider?: boolean;
+    /** Preview what upgrade would change without writing. */
+    dryRun?: boolean;
 }
 export interface UpdateInfo {
     fromVersion: string;
@@ -40,6 +49,23 @@ export declare function ensureCastingDefaults(dest: string, templatesDir?: strin
 /** 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;AAYH,OAAO,EAA4B,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AA0GzD,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;AA8HD,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,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"}
+{"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;IAClB,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;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;AAoVD;;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,CA0LhG;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"}

package/dist/cli/core/upgrade.js

@@ -6,7 +6,7 @@
 import path from 'node:path';
 import { execFileSync } from 'node:child_process';
 import { FSStorageProvider } from '@bradygaster/squad-sdk';
-import { success, warn, info, dim } from './output.js';
+import { success, warn, info, dim, bold } from './output.js';
 import { fatal } from './errors.js';
 import { detectSquadDir } from './detect-squad-dir.js';
 import { TEMPLATE_MANIFEST, getTemplatesDir } from './templates.js';
@@ -16,14 +16,40 @@ import { resolveSquadStateMcpSpec } from './mcp-spec.js';
 export { resolveSquadStateMcpSpec } from './mcp-spec.js';
 import { ensureSquadStateMcpInRoot, tombstoneStaleSquadStateInProjectMcp } from './mcp-root.js';
 const storage = new FSStorageProvider();
+/**
+ * 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 function isLocalOrUnpublishedVersion(version) {
+    if (!version || version === '0.0.0')
+        return true;
+    // Local linked builds often have 0.0.0-development or similar sentinel
+    if (/^0\.0\.0/.test(version))
+        return true;
+    // Versions with `+` build metadata (e.g. 0.10.0+local.1234) are not
+    // publishable to npm — they indicate a local build.
+    if (version.includes('+'))
+        return true;
+    return false;
+}
 function buildMcpServerSpecs(isGitHub, cliVersion) {
     // Pin the squad-cli package to the currently-installed CLI version so that
     // `npx -y @bradygaster/squad-cli state-mcp` does NOT silently resolve to the
     // npm `latest` dist-tag (which may predate the `state-mcp` command and thus
     // expose zero tools to Copilot — see MCP-BRIDGE-BROKEN root cause).
-    const pkgSpec = cliVersion && cliVersion !== '0.0.0'
-        ? `@bradygaster/squad-cli@${cliVersion}`
-        : '@bradygaster/squad-cli';
+    //
+    // #1204: When the CLI is a local dev build or unpublished pre-release, fall
+    // back to the @insider dist-tag to avoid writing an unresolvable version
+    // string that breaks npx resolution at session start.
+    let pkgSpec;
+    if (!cliVersion || isLocalOrUnpublishedVersion(cliVersion)) {
+        pkgSpec = '@bradygaster/squad-cli@insider';
+    }
+    else {
+        pkgSpec = `@bradygaster/squad-cli@${cliVersion}`;
+    }
     const servers = [
         {
             name: 'squad_state',
@@ -172,11 +198,37 @@ function detectIsGitHubForMcp(dest, config) {
     }
     return true;
 }
-function writeAgentTemplate(agentSrc, agentDest, cliVersion, mcpConfigMode, isGitHub) {
+function writeAgentTemplate(agentSrc, agentDest, cliVersion, mcpConfigMode, isGitHub, options) {
     let agentContent = storage.readSync(agentSrc) ?? '';
     if (mcpConfigMode === 'agent-frontmatter') {
         agentContent = injectMcpFrontmatter(agentContent, isGitHub, cliVersion);
     }
+    // Back up locally-customized squad.agent.md before overwriting (#1052)
+    if (storage.existsSync(agentDest)) {
+        const existing = (storage.readSync(agentDest) ?? '').replace(/\r\n/g, '\n');
+        // Strip the version stamp before comparing (version line changes every upgrade)
+        const stripVersion = (s) => s.replace(/<!-- squad-cli v[\d.]+[-\w.]* -->\n?/g, '');
+        const normalizedExisting = stripVersion(existing);
+        const normalizedTemplate = stripVersion(agentContent.replace(/\r\n/g, '\n'));
+        if (normalizedExisting !== normalizedTemplate && normalizedExisting.trim().length > 0) {
+            const backupPath = agentDest + '.local-backup';
+            if (options?.dryRun) {
+                warn(`squad.agent.md has local customizations — would back up to ${path.basename(backupPath)}`);
+                return;
+            }
+            storage.writeSync(backupPath, existing);
+            warn(`squad.agent.md has local customizations — backed up to ${path.basename(backupPath)}`);
+            info(`  To restore: copy ${path.basename(backupPath)} → ${path.basename(agentDest)}`);
+        }
+        else if (options?.dryRun) {
+            info('squad.agent.md is unmodified — would refresh with latest template');
+            return;
+        }
+    }
+    else if (options?.dryRun) {
+        info('squad.agent.md does not exist — would create from template');
+        return;
+    }
     storage.writeSync(agentDest, agentContent);
     stampVersion(agentDest, cliVersion);
 }
@@ -394,7 +446,7 @@ const ENSURE_DIRECTORIES = [
     '.squad/decisions/inbox',
     '.squad/casting',
     '.squad/agents',
-    '.copilot/skills',
+    '.github/skills',
 ];
 /**
  * Ensure .gitattributes has required merge=union rules (idempotent)
@@ -549,7 +601,74 @@ function warnIfSkillCustomized(srcPath, destPath, sourceName) {
     }
 }
 /**
- * Sync manifest-declared skills to .copilot/skills/, respecting overwriteOnUpgrade.
+ * Migrate skills from the legacy `.copilot/skills/<name>/` location to the
+ * canonical `.github/skills/<name>/`. Only migrates skills that appear in
+ * `TEMPLATE_MANIFEST` (manifest-curated Squad skills) — does NOT touch
+ * user-added skills in `.copilot/skills/`. After successful migration,
+ * removes the now-empty `.copilot/skills/<name>/` directories.
+ *
+ * Idempotent: when a skill already exists at the new location the legacy
+ * copy is tombstoned without comparing content — this protects any
+ * in-place customization the user made at `.github/skills/<name>/` from
+ * being clobbered, and means re-running upgrade is a no-op on the new
+ * location. If only the legacy copy exists, it is moved over.
+ *
+ * See bradygaster/squad#1126 (canonical issue) — this is the migration
+ * piece of that fix; #1304 is the PR that implements it.
+ */
+function migrateLegacyCopilotSkills(dest) {
+    const legacyDir = path.join(dest, '.copilot', 'skills');
+    if (!storage.existsSync(legacyDir))
+        return { migrated: [], tombstoned: [] };
+    const manifestSkills = new Set(TEMPLATE_MANIFEST
+        .filter(f => f.source.startsWith('skills/'))
+        .map(f => f.source.split('/')[1]) // 'skills/foo/SKILL.md' -> 'foo'
+        .filter((s) => Boolean(s)));
+    const newDir = path.join(dest, '.github', 'skills');
+    const migrated = [];
+    const tombstoned = [];
+    for (const entry of storage.listSync(legacyDir)) {
+        if (!manifestSkills.has(entry))
+            continue; // leave user-added skills alone
+        const legacySkillDir = path.join(legacyDir, entry);
+        if (!storage.isDirectorySync(legacySkillDir))
+            continue;
+        const newSkillDir = path.join(newDir, entry);
+        if (storage.existsSync(newSkillDir)) {
+            // New location already has it — drop the legacy copy without overwriting.
+            try {
+                storage.deleteDirSync(legacySkillDir);
+                tombstoned.push(path.posix.join('.copilot/skills', entry));
+            }
+            catch {
+                // best-effort; leave the legacy dir if we can't remove it
+            }
+            continue;
+        }
+        try {
+            storage.mkdirSync(newDir, { recursive: true });
+            copyDirRecursive(legacySkillDir, newSkillDir);
+            storage.deleteDirSync(legacySkillDir);
+            migrated.push(path.posix.join('.github/skills', entry));
+        }
+        catch {
+            // best-effort; leave the legacy dir if anything fails
+        }
+    }
+    // If the legacy `.copilot/skills/` directory is now empty, remove it too.
+    try {
+        if (storage.existsSync(legacyDir) && storage.listSync(legacyDir).length === 0) {
+            storage.deleteDirSync(legacyDir);
+            tombstoned.push('.copilot/skills');
+        }
+    }
+    catch {
+        // best-effort
+    }
+    return { migrated, tombstoned };
+}
+/**
+ * Sync manifest-declared skills to .github/skills/, respecting overwriteOnUpgrade.
  * Only skills listed in TEMPLATE_MANIFEST are installed — not the entire templates/skills/ dir.
  */
 function syncAllSkills(dest, templatesDir) {
@@ -622,18 +741,33 @@ async function runEnsureChecks(dest, templatesDir, filesUpdated) {
         success(`scaffolded memory governance defaults (${memoryFiles.length} files/directories)`);
         filesUpdated.push(...memoryFiles);
     }
+    const builtinAgents = ensureBuiltinAgents(dest, templatesDir);
+    if (builtinAgents.length > 0) {
+        const uniqueAgentNames = Array.from(new Set(builtinAgents.map(p => path.basename(path.dirname(p)))));
+        success(`scaffolded ${uniqueAgentNames.length} built-in agent(s): ${uniqueAgentNames.join(', ')}`);
+        filesUpdated.push(...builtinAgents);
+    }
+    const skillMigration = migrateLegacyCopilotSkills(dest);
+    if (skillMigration.migrated.length > 0) {
+        success(`migrated ${skillMigration.migrated.length} skill(s) from .copilot/skills/ → .github/skills/`);
+        filesUpdated.push(...skillMigration.migrated);
+    }
+    if (skillMigration.tombstoned.length > 0) {
+        success(`removed ${skillMigration.tombstoned.length} stale .copilot/skills entries (now live at .github/skills/)`);
+    }
     const skillCount = syncAllSkills(dest, templatesDir);
     if (skillCount > 0) {
-        success(`synced ${skillCount} skills to .copilot/skills/`);
+        success(`synced ${skillCount} skills to .github/skills/`);
         filesUpdated.push(`skills (${skillCount})`);
     }
     refreshSquadTemplatesDir(dest, templatesDir);
     success('refreshed .squad/templates/');
     filesUpdated.push('.squad/templates/');
     // iter-8: write squad_state MCP entry to repo-root `.mcp.json`
-    // (auto-loaded by Copilot CLI 5.3+ walking up from cwd to git root)
-    // and tombstone any stale project-level entry left by older Squad
-    // versions in `.copilot/mcp-config.json`. No HOME modifications.
+    // (auto-loaded by Copilot CLI ≥1.0.59, which walks up from cwd to the
+    // git root looking for .mcp.json) and tombstone any stale project-level
+    // entry left by older Squad versions in `.copilot/mcp-config.json`.
+    // No HOME modifications.
     const pinnedSpec = await resolveSquadStateMcpSpec(getPackageVersion());
     try {
         const rootResult = ensureSquadStateMcpInRoot(dest, getPackageVersion(), pinnedSpec);
@@ -645,6 +779,11 @@ async function runEnsureChecks(dest, templatesDir, filesUpdated) {
     catch (err) {
         warn(`Could not write .mcp.json: ${err instanceof Error ? err.message : err}`);
     }
+    // iter-8: do NOT write to ~/.copilot/mcp-config.json on upgrade. The
+    // repo-root .mcp.json write above is sufficient for Copilot CLI ≥1.0.59
+    // (walks from cwd up looking for .mcp.json) AND for `copilot -p` from
+    // the project root. Out-of-tree `copilot -p` should use
+    // `--additional-mcp-config @.mcp.json`. See bradygaster/squad#1296.
     const tomb = tombstoneStaleSquadStateInProjectMcp(dest);
     if (tomb.removed) {
         success(`removed stale squad_state from ${tomb.path} (now lives in .mcp.json)`);
@@ -696,6 +835,72 @@ export function ensureMemoryGovernanceUpgradeDefaults(dest) {
     }
     return created;
 }
+/**
+ * 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 function ensureBuiltinAgents(dest, templatesDir) {
+    const agentsDir = path.join(dest, '.squad', 'agents');
+    if (!storage.existsSync(agentsDir)) {
+        storage.mkdirSync(agentsDir, { recursive: true });
+    }
+    // Built-in agents that ship as charter templates. Each entry maps to:
+    //   - dirName: case-preserving directory name under .squad/agents/
+    //   - templateFile: filename under templatesDir (charter template)
+    //   - displayName: shown in history.md header
+    const builtins = [
+        { dirName: 'Rai', templateFile: 'Rai-charter.md', displayName: 'Rai' },
+        { dirName: 'fact-checker', templateFile: 'fact-checker-charter.md', displayName: 'Fact Checker' },
+    ];
+    const created = [];
+    for (const agent of builtins) {
+        const agentDir = path.join(agentsDir, agent.dirName);
+        const charterPath = path.join(agentDir, 'charter.md');
+        const historyPath = path.join(agentDir, 'history.md');
+        // Idempotent: skip if agent directory already exists. Never overwrite
+        // existing charters or history files (preserves user customization).
+        if (storage.existsSync(agentDir))
+            continue;
+        // Source charter content from the shipped template; fall back to a
+        // minimal placeholder if the template file is missing (defensive — should
+        // not happen in a well-formed install, but better than crashing upgrade).
+        const tplPath = path.join(templatesDir, agent.templateFile);
+        let charterContent;
+        if (storage.existsSync(tplPath)) {
+            charterContent = storage.readSync(tplPath) ?? '';
+        }
+        else {
+            charterContent = `# ${agent.displayName}\n\n> Charter template not found in shipped templates. Run \`squad upgrade\` after reinstalling the CLI to repair.\n`;
+        }
+        try {
+            storage.mkdirSync(agentDir, { recursive: true });
+            storage.writeSync(charterPath, charterContent);
+            created.push(path.join('.squad', 'agents', agent.dirName, 'charter.md'));
+            storage.writeSync(historyPath, `# ${agent.displayName} — History\n\n## Learnings\n\nInitial scaffold via \`squad upgrade\`. Ready for work.\n`);
+            created.push(path.join('.squad', 'agents', agent.dirName, 'history.md'));
+        }
+        catch (err) {
+            if (err instanceof Error && 'code' in err && ['EPERM', 'EACCES'].includes(err.code ?? '')) {
+                warn(`Could not scaffold built-in agent ${agent.displayName} (read-only). Create .squad/agents/${agent.dirName}/ manually.`);
+                continue;
+            }
+            throw err;
+        }
+    }
+    return created;
+}
 /**
  * Run the upgrade command
  */
@@ -721,6 +926,26 @@ export async function runUpgrade(dest, options = {}) {
     // Check if already current
     const isAlreadyCurrent = !options.force && oldVersion && oldVersion !== '0.0.0' && compareSemver(oldVersion, cliVersion) === 0;
     const projectType = detectProjectType(dest);
+    // --dry-run: preview what upgrade would do without writing (#1052)
+    if (options.dryRun) {
+        info(`\n${bold('Dry run')} — previewing upgrade from ${oldVersion || 'unknown'} → ${cliVersion}\n`);
+        const templatesDir = getTemplatesDir();
+        const agentSrc = path.join(templatesDir, 'squad.agent.md.template');
+        if (storage.existsSync(agentSrc)) {
+            writeAgentTemplate(agentSrc, agentDest, cliVersion, mcpConfigMode, isGitHubForMcp, { dryRun: true });
+        }
+        const filesToUpgrade = TEMPLATE_MANIFEST.filter(f => f.overwriteOnUpgrade && f.source !== 'squad.agent.md.template');
+        if (filesToUpgrade.length > 0) {
+            info(`Would overwrite ${filesToUpgrade.length} squad-owned file(s):`);
+            for (const file of filesToUpgrade) {
+                const destPath = path.join(squadDirInfo.path, file.destination);
+                const exists = storage.existsSync(destPath);
+                console.log(`  ${exists ? 'overwrite' : 'create'}  ${file.destination}`);
+            }
+        }
+        console.log(`\nRun without --dry-run to apply.\n`);
+        return { fromVersion: oldVersion, toVersion: cliVersion, filesUpdated: [], migrationsRun: [] };
+    }
     if (isAlreadyCurrent) {
         info(`Already up to date (v${cliVersion})`);
         // Still run missing migrations