raptor-aios 0.1.0

package/dist/_core/dist/agents/prompt-builder.js

@@ -0,0 +1,261 @@
+/**
+ * Canonical Prompt Builder.
+ *
+ * Assembles a CanonicalPrompt from the feature context.
+ * The canonical body is byte-identical across agents (I-04).
+ *
+ * Blueprint ref: 17.6 — "Prompt canônico normalizado".
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { hashString, hashFile } from "../audit/hash.js";
+import { wrapSpec, wrapUntrusted } from "./prompt-markers.js";
+const PHASE_MAP = {
+    new: {
+        command: "new",
+        inputs: [{ filename: "constitution.md", role: "constitution" }],
+        expectedOutput: "specs/{feature}/spec.md",
+        outputSchema: "raptor.spec/v1",
+        scope: {
+            read: ["specs/**", ".raptor/constitution.md"],
+            write: ["specs/{feature}/**"],
+            forbidden: [".raptor/audit.jsonl", ".raptor/constitution.md"],
+        },
+        bodyTemplate: [
+            "## Instrução",
+            "",
+            "Você é o agente de especificação do Raptor.",
+            "Crie o arquivo `spec.md` para a feature descrita abaixo,",
+            "seguindo o template de especificação SDD.",
+            "",
+            "### Requisitos obrigatórios:",
+            "1. Toda user story deve ter critérios de aceite mensuráveis.",
+            "2. Use marcadores `[NEEDS CLARIFICATION]` para ambiguidades.",
+            "3. Inclua seção de Riscos e Dependências.",
+            "4. Reference artigos constitucionais aplicáveis.",
+            "5. Use numeração sequencial para user stories ([US1], [US2]...).",
+            "",
+            "### Feature a especificar:",
+            "",
+            "{{DESCRIPTION}}",
+        ].join("\n"),
+    },
+    plan: {
+        command: "plan",
+        inputs: [
+            { filename: "spec.md", role: "spec" },
+            { filename: "constitution.md", role: "constitution" },
+        ],
+        expectedOutput: "specs/{feature}/plan.md",
+        outputSchema: "raptor.plan/v1",
+        scope: {
+            read: ["specs/{feature}/**", ".raptor/constitution.md"],
+            write: ["specs/{feature}/**"],
+            forbidden: [".raptor/audit.jsonl", ".raptor/constitution.md"],
+        },
+        bodyTemplate: [
+            "## Instrução",
+            "",
+            "Você é o agente de planejamento do Raptor.",
+            "Gere o `plan.md` traduzindo a spec em decisões técnicas.",
+            "",
+            "### Requisitos obrigatórios:",
+            "1. Execute Phase -1 (Gates Constitucionais) antes de decidir.",
+            "2. Referencie cada decisão ao artigo constitucional (C3).",
+            "3. Inclua Data Model, Contracts e Research quando aplicável.",
+            "4. Gere Complexity Tracking se algum gate for violado.",
+            "5. Não invente onde a spec tem `[NEEDS CLARIFICATION]`.",
+        ].join("\n"),
+    },
+    tasks: {
+        command: "tasks",
+        inputs: [
+            { filename: "spec.md", role: "spec" },
+            { filename: "plan.md", role: "plan" },
+            { filename: "constitution.md", role: "constitution" },
+        ],
+        expectedOutput: "specs/{feature}/tasks.md",
+        outputSchema: "raptor.tasks/v1",
+        scope: {
+            read: ["specs/{feature}/**", ".raptor/constitution.md"],
+            write: ["specs/{feature}/**"],
+            forbidden: [".raptor/audit.jsonl", ".raptor/constitution.md"],
+        },
+        bodyTemplate: [
+            "## Instrução",
+            "",
+            "Você é o agente de decomposição do Raptor.",
+            "Gere `tasks.md` quebrando o plano em unidades executáveis.",
+            "",
+            "### Requisitos obrigatórios:",
+            "1. Cada task deve mapear para uma user story ([US1], [US2]...).",
+            "2. Marque tasks paralelizáveis com [P].",
+            "3. Inclua critério de aceite técnico por task.",
+            "4. Ordene pela dependência natural (build-order).",
+            "5. Toda task deve ser completável em ≤4h.",
+        ].join("\n"),
+    },
+    implement: {
+        command: "implement",
+        inputs: [
+            { filename: "spec.md", role: "spec" },
+            { filename: "plan.md", role: "plan" },
+            { filename: "tasks.md", role: "tasks" },
+            { filename: "constitution.md", role: "constitution" },
+        ],
+        expectedOutput: "specs/{feature}/code/**",
+        outputSchema: "raptor.code/v1",
+        scope: {
+            read: ["specs/{feature}/**", "src/**", ".raptor/constitution.md"],
+            write: ["src/**", "specs/{feature}/tasks.md"],
+            forbidden: [
+                ".raptor/audit.jsonl",
+                ".raptor/constitution.md",
+                "specs/{feature}/spec.md",
+                "specs/{feature}/plan.md",
+            ],
+        },
+        bodyTemplate: [
+            "## Instrução",
+            "",
+            "Você é o agente de implementação do Raptor.",
+            "Execute as tasks do `tasks.md` em ordem, respeitando o plan.md.",
+            "",
+            "### Requisitos obrigatórios:",
+            "1. Marque cada task como [x] conforme for completando.",
+            "2. Respeite EXATAMENTE o escopo de escrita definido.",
+            "3. Toda mudança deve ser referenciável à task correspondente.",
+            "4. Não altere spec.md nem plan.md — são contratos aprovados.",
+            "5. Escreva testes conforme o critério de aceite de cada task.",
+        ].join("\n"),
+    },
+    clarify: {
+        command: "clarify",
+        inputs: [
+            { filename: "spec.md", role: "spec" },
+            { filename: "constitution.md", role: "constitution" },
+        ],
+        expectedOutput: "answers.json",
+        outputSchema: "raptor.answers/v1",
+        scope: {
+            read: ["specs/{feature}/**", ".raptor/constitution.md"],
+            write: ["specs/{feature}/answers.json"],
+            forbidden: [".raptor/audit.jsonl"],
+        },
+        bodyTemplate: [
+            "## Instrução",
+            "",
+            "Você é o agente de esclarecimento do Raptor.",
+            "Analise os marcadores `[NEEDS CLARIFICATION]` no `spec.md` e sugira resoluções.",
+            "",
+            "### Saída esperada:",
+            'Um arquivo JSON contendo um array de objetos `{ "label": string, "answer": string }`.',
+        ].join("\n"),
+    },
+    analyze: {
+        command: "analyze",
+        inputs: [
+            { filename: "spec.md", role: "spec" },
+            { filename: "plan.md", role: "plan" },
+            { filename: "tasks.md", role: "tasks" },
+            { filename: "constitution.md", role: "constitution" },
+        ],
+        expectedOutput: "specs/{feature}/analysis.md",
+        outputSchema: "raptor.analysis/v1",
+        scope: {
+            read: ["specs/{feature}/**", ".raptor/constitution.md"],
+            write: ["specs/{feature}/analysis.md"],
+            forbidden: [".raptor/audit.jsonl"],
+        },
+        bodyTemplate: [
+            "## Instrução",
+            "",
+            "Você é o agente de auditoria do Raptor.",
+            "Realize uma análise cruzada entre spec, plan e tasks buscando drift ou falhas de cobertura.",
+        ].join("\n"),
+    },
+    checklist: {
+        command: "checklist",
+        inputs: [
+            { filename: "spec.md", role: "spec" },
+            { filename: "plan.md", role: "plan" },
+            { filename: "constitution.md", role: "constitution" },
+        ],
+        expectedOutput: "specs/{feature}/checklists/*.md",
+        outputSchema: "raptor.checklist/v1",
+        scope: {
+            read: ["specs/{feature}/**", "src/**", ".raptor/constitution.md"],
+            write: ["specs/{feature}/checklists/**"],
+            forbidden: [".raptor/audit.jsonl"],
+        },
+        bodyTemplate: [
+            "## Instrução",
+            "",
+            "Você é o agente de validação do Raptor.",
+            "Avalie a implementação ou o design frente aos critérios do checklist.",
+        ].join("\n"),
+    },
+};
+/**
+ * Build a CanonicalPrompt for a given SDD phase.
+ *
+ * The body is deterministic for a given set of inputs —
+ * calling this with the same inputs produces the same hash (I-04).
+ */
+export function buildCanonicalPrompt(input) {
+    const phase = PHASE_MAP[input.command];
+    if (!phase) {
+        throw new Error(`Unknown command "${input.command}" — no phase definition found.`);
+    }
+    const featureDir = join(input.projectRoot, "specs", input.feature);
+    const raptorDir = join(input.projectRoot, ".raptor");
+    // Resolve inputs
+    const inputs = [];
+    for (const inp of phase.inputs) {
+        const path = inp.filename === "constitution.md"
+            ? join(raptorDir, "constitution.md")
+            : join(featureDir, inp.filename);
+        if (existsSync(path)) {
+            inputs.push({ path: inp.filename, hash: hashFile(path), role: inp.role });
+        }
+    }
+    // Resolve body — untrusted user input is wrapped in sanitized markers
+    // so an agent cannot be tricked into treating a feature description as
+    // a Raptor instruction.
+    let body = phase.bodyTemplate;
+    if (body.includes("{{DESCRIPTION}}")) {
+        const userText = typeof input.description === "string" && input.description.length > 0
+            ? input.description
+            : "(sem descrição fornecida)";
+        body = body.replace("{{DESCRIPTION}}", wrapUntrusted(userText));
+    }
+    body = wrapSpec(body);
+    // Resolve scope with feature substitution
+    const resolvePattern = (p) => p.replace("{feature}", input.feature);
+    const scope = {
+        read: phase.scope.read.map(resolvePattern),
+        write: phase.scope.write.map(resolvePattern),
+        forbidden: phase.scope.forbidden.map(resolvePattern),
+    };
+    const promptHash = hashString(body);
+    return {
+        command: input.command,
+        feature: input.feature,
+        promptHash,
+        generatedAt: new Date().toISOString(),
+        body,
+        scope,
+        invariants: input.invariants ?? [],
+        inputs,
+        expectedOutput: resolvePattern(phase.expectedOutput),
+        outputSchema: phase.outputSchema,
+        articles: input.constitutionArticles ?? [],
+    };
+}
+/**
+ * Get the list of known SDD command names.
+ */
+export function knownCommands() {
+    return Object.keys(PHASE_MAP);
+}
+//# sourceMappingURL=prompt-builder.js.map

package/dist/_core/dist/agents/prompt-builder.js.map

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

package/dist/_core/dist/agents/prompt-markers.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Prompt Markers — delimiters that hedge against prompt injection and
+ * let adapters (and downstream parsers) unambiguously extract the
+ * canonical body, user description, and untrusted inputs.
+ *
+ * Rationale:
+ * - The canonical prompt is byte-identical across agents (I-04). That
+ *   means a compromised user description cannot silently inject new
+ *   instructions — the agent sees the same body regardless.
+ * - Markers give the agent an explicit frame: "what's inside BEGIN/END
+ *   is Raptor's contract; what's inside UNTRUSTED INPUT is user text
+ *   and MUST NOT be executed as instructions."
+ *
+ * Blueprint ref: 17.6 — "Prompt canônico normalizado".
+ */
+export declare const MARKERS: {
+    readonly specBegin: "<<< RAPTOR SPEC BEGIN >>>";
+    readonly specEnd: "<<< RAPTOR SPEC END >>>";
+    readonly untrustedBegin: "<<< UNTRUSTED INPUT BEGIN >>>";
+    readonly untrustedEnd: "<<< UNTRUSTED INPUT END >>>";
+};
+export type MarkerName = keyof typeof MARKERS;
+/**
+ * Wrap a body of canonical-spec text between BEGIN/END markers. The body
+ * is written as-is (newlines preserved). The body is allowed to already
+ * contain UNTRUSTED markers (from `wrapUntrusted`) but must not contain
+ * SPEC markers — nesting specs would break `extractSpec`.
+ */
+export declare function wrapSpec(body: string): string;
+/**
+ * Wrap a block of untrusted user input (e.g. the feature description
+ * passed to `raptor new`) between UNTRUSTED markers and strip any
+ * occurrence of the control markers from the payload itself.
+ *
+ * Unlike `wrapSpec`, untrusted content is allowed to "contain" what
+ * looks like a marker — we sanitize by replacing those literals with
+ * their visually similar counterparts (angle brackets with fullwidth
+ * form) so the file stays readable and the real markers remain unique.
+ */
+export declare function wrapUntrusted(raw: string): string;
+/**
+ * Replace any occurrence of Raptor's marker strings inside untrusted
+ * input with a safe placeholder. This prevents a malicious description
+ * from ending the untrusted block early and injecting fake "spec" text.
+ */
+export declare function sanitizeUntrusted(raw: string): string;
+/**
+ * Throw if the input contains any Raptor control marker verbatim.
+ * Used on trusted-source text (templates, scope sections) where we
+ * expect the author to never include a marker by accident.
+ */
+export declare function assertNoMarkers(input: string, label: string): void;
+/**
+ * Extract the first spec block from a prompt string. Returns `null` if
+ * no complete BEGIN/END pair is found. Used by the artifact verifier to
+ * confirm an agent preserved the canonical body.
+ */
+export declare function extractSpec(full: string): string | null;
+/**
+ * Extract the first untrusted block from a prompt string. Returns `null`
+ * if no complete pair is found.
+ */
+export declare function extractUntrusted(full: string): string | null;
+/**
+ * Return true when the given text contains both the BEGIN and END spec
+ * markers in the correct order.
+ */
+export declare function hasSpecMarkers(full: string): boolean;
+//# sourceMappingURL=prompt-markers.d.ts.map

package/dist/_core/dist/agents/prompt-markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-markers.d.ts","sourceRoot":"","sources":["../../src/agents/prompt-markers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,OAAO;;;;;CAKV,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,OAAO,CAAC;AAE9C;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQrD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CASlE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMvD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS5D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIpD"}

package/dist/_core/dist/agents/prompt-markers.js

@@ -0,0 +1,111 @@
+/**
+ * Prompt Markers — delimiters that hedge against prompt injection and
+ * let adapters (and downstream parsers) unambiguously extract the
+ * canonical body, user description, and untrusted inputs.
+ *
+ * Rationale:
+ * - The canonical prompt is byte-identical across agents (I-04). That
+ *   means a compromised user description cannot silently inject new
+ *   instructions — the agent sees the same body regardless.
+ * - Markers give the agent an explicit frame: "what's inside BEGIN/END
+ *   is Raptor's contract; what's inside UNTRUSTED INPUT is user text
+ *   and MUST NOT be executed as instructions."
+ *
+ * Blueprint ref: 17.6 — "Prompt canônico normalizado".
+ */
+export const MARKERS = {
+    specBegin: "<<< RAPTOR SPEC BEGIN >>>",
+    specEnd: "<<< RAPTOR SPEC END >>>",
+    untrustedBegin: "<<< UNTRUSTED INPUT BEGIN >>>",
+    untrustedEnd: "<<< UNTRUSTED INPUT END >>>",
+};
+/**
+ * Wrap a body of canonical-spec text between BEGIN/END markers. The body
+ * is written as-is (newlines preserved). The body is allowed to already
+ * contain UNTRUSTED markers (from `wrapUntrusted`) but must not contain
+ * SPEC markers — nesting specs would break `extractSpec`.
+ */
+export function wrapSpec(body) {
+    if (body.includes(MARKERS.specBegin) || body.includes(MARKERS.specEnd)) {
+        throw new Error(`spec body already contains SPEC BEGIN/END markers. Nested specs are not allowed.`);
+    }
+    return `${MARKERS.specBegin}\n${body.trim()}\n${MARKERS.specEnd}`;
+}
+/**
+ * Wrap a block of untrusted user input (e.g. the feature description
+ * passed to `raptor new`) between UNTRUSTED markers and strip any
+ * occurrence of the control markers from the payload itself.
+ *
+ * Unlike `wrapSpec`, untrusted content is allowed to "contain" what
+ * looks like a marker — we sanitize by replacing those literals with
+ * their visually similar counterparts (angle brackets with fullwidth
+ * form) so the file stays readable and the real markers remain unique.
+ */
+export function wrapUntrusted(raw) {
+    const sanitized = sanitizeUntrusted(raw);
+    return `${MARKERS.untrustedBegin}\n${sanitized.trim()}\n${MARKERS.untrustedEnd}`;
+}
+/**
+ * Replace any occurrence of Raptor's marker strings inside untrusted
+ * input with a safe placeholder. This prevents a malicious description
+ * from ending the untrusted block early and injecting fake "spec" text.
+ */
+export function sanitizeUntrusted(raw) {
+    let out = raw;
+    for (const marker of Object.values(MARKERS)) {
+        // Escape regex meta chars in the marker before building the pattern.
+        const escaped = marker.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        out = out.replace(new RegExp(escaped, "g"), "[marker removed]");
+    }
+    return out;
+}
+/**
+ * Throw if the input contains any Raptor control marker verbatim.
+ * Used on trusted-source text (templates, scope sections) where we
+ * expect the author to never include a marker by accident.
+ */
+export function assertNoMarkers(input, label) {
+    for (const [name, marker] of Object.entries(MARKERS)) {
+        if (input.includes(marker)) {
+            throw new Error(`${label} contains reserved marker "${name}" (${marker}). ` +
+                `Rename the occurrence — Raptor reserves BEGIN/END and UNTRUSTED markers.`);
+        }
+    }
+}
+/**
+ * Extract the first spec block from a prompt string. Returns `null` if
+ * no complete BEGIN/END pair is found. Used by the artifact verifier to
+ * confirm an agent preserved the canonical body.
+ */
+export function extractSpec(full) {
+    const start = full.indexOf(MARKERS.specBegin);
+    if (start === -1)
+        return null;
+    const end = full.indexOf(MARKERS.specEnd, start + MARKERS.specBegin.length);
+    if (end === -1)
+        return null;
+    return full.slice(start + MARKERS.specBegin.length, end).trim();
+}
+/**
+ * Extract the first untrusted block from a prompt string. Returns `null`
+ * if no complete pair is found.
+ */
+export function extractUntrusted(full) {
+    const start = full.indexOf(MARKERS.untrustedBegin);
+    if (start === -1)
+        return null;
+    const end = full.indexOf(MARKERS.untrustedEnd, start + MARKERS.untrustedBegin.length);
+    if (end === -1)
+        return null;
+    return full.slice(start + MARKERS.untrustedBegin.length, end).trim();
+}
+/**
+ * Return true when the given text contains both the BEGIN and END spec
+ * markers in the correct order.
+ */
+export function hasSpecMarkers(full) {
+    const start = full.indexOf(MARKERS.specBegin);
+    const end = full.indexOf(MARKERS.specEnd);
+    return start !== -1 && end !== -1 && end > start;
+}
+//# sourceMappingURL=prompt-markers.js.map

package/dist/_core/dist/agents/prompt-markers.js.map

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

package/dist/_core/dist/agents/registry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Agent Registry — singleton that manages all known agent adapters.
+ *
+ * This is the ONLY entry point for the rest of the system to access agents.
+ * No other module should import adapters directly (blueprint 03§4).
+ */
+import type { AgentAdapter } from "./types.js";
+/**
+ * Register a custom agent adapter (for extensions).
+ * Throws if an adapter with the same id already exists.
+ */
+export declare function registerAgent(adapter: AgentAdapter): void;
+/**
+ * Get an adapter by its canonical key.
+ */
+export declare function getAgent(id: string): AgentAdapter | undefined;
+/**
+ * List all registered adapters.
+ */
+export declare function listAgents(): AgentAdapter[];
+/**
+ * List adapter keys in deterministic order.
+ */
+export declare function knownAgentIds(): string[];
+/**
+ * Detect which agents are actually installed on this system.
+ * Runs each adapter's `installCheck` command and returns those that succeed.
+ */
+export declare function detectInstalledAgents(): AgentAdapter[];
+/**
+ * Resolve an agent by kind string (used when parsing agents.yml).
+ * "kind" maps to adapter "id".
+ */
+export declare function getAgentByKind(kind: string): AgentAdapter | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/_core/dist/agents/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/agents/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA+B/C;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAMzD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAG7D;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,YAAY,EAAE,CAG3C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAGxC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,YAAY,EAAE,CAgBtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAMrE"}

package/dist/_core/dist/agents/registry.js

@@ -0,0 +1,102 @@
+/**
+ * Agent Registry — singleton that manages all known agent adapters.
+ *
+ * This is the ONLY entry point for the rest of the system to access agents.
+ * No other module should import adapters directly (blueprint 03§4).
+ */
+import { claudeCodeAdapter } from "./adapters/claude-code.js";
+import { cursorAdapter } from "./adapters/cursor.js";
+import { antigravityAdapter } from "./adapters/antigravity.js";
+import { geminiAdapter } from "./adapters/gemini.js";
+import { copilotAdapter } from "./adapters/copilot.js";
+import { codexAdapter } from "./adapters/codex.js";
+import { humanAdapter } from "./adapters/human.js";
+import { execSync } from "node:child_process";
+// ---------------------------------------------------------------------------
+// Registry singleton
+// ---------------------------------------------------------------------------
+const REGISTRY = new Map();
+function ensureBuiltins() {
+    if (REGISTRY.size > 0)
+        return;
+    for (const adapter of [
+        claudeCodeAdapter,
+        cursorAdapter,
+        antigravityAdapter,
+        geminiAdapter,
+        copilotAdapter,
+        codexAdapter,
+        humanAdapter,
+    ]) {
+        REGISTRY.set(adapter.id, adapter);
+    }
+}
+/**
+ * Register a custom agent adapter (for extensions).
+ * Throws if an adapter with the same id already exists.
+ */
+export function registerAgent(adapter) {
+    ensureBuiltins();
+    if (REGISTRY.has(adapter.id)) {
+        throw new Error(`Agent adapter "${adapter.id}" is already registered.`);
+    }
+    REGISTRY.set(adapter.id, adapter);
+}
+/**
+ * Get an adapter by its canonical key.
+ */
+export function getAgent(id) {
+    ensureBuiltins();
+    return REGISTRY.get(id);
+}
+/**
+ * List all registered adapters.
+ */
+export function listAgents() {
+    ensureBuiltins();
+    return [...REGISTRY.values()];
+}
+/**
+ * List adapter keys in deterministic order.
+ */
+export function knownAgentIds() {
+    ensureBuiltins();
+    return [...REGISTRY.keys()];
+}
+/**
+ * Detect which agents are actually installed on this system.
+ * Runs each adapter's `installCheck` command and returns those that succeed.
+ */
+export function detectInstalledAgents() {
+    ensureBuiltins();
+    const installed = [];
+    for (const adapter of REGISTRY.values()) {
+        if (adapter.id === "human")
+            continue; // always available
+        if (!adapter.installCheck)
+            continue;
+        try {
+            execSync(adapter.installCheck, { stdio: "ignore", timeout: 5000 });
+            installed.push(adapter);
+        }
+        catch {
+            // not installed or check failed
+        }
+    }
+    // Human is always available as the ultimate fallback
+    installed.push(humanAdapter);
+    return installed;
+}
+/**
+ * Resolve an agent by kind string (used when parsing agents.yml).
+ * "kind" maps to adapter "id".
+ */
+export function getAgentByKind(kind) {
+    ensureBuiltins();
+    for (const adapter of REGISTRY.values()) {
+        if (adapter.id === kind)
+            return adapter;
+    }
+    return undefined;
+}
+//# sourceMappingURL=registry.js.map

package/dist/_core/dist/agents/registry.js.map

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

package/dist/_core/dist/agents/selector.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Agent Selector — deterministic agent selection algorithm.
+ *
+ * Implements the selection policy from §17.4:
+ *   1. --agent flag → manual override
+ *   2. policy.byCommand[command] → command-specific default
+ *   3. policy.default → global fallback
+ *   4. installCheck → validate availability, else fallback_chain[next]
+ *   5. chain exhausted → abort
+ *
+ * Blueprint ref: 17.4 — "Algoritmo de seleção de agente".
+ */
+import type { AgentsConfig, AgentAdapter } from "./types.js";
+export interface SelectionResult {
+    /** Selected agent adapter. */
+    agent: AgentAdapter;
+    /** Agent entry id from agents.yml. */
+    agentEntryId: string;
+    /** Why this agent was selected. */
+    reason: "flag_override" | "command_policy" | "default_policy" | "fallback_chain" | "human_fallback";
+}
+export declare class AgentSelectionError extends Error {
+    constructor(command: string, triedIds: string[]);
+}
+/**
+ * Select the appropriate agent for a command.
+ *
+ * @param config  — Parsed agents.yml
+ * @param command — The SDD command being executed (new, plan, tasks, implement)
+ * @param flagOverride — Optional --agent CLI flag value (agent entry id)
+ */
+export declare function selectAgent(config: AgentsConfig, command: string, flagOverride?: string): SelectionResult;
+//# sourceMappingURL=selector.d.ts.map

package/dist/_core/dist/agents/selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../src/agents/selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQ7D,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,MAAM,EACF,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,CAAC;CACtB;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE;CAQhD;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,eAAe,CA0EjB"}