@mobrienv/autoloop-harness 0.7.0

package/dist/artifacts.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Run artifacts collection and formatting.
+ * Aggregates event counts, memory stats, guidance stats, commits,
+ * and document artifacts from journal lines.
+ */
+export interface DocumentArtifact {
+    path: string;
+    kind: string;
+    title: string;
+    missing: boolean;
+}
+export interface RunArtifacts {
+    runId: string;
+    preset: string;
+    status: string;
+    durationMs: number;
+    iterations: number;
+    events: {
+        total: number;
+        loop: number;
+        iteration: number;
+        backend: number;
+        review: number;
+        coordination: number;
+        operator: number;
+        routing: number;
+        errors: number;
+    };
+    artifacts: {
+        scratchpadEntries: number;
+        memoryLearnings: number;
+        memoryMeta: number;
+        memoryPreferences: number;
+        guidanceSent: number;
+        guidanceConsumed: number;
+        backpressure: number;
+    };
+    output: {
+        commits: number;
+        filesChanged: number;
+        journalSizeBytes: number;
+    };
+    documents: DocumentArtifact[];
+}
+/**
+ * Collect aggregated artifacts from journal lines and filesystem.
+ */
+export declare function collectArtifacts(lines: string[], projectDir: string, workDir?: string): RunArtifacts;
+/** Format RunArtifacts into a human-readable terminal string. */
+export declare function formatArtifacts(a: RunArtifacts): string;

package/dist/artifacts.js

@@ -0,0 +1,333 @@
+/**
+ * Run artifacts collection and formatting.
+ * Aggregates event counts, memory stats, guidance stats, commits,
+ * and document artifacts from journal lines.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { extname, join } from "node:path";
+import { decodeEvent } from "@mobrienv/autoloop-core";
+import * as config from "@mobrienv/autoloop-core/config";
+import { topicCategory } from "@mobrienv/autoloop-core/journal-format";
+import * as memory from "@mobrienv/autoloop-core/memory";
+/**
+ * Collect aggregated artifacts from journal lines and filesystem.
+ */
+export function collectArtifacts(lines, projectDir, workDir) {
+    const events = {
+        total: 0,
+        loop: 0,
+        iteration: 0,
+        backend: 0,
+        review: 0,
+        coordination: 0,
+        operator: 0,
+        routing: 0,
+        errors: 0,
+    };
+    let runId = "";
+    let preset = "";
+    let status = "unknown";
+    let startTs = "";
+    let endTs = "";
+    let maxIter = 0;
+    let scratchpadEntries = 0;
+    let guidanceSent = 0;
+    let guidanceConsumed = 0;
+    let backpressure = 0;
+    const commits = [];
+    let filesChanged = -1;
+    const documents = [];
+    const documentPaths = new Set();
+    for (const line of lines) {
+        const event = decodeEvent(line);
+        if (!event)
+            continue;
+        events.total++;
+        const cat = topicCategory(event.topic);
+        const key = cat === "error" ? "errors" : cat;
+        if (key in events) {
+            events[key]++;
+        }
+        // Track iteration count
+        if (event.iteration) {
+            const n = Number.parseInt(event.iteration, 10);
+            if (!Number.isNaN(n) && n > maxIter)
+                maxIter = n;
+        }
+        // Extract run metadata from loop.start
+        if (event.topic === "loop.start") {
+            if (event.run)
+                runId = event.run;
+            if (event.shape === "fields") {
+                preset = event.fields.preset ?? preset;
+            }
+            startTs = extractTs(event, line);
+            status = "active";
+        }
+        if (event.topic === "loop.complete") {
+            status = "completed";
+            endTs = extractTs(event, line);
+        }
+        if (event.topic === "loop.stop") {
+            status = "stopped";
+            endTs = extractTs(event, line);
+        }
+        // Scratchpad entries from iteration.finish
+        if (event.topic === "iteration.finish") {
+            scratchpadEntries++;
+        }
+        // Guidance tracking
+        if (event.topic === "operator.guidance")
+            guidanceSent++;
+        if (event.topic === "operator.guidance.consumed")
+            guidanceConsumed++;
+        // Backpressure from event.invalid
+        if (event.topic === "event.invalid")
+            backpressure++;
+        // Commits from slice.committed
+        if (event.topic === "slice.committed" && event.shape === "fields") {
+            const hash = event.fields.commit ?? event.fields.hash ?? "";
+            if (hash)
+                commits.push(hash);
+            const fc = event.fields.files_changed ?? event.fields.filesChanged ?? "";
+            if (fc) {
+                const n = Number.parseInt(fc, 10);
+                if (!Number.isNaN(n))
+                    filesChanged = Math.max(filesChanged, 0) + n;
+            }
+        }
+        // Document artifacts from artifact.created events
+        if (event.topic === "artifact.created" && event.shape === "fields") {
+            const docPath = event.fields.path ?? "";
+            if (docPath && !documentPaths.has(docPath)) {
+                documentPaths.add(docPath);
+                const resolvedDir = workDir ?? projectDir;
+                const fullPath = join(resolvedDir, docPath);
+                documents.push({
+                    path: docPath,
+                    kind: event.fields.kind ?? "other",
+                    title: event.fields.title ?? docPath,
+                    missing: !existsSync(fullPath),
+                });
+            }
+        }
+    }
+    // Fallback: scan for frontmatter if no artifact.created events found
+    if (documents.length === 0 && workDir) {
+        const scanned = scanFrontmatterArtifacts(workDir);
+        for (const doc of scanned) {
+            if (!documentPaths.has(doc.path)) {
+                documentPaths.add(doc.path);
+                documents.push(doc);
+            }
+        }
+    }
+    // Memory stats
+    let memStats = { learnings: 0, meta: 0, preferences: 0 };
+    try {
+        const stats = memory.statsProject(projectDir, 8000);
+        memStats = {
+            learnings: stats.learnings,
+            meta: stats.meta,
+            preferences: stats.preferences,
+        };
+    }
+    catch {
+        // memory file may not exist
+    }
+    // Journal file size
+    let journalSizeBytes = 0;
+    try {
+        const journalPath = config.resolveJournalFile(projectDir);
+        if (existsSync(journalPath)) {
+            journalSizeBytes = statSync(journalPath).size;
+        }
+    }
+    catch {
+        // ignore
+    }
+    // Duration
+    let durationMs = 0;
+    if (startTs && endTs) {
+        const start = new Date(startTs).getTime();
+        const end = new Date(endTs).getTime();
+        if (!Number.isNaN(start) && !Number.isNaN(end)) {
+            durationMs = end - start;
+        }
+    }
+    return {
+        runId,
+        preset,
+        status,
+        durationMs,
+        iterations: maxIter,
+        events,
+        artifacts: {
+            scratchpadEntries,
+            memoryLearnings: memStats.learnings,
+            memoryMeta: memStats.meta,
+            memoryPreferences: memStats.preferences,
+            guidanceSent,
+            guidanceConsumed,
+            backpressure,
+        },
+        output: {
+            commits: commits.length,
+            filesChanged: filesChanged < 0 ? -1 : filesChanged,
+            journalSizeBytes,
+        },
+        documents,
+    };
+}
+/** Format RunArtifacts into a human-readable terminal string. */
+export function formatArtifacts(a) {
+    const lines = [];
+    const statusNote = a.status === "active" ? " (run still active)" : "";
+    const presetLabel = a.preset
+        ? ` (${a.preset}${a.status !== "unknown" ? `, ${a.status}` : ""})`
+        : "";
+    lines.push(`Run: ${a.runId}${presetLabel}${statusNote}`);
+    if (a.durationMs > 0) {
+        lines.push(`Duration: ${formatDuration(a.durationMs)} (${a.iterations} iterations)`);
+    }
+    else {
+        lines.push(`Iterations: ${a.iterations}`);
+    }
+    lines.push("");
+    lines.push("Events");
+    lines.push(`  total           ${a.events.total}`);
+    lines.push(`  loop            ${a.events.loop}`);
+    lines.push(`  iteration       ${a.events.iteration}`);
+    lines.push(`  backend         ${a.events.backend}`);
+    lines.push(`  review          ${a.events.review}`);
+    lines.push(`  coordination    ${a.events.coordination}`);
+    lines.push(`  operator        ${a.events.operator}`);
+    lines.push(`  routing/wave    ${a.events.routing}`);
+    lines.push(`  errors          ${a.events.errors}`);
+    lines.push("");
+    lines.push("Artifacts");
+    lines.push(`  scratchpad      ${a.artifacts.scratchpadEntries} entries`);
+    lines.push(`  memory          ${a.artifacts.memoryLearnings} learnings, ${a.artifacts.memoryMeta} meta, ${a.artifacts.memoryPreferences} preferences`);
+    lines.push(`  guidance        ${a.artifacts.guidanceSent} sent, ${a.artifacts.guidanceConsumed} consumed`);
+    lines.push(`  backpressure    ${a.artifacts.backpressure} rejected event${a.artifacts.backpressure === 1 ? "" : "s"}`);
+    lines.push("");
+    lines.push("Output");
+    lines.push(`  commits         ${a.output.commits}`);
+    lines.push(`  files changed   ${a.output.filesChanged < 0 ? "-" : String(a.output.filesChanged)}`);
+    lines.push(`  journal size    ${formatBytes(a.output.journalSizeBytes)}`);
+    if (a.documents.length > 0) {
+        lines.push("");
+        lines.push("Documents");
+        for (const doc of a.documents) {
+            const label = doc.missing ? " (missing)" : "";
+            const padPath = doc.path.padEnd(42);
+            lines.push(`  ${padPath} ${doc.kind.padEnd(10)} "${doc.title}"${label}`);
+        }
+    }
+    return lines.join("\n");
+}
+function extractTs(event, line) {
+    if (event.shape === "fields") {
+        return event.fields.timestamp ?? event.fields.ts ?? "";
+    }
+    // Try raw line extraction for payload events
+    try {
+        const parsed = JSON.parse(line);
+        return String(parsed.timestamp ?? parsed.ts ?? "");
+    }
+    catch {
+        return "";
+    }
+}
+function formatDuration(ms) {
+    const totalSec = Math.floor(ms / 1000);
+    const min = Math.floor(totalSec / 60);
+    const sec = totalSec % 60;
+    if (min === 0)
+        return `${sec}s`;
+    return `${min}m ${sec}s`;
+}
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return "0 B";
+    if (bytes < 1024)
+        return `${bytes} B`;
+    const kb = bytes / 1024;
+    if (kb < 1024)
+        return `${kb.toFixed(1)} KB`;
+    const mb = kb / 1024;
+    return `${mb.toFixed(1)} MB`;
+}
+/**
+ * Scan a directory for .md files with autoloop frontmatter.
+ * Checks first 20 lines for `autoloop:` in YAML frontmatter.
+ */
+function scanFrontmatterArtifacts(dir) {
+    const results = [];
+    try {
+        scanDir(dir, dir, results, 0);
+    }
+    catch {
+        // ignore filesystem errors
+    }
+    return results;
+}
+function scanDir(baseDir, currentDir, results, depth) {
+    if (depth > 4)
+        return; // limit recursion depth
+    try {
+        const entries = readdirSync(currentDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith(".") &&
+                depth === 0 &&
+                entry.name !== ".autoloop")
+                continue;
+            if (entry.name === "node_modules")
+                continue;
+            if (entry.isSymbolicLink())
+                continue;
+            const fullPath = join(currentDir, entry.name);
+            if (entry.isDirectory()) {
+                scanDir(baseDir, fullPath, results, depth + 1);
+            }
+            else if (entry.isFile() && extname(entry.name) === ".md") {
+                const doc = checkFrontmatter(baseDir, fullPath);
+                if (doc)
+                    results.push(doc);
+            }
+        }
+    }
+    catch {
+        // ignore permission errors etc.
+    }
+}
+function checkFrontmatter(baseDir, filePath) {
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        const firstLines = content.split("\n").slice(0, 20).join("\n");
+        if (!firstLines.includes("autoloop:"))
+            return null;
+        // Must be in YAML frontmatter (between --- markers)
+        if (!firstLines.startsWith("---"))
+            return null;
+        const endIdx = firstLines.indexOf("---", 3);
+        if (endIdx < 0)
+            return null;
+        const fm = firstLines.slice(3, endIdx);
+        if (!fm.includes("autoloop:"))
+            return null;
+        // Extract kind from frontmatter
+        const kindMatch = fm.match(/kind:\s*(\S+)/);
+        const kind = kindMatch?.[1] ?? "other";
+        // Extract title from first heading after frontmatter
+        const afterFm = content.slice(endIdx + 3).trim();
+        const headingMatch = afterFm.match(/^#\s+(.+)/m);
+        const title = headingMatch?.[1]?.trim() ?? filePath.split("/").pop() ?? "";
+        const relPath = filePath.slice(baseDir.length + 1);
+        return { path: relPath, kind, title, missing: false };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/artifacts.js.map

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

package/dist/config-helpers.d.ts

@@ -0,0 +1,36 @@
+import * as config from "@mobrienv/autoloop-core/config";
+import * as topo from "@mobrienv/autoloop-core/topology";
+import type { LoopContext, RunOptions } from "./types.js";
+export declare function resolvePrompt(projectDir: string, cfg: config.Config, override: string | null): string;
+export declare function resolveReviewPrompt(projectDir: string, cfg: config.Config): string;
+export declare function readOptionalProjectFile(projectDir: string, relativePath: string): string;
+export declare function resolveReviewEvery(cfg: config.Config, topoData: topo.Topology): number;
+export declare function truthySetting(value: string): boolean;
+export declare function ensureLayout(stateDir: string): void;
+export declare function installRuntimeTools(loop: LoopContext): void;
+export declare function resolveProcessKind(kind: string, command: string): string;
+export declare function normalizePromptMode(value: string): string;
+export declare function configListWithFallback(cfg: config.Config, key: string, fallback: string[]): string[];
+export declare function injectClaudePermissions(command: string, args: string[]): string[];
+export declare function processStringOverride(override: Record<string, unknown>, key: string, fallback: string): string;
+export declare function processListOverride(override: Record<string, unknown>, key: string, fallback: string[]): string[];
+export declare function processIntOverride(override: Record<string, unknown>, key: string, fallback: number): number;
+export declare function claudeBackend(command: string): boolean;
+export declare function nextRunId(path: string, cfg: config.Config): string;
+export declare function iterationFieldForRun(journalFile: string, runId: string, iteration: string, topic: string, field: string): string;
+export declare function ensureRenderRunId(journalFile: string): string;
+export declare function absolutePath(path: string): string;
+export declare function emptyFallback(text: string): string;
+/**
+ * Resolve the journal file path for a specific run.
+ * Delegates to resolveRunJournalPath for run-scoped/worktree paths,
+ * falling back to the top-level journal.
+ */
+export declare function resolveJournalFileForRun(projectDir: string, runId: string): {
+    journalFile: string;
+    runId: string;
+};
+export declare function buildLoopContext(projectDir: string, promptOverride: string | null, selfCommand: string, runOptions: RunOptions): LoopContext;
+export declare function reloadLoop(loop: LoopContext): LoopContext;
+export declare function applyRuntimeModeOverrides(loop: LoopContext): LoopContext;
+export declare function initStore(loop: LoopContext): LoopContext;