conatus 0.1.0

package/dist/strategy-template-registry.d.ts

@@ -0,0 +1,80 @@
+import type { ILLMClient } from "./llm/llm-client.js";
+import type { IEmbeddingClient } from "./embedding-client.js";
+import { VectorIndex } from "./vector-index.js";
+import type { StrategyTemplate, EmbeddingRecommendation, HybridRecommendation } from "./types/cross-portfolio.js";
+import type { Strategy } from "./types/strategy.js";
+/**
+ * StrategyTemplateRegistry manages successful strategy templates for cross-goal reuse.
+ *
+ * It stores templates derived from completed strategies, generates semantic embeddings
+ * for semantic search, and can adapt templates to new goal contexts.
+ *
+ * Persistence: {basePath}/strategy-templates.json
+ */
+export declare class StrategyTemplateRegistry {
+    private readonly llmClient;
+    private readonly vectorIndex;
+    private readonly embeddingClient;
+    private readonly basePath;
+    private readonly templates;
+    private readonly persistPath;
+    constructor(llmClient: ILLMClient, vectorIndex: VectorIndex, embeddingClient: IEmbeddingClient, basePath: string);
+    /**
+     * Register a completed, effective strategy as a reusable template.
+     * Preconditions: strategy.state === "completed" AND effectiveness_score >= 0.5
+     */
+    registerTemplate(strategy: Strategy, goalId: string): Promise<StrategyTemplate>;
+    /**
+     * Search templates by semantic similarity.
+     * Optionally filter by domain tags (at least one tag must overlap).
+     */
+    searchTemplates(query: string, limit?: number, domainTags?: string[]): Promise<StrategyTemplate[]>;
+    /**
+     * Adapt a template to a new goal context, generating a concrete Strategy.
+     * The caller is responsible for persisting the returned Strategy.
+     */
+    applyTemplate(templateId: string, goalId: string, goalContext: string): Promise<Strategy>;
+    /**
+     * Index all registered templates into a VectorIndex using the provided embedding client.
+     * Each template's hypothesis_pattern is embedded and stored with its template_id as metadata.
+     * Call this once after loading templates to enable recommendByEmbedding() / recommendHybrid().
+     */
+    indexTemplates(embeddingClient: IEmbeddingClient, vectorIndex: VectorIndex): Promise<void>;
+    /**
+     * Recommend templates for a goal description using semantic embedding similarity.
+     * Searches the provided VectorIndex for the top-K closest templates.
+     * Returns EmbeddingRecommendation[] sorted by similarity descending.
+     */
+    recommendByEmbedding(goalDescription: string, embeddingClient: IEmbeddingClient, vectorIndex: VectorIndex, topK?: number): Promise<EmbeddingRecommendation[]>;
+    /**
+     * Hybrid recommendation combining tag-based matching with embedding similarity.
+     * tagScore: fraction of goal tags that overlap with template domain_tags (0 if no tags supplied).
+     * embeddingScore: cosine similarity from VectorIndex.
+     * combinedScore: tagWeight * tagScore + embeddingWeight * embeddingScore (default 0.4 / 0.6).
+     * Returns HybridRecommendation[] sorted by combinedScore descending.
+     */
+    recommendHybrid(goalDescription: string, goalTags: string[], embeddingClient: IEmbeddingClient, vectorIndex: VectorIndex, options?: {
+        tagWeight?: number;
+        embeddingWeight?: number;
+        topK?: number;
+    }): Promise<HybridRecommendation[]>;
+    /**
+     * Persist all templates to JSON file (atomic write).
+     */
+    save(): Promise<void>;
+    /**
+     * Load templates from JSON file.
+     * Silently succeeds if the file does not exist.
+     */
+    load(): Promise<void>;
+    /**
+     * Return the number of templates currently in the registry.
+     */
+    get size(): number;
+    /**
+     * Retrieve a template by ID. Returns undefined if not found.
+     */
+    getTemplate(templateId: string): StrategyTemplate | undefined;
+    private _findTemplateByEmbeddingId;
+}
+//# sourceMappingURL=strategy-template-registry.d.ts.map

package/dist/strategy-template-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-template-registry.d.ts","sourceRoot":"","sources":["../src/strategy-template-registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAwBpD;;;;;;;GAOG;AACH,qBAAa,wBAAwB;IAKjC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAP3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;IACtE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAGlB,SAAS,EAAE,UAAU,EACrB,WAAW,EAAE,WAAW,EACxB,eAAe,EAAE,gBAAgB,EACjC,QAAQ,EAAE,MAAM;IAKnC;;;OAGG;IACG,gBAAgB,CACpB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC;IAsE5B;;;OAGG;IACG,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAU,EACjB,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAuC9B;;;OAGG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,QAAQ,CAAC;IAyDpB;;;;OAIG;IACG,cAAc,CAClB,eAAe,EAAE,gBAAgB,EACjC,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,IAAI,CAAC;IAUhB;;;;OAIG;IACG,oBAAoB,CACxB,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,gBAAgB,EACjC,WAAW,EAAE,WAAW,EACxB,IAAI,GAAE,MAAU,GACf,OAAO,CAAC,uBAAuB,EAAE,CAAC;IA4BrC;;;;;;OAMG;IACG,eAAe,CACnB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,EAAE,EAClB,eAAe,EAAE,gBAAgB,EACjC,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAC5E,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAsDlC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAM7D,OAAO,CAAC,0BAA0B;CAUnC"}

package/dist/strategy-template-registry.js

@@ -0,0 +1,320 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { z } from "zod";
+import { StrategyTemplateSchema } from "./types/cross-portfolio.js";
+import { StrategySchema } from "./types/strategy.js";
+// ─── LLM Response Schemas ───
+const GeneralizeHypothesisResponseSchema = z.object({
+    hypothesis_pattern: z.string(),
+    domain_tags: z.array(z.string()),
+    applicable_dimensions: z.array(z.string()),
+});
+const AdaptTemplateResponseSchema = z.object({
+    hypothesis: z.string(),
+    target_dimensions: z.array(z.string()),
+    expected_effect: z.array(z.object({
+        dimension: z.string(),
+        direction: z.enum(["increase", "decrease"]),
+        magnitude: z.enum(["small", "medium", "large"]),
+    })),
+});
+// ─── StrategyTemplateRegistry ───
+/**
+ * StrategyTemplateRegistry manages successful strategy templates for cross-goal reuse.
+ *
+ * It stores templates derived from completed strategies, generates semantic embeddings
+ * for semantic search, and can adapt templates to new goal contexts.
+ *
+ * Persistence: {basePath}/strategy-templates.json
+ */
+export class StrategyTemplateRegistry {
+    llmClient;
+    vectorIndex;
+    embeddingClient;
+    basePath;
+    templates = new Map();
+    persistPath;
+    constructor(llmClient, vectorIndex, embeddingClient, basePath) {
+        this.llmClient = llmClient;
+        this.vectorIndex = vectorIndex;
+        this.embeddingClient = embeddingClient;
+        this.basePath = basePath;
+        this.persistPath = path.join(basePath, "strategy-templates.json");
+    }
+    /**
+     * Register a completed, effective strategy as a reusable template.
+     * Preconditions: strategy.state === "completed" AND effectiveness_score >= 0.5
+     */
+    async registerTemplate(strategy, goalId) {
+        if (strategy.state !== "completed") {
+            throw new Error(`Cannot register template: strategy state is "${strategy.state}", expected "completed"`);
+        }
+        if (strategy.effectiveness_score === null ||
+            strategy.effectiveness_score < 0.5) {
+            throw new Error(`Cannot register template: effectiveness_score is ${strategy.effectiveness_score ?? "null"}, must be >= 0.5`);
+        }
+        // Ask LLM to generalize the hypothesis into a reusable pattern
+        const generalizePrompt = [
+            "Generalize this successful strategy hypothesis into a reusable pattern.",
+            "Remove domain-specific details and keep the core approach.",
+            "",
+            `Hypothesis: ${strategy.hypothesis}`,
+            `Target dimensions: ${strategy.target_dimensions.join(", ")}`,
+            `Expected effects: ${JSON.stringify(strategy.expected_effect)}`,
+            "",
+            'Output JSON: { "hypothesis_pattern": string, "domain_tags": string[], "applicable_dimensions": string[] }',
+        ].join("\n");
+        const llmResponse = await this.llmClient.sendMessage([
+            { role: "user", content: generalizePrompt },
+        ]);
+        const generalized = this.llmClient.parseJSON(llmResponse.content, GeneralizeHypothesisResponseSchema);
+        // Generate embedding from the generalized hypothesis_pattern
+        const vector = await this.embeddingClient.embed(generalized.hypothesis_pattern);
+        // Create a VectorIndex entry for semantic search
+        const embeddingId = `tmpl-emb-${crypto.randomUUID()}`;
+        await this.vectorIndex.add(embeddingId, generalized.hypothesis_pattern, {
+            template_type: "strategy-template",
+            domain_tags: generalized.domain_tags,
+            applicable_dimensions: generalized.applicable_dimensions,
+            source_goal_id: goalId,
+            source_strategy_id: strategy.id,
+        });
+        // Create the StrategyTemplate object
+        const template = StrategyTemplateSchema.parse({
+            template_id: `tmpl-${crypto.randomUUID()}`,
+            source_goal_id: goalId,
+            source_strategy_id: strategy.id,
+            hypothesis_pattern: generalized.hypothesis_pattern,
+            domain_tags: generalized.domain_tags,
+            effectiveness_score: strategy.effectiveness_score,
+            applicable_dimensions: generalized.applicable_dimensions,
+            embedding_id: embeddingId,
+            created_at: new Date().toISOString(),
+        });
+        this.templates.set(template.template_id, template);
+        await this.save();
+        return template;
+    }
+    /**
+     * Search templates by semantic similarity.
+     * Optionally filter by domain tags (at least one tag must overlap).
+     */
+    async searchTemplates(query, limit = 5, domainTags) {
+        if (this.templates.size === 0) {
+            return [];
+        }
+        // Generate embedding for query and search VectorIndex
+        const queryVector = await this.embeddingClient.embed(query);
+        const searchResults = this.vectorIndex.searchByVector(queryVector, this.templates.size // fetch all, we'll slice after filtering
+        );
+        // Map results to StrategyTemplate objects, filtering by domain tags if needed
+        const matched = [];
+        for (const result of searchResults) {
+            // Each VectorIndex entry has the embeddingId as its id
+            // Find the template that references this embeddingId
+            const template = this._findTemplateByEmbeddingId(result.id);
+            if (!template)
+                continue;
+            // Filter by domain tags if specified
+            if (domainTags && domainTags.length > 0) {
+                const overlap = template.domain_tags.some((tag) => domainTags.includes(tag));
+                if (!overlap)
+                    continue;
+            }
+            matched.push({ template, similarity: result.similarity });
+        }
+        // Sort by similarity descending (searchByVector already sorts, but re-sort after filtering)
+        matched.sort((a, b) => b.similarity - a.similarity);
+        return matched.slice(0, limit).map((m) => m.template);
+    }
+    /**
+     * Adapt a template to a new goal context, generating a concrete Strategy.
+     * The caller is responsible for persisting the returned Strategy.
+     */
+    async applyTemplate(templateId, goalId, goalContext) {
+        const template = this.templates.get(templateId);
+        if (!template) {
+            throw new Error(`Template not found: ${templateId}`);
+        }
+        // Ask LLM to adapt the template to the new goal context
+        const adaptPrompt = [
+            "Adapt this strategy template to the following goal context.",
+            "Create a concrete strategy hypothesis.",
+            "",
+            `Template hypothesis pattern: ${template.hypothesis_pattern}`,
+            `Applicable dimensions: ${template.applicable_dimensions.join(", ")}`,
+            `Goal context: ${goalContext}`,
+            "",
+            'Output JSON: { "hypothesis": string, "target_dimensions": string[], "expected_effect": Array<{ "dimension": string, "direction": "increase"|"decrease", "magnitude": "small"|"medium"|"large" }> }',
+        ].join("\n");
+        const llmResponse = await this.llmClient.sendMessage([
+            { role: "user", content: adaptPrompt },
+        ]);
+        const adapted = this.llmClient.parseJSON(llmResponse.content, AdaptTemplateResponseSchema);
+        // Create a new Strategy object
+        const now = new Date().toISOString();
+        const strategy = StrategySchema.parse({
+            id: `strat-${crypto.randomUUID()}`,
+            goal_id: goalId,
+            target_dimensions: adapted.target_dimensions,
+            primary_dimension: adapted.target_dimensions[0] ?? "default",
+            hypothesis: adapted.hypothesis,
+            expected_effect: adapted.expected_effect,
+            resource_estimate: {
+                sessions: 1,
+                duration: { unit: "hours", value: 1 },
+                llm_calls: null,
+            },
+            state: "candidate",
+            allocation: 0,
+            created_at: now,
+            started_at: null,
+            completed_at: null,
+            gap_snapshot_at_start: null,
+            tasks_generated: [],
+            effectiveness_score: null,
+            consecutive_stall_count: 0,
+            source_template_id: templateId,
+            cross_goal_context: goalContext,
+        });
+        return strategy;
+    }
+    /**
+     * Index all registered templates into a VectorIndex using the provided embedding client.
+     * Each template's hypothesis_pattern is embedded and stored with its template_id as metadata.
+     * Call this once after loading templates to enable recommendByEmbedding() / recommendHybrid().
+     */
+    async indexTemplates(embeddingClient, vectorIndex) {
+        for (const template of this.templates.values()) {
+            const indexId = `idx-${template.template_id}`;
+            await vectorIndex.add(indexId, template.hypothesis_pattern, {
+                template_id: template.template_id,
+                domain_tags: template.domain_tags,
+            });
+        }
+    }
+    /**
+     * Recommend templates for a goal description using semantic embedding similarity.
+     * Searches the provided VectorIndex for the top-K closest templates.
+     * Returns EmbeddingRecommendation[] sorted by similarity descending.
+     */
+    async recommendByEmbedding(goalDescription, embeddingClient, vectorIndex, topK = 5) {
+        if (this.templates.size === 0) {
+            return [];
+        }
+        const queryVector = await embeddingClient.embed(goalDescription);
+        const searchResults = vectorIndex.searchByVector(queryVector, topK);
+        const recommendations = [];
+        for (const result of searchResults) {
+            // Each indexed entry stores template_id in metadata
+            const templateId = result.metadata?.["template_id"];
+            if (!templateId)
+                continue;
+            const template = this.templates.get(templateId);
+            if (!template)
+                continue;
+            recommendations.push({
+                templateId,
+                similarity: result.similarity,
+                matchReason: `Semantic similarity to hypothesis pattern: "${template.hypothesis_pattern}"`,
+            });
+        }
+        return recommendations;
+    }
+    /**
+     * Hybrid recommendation combining tag-based matching with embedding similarity.
+     * tagScore: fraction of goal tags that overlap with template domain_tags (0 if no tags supplied).
+     * embeddingScore: cosine similarity from VectorIndex.
+     * combinedScore: tagWeight * tagScore + embeddingWeight * embeddingScore (default 0.4 / 0.6).
+     * Returns HybridRecommendation[] sorted by combinedScore descending.
+     */
+    async recommendHybrid(goalDescription, goalTags, embeddingClient, vectorIndex, options = {}) {
+        const { tagWeight = 0.4, embeddingWeight = 0.6, topK = 5, } = options;
+        if (this.templates.size === 0) {
+            return [];
+        }
+        // Get embedding scores for all templates (fetch all, we slice after combining)
+        const queryVector = await embeddingClient.embed(goalDescription);
+        const searchResults = vectorIndex.searchByVector(queryVector, this.templates.size);
+        // Build a lookup from templateId → embedding similarity
+        const embeddingMap = new Map();
+        for (const result of searchResults) {
+            const templateId = result.metadata?.["template_id"];
+            if (templateId) {
+                embeddingMap.set(templateId, result.similarity);
+            }
+        }
+        const hybrid = [];
+        for (const template of this.templates.values()) {
+            // Tag score: fraction of goal tags present in template domain_tags
+            let tagScore = 0;
+            if (goalTags.length > 0 && template.domain_tags.length > 0) {
+                const matchCount = goalTags.filter((t) => template.domain_tags.includes(t)).length;
+                tagScore = matchCount / goalTags.length;
+            }
+            const embeddingScore = embeddingMap.get(template.template_id) ?? 0;
+            const combinedScore = tagWeight * tagScore + embeddingWeight * embeddingScore;
+            hybrid.push({
+                templateId: template.template_id,
+                tagScore,
+                embeddingScore,
+                combinedScore,
+            });
+        }
+        hybrid.sort((a, b) => b.combinedScore - a.combinedScore);
+        return hybrid.slice(0, topK);
+    }
+    /**
+     * Persist all templates to JSON file (atomic write).
+     */
+    async save() {
+        const dir = path.dirname(this.persistPath);
+        fs.mkdirSync(dir, { recursive: true });
+        const data = JSON.stringify(Array.from(this.templates.values()), null, 2);
+        const tmpPath = `${this.persistPath}.tmp`;
+        fs.writeFileSync(tmpPath, data, "utf-8");
+        fs.renameSync(tmpPath, this.persistPath);
+    }
+    /**
+     * Load templates from JSON file.
+     * Silently succeeds if the file does not exist.
+     */
+    async load() {
+        if (!fs.existsSync(this.persistPath))
+            return;
+        try {
+            const raw = fs.readFileSync(this.persistPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            this.templates.clear();
+            for (const item of parsed) {
+                const template = StrategyTemplateSchema.parse(item);
+                this.templates.set(template.template_id, template);
+            }
+        }
+        catch {
+            // Corrupt or empty file — start fresh
+        }
+    }
+    /**
+     * Return the number of templates currently in the registry.
+     */
+    get size() {
+        return this.templates.size;
+    }
+    /**
+     * Retrieve a template by ID. Returns undefined if not found.
+     */
+    getTemplate(templateId) {
+        return this.templates.get(templateId);
+    }
+    // ─── Private Helpers ───
+    _findTemplateByEmbeddingId(embeddingId) {
+        for (const template of this.templates.values()) {
+            if (template.embedding_id === embeddingId) {
+                return template;
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=strategy-template-registry.js.map

package/dist/strategy-template-registry.js.map

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

package/dist/task-lifecycle.d.ts

@@ -0,0 +1,167 @@
+import type { Logger } from "./runtime/logger.js";
+import { StateManager } from "./state-manager.js";
+import type { ILLMClient } from "./llm/llm-client.js";
+import { SessionManager } from "./session-manager.js";
+import { TrustManager } from "./traits/trust-manager.js";
+import { StrategyManager } from "./strategy-manager.js";
+import { StallDetector } from "./drive/stall-detector.js";
+import type { Task, VerificationResult } from "./types/task.js";
+import type { GapVector } from "./types/gap.js";
+import type { DriveContext } from "./types/drive.js";
+import type { EthicsGate } from "./traits/ethics-gate.js";
+import type { CapabilityDetector } from "./capability-detector.js";
+import type { CapabilityAcquisitionTask } from "./types/capability.js";
+import type { AgentTask, AgentResult, IAdapter } from "./adapter-layer.js";
+import { AdapterRegistry } from "./adapter-layer.js";
+export type { AgentTask, AgentResult, IAdapter };
+export { AdapterRegistry };
+export interface ExecutorReport {
+    completed: boolean;
+    summary: string;
+    partial_results: string[];
+    blockers: string[];
+}
+export interface TaskCycleResult {
+    task: Task;
+    verificationResult: VerificationResult;
+    action: "completed" | "keep" | "discard" | "escalate" | "approval_denied" | "capability_acquiring";
+    acquisition_task?: CapabilityAcquisitionTask;
+}
+export interface VerdictResult {
+    action: "completed" | "keep" | "discard" | "escalate";
+    task: Task;
+}
+export interface FailureResult {
+    action: "keep" | "discard" | "escalate";
+    task: Task;
+}
+/**
+ * TaskLifecycle manages the full lifecycle of tasks:
+ * select target dimension -> generate task -> approval check -> execute -> verify -> handle verdict.
+ */
+export declare class TaskLifecycle {
+    private readonly stateManager;
+    private readonly llmClient;
+    private readonly sessionManager;
+    private readonly trustManager;
+    private readonly strategyManager;
+    private readonly stallDetector;
+    private readonly approvalFn;
+    private readonly ethicsGate?;
+    private readonly capabilityDetector?;
+    private readonly logger?;
+    private readonly adapterRegistry?;
+    private readonly healthCheckEnabled;
+    private readonly execFileSyncFn;
+    private onTaskComplete?;
+    constructor(stateManager: StateManager, llmClient: ILLMClient, sessionManager: SessionManager, trustManager: TrustManager, strategyManager: StrategyManager, stallDetector: StallDetector, options?: {
+        approvalFn?: (task: Task) => Promise<boolean>;
+        ethicsGate?: EthicsGate;
+        capabilityDetector?: CapabilityDetector;
+        logger?: Logger;
+        /** Optional adapter registry for L1 mechanical verification command execution */
+        adapterRegistry?: AdapterRegistry;
+        /** Enable post-execution build/test health check (disabled by default) */
+        healthCheckEnabled?: boolean;
+        /** Injectable execFileSync for testing (defaults to node:child_process execFileSync) */
+        execFileSyncFn?: (cmd: string, args: string[], opts: {
+            cwd: string;
+            encoding: "utf-8";
+        }) => string;
+    });
+    /**
+     * Register a callback to be invoked when a task completes successfully.
+     * Used by PortfolioManager to track task completion times per strategy.
+     */
+    setOnTaskComplete(callback: (strategyId: string) => void): void;
+    /**
+     * Select the highest-priority dimension to work on based on drive scoring.
+     *
+     * @param gapVector - current gap state for the goal
+     * @param driveContext - per-dimension timing/deadline/opportunity context
+     * @returns the name of the top-ranked dimension
+     * @throws if gapVector has no gaps (empty)
+     */
+    selectTargetDimension(gapVector: GapVector, driveContext: DriveContext): string;
+    /**
+     * Generate a task for the given goal and target dimension via LLM.
+     *
+     * @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
+     */
+    generateTask(goalId: string, targetDimension: string, strategyId?: string, knowledgeContext?: string, adapterType?: string, existingTasks?: string[], workspaceContext?: string): Promise<Task>;
+    /**
+     * Check whether the task requires human approval and, if so, request it.
+     *
+     * @param task - the task to check
+     * @param confidence - observation confidence for the approval check (default 0.5)
+     * @returns true if approved or approval not needed; false if approval was denied
+     */
+    checkIrreversibleApproval(task: Task, confidence?: number): Promise<boolean>;
+    /**
+     * 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.
+     */
+    executeTask(task: Task, adapter: IAdapter): Promise<AgentResult>;
+    /**
+     * Verify task execution results using 3-layer verification.
+     *
+     * Layer 1: Mechanical verification (via adapter in review session)
+     * Layer 2: LLM task reviewer (independent, no self-report)
+     * Layer 3: Executor self-report (reference only)
+     *
+     * Contradiction resolution:
+     * - L1 PASS + L2 PASS → pass
+     * - L1 PASS + L2 FAIL → re-review; if still FAIL → fail
+     * - L1 FAIL + L2 PASS → fail (mechanical priority)
+     * - L1 FAIL + L2 FAIL → fail
+     * - L1 SKIP → use L2 only (lower confidence)
+     */
+    verifyTask(task: Task, executionResult: AgentResult): Promise<VerificationResult>;
+    /**
+     * Handle a verification verdict (pass/partial/fail).
+     */
+    handleVerdict(task: Task, verificationResult: VerificationResult): Promise<VerdictResult>;
+    /**
+     * Handle a task failure: increment failure count, record failure,
+     * decide keep/discard/escalate.
+     */
+    handleFailure(task: Task, verificationResult: VerificationResult): Promise<FailureResult>;
+    /**
+     * Run a full task cycle: select → generate → approve → execute → verify → verdict.
+     */
+    runTaskCycle(goalId: string, gapVector: GapVector, driveContext: DriveContext, adapter: IAdapter, knowledgeContext?: string, existingTasks?: string[], workspaceContext?: string): Promise<TaskCycleResult>;
+    private buildTaskGenerationPrompt;
+    private runMechanicalVerification;
+    private runLLMReview;
+    private parseExecutorReport;
+    private isDirectionCorrect;
+    private attemptRevert;
+    private setDimensionIntegrity;
+    private appendTaskHistory;
+    private durationToMs;
+    /**
+     * Run build and test checks after successful task execution to verify
+     * the codebase remains healthy. Opt-in via healthCheckEnabled constructor option.
+     */
+    runPostExecutionHealthCheck(_adapter: IAdapter, _task: Task): Promise<{
+        healthy: boolean;
+        output: string;
+    }>;
+    /**
+     * Run a shell command safely using execFile (not exec) to avoid shell injection.
+     */
+    runShellCommand(argv: string[], options: {
+        timeout: number;
+        cwd: string;
+    }): Promise<{
+        success: boolean;
+        stdout: string;
+        stderr: string;
+    }>;
+}
+//# sourceMappingURL=task-lifecycle.d.ts.map

package/dist/task-lifecycle.d.ts.map

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