@phamvuhoang/otto-core 0.10.0 → 0.12.0

package/dist/run-report.js

@@ -0,0 +1,118 @@
+import { mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync, } from "node:fs";
+import { dirname, join } from "node:path";
+/**
+ * Allocate a sortable, filesystem-safe run id: an ISO timestamp with its
+ * colons/periods replaced by dashes, suffixed by the pid to keep concurrent
+ * runs on one host from colliding. Lexicographic order matches chronological
+ * order, so "latest" is a plain string sort. `date`/`pid` are injectable so
+ * tests are deterministic.
+ */
+export function allocateRunId(date = new Date(), pid = process.pid) {
+    const stamp = date.toISOString().replace(/[:.]/g, "-");
+    return `${stamp}-${pid}`;
+}
+const RUNS_REL = join(".otto", "runs");
+/** Absolute path to the workspace's run-bundle root (`.otto/runs`). */
+export function runsDir(workspaceDir) {
+    return join(workspaceDir, RUNS_REL);
+}
+/** Absolute path to one run's bundle dir (`.otto/runs/<run-id>`). */
+export function runReportDir(workspaceDir, runId) {
+    return join(runsDir(workspaceDir), runId);
+}
+/**
+ * List the run ids present under `.otto/runs/`, sorted ascending. Because run
+ * ids are lexicographically sortable (see {@link allocateRunId}), the last
+ * entry is the most recent run — so "latest" is `at(-1)`. Absent/unreadable
+ * dir → `[]` (never throws).
+ */
+export function listRunIds(workspaceDir) {
+    try {
+        return readdirSync(runsDir(workspaceDir), { withFileTypes: true })
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+function manifestPath(workspaceDir, runId) {
+    return join(runReportDir(workspaceDir, runId), "manifest.json");
+}
+function stagesDir(workspaceDir, runId) {
+    return join(runReportDir(workspaceDir, runId), "stages");
+}
+/** Write the run manifest (creates `.otto/runs/<run-id>/`). */
+export function writeManifest(workspaceDir, manifest) {
+    const p = manifestPath(workspaceDir, manifest.runId);
+    mkdirSync(dirname(p), { recursive: true });
+    writeFileSync(p, JSON.stringify(manifest, null, 2) + "\n");
+}
+/** Read a run manifest. Absent or malformed → null (never throws). */
+export function readManifest(workspaceDir, runId) {
+    try {
+        return JSON.parse(readFileSync(manifestPath(workspaceDir, runId), "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write one normalized stage record under the run's `stages/` dir. `seq` is a
+ * monotonic per-run counter that zero-pads into the filename so records sort in
+ * execution order. The stage segment is sanitized to `[A-Za-z0-9_-]` because
+ * panel lens names (from `OTTO_REVIEW_LENSES`) are free text that becomes a
+ * filename. Returns the written basename.
+ */
+export function writeStageRecord(workspaceDir, runId, seq, record) {
+    const dir = stagesDir(workspaceDir, runId);
+    mkdirSync(dir, { recursive: true });
+    const safeStage = record.stage.replace(/[^A-Za-z0-9_-]/g, "-");
+    const name = `${String(seq).padStart(4, "0")}-iter${record.iteration}-${safeStage}.json`;
+    writeFileSync(join(dir, name), JSON.stringify(record, null, 2) + "\n");
+    return name;
+}
+/**
+ * Delete the named stage-record files (basenames from {@link writeStageRecord})
+ * from a run's `stages/` dir. Used to roll back records written by a panel
+ * attempt that later rate-limited and is being retried, so the bundle keeps one
+ * record per stage rather than a duplicate per retry. Best-effort: a missing or
+ * unremovable file is skipped (never throws).
+ */
+export function removeStageRecords(workspaceDir, runId, names) {
+    const dir = stagesDir(workspaceDir, runId);
+    for (const name of names) {
+        try {
+            rmSync(join(dir, name), { force: true });
+        }
+        catch {
+            // Best-effort: never fail a run because a stale record could not be removed.
+        }
+    }
+}
+/**
+ * Read every stage record for a run in execution (seq) order. Absent/unreadable
+ * dir or a malformed entry → the records read so far (never throws); a malformed
+ * file is skipped.
+ */
+export function readStageRecords(workspaceDir, runId) {
+    let names;
+    try {
+        names = readdirSync(stagesDir(workspaceDir, runId));
+    }
+    catch {
+        return [];
+    }
+    const records = [];
+    for (const name of names.filter((n) => n.endsWith(".json")).sort()) {
+        try {
+            records.push(JSON.parse(readFileSync(join(stagesDir(workspaceDir, runId), name), "utf8")));
+        }
+        catch {
+            // Skip a malformed record rather than failing the whole read.
+        }
+    }
+    return records;
+}
+//# sourceMappingURL=run-report.js.map

package/dist/run-report.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phamvuhoang/otto-core",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Claude Code AFK orchestration: iteration loop, native-sandbox runner, template renderer.",
   "type": "module",
   "license": "MIT",