myshell-tools 1.0.0 → 2.0.0

package/dist/core/orchestrate.js

@@ -0,0 +1,439 @@
+/**
+ * src/core/orchestrate.ts — the bounded escalation + review loop.
+ *
+ * Implements the Phase-2 multi-tier loop:
+ *   classify → route → run IC → (optionally) cross-vendor review → assess →
+ *   escalate/retry/accept → final
+ *
+ * Control-flow overview:
+ *   1. Classify the task.
+ *   2. If no providers → notice(error) + final(false); return.
+ *   3. Append user session entry once.
+ *   4. Loop (≤ maxAttempts):
+ *      a. Route to provider+model for currentTier.
+ *      b. Yield tier-start → stream provider events → yield tier-done.
+ *      c. Provider failure → escalate to manager (or break if already there).
+ *      d. If IC tier + shouldReview(classification, assessment):
+ *         run cross-vendor reviewer at manager tier.
+ *         approve → accept; revise → retry IC with notes; escalate → escalate tier.
+ *      e. Low-confidence / escalate signal → nextTierUp → continue.
+ *      f. All good → yield final(success:true); return.
+ *   5. Loop exhausted or broke on failure → yield final(success:false).
+ *
+ * Purity rules (enforced by test/arch/guards.test.ts):
+ *  - No imports of fs / path / child_process
+ *  - No console.* calls
+ *  - No Date.now() / Math.random() / new Date() — use deps.clock
+ *  - No process.exit() — only src/cli.ts may terminate the process
+ */
+import { classify } from './classify.js';
+import { route } from './route.js';
+import { buildPrompt } from './prompt.js';
+import { assess } from './assess.js';
+import { getModelPricing, calculateCost } from '../infra/pricing.js';
+import { nextTierUp, pickReviewer } from './escalate.js';
+import { buildReviewPrompt, parseReviewVerdict } from './review.js';
+// ---------------------------------------------------------------------------
+// Pure helper: should this IC output be cross-vendor reviewed?
+// ---------------------------------------------------------------------------
+function shouldReview(classification, assessment) {
+    return (classification.risk === 'high' ||
+        classification.risk === 'critical' ||
+        assessment.needsReview === true);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Orchestrate a task through the bounded escalation + review loop.
+ *
+ * Yields a sequence of {@link CoreEvent} objects.
+ * The interface/render layer drives the generator and surfaces events to
+ * the user.
+ *
+ * @param task   - The raw user task description.
+ * @param deps   - Injected dependencies (providers, clock, session, ledger, policy, …).
+ * @param signal - AbortSignal; when aborted the generator stops and yields a
+ *                 notice(warn, 'cancelled') followed by final(success:false).
+ */
+export async function* orchestrate(task, deps, signal) {
+    // -------------------------------------------------------------------------
+    // (a) Classify the task
+    // -------------------------------------------------------------------------
+    const classification = classify(task);
+    yield { type: 'classified', classification };
+    // -------------------------------------------------------------------------
+    // (b) Resolve available providers
+    // -------------------------------------------------------------------------
+    const available = Object.keys(deps.providers).filter((id) => deps.providers[id] !== undefined);
+    // -------------------------------------------------------------------------
+    // (c) No providers path
+    // -------------------------------------------------------------------------
+    if (available.length === 0) {
+        yield {
+            type: 'notice',
+            level: 'error',
+            message: 'No providers are available. Install and authenticate at least one provider ' +
+                '(claude or codex) and try again.',
+        };
+        yield {
+            type: 'final',
+            success: false,
+            output: 'No providers available.',
+            tier: classification.tier,
+            totalCostUsd: 0,
+            sessionId: deps.session.id,
+            attempts: 0,
+        };
+        return;
+    }
+    // -------------------------------------------------------------------------
+    // (d) Append user message to session once (before any tier run)
+    // -------------------------------------------------------------------------
+    await deps.session.append({
+        timestamp: deps.clock.isoNow(),
+        role: 'user',
+        content: task,
+    });
+    // -------------------------------------------------------------------------
+    // (e) Loop state
+    // -------------------------------------------------------------------------
+    let currentTier = classification.tier;
+    let managerNotes;
+    let attempts = 0;
+    let totalCostUsd = 0;
+    let lastOutput = '';
+    // -------------------------------------------------------------------------
+    // (f) Main orchestration loop
+    // -------------------------------------------------------------------------
+    mainLoop: while (attempts < deps.policy.maxAttempts) {
+        attempts++;
+        // --- Route for current tier ---
+        const decision = route(currentTier, available, deps.policy);
+        const provider = deps.providers[decision.provider];
+        if (provider === undefined) {
+            yield {
+                type: 'notice',
+                level: 'error',
+                message: `Provider "${decision.provider}" was selected by route() but is not present in deps.providers.`,
+            };
+            break mainLoop;
+        }
+        // --- Build prompt (with optional reviewer feedback on IC retry) ---
+        const prompt = currentTier === 'ic' && managerNotes !== undefined
+            ? buildPrompt(currentTier, task, managerNotes)
+            : buildPrompt(currentTier, task);
+        // --- Yield tier-start ---
+        yield {
+            type: 'tier-start',
+            tier: decision.tier,
+            provider: decision.provider,
+            model: decision.model,
+            attempt: attempts,
+        };
+        // --- Build request and record start time ---
+        const req = {
+            model: decision.model,
+            prompt,
+            cwd: deps.cwd,
+            sandbox: deps.sandbox,
+            timeoutMs: deps.timeoutMs,
+        };
+        const start = deps.clock.now();
+        let finalText;
+        let errored;
+        let usage;
+        let providerCostUsd;
+        // Check abort before entering the stream
+        if (signal.aborted) {
+            yield { type: 'notice', level: 'warn', message: 'cancelled' };
+            yield {
+                type: 'final',
+                success: false,
+                output: 'Task was cancelled before it started.',
+                tier: decision.tier,
+                totalCostUsd,
+                sessionId: deps.session.id,
+                attempts,
+            };
+            return;
+        }
+        // --- Stream provider events ---
+        for await (const ev of provider.run(req, signal)) {
+            yield { type: 'provider-event', tier: decision.tier, event: ev };
+            if (ev.type === 'done') {
+                finalText = ev.text;
+                if (ev.usage !== undefined && usage === undefined) {
+                    usage = ev.usage;
+                }
+                if (ev.costUsd !== undefined) {
+                    providerCostUsd = ev.costUsd;
+                }
+            }
+            else if (ev.type === 'error') {
+                errored = ev.error;
+            }
+            else if (ev.type === 'usage' && usage === undefined) {
+                usage = ev.usage;
+            }
+            if (signal.aborted) {
+                yield { type: 'notice', level: 'warn', message: 'cancelled' };
+                yield {
+                    type: 'final',
+                    success: false,
+                    output: 'Task was cancelled.',
+                    tier: decision.tier,
+                    totalCostUsd,
+                    sessionId: deps.session.id,
+                    attempts,
+                };
+                return;
+            }
+        }
+        // --- Compute duration + cost ---
+        const durationMs = deps.clock.now() - start;
+        const success = errored == null;
+        const pricing = getModelPricing(decision.provider, decision.model);
+        const usd = providerCostUsd ??
+            (usage !== undefined && pricing !== undefined
+                ? calculateCost(usage.inputTokens, usage.outputTokens, pricing)
+                : 0);
+        totalCostUsd += usd;
+        // --- Assess output ---
+        const assessment = assess(finalText ?? '');
+        // --- Record in ledger ---
+        await deps.ledger.record({
+            timestamp: deps.clock.isoNow(),
+            sessionId: deps.session.id,
+            taskId: deps.clock.uuid(),
+            provider: decision.provider,
+            model: decision.model,
+            tier: decision.tier,
+            inputTokens: usage?.inputTokens ?? 0,
+            outputTokens: usage?.outputTokens ?? 0,
+            cachedInputTokens: usage?.cachedInputTokens ?? 0,
+            usd,
+            durationMs,
+            success,
+        });
+        // --- Append assistant session entry ---
+        await deps.session.append({
+            timestamp: deps.clock.isoNow(),
+            role: 'assistant',
+            content: finalText ?? (errored?.message ?? ''),
+            tier: decision.tier,
+            provider: decision.provider,
+            model: decision.model,
+            confidence: assessment.confidence,
+            costUsd: usd,
+            durationMs,
+        });
+        // --- Yield tier-done ---
+        yield {
+            type: 'tier-done',
+            tier: decision.tier,
+            success,
+            confidence: assessment.confidence,
+            costUsd: usd,
+            durationMs,
+        };
+        lastOutput = finalText ?? (errored?.message ?? '');
+        // -----------------------------------------------------------------------
+        // Decision tree
+        // -----------------------------------------------------------------------
+        // 1) Provider failure → escalate to manager (or fail if already there)
+        if (!success) {
+            if (currentTier !== 'manager') {
+                yield { type: 'escalate', from: currentTier, to: 'manager', reason: 'execution failure' };
+                currentTier = 'manager';
+                continue mainLoop;
+            }
+            else {
+                break mainLoop; // already at manager; emit failing final below
+            }
+        }
+        // 2) Cross-vendor review for IC work on high/critical risk or needsReview
+        if (currentTier === 'ic' && shouldReview(classification, assessment)) {
+            const reviewerId = pickReviewer(available, decision.provider);
+            const reviewerProvider = reviewerId === null ? undefined : deps.providers[reviewerId];
+            if (reviewerId !== null && reviewerProvider !== undefined) {
+                const sameVendor = reviewerId === decision.provider;
+                yield {
+                    type: 'notice',
+                    level: 'info',
+                    message: `Review by ${reviewerId} (${sameVendor ? 'same vendor' : 'cross-vendor'})`,
+                };
+                // Route reviewer at manager tier
+                const reviewDecision = route('manager', [reviewerId], deps.policy);
+                const reviewPrompt = buildReviewPrompt(task, lastOutput);
+                // Yield tier-start for review run
+                yield {
+                    type: 'tier-start',
+                    tier: 'manager',
+                    provider: reviewerId,
+                    model: reviewDecision.model,
+                    attempt: attempts,
+                };
+                const reviewReq = {
+                    model: reviewDecision.model,
+                    prompt: reviewPrompt,
+                    cwd: deps.cwd,
+                    sandbox: deps.sandbox,
+                    timeoutMs: deps.timeoutMs,
+                };
+                const reviewStart = deps.clock.now();
+                let reviewText;
+                let reviewErrored;
+                let reviewUsage;
+                let reviewProviderCostUsd;
+                // Check abort before reviewer streaming
+                if (signal.aborted) {
+                    yield { type: 'notice', level: 'warn', message: 'cancelled' };
+                    yield {
+                        type: 'final',
+                        success: false,
+                        output: 'Task was cancelled.',
+                        tier: currentTier,
+                        totalCostUsd,
+                        sessionId: deps.session.id,
+                        attempts,
+                    };
+                    return;
+                }
+                for await (const rev of reviewerProvider.run(reviewReq, signal)) {
+                    yield { type: 'provider-event', tier: 'manager', event: rev };
+                    if (rev.type === 'done') {
+                        reviewText = rev.text;
+                        if (rev.usage !== undefined && reviewUsage === undefined) {
+                            reviewUsage = rev.usage;
+                        }
+                        if (rev.costUsd !== undefined) {
+                            reviewProviderCostUsd = rev.costUsd;
+                        }
+                    }
+                    else if (rev.type === 'error') {
+                        reviewErrored = rev.error;
+                    }
+                    else if (rev.type === 'usage' && reviewUsage === undefined) {
+                        reviewUsage = rev.usage;
+                    }
+                    if (signal.aborted) {
+                        yield { type: 'notice', level: 'warn', message: 'cancelled' };
+                        yield {
+                            type: 'final',
+                            success: false,
+                            output: 'Task was cancelled.',
+                            tier: currentTier,
+                            totalCostUsd,
+                            sessionId: deps.session.id,
+                            attempts,
+                        };
+                        return;
+                    }
+                }
+                const reviewDurationMs = deps.clock.now() - reviewStart;
+                const reviewSuccess = reviewErrored == null;
+                const reviewPricing = getModelPricing(reviewerId, reviewDecision.model);
+                const reviewUsd = reviewProviderCostUsd ??
+                    (reviewUsage !== undefined && reviewPricing !== undefined
+                        ? calculateCost(reviewUsage.inputTokens, reviewUsage.outputTokens, reviewPricing)
+                        : 0);
+                totalCostUsd += reviewUsd;
+                // Record reviewer run in ledger
+                await deps.ledger.record({
+                    timestamp: deps.clock.isoNow(),
+                    sessionId: deps.session.id,
+                    taskId: deps.clock.uuid(),
+                    provider: reviewerId,
+                    model: reviewDecision.model,
+                    tier: 'manager',
+                    inputTokens: reviewUsage?.inputTokens ?? 0,
+                    outputTokens: reviewUsage?.outputTokens ?? 0,
+                    cachedInputTokens: reviewUsage?.cachedInputTokens ?? 0,
+                    usd: reviewUsd,
+                    durationMs: reviewDurationMs,
+                    success: reviewSuccess,
+                });
+                // Yield tier-done for reviewer
+                yield {
+                    type: 'tier-done',
+                    tier: 'manager',
+                    success: reviewSuccess,
+                    confidence: null,
+                    costUsd: reviewUsd,
+                    durationMs: reviewDurationMs,
+                };
+                // Parse verdict and act on it
+                const verdict = parseReviewVerdict(reviewText ?? '');
+                yield {
+                    type: 'notice',
+                    level: 'info',
+                    message: `Review verdict: ${verdict.verdict}`,
+                };
+                if (verdict.verdict === 'approve') {
+                    yield {
+                        type: 'final',
+                        success: true,
+                        output: lastOutput,
+                        tier: currentTier,
+                        totalCostUsd,
+                        sessionId: deps.session.id,
+                        attempts,
+                    };
+                    return;
+                }
+                if (verdict.verdict === 'revise') {
+                    // Retry IC with reviewer's notes; managerNotes is cleared after use
+                    managerNotes = verdict.notes;
+                    // Stay at 'ic' tier; loop continues
+                    continue mainLoop;
+                }
+                // verdict === 'escalate'
+                yield { type: 'escalate', from: 'ic', to: 'manager', reason: 'reviewer escalation' };
+                currentTier = 'manager';
+                continue mainLoop;
+            }
+        }
+        // 3) Confidence-based escalation
+        const threshold = deps.policy.escalateBelowConfidence[classification.risk];
+        const needEsc = assessment.escalate ||
+            (assessment.confidence !== null && assessment.confidence < threshold);
+        const nextTier = nextTierUp(currentTier);
+        if (needEsc && nextTier !== null) {
+            const escalateReason = assessment.reason !== 'model provided no reason' &&
+                assessment.reason !== 'no confidence envelope'
+                ? assessment.reason
+                : 'low confidence';
+            yield {
+                type: 'escalate',
+                from: currentTier,
+                to: nextTier,
+                reason: escalateReason,
+            };
+            currentTier = nextTier;
+            continue mainLoop;
+        }
+        // 4) Accept — everything checks out
+        yield {
+            type: 'final',
+            success: true,
+            output: lastOutput,
+            tier: currentTier,
+            totalCostUsd,
+            sessionId: deps.session.id,
+            attempts,
+        };
+        return;
+    }
+    // Loop exhausted or broke out on failure
+    yield {
+        type: 'final',
+        success: false,
+        output: lastOutput,
+        tier: currentTier,
+        totalCostUsd,
+        sessionId: deps.session.id,
+        attempts,
+    };
+}
+//# sourceMappingURL=orchestrate.js.map

package/dist/core/orchestrate.js.map

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

package/dist/core/policy.d.ts

@@ -0,0 +1,9 @@
+/**
+ * src/core/policy.ts — the single source of orchestration thresholds & routing
+ * preferences. All tunable numbers live here (typed by `Policy` in types.ts),
+ * never scattered as magic constants across the core.
+ *
+ * Pure data module: no I/O, no time, no randomness.
+ */
+import type { Policy } from './types.js';
+export declare const DEFAULT_POLICY: Policy;

package/dist/core/policy.js

@@ -0,0 +1,27 @@
+/**
+ * src/core/policy.ts — the single source of orchestration thresholds & routing
+ * preferences. All tunable numbers live here (typed by `Policy` in types.ts),
+ * never scattered as magic constants across the core.
+ *
+ * Pure data module: no I/O, no time, no randomness.
+ */
+export const DEFAULT_POLICY = {
+    maxAttempts: 3,
+    // Higher-risk work demands higher confidence before we accept it; below the
+    // threshold we escalate to a higher tier (or, later, a cross-vendor review).
+    escalateBelowConfidence: {
+        low: 0.4,
+        medium: 0.5,
+        high: 0.7,
+        critical: 0.8,
+    },
+    // Provider preference per tier. route() picks the first available provider in
+    // this order that has a model for the tier; otherwise it falls back to the
+    // cheapest available model for that tier (via pricing.getCheapestForTier).
+    providerOrderByTier: {
+        worker: ['claude', 'codex'],
+        ic: ['claude', 'codex'],
+        manager: ['claude', 'codex'],
+    },
+};
+//# sourceMappingURL=policy.js.map

package/dist/core/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/core/policy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,CAAC,MAAM,cAAc,GAAW;IACpC,WAAW,EAAE,CAAC;IAEd,4EAA4E;IAC5E,6EAA6E;IAC7E,uBAAuB,EAAE;QACvB,GAAG,EAAE,GAAG;QACR,MAAM,EAAE,GAAG;QACX,IAAI,EAAE,GAAG;QACT,QAAQ,EAAE,GAAG;KACd;IAED,8EAA8E;IAC9E,2EAA2E;IAC3E,2EAA2E;IAC3E,mBAAmB,EAAE;QACnB,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,EAAE,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QACvB,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;KAC7B;CACF,CAAC"}

package/dist/core/prompt.d.ts

@@ -0,0 +1,26 @@
+/**
+ * src/core/prompt.ts — typed, tier-specific prompt builders.
+ *
+ * Each tier gets a professional role prompt that instructs the model to perform
+ * real work and end its response with a structured JSON confidence envelope on
+ * its own line. The envelope is the only source of confidence data — no keyword
+ * heuristics, no fabricated numbers.
+ *
+ * Pure module: no I/O, no time, no randomness.
+ */
+import type { Tier } from './types.js';
+/**
+ * Build the full prompt string to deliver to a model for the given tier.
+ *
+ * The system instructions are prepended to the raw task so the model receives
+ * role context before the user request.
+ *
+ * When `managerNotes` is provided (IC retry after a reviewer's `revise` verdict),
+ * the prompt is extended with a REVIEWER FEEDBACK section so the IC can address
+ * the specific feedback on its next attempt.
+ *
+ * @param tier         - The orchestration tier that will handle the task.
+ * @param task         - The raw user task description.
+ * @param managerNotes - Optional feedback from a cross-vendor reviewer to be addressed.
+ */
+export declare function buildPrompt(tier: Tier, task: string, managerNotes?: string): string;

package/dist/core/prompt.js

@@ -0,0 +1,125 @@
+/**
+ * src/core/prompt.ts — typed, tier-specific prompt builders.
+ *
+ * Each tier gets a professional role prompt that instructs the model to perform
+ * real work and end its response with a structured JSON confidence envelope on
+ * its own line. The envelope is the only source of confidence data — no keyword
+ * heuristics, no fabricated numbers.
+ *
+ * Pure module: no I/O, no time, no randomness.
+ */
+// ---------------------------------------------------------------------------
+// Envelope schema (documented here for parser/prompt alignment)
+// ---------------------------------------------------------------------------
+//
+// Every model response MUST end with exactly this JSON object on its own line:
+//
+//   {"confidence": <0.0-1.0>, "escalate": <true|false>, "reason": "<string>", "needs_review": <true|false>}
+//
+// confidence  : float [0,1] — the model's self-assessed probability of correctness
+// escalate    : true  → the model requests a higher-tier pass
+// reason      : brief human-readable justification for the confidence / escalation
+// needs_review: true  → the model recommends cross-provider review
+//
+// The assess() function in assess.ts parses this envelope.  If the envelope is
+// absent or malformed, confidence is recorded as null (never fabricated).
+// ---------------------------------------------------------------------------
+// Tier role prompts
+// ---------------------------------------------------------------------------
+const WORKER_SYSTEM = `\
+You are a precise, efficient worker-tier assistant. Your role is to perform
+well-scoped, read-oriented tasks: searching codebases, listing files, looking up
+definitions, reading documentation, and answering factual questions about the
+current project.
+
+Guidelines:
+- Be concise and direct. Do not pad responses with unnecessary explanation.
+- Quote exact file paths, line numbers, and symbols when they are available.
+- If the task requires writing or modifying files, note that explicitly and
+  recommend escalating to an IC-tier run.
+- Do not speculate beyond what is directly observable in the project.
+
+After completing the task, append EXACTLY the following JSON object on its own
+line at the very end of your response (no trailing text after it):
+{"confidence": <0.0-1.0>, "escalate": <true|false>, "reason": "<one sentence>", "needs_review": <true|false>}
+
+Set confidence to your honest estimate of correctness (1.0 = certain, 0.0 = no
+idea). Set escalate to true if the task requires a higher-tier model. Set
+needs_review to true if you are uncertain and an independent check would help.`;
+const IC_SYSTEM = `\
+You are a skilled individual-contributor (IC) engineer. Your role is to
+implement, refactor, debug, and explain code. You work directly in the project's
+file tree, make targeted edits, run available tools, and produce clean,
+well-reasoned output.
+
+Guidelines:
+- Read the relevant files before making changes.
+- Make the smallest correct change that satisfies the task; avoid scope creep.
+- If you modify files, describe each change with file path, what changed, and why.
+- If you run commands (tests, builds), report the exact output.
+- If the task involves high-stakes areas (auth, secrets, payments, deployments),
+  err on the side of caution and set needs_review to true.
+
+After completing the task, append EXACTLY the following JSON object on its own
+line at the very end of your response (no trailing text after it):
+{"confidence": <0.0-1.0>, "escalate": <true|false>, "reason": "<one sentence>", "needs_review": <true|false>}
+
+Set confidence to your honest estimate of correctness (1.0 = certain, 0.0 = no
+idea). Set escalate to true if the task is beyond IC scope (e.g. requires
+cross-cutting architectural decisions). Set needs_review to true if an
+independent reviewer would meaningfully reduce risk.`;
+const MANAGER_SYSTEM = `\
+You are a senior-manager / staff-engineer-tier reviewer and architect. Your role
+is to evaluate code, plans, and proposals; identify systemic risks; design
+solutions; and produce authoritative recommendations.
+
+Guidelines:
+- Ground every finding in specific, file-anchored evidence (file path + line
+  range). Vague assertions are not acceptable.
+- For security/threat-model reviews, enumerate each threat class, its severity
+  (Critical/High/Medium/Low), and a concrete mitigation.
+- For architectural reviews, identify coupling, missing abstractions, and failure
+  modes — not just style issues.
+- Produce a structured verdict with a clear APPROVE / REQUEST_CHANGES /
+  ESCALATE recommendation.
+- If you identify a critical defect, set escalate to true and explain why
+  immediate attention is required.
+
+After completing the review or plan, append EXACTLY the following JSON object on
+its own line at the very end of your response (no trailing text after it):
+{"confidence": <0.0-1.0>, "escalate": <true|false>, "reason": "<one sentence>", "needs_review": <true|false>}
+
+Set confidence to your honest estimate that your analysis is complete and correct
+(1.0 = certain, 0.0 = severely incomplete). Set escalate to true only if the
+situation warrants immediate human or higher-tier intervention.`;
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Build the full prompt string to deliver to a model for the given tier.
+ *
+ * The system instructions are prepended to the raw task so the model receives
+ * role context before the user request.
+ *
+ * When `managerNotes` is provided (IC retry after a reviewer's `revise` verdict),
+ * the prompt is extended with a REVIEWER FEEDBACK section so the IC can address
+ * the specific feedback on its next attempt.
+ *
+ * @param tier         - The orchestration tier that will handle the task.
+ * @param task         - The raw user task description.
+ * @param managerNotes - Optional feedback from a cross-vendor reviewer to be addressed.
+ */
+export function buildPrompt(tier, task, managerNotes) {
+    const system = TIER_PROMPTS[tier];
+    let prompt = `${system}\n\n---\n\nTask:\n${task}`;
+    if (managerNotes !== undefined && managerNotes.trim().length > 0) {
+        prompt += `\n\nREVIEWER FEEDBACK:\n${managerNotes.trim()}\nAddress this specifically.`;
+    }
+    return prompt;
+}
+const TIER_PROMPTS = {
+    worker: WORKER_SYSTEM,
+    ic: IC_SYSTEM,
+    manager: MANAGER_SYSTEM,
+};
+//# sourceMappingURL=prompt.js.map

package/dist/core/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/core/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,8EAA8E;AAC9E,gEAAgE;AAChE,8EAA8E;AAC9E,EAAE;AACF,+EAA+E;AAC/E,EAAE;AACF,4GAA4G;AAC5G,EAAE;AACF,mFAAmF;AACnF,8DAA8D;AAC9D,mFAAmF;AACnF,mEAAmE;AACnE,EAAE;AACF,+EAA+E;AAC/E,0EAA0E;AAE1E,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;+EAmByD,CAAC;AAEhF,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;qDAqBmC,CAAC;AAEtD,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;gEAuByC,CAAC;AAEjE,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAAC,IAAU,EAAE,IAAY,EAAE,YAAqB;IACzE,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,MAAM,GAAG,GAAG,MAAM,qBAAqB,IAAI,EAAE,CAAC;IAClD,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,2BAA2B,YAAY,CAAC,IAAI,EAAE,8BAA8B,CAAC;IACzF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,YAAY,GAAyB;IACzC,MAAM,EAAE,aAAa;IACrB,EAAE,EAAE,SAAS;IACb,OAAO,EAAE,cAAc;CACxB,CAAC"}