pulseed 0.0.1 → 0.1.1

package/dist/execution/task-approval.js

@@ -0,0 +1,147 @@
+import { VerificationResultSchema } from "../types/task.js";
+// ─── runEthicsCheck ───
+/**
+ * Run ethics gate check on a task.
+ * Returns null if passed, or a TaskCycleResult to return early.
+ */
+async function runEthicsCheck(ethicsGate, approvalFn, task) {
+    const ethicsVerdict = await ethicsGate.checkMeans(task.id, task.work_description, task.approach);
+    if (ethicsVerdict.verdict === "reject") {
+        const rejectedResult = VerificationResultSchema.parse({
+            task_id: task.id,
+            verdict: "fail",
+            confidence: 1.0,
+            evidence: [
+                {
+                    layer: "mechanical",
+                    description: `Ethics gate rejected task: ${ethicsVerdict.reasoning}`,
+                    confidence: 1.0,
+                },
+            ],
+            dimension_updates: [],
+            timestamp: new Date().toISOString(),
+        });
+        return { task, verificationResult: rejectedResult, action: "discard" };
+    }
+    if (ethicsVerdict.verdict === "flag") {
+        // Treat flag as requiring human approval via the existing approvalFn
+        const approved = await approvalFn(task);
+        if (!approved) {
+            const flagDeniedResult = VerificationResultSchema.parse({
+                task_id: task.id,
+                verdict: "fail",
+                confidence: 1.0,
+                evidence: [
+                    {
+                        layer: "mechanical",
+                        description: `Ethics flag: approval denied. Reasoning: ${ethicsVerdict.reasoning}`,
+                        confidence: 1.0,
+                    },
+                ],
+                dimension_updates: [],
+                timestamp: new Date().toISOString(),
+            });
+            return { task, verificationResult: flagDeniedResult, action: "approval_denied" };
+        }
+    }
+    // verdict === "pass" → passed
+    return null;
+}
+// ─── runCapabilityCheck ───
+/**
+ * Run capability deficiency check on a task.
+ * Returns null if passed, or a TaskCycleResult to return early.
+ */
+async function runCapabilityCheck(capabilityDetector, task) {
+    // Skip for capability_acquisition tasks to prevent infinite delegation loops.
+    if (task.task_category === "capability_acquisition") {
+        return null;
+    }
+    const gap = await capabilityDetector.detectDeficiency(task);
+    if (gap === null) {
+        return null;
+    }
+    const capabilityResult = VerificationResultSchema.parse({
+        task_id: task.id,
+        verdict: "fail",
+        confidence: 1.0,
+        evidence: [
+            {
+                layer: "mechanical",
+                description: `Capability deficiency: ${gap.missing_capability.name} — ${gap.reason}`,
+                confidence: 1.0,
+            },
+        ],
+        dimension_updates: [],
+        timestamp: new Date().toISOString(),
+    });
+    // Determine acquisition method. Permissions always require human approval.
+    const acquisitionTask = capabilityDetector.planAcquisition(gap);
+    if (acquisitionTask.method === "permission_request") {
+        // Permissions cannot be autonomously acquired — escalate to human.
+        return { task, verificationResult: capabilityResult, action: "escalate" };
+    }
+    // For tool_creation and service_setup: mark as acquiring and delegate.
+    await capabilityDetector.setCapabilityStatus(gap.missing_capability.name, gap.missing_capability.type, "acquiring");
+    return {
+        action: "capability_acquiring",
+        task,
+        verificationResult: capabilityResult,
+        acquisition_task: acquisitionTask,
+    };
+}
+// ─── runIrreversibleApprovalCheck ───
+/**
+ * Run irreversible approval check on a task.
+ * Returns null if approved, or a TaskCycleResult to return early.
+ */
+async function runIrreversibleApprovalCheck(checkIrreversibleApproval, task) {
+    const approved = await checkIrreversibleApproval(task);
+    if (approved) {
+        return null;
+    }
+    const deniedResult = VerificationResultSchema.parse({
+        task_id: task.id,
+        verdict: "fail",
+        confidence: 1.0,
+        evidence: [
+            {
+                layer: "mechanical",
+                description: "Approval denied by human",
+                confidence: 1.0,
+            },
+        ],
+        dimension_updates: [],
+        timestamp: new Date().toISOString(),
+    });
+    return {
+        task,
+        verificationResult: deniedResult,
+        action: "approval_denied",
+    };
+}
+// ─── runPreExecutionChecks ───
+/**
+ * Run all pre-execution checks: ethics, capability, irreversible approval.
+ * Returns null if all passed, or a TaskCycleResult to return early.
+ */
+export async function runPreExecutionChecks(deps, task) {
+    // 3a. Ethics means check
+    if (deps.ethicsGate) {
+        const ethicsResult = await runEthicsCheck(deps.ethicsGate, deps.approvalFn, task);
+        if (ethicsResult !== null)
+            return ethicsResult;
+    }
+    // 3b. Capability check
+    if (deps.capabilityDetector) {
+        const capabilityResult = await runCapabilityCheck(deps.capabilityDetector, task);
+        if (capabilityResult !== null)
+            return capabilityResult;
+    }
+    // 3c. Check irreversible approval
+    const approvalResult = await runIrreversibleApprovalCheck(deps.checkIrreversibleApproval, task);
+    if (approvalResult !== null)
+        return approvalResult;
+    return null;
+}
+//# sourceMappingURL=task-approval.js.map

package/dist/execution/task-approval.js.map

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

package/dist/execution/task-execution-types.d.ts

@@ -0,0 +1,18 @@
+import type { Task, VerificationResult } from "../types/task.js";
+import type { CapabilityAcquisitionTask } from "../types/capability.js";
+/**
+ * Result produced by one full task cycle (generate → approve → execute → verify).
+ * Defined here (not in task-lifecycle.ts) to break the circular dependency between
+ * task-lifecycle.ts and task-approval.ts.
+ */
+export interface TaskCycleResult {
+    task: Task;
+    verificationResult: VerificationResult;
+    action: "completed" | "keep" | "discard" | "escalate" | "approval_denied" | "capability_acquiring";
+    acquisition_task?: CapabilityAcquisitionTask;
+}
+/**
+ * Creates a synthetic TaskCycleResult for a skipped (duplicate-detected) task.
+ */
+export declare function createSkippedTaskResult(goalId: string, targetDimension: string): TaskCycleResult;
+//# sourceMappingURL=task-execution-types.d.ts.map

package/dist/execution/task-execution-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-execution-types.d.ts","sourceRoot":"","sources":["../../src/execution/task-execution-types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,IAAI,CAAC;IACX,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,iBAAiB,GAAG,sBAAsB,CAAC;IACnG,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;CAC9C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,eAAe,CAIhG"}

package/dist/execution/task-execution-types.js

@@ -0,0 +1,10 @@
+import { TaskSchema, VerificationResultSchema } from "../types/task.js";
+/**
+ * Creates a synthetic TaskCycleResult for a skipped (duplicate-detected) task.
+ */
+export function createSkippedTaskResult(goalId, targetDimension) {
+    const skippedTask = TaskSchema.parse({ id: "skipped", goal_id: goalId, target_dimensions: [], primary_dimension: targetDimension, work_description: "skipped (duplicate)", rationale: "", approach: "", success_criteria: [], scope_boundary: { in_scope: [], out_of_scope: [], blast_radius: "" }, constraints: [], created_at: new Date().toISOString() });
+    const skippedVerification = VerificationResultSchema.parse({ task_id: "skipped", verdict: "fail", confidence: 0, evidence: [], dimension_updates: [], timestamp: new Date().toISOString() });
+    return { task: skippedTask, verificationResult: skippedVerification, action: "discard" };
+}
+//# sourceMappingURL=task-execution-types.js.map

package/dist/execution/task-execution-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-execution-types.js","sourceRoot":"","sources":["../../src/execution/task-execution-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAgBxE;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAc,EAAE,eAAuB;IAC7E,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,EAAE,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC7V,MAAM,mBAAmB,GAAG,wBAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC7L,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC3F,CAAC"}

package/dist/execution/task-executor.d.ts

@@ -0,0 +1,31 @@
+import type { Logger } from "../runtime/logger.js";
+import { StateManager } from "../state-manager.js";
+import { SessionManager } from "./session-manager.js";
+import type { AgentResult, IAdapter } from "./adapter-layer.js";
+import type { Task } from "../types/task.js";
+import type { Strategy } from "../types/strategy.js";
+export interface TaskExecutorDeps {
+    stateManager: StateManager;
+    sessionManager: SessionManager;
+    logger?: Logger;
+    execFileSyncFn: (cmd: string, args: string[], opts: {
+        cwd: string;
+        encoding: "utf-8";
+    }) => string;
+}
+export declare function durationToMs(duration: {
+    value: number;
+    unit: string;
+}): number;
+/**
+ * Execute a task via the given adapter.
+ *
+ * Creates a session, builds context, converts to AgentTask, executes
+ * via adapter, ends session, and updates task status based on result.
+ */
+export declare function executeTask(deps: TaskExecutorDeps, task: Task, adapter: IAdapter, workspaceContext?: string, activeStrategy?: Strategy): Promise<AgentResult>;
+/**
+ * Reload a task from disk (falls back to in-memory task if unavailable).
+ */
+export declare function reloadTaskFromDisk(stateManager: StateManager, task: Task): Promise<Task>;
+//# sourceMappingURL=task-executor.d.ts.map

package/dist/execution/task-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-executor.d.ts","sourceRoot":"","sources":["../../src/execution/task-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAa,WAAW,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAKrD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,CAAC;CACnG;AAID,wBAAgB,YAAY,CAAC,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAQ9E;AAID;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,QAAQ,EACjB,gBAAgB,CAAC,EAAE,MAAM,EACzB,cAAc,CAAC,EAAE,QAAQ,GACxB,OAAO,CAAC,WAAW,CAAC,CAsLtB;AAID;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9F"}

package/dist/execution/task-executor.js

@@ -0,0 +1,190 @@
+import { TaskSchema } from "../types/task.js";
+const DEBUG = process.env.PULSEED_DEBUG === "true";
+// ─── durationToMs ───
+export function durationToMs(duration) {
+    const multipliers = {
+        minutes: 60 * 1000,
+        hours: 60 * 60 * 1000,
+        days: 24 * 60 * 60 * 1000,
+        weeks: 7 * 24 * 60 * 60 * 1000,
+    };
+    return duration.value * (multipliers[duration.unit] ?? 60 * 60 * 1000);
+}
+// ─── executeTask ───
+/**
+ * Execute a task via the given adapter.
+ *
+ * Creates a session, builds context, converts to AgentTask, executes
+ * via adapter, ends session, and updates task status based on result.
+ */
+export async function executeTask(deps, task, adapter, workspaceContext, activeStrategy) {
+    const { stateManager, sessionManager, logger, execFileSyncFn } = deps;
+    // Create execution session
+    const session = await sessionManager.createSession("task_execution", task.goal_id, task.id);
+    // Build context
+    const contextSlots = sessionManager.buildTaskExecutionContext(task.goal_id, task.id);
+    // Convert to AgentTask
+    // If the adapter provides formatPrompt, delegate prompt construction to it.
+    // Otherwise use the default builder.
+    let prompt;
+    if (adapter.formatPrompt) {
+        prompt = adapter.formatPrompt(task, workspaceContext);
+    }
+    else {
+        // Build prompt with task description as primary content
+        const scopeConstraints = `\n\nSCOPE CONSTRAINTS (CRITICAL — violations will cause task failure):\n` +
+            `- ONLY modify files directly related to the task\n` +
+            `- Do NOT modify: config files (*.config.*, package.json, tsconfig.json), CI/CD files, build configuration, dependency files\n` +
+            `- Do NOT change function visibility (private→export) or imports in unrelated files\n` +
+            `- If a file contains the target pattern inside a string literal or template, leave it as-is`;
+        const contextSection = workspaceContext
+            ? `\n\nWORKSPACE CONTEXT (use these specific locations):\n${workspaceContext}`
+            : "";
+        const taskDescription = `You are an AI agent executing a task.\n\nTask: ${task.work_description}\n\nApproach: ${task.approach}\n\nSuccess Criteria:\n${task.success_criteria.map((c) => `- ${c.description}`).join("\n")}${scopeConstraints}${contextSection}`;
+        const contextContent = contextSlots
+            .filter((slot) => slot.content.trim().length > 0) // Skip empty slots
+            .sort((a, b) => a.priority - b.priority)
+            .map((slot) => `[${slot.label}]\n${slot.content}`)
+            .join("\n\n");
+        prompt = contextContent
+            ? `${taskDescription}\n\n--- Context ---\n${contextContent}`
+            : taskDescription;
+    }
+    const timeoutMs = task.estimated_duration
+        ? durationToMs(task.estimated_duration)
+        : 30 * 60 * 1000; // default 30 minutes
+    // Resolve allowed_tools from the active strategy (if any).
+    // If toolset_locked=true, the strategy must have allowed_tools defined — log a warning if not.
+    if (activeStrategy?.toolset_locked && !activeStrategy.allowed_tools?.length) {
+        logger?.warn(`[TaskExecutor] Strategy ${activeStrategy.id} has toolset_locked=true but no allowed_tools defined`, {
+            taskId: task.id,
+        });
+    }
+    const allowedTools = activeStrategy?.allowed_tools?.length ? activeStrategy.allowed_tools : undefined;
+    const agentTask = {
+        prompt,
+        timeout_ms: timeoutMs,
+        adapter_type: adapter.adapterType,
+        ...(allowedTools !== undefined ? { allowed_tools: allowedTools } : {}),
+    };
+    // Update task status to running
+    const runningTask = { ...task, status: "running", started_at: new Date().toISOString() };
+    await stateManager.writeRaw(`tasks/${task.goal_id}/${task.id}.json`, runningTask);
+    // Execute
+    let result;
+    try {
+        // Generic dedup check — any adapter may optionally implement checkDuplicate
+        if (adapter.checkDuplicate) {
+            try {
+                const isDuplicate = await adapter.checkDuplicate(agentTask);
+                if (isDuplicate) {
+                    // Return synthetic result — task already exists, skip execution
+                    result = {
+                        success: true,
+                        output: 'Skipped: duplicate task detected by adapter',
+                        error: null,
+                        exit_code: 0,
+                        elapsed_ms: 0,
+                        stopped_reason: 'completed',
+                    };
+                    // End session and update task status without calling adapter.execute
+                    const skipSummary = 'Task skipped: duplicate detected by adapter';
+                    await sessionManager.endSession(session.id, skipSummary);
+                    const skipNow = new Date().toISOString();
+                    const skippedTask = { ...runningTask, status: 'completed', completed_at: skipNow };
+                    await stateManager.writeRaw(`tasks/${task.goal_id}/${task.id}.json`, skippedTask);
+                    return result;
+                }
+            }
+            catch { /* non-fatal: proceed with execution if dedup check fails */ }
+        }
+        result = await adapter.execute(agentTask);
+    }
+    catch (err) {
+        result = {
+            success: false,
+            output: "",
+            error: err instanceof Error ? err.message : String(err),
+            exit_code: null,
+            elapsed_ms: 0,
+            stopped_reason: "error",
+        };
+    }
+    // Post-execution scope check: revert changes to protected files,
+    // and annotate result.filesChanged from the same git diff --name-only call.
+    if (result.success) {
+        try {
+            const diffOutput = execFileSyncFn("git", ["diff", "--name-only"], {
+                cwd: process.cwd(),
+                encoding: "utf-8",
+            }).trim();
+            const changedFiles = diffOutput ? diffOutput.split("\n") : [];
+            result.filesChanged = changedFiles.length > 0;
+            if (!result.filesChanged) {
+                logger?.warn("[TaskLifecycle] Adapter reported success but no files were modified", { taskId: task.id });
+            }
+            if (changedFiles.length > 0) {
+                const protectedPatterns = [
+                    /vitest\.config/,
+                    /jest\.config/,
+                    /tsconfig/,
+                    /package\.json$/,
+                    /package-lock\.json$/,
+                    /\.config\.(ts|js|mjs)$/,
+                ];
+                const protectedChanges = changedFiles.filter((f) => protectedPatterns.some((p) => p.test(f)));
+                if (protectedChanges.length > 0) {
+                    execFileSyncFn("git", ["checkout", "--", ...protectedChanges], {
+                        cwd: process.cwd(),
+                        encoding: "utf-8",
+                    });
+                    result.output = (result.output || "") +
+                        `\n[Scope Check] Reverted ${protectedChanges.length} protected file(s): ${protectedChanges.join(", ")}`;
+                }
+            }
+        }
+        catch {
+            // Non-fatal: scope check failure should not break execution
+        }
+    }
+    // End session
+    const summary = result.success
+        ? `Task completed successfully. Output length: ${result.output.length}`
+        : `Task failed: ${result.stopped_reason}. Error: ${result.error ?? "unknown"}`;
+    await sessionManager.endSession(session.id, summary);
+    // Update task status based on result
+    const now = new Date().toISOString();
+    let newStatus;
+    if (result.stopped_reason === "timeout") {
+        newStatus = "timed_out";
+    }
+    else if (result.stopped_reason === "error" || !result.success) {
+        newStatus = "error";
+    }
+    else {
+        newStatus = "completed";
+    }
+    const updatedTask = {
+        ...runningTask,
+        status: newStatus,
+        completed_at: now,
+        ...(newStatus === "timed_out" ? { timeout_at: now } : {}),
+        execution_output: result.output ? result.output.slice(0, 2000) : undefined,
+    };
+    await stateManager.writeRaw(`tasks/${task.goal_id}/${task.id}.json`, updatedTask);
+    return result;
+}
+// ─── reloadTaskFromDisk ───
+/**
+ * Reload a task from disk (falls back to in-memory task if unavailable).
+ */
+export async function reloadTaskFromDisk(stateManager, task) {
+    try {
+        const raw = await stateManager.readRaw(`tasks/${task.goal_id}/${task.id}.json`);
+        if (raw)
+            return TaskSchema.parse(raw);
+    }
+    catch { /* fall back to in-memory task */ }
+    return task;
+}
+//# sourceMappingURL=task-executor.js.map

package/dist/execution/task-executor.js.map

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

package/dist/execution/task-generation.d.ts

@@ -0,0 +1,154 @@
+import { z } from "zod";
+import type { Logger } from "../runtime/logger.js";
+import type { ILLMClient } from "../llm/llm-client.js";
+import { StateManager } from "../state-manager.js";
+import { StrategyManager } from "../strategy/strategy-manager.js";
+import type { Task } from "../types/task.js";
+import type { TaskGroup } from "../types/index.js";
+import type { KnowledgeManager } from "../knowledge/knowledge-manager.js";
+import type { IPromptGateway } from "../prompt/gateway.js";
+export declare const LLMGeneratedTaskSchema: z.ZodObject<{
+    work_description: z.ZodString;
+    rationale: z.ZodString;
+    approach: z.ZodString;
+    success_criteria: z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        verification_method: z.ZodString;
+        is_blocking: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        verification_method: string;
+        is_blocking: boolean;
+    }, {
+        description: string;
+        verification_method: string;
+        is_blocking?: boolean | undefined;
+    }>, "many">;
+    scope_boundary: z.ZodObject<{
+        in_scope: z.ZodArray<z.ZodString, "many">;
+        out_of_scope: z.ZodArray<z.ZodString, "many">;
+        blast_radius: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        in_scope: string[];
+        out_of_scope: string[];
+        blast_radius: string;
+    }, {
+        in_scope: string[];
+        out_of_scope: string[];
+        blast_radius: string;
+    }>;
+    constraints: z.ZodArray<z.ZodString, "many">;
+    reversibility: z.ZodDefault<z.ZodEnum<["reversible", "irreversible", "unknown"]>>;
+    intended_direction: z.ZodOptional<z.ZodEnum<["increase", "decrease", "neutral"]>>;
+    estimated_duration: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        value: z.ZodNumber;
+        unit: z.ZodEnum<["minutes", "hours", "days", "weeks"]>;
+    }, "strip", z.ZodTypeAny, {
+        value: number;
+        unit: "minutes" | "hours" | "days" | "weeks";
+    }, {
+        value: number;
+        unit: "minutes" | "hours" | "days" | "weeks";
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    constraints: string[];
+    work_description: string;
+    rationale: string;
+    approach: string;
+    success_criteria: {
+        description: string;
+        verification_method: string;
+        is_blocking: boolean;
+    }[];
+    scope_boundary: {
+        in_scope: string[];
+        out_of_scope: string[];
+        blast_radius: string;
+    };
+    estimated_duration: {
+        value: number;
+        unit: "minutes" | "hours" | "days" | "weeks";
+    } | null;
+    reversibility: "unknown" | "reversible" | "irreversible";
+    intended_direction?: "increase" | "decrease" | "neutral" | undefined;
+}, {
+    constraints: string[];
+    work_description: string;
+    rationale: string;
+    approach: string;
+    success_criteria: {
+        description: string;
+        verification_method: string;
+        is_blocking?: boolean | undefined;
+    }[];
+    scope_boundary: {
+        in_scope: string[];
+        out_of_scope: string[];
+        blast_radius: string;
+    };
+    estimated_duration?: {
+        value: number;
+        unit: "minutes" | "hours" | "days" | "weeks";
+    } | null | undefined;
+    reversibility?: "unknown" | "reversible" | "irreversible" | undefined;
+    intended_direction?: "increase" | "decrease" | "neutral" | undefined;
+}>;
+export interface TaskGenerationDeps {
+    stateManager: StateManager;
+    llmClient: ILLMClient;
+    strategyManager: StrategyManager;
+    logger?: Logger;
+    knowledgeManager?: KnowledgeManager;
+    /** Optional PromptGateway — when provided, LLM calls are routed through it */
+    gateway?: IPromptGateway;
+    memoryLifecycle?: {
+        selectForWorkingMemory(goalId: string, dims: string[], tags: string[], max?: number): Promise<{
+            shortTerm: unknown[];
+            lessons: Array<{
+                type?: string;
+                lesson?: string;
+                content?: string;
+                relevance_tags?: string[];
+            }>;
+        }>;
+    };
+}
+/**
+ * Evaluate the complexity of a task to determine pipeline requirements.
+ *
+ * Rules (from design doc §4):
+ * - Small: single file target, simple description (no "and" conjunctions, < 50 chars)
+ * - Medium: single file but complex description (6+ expected line changes)
+ * - Large: multiple file targets OR "and" in description OR explicit multi-file indicators
+ */
+export declare function evaluateTaskComplexity(task: Task): "small" | "medium" | "large";
+/**
+ * Compute Jaccard similarity between character trigram sets of two strings.
+ * Returns a value in [0, 1]. Higher means more similar.
+ */
+export declare function trigramSimilarity(a: string, b: string): number;
+/**
+ * Generate a task for the given goal and target dimension via LLM.
+ *
+ * @param deps - dependencies (stateManager, llmClient, strategyManager, logger)
+ * @param goalId - the goal this task belongs to
+ * @param targetDimension - the dimension this task should improve
+ * @param strategyId - optional override; if not provided, uses active strategy
+ * @returns the generated and persisted Task, or null if duplicate detected
+ */
+export declare function generateTask(deps: TaskGenerationDeps, goalId: string, targetDimension: string, strategyId?: string, knowledgeContext?: string, adapterType?: string, existingTasks?: string[], workspaceContext?: string): Promise<Task | null>;
+/**
+ * Ask the LLM to decompose a complex task into a TaskGroup of subtasks.
+ *
+ * @returns TaskGroup on success, null on parse failure
+ */
+export declare function generateTaskGroup(llmClient: ILLMClient, context: {
+    goalDescription: string;
+    targetDimension: string;
+    currentState: string;
+    gap: number;
+    availableAdapters: string[];
+    contextBlock?: string;
+    goalId?: string;
+}, logger?: Logger, gateway?: IPromptGateway): Promise<TaskGroup | null>;
+//# sourceMappingURL=task-generation.d.ts.map

package/dist/execution/task-generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-generation.d.ts","sourceRoot":"","sources":["../../src/execution/task-generation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAInD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BjC,CAAC;AAIH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,UAAU,CAAC;IACtB,eAAe,EAAE,eAAe,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,eAAe,CAAC,EAAE;QAChB,sBAAsB,CACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;YAAE,SAAS,EAAE,OAAO,EAAE,CAAC;YAAC,OAAO,EAAE,KAAK,CAAC;gBAAE,IAAI,CAAC,EAAE,MAAM,CAAC;gBAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC,CAAC;KACvI,CAAC;CACH;AAID;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAgB/E;AA0BD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAuB9D;AAmDD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,EACvB,UAAU,CAAC,EAAE,MAAM,EACnB,gBAAgB,CAAC,EAAE,MAAM,EACzB,WAAW,CAAC,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,MAAM,EAAE,EACxB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CA2JtB;AAkCD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE;IACP,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,EACD,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAqI3B"}