@lsctech/polaris 0.1.0

package/dist/loop/worker-prompt.js

@@ -0,0 +1,260 @@
+"use strict";
+/**
+ * Compact worker prompt builder.
+ *
+ * Generates deterministic, size-bounded prompts for impl worker dispatch.
+ * Replaces ad-hoc string construction in compileImplPacket with a structured
+ * template that omits full issue bodies, repeated doctrine, and architecture
+ * explanations — all of which inflate token cost without aiding implementation.
+ *
+ * Two modes:
+ *   compact (default) — narrow single-repo children; structured template only.
+ *   full             — cross-cutting or architectural children; may include
+ *                      expanded issue context.
+ *
+ * Governance instructions (validation, commit, boundary, reporting) are always
+ * preserved in both modes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNarrowChild = isNarrowChild;
+exports.selectPromptMode = selectPromptMode;
+exports.buildWorkerPrompt = buildWorkerPrompt;
+exports.buildPromptFromPacketInput = buildPromptFromPacketInput;
+// ── Narrow-child heuristics ───────────────────────────────────────────────────
+/**
+ * Labels that mark a child as non-narrow (requires full context).
+ * Checked against open_children_meta[childId].labels.
+ */
+const WIDE_LABELS = new Set([
+    'cross-cutting',
+    'high-risk',
+    'parallel',
+    'worker-isolation',
+    'architectural',
+]);
+/**
+ * Returns true when a child qualifies for compact dispatch.
+ * A child is narrow when it has no wide labels and no explicit full-context flag.
+ */
+function isNarrowChild(childId, state) {
+    const meta = state.open_children_meta?.[childId];
+    if (!meta)
+        return true;
+    const labels = meta.labels ?? [];
+    for (const label of labels) {
+        if (WIDE_LABELS.has(label))
+            return false;
+    }
+    return true;
+}
+/**
+ * Selects the prompt mode for a given child.
+ * - Returns 'compact' for narrow children (default).
+ * - Returns 'full' when forced via override or when child is wide.
+ */
+function selectPromptMode(childId, state, override) {
+    if (override)
+        return override;
+    return isNarrowChild(childId, state) ? 'compact' : 'full';
+}
+// ── Builder ───────────────────────────────────────────────────────────────────
+/**
+ * Build a compact or full worker dispatch prompt.
+ *
+ * The compact template carries only what the worker needs to implement:
+ * identity, location, goal, scope, acceptance criteria, helpers, validation,
+ * and reporting format. It intentionally omits full issue bodies, cluster JSON,
+ * repeated doctrine, and architecture explanations.
+ *
+ * Full mode appends expanded issue context after the compact body.
+ * Governance instructions are always present in both modes.
+ */
+function buildWorkerPrompt(input) {
+    const lines = [];
+    // ── Header ────────────────────────────────────────────────────────────────
+    lines.push(`Issue: ${input.issueId} — ${input.title}`);
+    lines.push(`Worktree: ${input.worktree}`);
+    lines.push(`Branch: ${input.branch}`);
+    lines.push('');
+    // ── Goal ──────────────────────────────────────────────────────────────────
+    lines.push('## Goal');
+    lines.push(input.goal.trim());
+    lines.push('');
+    // ── Scope ─────────────────────────────────────────────────────────────────
+    lines.push('## Scope');
+    if (input.scopeTouch.length > 0) {
+        lines.push('Touch only:');
+        for (const s of input.scopeTouch)
+            lines.push(`- ${s}`);
+    }
+    if (input.scopeAvoid.length > 0) {
+        lines.push('Do not touch:');
+        for (const s of input.scopeAvoid)
+            lines.push(`- ${s}`);
+    }
+    lines.push('');
+    // ── Acceptance Criteria ───────────────────────────────────────────────────
+    lines.push('## Acceptance Criteria');
+    for (const ac of input.acceptanceCriteria)
+        lines.push(`- ${ac}`);
+    lines.push('');
+    // ── Existing Helpers ──────────────────────────────────────────────────────
+    if (input.existingHelpers.length > 0) {
+        lines.push('## Existing Helpers');
+        for (const h of input.existingHelpers)
+            lines.push(`- ${h}`);
+        lines.push('');
+    }
+    // ── Validation ────────────────────────────────────────────────────────────
+    lines.push('## Validation');
+    for (const cmd of input.validationCommands)
+        lines.push(`- ${cmd}`);
+    lines.push('');
+    // ── Commit ────────────────────────────────────────────────────────────────
+    lines.push('## Commit');
+    lines.push(input.commitFormat);
+    lines.push('');
+    // ── State + telemetry (governance — always present) ───────────────────────
+    lines.push('## Governance');
+    lines.push(`- Do NOT modify open_children or completed_children in ${input.stateFile}. The parent runtime (loop continue) owns state transitions.`);
+    lines.push(`- Append a telemetry event to ${input.telemetryFile}.`);
+    lines.push('');
+    // ── Worker Heartbeat Telemetry (observability — always present) ────────────
+    lines.push('## Worker Progress Telemetry (MANDATORY)');
+    lines.push('The parent CANNOT see your work. You MUST emit heartbeat events so the parent knows you are alive and making progress.');
+    lines.push('');
+    lines.push(`After EVERY step, append a JSONL event to ${input.telemetryFile}:`);
+    lines.push('```jsonl');
+    lines.push(`{"event":"worker-heartbeat","run_id":"<from packet>","child_id":"${input.issueId}","step_cursor":"<current step>","timestamp":"<ISO8601>","progress_pct":<0-100>,"files_changed":<count>,"current_file":"<file being edited>"}`);
+    lines.push('```');
+    lines.push('');
+    lines.push('Required heartbeat points:');
+    lines.push('  1. Immediately after reading this packet (step_cursor: "start")');
+    lines.push('  2. After verifying state file (step_cursor: "verify")');
+    lines.push('  3. After EACH file edit (step_cursor: "implement")');
+    lines.push('  4. After running validation (step_cursor: "validate")');
+    lines.push('  5. After creating commit (step_cursor: "commit")');
+    lines.push('  6. Before terminating (step_cursor: "complete" or "failed")');
+    lines.push('');
+    lines.push('If heartbeats stop, the parent will assume you crashed and may dispatch a replacement worker.');
+    lines.push('');
+    // ── Approval Escalation Telemetry ───────────────────────────────────────────
+    lines.push('## Approval Escalation (when uncertain)');
+    lines.push('You have a sealed packet defining your exact scope, allowed files, and validation commands. Use this to decide:');
+    lines.push('');
+    lines.push('Rule 1 - Auto-approve WITHIN scope (normal work):');
+    lines.push('  - If the operation touches files within `instructions.allowed_scope` → Just do it');
+    lines.push('  - If the command is in `instructions.validation_commands` → Just run it');
+    lines.push('  - Low risk, expected work → No need to ask, emit heartbeat with step_cursor: "implement"');
+    lines.push('');
+    lines.push('Rule 2 - ESCALATE out-of-scope or high-risk:');
+    lines.push('  - File outside allowed_scope → Emit worker-blocked with approval_type: "out-of-scope"');
+    lines.push('  - Destructive operation (rm -rf, major refactor) → Emit worker-blocked with approval_type: "destructive"');
+    lines.push('  - External API calls with cost → Emit worker-blocked with approval_type: "cost"');
+    lines.push('  - Changing secrets/.env → Emit worker-blocked with approval_type: "security"');
+    lines.push('  - Unclear requirements → Emit worker-blocked with approval_type: "ambiguous"');
+    lines.push('');
+    lines.push('To escalate, emit IMMEDIATELY to telemetry:');
+    lines.push('```jsonl');
+    lines.push(`{"event":"worker-blocked","run_id":"<from packet>","child_id":"${input.issueId}","reason":"needs-approval","approval_type":"<out-of-scope|destructive|cost|security|ambiguous>","description":"<specifically what needs approval>","blocker_id":"<unique-id>","timestamp":"<ISO8601>"}`);
+    lines.push('```');
+    lines.push('');
+    lines.push('Then: Continue heartbeats every 30s with step_cursor: "blocked-awaiting-approval"');
+    lines.push('Wait for parent response. If no response in 5 minutes → TERMINATE with approval-timeout.');
+    lines.push('');
+    lines.push('Remember: Your packet scope is your authority. Within scope = proceed. Outside scope = escalate.');
+    lines.push('');
+    // ── Route cognition delta (always present) ────────────────────────────────
+    lines.push('## Route Cognition Delta');
+    lines.push('After implementation, apply route-local cognition delta — only if something materially changed.');
+    lines.push('');
+    lines.push('**POLARIS.md** — update only when ALL of the following are true:');
+    lines.push('  - You touched a file in that folder (not a distant folder).');
+    lines.push('  - The change materially affects: folder responsibilities, commands/workflows,');
+    lines.push('    execution constraints, ownership/routing, or operational behavior.');
+    lines.push('  - The current POLARIS.md content is actually wrong or incomplete as a result.');
+    lines.push('  DO NOT update POLARIS.md for: formatting fixes, comment changes, tiny refactors,');
+    lines.push('  internal implementation details, or any change that leaves the operational guidance');
+    lines.push('  still accurate. When in doubt, do not update.');
+    lines.push('');
+    lines.push('**SUMMARY.md** — update only when: linked docs/specs changed, canon relationships');
+    lines.push('  changed, architecture meaning changed, or doctrine/spec linkage changed.');
+    lines.push('  SUMMARY.md is informational only. Do not create it if missing — that is a hint for');
+    lines.push('  operators, not a task for workers. Keep it short. Never add operational doctrine.');
+    lines.push('');
+    lines.push('**Never** scan unrelated folders. **Never** regenerate all route docs.');
+    lines.push('If no material change occurred, skip this section entirely.');
+    lines.push('');
+    // ── Report Back ───────────────────────────────────────────────────────────
+    lines.push('## Report Back');
+    lines.push('- files changed');
+    lines.push('- validation results');
+    lines.push('- commit hash');
+    lines.push('- blockers');
+    lines.push('');
+    // ── Termination (governance — always present) ─────────────────────────────
+    lines.push('TERMINATE SESSION IMMEDIATELY. Do not select or execute the next child.');
+    // ── Full mode: append expanded context ───────────────────────────────────
+    if (input.mode === 'full' && input.issueContext) {
+        lines.push('');
+        lines.push('---');
+        lines.push('');
+        lines.push('## Expanded Issue Context');
+        lines.push(`**${input.issueContext.id}**: ${input.issueContext.title}`);
+        if (input.issueContext.body) {
+            lines.push('');
+            lines.push(input.issueContext.body);
+        }
+        if (input.issueContext.key_requirements.length > 0) {
+            lines.push('');
+            lines.push('Key requirements:');
+            for (const [i, r] of input.issueContext.key_requirements.entries()) {
+                lines.push(`${i + 1}. ${r}`);
+            }
+        }
+    }
+    const prompt = lines.join('\n');
+    const charCount = prompt.length;
+    return {
+        prompt,
+        metrics: {
+            mode: input.mode,
+            char_count: charCount,
+            estimated_tokens: Math.round(charCount / 4),
+        },
+    };
+}
+/**
+ * Build a worker prompt from the same inputs used by compileImplPacket.
+ * Derives goal, scope, acceptance criteria, and helpers from issue context.
+ */
+function buildPromptFromPacketInput(input) {
+    const requirements = input.issueContext?.key_requirements ?? [];
+    const body = input.issueContext?.body?.trim();
+    // Body is the canonical goal text — it is the full issue description written by the
+    // product team. Use it verbatim so the worker acts on the real spec, not a title stub.
+    // Fall back to first requirement, then to a minimal "Implement X" placeholder.
+    const goal = body
+        ?? (requirements.length > 0 ? requirements[0] : `Implement ${input.issueId}: "${input.title}".`);
+    return buildWorkerPrompt({
+        issueId: input.issueId,
+        title: input.title,
+        worktree: input.worktree,
+        branch: input.branch,
+        goal,
+        scopeTouch: input.allowedScope ?? [],
+        scopeAvoid: [],
+        // When body is the goal, all requirements are acceptance criteria (none was consumed as goal).
+        // When requirements[0] is the goal, the rest (slice(1)) are acceptance criteria.
+        acceptanceCriteria: body
+            ? requirements
+            : (requirements.length > 1 ? requirements.slice(1) : requirements),
+        existingHelpers: [],
+        validationCommands: input.validationCommands ?? [],
+        commitFormat: `[${input.issueId}] ${input.title}`,
+        stateFile: input.stateFile,
+        telemetryFile: input.telemetryFile,
+        issueContext: input.issueContext,
+        mode: input.mode,
+    });
+}

package/dist/loop/worker-prompt.test.js

@@ -0,0 +1,247 @@
+"use strict";
+/**
+ * Tests for src/loop/worker-prompt.ts
+ *
+ * Covers:
+ * - compact prompt generation (structure, required sections, governance)
+ * - full mode: expanded issue context appended
+ * - narrow-child detection via labels
+ * - prompt mode selection
+ * - oversized requirement compression (many requirements still produce one prompt)
+ * - prompt metrics accuracy
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const worker_prompt_js_1 = require("./worker-prompt.js");
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function makeState(labels = []) {
+    return {
+        schema_version: "1.0",
+        run_id: "test-run",
+        cluster_id: "POL-130",
+        skill: "polaris-run",
+        artifact_dir: ".taskchain_artifacts/polaris-run",
+        branch: "feat/test",
+        current_step_id: "03-select-child",
+        step_cursor: "dispatching",
+        status: "running",
+        session_type: "implementation",
+        active_child: "POL-131",
+        last_commit: "",
+        pr_url: "",
+        next_open_child: "POL-131",
+        completed_children: [],
+        open_children: ["POL-131"],
+        open_children_meta: {
+            "POL-131": {
+                title: "IMPLEMENT: Add .smartdocignore parser",
+                state: "Backlog",
+                status_type: "backlog",
+                blocked_by: [],
+                labels,
+            },
+        },
+        context_budget: { children_completed: 0, files_touched_total: 0, last_child_files_touched: 0 },
+        validation_status: "not-run",
+        updated_at: new Date().toISOString(),
+        blocker: null,
+    };
+}
+function makeBaseInput(overrides = {}) {
+    return {
+        issueId: "POL-131",
+        title: "Add .smartdocignore parser",
+        worktree: "/repo",
+        branch: "feat/test",
+        goal: "Parse .smartdocignore and enforce it during docs ingest.",
+        scopeTouch: ["src/smartdocs-engine/ingest.ts", "src/smartdocs-engine/ignore-parser.ts"],
+        scopeAvoid: ["src/loop/", "src/finalize/"],
+        acceptanceCriteria: [
+            "Parser reads .smartdocignore from repo root",
+            "Ignored paths are skipped during ingest",
+        ],
+        existingHelpers: ["src/utils/glob.ts — glob matching utilities"],
+        validationCommands: ["npm run build", "npm test"],
+        commitFormat: "[POL-131] Add .smartdocignore parser",
+        stateFile: ".taskchain_artifacts/polaris-run/current-state.json",
+        telemetryFile: ".taskchain_artifacts/polaris-run/runs/test/telemetry.jsonl",
+        mode: "compact",
+        ...overrides,
+    };
+}
+// ── Tests ─────────────────────────────────────────────────────────────────────
+(0, vitest_1.describe)("buildWorkerPrompt", () => {
+    (0, vitest_1.it)("compact prompt contains required header fields", () => {
+        const { prompt } = (0, worker_prompt_js_1.buildWorkerPrompt)(makeBaseInput());
+        (0, vitest_1.expect)(prompt).toContain("Issue: POL-131 — Add .smartdocignore parser");
+        (0, vitest_1.expect)(prompt).toContain("Worktree: /repo");
+        (0, vitest_1.expect)(prompt).toContain("Branch: feat/test");
+    });
+    (0, vitest_1.it)("compact prompt contains all required sections", () => {
+        const { prompt } = (0, worker_prompt_js_1.buildWorkerPrompt)(makeBaseInput());
+        (0, vitest_1.expect)(prompt).toContain("## Goal");
+        (0, vitest_1.expect)(prompt).toContain("## Scope");
+        (0, vitest_1.expect)(prompt).toContain("## Acceptance Criteria");
+        (0, vitest_1.expect)(prompt).toContain("## Existing Helpers");
+        (0, vitest_1.expect)(prompt).toContain("## Validation");
+        (0, vitest_1.expect)(prompt).toContain("## Commit");
+        (0, vitest_1.expect)(prompt).toContain("## Governance");
+        (0, vitest_1.expect)(prompt).toContain("## Report Back");
+    });
+    (0, vitest_1.it)("compact prompt contains governance instructions", () => {
+        const { prompt } = (0, worker_prompt_js_1.buildWorkerPrompt)(makeBaseInput());
+        (0, vitest_1.expect)(prompt).toContain("open_children to completed_children");
+        (0, vitest_1.expect)(prompt).toContain("telemetry.jsonl");
+        (0, vitest_1.expect)(prompt).toContain("TERMINATE SESSION IMMEDIATELY");
+    });
+    (0, vitest_1.it)("compact prompt contains report back fields", () => {
+        const { prompt } = (0, worker_prompt_js_1.buildWorkerPrompt)(makeBaseInput());
+        (0, vitest_1.expect)(prompt).toContain("files changed");
+        (0, vitest_1.expect)(prompt).toContain("validation results");
+        (0, vitest_1.expect)(prompt).toContain("commit hash");
+        (0, vitest_1.expect)(prompt).toContain("blockers");
+    });
+    (0, vitest_1.it)("compact prompt does NOT include expanded issue context section", () => {
+        const { prompt } = (0, worker_prompt_js_1.buildWorkerPrompt)(makeBaseInput());
+        (0, vitest_1.expect)(prompt).not.toContain("## Expanded Issue Context");
+        (0, vitest_1.expect)(prompt).not.toContain("---");
+    });
+    (0, vitest_1.it)("full mode appends expanded issue context", () => {
+        const input = makeBaseInput({
+            mode: "full",
+            issueContext: {
+                id: "POL-131",
+                title: "Add .smartdocignore parser",
+                key_requirements: ["Parse .smartdocignore", "Enforce during ingest"],
+            },
+        });
+        const { prompt } = (0, worker_prompt_js_1.buildWorkerPrompt)(input);
+        (0, vitest_1.expect)(prompt).toContain("## Expanded Issue Context");
+        (0, vitest_1.expect)(prompt).toContain("Parse .smartdocignore");
+        (0, vitest_1.expect)(prompt).toContain("Enforce during ingest");
+    });
+    (0, vitest_1.it)("full mode without issueContext does not append expanded section", () => {
+        const { prompt } = (0, worker_prompt_js_1.buildWorkerPrompt)(makeBaseInput({ mode: "full" }));
+        (0, vitest_1.expect)(prompt).not.toContain("## Expanded Issue Context");
+    });
+    (0, vitest_1.it)("compact prompt is smaller than full prompt with context", () => {
+        const issueContext = {
+            id: "POL-131",
+            title: "Add .smartdocignore parser",
+            key_requirements: Array.from({ length: 10 }, (_, i) => `Requirement ${i + 1}`),
+        };
+        const compact = (0, worker_prompt_js_1.buildWorkerPrompt)(makeBaseInput({ mode: "compact", issueContext }));
+        const full = (0, worker_prompt_js_1.buildWorkerPrompt)(makeBaseInput({ mode: "full", issueContext }));
+        (0, vitest_1.expect)(compact.metrics.char_count).toBeLessThan(full.metrics.char_count);
+    });
+    (0, vitest_1.it)("omits Existing Helpers section when list is empty", () => {
+        const { prompt } = (0, worker_prompt_js_1.buildWorkerPrompt)(makeBaseInput({ existingHelpers: [] }));
+        (0, vitest_1.expect)(prompt).not.toContain("## Existing Helpers");
+    });
+    (0, vitest_1.it)("scope touch and avoid lines are included", () => {
+        const { prompt } = (0, worker_prompt_js_1.buildWorkerPrompt)(makeBaseInput());
+        (0, vitest_1.expect)(prompt).toContain("src/smartdocs-engine/ingest.ts");
+        (0, vitest_1.expect)(prompt).toContain("src/loop/");
+    });
+    (0, vitest_1.it)("metrics char_count matches prompt length", () => {
+        const { prompt, metrics } = (0, worker_prompt_js_1.buildWorkerPrompt)(makeBaseInput());
+        (0, vitest_1.expect)(metrics.char_count).toBe(prompt.length);
+    });
+    (0, vitest_1.it)("metrics estimated_tokens is approximately char_count / 4", () => {
+        const { prompt, metrics } = (0, worker_prompt_js_1.buildWorkerPrompt)(makeBaseInput());
+        (0, vitest_1.expect)(metrics.estimated_tokens).toBe(Math.round(prompt.length / 4));
+    });
+    (0, vitest_1.it)("many requirements still produce a single prompt (no truncation)", () => {
+        const acceptanceCriteria = Array.from({ length: 20 }, (_, i) => `AC ${i + 1}`);
+        const { prompt } = (0, worker_prompt_js_1.buildWorkerPrompt)(makeBaseInput({ acceptanceCriteria }));
+        for (let i = 1; i <= 20; i++) {
+            (0, vitest_1.expect)(prompt).toContain(`AC ${i}`);
+        }
+    });
+});
+(0, vitest_1.describe)("isNarrowChild", () => {
+    (0, vitest_1.it)("returns true when child has no labels", () => {
+        (0, vitest_1.expect)((0, worker_prompt_js_1.isNarrowChild)("POL-131", makeState())).toBe(true);
+    });
+    (0, vitest_1.it)("returns true when child has irrelevant labels", () => {
+        (0, vitest_1.expect)((0, worker_prompt_js_1.isNarrowChild)("POL-131", makeState(["implement", "docs"]))).toBe(true);
+    });
+    (0, vitest_1.it)("returns false for cross-cutting label", () => {
+        (0, vitest_1.expect)((0, worker_prompt_js_1.isNarrowChild)("POL-131", makeState(["cross-cutting"]))).toBe(false);
+    });
+    (0, vitest_1.it)("returns false for high-risk label", () => {
+        (0, vitest_1.expect)((0, worker_prompt_js_1.isNarrowChild)("POL-131", makeState(["high-risk"]))).toBe(false);
+    });
+    (0, vitest_1.it)("returns false for parallel label", () => {
+        (0, vitest_1.expect)((0, worker_prompt_js_1.isNarrowChild)("POL-131", makeState(["parallel"]))).toBe(false);
+    });
+    (0, vitest_1.it)("returns false for worker-isolation label", () => {
+        (0, vitest_1.expect)((0, worker_prompt_js_1.isNarrowChild)("POL-131", makeState(["worker-isolation"]))).toBe(false);
+    });
+    (0, vitest_1.it)("returns false for architectural label", () => {
+        (0, vitest_1.expect)((0, worker_prompt_js_1.isNarrowChild)("POL-131", makeState(["architectural"]))).toBe(false);
+    });
+    (0, vitest_1.it)("returns true when child has no meta entry", () => {
+        const state = makeState();
+        (0, vitest_1.expect)((0, worker_prompt_js_1.isNarrowChild)("POL-999", state)).toBe(true);
+    });
+});
+(0, vitest_1.describe)("selectPromptMode", () => {
+    (0, vitest_1.it)("returns compact for narrow child with no override", () => {
+        (0, vitest_1.expect)((0, worker_prompt_js_1.selectPromptMode)("POL-131", makeState())).toBe("compact");
+    });
+    (0, vitest_1.it)("returns full for non-narrow child", () => {
+        (0, vitest_1.expect)((0, worker_prompt_js_1.selectPromptMode)("POL-131", makeState(["cross-cutting"]))).toBe("full");
+    });
+    (0, vitest_1.it)("override wins over narrow detection", () => {
+        (0, vitest_1.expect)((0, worker_prompt_js_1.selectPromptMode)("POL-131", makeState(), "full")).toBe("full");
+    });
+    (0, vitest_1.it)("override wins over non-narrow detection", () => {
+        (0, vitest_1.expect)((0, worker_prompt_js_1.selectPromptMode)("POL-131", makeState(["cross-cutting"]), "compact")).toBe("compact");
+    });
+});
+(0, vitest_1.describe)("buildPromptFromPacketInput", () => {
+    (0, vitest_1.it)("produces a prompt with the correct issue ID and title", () => {
+        const { prompt } = (0, worker_prompt_js_1.buildPromptFromPacketInput)({
+            issueId: "POL-131",
+            title: "Add .smartdocignore parser",
+            worktree: ".",
+            branch: "feat/test",
+            stateFile: "state.json",
+            telemetryFile: "telemetry.jsonl",
+            mode: "compact",
+        });
+        (0, vitest_1.expect)(prompt).toContain("Issue: POL-131 — Add .smartdocignore parser");
+    });
+    (0, vitest_1.it)("uses first requirement as goal when issueContext provided", () => {
+        const { prompt } = (0, worker_prompt_js_1.buildPromptFromPacketInput)({
+            issueId: "POL-131",
+            title: "Add .smartdocignore parser",
+            worktree: ".",
+            branch: "feat/test",
+            stateFile: "state.json",
+            telemetryFile: "telemetry.jsonl",
+            issueContext: {
+                id: "POL-131",
+                title: "Add .smartdocignore parser",
+                key_requirements: ["Parse .smartdocignore from repo root", "Enforce during ingest"],
+            },
+            mode: "compact",
+        });
+        (0, vitest_1.expect)(prompt).toContain("Parse .smartdocignore from repo root");
+    });
+    (0, vitest_1.it)("returns compact metrics by default for narrow input", () => {
+        const { metrics } = (0, worker_prompt_js_1.buildPromptFromPacketInput)({
+            issueId: "POL-131",
+            title: "Title",
+            worktree: ".",
+            branch: "main",
+            stateFile: "s.json",
+            telemetryFile: "t.jsonl",
+            mode: "compact",
+        });
+        (0, vitest_1.expect)(metrics.mode).toBe("compact");
+        (0, vitest_1.expect)(metrics.char_count).toBeGreaterThan(0);
+        (0, vitest_1.expect)(metrics.estimated_tokens).toBeGreaterThan(0);
+    });
+});