@bradygaster/squad-cli 0.7.0 → 0.8.1

package/dist/cli/core/templates.js

@@ -0,0 +1,247 @@
+/**
+ * Template system types and manifest for Squad initialization.
+ * @module cli/core/templates
+ */
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { existsSync } from 'node:fs';
+/**
+ * Template manifest — all files that init copies.
+ *
+ * Categorization:
+ * - Squad-owned (overwriteOnUpgrade: true): squad.agent.md, workflows, template files, casting data
+ * - User-owned (overwriteOnUpgrade: false): team.md, routing.md, decisions.md, ceremonies.md, agent history/identity
+ */
+export const TEMPLATE_MANIFEST = [
+    // Core coordinator
+    {
+        source: 'squad.agent.md',
+        destination: '../.github/agents/squad.agent.md',
+        overwriteOnUpgrade: true,
+        description: 'Squad coordinator agent prompt',
+    },
+    // Casting system (squad-owned, overwrite on upgrade)
+    {
+        source: 'casting-history.json',
+        destination: 'casting-history.json',
+        overwriteOnUpgrade: true,
+        description: 'Casting history tracking',
+    },
+    {
+        source: 'casting-policy.json',
+        destination: 'casting-policy.json',
+        overwriteOnUpgrade: true,
+        description: 'Casting policy configuration',
+    },
+    {
+        source: 'casting-registry.json',
+        destination: 'casting-registry.json',
+        overwriteOnUpgrade: true,
+        description: 'Universe-based character registry',
+    },
+    // Template files (squad-owned, overwrite on upgrade)
+    {
+        source: 'charter.md',
+        destination: 'charter.md',
+        overwriteOnUpgrade: true,
+        description: 'Agent charter template',
+    },
+    {
+        source: 'constraint-tracking.md',
+        destination: 'constraint-tracking.md',
+        overwriteOnUpgrade: true,
+        description: 'Constraint tracking template',
+    },
+    {
+        source: 'copilot-instructions.md',
+        destination: 'copilot-instructions.md',
+        overwriteOnUpgrade: true,
+        description: 'Copilot instructions template',
+    },
+    {
+        source: 'history.md',
+        destination: 'history.md',
+        overwriteOnUpgrade: true,
+        description: 'Agent history template',
+    },
+    {
+        source: 'mcp-config.md',
+        destination: 'mcp-config.md',
+        overwriteOnUpgrade: true,
+        description: 'MCP configuration template',
+    },
+    {
+        source: 'multi-agent-format.md',
+        destination: 'multi-agent-format.md',
+        overwriteOnUpgrade: true,
+        description: 'Multi-agent format specification',
+    },
+    {
+        source: 'orchestration-log.md',
+        destination: 'orchestration-log.md',
+        overwriteOnUpgrade: true,
+        description: 'Orchestration log template',
+    },
+    {
+        source: 'plugin-marketplace.md',
+        destination: 'plugin-marketplace.md',
+        overwriteOnUpgrade: true,
+        description: 'Plugin marketplace template',
+    },
+    {
+        source: 'raw-agent-output.md',
+        destination: 'raw-agent-output.md',
+        overwriteOnUpgrade: true,
+        description: 'Raw agent output template',
+    },
+    {
+        source: 'roster.md',
+        destination: 'roster.md',
+        overwriteOnUpgrade: true,
+        description: 'Team roster template',
+    },
+    {
+        source: 'run-output.md',
+        destination: 'run-output.md',
+        overwriteOnUpgrade: true,
+        description: 'Run output template',
+    },
+    {
+        source: 'scribe-charter.md',
+        destination: 'scribe-charter.md',
+        overwriteOnUpgrade: true,
+        description: 'Scribe charter template',
+    },
+    {
+        source: 'skill.md',
+        destination: 'skill.md',
+        overwriteOnUpgrade: true,
+        description: 'Skill definition template',
+    },
+    // User-owned files (never overwrite)
+    {
+        source: 'ceremonies.md',
+        destination: 'ceremonies.md',
+        overwriteOnUpgrade: false,
+        description: 'Team ceremonies configuration',
+    },
+    {
+        source: 'routing.md',
+        destination: 'routing.md',
+        overwriteOnUpgrade: false,
+        description: 'Agent routing rules',
+    },
+    // Identity subdirectory (user-owned)
+    {
+        source: 'identity/now.md',
+        destination: 'identity/now.md',
+        overwriteOnUpgrade: false,
+        description: 'Agent current focus',
+    },
+    {
+        source: 'identity/wisdom.md',
+        destination: 'identity/wisdom.md',
+        overwriteOnUpgrade: false,
+        description: 'Agent accumulated wisdom',
+    },
+    // Skills subdirectory (squad-owned)
+    {
+        source: 'skills/squad-conventions/SKILL.md',
+        destination: 'skills/squad-conventions/SKILL.md',
+        overwriteOnUpgrade: true,
+        description: 'Squad conventions skill definition',
+    },
+    // Workflows (squad-owned, overwrite on upgrade)
+    {
+        source: 'workflows/squad-ci.yml',
+        destination: '../.github/workflows/squad-ci.yml',
+        overwriteOnUpgrade: true,
+        description: 'Squad CI workflow',
+    },
+    {
+        source: 'workflows/squad-docs.yml',
+        destination: '../.github/workflows/squad-docs.yml',
+        overwriteOnUpgrade: true,
+        description: 'Squad docs workflow',
+    },
+    {
+        source: 'workflows/squad-heartbeat.yml',
+        destination: '../.github/workflows/squad-heartbeat.yml',
+        overwriteOnUpgrade: true,
+        description: 'Squad heartbeat workflow',
+    },
+    {
+        source: 'workflows/squad-insider-release.yml',
+        destination: '../.github/workflows/squad-insider-release.yml',
+        overwriteOnUpgrade: true,
+        description: 'Squad insider release workflow',
+    },
+    {
+        source: 'workflows/squad-issue-assign.yml',
+        destination: '../.github/workflows/squad-issue-assign.yml',
+        overwriteOnUpgrade: true,
+        description: 'Squad issue auto-assignment workflow',
+    },
+    {
+        source: 'workflows/squad-label-enforce.yml',
+        destination: '../.github/workflows/squad-label-enforce.yml',
+        overwriteOnUpgrade: true,
+        description: 'Squad label enforcement workflow',
+    },
+    {
+        source: 'workflows/squad-main-guard.yml',
+        destination: '../.github/workflows/squad-main-guard.yml',
+        overwriteOnUpgrade: true,
+        description: 'Squad main branch protection workflow',
+    },
+    {
+        source: 'workflows/squad-preview.yml',
+        destination: '../.github/workflows/squad-preview.yml',
+        overwriteOnUpgrade: true,
+        description: 'Squad preview workflow',
+    },
+    {
+        source: 'workflows/squad-promote.yml',
+        destination: '../.github/workflows/squad-promote.yml',
+        overwriteOnUpgrade: true,
+        description: 'Squad promotion workflow',
+    },
+    {
+        source: 'workflows/squad-release.yml',
+        destination: '../.github/workflows/squad-release.yml',
+        overwriteOnUpgrade: true,
+        description: 'Squad release workflow',
+    },
+    {
+        source: 'workflows/squad-triage.yml',
+        destination: '../.github/workflows/squad-triage.yml',
+        overwriteOnUpgrade: true,
+        description: 'Squad issue triage workflow',
+    },
+    {
+        source: 'workflows/sync-squad-labels.yml',
+        destination: '../.github/workflows/sync-squad-labels.yml',
+        overwriteOnUpgrade: true,
+        description: 'Squad label sync workflow',
+    },
+];
+/**
+ * Get the templates directory path.
+ * Walks up from the current file to find templates/ — works both
+ * from compiled dist/cli/core/templates.js and from a bundled cli.js at the root.
+ */
+export function getTemplatesDir() {
+    const currentFile = fileURLToPath(import.meta.url);
+    let dir = dirname(currentFile);
+    for (let i = 0; i < 6; i++) {
+        const candidate = join(dir, 'templates');
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error('Templates directory not found — installation may be corrupted');
+}
+//# sourceMappingURL=templates.js.map

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

@@ -0,0 +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,UAAU,EAAE,MAAM,SAAS,CAAC;AAcrC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,mBAAmB;IACnB;QACE,MAAM,EAAE,gBAAgB;QACxB,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,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,oCAAoC;IACpC;QACE,MAAM,EAAE,mCAAmC;QAC3C,WAAW,EAAE,mCAAmC;QAChD,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,oCAAoC;KAClD;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,gCAAgC;QACxC,WAAW,EAAE,2CAA2C;QACxD,kBAAkB,EAAE,IAAI;QACxB,WAAW,EAAE,uCAAuC;KACrD;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,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5C,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"}

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

@@ -0,0 +1,20 @@
+/**
+ * Squad upgrade command — overwrites squad-owned files, runs migrations
+ * Zero-dep implementation using Node.js stdlib only
+ * @module cli/core/upgrade
+ */
+export interface UpgradeOptions {
+    migrateDirectory?: boolean;
+    self?: boolean;
+}
+export interface UpdateInfo {
+    fromVersion: string;
+    toVersion: string;
+    filesUpdated: string[];
+    migrationsRun: string[];
+}
+/**
+ * Run the upgrade command
+ */
+export declare function runUpgrade(dest: string, options?: UpgradeOptions): Promise<UpdateInfo>;
+//# sourceMappingURL=upgrade.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../../src/cli/core/upgrade.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH,MAAM,WAAW,cAAc;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;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;AAiRD;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAoJhG"}

package/dist/cli/core/upgrade.js

@@ -0,0 +1,399 @@
+/**
+ * Squad upgrade command — overwrites squad-owned files, runs migrations
+ * Zero-dep implementation using Node.js stdlib only
+ * @module cli/core/upgrade
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { dirname } from 'node:path';
+import { success, warn, info, dim } from './output.js';
+import { fatal } from './errors.js';
+import { detectSquadDir } from './detect-squad-dir.js';
+import { TEMPLATE_MANIFEST, getTemplatesDir } from './templates.js';
+import { runMigrations } from './migrations.js';
+const currentFile = fileURLToPath(import.meta.url);
+const currentDir = dirname(currentFile);
+/**
+ * Read version from squad.agent.md HTML comment
+ */
+function readInstalledVersion(agentPath) {
+    try {
+        if (!fs.existsSync(agentPath))
+            return '0.0.0';
+        const content = fs.readFileSync(agentPath, 'utf8');
+        // Try HTML comment first (new format)
+        const commentMatch = content.match(/<!-- version: ([0-9.]+(?:-[a-z]+(?:\.\d+)?)?) -->/);
+        if (commentMatch)
+            return commentMatch[1];
+        // Fallback to frontmatter (old format)
+        const frontmatterMatch = content.match(/^version:\s*"([^"]+)"/m);
+        return frontmatterMatch ? frontmatterMatch[1] : '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/**
+ * Compare semver strings: -1 (a<b), 0 (a==b), 1 (a>b)
+ */
+function compareSemver(a, b) {
+    const stripPre = (v) => v.split('-')[0];
+    const pa = stripPre(a).split('.').map(Number);
+    const pb = stripPre(b).split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((pa[i] || 0) < (pb[i] || 0))
+            return -1;
+        if ((pa[i] || 0) > (pb[i] || 0))
+            return 1;
+    }
+    // Base versions equal — pre-release is less than release
+    const aPre = a.includes('-');
+    const bPre = b.includes('-');
+    if (aPre && !bPre)
+        return -1;
+    if (!aPre && bPre)
+        return 1;
+    if (aPre && bPre)
+        return a < b ? -1 : a > b ? 1 : 0;
+    return 0;
+}
+/**
+ * Stamp version into squad.agent.md after copying
+ */
+function stampVersion(filePath, version) {
+    let content = fs.readFileSync(filePath, 'utf8');
+    // Replace version in HTML comment
+    content = content.replace(/<!-- version: [^>]+ -->/m, `<!-- version: ${version} -->`);
+    // Replace version in Identity section's Version line
+    content = content.replace(/- \*\*Version:\*\* [0-9.]+(?:-[a-z]+(?:\.\d+)?)?/m, `- **Version:** ${version}`);
+    // Replace {version} placeholder
+    content = content.replace(/`Squad v\{version\}`/g, `\`Squad v${version}\``);
+    fs.writeFileSync(filePath, content);
+}
+/**
+ * Detect project type by checking marker files
+ */
+function detectProjectType(dir) {
+    if (fs.existsSync(path.join(dir, 'package.json')))
+        return 'npm';
+    if (fs.existsSync(path.join(dir, 'go.mod')))
+        return 'go';
+    if (fs.existsSync(path.join(dir, 'requirements.txt')) ||
+        fs.existsSync(path.join(dir, 'pyproject.toml')))
+        return 'python';
+    if (fs.existsSync(path.join(dir, 'pom.xml')) ||
+        fs.existsSync(path.join(dir, 'build.gradle')) ||
+        fs.existsSync(path.join(dir, 'build.gradle.kts')))
+        return 'java';
+    try {
+        const entries = fs.readdirSync(dir);
+        if (entries.some(e => e.endsWith('.csproj') || e.endsWith('.sln') ||
+            e.endsWith('.slnx') || e.endsWith('.fsproj') ||
+            e.endsWith('.vbproj')))
+            return 'dotnet';
+    }
+    catch { }
+    return 'unknown';
+}
+/**
+ * Project-type-sensitive workflows that need stubs for non-npm projects
+ */
+const PROJECT_TYPE_SENSITIVE_WORKFLOWS = new Set([
+    'squad-ci.yml',
+    'squad-release.yml',
+    'squad-preview.yml',
+    'squad-insider-release.yml',
+    'squad-docs.yml',
+]);
+/**
+ * Generate stub workflow for non-npm projects
+ */
+function generateProjectWorkflowStub(workflowFile, projectType) {
+    const typeLabel = projectType === 'unknown'
+        ? 'Project type was not detected'
+        : projectType + ' project';
+    const todoBuildCmd = projectType === 'unknown'
+        ? '# TODO: Project type was not detected — add your build/test commands here'
+        : '# TODO: Add your ' + projectType + ' build/test commands here';
+    const buildHints = [
+        '          # Go:            go test ./...',
+        '          # Python:        pip install -r requirements.txt && pytest',
+        '          # .NET:          dotnet test',
+        '          # Java (Maven):  mvn test',
+        '          # Java (Gradle): ./gradlew test',
+    ].join('\n');
+    if (workflowFile === 'squad-ci.yml') {
+        return 'name: Squad CI\n' +
+            '# ' + typeLabel + ' — configure build/test commands below\n\n' +
+            'on:\n' +
+            '  pull_request:\n' +
+            '    branches: [dev, preview, main, insider]\n' +
+            '    types: [opened, synchronize, reopened]\n' +
+            '  push:\n' +
+            '    branches: [dev, insider]\n\n' +
+            'permissions:\n' +
+            '  contents: read\n\n' +
+            'jobs:\n' +
+            '  test:\n' +
+            '    runs-on: ubuntu-latest\n' +
+            '    steps:\n' +
+            '      - uses: actions/checkout@v4\n\n' +
+            '      - name: Build and test\n' +
+            '        run: |\n' +
+            '          ' + todoBuildCmd + '\n' +
+            buildHints + '\n' +
+            '          echo "No build commands configured — update squad-ci.yml"\n';
+    }
+    if (workflowFile === 'squad-release.yml') {
+        return 'name: Squad Release\n' +
+            '# ' + typeLabel + ' — configure build, test, and release commands below\n\n' +
+            'on:\n' +
+            '  push:\n' +
+            '    branches: [main]\n\n' +
+            'permissions:\n' +
+            '  contents: write\n\n' +
+            'jobs:\n' +
+            '  release:\n' +
+            '    runs-on: ubuntu-latest\n' +
+            '    steps:\n' +
+            '      - uses: actions/checkout@v4\n' +
+            '        with:\n' +
+            '          fetch-depth: 0\n\n' +
+            '      - name: Build and test\n' +
+            '        run: |\n' +
+            '          ' + todoBuildCmd + '\n' +
+            buildHints + '\n' +
+            '          echo "No build commands configured — update squad-release.yml"\n\n' +
+            '      - name: Create release\n' +
+            '        env:\n' +
+            '          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n' +
+            '        run: |\n' +
+            '          # TODO: Add your release commands here (e.g., git tag, gh release create)\n' +
+            '          echo "No release commands configured — update squad-release.yml"\n';
+    }
+    if (workflowFile === 'squad-preview.yml') {
+        return 'name: Squad Preview Validation\n' +
+            '# ' + typeLabel + ' — configure build, test, and validation commands below\n\n' +
+            'on:\n' +
+            '  push:\n' +
+            '    branches: [preview]\n\n' +
+            'permissions:\n' +
+            '  contents: read\n\n' +
+            'jobs:\n' +
+            '  validate:\n' +
+            '    runs-on: ubuntu-latest\n' +
+            '    steps:\n' +
+            '      - uses: actions/checkout@v4\n\n' +
+            '      - name: Build and test\n' +
+            '        run: |\n' +
+            '          ' + todoBuildCmd + '\n' +
+            buildHints + '\n' +
+            '          echo "No build commands configured — update squad-preview.yml"\n\n' +
+            '      - name: Validate\n' +
+            '        run: |\n' +
+            '          # TODO: Add pre-release validation commands here\n' +
+            '          echo "No validation commands configured — update squad-preview.yml"\n';
+    }
+    if (workflowFile === 'squad-insider-release.yml') {
+        return 'name: Squad Insider Release\n' +
+            '# ' + typeLabel + ' — configure build, test, and insider release commands below\n\n' +
+            'on:\n' +
+            '  push:\n' +
+            '    branches: [insider]\n\n' +
+            'permissions:\n' +
+            '  contents: write\n\n' +
+            'jobs:\n' +
+            '  release:\n' +
+            '    runs-on: ubuntu-latest\n' +
+            '    steps:\n' +
+            '      - uses: actions/checkout@v4\n' +
+            '        with:\n' +
+            '          fetch-depth: 0\n\n' +
+            '      - name: Build and test\n' +
+            '        run: |\n' +
+            '          ' + todoBuildCmd + '\n' +
+            buildHints + '\n' +
+            '          echo "No build commands configured — update squad-insider-release.yml"\n\n' +
+            '      - name: Create insider release\n' +
+            '        env:\n' +
+            '          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n' +
+            '        run: |\n' +
+            '          # TODO: Add your insider/pre-release commands here\n' +
+            '          echo "No release commands configured — update squad-insider-release.yml"\n';
+    }
+    if (workflowFile === 'squad-docs.yml') {
+        return 'name: Squad Docs — Build & Deploy\n' +
+            '# ' + typeLabel + ' — configure documentation build commands below\n\n' +
+            'on:\n' +
+            '  workflow_dispatch:\n' +
+            '  push:\n' +
+            '    branches: [preview]\n' +
+            '    paths:\n' +
+            "      - 'docs/**'\n" +
+            "      - '.github/workflows/squad-docs.yml'\n\n" +
+            'permissions:\n' +
+            '  contents: read\n' +
+            '  pages: write\n' +
+            '  id-token: write\n\n' +
+            'jobs:\n' +
+            '  build:\n' +
+            '    runs-on: ubuntu-latest\n' +
+            '    steps:\n' +
+            '      - uses: actions/checkout@v4\n\n' +
+            '      - name: Build docs\n' +
+            '        run: |\n' +
+            '          # TODO: Add your documentation build commands here\n' +
+            '          # This workflow is optional — remove or customize it for your project\n' +
+            '          echo "No docs build commands configured — update or remove squad-docs.yml"\n';
+    }
+    return null;
+}
+/**
+ * Write workflow file: verbatim copy for npm, stub for others
+ */
+function writeWorkflowFile(file, srcPath, destPath, projectType) {
+    if (projectType !== 'npm' && PROJECT_TYPE_SENSITIVE_WORKFLOWS.has(file)) {
+        const stub = generateProjectWorkflowStub(file, projectType);
+        if (stub) {
+            fs.writeFileSync(destPath, stub);
+            return;
+        }
+    }
+    fs.copyFileSync(srcPath, destPath);
+}
+/**
+ * Get CLI version from package.json
+ */
+function getCLIVersion() {
+    try {
+        // From src/cli/core/upgrade.ts, go up to package root
+        const pkgPath = path.join(currentDir, '..', '..', '..', 'package.json');
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        return pkg.version || '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/**
+ * Run the upgrade command
+ */
+export async function runUpgrade(dest, options = {}) {
+    const cliVersion = getCLIVersion();
+    const filesUpdated = [];
+    // Detect squad directory
+    const squadDirInfo = detectSquadDir(dest);
+    if (squadDirInfo.isLegacy) {
+        warn('DEPRECATION: .ai-team/ is deprecated and will be removed in v1.0.0');
+        warn("Run 'squad upgrade --migrate-directory' to migrate to .squad/");
+        console.log();
+    }
+    // Verify squad exists
+    if (!fs.existsSync(squadDirInfo.path)) {
+        fatal('No squad found — run init first.');
+    }
+    const agentDest = path.join(dest, '.github', 'agents', 'squad.agent.md');
+    const oldVersion = readInstalledVersion(agentDest);
+    // Check if already current
+    const isAlreadyCurrent = oldVersion && oldVersion !== '0.0.0' && compareSemver(oldVersion, cliVersion) === 0;
+    const projectType = detectProjectType(dest);
+    if (isAlreadyCurrent) {
+        info(`Already up to date (v${cliVersion})`);
+        // Still run missing migrations
+        const migrationsApplied = await runMigrations(squadDirInfo.path, oldVersion, cliVersion);
+        // Refresh squad-owned files even when version matches
+        const templatesDir = getTemplatesDir();
+        const workflowsSrc = path.join(templatesDir, 'workflows');
+        const workflowsDest = path.join(dest, '.github', 'workflows');
+        if (fs.existsSync(workflowsSrc)) {
+            const wfFiles = fs.readdirSync(workflowsSrc).filter(f => f.endsWith('.yml'));
+            fs.mkdirSync(workflowsDest, { recursive: true });
+            for (const file of wfFiles) {
+                writeWorkflowFile(file, path.join(workflowsSrc, file), path.join(workflowsDest, file), projectType);
+            }
+            success(`upgraded squad workflows (${wfFiles.length} files)`);
+            filesUpdated.push(`workflows (${wfFiles.length} files)`);
+        }
+        // Refresh squad.agent.md
+        const agentSrc = path.join(templatesDir, 'squad.agent.md');
+        if (fs.existsSync(agentSrc)) {
+            fs.mkdirSync(path.dirname(agentDest), { recursive: true });
+            fs.copyFileSync(agentSrc, agentDest);
+            stampVersion(agentDest, cliVersion);
+            success('upgraded squad.agent.md');
+            filesUpdated.push('squad.agent.md');
+        }
+        return {
+            fromVersion: oldVersion,
+            toVersion: cliVersion,
+            filesUpdated,
+            migrationsRun: migrationsApplied,
+        };
+    }
+    // Upgrade squad.agent.md
+    const templatesDir = getTemplatesDir();
+    const agentSrc = path.join(templatesDir, 'squad.agent.md');
+    if (!fs.existsSync(agentSrc)) {
+        fatal('squad.agent.md not found in templates — installation may be corrupted');
+    }
+    fs.mkdirSync(path.dirname(agentDest), { recursive: true });
+    fs.copyFileSync(agentSrc, agentDest);
+    stampVersion(agentDest, cliVersion);
+    const fromLabel = oldVersion === '0.0.0' || !oldVersion ? 'unknown' : oldVersion;
+    success(`upgraded coordinator from ${fromLabel} to ${cliVersion}`);
+    filesUpdated.push('squad.agent.md');
+    // Upgrade squad-owned files from template manifest
+    const filesToUpgrade = TEMPLATE_MANIFEST.filter(f => f.overwriteOnUpgrade);
+    for (const file of filesToUpgrade) {
+        const srcPath = path.join(templatesDir, file.source);
+        const destPath = path.join(squadDirInfo.path, file.destination);
+        if (!fs.existsSync(srcPath))
+            continue;
+        fs.mkdirSync(path.dirname(destPath), { recursive: true });
+        fs.copyFileSync(srcPath, destPath);
+        filesUpdated.push(file.destination);
+    }
+    if (filesToUpgrade.length > 0) {
+        success(`upgraded ${filesToUpgrade.length} squad-owned files`);
+    }
+    // Upgrade workflows
+    const workflowsSrc = path.join(templatesDir, 'workflows');
+    const workflowsDest = path.join(dest, '.github', 'workflows');
+    if (fs.existsSync(workflowsSrc)) {
+        const wfFiles = fs.readdirSync(workflowsSrc).filter(f => f.endsWith('.yml'));
+        fs.mkdirSync(workflowsDest, { recursive: true });
+        for (const file of wfFiles) {
+            writeWorkflowFile(file, path.join(workflowsSrc, file), path.join(workflowsDest, file), projectType);
+        }
+        success(`upgraded squad workflows (${wfFiles.length} files)`);
+        filesUpdated.push(`workflows (${wfFiles.length} files)`);
+    }
+    // Run migrations
+    const migrationsApplied = await runMigrations(squadDirInfo.path, oldVersion, cliVersion);
+    // Update copilot-instructions.md if @copilot is enabled
+    const copilotInstructionsSrc = path.join(templatesDir, 'copilot-instructions.md');
+    const copilotInstructionsDest = path.join(dest, '.github', 'copilot-instructions.md');
+    const teamMdPath = path.join(squadDirInfo.path, 'team.md');
+    if (fs.existsSync(teamMdPath)) {
+        const teamContent = fs.readFileSync(teamMdPath, 'utf8');
+        const copilotEnabled = teamContent.includes('🤖 Coding Agent');
+        if (copilotEnabled && fs.existsSync(copilotInstructionsSrc)) {
+            fs.mkdirSync(path.dirname(copilotInstructionsDest), { recursive: true });
+            fs.copyFileSync(copilotInstructionsSrc, copilotInstructionsDest);
+            success('upgraded .github/copilot-instructions.md');
+            filesUpdated.push('copilot-instructions.md');
+        }
+    }
+    console.log();
+    info(`Upgrade complete: v${fromLabel} → v${cliVersion}`);
+    dim('Never touches user state: team.md, decisions/, agents/*/history.md');
+    console.log();
+    return {
+        fromVersion: fromLabel,
+        toVersion: cliVersion,
+        filesUpdated,
+        migrationsRun: migrationsApplied,
+    };
+}
+//# sourceMappingURL=upgrade.js.map