pulseed 0.1.5 → 0.2.0

package/dist/orchestrator/execution/checkpoint-manager.js

@@ -0,0 +1,143 @@
+import { randomUUID } from 'node:crypto';
+import { promises as fsp } from 'node:fs';
+import path from 'node:path';
+import { z } from 'zod';
+import { CheckpointSchema, CheckpointIndexSchema, } from '../../base/types/checkpoint.js';
+const CheckpointAdaptResponseSchema = z.object({
+    adapted_context: z.string(),
+});
+export class CheckpointManager {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    indexPath = (goalId) => `checkpoints/${goalId}/index.json`;
+    checkpointPath = (goalId, checkpointId) => `checkpoints/${goalId}/${checkpointId}.json`;
+    async readIndex(goalId) {
+        const raw = await this.deps.stateManager.readRaw(this.indexPath(goalId));
+        if (!raw)
+            return { goal_id: goalId, checkpoints: [] };
+        try {
+            return CheckpointIndexSchema.parse(raw);
+        }
+        catch {
+            this.deps.logger?.warn('checkpoint index parse failed, resetting', { goalId });
+            return { goal_id: goalId, checkpoints: [] };
+        }
+    }
+    async writeIndex(index) {
+        await this.deps.stateManager.writeRaw(this.indexPath(index.goal_id), index);
+    }
+    async saveCheckpoint(params) {
+        const checkpoint = CheckpointSchema.parse({
+            checkpoint_id: randomUUID(),
+            goal_id: params.goalId,
+            task_id: params.taskId,
+            agent_id: params.agentId,
+            session_context_snapshot: params.sessionContextSnapshot,
+            intermediate_results: params.intermediateResults ?? [],
+            created_at: new Date().toISOString(),
+            metadata: params.metadata ?? {},
+        });
+        await this.deps.stateManager.writeRaw(this.checkpointPath(params.goalId, checkpoint.checkpoint_id), checkpoint);
+        const index = await this.readIndex(params.goalId);
+        index.checkpoints.push({
+            checkpoint_id: checkpoint.checkpoint_id,
+            task_id: checkpoint.task_id,
+            agent_id: checkpoint.agent_id,
+            created_at: checkpoint.created_at,
+        });
+        await this.writeIndex(index);
+        this.deps.logger?.info('checkpoint saved', {
+            checkpointId: checkpoint.checkpoint_id,
+            goalId: params.goalId,
+        });
+        return checkpoint;
+    }
+    async loadCheckpoint(goalId, taskId) {
+        const index = await this.readIndex(goalId);
+        let entries = index.checkpoints;
+        if (taskId)
+            entries = entries.filter((e) => e.task_id === taskId);
+        if (entries.length === 0)
+            return null;
+        const latest = entries.reduce((a, b) => (a.created_at > b.created_at ? a : b));
+        const raw = await this.deps.stateManager.readRaw(this.checkpointPath(goalId, latest.checkpoint_id));
+        if (!raw)
+            return null;
+        try {
+            return CheckpointSchema.parse(raw);
+        }
+        catch {
+            this.deps.logger?.warn('checkpoint parse failed', {
+                checkpointId: latest.checkpoint_id,
+            });
+            return null;
+        }
+    }
+    async loadAndAdaptCheckpoint(goalId, currentAgentId, taskId) {
+        const checkpoint = await this.loadCheckpoint(goalId, taskId);
+        if (!checkpoint)
+            return null;
+        if (checkpoint.agent_id === currentAgentId) {
+            return { checkpoint, adaptedContext: checkpoint.session_context_snapshot, wasAdapted: false };
+        }
+        if (!this.deps.llmClient && !this.deps.gateway) {
+            return { checkpoint, adaptedContext: checkpoint.session_context_snapshot, wasAdapted: false };
+        }
+        const prompt = `You are helping transfer context from agent '${checkpoint.agent_id}' to agent '${currentAgentId}'. ` +
+            `Summarize and adapt the following session context and intermediate results for the new agent to continue the work.\n\n` +
+            `Context:\n${checkpoint.session_context_snapshot}\n\n` +
+            `Intermediate Results:\n${checkpoint.intermediate_results.join('\n')}`;
+        try {
+            if (this.deps.gateway) {
+                const result = await this.deps.gateway.execute({
+                    purpose: "checkpoint_adapt",
+                    goalId,
+                    additionalContext: { adapt_prompt: prompt },
+                    responseSchema: CheckpointAdaptResponseSchema,
+                });
+                return { checkpoint, adaptedContext: result.adapted_context, wasAdapted: true };
+            }
+            else {
+                const response = await this.deps.llmClient.chat([{ role: 'user', content: prompt }]);
+                return { checkpoint, adaptedContext: response.content, wasAdapted: true };
+            }
+        }
+        catch (err) {
+            this.deps.logger?.error('context adaptation failed', { error: String(err) });
+            return { checkpoint, adaptedContext: checkpoint.session_context_snapshot, wasAdapted: false };
+        }
+    }
+    async listCheckpoints(goalId) {
+        const index = await this.readIndex(goalId);
+        return index.checkpoints;
+    }
+    async deleteCheckpoint(goalId, checkpointId) {
+        const filePath = path.join(this.deps.stateManager.getBaseDir(), this.checkpointPath(goalId, checkpointId));
+        await fsp.unlink(filePath).catch((err) => {
+            console.error("[CheckpointManager] failed to delete checkpoint file:", err instanceof Error ? err.message : err);
+        });
+        const index = await this.readIndex(goalId);
+        index.checkpoints = index.checkpoints.filter((e) => e.checkpoint_id !== checkpointId);
+        await this.writeIndex(index);
+        this.deps.logger?.info('checkpoint deleted', { checkpointId, goalId });
+    }
+    async garbageCollect(goalId, maxAgeDays = 7) {
+        const index = await this.readIndex(goalId);
+        const cutoff = Date.now() - maxAgeDays * 86_400_000;
+        const toDelete = index.checkpoints.filter((e) => new Date(e.created_at).getTime() < cutoff);
+        for (const entry of toDelete) {
+            const filePath = path.join(this.deps.stateManager.getBaseDir(), this.checkpointPath(goalId, entry.checkpoint_id));
+            await fsp.unlink(filePath).catch((err) => {
+                console.error("[CheckpointManager] failed to delete checkpoint file during GC:", err instanceof Error ? err.message : err);
+            });
+        }
+        const deletedIds = new Set(toDelete.map((e) => e.checkpoint_id));
+        index.checkpoints = index.checkpoints.filter((e) => !deletedIds.has(e.checkpoint_id));
+        await this.writeIndex(index);
+        this.deps.logger?.info('garbage collected checkpoints', { goalId, count: toDelete.length });
+        return toDelete.length;
+    }
+}
+//# sourceMappingURL=checkpoint-manager.js.map

package/dist/orchestrator/execution/checkpoint-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-manager.js","sourceRoot":"","sources":["../../../src/orchestrator/execution/checkpoint-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAEL,gBAAgB,EAEhB,qBAAqB,GACtB,MAAM,gCAAgC,CAAC;AAaxC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;CAC5B,CAAC,CAAC;AASH,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,IAA2B;QAA3B,SAAI,GAAJ,IAAI,CAAuB;IAAG,CAAC;IAEpD,SAAS,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,eAAe,MAAM,aAAa,CAAC;IACnE,cAAc,GAAG,CAAC,MAAc,EAAE,YAAoB,EAAE,EAAE,CAChE,eAAe,MAAM,IAAI,YAAY,OAAO,CAAC;IAEvC,KAAK,CAAC,SAAS,CAAC,MAAc;QACpC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;QACtD,IAAI,CAAC;YACH,OAAO,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,0CAA0C,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;QAC9C,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,KAAsB;QAC7C,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAOpB;QACC,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC;YACxC,aAAa,EAAE,UAAU,EAAE;YAC3B,OAAO,EAAE,MAAM,CAAC,MAAM;YACtB,OAAO,EAAE,MAAM,CAAC,MAAM;YACtB,QAAQ,EAAE,MAAM,CAAC,OAAO;YACxB,wBAAwB,EAAE,MAAM,CAAC,sBAAsB;YACvD,oBAAoB,EAAE,MAAM,CAAC,mBAAmB,IAAI,EAAE;YACtD,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;SAChC,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CACnC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,aAAa,CAAC,EAC5D,UAAU,CACX,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClD,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;YACrB,aAAa,EAAE,UAAU,CAAC,aAAa;YACvC,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,UAAU,EAAE,UAAU,CAAC,UAAU;SAClC,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAE7B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE;YACzC,YAAY,EAAE,UAAU,CAAC,aAAa;YACtC,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC;QAEH,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAc,EAAE,MAAe;QAClD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC;QAChC,IAAI,MAAM;YAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;QAClE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEtC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/E,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAC9C,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC,CAClD,CAAC;QACF,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QAEtB,IAAI,CAAC;YACH,OAAO,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,yBAAyB,EAAE;gBAChD,YAAY,EAAE,MAAM,CAAC,aAAa;aACnC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,sBAAsB,CAC1B,MAAc,EACd,cAAsB,EACtB,MAAe;QAEf,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAE7B,IAAI,UAAU,CAAC,QAAQ,KAAK,cAAc,EAAE,CAAC;YAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,CAAC,wBAAwB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAChG,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,CAAC,wBAAwB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAChG,CAAC;QAED,MAAM,MAAM,GACV,gDAAgD,UAAU,CAAC,QAAQ,eAAe,cAAc,KAAK;YACrG,wHAAwH;YACxH,aAAa,UAAU,CAAC,wBAAwB,MAAM;YACtD,0BAA0B,UAAU,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAEzE,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;oBAC7C,OAAO,EAAE,kBAAkB;oBAC3B,MAAM;oBACN,iBAAiB,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE;oBAC3C,cAAc,EAAE,6BAA6B;iBAC9C,CAAC,CAAC;gBACH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,CAAC,eAAe,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;YAClF,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAU,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;gBACtF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;YAC5E,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7E,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,CAAC,wBAAwB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAChG,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,MAAc;QAClC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC3C,OAAO,KAAK,CAAC,WAAW,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,MAAc,EAAE,YAAoB;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CACxB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,EACnC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,YAAY,CAAC,CAC1C,CAAC;QACF,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACvC,OAAO,CAAC,KAAK,CAAC,uDAAuD,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACnH,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC3C,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,YAAY,CAAC,CAAC;QACtF,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAc,EAAE,UAAU,GAAG,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,UAAU,CAAC;QACpD,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,GAAG,MAAM,CACjD,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CACxB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,EACnC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,CACjD,CAAC;YACF,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACvC,OAAO,CAAC,KAAK,CAAC,iEAAiE,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAC7H,CAAC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;QACjE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;QACtF,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAE7B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,+BAA+B,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5F,OAAO,QAAQ,CAAC,MAAM,CAAC;IACzB,CAAC;CACF"}

package/dist/orchestrator/execution/context/context-budget.d.ts

@@ -0,0 +1,35 @@
+import type { TierBudget } from "../../../base/types/memory-lifecycle.js";
+/**
+ * Distributes a total token budget across memory tiers.
+ * - core: 50% (always included items)
+ * - recall: 35% (recent observations, strategy history)
+ * - archival: remaining (completed-goal knowledge)
+ */
+export declare function allocateTierBudget(totalTokens: number): TierBudget;
+export interface BudgetAllocation {
+    goalDefinition: number;
+    observations: number;
+    knowledge: number;
+    transferKnowledge: number;
+    meta: number;
+}
+export declare function allocateBudget(totalBudget: number): BudgetAllocation;
+/** Estimate token count. Heuristic: 1 token ≈ 4 characters. */
+export declare function estimateTokens(text: string): number;
+/**
+ * Select candidates greedily by similarity (descending) until the budget is exhausted.
+ * Assumes `candidates` is already sorted by similarity descending.
+ */
+export declare function selectWithinBudget<T extends {
+    text: string;
+    similarity: number;
+}>(candidates: T[], budgetTokens: number): T[];
+/**
+ * When total actual usage exceeds the budget, reduce allocations starting from
+ * the lowest-priority categories.
+ *
+ * Priority order (highest first): observations, knowledge, goalDefinition,
+ * transferKnowledge, meta.
+ */
+export declare function trimToBudget(allocation: BudgetAllocation, actualUsage: Record<keyof BudgetAllocation, number>, totalBudget: number): BudgetAllocation;
+//# sourceMappingURL=context-budget.d.ts.map

package/dist/orchestrator/execution/context/context-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-budget.d.ts","sourceRoot":"","sources":["../../../../src/orchestrator/execution/context/context-budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAC;AAI1E;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAKlE;AAID,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAQpE;AAID,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAC/E,UAAU,EAAE,CAAC,EAAE,EACf,YAAY,EAAE,MAAM,GACnB,CAAC,EAAE,CAUL;AAID;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,gBAAgB,EAC5B,WAAW,EAAE,MAAM,CAAC,MAAM,gBAAgB,EAAE,MAAM,CAAC,EACnD,WAAW,EAAE,MAAM,GAClB,gBAAgB,CAmBlB"}

package/dist/orchestrator/execution/context/context-budget.js

@@ -0,0 +1,73 @@
+// ─── Tier Budget Allocation ───
+/**
+ * Distributes a total token budget across memory tiers.
+ * - core: 50% (always included items)
+ * - recall: 35% (recent observations, strategy history)
+ * - archival: remaining (completed-goal knowledge)
+ */
+export function allocateTierBudget(totalTokens) {
+    const core = Math.floor(totalTokens * 0.50);
+    const recall = Math.floor(totalTokens * 0.35);
+    const archival = totalTokens - core - recall;
+    return { core, recall, archival };
+}
+export function allocateBudget(totalBudget) {
+    return {
+        goalDefinition: Math.floor(totalBudget * 0.20),
+        observations: Math.floor(totalBudget * 0.30),
+        knowledge: Math.floor(totalBudget * 0.30),
+        transferKnowledge: Math.floor(totalBudget * 0.15),
+        meta: Math.floor(totalBudget * 0.05),
+    };
+}
+// ─── Token Estimation ───
+/** Estimate token count. Heuristic: 1 token ≈ 4 characters. */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+// ─── Progressive Disclosure Selection ───
+/**
+ * Select candidates greedily by similarity (descending) until the budget is exhausted.
+ * Assumes `candidates` is already sorted by similarity descending.
+ */
+export function selectWithinBudget(candidates, budgetTokens) {
+    const selected = [];
+    let usedTokens = 0;
+    for (const candidate of candidates) {
+        const tokens = estimateTokens(candidate.text);
+        if (usedTokens + tokens > budgetTokens)
+            break;
+        selected.push(candidate);
+        usedTokens += tokens;
+    }
+    return selected;
+}
+// ─── Budget Trimming ───
+/**
+ * When total actual usage exceeds the budget, reduce allocations starting from
+ * the lowest-priority categories.
+ *
+ * Priority order (highest first): observations, knowledge, goalDefinition,
+ * transferKnowledge, meta.
+ */
+export function trimToBudget(allocation, actualUsage, totalBudget) {
+    const trimOrder = [
+        "meta",
+        "transferKnowledge",
+        "goalDefinition",
+        "knowledge",
+        "observations",
+    ];
+    const result = { ...allocation };
+    let totalUsed = Object.values(actualUsage).reduce((a, b) => a + b, 0);
+    for (const category of trimOrder) {
+        if (totalUsed <= totalBudget)
+            break;
+        const excess = totalUsed - totalBudget;
+        const reduction = Math.min(result[category], excess);
+        result[category] -= reduction;
+        totalUsed -= reduction;
+    }
+    return result;
+}
+//# sourceMappingURL=context-budget.js.map

package/dist/orchestrator/execution/context/context-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-budget.js","sourceRoot":"","sources":["../../../../src/orchestrator/execution/context/context-budget.ts"],"names":[],"mappings":"AAEA,iCAAiC;AAEjC;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,WAAW,GAAG,IAAI,GAAG,MAAM,CAAC;IAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACpC,CAAC;AAYD,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,OAAO;QACL,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QAC9C,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QAC5C,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QACzC,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QACjD,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,2BAA2B;AAE3B,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,2CAA2C;AAE3C;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAe,EACf,YAAoB;IAEpB,MAAM,QAAQ,GAAQ,EAAE,CAAC;IACzB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,UAAU,GAAG,MAAM,GAAG,YAAY;YAAE,MAAM;QAC9C,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzB,UAAU,IAAI,MAAM,CAAC;IACvB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,0BAA0B;AAE1B;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,UAA4B,EAC5B,WAAmD,EACnD,WAAmB;IAEnB,MAAM,SAAS,GAA+B;QAC5C,MAAM;QACN,mBAAmB;QACnB,gBAAgB;QAChB,WAAW;QACX,cAAc;KACf,CAAC;IACF,MAAM,MAAM,GAAG,EAAE,GAAG,UAAU,EAAE,CAAC;IACjC,IAAI,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAEtE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,SAAS,IAAI,WAAW;YAAE,MAAM;QACpC,MAAM,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACrD,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC;QAC9B,SAAS,IAAI,SAAS,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/orchestrator/execution/context/context-builder.d.ts

@@ -0,0 +1,44 @@
+import type { ContextSlot } from "../../../base/types/session.js";
+import type { KnowledgeEntry } from "../../../base/types/knowledge.js";
+import type { VectorIndex } from "../../../platform/knowledge/vector-index.js";
+import { estimateTokens } from "./context-budget.js";
+export { estimateTokens };
+export declare const DEFAULT_CONTEXT_BUDGET = 50000;
+/**
+ * Compresses a context slot to fit within maxTokens.
+ * Uses head + tail strategy: keeps first 60% and last 40% of allowed chars.
+ */
+export declare function compressSlot(slot: ContextSlot, maxTokens: number): ContextSlot;
+/**
+ * Filters context slots to fit within a token budget.
+ *
+ * Slots are sorted by priority (ascending = higher priority first).
+ * Slots are accumulated until the budget is exceeded; any slot that
+ * would push the total over budget is dropped along with all subsequent slots.
+ *
+ * The returned array preserves the original slot order.
+ */
+export declare function filterSlotsByBudget(slots: ContextSlot[], budget: number): ContextSlot[];
+/**
+ * Inject relevant KnowledgeEntry items into an existing set of context slots.
+ *
+ * Each non-superseded entry is formatted as structured text and appended as
+ * a new low-priority context slot (`domain_knowledge`). Empty entry arrays
+ * are a no-op — the original slots are returned unchanged.
+ */
+export declare function injectKnowledgeContext(slots: ContextSlot[], entries: KnowledgeEntry[]): ContextSlot[];
+/**
+ * Phase 2 (Progressive Disclosure): Inject knowledge context using semantic search.
+ * 1. searchMetadata() — fetch id+score for up to 20 candidates (no full text)
+ * 2. selectWithinBudget() — pick candidates that fit the knowledge budget
+ * 3. getEntryById() — load full text only for selected candidates
+ *
+ * Falls back to empty if no vectorIndex available.
+ */
+export declare function injectSemanticKnowledgeContext(slots: ContextSlot[], query: string, vectorIndex: VectorIndex | undefined, contextBudget?: number): Promise<ContextSlot[]>;
+/**
+ * Inject learning feedback into context slots.
+ * Adds a single "learning_feedback" slot containing all feedback strings.
+ */
+export declare function injectLearningFeedback(slots: ContextSlot[], feedback: string[]): ContextSlot[];
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/orchestrator/execution/context/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../../../src/orchestrator/execution/context/context-builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,EAAsC,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEzF,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAI7C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CAkB9E;AAID;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAmBvF;AAID;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,EAAE,cAAc,EAAE,GACxB,WAAW,EAAE,CAwBf;AAED;;;;;;;GAOG;AACH,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,WAAW,EAAE,EACpB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,aAAa,GAAE,MAA+B,GAC7C,OAAO,CAAC,WAAW,EAAE,CAAC,CAoCxB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAkB9F"}

package/dist/orchestrator/execution/context/context-builder.js

@@ -0,0 +1,132 @@
+import { ContextSlotSchema } from "../../../base/types/session.js";
+import { allocateBudget, selectWithinBudget, estimateTokens } from "./context-budget.js";
+export { estimateTokens };
+export const DEFAULT_CONTEXT_BUDGET = 50_000;
+// ─── Slot Compression ───
+/**
+ * Compresses a context slot to fit within maxTokens.
+ * Uses head + tail strategy: keeps first 60% and last 40% of allowed chars.
+ */
+export function compressSlot(slot, maxTokens) {
+    const maxChars = maxTokens * 4;
+    if (slot.content.length <= maxChars) {
+        return { ...slot, token_estimate: estimateTokens(slot.content) };
+    }
+    const headChars = Math.floor(maxChars * 0.6);
+    const tailChars = maxChars - headChars;
+    const compressed = slot.content.slice(0, headChars) +
+        "\n...[truncated]...\n" +
+        slot.content.slice(slot.content.length - tailChars);
+    return {
+        ...slot,
+        content: compressed,
+        token_estimate: estimateTokens(compressed),
+    };
+}
+// ─── Budget Filtering ───
+/**
+ * Filters context slots to fit within a token budget.
+ *
+ * Slots are sorted by priority (ascending = higher priority first).
+ * Slots are accumulated until the budget is exceeded; any slot that
+ * would push the total over budget is dropped along with all subsequent slots.
+ *
+ * The returned array preserves the original slot order.
+ */
+export function filterSlotsByBudget(slots, budget) {
+    const sorted = [...slots].sort((a, b) => a.priority - b.priority);
+    let accumulated = 0;
+    const kept = [];
+    for (const slot of sorted) {
+        const estimate = slot.token_estimate > 0
+            ? slot.token_estimate
+            : Math.ceil(slot.content.length / 4);
+        if (accumulated + estimate <= budget) {
+            accumulated += estimate;
+            kept.push(slot);
+        }
+    }
+    const keptSet = new Set(kept);
+    return slots.filter((s) => keptSet.has(s));
+}
+// ─── Knowledge Context Injection ───
+/**
+ * Inject relevant KnowledgeEntry items into an existing set of context slots.
+ *
+ * Each non-superseded entry is formatted as structured text and appended as
+ * a new low-priority context slot (`domain_knowledge`). Empty entry arrays
+ * are a no-op — the original slots are returned unchanged.
+ */
+export function injectKnowledgeContext(slots, entries) {
+    const activeEntries = entries.filter((e) => e.superseded_by === null);
+    if (activeEntries.length === 0)
+        return slots;
+    const content = activeEntries
+        .map((e) => `[Knowledge] Q: ${e.question}\nA: ${e.answer} (confidence: ${e.confidence})`)
+        .join("\n\n");
+    const maxPriority = slots.reduce((max, s) => (s.priority > max ? s.priority : max), 0);
+    const knowledgeSlot = {
+        priority: maxPriority + 1,
+        label: "domain_knowledge",
+        content,
+        token_estimate: 0,
+    };
+    return [...slots, knowledgeSlot];
+}
+/**
+ * Phase 2 (Progressive Disclosure): Inject knowledge context using semantic search.
+ * 1. searchMetadata() — fetch id+score for up to 20 candidates (no full text)
+ * 2. selectWithinBudget() — pick candidates that fit the knowledge budget
+ * 3. getEntryById() — load full text only for selected candidates
+ *
+ * Falls back to empty if no vectorIndex available.
+ */
+export async function injectSemanticKnowledgeContext(slots, query, vectorIndex, contextBudget = DEFAULT_CONTEXT_BUDGET) {
+    if (!vectorIndex)
+        return slots;
+    try {
+        const candidates = await vectorIndex.searchMetadata(query, 20, 0.5);
+        if (candidates.length === 0)
+            return slots;
+        const allocation = allocateBudget(contextBudget);
+        const knowledgeBudget = allocation.knowledge;
+        const withText = candidates
+            .map((c) => {
+            const entry = vectorIndex.getEntryById(c.id);
+            return entry ? { ...c, text: entry.text } : null;
+        })
+            .filter((c) => c !== null);
+        const selected = selectWithinBudget(withText, knowledgeBudget);
+        if (selected.length === 0)
+            return slots;
+        const maxPriority = slots.reduce((max, s) => (s.priority > max ? s.priority : max), 0);
+        const knowledgeSlots = selected.map((result, i) => ({
+            priority: maxPriority + 1 + i,
+            label: `semantic_knowledge_${i}`,
+            content: result.text,
+            token_estimate: Math.ceil(result.text.length / 4),
+        }));
+        return [...slots, ...knowledgeSlots];
+    }
+    catch {
+        return slots; // Non-critical failure
+    }
+}
+/**
+ * Inject learning feedback into context slots.
+ * Adds a single "learning_feedback" slot containing all feedback strings.
+ */
+export function injectLearningFeedback(slots, feedback) {
+    if (feedback.length === 0) {
+        return slots;
+    }
+    const maxPriority = slots.reduce((max, s) => Math.max(max, s.priority), 0);
+    const feedbackSlot = ContextSlotSchema.parse({
+        label: "learning_feedback",
+        content: feedback.join("\n---\n"),
+        token_estimate: feedback.join("\n---\n").length / 4,
+        priority: maxPriority + 1,
+    });
+    return [...slots, feedbackSlot];
+}
+//# sourceMappingURL=context-builder.js.map

package/dist/orchestrator/execution/context/context-builder.js.map

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

package/dist/orchestrator/execution/context/dimension-selector.d.ts

@@ -0,0 +1,16 @@
+import type { GapVector } from "../../../base/types/gap.js";
+import type { DriveContext } from "../../../base/types/drive.js";
+import type { Dimension } from "../../../base/types/goal.js";
+/**
+ * Select the highest-priority dimension to work on based on drive scoring,
+ * weighted by observation confidence tier so that mechanically-observable
+ * dimensions are preferred over LLM-only ones at equal gap severity.
+ *
+ * @param gapVector - current gap state for the goal
+ * @param driveContext - per-dimension timing/deadline/opportunity context
+ * @param dimensions - optional goal dimensions used to apply confidence-tier weighting
+ * @returns the name of the top-ranked dimension
+ * @throws if gapVector has no gaps (empty)
+ */
+export declare function selectTargetDimension(gapVector: GapVector, driveContext: DriveContext, dimensions?: Dimension[]): string;
+//# sourceMappingURL=dimension-selector.d.ts.map

package/dist/orchestrator/execution/context/dimension-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimension-selector.d.ts","sourceRoot":"","sources":["../../../../src/orchestrator/execution/context/dimension-selector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAkB7D;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,YAAY,EAC1B,UAAU,CAAC,EAAE,SAAS,EAAE,GACvB,MAAM,CAkCR"}

package/dist/orchestrator/execution/context/dimension-selector.js

@@ -0,0 +1,57 @@
+import { scoreAllDimensions, rankDimensions } from "../../../platform/drive/drive-scorer.js";
+/**
+ * Confidence-tier weights for dimension selection.
+ * Mechanically-observable dimensions are prioritized over LLM-only ones.
+ */
+const CONFIDENCE_WEIGHTS = {
+    mechanical: 1.0,
+    verified: 0.9,
+    independent_review: 0.7,
+    self_report: 0.3,
+};
+function getConfidenceWeight(dim) {
+    const tier = dim.observation_method.confidence_tier;
+    return CONFIDENCE_WEIGHTS[tier] ?? 0.3;
+}
+/**
+ * Select the highest-priority dimension to work on based on drive scoring,
+ * weighted by observation confidence tier so that mechanically-observable
+ * dimensions are preferred over LLM-only ones at equal gap severity.
+ *
+ * @param gapVector - current gap state for the goal
+ * @param driveContext - per-dimension timing/deadline/opportunity context
+ * @param dimensions - optional goal dimensions used to apply confidence-tier weighting
+ * @returns the name of the top-ranked dimension
+ * @throws if gapVector has no gaps (empty)
+ */
+export function selectTargetDimension(gapVector, driveContext, dimensions) {
+    if (gapVector.gaps.length === 0) {
+        throw new Error("selectTargetDimension: gapVector has no gaps (empty gap vector)");
+    }
+    const scores = scoreAllDimensions(gapVector, driveContext);
+    const ranked = rankDimensions(scores);
+    if (!dimensions || dimensions.length === 0) {
+        // No dimension metadata available — fall back to drive-score ranking only
+        // ranked is non-empty: gapVector.gaps.length === 0 guard above ensures at least one gap
+        return ranked[0]?.dimension_name ?? gapVector.gaps[0]?.dimension_name ?? "";
+    }
+    // Build a lookup from dimension name → confidence weight
+    const weightByName = new Map();
+    for (const dim of dimensions) {
+        weightByName.set(dim.name, getConfidenceWeight(dim));
+    }
+    // Apply confidence-tier weighting to final_score for selection only
+    const weighted = ranked.map((score) => ({
+        dimension_name: score.dimension_name,
+        weighted_score: score.final_score * (weightByName.get(score.dimension_name) ?? 0.3),
+    }));
+    weighted.sort((a, b) => {
+        const scoreDiff = b.weighted_score - a.weighted_score;
+        if (scoreDiff !== 0)
+            return scoreDiff;
+        return a.dimension_name < b.dimension_name ? -1 : a.dimension_name > b.dimension_name ? 1 : 0;
+    });
+    // weighted is non-empty: ranked is non-empty (gapVector guard above), weighted maps ranked 1:1
+    return weighted[0]?.dimension_name ?? gapVector.gaps[0]?.dimension_name ?? "";
+}
+//# sourceMappingURL=dimension-selector.js.map

package/dist/orchestrator/execution/context/dimension-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimension-selector.js","sourceRoot":"","sources":["../../../../src/orchestrator/execution/context/dimension-selector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAK7F;;;GAGG;AACH,MAAM,kBAAkB,GAA2B;IACjD,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,kBAAkB,EAAE,GAAG;IACvB,WAAW,EAAE,GAAG;CACjB,CAAC;AAEF,SAAS,mBAAmB,CAAC,GAAc;IACzC,MAAM,IAAI,GAAG,GAAG,CAAC,kBAAkB,CAAC,eAAe,CAAC;IACpD,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;AACzC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAoB,EACpB,YAA0B,EAC1B,UAAwB;IAExB,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEtC,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,0EAA0E;QAC1E,wFAAwF;QACxF,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,cAAc,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,IAAI,EAAE,CAAC;IAC9E,CAAC;IAED,yDAAyD;IACzD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC/C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,oEAAoE;IACpE,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACtC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,cAAc,EAAE,KAAK,CAAC,WAAW,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC;KACpF,CAAC,CAAC,CAAC;IAEJ,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrB,MAAM,SAAS,GAAG,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC;QACtD,IAAI,SAAS,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACtC,OAAO,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;IAEH,+FAA+F;IAC/F,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,cAAc,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,IAAI,EAAE,CAAC;AAChF,CAAC"}

package/dist/orchestrator/execution/context/issue-context-fetcher.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Extract unique GitHub issue numbers from text.
+ * Skips hex-color-like tokens (non-digit characters after #).
+ *
+ * Matches #NNN preceded by start-of-string, whitespace, or opening paren,
+ * and NOT followed by any non-digit word character.
+ * This avoids matching hex colors like #fff, #abc123, or #1a2b3c.
+ */
+export declare function extractIssueNumbers(text: string): number[];
+/**
+ * Extract GitHub issue numbers from `text`, fetch their content via `gh`,
+ * and return formatted context for use in task prompts.
+ *
+ * - Deduplicates issue numbers.
+ * - Processes at most 3 issues (first ones found).
+ * - Returns empty string on any failure.
+ */
+export declare function fetchIssueContext(text: string): Promise<string>;
+//# sourceMappingURL=issue-context-fetcher.d.ts.map

package/dist/orchestrator/execution/context/issue-context-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-context-fetcher.d.ts","sourceRoot":"","sources":["../../../../src/orchestrator/execution/context/issue-context-fetcher.ts"],"names":[],"mappings":"AAiBA;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAc1D;AAyBD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWrE"}

package/dist/orchestrator/execution/context/issue-context-fetcher.js

@@ -0,0 +1,73 @@
+// ─── fetchIssueContext ───
+//
+// Extracts GitHub issue numbers from goal text and fetches their content via
+// `gh issue view`. Returns formatted context for inclusion in task prompts.
+// On any failure, returns empty string (graceful degradation).
+import { execFileNoThrow } from "../../../base/utils/execFileNoThrow.js";
+const MAX_ISSUES = 3;
+const MAX_BODY_CHARS = 3000;
+const FETCH_TIMEOUT_MS = 10000;
+/**
+ * Extract unique GitHub issue numbers from text.
+ * Skips hex-color-like tokens (non-digit characters after #).
+ *
+ * Matches #NNN preceded by start-of-string, whitespace, or opening paren,
+ * and NOT followed by any non-digit word character.
+ * This avoids matching hex colors like #fff, #abc123, or #1a2b3c.
+ */
+export function extractIssueNumbers(text) {
+    // Regex is defined locally to avoid shared `lastIndex` state bugs with /g flag
+    const issueRefRe = /(?:^|[\s(])#(\d+)(?![a-zA-Z])/g;
+    const seen = new Set();
+    const results = [];
+    let match;
+    while ((match = issueRefRe.exec(text)) !== null) {
+        const num = parseInt(match[1], 10);
+        if (!seen.has(num)) {
+            seen.add(num);
+            results.push(num);
+        }
+    }
+    return results;
+}
+/**
+ * Fetch a single GitHub issue and format it for prompt inclusion.
+ * Returns null on any failure.
+ */
+async function fetchIssue(num) {
+    try {
+        const result = await execFileNoThrow("gh", ["issue", "view", String(num), "--json", "title,body"], { timeoutMs: FETCH_TIMEOUT_MS });
+        if (result.exitCode !== 0 || !result.stdout.trim()) {
+            return null;
+        }
+        const parsed = JSON.parse(result.stdout);
+        const title = parsed.title ?? "";
+        const body = (parsed.body ?? "").slice(0, MAX_BODY_CHARS);
+        return `## Referenced Issue #${num}\nTitle: ${title}\n${body}`;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Extract GitHub issue numbers from `text`, fetch their content via `gh`,
+ * and return formatted context for use in task prompts.
+ *
+ * - Deduplicates issue numbers.
+ * - Processes at most 3 issues (first ones found).
+ * - Returns empty string on any failure.
+ */
+export async function fetchIssueContext(text) {
+    try {
+        const nums = extractIssueNumbers(text).slice(0, MAX_ISSUES);
+        if (nums.length === 0)
+            return "";
+        const parts = await Promise.all(nums.map(fetchIssue));
+        const valid = parts.filter((p) => p !== null);
+        return valid.join("\n\n");
+    }
+    catch {
+        return "";
+    }
+}
+//# sourceMappingURL=issue-context-fetcher.js.map