squadfoundry 0.1.0

package/dist/orchestrator/artifacts/artifact-store.js

@@ -0,0 +1,135 @@
+/**
+ * ArtifactStore
+ *
+ * Filesystem-based artifact persistence for squad jobs.
+ * All job state, handoffs, events, outputs, and approvals are stored
+ * as human-readable JSON/Markdown files under:
+ *
+ *   artifacts/<squad_id>/<job_id>/
+ *     state.json
+ *     handoffs.json
+ *     events.json
+ *     approvals.json
+ *     outputs/
+ *     reports/
+ */
+import { mkdirSync, writeFileSync, readFileSync, existsSync, readdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+// ─────────────────────────────────────────────────────────────────────────────
+// Paths
+// ─────────────────────────────────────────────────────────────────────────────
+export class ArtifactStore {
+    baseDir;
+    constructor(baseDir = 'artifacts') {
+        this.baseDir = baseDir;
+    }
+    jobDir(squadId, jobId) {
+        return join(this.baseDir, squadId, jobId);
+    }
+    ensureDir(path) {
+        mkdirSync(path, { recursive: true });
+    }
+    write(path, data) {
+        this.ensureDir(dirname(path));
+        writeFileSync(path, JSON.stringify(data, null, 2), 'utf-8');
+    }
+    read(path) {
+        if (!existsSync(path))
+            return null;
+        try {
+            return JSON.parse(readFileSync(path, 'utf-8'));
+        }
+        catch {
+            return null;
+        }
+    }
+    // ─── Job State ─────────────────────────────────────────────────────────────
+    /** Persist the full job state */
+    saveJob(job) {
+        const path = join(this.jobDir(job.squadId, job.id), 'state.json');
+        this.write(path, job);
+    }
+    /** Load a job state from disk */
+    loadJob(squadId, jobId) {
+        return this.read(join(this.jobDir(squadId, jobId), 'state.json'));
+    }
+    /** List all job IDs for a squad */
+    listJobs(squadId) {
+        const squadPath = join(this.baseDir, squadId);
+        if (!existsSync(squadPath))
+            return [];
+        return readdirSync(squadPath, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => d.name);
+    }
+    // ─── Handoffs ──────────────────────────────────────────────────────────────
+    appendHandoff(squadId, jobId, handoff) {
+        const path = join(this.jobDir(squadId, jobId), 'handoffs.json');
+        const existing = this.read(path) ?? [];
+        existing.push(handoff);
+        this.write(path, existing);
+    }
+    loadHandoffs(squadId, jobId) {
+        return this.read(join(this.jobDir(squadId, jobId), 'handoffs.json')) ?? [];
+    }
+    // ─── Events / History ──────────────────────────────────────────────────────
+    appendEvent(squadId, jobId, event) {
+        const path = join(this.jobDir(squadId, jobId), 'events.json');
+        const existing = this.read(path) ?? [];
+        existing.push(event);
+        this.write(path, existing);
+    }
+    loadEvents(squadId, jobId) {
+        return this.read(join(this.jobDir(squadId, jobId), 'events.json')) ?? [];
+    }
+    // ─── Approvals ─────────────────────────────────────────────────────────────
+    saveApprovals(squadId, jobId, approvals) {
+        const path = join(this.jobDir(squadId, jobId), 'approvals.json');
+        this.write(path, approvals);
+    }
+    loadApprovals(squadId, jobId) {
+        return this.read(join(this.jobDir(squadId, jobId), 'approvals.json')) ?? [];
+    }
+    // ─── Artifact Outputs ──────────────────────────────────────────────────────
+    /**
+     * Persist a pending artifact (content produced by an agent) to disk.
+     * Returns an ArtifactRef that can be stored in the job.
+     */
+    persistArtifact(squadId, jobId, artifact, agentId, stepId) {
+        const ext = artifact.format === 'json' ? 'json' : artifact.format === 'markdown' ? 'md' : 'txt';
+        const safeName = artifact.name.replace(/[^a-zA-Z0-9_-]/g, '_');
+        const fileName = `${safeName}.${ext}`;
+        const outputPath = join(this.jobDir(squadId, jobId), 'outputs', fileName);
+        this.ensureDir(dirname(outputPath));
+        writeFileSync(outputPath, artifact.content, 'utf-8');
+        const ref = {
+            id: `artifact-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`,
+            name: artifact.name,
+            path: outputPath,
+            producedByAgentId: agentId,
+            producedAtStepId: stepId,
+            format: artifact.format,
+            createdAt: new Date().toISOString(),
+        };
+        return ref;
+    }
+    /** Save a Markdown report to artifacts/<squad_id>/<job_id>/reports/ */
+    saveReport(squadId, jobId, name, content) {
+        const safeName = name.replace(/[^a-zA-Z0-9_-]/g, '_');
+        const path = join(this.jobDir(squadId, jobId), 'reports', `${safeName}.md`);
+        this.ensureDir(dirname(path));
+        writeFileSync(path, content, 'utf-8');
+        return path;
+    }
+    /** List all artifact refs from the job's outputs directory */
+    listArtifacts(squadId, jobId) {
+        const outputDir = join(this.jobDir(squadId, jobId), 'outputs');
+        if (!existsSync(outputDir))
+            return [];
+        return readdirSync(outputDir);
+    }
+}
+export function createArtifactStore(baseDir) {
+    return new ArtifactStore(baseDir);
+}
+//# sourceMappingURL=artifact-store.js.map

package/dist/orchestrator/artifacts/artifact-store.js.map

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

package/dist/orchestrator/builder/domain-classifier.d.ts

@@ -0,0 +1,24 @@
+/**
+ * DomainClassifier
+ *
+ * Maps interview answers to a SquadDomain and selects the appropriate
+ * agent template set and workflow pattern.
+ *
+ * The classifier uses keyword matching — it is intentionally simple
+ * and transparent. Replace with an LLM-based classifier if needed.
+ */
+import type { SquadDomain, InterviewAnswer } from '../core/types.js';
+export interface ClassificationResult {
+    domain: SquadDomain;
+    confidence: 'high' | 'medium' | 'low';
+    suggestedAgentRoles: string[];
+    suggestedWorkflowPattern: WorkflowPattern;
+    notes: string[];
+}
+export type WorkflowPattern = 'linear' | 'review-loop' | 'publish-gate' | 'iterative' | 'pipeline' | 'custom';
+export declare class DomainClassifier {
+    classify(answers: InterviewAnswer[]): ClassificationResult;
+    private parseExplicitDomain;
+}
+export declare function createDomainClassifier(): DomainClassifier;
+//# sourceMappingURL=domain-classifier.d.ts.map

package/dist/orchestrator/builder/domain-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-classifier.d.ts","sourceRoot":"","sources":["../../../orchestrator/builder/domain-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEpE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,CAAA;IACnB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;IACrC,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B,wBAAwB,EAAE,eAAe,CAAA;IACzC,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,aAAa,GACb,cAAc,GACd,WAAW,GACX,UAAU,GACV,QAAQ,CAAA;AA4EZ,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,oBAAoB;IAkE1D,OAAO,CAAC,mBAAmB;CA2B5B;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD"}

package/dist/orchestrator/builder/domain-classifier.js

@@ -0,0 +1,156 @@
+/**
+ * DomainClassifier
+ *
+ * Maps interview answers to a SquadDomain and selects the appropriate
+ * agent template set and workflow pattern.
+ *
+ * The classifier uses keyword matching — it is intentionally simple
+ * and transparent. Replace with an LLM-based classifier if needed.
+ */
+const DOMAIN_TEMPLATES = [
+    {
+        domain: 'software-development',
+        keywords: [
+            'code', 'software', 'dev', 'development', 'programming', 'deploy', 'ci', 'cd',
+            'github', 'pr', 'pull request', 'test', 'review', 'bug', 'feature', 'branch',
+            'commit', 'release', 'build', 'api', 'backend', 'frontend', 'typescript', 'python',
+        ],
+        agentRoles: ['Product Agent', 'Code Agent', 'Reviewer Agent', 'Test Agent', 'Commit Agent', 'PR Agent', 'Deploy Agent'],
+        workflowPattern: 'pipeline',
+    },
+    {
+        domain: 'social-media',
+        keywords: [
+            'instagram', 'twitter', 'linkedin', 'tiktok', 'social', 'post', 'publish',
+            'content', 'caption', 'hashtag', 'story', 'reel', 'engagement', 'follower',
+            'brand', 'campaign', 'influencer', 'analytics',
+        ],
+        agentRoles: ['Strategy Agent', 'Research Agent', 'Copy Agent', 'Creative Review Agent', 'Brand/Compliance Agent', 'Approval Agent', 'Publisher Agent', 'Analytics Agent'],
+        workflowPattern: 'publish-gate',
+    },
+    {
+        domain: 'content-marketing',
+        keywords: [
+            'blog', 'article', 'seo', 'content', 'marketing', 'copy', 'editorial',
+            'newsletter', 'email', 'landing page', 'keyword', 'audience', 'traffic',
+        ],
+        agentRoles: ['Strategy Agent', 'Research Agent', 'Writer Agent', 'Editor Agent', 'SEO Agent', 'Approval Agent', 'Publisher Agent'],
+        workflowPattern: 'review-loop',
+    },
+    {
+        domain: 'documentation',
+        keywords: [
+            'doc', 'documentation', 'spec', 'wiki', 'readme', 'guide', 'manual',
+            'technical writing', 'confluence', 'notion', 'changelog', 'api doc',
+        ],
+        agentRoles: ['Intake Agent', 'Structuring Agent', 'Writer Agent', 'Reviewer Agent', 'Approval Agent', 'Publisher Agent'],
+        workflowPattern: 'review-loop',
+    },
+    {
+        domain: 'research',
+        keywords: [
+            'research', 'analysis', 'report', 'data', 'survey', 'literature', 'findings',
+            'summary', 'competitive', 'market research', 'insights',
+        ],
+        agentRoles: ['Planning Agent', 'Research Agent', 'Analysis Agent', 'Synthesis Agent', 'Review Agent', 'Report Agent'],
+        workflowPattern: 'iterative',
+    },
+    {
+        domain: 'operations',
+        keywords: [
+            'operations', 'hr', 'onboarding', 'sales', 'crm', 'pipeline', 'customer',
+            'support', 'ticket', 'process', 'workflow', 'automation', 'runbook',
+        ],
+        agentRoles: ['Intake Agent', 'Processing Agent', 'Review Agent', 'Approval Agent', 'Execution Agent', 'Reporting Agent'],
+        workflowPattern: 'linear',
+    },
+];
+// ─────────────────────────────────────────────────────────────────────────────
+// Classifier
+// ─────────────────────────────────────────────────────────────────────────────
+export class DomainClassifier {
+    classify(answers) {
+        const allText = answers.map((a) => a.answer).join(' ').toLowerCase();
+        // Score each domain template
+        const scores = DOMAIN_TEMPLATES.map((template) => ({
+            template,
+            score: template.keywords.filter((kw) => allText.includes(kw)).length,
+        }));
+        scores.sort((a, b) => b.score - a.score);
+        const best = scores[0];
+        const runner = scores[1];
+        const notes = [];
+        // Check explicit domain selection from q_domain
+        const domainAnswer = answers.find((a) => a.questionId === 'q_domain')?.answer ?? '';
+        const explicitDomain = this.parseExplicitDomain(domainAnswer);
+        if (explicitDomain) {
+            const template = DOMAIN_TEMPLATES.find((t) => t.domain === explicitDomain);
+            if (template) {
+                notes.push(`Domain explicitly selected: ${explicitDomain}`);
+                return {
+                    domain: explicitDomain,
+                    confidence: 'high',
+                    suggestedAgentRoles: template.agentRoles,
+                    suggestedWorkflowPattern: template.workflowPattern,
+                    notes,
+                };
+            }
+        }
+        if (!best || best.score === 0) {
+            notes.push('Could not confidently classify domain — defaulting to custom');
+            return {
+                domain: 'custom',
+                confidence: 'low',
+                suggestedAgentRoles: ['Intake Agent', 'Processing Agent', 'Review Agent', 'Output Agent'],
+                suggestedWorkflowPattern: 'linear',
+                notes,
+            };
+        }
+        const confidence = best.score >= 3 && (!runner || best.score > runner.score * 1.5)
+            ? 'high'
+            : best.score >= 2
+                ? 'medium'
+                : 'low';
+        if (confidence !== 'high') {
+            notes.push(`Classification confidence is ${confidence}. Consider clarifying the domain.`);
+        }
+        return {
+            domain: best.template.domain,
+            confidence,
+            suggestedAgentRoles: best.template.agentRoles,
+            suggestedWorkflowPattern: best.template.workflowPattern,
+            notes,
+        };
+    }
+    parseExplicitDomain(answer) {
+        const lower = answer.toLowerCase().trim();
+        const map = {
+            '1': 'software-development',
+            'software': 'software-development',
+            'development': 'software-development',
+            '2': 'content-marketing',
+            'content': 'content-marketing',
+            'marketing': 'content-marketing',
+            '3': 'social-media',
+            'social': 'social-media',
+            'instagram': 'social-media',
+            '4': 'documentation',
+            'docs': 'documentation',
+            'documentation': 'documentation',
+            '5': 'research',
+            'research': 'research',
+            '6': 'operations',
+            'operations': 'operations',
+            'hr': 'operations',
+            'sales': 'operations',
+            '7': 'custom',
+            'other': 'custom',
+            'custom': 'custom',
+        };
+        return map[lower] ?? null;
+    }
+}
+export function createDomainClassifier() {
+    return new DomainClassifier();
+}
+//# sourceMappingURL=domain-classifier.js.map

package/dist/orchestrator/builder/domain-classifier.js.map

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

package/dist/orchestrator/builder/interview-questions.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Interview Questions Bank
+ *
+ * Structured questions used by the Squad Builder to discover
+ * the user's intent, domain, workflow, and constraints before
+ * generating a squad definition.
+ */
+import type { InterviewQuestion } from '../core/types.js';
+export declare const INTERVIEW_QUESTIONS: InterviewQuestion[];
+export declare function getRequiredQuestions(): InterviewQuestion[];
+export declare function getQuestionById(id: string): InterviewQuestion | undefined;
+export declare function getQuestionsByCategory(category: InterviewQuestion['category']): InterviewQuestion[];
+//# sourceMappingURL=interview-questions.d.ts.map

package/dist/orchestrator/builder/interview-questions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interview-questions.d.ts","sourceRoot":"","sources":["../../../orchestrator/builder/interview-questions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,EAqHlD,CAAA;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,EAAE,CAE1D;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEzE;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,GACtC,iBAAiB,EAAE,CAErB"}

package/dist/orchestrator/builder/interview-questions.js

@@ -0,0 +1,127 @@
+/**
+ * Interview Questions Bank
+ *
+ * Structured questions used by the Squad Builder to discover
+ * the user's intent, domain, workflow, and constraints before
+ * generating a squad definition.
+ */
+export const INTERVIEW_QUESTIONS = [
+    // ── Objective ──────────────────────────────────────────────────────────────
+    {
+        id: 'q_objective',
+        category: 'objective',
+        required: true,
+        question: 'What is the primary objective of this squad? What problem does it solve?',
+        hint: 'e.g. "Automate publishing of Instagram content, from idea to post"',
+    },
+    {
+        id: 'q_domain',
+        category: 'domain',
+        required: true,
+        question: 'What domain does this squad operate in?\n  1. Software Development\n  2. Content Marketing\n  3. Social Media\n  4. Documentation\n  5. Research\n  6. Operations / HR / Sales\n  7. Other (describe)',
+        hint: 'Enter the number or describe freely',
+    },
+    {
+        id: 'q_description',
+        category: 'objective',
+        required: true,
+        question: 'Describe the squad in 2–3 sentences. What does it do end-to-end?',
+    },
+    // ── I/O ───────────────────────────────────────────────────────────────────
+    {
+        id: 'q_inputs',
+        category: 'io',
+        required: true,
+        question: 'What are the typical INPUTS for this squad? (e.g. a task description, a brief, a JIRA ticket, a keyword)',
+    },
+    {
+        id: 'q_outputs',
+        category: 'io',
+        required: true,
+        question: 'What are the expected OUTPUTS? (e.g. a PR, a published post, a documented spec, a report)',
+    },
+    // ── Steps ─────────────────────────────────────────────────────────────────
+    {
+        id: 'q_steps',
+        category: 'steps',
+        required: true,
+        question: 'What are the main steps in this process TODAY (even if manual)?\nList them in order, e.g. "1. Research, 2. Write, 3. Review, 4. Publish"',
+    },
+    {
+        id: 'q_loop_steps',
+        category: 'steps',
+        required: false,
+        question: 'Are there any steps that loop or iterate? (e.g. "Review → Revise → Review again")',
+        hint: 'Leave blank if steps are strictly sequential',
+    },
+    // ── Approvals ─────────────────────────────────────────────────────────────
+    {
+        id: 'q_approvals',
+        category: 'approvals',
+        required: true,
+        question: 'Which steps REQUIRE human approval or sign-off before moving forward?',
+        hint: 'e.g. "Publishing always needs approval. Commit never does."',
+    },
+    {
+        id: 'q_human_in_loop',
+        category: 'approvals',
+        required: true,
+        question: 'What is NEVER allowed to be fully automated? What must always involve a human?',
+        hint: 'e.g. "Never auto-publish. Never deploy to production without confirmation."',
+    },
+    // ── Tools ─────────────────────────────────────────────────────────────────
+    {
+        id: 'q_tools',
+        category: 'tools',
+        required: false,
+        question: 'What tools or systems are involved? (e.g. GitHub, Vercel, Instagram, Google Docs, Slack, Notion)',
+        hint: 'List any APIs, platforms, or services this squad will interact with',
+    },
+    // ── Policies ──────────────────────────────────────────────────────────────
+    {
+        id: 'q_policies',
+        category: 'policies',
+        required: false,
+        question: 'Are there any rules, brand guidelines, compliance requirements, or policies that must be respected?',
+        hint: 'e.g. "Must follow brand voice guidelines. No profanity. Legal review required for contracts."',
+    },
+    {
+        id: 'q_prohibited',
+        category: 'policies',
+        required: false,
+        question: 'What actions are strictly PROHIBITED for this squad to take automatically?',
+        hint: 'e.g. "No auto-merge of PRs. No posting without brand review."',
+    },
+    // ── Risks ─────────────────────────────────────────────────────────────────
+    {
+        id: 'q_risks',
+        category: 'risks',
+        required: false,
+        question: 'What are the most critical risks if something goes wrong in this workflow?',
+        hint: 'e.g. "Wrong post published. Broken deploy. PII exposed in public doc."',
+    },
+    // ── Context ───────────────────────────────────────────────────────────────
+    {
+        id: 'q_context_files',
+        category: 'context',
+        required: false,
+        question: 'What documentation already exists for this domain?\n(e.g. brand guide, design system, spec templates, playbooks)',
+    },
+    {
+        id: 'q_squad_name',
+        category: 'objective',
+        required: true,
+        question: 'What should this squad be called? (used as the squad ID and folder name)',
+        hint: 'e.g. "instagram-content", "software-dev", "technical-docs"',
+    },
+];
+export function getRequiredQuestions() {
+    return INTERVIEW_QUESTIONS.filter((q) => q.required);
+}
+export function getQuestionById(id) {
+    return INTERVIEW_QUESTIONS.find((q) => q.id === id);
+}
+export function getQuestionsByCategory(category) {
+    return INTERVIEW_QUESTIONS.filter((q) => q.category === category);
+}
+//# sourceMappingURL=interview-questions.js.map

package/dist/orchestrator/builder/interview-questions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interview-questions.js","sourceRoot":"","sources":["../../../orchestrator/builder/interview-questions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAAwB;IACtD,8EAA8E;IAC9E;QACE,EAAE,EAAE,aAAa;QACjB,QAAQ,EAAE,WAAW;QACrB,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,0EAA0E;QACpF,IAAI,EAAE,oEAAoE;KAC3E;IACD;QACE,EAAE,EAAE,UAAU;QACd,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,IAAI;QACd,QAAQ,EACN,uMAAuM;QACzM,IAAI,EAAE,qCAAqC;KAC5C;IACD;QACE,EAAE,EAAE,eAAe;QACnB,QAAQ,EAAE,WAAW;QACrB,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,kEAAkE;KAC7E;IAED,6EAA6E;IAC7E;QACE,EAAE,EAAE,UAAU;QACd,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,0GAA0G;KACrH;IACD;QACE,EAAE,EAAE,WAAW;QACf,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,2FAA2F;KACtG;IAED,6EAA6E;IAC7E;QACE,EAAE,EAAE,SAAS;QACb,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,0IAA0I;KACrJ;IACD;QACE,EAAE,EAAE,cAAc;QAClB,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,mFAAmF;QAC7F,IAAI,EAAE,8CAA8C;KACrD;IAED,6EAA6E;IAC7E;QACE,EAAE,EAAE,aAAa;QACjB,QAAQ,EAAE,WAAW;QACrB,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,uEAAuE;QACjF,IAAI,EAAE,6DAA6D;KACpE;IACD;QACE,EAAE,EAAE,iBAAiB;QACrB,QAAQ,EAAE,WAAW;QACrB,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,gFAAgF;QAC1F,IAAI,EAAE,6EAA6E;KACpF;IAED,6EAA6E;IAC7E;QACE,EAAE,EAAE,SAAS;QACb,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,kGAAkG;QAC5G,IAAI,EAAE,qEAAqE;KAC5E;IAED,6EAA6E;IAC7E;QACE,EAAE,EAAE,YAAY;QAChB,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,qGAAqG;QAC/G,IAAI,EAAE,+FAA+F;KACtG;IACD;QACE,EAAE,EAAE,cAAc;QAClB,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,4EAA4E;QACtF,IAAI,EAAE,+DAA+D;KACtE;IAED,6EAA6E;IAC7E;QACE,EAAE,EAAE,SAAS;QACb,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,4EAA4E;QACtF,IAAI,EAAE,wEAAwE;KAC/E;IAED,6EAA6E;IAC7E;QACE,EAAE,EAAE,iBAAiB;QACrB,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,kHAAkH;KAC7H;IACD;QACE,EAAE,EAAE,cAAc;QAClB,QAAQ,EAAE,WAAW;QACrB,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,0EAA0E;QACpF,IAAI,EAAE,4DAA4D;KACnE;CACF,CAAA;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;AACtD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AACrD,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAAuC;IAEvC,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAA;AACnE,CAAC"}

package/dist/orchestrator/builder/squad-builder.d.ts

@@ -0,0 +1,53 @@
+/**
+ * SquadBuilder
+ *
+ * High-level orchestrator for the squad design interview.
+ * Coordinates: questions → answers → classification → generation → file output.
+ *
+ * SquadBuilder is designed to run in two modes:
+ * 1. Programmatic: call conductInterview(answers[]) with pre-filled answers
+ * 2. Interactive CLI: use with the CLI entrypoint which prompts the user
+ */
+import type { InterviewAnswer, SquadBuildResult } from '../core/types.js';
+import { DomainClassifier } from './domain-classifier.js';
+import { SquadGenerator } from './squad-generator.js';
+export interface SquadBuilderOptions {
+    /** Root path for context discovery */
+    contextRootPath?: string;
+    /** Output directory for generated squad files */
+    outputDir?: string;
+    classifier?: DomainClassifier;
+    generator?: SquadGenerator;
+}
+export declare class SquadBuilder {
+    private contextRootPath;
+    private outputDir;
+    private classifier;
+    private generator;
+    constructor(options?: SquadBuilderOptions);
+    /**
+     * Return all interview questions (for display in CLI or agent conversation).
+     */
+    getQuestions(): import("../index.js").InterviewQuestion[];
+    /**
+     * Conduct the interview programmatically with a pre-built answer set.
+     * Returns the squad build result without writing files.
+     */
+    conductInterview(answers: InterviewAnswer[]): SquadBuildResult;
+    /**
+     * Build a squad from answers and write all generated files to disk.
+     */
+    build(answers: InterviewAnswer[]): Promise<SquadBuildResult>;
+    /**
+     * Validate that all required questions have answers.
+     * Returns an array of missing question IDs.
+     */
+    validateAnswers(answers: InterviewAnswer[]): string[];
+    /**
+     * Generate a formatted prompt string for the orquestrador to use
+     * when interviewing the user in an agent conversation context.
+     */
+    generateInterviewPrompt(): string;
+}
+export declare function createSquadBuilder(options?: SquadBuilderOptions): SquadBuilder;
+//# sourceMappingURL=squad-builder.d.ts.map

package/dist/orchestrator/builder/squad-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"squad-builder.d.ts","sourceRoot":"","sources":["../../../orchestrator/builder/squad-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEzE,OAAO,EAAE,gBAAgB,EAA0B,MAAM,wBAAwB,CAAA;AACjF,OAAO,EAAE,cAAc,EAAwB,MAAM,sBAAsB,CAAA;AAG3E,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B,SAAS,CAAC,EAAE,cAAc,CAAA;CAC3B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,SAAS,CAAgB;gBAErB,OAAO,GAAE,mBAAwB;IAO7C;;OAEG;IACH,YAAY;IAIZ;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,gBAAgB;IAK9D;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgClE;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,EAAE;IAQrD;;;OAGG;IACH,uBAAuB,IAAI,MAAM;CAgBlC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAE9E"}