@thoughtflow/core 0.1.2

package/dist/libs/task-board.class.js

@@ -0,0 +1,245 @@
+"use strict";
+/**
+ * TaskBoard — Phase 3
+ *
+ * Persistent task lifecycle management with dependency awareness.
+ * Tasks link to KnowledgeGraph nodes for traceability.
+ *
+ * Features:
+ *   - Full task CRUD with typed properties
+ *   - Status transitions with validation
+ *   - Dependency-aware scheduling (can't start blocked tasks)
+ *   - Query by status, type, assignee, priority
+ *   - Transition history
+ *   - Statistics
+ *
+ * Backed by IStorageAdapter. Default: InMemoryAdapter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskBoard = void 0;
+const in_memory_adapter_1 = require("../storage/in-memory.adapter");
+const task_board_types_1 = require("../contracts/task-board.types");
+// ── Allowed transitions ─────────────────────────────────────────────────────
+const ALLOWED_TRANSITIONS = {
+    [task_board_types_1.BoardTaskStatus.DRAFT]: [task_board_types_1.BoardTaskStatus.PLANNED, task_board_types_1.BoardTaskStatus.CANCELLED],
+    [task_board_types_1.BoardTaskStatus.PLANNED]: [task_board_types_1.BoardTaskStatus.IN_PROGRESS, task_board_types_1.BoardTaskStatus.BLOCKED, task_board_types_1.BoardTaskStatus.CANCELLED],
+    [task_board_types_1.BoardTaskStatus.IN_PROGRESS]: [task_board_types_1.BoardTaskStatus.REVIEW, task_board_types_1.BoardTaskStatus.BLOCKED, task_board_types_1.BoardTaskStatus.CANCELLED],
+    [task_board_types_1.BoardTaskStatus.REVIEW]: [task_board_types_1.BoardTaskStatus.DONE, task_board_types_1.BoardTaskStatus.IN_PROGRESS, task_board_types_1.BoardTaskStatus.CANCELLED],
+    [task_board_types_1.BoardTaskStatus.BLOCKED]: [task_board_types_1.BoardTaskStatus.PLANNED, task_board_types_1.BoardTaskStatus.IN_PROGRESS, task_board_types_1.BoardTaskStatus.CANCELLED],
+    [task_board_types_1.BoardTaskStatus.DONE]: [],
+    [task_board_types_1.BoardTaskStatus.CANCELLED]: [],
+};
+// ── TaskBoard ───────────────────────────────────────────────────────────────
+class TaskBoard {
+    tasks;
+    transitions = [];
+    constructor(adapter) {
+        this.tasks = adapter ?? new in_memory_adapter_1.InMemoryAdapter();
+    }
+    // ── CRUD ──────────────────────────────────────────────────────────────
+    async createTask(input) {
+        const now = new Date().toISOString();
+        return this.tasks.create({
+            title: input.title,
+            description: input.description,
+            type: input.type,
+            status: task_board_types_1.BoardTaskStatus.DRAFT,
+            priority: input.priority,
+            assignee: input.assignee,
+            dependsOn: input.dependsOn ?? [],
+            relatedNodes: input.relatedNodes ?? [],
+            acceptanceCriteria: input.acceptanceCriteria ?? [],
+            touchedFiles: input.touchedFiles ?? [],
+            effort: input.effort,
+            metadata: input.metadata,
+            createdAt: now,
+            updatedAt: now,
+        });
+    }
+    async getTask(id) {
+        return this.tasks.read(id);
+    }
+    async updateTask(id, patch) {
+        return this.tasks.update(id, {
+            ...patch,
+            updatedAt: new Date().toISOString(),
+        });
+    }
+    async removeTask(id) {
+        await this.tasks.delete(id);
+    }
+    // ── Status transitions ────────────────────────────────────────────────
+    async transition(taskId, toStatus, reason) {
+        const task = await this.tasks.read(taskId);
+        if (!task)
+            throw new Error(`TaskBoard: task '${taskId}' not found`);
+        console.log(`[TaskBoard] Transitioning task ${taskId}`);
+        console.log(`  Current status: ${task.status}`);
+        console.log(`  Target status: ${toStatus}`);
+        console.log(`  Reason: ${reason || 'none'}`);
+        const allowed = ALLOWED_TRANSITIONS[task.status];
+        if (!allowed?.includes(toStatus)) {
+            throw new Error(`TaskBoard: invalid transition '${task.status}' → '${toStatus}' for task '${taskId}'`);
+        }
+        console.log(`[TaskBoard] ✓ Transition allowed`);
+        // Check dependencies when moving to IN_PROGRESS
+        if (toStatus === task_board_types_1.BoardTaskStatus.IN_PROGRESS) {
+            const blockers = await this.getBlockingDependencies(taskId);
+            if (blockers.length > 0) {
+                const blockerTitles = blockers.map((b) => b.title).join(", ");
+                throw new Error(`TaskBoard: task '${taskId}' blocked by unfinished dependencies: ${blockerTitles}`);
+            }
+        }
+        const now = new Date().toISOString();
+        const updates = {
+            status: toStatus,
+            statusReason: reason,
+            updatedAt: now,
+        };
+        if (toStatus === task_board_types_1.BoardTaskStatus.IN_PROGRESS && !task.startedAt) {
+            updates.startedAt = now;
+        }
+        if (toStatus === task_board_types_1.BoardTaskStatus.DONE || toStatus === task_board_types_1.BoardTaskStatus.CANCELLED) {
+            updates.completedAt = now;
+        }
+        this.transitions.push({
+            taskId,
+            fromStatus: task.status,
+            toStatus,
+            reason,
+            at: now,
+        });
+        const updatedTask = await this.tasks.update(taskId, updates);
+        console.log(`[TaskBoard] ✓ Task ${taskId} now ${toStatus}\n`);
+        return updatedTask;
+    }
+    // ── Dependency management ─────────────────────────────────────────────
+    /**
+     * Returns dependencies that are NOT yet DONE or CANCELLED.
+     */
+    async getBlockingDependencies(taskId) {
+        const task = await this.tasks.read(taskId);
+        if (!task)
+            return [];
+        const blockers = [];
+        for (const depId of task.dependsOn) {
+            const dep = await this.tasks.read(depId);
+            if (dep && dep.status !== task_board_types_1.BoardTaskStatus.DONE && dep.status !== task_board_types_1.BoardTaskStatus.CANCELLED) {
+                blockers.push(dep);
+            }
+        }
+        return blockers;
+    }
+    /**
+     * Get tasks that are ready to start (PLANNED + all dependencies DONE).
+     */
+    async getReadyTasks() {
+        const planned = await this.queryTasks({ statuses: [task_board_types_1.BoardTaskStatus.PLANNED] });
+        const ready = [];
+        console.log(`[TaskBoard] Checking ${planned.length} PLANNED tasks for readiness...`);
+        for (const task of planned) {
+            const blockers = await this.getBlockingDependencies(task.id);
+            if (blockers.length === 0) {
+                console.log(`[TaskBoard] ✓ Task ${task.id} (${task.title}) is READY`);
+                ready.push(task);
+            }
+            else {
+                const blockerTitles = blockers.map((b) => b.title).join(", ");
+                console.log(`[TaskBoard] ✗ Task ${task.id} (${task.title}) blocked by: ${blockerTitles}`);
+            }
+        }
+        console.log(`[TaskBoard] ${ready.length} tasks are READY\n`);
+        // Sort by priority descending
+        return ready.sort((a, b) => b.priority - a.priority);
+    }
+    // ── Queries ───────────────────────────────────────────────────────────
+    async queryTasks(options = {}) {
+        let results = await this.tasks.list();
+        if (options.statuses?.length) {
+            const statuses = new Set(options.statuses);
+            results = results.filter((t) => statuses.has(t.status));
+        }
+        if (options.types?.length) {
+            const types = new Set(options.types);
+            results = results.filter((t) => types.has(t.type));
+        }
+        if (options.assignee) {
+            results = results.filter((t) => t.assignee === options.assignee);
+        }
+        if (options.minPriority !== undefined) {
+            results = results.filter((t) => t.priority >= options.minPriority);
+        }
+        if (options.search) {
+            const q = options.search.toLowerCase();
+            results = results.filter((t) => t.title.toLowerCase().includes(q) ||
+                t.description.toLowerCase().includes(q));
+        }
+        if (options.relatedNodeIds?.length) {
+            const nodeIds = new Set(options.relatedNodeIds);
+            results = results.filter((t) => t.relatedNodes.some((id) => nodeIds.has(id)));
+        }
+        // Sorting
+        if (options.orderBy) {
+            const dir = options.order === "asc" ? 1 : -1;
+            results = results.sort((a, b) => {
+                const av = a[options.orderBy];
+                const bv = b[options.orderBy];
+                if (av === bv)
+                    return 0;
+                if (av == null)
+                    return dir;
+                if (bv == null)
+                    return -dir;
+                return av < bv ? -dir : dir;
+            });
+        }
+        if (options.offset) {
+            results = results.slice(options.offset);
+        }
+        if (options.limit !== undefined) {
+            results = results.slice(0, options.limit);
+        }
+        return results;
+    }
+    // ── History ───────────────────────────────────────────────────────────
+    getTransitions(taskId) {
+        if (taskId) {
+            return this.transitions.filter((t) => t.taskId === taskId);
+        }
+        return [...this.transitions];
+    }
+    // ── Statistics ────────────────────────────────────────────────────────
+    async getStatistics() {
+        const all = await this.tasks.list();
+        const byStatus = {};
+        const byType = {};
+        const byAssignee = {};
+        let blockedCount = 0;
+        let completedCount = 0;
+        let totalCompletionTimeMs = 0;
+        for (const task of all) {
+            byStatus[task.status] = (byStatus[task.status] ?? 0) + 1;
+            byType[task.type] = (byType[task.type] ?? 0) + 1;
+            if (task.assignee) {
+                byAssignee[task.assignee] = (byAssignee[task.assignee] ?? 0) + 1;
+            }
+            if (task.status === task_board_types_1.BoardTaskStatus.BLOCKED)
+                blockedCount++;
+            if (task.status === task_board_types_1.BoardTaskStatus.DONE && task.startedAt && task.completedAt) {
+                completedCount++;
+                totalCompletionTimeMs +=
+                    new Date(task.completedAt).getTime() - new Date(task.startedAt).getTime();
+            }
+        }
+        return {
+            total: all.length,
+            byStatus,
+            byType,
+            byAssignee,
+            blockedCount,
+            avgCompletionTimeMs: completedCount > 0 ? totalCompletionTimeMs / completedCount : 0,
+        };
+    }
+}
+exports.TaskBoard = TaskBoard;
+//# sourceMappingURL=task-board.class.js.map

package/dist/libs/task-board.class.js.map

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

package/dist/libs/task-flow/auto-answer-engine.class.d.ts

@@ -0,0 +1,22 @@
+import { EvidenceItem, TaskStrictness } from "../../contracts/task-flow.types";
+export type AutoAnswerMode = "auto-answer" | "optional-hitl" | "mandatory-hitl";
+export interface AutoAnswerInput {
+    evidence: EvidenceItem[];
+    ambiguity: number;
+    conflicts: number;
+    affectsBusinessModel: boolean;
+    affectsCompliance: boolean;
+    affectsLegal: boolean;
+    affectsRisk: boolean;
+}
+export interface AutoAnswerDecision {
+    mode: AutoAnswerMode;
+    confidence: number;
+    reasons: string[];
+}
+export declare class AutoAnswerEngine {
+    decide(input: AutoAnswerInput, strictness: TaskStrictness): AutoAnswerDecision;
+    private computeConfidence;
+    private clamp;
+}
+//# sourceMappingURL=auto-answer-engine.class.d.ts.map

package/dist/libs/task-flow/auto-answer-engine.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-answer-engine.class.d.ts","sourceRoot":"","sources":["../../../src/libs/task-flow/auto-answer-engine.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAE/E,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,GAAG,kBAAkB;IAiD9E,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,KAAK;CAGd"}

package/dist/libs/task-flow/auto-answer-engine.class.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutoAnswerEngine = void 0;
+const task_flow_types_1 = require("../../contracts/task-flow.types");
+class AutoAnswerEngine {
+    decide(input, strictness) {
+        const reasons = [];
+        const averageConfidence = input.evidence.length > 0
+            ? input.evidence.reduce((sum, item) => sum + this.clamp(item.confidence), 0) / input.evidence.length
+            : 0;
+        const evidenceCoverage = this.clamp(input.evidence.length / 8);
+        const businessSensitive = input.affectsBusinessModel || input.affectsCompliance || input.affectsLegal || input.affectsRisk;
+        if (businessSensitive) {
+            reasons.push("Business/compliance/legal/risk ambiguity requires mandatory HITL.");
+            return {
+                mode: "mandatory-hitl",
+                confidence: this.computeConfidence(averageConfidence, evidenceCoverage, input.ambiguity, input.conflicts),
+                reasons,
+            };
+        }
+        if (input.conflicts > 0 && strictness === task_flow_types_1.TaskStrictness.STRICT) {
+            reasons.push("Conflicting evidence detected in strict mode.");
+            return {
+                mode: "mandatory-hitl",
+                confidence: this.computeConfidence(averageConfidence, evidenceCoverage, input.ambiguity, input.conflicts),
+                reasons,
+            };
+        }
+        const confidence = this.computeConfidence(averageConfidence, evidenceCoverage, input.ambiguity, input.conflicts);
+        if (confidence >= 0.75 && input.ambiguity < 0.3 && input.conflicts === 0) {
+            reasons.push("High confidence and low ambiguity.");
+            return {
+                mode: "auto-answer",
+                confidence,
+                reasons,
+            };
+        }
+        reasons.push("Ambiguity or uncertainty remains; keeping HITL optional.");
+        return {
+            mode: "optional-hitl",
+            confidence,
+            reasons,
+        };
+    }
+    computeConfidence(averageConfidence, evidenceCoverage, ambiguity, conflicts) {
+        const conflictPenalty = Math.min(0.6, conflicts * 0.2);
+        const ambiguityPenalty = this.clamp(ambiguity) * 0.45;
+        const score = averageConfidence * 0.55 + evidenceCoverage * 0.45 - conflictPenalty - ambiguityPenalty;
+        return this.clamp(score);
+    }
+    clamp(value) {
+        return Math.max(0, Math.min(1, value));
+    }
+}
+exports.AutoAnswerEngine = AutoAnswerEngine;
+//# sourceMappingURL=auto-answer-engine.class.js.map

package/dist/libs/task-flow/auto-answer-engine.class.js.map

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

package/dist/libs/task-flow/controlled-coding-engine.class.d.ts

@@ -0,0 +1,18 @@
+import { ControlledCodingOptions, ControlledCodingRunResult, ControlledExecutionStep } from "../../contracts/task-flow.types";
+interface ExecutePlanInput {
+    approvedPlan: boolean;
+    steps: ControlledExecutionStep[];
+    existingSymbols?: Set<string>;
+}
+export declare class ControlledCodingEngine {
+    private readonly options;
+    constructor(options: ControlledCodingOptions);
+    executePlan(input: ExecutePlanInput): Promise<ControlledCodingRunResult>;
+    private rollback;
+    private assertTouchedFileBudget;
+    private assertProtectedFiles;
+    private assertNoWriteCollision;
+    private assertNoDuplicateSymbols;
+}
+export {};
+//# sourceMappingURL=controlled-coding-engine.class.d.ts.map

package/dist/libs/task-flow/controlled-coding-engine.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controlled-coding-engine.class.d.ts","sourceRoot":"","sources":["../../../src/libs/task-flow/controlled-coding-engine.class.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EAGxB,MAAM,iCAAiC,CAAC;AAEzC,UAAU,gBAAgB;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACjC,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,uBAAuB;IAEvD,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,yBAAyB,CAAC;YAiFhE,QAAQ;IA2BtB,OAAO,CAAC,uBAAuB;IAoB/B,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,wBAAwB;CAUjC"}

package/dist/libs/task-flow/controlled-coding-engine.class.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ControlledCodingEngine = void 0;
+const task_flow_types_1 = require("../../contracts/task-flow.types");
+class ControlledCodingEngine {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async executePlan(input) {
+        if (!input.approvedPlan) {
+            throw new Error("Cannot execute coding plan before approval.");
+        }
+        this.assertTouchedFileBudget(input.steps);
+        const records = [];
+        const completedForRollback = [];
+        const knownSymbols = new Set(input.existingSymbols ?? []);
+        const activeWrites = new Set();
+        for (const executionStep of input.steps) {
+            const startedAt = new Date().toISOString();
+            try {
+                this.assertProtectedFiles(executionStep.step.touchedFiles);
+                this.assertNoWriteCollision(activeWrites, executionStep.step.touchedFiles);
+                for (const file of executionStep.step.touchedFiles) {
+                    activeWrites.add(file);
+                }
+                const outcome = await executionStep.execute();
+                const verified = await executionStep.verify(outcome);
+                if (!verified) {
+                    throw new Error(`Verification failed for step ${executionStep.step.id}`);
+                }
+                const introduced = outcome.introducedSymbols ?? [];
+                this.assertNoDuplicateSymbols(knownSymbols, introduced);
+                for (const symbol of [...(executionStep.step.proposedSymbols ?? []), ...introduced]) {
+                    knownSymbols.add(symbol);
+                }
+                completedForRollback.push(executionStep);
+                records.push({
+                    stepId: executionStep.step.id,
+                    status: "completed",
+                    startedAt,
+                    completedAt: new Date().toISOString(),
+                    changedFiles: outcome.changedFiles,
+                    message: outcome.summary,
+                });
+            }
+            catch (error) {
+                for (const file of executionStep.step.touchedFiles) {
+                    activeWrites.delete(file);
+                }
+                const rollbackSteps = await this.rollback(completedForRollback, records);
+                records.push({
+                    stepId: executionStep.step.id,
+                    status: "failed",
+                    startedAt,
+                    completedAt: new Date().toISOString(),
+                    changedFiles: executionStep.step.touchedFiles,
+                    message: error instanceof Error ? error.message : String(error),
+                });
+                return {
+                    success: false,
+                    records,
+                    rolledBackSteps: rollbackSteps,
+                    error: error instanceof Error ? error.message : String(error),
+                };
+            }
+            finally {
+                for (const file of executionStep.step.touchedFiles) {
+                    activeWrites.delete(file);
+                }
+            }
+        }
+        return {
+            success: true,
+            records,
+            rolledBackSteps: [],
+        };
+    }
+    async rollback(completedForRollback, records) {
+        const rolledBack = [];
+        for (let index = completedForRollback.length - 1; index >= 0; index -= 1) {
+            const step = completedForRollback[index];
+            if (!step.rollback) {
+                continue;
+            }
+            await step.rollback();
+            rolledBack.push(step.step.id);
+            records.push({
+                stepId: step.step.id,
+                status: "rolled-back",
+                startedAt: new Date().toISOString(),
+                completedAt: new Date().toISOString(),
+                changedFiles: step.step.touchedFiles,
+                message: `Rollback executed for ${step.step.id}`,
+            });
+        }
+        return rolledBack;
+    }
+    assertTouchedFileBudget(steps) {
+        const touched = new Set();
+        for (const step of steps) {
+            for (const file of step.step.touchedFiles) {
+                touched.add(file);
+            }
+        }
+        if (touched.size <= this.options.touchedFileBudget) {
+            return;
+        }
+        const message = `Touched files ${touched.size} exceed budget ${this.options.touchedFileBudget}`;
+        if (this.options.strictness === task_flow_types_1.TaskStrictness.STRICT) {
+            throw new Error(message);
+        }
+    }
+    assertProtectedFiles(files) {
+        for (const file of files) {
+            for (const glob of this.options.protectedFileGlobs) {
+                if (!globMatches(glob, file)) {
+                    continue;
+                }
+                throw new Error(`Protected file matched (${file}) by policy '${glob}'`);
+            }
+        }
+    }
+    assertNoWriteCollision(activeWrites, touchedFiles) {
+        if (!this.options.allowParallelNonOverlapping) {
+            return;
+        }
+        for (const file of touchedFiles) {
+            if (activeWrites.has(file)) {
+                throw new Error(`Parallel write collision for file '${file}'`);
+            }
+        }
+    }
+    assertNoDuplicateSymbols(knownSymbols, symbols) {
+        for (const symbol of symbols) {
+            if (!symbol) {
+                continue;
+            }
+            if (knownSymbols.has(symbol)) {
+                throw new Error(`Duplicate symbol introduction blocked for '${symbol}'`);
+            }
+        }
+    }
+}
+exports.ControlledCodingEngine = ControlledCodingEngine;
+function globMatches(glob, filePath) {
+    const normalizedGlob = glob.replace(/\\/g, "/");
+    const normalizedPath = filePath.replace(/\\/g, "/");
+    const escaped = normalizedGlob
+        .replace(/[.+^${}()|[\]\\]/g, "\\$&")
+        .replace(/\*\*/g, "@@DOUBLESTAR@@")
+        .replace(/\*/g, "[^/]*")
+        .replace(/@@DOUBLESTAR@@/g, ".*");
+    return new RegExp(`^${escaped}$`).test(normalizedPath);
+}
+//# sourceMappingURL=controlled-coding-engine.class.js.map

package/dist/libs/task-flow/controlled-coding-engine.class.js.map

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

package/dist/libs/task-flow/dependency-analyzer.class.d.ts

@@ -0,0 +1,16 @@
+import { DependencyEdge } from "../../contracts/task-flow.types";
+export interface DependencyAnalysisResult {
+    edges: DependencyEdge[];
+    highRiskFiles: string[];
+    cycles: string[][];
+}
+export declare class DependencyAnalyzer {
+    analyzeFromFiles(rootDir: string, files: string[]): DependencyAnalysisResult;
+    estimateImpactRadius(edges: DependencyEdge[], changedFiles: string[]): string[];
+    private safeRead;
+    private extractDependencies;
+    private resolveImport;
+    private computeHighRiskFiles;
+    private detectSimpleCycles;
+}
+//# sourceMappingURL=dependency-analyzer.class.d.ts.map

package/dist/libs/task-flow/dependency-analyzer.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-analyzer.class.d.ts","sourceRoot":"","sources":["../../../src/libs/task-flow/dependency-analyzer.class.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;CACpB;AAKD,qBAAa,kBAAkB;IAC7B,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,wBAAwB;IA0C5E,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IA4B/E,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,kBAAkB;CAoB3B"}