pulseed 0.0.1 → 0.1.0

package/dist/codex-llm-client.js.map

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

package/dist/context-provider.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Provides workspace context for task generation.
+ * Given a goalId and dimensionName, returns relevant file contents,
+ * grep results, and test status.
+ */
+export declare function buildWorkspaceContext(goalId: string, dimensionName: string, options?: {
+    cwd?: string;
+    maxFileContentLines?: number;
+}): Promise<string>;
+/**
+ * Convert dimension names to search terms for grep.
+ * e.g., "todo_count" → ["TODO"], "fixme_count" → ["FIXME"],
+ *        "test_coverage" → ["test", "coverage"], "code_quality" → ["quality"]
+ */
+export declare function dimensionNameToSearchTerms(dimensionName: string): string[];
+//# sourceMappingURL=context-provider.d.ts.map

package/dist/context-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-provider.d.ts","sourceRoot":"","sources":["../src/context-provider.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;IACR,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,GACA,OAAO,CAAC,MAAM,CAAC,CAoFjB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAmB1E"}

package/dist/context-provider.js

@@ -0,0 +1,107 @@
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { readFile } from "fs/promises";
+const execFileAsync = promisify(execFile);
+/**
+ * Provides workspace context for task generation.
+ * Given a goalId and dimensionName, returns relevant file contents,
+ * grep results, and test status.
+ */
+export async function buildWorkspaceContext(goalId, dimensionName, options) {
+    const cwd = options?.cwd || process.cwd();
+    const maxLines = options?.maxFileContentLines ?? 100;
+    const parts = [];
+    // 1. Search for files related to the dimension name
+    // Convert dimension_name to search terms (e.g., "todo_count" → "TODO")
+    const searchTerms = dimensionNameToSearchTerms(dimensionName);
+    for (const term of searchTerms) {
+        try {
+            const { stdout } = await execFileAsync("grep", ["-rn", "--include=*.ts", "--include=*.js", "-l", term, cwd], { timeout: 10000 });
+            const files = stdout
+                .trim()
+                .split("\n")
+                .filter(Boolean)
+                .slice(0, 5);
+            if (files.length > 0) {
+                parts.push(`[grep "${term}" — ${files.length} files matched]`);
+                // Read first few matching files (up to 3, maxLines each)
+                for (const filePath of files.slice(0, 3)) {
+                    try {
+                        const content = await readFile(filePath, "utf-8");
+                        const lines = content.split("\n").slice(0, maxLines);
+                        const relativePath = filePath.replace(cwd + "/", "");
+                        parts.push(`[File: ${relativePath} (${lines.length} lines)]`);
+                        parts.push(lines.join("\n"));
+                    }
+                    catch {
+                        // skip unreadable files
+                    }
+                }
+            }
+        }
+        catch {
+            // grep returns exit 1 for zero matches — ignore
+        }
+    }
+    // 2. Git diff (recent changes)
+    try {
+        const { stdout } = await execFileAsync("git", ["diff", "HEAD~1", "--stat"], { cwd, timeout: 10000 });
+        if (stdout.trim()) {
+            parts.push(`[Recent changes: git diff HEAD~1 --stat]`);
+            parts.push(stdout.trim());
+        }
+    }
+    catch {
+        // ignore
+    }
+    // 3. Test status summary
+    try {
+        const { stdout } = await execFileAsync("npx", ["vitest", "run", "--reporter=dot"], { cwd, timeout: 30000 });
+        const lastLines = stdout.split("\n").slice(-10).join("\n");
+        parts.push(`[Test status]`);
+        parts.push(lastLines);
+    }
+    catch (err) {
+        if (typeof err === "object" && err !== null && "stdout" in err) {
+            const lastLines = (err.stdout || "")
+                .split("\n")
+                .slice(-10)
+                .join("\n");
+            if (lastLines.trim()) {
+                parts.push(`[Test status (failures detected)]`);
+                parts.push(lastLines);
+            }
+        }
+    }
+    return parts.join("\n\n") || "(No workspace context available)";
+}
+/**
+ * Convert dimension names to search terms for grep.
+ * e.g., "todo_count" → ["TODO"], "fixme_count" → ["FIXME"],
+ *        "test_coverage" → ["test", "coverage"], "code_quality" → ["quality"]
+ */
+export function dimensionNameToSearchTerms(dimensionName) {
+    const terms = [];
+    const lower = dimensionName.toLowerCase();
+    if (lower.includes("todo"))
+        terms.push("TODO");
+    if (lower.includes("fixme"))
+        terms.push("FIXME");
+    if (lower.includes("test"))
+        terms.push("test");
+    if (lower.includes("coverage"))
+        terms.push("coverage");
+    if (lower.includes("lint") || lower.includes("eslint"))
+        terms.push("eslint");
+    if (lower.includes("error") || lower.includes("bug"))
+        terms.push("error");
+    if (lower.includes("doc") || lower.includes("readme"))
+        terms.push("README");
+    // Fallback: use the dimension name itself as a search term
+    if (terms.length === 0) {
+        const words = dimensionName.split("_").filter((w) => w.length > 2);
+        terms.push(...words.slice(0, 2));
+    }
+    return terms.length > 0 ? terms : [dimensionName];
+}
+//# sourceMappingURL=context-provider.js.map

package/dist/context-provider.js.map

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

package/dist/context-providers/workspace-context.d.ts

@@ -0,0 +1,8 @@
+export interface WorkspaceContextOptions {
+    workDir: string;
+    maxFiles?: number;
+    maxCharsPerFile?: number;
+    externalFileMaxBytes?: number;
+}
+export declare function createWorkspaceContextProvider(options: WorkspaceContextOptions, getGoalDescription: (goalId: string) => string | undefined): (goalId: string, dimensionName: string) => Promise<string>;
+//# sourceMappingURL=workspace-context.d.ts.map

package/dist/context-providers/workspace-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-context.d.ts","sourceRoot":"","sources":["../../src/context-providers/workspace-context.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AA0HD,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,uBAAuB,EAChC,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GACzD,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAkG5D"}

package/dist/context-providers/workspace-context.js

@@ -0,0 +1,217 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+const ALLOWED_EXTERNAL_PREFIXES = [os.homedir(), "/tmp"];
+/**
+ * Extract absolute file paths from a text string.
+ * Matches paths starting with / that look like file paths.
+ */
+function extractAbsolutePaths(text) {
+    // Match absolute paths: /something/... (not just /)
+    const matches = text.match(/\/[^\s'"`,;)>]+/g) ?? [];
+    // Filter to plausible file paths (must have at least one path segment)
+    return [...new Set(matches.filter((p) => p.split("/").length >= 2))];
+}
+/**
+ * Extract relative file paths from a text string.
+ * Matches paths like src/xxx.ts, docs/yyy.md, etc.
+ */
+function extractRelativePaths(text) {
+    // Match relative paths: word/word... with common file extensions or multiple segments
+    const matches = text.match(/(?<![/\w])\w[\w.-]*(?:\/[\w.-]+)+/g) ?? [];
+    // Filter to plausible relative file paths (must contain a dot for extension or multiple segments)
+    return [...new Set(matches.filter((p) => {
+            const parts = p.split("/");
+            // Must have at least 2 parts and last part should look like a file (has extension or is recognizable)
+            return parts.length >= 2 && parts[parts.length - 1].includes(".");
+        }))];
+}
+/**
+ * Returns true if the resolved path is under an allowed prefix.
+ * Allowed: home directory or /tmp.
+ */
+function isAllowedExternalPath(filePath) {
+    const resolved = path.resolve(filePath);
+    return ALLOWED_EXTERNAL_PREFIXES.some((prefix) => resolved.startsWith(prefix + path.sep) || resolved === prefix);
+}
+/**
+ * Read an external file if it exists, is allowed, and is within size limit.
+ * Returns the content string or null if not readable.
+ */
+function readExternalFile(filePath, maxBytes) {
+    if (!isAllowedExternalPath(filePath))
+        return null;
+    try {
+        const stat = fs.statSync(filePath);
+        if (!stat.isFile())
+            return null;
+        if (stat.size > maxBytes)
+            return null;
+        return fs.readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+const STOPWORDS = new Set([
+    "the", "a", "an", "is", "are", "to", "for", "of", "in", "on", "at",
+    "and", "or", "not", "be", "was", "were", "has", "have", "had",
+    "do", "does", "did", "will", "would", "could", "should", "may",
+    "might", "can", "its", "it", "this", "that", "with", "as", "by",
+    "from", "up", "about", "into", "through", "during", "before",
+    "after", "above", "below", "between", "each", "but", "also",
+]);
+const EXCLUDE_DIRS = new Set(["node_modules", ".git", "dist", "coverage", ".DS_Store"]);
+function extractKeywords(text) {
+    return text
+        .toLowerCase()
+        .split(/[\s\-_\/\.]+/)
+        .filter((w) => w.length >= 3 && !STOPWORDS.has(w));
+}
+function collectFiles(dir, rootDir, depth, result) {
+    if (depth > 3)
+        return;
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    const resolvedRoot = path.resolve(rootDir);
+    for (const entry of entries) {
+        if (EXCLUDE_DIRS.has(entry.name))
+            continue;
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            collectFiles(full, rootDir, depth + 1, result);
+        }
+        else if (entry.isFile()) {
+            const resolved = path.resolve(full);
+            if (resolved.startsWith(resolvedRoot + path.sep) || resolved === resolvedRoot) {
+                result.push(full);
+            }
+        }
+    }
+}
+function fileMatchesKeywords(filePath, keywords) {
+    const name = path.basename(filePath).toLowerCase();
+    return keywords.some((kw) => name.includes(kw));
+}
+function fileContentMatchesKeywords(filePath, keywords) {
+    try {
+        const raw = fs.readFileSync(filePath, "utf-8");
+        const content = raw.slice(0, 20480).toLowerCase();
+        return keywords.some((kw) => content.includes(kw));
+    }
+    catch {
+        return false;
+    }
+}
+function readFileSection(filePath, maxChars) {
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        return content.slice(0, maxChars);
+    }
+    catch {
+        return "";
+    }
+}
+export function createWorkspaceContextProvider(options, getGoalDescription) {
+    const { workDir, maxFiles = 5, maxCharsPerFile = 4000, externalFileMaxBytes = 10240 } = options;
+    return async (goalId, dimensionName) => {
+        const goalDescription = getGoalDescription(goalId) ?? "";
+        const keywords = extractKeywords(goalDescription + " " + dimensionName);
+        const parts = [`# Workspace: ${workDir}`];
+        // Read external absolute-path files mentioned in goal description
+        const externalPaths = extractAbsolutePaths(goalDescription);
+        for (const extPath of externalPaths) {
+            const content = readExternalFile(extPath, externalFileMaxBytes);
+            if (content !== null) {
+                parts.push(`## External file: ${extPath}\n\`\`\`\n${content}\n\`\`\``);
+            }
+        }
+        // Directory listing
+        try {
+            const entries = fs.readdirSync(workDir);
+            parts.push(`## Directory listing\n${entries.join(", ")}`);
+        }
+        catch {
+            /* skip */
+        }
+        // Always-include candidates
+        const alwaysInclude = ["README.md", "package.json"];
+        const alwaysIncludePaths = alwaysInclude
+            .map((rel) => path.join(workDir, rel))
+            .filter((fp) => {
+            try {
+                fs.accessSync(fp);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        });
+        // Relative path exact-match: files explicitly mentioned in goal description
+        const relativePathsInGoal = extractRelativePaths(goalDescription);
+        const pathMatchedPaths = relativePathsInGoal
+            .map((rel) => path.join(workDir, rel))
+            .filter((fp) => {
+            try {
+                fs.accessSync(fp);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        });
+        // Collect all files (depth 3)
+        const allFiles = [];
+        collectFiles(workDir, workDir, 0, allFiles);
+        // Separate already-included from candidates
+        const alwaysSet = new Set(alwaysIncludePaths);
+        const pathMatchSet = new Set(pathMatchedPaths);
+        const candidates = allFiles.filter((fp) => !alwaysSet.has(fp) && !pathMatchSet.has(fp));
+        // Phase 1: filename match
+        const nameMatched = candidates.filter((fp) => fileMatchesKeywords(fp, keywords));
+        // Phase 2: content match (only if we still need more)
+        // alwaysInclude and pathMatch are treated as priority (outside maxFiles cap),
+        // so keyword-match fills remaining slots up to maxFiles
+        const neededFromCandidates = Math.max(0, maxFiles - alwaysIncludePaths.length - pathMatchedPaths.length);
+        let selected = nameMatched.slice(0, neededFromCandidates);
+        if (selected.length < neededFromCandidates) {
+            const remaining = candidates.filter((fp) => !selected.includes(fp));
+            const contentMatched = remaining.filter((fp) => fileContentMatchesKeywords(fp, keywords));
+            selected = [
+                ...selected,
+                ...contentMatched.slice(0, neededFromCandidates - selected.length),
+            ];
+        }
+        // Read always-include files first
+        for (const fp of alwaysIncludePaths) {
+            const rel = path.relative(workDir, fp);
+            const content = readFileSection(fp, maxCharsPerFile);
+            if (content) {
+                parts.push(`## ${rel}\n\`\`\`\n${content}\n\`\`\``);
+            }
+        }
+        // Read explicit path-matched files (priority, same as alwaysInclude)
+        for (const fp of pathMatchedPaths) {
+            const rel = path.relative(workDir, fp);
+            const content = readFileSection(fp, maxCharsPerFile);
+            if (content) {
+                parts.push(`## ${rel}\n\`\`\`\n${content}\n\`\`\``);
+            }
+        }
+        // Read selected keyword-matched files
+        for (const fp of selected) {
+            const rel = path.relative(workDir, fp);
+            const content = readFileSection(fp, maxCharsPerFile);
+            if (content) {
+                parts.push(`## ${rel}\n\`\`\`\n${content}\n\`\`\``);
+            }
+        }
+        return parts.join("\n\n");
+    };
+}
+//# sourceMappingURL=workspace-context.js.map

package/dist/context-providers/workspace-context.js.map

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

package/dist/core/suggest/repo-context.d.ts

@@ -0,0 +1,8 @@
+export interface SuggestRepoPath {
+    resolvedPath: string;
+    displayPath: string;
+}
+export declare function resolveSuggestRepoPath(inputPath?: string): SuggestRepoPath;
+export declare function listSuggestRepoFiles(targetPath: string): Promise<string[]>;
+export declare function buildSuggestRepoContext(targetPath: string, repoFiles?: string[]): Promise<string>;
+//# sourceMappingURL=repo-context.d.ts.map

package/dist/core/suggest/repo-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-context.d.ts","sourceRoot":"","sources":["../../../src/core/suggest/repo-context.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,sBAAsB,CAAC,SAAS,GAAE,MAAY,GAAG,eAAe,CAO/E;AAsBD,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA+ChF;AAED,wBAAsB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA+EvG"}

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":"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"}

package/dist/core-loop.d.ts

@@ -0,0 +1,61 @@
+import type { StateDiffCalculator } from "./loop/state-diff.js";
+import type { LoopConfig, LoopIterationResult, LoopResult, CoreLoopDeps } from "./loop/core-loop-types.js";
+export type { GapCalculatorModule, DriveScorerModule, ExecutionSummaryParams, ReportingEngine, LoopConfig, ResolvedLoopConfig, LoopIterationResult, LoopResult, CoreLoopDeps, ProgressEvent, ProgressPhase, } from "./loop/core-loop-types.js";
+export { buildDriveContext, makeEmptyIterationResult } from "./loop/core-loop-types.js";
+/**
+ * CoreLoop is the heart of PulSeed — 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;
+    /** Mutable config — may be updated mid-run (e.g. treeMode enabled after decomposition). */
+    private config;
+    private readonly logger?;
+    private stopped;
+    private readonly learning;
+    /** Optional StateDiffCalculator for loop-skip optimization. */
+    private readonly stateDiff?;
+    private stateDiffState;
+    /** Tracks goals that have already been through auto-decompose this run. */
+    private decomposedGoals;
+    constructor(deps: CoreLoopDeps, config?: LoopConfig, stateDiff?: StateDiffCalculator);
+    /**
+     * 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, nodeConsumedMap: Map<string, 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;
+}
+//# 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":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAqB,MAAM,sBAAsB,CAAC;AAQnF,OAAO,KAAK,EACV,UAAU,EAEV,mBAAmB,EACnB,UAAU,EACV,YAAY,EAEb,MAAM,2BAA2B,CAAC;AAwBnC,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,GACd,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAmBxF;;;;;;GAMG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,2FAA2F;IAC3F,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IACrE,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAsB;IACjD,OAAO,CAAC,cAAc,CAA+F;IACrH,2EAA2E;IAC3E,OAAO,CAAC,eAAe,CAAqB;gBAEhC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,mBAAmB;IAcpF;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiN9C;;OAEG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,CAAC;IA0K/B;;;;;OAKG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAK7H;;;;;;;;;;OAUG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAK5E;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,SAAS,IAAI,OAAO;CAIrB"}