@bradygaster/squad-sdk 0.7.0 → 0.8.2

package/dist/build/ci-pipeline.js

@@ -0,0 +1,180 @@
+/**
+ * M4-9: CI/CD pipeline for distribution
+ * Generates GitHub Actions workflow YAML for build, test, and release pipelines.
+ */
+const DEFAULT_STEPS = [
+    { name: 'Lint', command: 'npm run lint' },
+    { name: 'Build', command: 'npm run build' },
+    { name: 'Test', command: 'npm test' },
+    { name: 'Bundle', command: 'npx esbuild src/index.ts --bundle --format=esm --outdir=dist' },
+];
+const PUBLISH_STEP = {
+    name: 'Publish',
+    command: 'npm publish --access public',
+    env: { NODE_AUTH_TOKEN: '${{ secrets.NPM_TOKEN }}' },
+};
+const TAG_STEP = {
+    name: 'Tag',
+    command: 'git tag v${{ github.event.release.tag_name }}',
+};
+function indent(text, spaces) {
+    const pad = ' '.repeat(spaces);
+    return text.split('\n').map(l => l.length > 0 ? pad + l : l).join('\n');
+}
+function yamlEnv(env, spaces) {
+    const pad = ' '.repeat(spaces);
+    return Object.entries(env).map(([k, v]) => `${pad}${k}: ${v}`).join('\n');
+}
+/**
+ * Generate a GitHub Actions CI workflow YAML string.
+ */
+export function generateGitHubActionsWorkflow(config) {
+    const nodeVersion = config.nodeVersion ?? '20';
+    const lines = [];
+    lines.push(`name: ${config.name}`);
+    lines.push('');
+    lines.push('on:');
+    for (const trigger of config.triggers) {
+        if (trigger.event === 'schedule' && trigger.cron) {
+            lines.push('  schedule:');
+            lines.push(`    - cron: '${trigger.cron}'`);
+        }
+        else if (trigger.event === 'workflow_dispatch') {
+            lines.push('  workflow_dispatch:');
+        }
+        else if (trigger.event === 'push') {
+            lines.push('  push:');
+            if (trigger.branches?.length) {
+                lines.push('    branches:');
+                for (const b of trigger.branches)
+                    lines.push(`      - ${b}`);
+            }
+            if (trigger.tags?.length) {
+                lines.push('    tags:');
+                for (const t of trigger.tags)
+                    lines.push(`      - ${t}`);
+            }
+        }
+        else if (trigger.event === 'pull_request') {
+            lines.push('  pull_request:');
+            if (trigger.branches?.length) {
+                lines.push('    branches:');
+                for (const b of trigger.branches)
+                    lines.push(`      - ${b}`);
+            }
+        }
+        else if (trigger.event === 'release') {
+            lines.push('  release:');
+            lines.push('    types: [published]');
+        }
+    }
+    lines.push('');
+    if (Object.keys(config.environment).length > 0) {
+        lines.push('env:');
+        for (const [k, v] of Object.entries(config.environment)) {
+            lines.push(`  ${k}: ${v}`);
+        }
+        lines.push('');
+    }
+    lines.push('jobs:');
+    lines.push('  build:');
+    lines.push('    runs-on: ubuntu-latest');
+    lines.push('    steps:');
+    lines.push('      - uses: actions/checkout@v4');
+    lines.push('      - uses: actions/setup-node@v4');
+    lines.push('        with:');
+    lines.push(`          node-version: '${nodeVersion}'`);
+    lines.push('          cache: npm');
+    lines.push('      - run: npm ci');
+    for (const step of config.steps) {
+        lines.push(`      - name: ${step.name}`);
+        lines.push(`        run: ${step.command}`);
+        if (step.condition) {
+            lines.push(`        if: ${step.condition}`);
+        }
+        if (step.env && Object.keys(step.env).length > 0) {
+            lines.push('        env:');
+            for (const [k, v] of Object.entries(step.env)) {
+                lines.push(`          ${k}: ${v}`);
+            }
+        }
+    }
+    for (const artifact of config.artifacts) {
+        lines.push('      - uses: actions/upload-artifact@v4');
+        lines.push(`        name: Upload ${artifact.name}`);
+        lines.push('        with:');
+        lines.push(`          name: ${artifact.name}`);
+        lines.push(`          path: ${artifact.path}`);
+        if (artifact.retention) {
+            lines.push(`          retention-days: ${artifact.retention}`);
+        }
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Generate a release workflow YAML string.
+ */
+export function generateReleaseWorkflow(config) {
+    const releaseConfig = {
+        ...config,
+        name: `${config.name} — Release`,
+        triggers: [{ event: 'release', tags: ['v*'] }],
+        steps: [
+            ...config.steps,
+            PUBLISH_STEP,
+            TAG_STEP,
+        ],
+    };
+    return generateGitHubActionsWorkflow(releaseConfig);
+}
+/**
+ * Validate a CI pipeline configuration for completeness and correctness.
+ */
+export function validatePipelineConfig(config) {
+    const errors = [];
+    const warnings = [];
+    if (!config.name || typeof config.name !== 'string' || config.name.trim().length === 0) {
+        errors.push('Pipeline name is required');
+    }
+    if (!config.steps || config.steps.length === 0) {
+        errors.push('Pipeline must have at least one step');
+    }
+    else {
+        for (let i = 0; i < config.steps.length; i++) {
+            const step = config.steps[i];
+            if (!step.name)
+                errors.push(`Step ${i} missing name`);
+            if (!step.command)
+                errors.push(`Step ${i} missing command`);
+        }
+    }
+    if (!config.triggers || config.triggers.length === 0) {
+        errors.push('Pipeline must have at least one trigger');
+    }
+    else {
+        for (const trigger of config.triggers) {
+            if (trigger.event === 'schedule' && !trigger.cron) {
+                errors.push('Schedule trigger requires a cron expression');
+            }
+        }
+    }
+    if (!config.artifacts) {
+        warnings.push('No artifacts configured');
+    }
+    const stepNames = config.steps?.map(s => s.name) ?? [];
+    if (!stepNames.some(n => n.toLowerCase().includes('test'))) {
+        warnings.push('Pipeline has no test step');
+    }
+    if (!stepNames.some(n => n.toLowerCase().includes('lint'))) {
+        warnings.push('Pipeline has no lint step');
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+/**
+ * Get the default CI pipeline steps.
+ */
+export function getDefaultSteps() {
+    return DEFAULT_STEPS.map(s => ({ ...s, env: s.env ? { ...s.env } : undefined }));
+}
+//# sourceMappingURL=ci-pipeline.js.map

package/dist/build/ci-pipeline.js.map

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

package/dist/build/github-dist.d.ts

@@ -0,0 +1,37 @@
+/**
+ * M4-3: GitHub distribution (npx github:bradygaster/squad)
+ * Supports GitHub Releases distribution and npx execution.
+ */
+export interface GitHubDistConfig {
+    owner: string;
+    repo: string;
+    binaryName: string;
+    installCommandTemplate: string;
+}
+/**
+ * Generate a shell script that downloads and installs from GitHub releases.
+ */
+export declare function generateInstallScript(config?: Partial<GitHubDistConfig>): string;
+export interface ReleaseValidationResult {
+    valid: boolean;
+    errors: string[];
+    version: string;
+    expectedAssets: string[];
+}
+/**
+ * Validate that a GitHub release has the expected assets.
+ */
+export declare function validateGitHubRelease(config: GitHubDistConfig, version: string): ReleaseValidationResult;
+/**
+ * Get the npx install command string.
+ */
+export declare function getInstallCommand(config?: Partial<GitHubDistConfig>): string;
+/**
+ * Generate the bin script that runs when npx invokes the package.
+ */
+export declare function generateNpxEntryPoint(): string;
+/**
+ * Get the default GitHub distribution config.
+ */
+export declare function getDefaultDistConfig(): GitHubDistConfig;
+//# sourceMappingURL=github-dist.d.ts.map

package/dist/build/github-dist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-dist.d.ts","sourceRoot":"","sources":["../../src/build/github-dist.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AASD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAwBhF;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,uBAAuB,CA0BxG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAK5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAuB9C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,CAEvD"}

package/dist/build/github-dist.js

@@ -0,0 +1,117 @@
+/**
+ * M4-3: GitHub distribution (npx github:bradygaster/squad)
+ * Supports GitHub Releases distribution and npx execution.
+ */
+const DEFAULT_CONFIG = {
+    owner: 'bradygaster',
+    repo: 'squad',
+    binaryName: 'squad',
+    installCommandTemplate: 'npx github:{{owner}}/{{repo}}',
+};
+/**
+ * Generate a shell script that downloads and installs from GitHub releases.
+ */
+export function generateInstallScript(config) {
+    const c = resolveConfig(config);
+    return `#!/usr/bin/env bash
+set -euo pipefail
+
+OWNER="${c.owner}"
+REPO="${c.repo}"
+BINARY="${c.binaryName}"
+
+# Detect latest version from GitHub API
+VERSION=\${1:-$(curl -sL "https://api.github.com/repos/\${OWNER}/\${REPO}/releases/latest" | grep '"tag_name"' | sed -E 's/.*"v?([^"]+)".*/\\1/')}
+
+echo "Installing \${BINARY} v\${VERSION}..."
+
+DOWNLOAD_URL="https://github.com/\${OWNER}/\${REPO}/releases/download/v\${VERSION}/\${BINARY}-\${VERSION}.tar.gz"
+INSTALL_DIR="\${HOME}/.local/bin"
+
+mkdir -p "\${INSTALL_DIR}"
+curl -sL "\${DOWNLOAD_URL}" | tar xz -C "\${INSTALL_DIR}"
+chmod +x "\${INSTALL_DIR}/\${BINARY}"
+
+echo "\${BINARY} v\${VERSION} installed to \${INSTALL_DIR}/\${BINARY}"
+echo "Make sure \${INSTALL_DIR} is in your PATH."
+`;
+}
+/**
+ * Validate that a GitHub release has the expected assets.
+ */
+export function validateGitHubRelease(config, version) {
+    const errors = [];
+    const expectedAssets = [
+        `${config.binaryName}-${version}.tar.gz`,
+        `${config.binaryName}-${version}.zip`,
+    ];
+    if (!version || typeof version !== 'string') {
+        errors.push('Version is required');
+    }
+    else if (!/^\d+\.\d+\.\d+/.test(version)) {
+        errors.push(`Invalid semver version: ${version}`);
+    }
+    if (!config.owner) {
+        errors.push('Missing owner in config');
+    }
+    if (!config.repo) {
+        errors.push('Missing repo in config');
+    }
+    if (!config.binaryName) {
+        errors.push('Missing binaryName in config');
+    }
+    return { valid: errors.length === 0, errors, version: version || '', expectedAssets };
+}
+/**
+ * Get the npx install command string.
+ */
+export function getInstallCommand(config) {
+    const c = resolveConfig(config);
+    return c.installCommandTemplate
+        .replace('{{owner}}', c.owner)
+        .replace('{{repo}}', c.repo);
+}
+/**
+ * Generate the bin script that runs when npx invokes the package.
+ */
+export function generateNpxEntryPoint() {
+    return `#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+async function main() {
+  try {
+    const { main: run } = await import(join(__dirname, 'index.js'));
+    if (typeof run === 'function') {
+      await run();
+    }
+  } catch (err) {
+    console.error('squad: failed to start —', err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+}
+
+main();
+`;
+}
+/**
+ * Get the default GitHub distribution config.
+ */
+export function getDefaultDistConfig() {
+    return { ...DEFAULT_CONFIG };
+}
+function resolveConfig(config) {
+    if (!config)
+        return { ...DEFAULT_CONFIG };
+    return {
+        owner: config.owner ?? DEFAULT_CONFIG.owner,
+        repo: config.repo ?? DEFAULT_CONFIG.repo,
+        binaryName: config.binaryName ?? DEFAULT_CONFIG.binaryName,
+        installCommandTemplate: config.installCommandTemplate ?? DEFAULT_CONFIG.installCommandTemplate,
+    };
+}
+//# sourceMappingURL=github-dist.js.map

package/dist/build/github-dist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-dist.js","sourceRoot":"","sources":["../../src/build/github-dist.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,cAAc,GAAqB;IACvC,KAAK,EAAE,aAAa;IACpB,IAAI,EAAE,OAAO;IACb,UAAU,EAAE,OAAO;IACnB,sBAAsB,EAAE,+BAA+B;CACxD,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAkC;IACtE,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO;;;SAGA,CAAC,CAAC,KAAK;QACR,CAAC,CAAC,IAAI;UACJ,CAAC,CAAC,UAAU;;;;;;;;;;;;;;;;CAgBrB,CAAC;AACF,CAAC;AASD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAwB,EAAE,OAAe;IAC7E,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,cAAc,GAAG;QACrB,GAAG,MAAM,CAAC,UAAU,IAAI,OAAO,SAAS;QACxC,GAAG,MAAM,CAAC,UAAU,IAAI,OAAO,MAAM;KACtC,CAAC;IAEF,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACrC,CAAC;SAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,cAAc,EAAE,CAAC;AACxF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAkC;IAClE,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,CAAC,sBAAsB;SAC5B,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC;SAC7B,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;;;;;;;CAqBR,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,aAAa,CAAC,MAAkC;IACvD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC1C,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,cAAc,CAAC,KAAK;QAC3C,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,cAAc,CAAC,IAAI;QACxC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,cAAc,CAAC,UAAU;QAC1D,sBAAsB,EAAE,MAAM,CAAC,sBAAsB,IAAI,cAAc,CAAC,sBAAsB;KAC/F,CAAC;AACJ,CAAC"}

package/dist/build/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Build & distribution module exports
+ */
+export * from './bundle.js';
+export * from './npm-package.js';
+export * from './github-dist.js';
+export * from './ci-pipeline.js';
+export * from './versioning.js';
+export * from './install-migration.js';
+export { type ReleaseChannel as BuildReleaseChannel, type ReleaseConfig, type ReleaseArtifact, type ReleaseManifest, type ReleaseValidationError, type ReleaseChecklistItem, computeSha256, buildArtifact, createRelease, validateRelease, generateReleaseNotes, getReleaseChecklist, } from './release.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/build/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EACL,KAAK,cAAc,IAAI,mBAAmB,EAC1C,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,cAAc,CAAC"}

package/dist/build/index.js

@@ -0,0 +1,11 @@
+/**
+ * Build & distribution module exports
+ */
+export * from './bundle.js';
+export * from './npm-package.js';
+export * from './github-dist.js';
+export * from './ci-pipeline.js';
+export * from './versioning.js';
+export * from './install-migration.js';
+export { computeSha256, buildArtifact, createRelease, validateRelease, generateReleaseNotes, getReleaseChecklist, } from './release.js';
+//# sourceMappingURL=index.js.map

package/dist/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/build/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAOL,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,cAAc,CAAC"}

package/dist/build/install-migration.d.ts

@@ -0,0 +1,28 @@
+/**
+ * M4-11: Migration for install path changes
+ * Detects current install method and generates migration instructions.
+ */
+export type InstallMethod = 'npx-github' | 'npm-global' | 'npm-local' | 'unknown';
+export interface MigrationStep {
+    description: string;
+    command?: string;
+    manual?: boolean;
+}
+export interface MigrationPlan {
+    from: InstallMethod;
+    to: InstallMethod;
+    steps: MigrationStep[];
+}
+/**
+ * Detect the current install method based on environment heuristics.
+ */
+export declare function detectInstallMethod(): InstallMethod;
+/**
+ * Generate a migration plan between install methods.
+ */
+export declare function migrateInstallPath(from: InstallMethod, to: InstallMethod): MigrationPlan;
+/**
+ * Generate user-facing markdown migration instructions.
+ */
+export declare function generateMigrationInstructions(from: InstallMethod, to: InstallMethod): string;
+//# sourceMappingURL=install-migration.d.ts.map

package/dist/build/install-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-migration.d.ts","sourceRoot":"","sources":["../../src/build/install-migration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,CAAC;AAElF,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,aAAa,CAAC;IAClB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAkBnD;AAiCD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,GAAG,aAAa,CAqBxF;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,GAAG,MAAM,CA6B5F"}

package/dist/build/install-migration.js

@@ -0,0 +1,103 @@
+/**
+ * M4-11: Migration for install path changes
+ * Detects current install method and generates migration instructions.
+ */
+/**
+ * Detect the current install method based on environment heuristics.
+ */
+export function detectInstallMethod() {
+    // Check for npm global prefix
+    const execPath = process.argv[1] ?? '';
+    const npmGlobalPrefix = process.env.npm_config_prefix ?? '';
+    if (process.env.npm_execpath?.includes('npx') || execPath.includes('_npx')) {
+        return 'npx-github';
+    }
+    if (npmGlobalPrefix && execPath.startsWith(npmGlobalPrefix)) {
+        return 'npm-global';
+    }
+    if (execPath.includes('node_modules')) {
+        return 'npm-local';
+    }
+    return 'unknown';
+}
+const MIGRATION_STEPS = {
+    'npx-github->npm-global': [
+        { description: 'Install the squad package globally from npm', command: 'npm install -g @bradygaster/squad' },
+        { description: 'Verify the installation', command: 'squad --version' },
+        { description: 'Remove any cached npx versions', command: 'npx --yes clear-npx-cache || true' },
+    ],
+    'npx-github->npm-local': [
+        { description: 'Add squad as a local dev dependency', command: 'npm install --save-dev @bradygaster/squad' },
+        { description: 'Add a script entry in package.json', manual: true, command: undefined },
+        { description: 'Verify the installation', command: 'npx squad --version' },
+    ],
+    'npm-global->npm-local': [
+        { description: 'Add squad as a local dev dependency', command: 'npm install --save-dev @bradygaster/squad' },
+        { description: 'Optionally uninstall the global version', command: 'npm uninstall -g @bradygaster/squad' },
+        { description: 'Use npx squad or add an npm script to run locally' },
+    ],
+    'npm-local->npm-global': [
+        { description: 'Install squad globally', command: 'npm install -g @bradygaster/squad' },
+        { description: 'Remove from local devDependencies', command: 'npm uninstall @bradygaster/squad' },
+        { description: 'Verify the global installation', command: 'squad --version' },
+    ],
+    'npm-global->npx-github': [
+        { description: 'Uninstall the global npm package', command: 'npm uninstall -g @bradygaster/squad' },
+        { description: 'Use npx to run directly from GitHub', command: 'npx github:bradygaster/squad' },
+    ],
+    'npm-local->npx-github': [
+        { description: 'Remove squad from local dependencies', command: 'npm uninstall @bradygaster/squad' },
+        { description: 'Use npx to run directly from GitHub', command: 'npx github:bradygaster/squad' },
+    ],
+};
+/**
+ * Generate a migration plan between install methods.
+ */
+export function migrateInstallPath(from, to) {
+    if (from === to) {
+        return { from, to, steps: [{ description: 'No migration needed — already using this install method' }] };
+    }
+    if (from === 'unknown') {
+        return { from, to, steps: [{ description: 'Cannot determine current install method; perform a fresh install', manual: true }] };
+    }
+    const key = `${from}->${to}`;
+    const steps = MIGRATION_STEPS[key];
+    if (!steps) {
+        return {
+            from,
+            to,
+            steps: [{ description: `Direct migration from ${from} to ${to} is not supported; uninstall and reinstall`, manual: true }],
+        };
+    }
+    return { from, to, steps: steps.map(s => ({ ...s })) };
+}
+/**
+ * Generate user-facing markdown migration instructions.
+ */
+export function generateMigrationInstructions(from, to) {
+    const plan = migrateInstallPath(from, to);
+    const lines = [];
+    lines.push(`# Migrate from \`${from}\` to \`${to}\``);
+    lines.push('');
+    if (plan.steps.length === 1 && from === to) {
+        lines.push('No migration needed — you are already using this install method.');
+        return lines.join('\n') + '\n';
+    }
+    for (let i = 0; i < plan.steps.length; i++) {
+        const step = plan.steps[i];
+        lines.push(`${i + 1}. ${step.description}`);
+        if (step.command) {
+            lines.push('');
+            lines.push('   ```bash');
+            lines.push(`   ${step.command}`);
+            lines.push('   ```');
+            lines.push('');
+        }
+        if (step.manual) {
+            lines.push('   *(manual step)*');
+            lines.push('');
+        }
+    }
+    return lines.join('\n').trimEnd() + '\n';
+}
+//# sourceMappingURL=install-migration.js.map

package/dist/build/install-migration.js.map

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

package/dist/build/npm-package.d.ts

@@ -0,0 +1,54 @@
+/**
+ * M4-2: npm bundling & registry publication
+ * Generates package.json content and validates npm publication readiness.
+ */
+export interface NpmPackageConfig {
+    name: string;
+    version: string;
+    description: string;
+    exports: Record<string, string | Record<string, string>>;
+    bin?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    engines?: Record<string, string>;
+}
+export interface PackageJsonOutput {
+    name: string;
+    version: string;
+    description: string;
+    type: string;
+    main: string;
+    types: string;
+    exports: Record<string, unknown>;
+    bin?: Record<string, string>;
+    files: string[];
+    peerDependencies?: Record<string, string>;
+    engines: Record<string, string>;
+    license: string;
+    repository: {
+        type: string;
+        url: string;
+    };
+    keywords: string[];
+}
+export interface PackageValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Generate package.json content suitable for npm publication.
+ */
+export declare function generatePackageJson(config: NpmPackageConfig): PackageJsonOutput;
+/**
+ * Validate a package.json object for npm publication readiness.
+ */
+export declare function validatePackageJson(pkg: Record<string, unknown>): PackageValidationResult;
+/**
+ * Return the files array for package.json publication.
+ */
+export declare function getPublishFiles(): string[];
+/**
+ * Return the default ESM exports map for the SDK.
+ */
+export declare function getDefaultExports(): Record<string, Record<string, string>>;
+//# sourceMappingURL=npm-package.d.ts.map

package/dist/build/npm-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-package.d.ts","sourceRoot":"","sources":["../../src/build/npm-package.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAgCD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,CA4B/E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,uBAAuB,CAsDzF;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAE1E"}