@imolko/ultra-agent 0.1.0-beta

package/dist-node/reconcile.cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.cli.js","sourceRoot":"","sources":["../src/reconcile.cli.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAEH,qCAAuC;AACvC,2CAIqB;AAOrB,SAAS,UAAU,CAAC,GAAW;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;IAC1D,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;QAClE,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE;KAC5E,CAAC;AACJ,CAAC;AAED,SAAS,IAAI;IACX,IAAI,KAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,KAAK,GAAG,UAAU,CAAC,IAAA,sBAAY,EAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,0FAA0F,CAC3F,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,IAAA,kCAAsB,EAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,OAAO,qBAAqB,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,IAAA,uBAAW,EAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QACpE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist-node/reconcile.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Reconciliación de etiquetas git desde el registry (T-025): cada versión
+ * publicada en npm que no tenga etiqueta git se etiqueta en el commit que la
+ * produjo, que npm expone como `gitHead`.
+ *
+ * Funciones puras: ninguna toca el sistema de archivos ni el shell. El CLI
+ * (`reconcile.cli.ts`) las expone a los scripts de release; los tests las
+ * ejercen directamente sobre listas de versiones y etiquetas.
+ */
+export interface PublishedVersion {
+    version: string;
+    gitHead: string | undefined;
+}
+export interface TagPlan {
+    version: string;
+    commit: string;
+}
+/**
+ * Devuelve los planes `{version, commit}` de las versiones publicadas que no
+ * tienen etiqueta, preservando el orden de `published`. Las versiones sin
+ * `gitHead` no se incluyen: no hay commit al que anclar la etiqueta.
+ */
+export declare function missingTags(published: PublishedVersion[], existingTags: string[]): TagPlan[];
+/**
+ * Reporte de las versiones publicadas que no traen `gitHead`: indica una
+ * publicación que no salió de un checkout git y, por tanto, no puede
+ * reconciliarse con una etiqueta. Preserva el orden de `published`.
+ */
+export declare function versionsWithoutGitHead(published: PublishedVersion[]): string[];
+//# sourceMappingURL=reconcile.d.ts.map

package/dist-node/reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../src/reconcile.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAUD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,gBAAgB,EAAE,EAC7B,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,EAAE,CAWX;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,EAAE,GAAG,MAAM,EAAE,CAQ9E"}

package/dist-node/reconcile.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Reconciliación de etiquetas git desde el registry (T-025): cada versión
+ * publicada en npm que no tenga etiqueta git se etiqueta en el commit que la
+ * produjo, que npm expone como `gitHead`.
+ *
+ * Funciones puras: ninguna toca el sistema de archivos ni el shell. El CLI
+ * (`reconcile.cli.ts`) las expone a los scripts de release; los tests las
+ * ejercen directamente sobre listas de versiones y etiquetas.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.missingTags = missingTags;
+exports.versionsWithoutGitHead = versionsWithoutGitHead;
+/**
+ * Considera que una versión trae `gitHead` solo si es una cadena no vacía. Un
+ * valor ausente o vacío significa que npm no registró el commit de origen.
+ */
+function hasGitHead(item) {
+    return typeof item.gitHead === "string" && item.gitHead.length > 0;
+}
+/**
+ * Devuelve los planes `{version, commit}` de las versiones publicadas que no
+ * tienen etiqueta, preservando el orden de `published`. Las versiones sin
+ * `gitHead` no se incluyen: no hay commit al que anclar la etiqueta.
+ */
+function missingTags(published, existingTags) {
+    const existing = new Set(existingTags);
+    const plans = [];
+    for (const item of published) {
+        if (!hasGitHead(item))
+            continue;
+        if (existing.has(item.version))
+            continue;
+        plans.push({ version: item.version, commit: item.gitHead });
+    }
+    return plans;
+}
+/**
+ * Reporte de las versiones publicadas que no traen `gitHead`: indica una
+ * publicación que no salió de un checkout git y, por tanto, no puede
+ * reconciliarse con una etiqueta. Preserva el orden de `published`.
+ */
+function versionsWithoutGitHead(published) {
+    const result = [];
+    for (const item of published) {
+        if (!hasGitHead(item))
+            result.push(item.version);
+    }
+    return result;
+}
+//# sourceMappingURL=reconcile.js.map

package/dist-node/reconcile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.js","sourceRoot":"","sources":["../src/reconcile.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAyBH,kCAcC;AAOD,wDAQC;AA1CD;;;GAGG;AACH,SAAS,UAAU,CAAC,IAAsB;IACxC,OAAO,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,SAAgB,WAAW,CACzB,SAA6B,EAC7B,YAAsB;IAEtB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,KAAK,GAAc,EAAE,CAAC;IAE5B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QAChC,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,SAAS;QACzC,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAgB,sBAAsB,CAAC,SAA6B;IAClE,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist-node/ship/prompts/fix.md

@@ -0,0 +1,22 @@
+---
+name: fix
+description: Corrige los hallazgos de la revisión y deja los tests en verde.
+tools: read, edit, write, bash, grep, find, ls
+---
+
+# Fix
+
+Eres un agente de corrección. Recibes los hallazgos de la revisión y los corriges.
+
+## Reglas
+
+- Corrige cada hallazgo de la lista.
+- Ejecuta el build y las pruebas; todo debe quedar en verde.
+- No toques el tracker: no ejecutes `glab`.
+
+## Salida
+
+Tu mensaje final debe **terminar** con UNA de estas dos líneas:
+
+- `VERDICT: done` — hallazgos corregidos, tests en verde.
+- `VERDICT: blocked` — no puedes corregir sin intervención humana; explica por qué.

package/dist-node/ship/prompts/implement.md

@@ -0,0 +1,34 @@
+---
+name: implement
+description: Implementa un único issue hijo de un spec, con contexto fresco y enfocado.
+tools: read, edit, write, bash, grep, find, ls
+---
+
+# Implement
+
+Eres un agente de implementación. En esta sesión implementas **un único issue hijo** y nada más.
+
+## Entrada
+
+Recibirás tres piezas de contexto:
+
+1. El spec padre (PRD) — contexto general del esfuerzo.
+2. El issue hijo — lo **único** que debes implementar en esta sesión.
+3. El progreso reciente (comentarios del padre) — lo que ya se ha hecho.
+
+## Reglas
+
+- Implementa exactamente lo que pide el issue hijo. Sigue su `# Alcance` y su `# Criterio de cierre` al pie de la letra.
+- Si el `# Alcance` referencia un skill (ej. `/skill:ultra-generator`, `/skill:tdd`), úsalo como primera instrucción.
+- No toques el tracker: no ejecutes `glab`, no cambies labels ni asignees. De eso se encarga el orquestador.
+- Escribe código y pruebas con `/skill:tdd`, siguiendo los ADRs aplicables del registro.
+- Ejecuta el build y las pruebas; deja todo en verde antes de terminar.
+
+## Salida
+
+Cuando hayas terminado — o si no puedes avanzar —, tu mensaje final debe **terminar** con UNA de estas dos líneas, seguida de un resumen breve de lo hecho:
+
+- `VERDICT: done` — implementado, build y tests en verde.
+- `VERDICT: blocked` — no puedes completar sin intervención humana; explica por qué.
+
+No emitas la línea `VERDICT` antes de haber terminado de verdad.

package/dist-node/ship/prompts/review.md

@@ -0,0 +1,28 @@
+---
+name: review
+description: Revisa el diff acumulado de un spec contra su PRD y los ADRs que lo gobiernan.
+tools: read, grep, find, ls, bash
+---
+
+# Review
+
+Eres un revisor de código. Revisa el diff completo del working tree contra:
+
+1. El spec padre (PRD) — lo que se pidió.
+2. Los ADRs que gobiernan el área tocada (`docs/adr/`).
+3. Los `# Criterio de cierre` de los issues hijos implementados.
+
+## Qué revisar
+
+- **Corrección**: ¿cumple el spec y los criterios de cierre?
+- **Estándares**: ¿respeta los ADRs (arquitectura, TDD, completitud)?
+- **Calidad**: ¿pruebas adecuadas, sin deuda evidente, sin código muerto?
+
+## Salida
+
+Termina con una lista numerada de hallazgos (si los hay) y, en la última línea, UNA de estas dos:
+
+- `VERDICT: clean` — sin hallazgos.
+- `VERDICT: issues` — con la lista de hallazgos a corregir.
+
+**No corrijas nada tú**: solo reporta. La corrección la hace otro agente.

package/dist-node/ship/ship.agent.d.ts

@@ -0,0 +1,22 @@
+export interface AgentResult {
+    verdict: string;
+    output: string;
+    exitCode: number;
+}
+export interface RunAgentInput {
+    phase: string;
+    contextFiles: string[];
+    task: string;
+    provider: string;
+    model: string;
+}
+/** Elimina un archivo o directorio temporal sin fallar si ya no existe. */
+export declare function removePath(path: string): void;
+/** Lee el prompt de fase desde el payload del paquete (no `cwd/.pi/agents/`). */
+export declare function readAgentPrompt(name: string): string;
+/** Procesa una línea JSON del stdout de pi; devuelve el delta de texto, si lo hay. */
+export declare function handleOutputLine(line: string): string;
+/** Extrae el veredicto final del texto del agente. */
+export declare function extractVerdict(text: string): string;
+export declare function runAgent(input: RunAgentInput): Promise<AgentResult>;
+//# sourceMappingURL=ship.agent.d.ts.map

package/dist-node/ship/ship.agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship.agent.d.ts","sourceRoot":"","sources":["../../src/ship/ship.agent.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AASD,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7C;AAID,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOpD;AAuCD,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWrD;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AAkBD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CA2CnE"}

package/dist-node/ship/ship.agent.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removePath = removePath;
+exports.readAgentPrompt = readAgentPrompt;
+exports.handleOutputLine = handleOutputLine;
+exports.extractVerdict = extractVerdict;
+exports.runAgent = runAgent;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+const ship_output_1 = require("./ship.output");
+const PI_RESOLVE_TIMEOUT_MS = 5000;
+const TEXT_PREVIEW_LENGTH = 200;
+const STDERR_TAIL_LENGTH = 500;
+/** Elimina un archivo o directorio temporal sin fallar si ya no existe. */
+function removePath(path) {
+    try {
+        (0, node_fs_1.rmSync)(path, { recursive: true, force: true });
+    }
+    catch { /* ignore */ }
+}
+// ── Agent prompt (modular: lives in the package payload, A-039) ───────────────
+/** Lee el prompt de fase desde el payload del paquete (no `cwd/.pi/agents/`). */
+function readAgentPrompt(name) {
+    const file = (0, node_path_1.join)(__dirname, "prompts", `${name}.md`);
+    const text = (0, node_fs_1.readFileSync)(file, "utf-8");
+    // Strip YAML frontmatter (--- ... ---); the body is the system prompt.
+    const match = text.match(/^---\n[\s\S]*?\n---\n?/);
+    return match ? text.slice(match[0].length).trim() : text.trim();
+}
+function preview(text) {
+    if (text.length <= TEXT_PREVIEW_LENGTH)
+        return text;
+    return `${text.slice(0, TEXT_PREVIEW_LENGTH)}...`;
+}
+function toolName(event) {
+    return event.toolName === undefined ? "?" : event.toolName;
+}
+function argText(event, key) {
+    const args = event.args;
+    if (args === undefined)
+        return "";
+    const value = args[key];
+    return value === undefined ? "" : value;
+}
+function toolLabel(event) {
+    const name = toolName(event);
+    if (name === "read")
+        return `  📖 ${argText(event, "path")}`;
+    if (name === "edit")
+        return `  ✏️  ${argText(event, "path")}`;
+    if (name === "write")
+        return `  📝 ${argText(event, "path")}`;
+    if (name === "bash")
+        return `  💻 ${preview(argText(event, "command"))}`;
+    return "";
+}
+function logToolEvent(event) {
+    const label = toolLabel(event);
+    if (label.length > 0)
+        (0, ship_output_1.writeLine)(label);
+}
+function eventTextDelta(event) {
+    if (event.type === "message_update" && event.assistantMessageEvent?.type === "text_delta") {
+        return event.assistantMessageEvent.delta ?? "";
+    }
+    return "";
+}
+/** Procesa una línea JSON del stdout de pi; devuelve el delta de texto, si lo hay. */
+function handleOutputLine(line) {
+    try {
+        const event = JSON.parse(line);
+        if (event.type === "tool_execution_start") {
+            logToolEvent(event);
+            return "";
+        }
+        return eventTextDelta(event);
+    }
+    catch {
+        return ""; // skip non-JSON lines
+    }
+}
+/** Extrae el veredicto final del texto del agente. */
+function extractVerdict(text) {
+    const match = text.match(/VERDICT:\s*(done|blocked|clean|issues)/i);
+    return match ? match[1].toLowerCase() : "";
+}
+function makeAgentArgs(input, bodyFile) {
+    const args = [
+        "--mode", "json",
+        "--provider", input.provider,
+        "--model", input.model,
+        "--print",
+        "--no-session",
+        "--append-system-prompt", bodyFile,
+    ];
+    for (const file of input.contextFiles)
+        args.push(`@${file}`);
+    args.push(input.task);
+    return args;
+}
+// ── Sub-agent runner (fresh isolated pi per phase) ────────────────────────────
+function runAgent(input) {
+    return new Promise((resolve, reject) => {
+        const body = readAgentPrompt(input.phase);
+        const tmpDir = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), "ship-"));
+        const bodyFile = (0, node_path_1.join)(tmpDir, "agent.md");
+        (0, node_fs_1.writeFileSync)(bodyFile, body);
+        const piBin = (0, node_child_process_1.execSync)("which pi", { encoding: "utf-8", timeout: PI_RESOLVE_TIMEOUT_MS }).trim();
+        const pi = (0, node_child_process_1.spawn)(piBin, makeAgentArgs(input, bodyFile), { stdio: ["pipe", "pipe", "pipe"] });
+        pi.stdin.end();
+        let lastAssistantText = "";
+        let stderr = "";
+        pi.stdout.on("data", (chunk) => {
+            const lines = chunk.toString().split("\n").filter((line) => line.trim().length > 0);
+            for (const line of lines) {
+                lastAssistantText += handleOutputLine(line);
+            }
+        });
+        pi.stderr.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        pi.on("close", (exitCode) => {
+            removePath(tmpDir);
+            const verdict = extractVerdict(lastAssistantText);
+            if (exitCode !== 0 && verdict.length === 0) {
+                (0, ship_output_1.writeError)(stderr.slice(-STDERR_TAIL_LENGTH));
+            }
+            resolve({
+                verdict,
+                output: lastAssistantText.trim(),
+                exitCode: exitCode ?? 1,
+            });
+        });
+        pi.on("error", (error) => {
+            removePath(tmpDir);
+            reject(error);
+        });
+    });
+}
+//# sourceMappingURL=ship.agent.js.map

package/dist-node/ship/ship.agent.js.map

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

package/dist-node/ship/ship.args.d.ts

@@ -0,0 +1,15 @@
+export interface ParsedArgs {
+    parentIid: number;
+    provider: string;
+    model: string;
+    maxIterations: number;
+    targetBranch: string;
+}
+export declare const DEFAULT_PROVIDER = "deepseek";
+export declare const DEFAULT_MODEL = "deepseek-v4-pro";
+export declare const DEFAULT_TARGET_BRANCH = "develop";
+/** Parsea los argumentos crudos (sin `process.argv`) — puro, testable. */
+export declare function parseArgv(argv: string[]): ParsedArgs;
+export declare function parseArgs(): ParsedArgs;
+export declare function usageText(): string;
+//# sourceMappingURL=ship.args.d.ts.map

package/dist-node/ship/ship.args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship.args.d.ts","sourceRoot":"","sources":["../../src/ship/ship.args.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAYD,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAC3C,eAAO,MAAM,aAAa,oBAAoB,CAAC;AAC/C,eAAO,MAAM,qBAAqB,YAAY,CAAC;AA6B/C,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAmBpD;AAED,wBAAgB,SAAS,IAAI,UAAU,CAEtC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAoBlC"}

package/dist-node/ship/ship.args.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TARGET_BRANCH = exports.DEFAULT_MODEL = exports.DEFAULT_PROVIDER = void 0;
+exports.parseArgv = parseArgv;
+exports.parseArgs = parseArgs;
+exports.usageText = usageText;
+const ship_output_1 = require("./ship.output");
+const VALUE_OPTIONS = [
+    "--parent-iid", "-p",
+    "--provider",
+    "--model", "-m",
+    "--max-iterations", "-i",
+    "--target-branch",
+];
+const HELP_OPTIONS = ["--help", "-h"];
+exports.DEFAULT_PROVIDER = "deepseek";
+exports.DEFAULT_MODEL = "deepseek-v4-pro";
+exports.DEFAULT_TARGET_BRANCH = "develop";
+function firstArg(raw, names) {
+    for (const name of names) {
+        const value = raw[name];
+        if (value !== undefined)
+            return value;
+    }
+    return "";
+}
+function withDefault(value, fallback) {
+    return value.length === 0 ? fallback : value;
+}
+function toInt(text) {
+    const parsed = parseInt(text, 10);
+    return Number.isNaN(parsed) ? 0 : parsed;
+}
+function extractArgs(raw) {
+    return {
+        parentIid: toInt(firstArg(raw, ["--parent-iid", "-p"])),
+        provider: withDefault(firstArg(raw, ["--provider"]), exports.DEFAULT_PROVIDER),
+        model: withDefault(firstArg(raw, ["--model", "-m"]), exports.DEFAULT_MODEL),
+        maxIterations: toInt(firstArg(raw, ["--max-iterations", "-i"])),
+        targetBranch: withDefault(firstArg(raw, ["--target-branch"]), exports.DEFAULT_TARGET_BRANCH),
+    };
+}
+/** Parsea los argumentos crudos (sin `process.argv`) — puro, testable. */
+function parseArgv(argv) {
+    const raw = {};
+    for (let idx = 0; idx < argv.length; idx++) {
+        const option = argv[idx];
+        if (HELP_OPTIONS.includes(option)) {
+            printUsage(0);
+        }
+        if (VALUE_OPTIONS.includes(option)) {
+            raw[option] = argv[idx + 1] ?? "";
+            idx++;
+        }
+        else {
+            (0, ship_output_1.writeError)(`Unknown option: ${option}`);
+            printUsage(1);
+        }
+    }
+    const parsed = extractArgs(raw);
+    if (parsed.parentIid === 0)
+        printUsage(1);
+    return parsed;
+}
+function parseArgs() {
+    return parseArgv(process.argv.slice(2));
+}
+function usageText() {
+    return `ship — implement a parent spec's child issues, review, fix, and open one MR.
+
+Run: one unblocked child at a time (state::ready + exec::AFK), claimed and marked
+completed on VERDICT: done. Then the full diff is reviewed, findings fixed (up to
+3 attempts, trusting the fix agent's verdict), and one MR per parent opened. No MR
+is opened if no child completed; the MR's Closes lists only the completed children.
+Leftover in-development children from an interrupted run are reset to ready on start.
+
+Usage: ultra-agent ship --parent-iid <iid> [--provider <name>] [--model <id>]
+         [--max-iterations <n>] [--target-branch <branch>]
+
+  --parent-iid, -p    The IID of the parent issue (spec/PRD)
+  --provider          Provider name (default: ${exports.DEFAULT_PROVIDER})
+  --model, -m         Model ID (default: ${exports.DEFAULT_MODEL})
+  --max-iterations, -i  Safety cap on child issues (0 = unlimited)
+  --target-branch     Target branch of the MR (default: ${exports.DEFAULT_TARGET_BRANCH})
+
+Example:
+  ultra-agent ship -p 42`;
+}
+function printUsage(exitCode) {
+    (0, ship_output_1.writeLine)(usageText());
+    process.exit(exitCode);
+}
+//# sourceMappingURL=ship.args.js.map

package/dist-node/ship/ship.args.js.map

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

package/dist-node/ship/ship.context.d.ts

@@ -0,0 +1,12 @@
+import type { Issue } from "./ship.tracker";
+/** Estado compartido de una ejecución del pipeline ship (A-039). */
+export interface ShipContext {
+    parentIid: number;
+    provider: string;
+    model: string;
+    maxIterations: number;
+    targetBranch: string;
+    projectEncoded: string;
+    parentIssue: Issue;
+}
+//# sourceMappingURL=ship.context.d.ts.map

package/dist-node/ship/ship.context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship.context.d.ts","sourceRoot":"","sources":["../../src/ship/ship.context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,KAAK,CAAC;CACpB"}

package/dist-node/ship/ship.context.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ship.context.js.map

package/dist-node/ship/ship.context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship.context.js","sourceRoot":"","sources":["../../src/ship/ship.context.ts"],"names":[],"mappings":""}

package/dist-node/ship/ship.d.ts

@@ -0,0 +1,4 @@
+import { type ParsedArgs } from "./ship.args";
+export declare function main(args: ParsedArgs): Promise<void>;
+export declare function runShip(argv: string[]): Promise<void>;
+//# sourceMappingURL=ship.d.ts.map

package/dist-node/ship/ship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship.d.ts","sourceRoot":"","sources":["../../src/ship/ship.ts"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AA0NzD,wBAAsB,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC1D;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3D"}