conatus 0.1.0

package/dist/core/suggest/repo-context.js

@@ -0,0 +1,154 @@
+import * as path from "node:path";
+export function resolveSuggestRepoPath(inputPath = ".") {
+    const displayPath = inputPath.trim().length > 0 ? inputPath : ".";
+    return {
+        resolvedPath: path.resolve(displayPath),
+        displayPath,
+    };
+}
+function normalizeRepoFilePath(targetPath, filePath) {
+    const trimmed = filePath.trim();
+    if (trimmed.length === 0) {
+        return "";
+    }
+    let normalized = trimmed;
+    if (path.isAbsolute(trimmed)) {
+        normalized = path.relative(targetPath, trimmed);
+    }
+    else {
+        const prefixedTarget = targetPath.endsWith(path.sep) ? targetPath : `${targetPath}${path.sep}`;
+        if (trimmed.startsWith(prefixedTarget)) {
+            normalized = path.relative(targetPath, trimmed);
+        }
+    }
+    const withForwardSlashes = normalized.split(path.sep).join("/");
+    return withForwardSlashes === "" ? path.basename(targetPath) : withForwardSlashes;
+}
+export async function listSuggestRepoFiles(targetPath) {
+    const { execFile } = await import("node:child_process");
+    const { promisify } = await import("node:util");
+    const execFileAsync = promisify(execFile);
+    try {
+        let stdout = "";
+        try {
+            ({ stdout } = await execFileAsync("rg", [
+                "--files",
+                targetPath,
+                "-g", "*.ts",
+                "-g", "*.js",
+                "-g", "*.tsx",
+                "-g", "*.jsx",
+                "-g", "*.json",
+                "-g", "*.md",
+                "-g", "!node_modules/**",
+                "-g", "!dist/**",
+                "-g", "!.git/**",
+            ], { timeout: 5000 }));
+        }
+        catch {
+            ({ stdout } = await execFileAsync("find", [
+                targetPath, "-type", "f",
+                "(",
+                "-name", "*.ts",
+                "-o", "-name", "*.js",
+                "-o", "-name", "*.tsx",
+                "-o", "-name", "*.jsx",
+                "-o", "-name", "*.json",
+                "-o", "-name", "*.md",
+                ")",
+                "-not", "-path", "*/node_modules/*",
+                "-not", "-path", "*/dist/*",
+                "-not", "-path", "*/.git/*",
+            ], { timeout: 5000 }));
+        }
+        return stdout
+            .trim()
+            .split("\n")
+            .map((file) => normalizeRepoFilePath(targetPath, file))
+            .filter(Boolean)
+            .slice(0, 200);
+    }
+    catch {
+        return [];
+    }
+}
+export async function buildSuggestRepoContext(targetPath, repoFiles) {
+    const { execFile } = await import("node:child_process");
+    const { promisify } = await import("node:util");
+    const { readFile } = await import("node:fs/promises");
+    const execFileAsync = promisify(execFile);
+    const parts = [];
+    const projectFiles = repoFiles ?? await listSuggestRepoFiles(targetPath);
+    if (projectFiles.length > 0) {
+        parts.push(`Project files:\n${projectFiles.join("\n")}`);
+    }
+    try {
+        const pkg = await readFile(path.join(targetPath, "package.json"), "utf-8");
+        parts.push(`package.json:\n${pkg}`);
+    }
+    catch {
+        // Best-effort context assembly only.
+    }
+    try {
+        let stdout = "";
+        try {
+            ({ stdout } = await execFileAsync("rg", [
+                "-n",
+                "TODO|FIXME",
+                targetPath,
+                "-g", "*.ts",
+                "-g", "*.js",
+                "-g", "!node_modules/**",
+                "-g", "!dist/**",
+                "-g", "!.git/**",
+            ], { timeout: 5000 }));
+        }
+        catch {
+            ({ stdout } = await execFileAsync("grep", [
+                "-rc", "TODO\\|FIXME", targetPath,
+                "--include=*.ts", "--include=*.js",
+            ], { timeout: 5000 }));
+        }
+        const totalCount = stdout.trim().length === 0
+            ? 0
+            : stdout.trim().split("\n").reduce((sum, line) => {
+                if (line.includes(":")) {
+                    const tail = line.split(":").pop() || "0";
+                    const parsed = parseInt(tail, 10);
+                    return sum + (Number.isNaN(parsed) ? 1 : parsed);
+                }
+                return sum + 1;
+            }, 0);
+        parts.push(`TODO/FIXME count: ${totalCount}`);
+    }
+    catch (err) {
+        if (typeof err === "object" && err !== null && "code" in err && err.code === 1) {
+            parts.push("TODO/FIXME count: 0");
+        }
+    }
+    try {
+        let stdout = "";
+        try {
+            ({ stdout } = await execFileAsync("rg", [
+                "--files",
+                targetPath,
+                "-g", "*.test.ts",
+                "-g", "!node_modules/**",
+                "-g", "!dist/**",
+                "-g", "!.git/**",
+            ], { timeout: 5000 }));
+        }
+        catch {
+            ({ stdout } = await execFileAsync("find", [
+                targetPath, "-name", "*.test.ts", "-not", "-path", "*/node_modules/*",
+            ], { timeout: 5000 }));
+        }
+        const testFiles = stdout.trim().split("\n").filter(Boolean);
+        parts.push(`Test files: ${testFiles.length}`);
+    }
+    catch {
+        // Best-effort context assembly only.
+    }
+    return parts.join("\n\n");
+}
+//# sourceMappingURL=repo-context.js.map

package/dist/core/suggest/repo-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-context.js","sourceRoot":"","sources":["../../../src/core/suggest/repo-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAOlC,MAAM,UAAU,sBAAsB,CAAC,YAAoB,GAAG;IAC5D,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;IAElE,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QACvC,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,UAAkB,EAAE,QAAgB;IACjE,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,UAAU,GAAG,OAAO,CAAC;IACzB,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;SAAM,CAAC;QACN,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/F,IAAI,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YACvC,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,MAAM,kBAAkB,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChE,OAAO,kBAAkB,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC;AACpF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,UAAkB;IAC3D,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACxD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE1C,IAAI,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE;gBACtC,SAAS;gBACT,UAAU;gBACV,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,UAAU;aACjB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE;gBACxC,UAAU,EAAE,OAAO,EAAE,GAAG;gBACxB,GAAG;gBACH,OAAO,EAAE,MAAM;gBACf,IAAI,EAAE,OAAO,EAAE,MAAM;gBACrB,IAAI,EAAE,OAAO,EAAE,OAAO;gBACtB,IAAI,EAAE,OAAO,EAAE,OAAO;gBACtB,IAAI,EAAE,OAAO,EAAE,QAAQ;gBACvB,IAAI,EAAE,OAAO,EAAE,MAAM;gBACrB,GAAG;gBACH,MAAM,EAAE,OAAO,EAAE,kBAAkB;gBACnC,MAAM,EAAE,OAAO,EAAE,UAAU;gBAC3B,MAAM,EAAE,OAAO,EAAE,UAAU;aAC5B,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzB,CAAC;QAED,OAAO,MAAM;aACV,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,qBAAqB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;aACtD,MAAM,CAAC,OAAO,CAAC;aACf,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,UAAkB,EAAE,SAAoB;IACpF,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACxD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IACtD,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE1C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,MAAM,YAAY,GAAG,SAAS,IAAI,MAAM,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACzE,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,mBAAmB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,qCAAqC;IACvC,CAAC;IAED,IAAI,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE;gBACtC,IAAI;gBACJ,YAAY;gBACZ,UAAU;gBACV,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,UAAU;aACjB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE;gBACxC,KAAK,EAAE,cAAc,EAAE,UAAU;gBACjC,gBAAgB,EAAE,gBAAgB;aACnC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzB,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAC3C,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;gBAC/C,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACvB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC;oBAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;oBAClC,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;gBACnD,CAAC;gBACD,OAAO,GAAG,GAAG,CAAC,CAAC;YACjB,CAAC,EAAE,CAAC,CAAC,CAAC;QACR,KAAK,CAAC,IAAI,CAAC,qBAAqB,UAAU,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,MAAM,IAAI,GAAG,IAAK,GAAwB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACrG,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE;gBACtC,SAAS;gBACT,UAAU;gBACV,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,UAAU;aACjB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE;gBACxC,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB;aACtE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzB,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,eAAe,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,qCAAqC;IACvC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/core-loop.d.ts

@@ -0,0 +1,63 @@
+import type { LoopConfig, LoopIterationResult, LoopResult, CoreLoopDeps } from "./loop/core-loop-types.js";
+export type { GapCalculatorModule, DriveScorerModule, ExecutionSummaryParams, ReportingEngine, LoopConfig, LoopIterationResult, LoopResult, CoreLoopDeps, ProgressEvent, } from "./loop/core-loop-types.js";
+export { buildDriveContext } from "./loop/core-loop-types.js";
+/**
+ * CoreLoop is the heart of Conatus — it orchestrates one full iteration of the
+ * task discovery loop: observe → gap → score → completion check → stall check → task → report.
+ *
+ * It runs multiple iterations until the goal is complete (SatisficingJudge),
+ * max iterations reached, stall escalation occurs, or an external stop signal.
+ */
+export declare class CoreLoop {
+    private readonly deps;
+    private readonly config;
+    private readonly logger?;
+    private stopped;
+    private readonly learning;
+    constructor(deps: CoreLoopDeps, config?: LoopConfig);
+    /**
+     * Run the full loop until completion or stop condition.
+     */
+    run(goalId: string): Promise<LoopResult>;
+    /**
+     * Run a single iteration of the loop.
+     */
+    runOneIteration(goalId: string, loopIndex: number): Promise<LoopIterationResult>;
+    /**
+     * Tree-mode iteration: select one node via TreeLoopOrchestrator, run a
+     * normal observe→gap→score→task cycle on that node, then aggregate upward.
+     *
+     * Called by run() when treeMode=true.
+     */
+    runTreeIteration(rootId: string, loopIndex: number): Promise<LoopIterationResult>;
+    /**
+     * Run one iteration of the multi-goal loop.
+     *
+     * Uses CrossGoalPortfolio (if available) to determine goal allocations,
+     * then calls portfolioManager.selectNextStrategyAcrossGoals() to pick
+     * which goal gets the next iteration. Falls back to equal allocation if
+     * CrossGoalPortfolio is not injected.
+     *
+     * Requires config.multiGoalMode=true and config.goalIds to be set.
+     * Throws if CrossGoalPortfolio is not injected and multiGoalMode is enabled.
+     */
+    runMultiGoalIteration(loopIndex: number): Promise<LoopIterationResult>;
+    /**
+     * Stop the loop externally (e.g., on SIGTERM).
+     */
+    stop(): void;
+    /**
+     * Check if the loop has been stopped.
+     */
+    isStopped(): boolean;
+    /**
+     * Attempt TaskGroup decomposition and parallel execution.
+     *
+     * Returns a ParallelExecutionResult when the parallel path ran successfully,
+     * or null when the caller should fall through to the normal single-task cycle.
+     * Updates result.taskResult with a synthetic entry reflecting the parallel outcome.
+     */
+    private tryRunParallel;
+    private tryGenerateReport;
+}
+//# sourceMappingURL=core-loop.d.ts.map

package/dist/core-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-loop.d.ts","sourceRoot":"","sources":["../src/core-loop.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAKV,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,YAAY,EAEb,MAAM,2BAA2B,CAAC;AAuBnC,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,aAAa,GACd,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAgB9D;;;;;;GAMG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;gBAEzD,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,UAAU;IAQnD;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA8Q9C;;OAEG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,CAAC;IAgG/B;;;;;OAKG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAKvF;;;;;;;;;;OAUG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAK5E;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,SAAS,IAAI,OAAO;IAMpB;;;;;;OAMG;YACW,cAAc;YA0Gd,iBAAiB;CAsChC"}