@bradygaster/squad-sdk 0.6.2 → 0.8.0

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"}

package/dist/build/npm-package.js

@@ -0,0 +1,128 @@
+/**
+ * M4-2: npm bundling & registry publication
+ * Generates package.json content and validates npm publication readiness.
+ */
+const DEFAULT_FILES = [
+    'dist/',
+    'README.md',
+    'LICENSE',
+    'CHANGELOG.md',
+];
+const DEFAULT_EXPORTS = {
+    '.': {
+        import: './dist/index.js',
+        types: './dist/index.d.ts',
+    },
+    './config': {
+        import: './dist/config/index.js',
+        types: './dist/config/index.d.ts',
+    },
+    './agents': {
+        import: './dist/agents/onboarding.js',
+        types: './dist/agents/onboarding.d.ts',
+    },
+    './skills': {
+        import: './dist/skills/index.js',
+        types: './dist/skills/index.d.ts',
+    },
+    './runtime': {
+        import: './dist/runtime/config.js',
+        types: './dist/runtime/config.d.ts',
+    },
+};
+/**
+ * Generate package.json content suitable for npm publication.
+ */
+export function generatePackageJson(config) {
+    const exports = {};
+    for (const [key, value] of Object.entries(config.exports)) {
+        if (typeof value === 'string') {
+            exports[key] = { import: value, types: value.replace(/\.js$/, '.d.ts') };
+        }
+        else {
+            exports[key] = { ...value };
+        }
+    }
+    return {
+        name: config.name,
+        version: config.version,
+        description: config.description,
+        type: 'module',
+        main: './dist/index.js',
+        types: './dist/index.d.ts',
+        exports,
+        ...(config.bin && Object.keys(config.bin).length > 0 ? { bin: { ...config.bin } } : {}),
+        files: [...DEFAULT_FILES],
+        ...(config.peerDependencies && Object.keys(config.peerDependencies).length > 0
+            ? { peerDependencies: { ...config.peerDependencies } }
+            : {}),
+        engines: config.engines ? { ...config.engines } : { node: '>=20.0.0' },
+        license: 'MIT',
+        repository: { type: 'git', url: 'https://github.com/bradygaster/squad.git' },
+        keywords: ['copilot', 'multi-agent', 'squad', 'sdk'],
+    };
+}
+/**
+ * Validate a package.json object for npm publication readiness.
+ */
+export function validatePackageJson(pkg) {
+    const errors = [];
+    const warnings = [];
+    if (!pkg.name || typeof pkg.name !== 'string') {
+        errors.push('Missing or invalid "name" field');
+    }
+    else {
+        if (!/^(@[a-z0-9-]+\/)?[a-z0-9._-]+$/.test(pkg.name)) {
+            errors.push(`Invalid package name: ${pkg.name}`);
+        }
+    }
+    if (!pkg.version || typeof pkg.version !== 'string') {
+        errors.push('Missing or invalid "version" field');
+    }
+    else {
+        if (!/^\d+\.\d+\.\d+/.test(pkg.version)) {
+            errors.push(`Invalid semver version: ${pkg.version}`);
+        }
+    }
+    if (!pkg.description || typeof pkg.description !== 'string') {
+        warnings.push('Missing "description" field');
+    }
+    if (!pkg.license || typeof pkg.license !== 'string') {
+        warnings.push('Missing "license" field');
+    }
+    if (!pkg.exports || typeof pkg.exports !== 'object') {
+        errors.push('Missing "exports" map — required for ESM packages');
+    }
+    else {
+        const exports = pkg.exports;
+        if (!exports['.']) {
+            errors.push('Exports map missing "." entry point');
+        }
+    }
+    if (pkg.type !== 'module') {
+        warnings.push('"type" should be "module" for ESM packages');
+    }
+    if (!pkg.files || !Array.isArray(pkg.files) || pkg.files.length === 0) {
+        warnings.push('Missing "files" field — all files will be published');
+    }
+    if (!pkg.engines || typeof pkg.engines !== 'object') {
+        warnings.push('Missing "engines" field — specify Node.js version requirement');
+    }
+    if (!pkg.repository || typeof pkg.repository !== 'object') {
+        warnings.push('Missing "repository" field');
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+/**
+ * Return the files array for package.json publication.
+ */
+export function getPublishFiles() {
+    return [...DEFAULT_FILES];
+}
+/**
+ * Return the default ESM exports map for the SDK.
+ */
+export function getDefaultExports() {
+    return JSON.parse(JSON.stringify(DEFAULT_EXPORTS));
+}
+//# sourceMappingURL=npm-package.js.map

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

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

package/dist/build/release.d.ts

@@ -0,0 +1,108 @@
+/**
+ * M6-13: Release candidate build & validation
+ * Handles release manifest creation, validation, and release notes generation.
+ *
+ * @module build/release
+ */
+import type { CommitInfo } from './versioning.js';
+/** Release channel. */
+export type ReleaseChannel = 'stable' | 'rc' | 'beta' | 'alpha';
+/**
+ * Configuration for creating a release.
+ */
+export interface ReleaseConfig {
+    /** Semver version string (e.g. "1.0.0", "1.0.0-rc.1") */
+    version: string;
+    /** Release channel */
+    channel: ReleaseChannel;
+    /** Whether this is a prerelease */
+    prerelease: boolean;
+    /** Git tag name (e.g. "v1.0.0-rc.1") */
+    tag: string;
+}
+/**
+ * An artifact included in a release.
+ */
+export interface ReleaseArtifact {
+    /** Display name */
+    name: string;
+    /** File path */
+    path: string;
+    /** File size in bytes */
+    size: number;
+    /** SHA-256 hash */
+    sha256: string;
+}
+/**
+ * Release manifest describing a complete release.
+ */
+export interface ReleaseManifest {
+    /** Semver version */
+    version: string;
+    /** Release channel */
+    channel: ReleaseChannel;
+    /** Build artifacts */
+    artifacts: ReleaseArtifact[];
+    /** ISO timestamp of the release */
+    timestamp: string;
+    /** Changelog markdown for this release */
+    changelog: string;
+}
+/**
+ * A validation error found in a release manifest.
+ */
+export interface ReleaseValidationError {
+    /** Field that failed validation */
+    field: string;
+    /** Error message */
+    message: string;
+    /** Severity */
+    severity: 'error' | 'warning';
+}
+/**
+ * A checklist item for the release process.
+ */
+export interface ReleaseChecklistItem {
+    /** Human-readable name */
+    name: string;
+    /** Function that checks this item (returns true if passing) */
+    check: () => boolean;
+    /** Whether this item is required for release */
+    required: boolean;
+    /** Current status */
+    status: 'pass' | 'fail' | 'skip';
+}
+/**
+ * Compute the SHA-256 hash of a buffer or string.
+ */
+export declare function computeSha256(data: Buffer | string): string;
+/**
+ * Build a ReleaseArtifact from a file path.
+ * Returns null if the file does not exist.
+ */
+export declare function buildArtifact(name: string, filePath: string): ReleaseArtifact | null;
+/**
+ * Create a release manifest from a ReleaseConfig.
+ *
+ * @param config - Release configuration
+ * @param artifactPaths - Optional map of artifact name → file path
+ * @returns Release manifest
+ */
+export declare function createRelease(config: ReleaseConfig, artifactPaths?: Record<string, string>): ReleaseManifest;
+/**
+ * Validate a release manifest for correctness.
+ *
+ * @param manifest - Release manifest to validate
+ * @returns Array of validation errors (empty if valid)
+ */
+export declare function validateRelease(manifest: ReleaseManifest): ReleaseValidationError[];
+/**
+ * Generate release notes markdown from a manifest and commit list.
+ */
+export declare function generateReleaseNotes(manifest: ReleaseManifest, commits: CommitInfo[]): string;
+/**
+ * Get the release checklist with default items.
+ * Each item's check function can be evaluated to determine pass/fail.
+ */
+export declare function getReleaseChecklist(manifest?: ReleaseManifest): ReleaseChecklistItem[];
+//# sourceMappingURL=release.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../src/build/release.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAOlD,uBAAuB;AACvB,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,mCAAmC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,sBAAsB;IACtB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,KAAK,EAAE,MAAM,OAAO,CAAC;IACrB,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,qBAAqB;IACrB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CAClC;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAYpF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EACrB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,eAAe,CAmBjB;AAQD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,sBAAsB,EAAE,CA2EnF;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,UAAU,EAAE,GACpB,MAAM,CAqER;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,oBAAoB,EAAE,CAyEtF"}