@autonav/core 1.5.0 → 1.7.0

package/dist/standup/prompts.js

@@ -0,0 +1,211 @@
+/**
+ * Prompts for Standup Mode
+ *
+ * System prompts and user prompts for the report and sync phases.
+ * Uses shared Agent Identity Protocol from communication-layer.
+ *
+ * Prompt engineering principles applied:
+ * - XML tags separate data from instructions (Anthropic best practice)
+ * - System prompts define role/constraints; user prompts define task/data (no duplication)
+ * - Guided chain-of-thought before tool submission
+ * - Explicit context: what output is used for, who reads it, where it fits in workflow
+ * - Minimize noise: no redundant instructions between system and user prompts
+ */
+import { buildAgentIdentityProtocol, } from "@autonav/communication-layer";
+/**
+ * Build the system prompt for a navigator in the report phase.
+ *
+ * Role definition + behavioral constraints only.
+ * Task-specific instructions live in the user prompt to avoid duplication.
+ */
+export function buildReportSystemPrompt(navSystemPrompt) {
+    return `${navSystemPrompt}
+
+<standup_role>
+You are participating in Phase 1 (Report) of a multi-navigator standup. Your output will be read by other navigators in Phase 2 (Sync) to identify cross-navigator dependencies and resolve blockers.
+
+Your sole deliverable is a structured status report submitted via the \`submit_status_report\` tool. Do not produce any other output.
+
+<constraints>
+- You have READ-ONLY access. Do not attempt to write, edit, or create files.
+- Base every claim on evidence from your knowledge base or working directories. If you have no evidence of recent progress, say so rather than fabricating items.
+- A blocker is something that prevents YOU from making progress. Do not report general risks or hypotheticals as blockers.
+- For each blocker, if you know which specific navigator could help, set \`needsFrom\` to their exact name. Otherwise set it to "any".
+- \`severity\` meanings: "critical" = completely blocked, cannot proceed; "moderate" = slowed but can work around; "minor" = inconvenience, low priority.
+- \`canHelpWith\` should describe concrete capabilities, not vague offers. Bad: "general advice". Good: "Kubernetes ingress configuration for multi-tenant setups".
+</constraints>
+</standup_role>`;
+}
+/**
+ * Build the user prompt for the report phase.
+ *
+ * Provides task context, data via XML tags, and guided chain-of-thought.
+ */
+export function buildReportPrompt(context, identity) {
+    const identityProtocol = buildAgentIdentityProtocol(identity, {
+        name: "Autonav Standup",
+        request: "Provide your status report for this multi-navigator standup using the `submit_status_report` tool.",
+    });
+    const otherNavsList = context.otherNavigators.length > 0
+        ? context.otherNavigators.map((n) => `  - ${n}`).join("\n")
+        : "  (none)";
+    return `${identityProtocol}
+<task_context>
+This is a multi-navigator standup. After all navigators submit their reports in parallel, each navigator will review ALL reports and attempt to resolve each other's blockers. Your report directly determines whether other navigators can help you, so specificity matters.
+</task_context>
+
+<your_environment>
+<directory>${context.navDirectory}</directory>
+<knowledge_base>${context.knowledgeBasePath}</knowledge_base>
+<other_navigators>
+${otherNavsList}
+</other_navigators>
+</your_environment>
+
+<instructions>
+Think step-by-step before submitting your report:
+
+1. Read your CLAUDE.md file to understand your current role, domain, and responsibilities.
+2. Scan your knowledge base directory to identify recent work, changes, or documented progress.
+3. If you have working directories configured, scan those for additional context about your current state.
+4. Think through the following in order:
+   a. What is your primary focus area right now? Be specific — name the feature, system, or problem.
+   b. What concrete progress have you made? List only things you can point to evidence for.
+   c. What is actually blocking you? Only report real blockers, not hypothetical risks. For each one, assess severity and whether a specific other navigator could help.
+   d. Given the other navigators in this standup, what concrete expertise or knowledge could you offer them?
+   e. Are there areas where you lack knowledge that another navigator might cover?
+5. Submit your report using the \`submit_status_report\` tool with your findings.
+</instructions>`;
+}
+/**
+ * Build the system prompt for a navigator in the sync phase.
+ *
+ * Role definition + behavioral constraints only.
+ */
+export function buildSyncSystemPrompt(navSystemPrompt) {
+    return `${navSystemPrompt}
+
+<standup_role>
+You are participating in Phase 2 (Sync) of a multi-navigator standup. You have received status reports from all navigators and must help resolve their blockers using your domain expertise.
+
+Your sole deliverable is a structured sync response submitted via the \`submit_sync_response\` tool.
+
+<constraints>
+- You MAY read and modify files in your own directory.
+- You MAY write shared artifacts (docs, configs, scripts) to the standup directory.
+- You MUST NOT modify files in other navigators' directories.
+- Prioritize blockers by severity: resolve "critical" blockers first, then "moderate", then "minor".
+- For each resolution, honestly assess your confidence: "high" = you are certain this resolves the blocker; "medium" = likely helpful but the navigator should verify; "low" = best-effort suggestion, may not fully resolve it.
+- If you create an artifact file to help resolve a blocker, write it to the standup directory and reference its path in \`artifactPath\`.
+- Set \`followUpNeeded\` to true only if there are unresolved critical blockers or if your resolution requires the other navigator to take action and confirm.
+</constraints>
+</standup_role>`;
+}
+/**
+ * Build the user prompt for the sync phase.
+ *
+ * Data sections use XML tags for clean separation.
+ * Includes guided chain-of-thought for blocker prioritization.
+ */
+export function buildSyncPrompt(context, identity) {
+    const identityProtocol = buildAgentIdentityProtocol(identity, {
+        name: "Autonav Standup",
+        request: "Review all status reports and help resolve blockers using the `submit_sync_response` tool.",
+    });
+    const reportsXml = context.allReports
+        .map((r) => formatReportAsXml(r))
+        .join("\n\n");
+    const previousSyncXml = context.previousSyncResponses.length > 0
+        ? `<previous_sync_responses>
+${context.previousSyncResponses.map((s) => formatSyncAsXml(s)).join("\n\n")}
+</previous_sync_responses>`
+        : "";
+    return `${identityProtocol}
+<task_context>
+This is the sync phase of a multi-navigator standup. Each navigator takes a turn reviewing all status reports and attempting to resolve blockers from their domain expertise. You are seeing all reports plus any sync responses from navigators who went before you. Your goal is to unblock other navigators wherever your knowledge applies.
+</task_context>
+
+<your_environment>
+<directory>${context.navDirectory}</directory>
+<standup_output_directory>${context.standupDir}</standup_output_directory>
+</your_environment>
+
+<status_reports>
+${reportsXml}
+</status_reports>
+
+${previousSyncXml}
+
+<instructions>
+Think step-by-step before submitting your sync response:
+
+1. Read through every status report above. For each blocker, note:
+   - Does \`needsFrom\` match your name ("${identity?.name || "your name"}")? These are your primary responsibility.
+   - Is \`needsFrom\` set to "any"? You should attempt these if they fall in your domain.
+   - What is the severity? Prioritize critical > moderate > minor.
+
+2. For each blocker you can address:
+   a. Read relevant files from your knowledge base or working directories to find the answer.
+   b. Determine whether you can fully resolve it, partially help, or only offer a lead.
+   c. If the resolution would benefit from a written artifact (e.g., a config snippet, a runbook, a script), write it to the standup output directory and note the path.
+   d. Assess your confidence honestly.
+
+3. Review whether previous sync responses (if any) already addressed some blockers. Do not duplicate work — build on or refine previous resolutions instead.
+
+4. Note any new cross-cutting insights you discovered while reviewing all the reports together (e.g., two navigators working on conflicting approaches, shared dependencies, opportunities for collaboration).
+
+5. Submit your sync response using the \`submit_sync_response\` tool.
+</instructions>`;
+}
+/**
+ * Format a status report as XML for the sync phase context.
+ * XML tags provide clean boundaries between data sections.
+ */
+function formatReportAsXml(report) {
+    const blockersList = report.blockers.length > 0
+        ? report.blockers
+            .map((b) => `    <blocker severity="${b.severity}"${b.needsFrom ? ` needs_from="${b.needsFrom}"` : ""}>${b.description}</blocker>`)
+            .join("\n")
+        : "    <none/>";
+    const canHelpList = report.canHelpWith.length > 0
+        ? report.canHelpWith.map((h) => `    <capability>${h}</capability>`).join("\n")
+        : "    <none/>";
+    const gapsList = report.knowledgeGaps && report.knowledgeGaps.length > 0
+        ? `\n  <knowledge_gaps>\n${report.knowledgeGaps.map((g) => `    <gap>${g}</gap>`).join("\n")}\n  </knowledge_gaps>`
+        : "";
+    return `<report navigator="${report.navigatorName}">
+  <current_focus>${report.currentFocus}</current_focus>
+  <recent_progress>
+${report.recentProgress.map((p) => `    <item>${p}</item>`).join("\n")}
+  </recent_progress>
+  <blockers>
+${blockersList}
+  </blockers>
+  <can_help_with>
+${canHelpList}
+  </can_help_with>${gapsList}
+</report>`;
+}
+/**
+ * Format a sync response as XML for accumulating context
+ */
+function formatSyncAsXml(sync) {
+    const resolutions = sync.blockerResolutions.length > 0
+        ? sync.blockerResolutions
+            .map((r) => `    <resolution for="${r.navigatorName}" confidence="${r.confidence}"${r.artifactPath ? ` artifact="${r.artifactPath}"` : ""}>
+      <blocker>${r.blockerDescription}</blocker>
+      <answer>${r.resolution}</answer>
+    </resolution>`)
+            .join("\n")
+        : "    <none/>";
+    const insights = sync.newInsights && sync.newInsights.length > 0
+        ? `\n  <insights>\n${sync.newInsights.map((i) => `    <insight>${i}</insight>`).join("\n")}\n  </insights>`
+        : "";
+    return `<sync_response navigator="${sync.navigatorName}" follow_up_needed="${sync.followUpNeeded}">
+  <summary>${sync.summary}</summary>
+  <blocker_resolutions>
+${resolutions}
+  </blocker_resolutions>${insights}
+</sync_response>`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/standup/prompts.js.map

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

package/dist/standup/standup-protocol.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Standup Protocol MCP Servers
+ *
+ * MCP server factories providing submit_status_report and submit_sync_response
+ * tools for the standup report and sync phases respectively.
+ */
+import { type StatusReport, type SyncResponse } from "./types.js";
+/**
+ * Tool names
+ */
+export declare const SUBMIT_STATUS_REPORT_TOOL = "submit_status_report";
+export declare const SUBMIT_SYNC_RESPONSE_TOOL = "submit_sync_response";
+/**
+ * Create an MCP server with the submit_status_report tool for the report phase.
+ *
+ * Each navigator gets its own server instance (separate closure).
+ */
+export declare function createReportProtocolTools(): {
+    tools: import("../harness/tool-server.js").ToolDefinition[];
+    getCapturedReport: () => StatusReport | null;
+    resetCapturedReport: () => void;
+};
+/**
+ * Create an MCP server with the submit_sync_response tool for the sync phase.
+ *
+ * Each navigator gets its own server instance (separate closure).
+ */
+export declare function createSyncProtocolTools(): {
+    tools: import("../harness/tool-server.js").ToolDefinition[];
+    getCapturedSync: () => SyncResponse | null;
+    resetCapturedSync: () => void;
+};
+//# sourceMappingURL=standup-protocol.d.ts.map

package/dist/standup/standup-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standup-protocol.d.ts","sourceRoot":"","sources":["../../src/standup/standup-protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAChE,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAwBhE;;;;GAIG;AACH,wBAAgB,yBAAyB;;6BAgFd,YAAY,GAAG,IAAI;;EAK7C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB;;2BA0Ed,YAAY,GAAG,IAAI;;EAK3C"}

package/dist/standup/standup-protocol.js

@@ -0,0 +1,189 @@
+/**
+ * Standup Protocol MCP Servers
+ *
+ * MCP server factories providing submit_status_report and submit_sync_response
+ * tools for the standup report and sync phases respectively.
+ */
+import { z } from "zod";
+import { defineTool } from "../harness/index.js";
+import { StatusReportSchema, SyncResponseSchema, } from "./types.js";
+/**
+ * Tool names
+ */
+export const SUBMIT_STATUS_REPORT_TOOL = "submit_status_report";
+export const SUBMIT_SYNC_RESPONSE_TOOL = "submit_sync_response";
+const DEBUG = process.env.AUTONAV_DEBUG === "1" || process.env.DEBUG === "1";
+/**
+ * Recursively strip null values to undefined so Zod .optional() accepts them.
+ *
+ * Models produce JSON where optional fields are `null` (JSON has no `undefined`).
+ * Zod's `.optional()` expects `T | undefined`, rejecting `null`. This mismatch
+ * silently breaks MCP tool handlers.
+ */
+function stripNulls(obj) {
+    if (obj === null)
+        return undefined;
+    if (Array.isArray(obj))
+        return obj.map(stripNulls);
+    if (typeof obj === "object" && obj !== null) {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            result[key] = stripNulls(value);
+        }
+        return result;
+    }
+    return obj;
+}
+/**
+ * Create an MCP server with the submit_status_report tool for the report phase.
+ *
+ * Each navigator gets its own server instance (separate closure).
+ */
+export function createReportProtocolTools() {
+    let capturedReport = null;
+    const tools = [
+        defineTool(SUBMIT_STATUS_REPORT_TOOL, `Submit your structured status report. This is the ONLY way to deliver your report — the standup loop captures your output exclusively through this tool. Plain text responses are discarded.
+
+Other navigators will read your report in the sync phase to identify blockers they can resolve for you. Be specific: vague blockers cannot be acted on, and vague offers to help will be ignored.`, {
+            navigatorName: z.string().describe("Your exact navigator name as it appears in config.json"),
+            currentFocus: z.string().min(5).describe("Specific feature, system, or problem you are working on right now"),
+            recentProgress: z
+                .array(z.string())
+                .describe("Concrete accomplishments you have evidence for. Each item should be a single sentence."),
+            blockers: z
+                .array(z.object({
+                description: z.string().describe("Specific description of what is blocked and why. Include enough detail for another navigator to act on it."),
+                needsFrom: z
+                    .string()
+                    .nullish()
+                    .describe("Exact name of the navigator who can help, or 'any' if anyone with relevant expertise could help"),
+                severity: z
+                    .enum(["critical", "moderate", "minor"])
+                    .describe("critical = completely blocked; moderate = slowed, can work around; minor = inconvenience"),
+            }))
+                .describe("Real blockers preventing progress. Do not include hypothetical risks."),
+            canHelpWith: z
+                .array(z.string())
+                .describe("Concrete capabilities you can offer others. Be specific enough that another navigator can decide whether to ask you."),
+            knowledgeGaps: z
+                .array(z.string())
+                .nullish()
+                .describe("Specific areas where you lack knowledge that another navigator might cover"),
+        }, async (args) => {
+            if (DEBUG) {
+                console.error(`[debug] submit_status_report HANDLER ENTERED`);
+                console.error(`[debug] Raw args keys:`, Object.keys(args));
+            }
+            try {
+                const cleaned = stripNulls(args);
+                const report = StatusReportSchema.parse(cleaned);
+                capturedReport = report;
+                const blockerSummary = report.blockers.length > 0
+                    ? `${report.blockers.length} blocker(s) reported.`
+                    : "No blockers.";
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: true,
+                                message: `Status report submitted. ${blockerSummary}`,
+                                report,
+                            }),
+                        },
+                    ],
+                    isError: false,
+                };
+            }
+            catch (error) {
+                if (DEBUG) {
+                    console.error(`[debug] submit_status_report handler error:`, error);
+                    console.error(`[debug] Raw args:`, JSON.stringify(args, null, 2));
+                }
+                throw error;
+            }
+        }),
+    ];
+    return {
+        tools,
+        getCapturedReport: () => capturedReport,
+        resetCapturedReport: () => {
+            capturedReport = null;
+        },
+    };
+}
+/**
+ * Create an MCP server with the submit_sync_response tool for the sync phase.
+ *
+ * Each navigator gets its own server instance (separate closure).
+ */
+export function createSyncProtocolTools() {
+    let capturedSync = null;
+    const tools = [
+        defineTool(SUBMIT_SYNC_RESPONSE_TOOL, `Submit your structured sync response after reviewing all status reports. This is the ONLY way to deliver your response — the standup loop captures your output exclusively through this tool. Plain text responses are discarded.
+
+Prioritize resolving blockers where \`needsFrom\` matches your name, then those set to "any" that fall in your domain. Assess confidence honestly per resolution.`, {
+            navigatorName: z.string().describe("Your exact navigator name as it appears in config.json"),
+            summary: z.string().min(5).describe("One-paragraph summary of what you contributed in this sync round"),
+            blockerResolutions: z
+                .array(z.object({
+                navigatorName: z
+                    .string()
+                    .describe("Exact name of the navigator whose blocker you are resolving"),
+                blockerDescription: z.string().describe("The blocker description as written in their report, so it can be matched"),
+                resolution: z
+                    .string()
+                    .describe("Actionable resolution: what the navigator should do, with enough detail to act on immediately"),
+                artifactPath: z
+                    .string()
+                    .nullish()
+                    .describe("Absolute path to any artifact you wrote to the standup directory to support this resolution"),
+                confidence: z
+                    .enum(["high", "medium", "low"])
+                    .describe("high = certain this resolves it; medium = likely helpful, should verify; low = best-effort suggestion"),
+            }))
+                .describe("One entry per blocker you addressed. Do not duplicate resolutions already provided by previous sync responses."),
+            newInsights: z
+                .array(z.string())
+                .nullish()
+                .describe("Cross-cutting insights from reviewing all reports together (e.g., conflicting approaches, shared dependencies, collaboration opportunities)"),
+            followUpNeeded: z
+                .boolean()
+                .describe("true only if unresolved critical blockers remain or your resolution requires confirmation from the other navigator"),
+        }, async (args) => {
+            try {
+                const cleaned = stripNulls(args);
+                const sync = SyncResponseSchema.parse(cleaned);
+                capturedSync = sync;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: true,
+                                message: `Sync response submitted with ${sync.blockerResolutions.length} blocker resolution(s).`,
+                                sync,
+                            }),
+                        },
+                    ],
+                    isError: false,
+                };
+            }
+            catch (error) {
+                if (DEBUG) {
+                    console.error(`[debug] submit_sync_response handler error:`, error);
+                    console.error(`[debug] Raw args:`, JSON.stringify(args, null, 2));
+                }
+                throw error;
+            }
+        }),
+    ];
+    return {
+        tools,
+        getCapturedSync: () => capturedSync,
+        resetCapturedSync: () => {
+            capturedSync = null;
+        },
+    };
+}
+//# sourceMappingURL=standup-protocol.js.map

package/dist/standup/standup-protocol.js.map

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

package/dist/standup/types.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Standup Types
+ *
+ * Core type definitions for the multi-navigator stand-up mode
+ * that orchestrates parallel status reports and sequential blocker sync.
+ */
+import { z } from "zod";
+/**
+ * Schema for a blocker reported by a navigator
+ */
+export declare const BlockerSchema: z.ZodObject<{
+    description: z.ZodString;
+    needsFrom: z.ZodOptional<z.ZodString>;
+    severity: z.ZodEnum<["critical", "moderate", "minor"]>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    severity: "critical" | "moderate" | "minor";
+    needsFrom?: string | undefined;
+}, {
+    description: string;
+    severity: "critical" | "moderate" | "minor";
+    needsFrom?: string | undefined;
+}>;
+export type Blocker = z.infer<typeof BlockerSchema>;
+/**
+ * Schema for a status report submitted by a navigator during the report phase
+ */
+export declare const StatusReportSchema: z.ZodObject<{
+    navigatorName: z.ZodString;
+    currentFocus: z.ZodString;
+    recentProgress: z.ZodArray<z.ZodString, "many">;
+    blockers: z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        needsFrom: z.ZodOptional<z.ZodString>;
+        severity: z.ZodEnum<["critical", "moderate", "minor"]>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        severity: "critical" | "moderate" | "minor";
+        needsFrom?: string | undefined;
+    }, {
+        description: string;
+        severity: "critical" | "moderate" | "minor";
+        needsFrom?: string | undefined;
+    }>, "many">;
+    canHelpWith: z.ZodArray<z.ZodString, "many">;
+    knowledgeGaps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    navigatorName: string;
+    currentFocus: string;
+    recentProgress: string[];
+    blockers: {
+        description: string;
+        severity: "critical" | "moderate" | "minor";
+        needsFrom?: string | undefined;
+    }[];
+    canHelpWith: string[];
+    knowledgeGaps?: string[] | undefined;
+}, {
+    navigatorName: string;
+    currentFocus: string;
+    recentProgress: string[];
+    blockers: {
+        description: string;
+        severity: "critical" | "moderate" | "minor";
+        needsFrom?: string | undefined;
+    }[];
+    canHelpWith: string[];
+    knowledgeGaps?: string[] | undefined;
+}>;
+export type StatusReport = z.infer<typeof StatusReportSchema>;
+/**
+ * Schema for a blocker resolution provided during the sync phase
+ */
+export declare const BlockerResolutionSchema: z.ZodObject<{
+    navigatorName: z.ZodString;
+    blockerDescription: z.ZodString;
+    resolution: z.ZodString;
+    artifactPath: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodEnum<["high", "medium", "low"]>;
+}, "strip", z.ZodTypeAny, {
+    navigatorName: string;
+    blockerDescription: string;
+    resolution: string;
+    confidence: "high" | "medium" | "low";
+    artifactPath?: string | undefined;
+}, {
+    navigatorName: string;
+    blockerDescription: string;
+    resolution: string;
+    confidence: "high" | "medium" | "low";
+    artifactPath?: string | undefined;
+}>;
+export type BlockerResolution = z.infer<typeof BlockerResolutionSchema>;
+/**
+ * Schema for a sync response submitted by a navigator during the sync phase
+ */
+export declare const SyncResponseSchema: z.ZodObject<{
+    navigatorName: z.ZodString;
+    summary: z.ZodString;
+    blockerResolutions: z.ZodArray<z.ZodObject<{
+        navigatorName: z.ZodString;
+        blockerDescription: z.ZodString;
+        resolution: z.ZodString;
+        artifactPath: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodEnum<["high", "medium", "low"]>;
+    }, "strip", z.ZodTypeAny, {
+        navigatorName: string;
+        blockerDescription: string;
+        resolution: string;
+        confidence: "high" | "medium" | "low";
+        artifactPath?: string | undefined;
+    }, {
+        navigatorName: string;
+        blockerDescription: string;
+        resolution: string;
+        confidence: "high" | "medium" | "low";
+        artifactPath?: string | undefined;
+    }>, "many">;
+    newInsights: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    followUpNeeded: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    navigatorName: string;
+    summary: string;
+    blockerResolutions: {
+        navigatorName: string;
+        blockerDescription: string;
+        resolution: string;
+        confidence: "high" | "medium" | "low";
+        artifactPath?: string | undefined;
+    }[];
+    followUpNeeded: boolean;
+    newInsights?: string[] | undefined;
+}, {
+    navigatorName: string;
+    summary: string;
+    blockerResolutions: {
+        navigatorName: string;
+        blockerDescription: string;
+        resolution: string;
+        confidence: "high" | "medium" | "low";
+        artifactPath?: string | undefined;
+    }[];
+    followUpNeeded: boolean;
+    newInsights?: string[] | undefined;
+}>;
+export type SyncResponse = z.infer<typeof SyncResponseSchema>;
+/**
+ * Command line options for standup command
+ */
+export interface StandupOptions {
+    /** Global config directory override */
+    configDir?: string;
+    /** Show detailed logging */
+    verbose?: boolean;
+    /** Model for agents */
+    model?: string;
+    /** Max turns per agent */
+    maxTurns?: number;
+    /** Skip sync phase, only generate reports */
+    reportOnly?: boolean;
+    /** Max cost per agent in USD */
+    maxBudgetUsd?: number;
+}
+/**
+ * Final result of standup execution
+ */
+export interface StandupResult {
+    /** Whether the standup completed successfully */
+    success: boolean;
+    /** Path to the standup output directory */
+    standupDir: string;
+    /** Status reports from each navigator */
+    reports: StatusReport[];
+    /** Sync responses from each navigator */
+    syncResponses: SyncResponse[];
+    /** Total duration in milliseconds */
+    durationMs: number;
+    /** Total cost in USD across all agents */
+    totalCostUsd: number;
+    /** Context utilization percentage per navigator name */
+    contextUtilization: Record<string, number>;
+    /** Any errors that occurred */
+    errors?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/standup/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/standup/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;EAOxB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;EAalC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IAEjB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IAEnB,yCAAyC;IACzC,OAAO,EAAE,YAAY,EAAE,CAAC;IAExB,yCAAyC;IACzC,aAAa,EAAE,YAAY,EAAE,CAAC;IAE9B,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IAEnB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IAErB,wDAAwD;IACxD,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE3C,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}