@bradygaster/squad-sdk 0.7.0 → 0.8.2

package/dist/build/versioning.js

@@ -0,0 +1,113 @@
+/**
+ * M4-10: Version stamping & CHANGELOG generation
+ * Conventional commits parsing, version bumping, and changelog output.
+ */
+/**
+ * Parse a conventional commit message into structured parts.
+ */
+export function parseConventionalCommit(message) {
+    const line = message.split('\n')[0].trim();
+    // Match: type(scope)!: description  or  type!: description  or  type: description
+    const match = line.match(/^(\w+)(?:\(([^)]*)\))?(!)?\s*:\s*(.+)$/);
+    if (!match) {
+        return { type: 'other', scope: null, description: line, breaking: false };
+    }
+    const [, type, scope, bang, description] = match;
+    const breaking = bang === '!' || /^BREAKING[ -]CHANGE\b/i.test(message);
+    return {
+        type: type.toLowerCase(),
+        scope: scope ?? null,
+        description: description.trim(),
+        breaking,
+    };
+}
+/**
+ * Bump a semver version string by the given increment type.
+ */
+export function bumpVersion(current, type) {
+    // Strip leading 'v' if present
+    const stripped = current.startsWith('v') ? current.slice(1) : current;
+    const prereleaseMatch = stripped.match(/^(\d+)\.(\d+)\.(\d+)(?:-([a-zA-Z]+)\.(\d+))?$/);
+    if (!prereleaseMatch) {
+        throw new Error(`Invalid semver version: ${current}`);
+    }
+    let [, majorStr, minorStr, patchStr, preTag, preNum] = prereleaseMatch;
+    let major = parseInt(majorStr, 10);
+    let minor = parseInt(minorStr, 10);
+    let patch = parseInt(patchStr, 10);
+    switch (type) {
+        case 'major':
+            return `${major + 1}.0.0`;
+        case 'minor':
+            return `${major}.${minor + 1}.0`;
+        case 'patch':
+            return `${major}.${minor}.${patch + 1}`;
+        case 'prerelease': {
+            if (preTag && preNum !== undefined) {
+                return `${major}.${minor}.${patch}-${preTag}.${parseInt(preNum, 10) + 1}`;
+            }
+            return `${major}.${minor}.${patch + 1}-alpha.0`;
+        }
+    }
+}
+/**
+ * Stamp a version string into the specified file contents.
+ * Returns an array of { file, content } with the version replaced.
+ */
+export function stampVersion(version, files) {
+    return files.map(file => ({
+        file,
+        content: version,
+    }));
+}
+/**
+ * Generate a CHANGELOG entry from a list of conventional commits.
+ */
+export function generateChangelog(commits, currentVersion) {
+    const date = new Date().toISOString().slice(0, 10);
+    const lines = [];
+    lines.push(`## ${currentVersion} (${date})`);
+    lines.push('');
+    const groups = {};
+    const breaking = [];
+    for (const commit of commits) {
+        const parsed = parseConventionalCommit(commit.message);
+        if (parsed.breaking) {
+            breaking.push(`- ${parsed.description} (${commit.sha.slice(0, 7)})`);
+        }
+        const key = parsed.type;
+        if (!groups[key])
+            groups[key] = [];
+        groups[key].push({ scope: parsed.scope, description: parsed.description, sha: commit.sha });
+    }
+    if (breaking.length > 0) {
+        lines.push('### ⚠ BREAKING CHANGES');
+        lines.push('');
+        lines.push(...breaking);
+        lines.push('');
+    }
+    const headings = {
+        feat: '### Features',
+        fix: '### Bug Fixes',
+        perf: '### Performance',
+        refactor: '### Refactoring',
+        docs: '### Documentation',
+        chore: '### Chores',
+        test: '### Tests',
+        ci: '### CI',
+    };
+    for (const [type, heading] of Object.entries(headings)) {
+        const items = groups[type];
+        if (!items || items.length === 0)
+            continue;
+        lines.push(heading);
+        lines.push('');
+        for (const item of items) {
+            const scopeStr = item.scope ? `**${item.scope}:** ` : '';
+            lines.push(`- ${scopeStr}${item.description} (${item.sha.slice(0, 7)})`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd() + '\n';
+}
+//# sourceMappingURL=versioning.js.map

package/dist/build/versioning.js.map

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

package/dist/casting/casting-engine.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Casting Engine v1 (M3-2, Issue #138)
+ *
+ * Generates themed agent personas from a universe template.
+ * Each CastMember maps to an agent role with name, personality, and backstory.
+ */
+export type AgentRole = 'lead' | 'developer' | 'tester' | 'prompt-engineer' | 'security' | 'devops' | 'designer' | 'scribe' | 'reviewer';
+export type UniverseId = 'usual-suspects' | 'oceans-eleven' | 'custom';
+export interface CastMember {
+    /** Character name from the universe */
+    name: string;
+    /** Agent role this character fills */
+    role: AgentRole;
+    /** One-line personality trait */
+    personality: string;
+    /** Short backstory for system-prompt injection */
+    backstory: string;
+    /** Display name: "Name — Role" */
+    displayName: string;
+}
+export interface CastingConfig {
+    /** Universe theme to draw characters from */
+    universe: UniverseId;
+    /** Desired team size (clamped to available characters) */
+    teamSize?: number;
+    /** Roles that must be filled */
+    requiredRoles?: AgentRole[];
+    /** Custom character names (only for universe = 'custom') */
+    customNames?: Record<AgentRole, string>;
+}
+interface UniverseCharacter {
+    name: string;
+    personality: string;
+    backstory: string;
+    preferredRoles: AgentRole[];
+}
+interface UniverseTemplate {
+    id: UniverseId;
+    label: string;
+    characters: UniverseCharacter[];
+}
+export declare class CastingEngine {
+    /** List available universe IDs. */
+    getUniverses(): UniverseId[];
+    /** Get a universe template by ID. */
+    getUniverse(id: UniverseId): UniverseTemplate | undefined;
+    /**
+     * Cast a team of agents from a universe.
+     *
+     * Roles are filled by best-fit characters (preferredRoles match).
+     * Required roles are guaranteed to be present.
+     * Team size is clamped to available characters.
+     */
+    castTeam(config: CastingConfig): CastMember[];
+    private castCustomTeam;
+    private findBestFit;
+    private toCastMember;
+}
+export {};
+//# sourceMappingURL=casting-engine.d.ts.map

package/dist/casting/casting-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"casting-engine.d.ts","sourceRoot":"","sources":["../../src/casting/casting-engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,WAAW,GACX,QAAQ,GACR,iBAAiB,GACjB,UAAU,GACV,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,UAAU,CAAC;AAEf,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,eAAe,GAAG,QAAQ,CAAC;AAEvE,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,EAAE,SAAS,CAAC;IAChB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,QAAQ,EAAE,UAAU,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,aAAa,CAAC,EAAE,SAAS,EAAE,CAAC;IAC5B,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;CACzC;AAID,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,SAAS,EAAE,CAAC;CAC7B;AAED,UAAU,gBAAgB;IACxB,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAmID,qBAAa,aAAa;IACxB,mCAAmC;IACnC,YAAY,IAAI,UAAU,EAAE;IAI5B,qCAAqC;IACrC,WAAW,CAAC,EAAE,EAAE,UAAU,GAAG,gBAAgB,GAAG,SAAS;IAIzD;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,EAAE;IA+C7C,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,YAAY;CASrB"}

package/dist/casting/casting-engine.js

@@ -0,0 +1,223 @@
+/**
+ * Casting Engine v1 (M3-2, Issue #138)
+ *
+ * Generates themed agent personas from a universe template.
+ * Each CastMember maps to an agent role with name, personality, and backstory.
+ */
+const USUAL_SUSPECTS = {
+    id: 'usual-suspects',
+    label: 'The Usual Suspects',
+    characters: [
+        {
+            name: 'Keyser',
+            personality: 'Quietly commanding; sees the whole board before anyone else.',
+            backstory: 'A legendary figure who orchestrates from the shadows, ensuring every piece falls into place.',
+            preferredRoles: ['lead'],
+        },
+        {
+            name: 'McManus',
+            personality: 'Bold and direct; ships fast, asks questions later.',
+            backstory: 'The hotshot operator who dives headfirst into the hardest problems.',
+            preferredRoles: ['developer'],
+        },
+        {
+            name: 'Fenster',
+            personality: 'Eccentric communicator; finds bugs nobody else can see.',
+            backstory: 'Speaks in riddles but has an uncanny knack for spotting what everyone else missed.',
+            preferredRoles: ['tester'],
+        },
+        {
+            name: 'Verbal',
+            personality: 'Silver-tongued storyteller; turns complexity into clarity.',
+            backstory: 'The narrator who shapes every prompt and message into something an LLM can\'t misunderstand.',
+            preferredRoles: ['prompt-engineer', 'scribe'],
+        },
+        {
+            name: 'Hockney',
+            personality: 'Street-smart and suspicious; trusts no input.',
+            backstory: 'A seasoned skeptic who probes every surface for weaknesses before anyone else can.',
+            preferredRoles: ['security', 'reviewer'],
+        },
+        {
+            name: 'Redfoot',
+            personality: 'Resourceful fixer; keeps the machinery running.',
+            backstory: 'The behind-the-scenes operator who makes sure builds ship and pipelines stay green.',
+            preferredRoles: ['devops'],
+        },
+        {
+            name: 'Edie',
+            personality: 'Methodical and detail-oriented; nothing escapes review.',
+            backstory: 'A meticulous analyst who ensures every deliverable meets the bar.',
+            preferredRoles: ['reviewer', 'tester'],
+        },
+        {
+            name: 'Kobayashi',
+            personality: 'Precise and formal; an interface between worlds.',
+            backstory: 'The liaison who translates requirements into structured specifications.',
+            preferredRoles: ['designer', 'prompt-engineer'],
+        },
+    ],
+};
+const OCEANS_ELEVEN = {
+    id: 'oceans-eleven',
+    label: "Ocean's Eleven",
+    characters: [
+        {
+            name: 'Danny',
+            personality: 'Cool under pressure; the plan is always three steps ahead.',
+            backstory: 'The mastermind who assembles the crew and keeps the vision on track.',
+            preferredRoles: ['lead'],
+        },
+        {
+            name: 'Rusty',
+            personality: 'Effortlessly sharp; reads people and code with equal ease.',
+            backstory: 'The right hand who can debug a conversation or a stack trace mid-bite.',
+            preferredRoles: ['developer', 'reviewer'],
+        },
+        {
+            name: 'Linus',
+            personality: 'Eager and adaptable; learns fast, ships faster.',
+            backstory: 'The up-and-comer who takes on any coding challenge to prove his worth.',
+            preferredRoles: ['developer'],
+        },
+        {
+            name: 'Basher',
+            personality: 'Explosive creativity; demolishes blockers with flair.',
+            backstory: 'The demolitions expert who clears technical debt and obstacles in one blast.',
+            preferredRoles: ['devops', 'developer'],
+        },
+        {
+            name: 'Livingston',
+            personality: 'Quiet tech wizard; the surveillance and tooling expert.',
+            backstory: 'The electronics specialist who wires up monitoring, logging, and automation.',
+            preferredRoles: ['devops', 'tester'],
+        },
+        {
+            name: 'Saul',
+            personality: 'Old-school wisdom; plays the long game with finesse.',
+            backstory: 'A veteran con artist who crafts the perfect prompt persona for any situation.',
+            preferredRoles: ['prompt-engineer', 'scribe'],
+        },
+        {
+            name: 'Yen',
+            personality: 'Acrobatic precision; navigates tight constraints with grace.',
+            backstory: 'The acrobat who fits into the tightest security gaps and edge cases.',
+            preferredRoles: ['security', 'tester'],
+        },
+        {
+            name: 'Virgil',
+            personality: 'Steadfast and reliable; the backbone of every operation.',
+            backstory: 'Half of the dependable duo that handles the grunt work with quiet excellence.',
+            preferredRoles: ['developer', 'reviewer'],
+        },
+        {
+            name: 'Turk',
+            personality: 'Competitive and driven; races to finish first.',
+            backstory: 'The other half of the duo, always trying to one-up his partner in velocity.',
+            preferredRoles: ['developer', 'designer'],
+        },
+        {
+            name: 'Reuben',
+            personality: 'Strategic backer; knows what\'s worth investing in.',
+            backstory: 'The financier who scopes effort and ensures the plan is economically sound.',
+            preferredRoles: ['lead', 'reviewer'],
+        },
+    ],
+};
+const UNIVERSES = new Map([
+    ['usual-suspects', USUAL_SUSPECTS],
+    ['oceans-eleven', OCEANS_ELEVEN],
+]);
+// --- Casting Engine ---
+export class CastingEngine {
+    /** List available universe IDs. */
+    getUniverses() {
+        return Array.from(UNIVERSES.keys());
+    }
+    /** Get a universe template by ID. */
+    getUniverse(id) {
+        return UNIVERSES.get(id);
+    }
+    /**
+     * Cast a team of agents from a universe.
+     *
+     * Roles are filled by best-fit characters (preferredRoles match).
+     * Required roles are guaranteed to be present.
+     * Team size is clamped to available characters.
+     */
+    castTeam(config) {
+        if (config.universe === 'custom') {
+            return this.castCustomTeam(config);
+        }
+        const template = UNIVERSES.get(config.universe);
+        if (!template) {
+            throw new Error(`Unknown universe: ${config.universe}`);
+        }
+        const requiredRoles = config.requiredRoles ?? ['lead', 'developer', 'tester'];
+        const teamSize = Math.max(requiredRoles.length, Math.min(config.teamSize ?? requiredRoles.length, template.characters.length));
+        const assigned = new Set();
+        const members = [];
+        // Phase 1: Fill required roles by best-fit
+        for (const role of requiredRoles) {
+            const best = this.findBestFit(template.characters, role, assigned);
+            if (!best) {
+                throw new Error(`Cannot fill required role "${role}" — not enough characters in universe "${config.universe}".`);
+            }
+            assigned.add(best.name);
+            members.push(this.toCastMember(best, role));
+        }
+        // Phase 2: Fill remaining slots with unassigned characters
+        if (members.length < teamSize) {
+            const remaining = template.characters.filter((c) => !assigned.has(c.name));
+            for (const char of remaining) {
+                if (members.length >= teamSize)
+                    break;
+                const role = char.preferredRoles[0] ?? 'developer';
+                assigned.add(char.name);
+                members.push(this.toCastMember(char, role));
+            }
+        }
+        return members;
+    }
+    // --- Internals ---
+    castCustomTeam(config) {
+        if (!config.customNames || Object.keys(config.customNames).length === 0) {
+            throw new Error('customNames is required when universe is "custom".');
+        }
+        return Object.entries(config.customNames).map(([role, name]) => ({
+            name,
+            role,
+            personality: 'Custom team member.',
+            backstory: `${name} fills the ${role} role on this squad.`,
+            displayName: `${name} — ${formatRole(role)}`,
+        }));
+    }
+    findBestFit(characters, role, assigned) {
+        // Prefer characters whose first preferred role matches
+        const primary = characters.find((c) => !assigned.has(c.name) && c.preferredRoles[0] === role);
+        if (primary)
+            return primary;
+        // Fall back to any character that lists this role
+        const secondary = characters.find((c) => !assigned.has(c.name) && c.preferredRoles.includes(role));
+        if (secondary)
+            return secondary;
+        // Last resort: any unassigned character
+        return characters.find((c) => !assigned.has(c.name));
+    }
+    toCastMember(char, role) {
+        return {
+            name: char.name,
+            role,
+            personality: char.personality,
+            backstory: char.backstory,
+            displayName: `${char.name} — ${formatRole(role)}`,
+        };
+    }
+}
+function formatRole(role) {
+    return role
+        .split('-')
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+}
+//# sourceMappingURL=casting-engine.js.map

package/dist/casting/casting-engine.js.map

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

package/dist/casting/casting-history.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Casting History (M3-10, Issue #151)
+ *
+ * Tracks casting decisions over time and makes them queryable.
+ * Each record captures who was cast, when, and from which config.
+ */
+import type { CastMember, CastingConfig, UniverseId, AgentRole } from './casting-engine.js';
+export interface CastingRecordMember {
+    name: string;
+    role: AgentRole;
+}
+export interface CastingRecord {
+    /** When this cast was created */
+    timestamp: string;
+    /** Universe used for casting */
+    universe: UniverseId;
+    /** Number of agents cast */
+    teamSize: number;
+    /** Summary of each member */
+    members: CastingRecordMember[];
+    /** Snapshot of the config used */
+    configSnapshot: CastingConfig;
+}
+export interface SerializedCastingHistory {
+    version: 1;
+    records: CastingRecord[];
+}
+export declare class CastingHistory {
+    private records;
+    /**
+     * Record a casting decision.
+     *
+     * @param team - The cast team produced by CastingEngine
+     * @param config - The CastingConfig that produced this team
+     * @param timestamp - Optional override (defaults to now)
+     */
+    recordCast(team: CastMember[], config: CastingConfig, timestamp?: Date): CastingRecord;
+    /** Return all casting records, oldest first. */
+    getCastHistory(): CastingRecord[];
+    /**
+     * Return casting records that include a specific agent name.
+     * Useful for answering "when was Verbal last cast?"
+     */
+    getAgentHistory(agentName: string): CastingRecord[];
+    /** Number of recorded casts. */
+    get size(): number;
+    /** Clear all history. */
+    clear(): void;
+    /** Serialize history to a plain object suitable for JSON / config persistence. */
+    serializeHistory(): SerializedCastingHistory;
+    /** Restore history from a previously serialized object. Replaces current records. */
+    deserializeHistory(data: SerializedCastingHistory): void;
+}
+//# sourceMappingURL=casting-history.d.ts.map

package/dist/casting/casting-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"casting-history.d.ts","sourceRoot":"","sources":["../../src/casting/casting-history.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAI5F,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,QAAQ,EAAE,UAAU,CAAC;IACrB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,kCAAkC;IAClC,cAAc,EAAE,aAAa,CAAC;CAC/B;AAID,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAID,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAuB;IAEtC;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,IAAI,GAAG,aAAa;IAYtF,gDAAgD;IAChD,cAAc,IAAI,aAAa,EAAE;IAIjC;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE;IAMnD,gCAAgC;IAChC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,yBAAyB;IACzB,KAAK,IAAI,IAAI;IAMb,kFAAkF;IAClF,gBAAgB,IAAI,wBAAwB;IAO5C,qFAAqF;IACrF,kBAAkB,CAAC,IAAI,EAAE,wBAAwB,GAAG,IAAI;CAMzD"}

package/dist/casting/casting-history.js

@@ -0,0 +1,63 @@
+/**
+ * Casting History (M3-10, Issue #151)
+ *
+ * Tracks casting decisions over time and makes them queryable.
+ * Each record captures who was cast, when, and from which config.
+ */
+// --- CastingHistory ---
+export class CastingHistory {
+    records = [];
+    /**
+     * Record a casting decision.
+     *
+     * @param team - The cast team produced by CastingEngine
+     * @param config - The CastingConfig that produced this team
+     * @param timestamp - Optional override (defaults to now)
+     */
+    recordCast(team, config, timestamp) {
+        const record = {
+            timestamp: (timestamp ?? new Date()).toISOString(),
+            universe: config.universe,
+            teamSize: team.length,
+            members: team.map((m) => ({ name: m.name, role: m.role })),
+            configSnapshot: { ...config },
+        };
+        this.records.push(record);
+        return record;
+    }
+    /** Return all casting records, oldest first. */
+    getCastHistory() {
+        return [...this.records];
+    }
+    /**
+     * Return casting records that include a specific agent name.
+     * Useful for answering "when was Verbal last cast?"
+     */
+    getAgentHistory(agentName) {
+        return this.records.filter((r) => r.members.some((m) => m.name === agentName));
+    }
+    /** Number of recorded casts. */
+    get size() {
+        return this.records.length;
+    }
+    /** Clear all history. */
+    clear() {
+        this.records = [];
+    }
+    // --- Serialization for config round-trip ---
+    /** Serialize history to a plain object suitable for JSON / config persistence. */
+    serializeHistory() {
+        return {
+            version: 1,
+            records: this.records.map((r) => ({ ...r })),
+        };
+    }
+    /** Restore history from a previously serialized object. Replaces current records. */
+    deserializeHistory(data) {
+        if (!data || data.version !== 1 || !Array.isArray(data.records)) {
+            throw new Error('Invalid casting history data: expected version 1 with records array');
+        }
+        this.records = data.records.map((r) => ({ ...r }));
+    }
+}
+//# sourceMappingURL=casting-history.js.map

package/dist/casting/casting-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"casting-history.js","sourceRoot":"","sources":["../../src/casting/casting-history.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+BH,yBAAyB;AAEzB,MAAM,OAAO,cAAc;IACjB,OAAO,GAAoB,EAAE,CAAC;IAEtC;;;;;;OAMG;IACH,UAAU,CAAC,IAAkB,EAAE,MAAqB,EAAE,SAAgB;QACpE,MAAM,MAAM,GAAkB;YAC5B,SAAS,EAAE,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE;YAClD,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,IAAI,CAAC,MAAM;YACrB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1D,cAAc,EAAE,EAAE,GAAG,MAAM,EAAE;SAC9B,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,gDAAgD;IAChD,cAAc;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,SAAiB;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/B,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAC5C,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,yBAAyB;IACzB,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;IAED,8CAA8C;IAE9C,kFAAkF;IAClF,gBAAgB;QACd,OAAO;YACL,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;SAC7C,CAAC;IACJ,CAAC;IAED,qFAAqF;IACrF,kBAAkB,CAAC,IAA8B;QAC/C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/casting/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Casting System (PRD 11 + M3-2)
+ *
+ * Runtime casting engine that generates agent personas from universe themes.
+ * Typed config replaces static markdown definitions.
+ *
+ * v1 API (M3-2):  CastingEngine.castTeam(config) → CastMember[]
+ * Legacy API:     CastingRegistry (filesystem-backed, stub)
+ */
+export { CastingEngine, type CastMember, type CastingConfig, type AgentRole, type UniverseId, } from './casting-engine.js';
+export { CastingHistory, type CastingRecord, type CastingRecordMember, type SerializedCastingHistory, } from './casting-history.js';
+export interface CastingUniverse {
+    /** Universe name (e.g., 'The Wire', 'Seinfeld') */
+    name: string;
+    /** Available character names */
+    characters: string[];
+    /** Universe-specific constraints */
+    constraints?: string[];
+}
+export interface CastingEntry {
+    /** Agent role name (e.g., 'core-dev', 'lead') */
+    role: string;
+    /** Cast character name */
+    characterName: string;
+    /** Universe the character is from */
+    universe: string;
+    /** Display name (e.g., 'Fenster — Core Dev') */
+    displayName: string;
+}
+export interface CastingRegistryConfig {
+    /** Path to .squad/casting/ directory */
+    castingDir: string;
+    /** Active universe name */
+    activeUniverse?: string;
+}
+export declare class CastingRegistry {
+    private entries;
+    private config;
+    constructor(config: CastingRegistryConfig);
+    load(): Promise<void>;
+    getByRole(role: string): CastingEntry | undefined;
+    getAllEntries(): CastingEntry[];
+    cast(role: string, _universe?: string): Promise<CastingEntry>;
+    recast(_universe: string): Promise<CastingEntry[]>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/casting/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACL,aAAa,EACb,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAI9B,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,EAAE,qBAAqB;IAInC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIjD,aAAa,IAAI,YAAY,EAAE;IAIzB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI7D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAGzD"}

package/dist/casting/index.js

@@ -0,0 +1,45 @@
+/**
+ * Casting System (PRD 11 + M3-2)
+ *
+ * Runtime casting engine that generates agent personas from universe themes.
+ * Typed config replaces static markdown definitions.
+ *
+ * v1 API (M3-2):  CastingEngine.castTeam(config) → CastMember[]
+ * Legacy API:     CastingRegistry (filesystem-backed, stub)
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export { CastingEngine, } from './casting-engine.js';
+// Re-export casting history (M3-10)
+export { CastingHistory, } from './casting-history.js';
+// --- Legacy Casting Registry ---
+export class CastingRegistry {
+    entries = new Map();
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async load() {
+        const registryPath = path.join(this.config.castingDir, 'registry.json');
+        if (!fs.existsSync(registryPath))
+            return;
+        const raw = fs.readFileSync(registryPath, 'utf-8');
+        const entries = JSON.parse(raw);
+        for (const entry of entries) {
+            this.entries.set(entry.role, entry);
+        }
+    }
+    getByRole(role) {
+        return this.entries.get(role);
+    }
+    getAllEntries() {
+        return Array.from(this.entries.values());
+    }
+    async cast(role, _universe) {
+        throw new Error('Not implemented');
+    }
+    async recast(_universe) {
+        throw new Error('Not implemented');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/casting/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/casting/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EACL,aAAa,GAKd,MAAM,qBAAqB,CAAC;AAE7B,oCAAoC;AACpC,OAAO,EACL,cAAc,GAIf,MAAM,sBAAsB,CAAC;AA+B9B,kCAAkC;AAElC,MAAM,OAAO,eAAe;IAClB,OAAO,GAA8B,IAAI,GAAG,EAAE,CAAC;IAC/C,MAAM,CAAwB;IAEtC,YAAY,MAA6B;QACvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;QACxE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;YAAE,OAAO;QAEzC,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;QAClD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,SAAkB;QACzC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;CACF"}