@guyghost/swarm-dao-cli 0.4.5 → 0.6.0

package/dist/roots.d.ts

@@ -0,0 +1,28 @@
+export declare const SERIES_ROOT_CANDIDATES: readonly [".dao/improvement-series", "evidence/improvement-series"];
+export declare const CYCLE_ROOT_CANDIDATES: readonly [".dao/improvement-cycles", "evidence/improvement-cycles"];
+export declare const GRAPH_ROOT_CANDIDATES: readonly [".dao/graph-runs", "evidence/graph-runs"];
+export interface LocatedRoot {
+    /** Absolute resolved root — the flag when given, else the best hit. */
+    root: string;
+    /** True when <root>/<id>/snapshot.json exists. */
+    found: boolean;
+    /** Relative candidates tried (for "not found" messages). */
+    tried: readonly string[];
+}
+/**
+ * Locate an evidence object across candidate roots. When the same id exists
+ * in several roots, a series that has actually started beats a fresh idle
+ * snapshot (running `improve status` without a root flag materializes an idle
+ * series under .dao/ — the operator's real series usually lives elsewhere).
+ */
+export declare function locateRoot(cwd: string, id: string, candidates: readonly string[], explicit?: string): Promise<LocatedRoot>;
+/** Read and parse a JSON file, or null when absent/invalid. */
+export declare function readJsonOrNull(file: string): Promise<unknown>;
+/** First/last journal timestamps as cycle duration, or null when unknowable. */
+export declare function readJournalDurationMs(cycleDir: string): Promise<number | null>;
+/** All cycle directories <root>/<seriesId>-c<N>, sorted by N. */
+export declare function listCycleDirs(cycleRoot: string, seriesId: string): Promise<Array<{
+    number: number;
+    dir: string;
+}>>;
+//# sourceMappingURL=roots.d.ts.map

package/dist/roots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roots.d.ts","sourceRoot":"","sources":["../src/roots.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,sBAAsB,qEAAsE,CAAC;AAC1G,eAAO,MAAM,qBAAqB,qEAAsE,CAAC;AACzG,eAAO,MAAM,qBAAqB,qDAAsD,CAAC;AAEzF,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,KAAK,EAAE,OAAO,CAAC;IACf,4DAA4D;IAC5D,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC,CActB;AAED,+DAA+D;AAC/D,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMnE;AAED,gFAAgF;AAChF,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYpF;AAED,iEAAiE;AACjE,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAYjD"}

package/dist/roots.js

@@ -0,0 +1,78 @@
+// Swarm DAO CLI — evidence-root location.
+//
+// Reads (status, cycles, gates) resolve an existing series/run across the
+// known roots (.dao/* default, evidence/* repo-dogfood convention) instead of
+// silently answering from a fresh idle snapshot. Creation effects (init, once,
+// submit) keep the strict explicit/default root: no silent resolution on
+// writes.
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+export const SERIES_ROOT_CANDIDATES = [".dao/improvement-series", "evidence/improvement-series"];
+export const CYCLE_ROOT_CANDIDATES = [".dao/improvement-cycles", "evidence/improvement-cycles"];
+export const GRAPH_ROOT_CANDIDATES = [".dao/graph-runs", "evidence/graph-runs"];
+/**
+ * Locate an evidence object across candidate roots. When the same id exists
+ * in several roots, a series that has actually started beats a fresh idle
+ * snapshot (running `improve status` without a root flag materializes an idle
+ * series under .dao/ — the operator's real series usually lives elsewhere).
+ */
+export async function locateRoot(cwd, id, candidates, explicit) {
+    const list = explicit ? [explicit] : candidates;
+    let fallback = null;
+    for (const relative of list) {
+        const root = path.resolve(cwd, relative);
+        const parsed = await readJsonOrNull(path.join(root, id, "snapshot.json"));
+        if (parsed === null)
+            continue;
+        const located = { root, found: true, tried: list };
+        const started = parsed.context?.started;
+        if (started === true)
+            return located;
+        fallback ??= located;
+    }
+    if (fallback)
+        return fallback;
+    return { root: path.resolve(cwd, list[0] ?? "."), found: false, tried: list };
+}
+/** Read and parse a JSON file, or null when absent/invalid. */
+export async function readJsonOrNull(file) {
+    try {
+        return JSON.parse(await readFile(file, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+/** First/last journal timestamps as cycle duration, or null when unknowable. */
+export async function readJournalDurationMs(cycleDir) {
+    try {
+        const raw = await readFile(path.join(cycleDir, "journal.ndjson"), "utf8");
+        const lines = raw.split("\n").filter((l) => l.trim().length > 0);
+        if (lines.length === 0)
+            return null;
+        const first = Date.parse(JSON.parse(lines[0] ?? "").receivedAt ?? "");
+        const last = Date.parse(JSON.parse(lines[lines.length - 1] ?? "").receivedAt ?? "");
+        if (!Number.isFinite(first) || !Number.isFinite(last) || last < first)
+            return null;
+        return last - first;
+    }
+    catch {
+        return null;
+    }
+}
+/** All cycle directories <root>/<seriesId>-c<N>, sorted by N. */
+export async function listCycleDirs(cycleRoot, seriesId) {
+    let entries = [];
+    try {
+        entries = await readdir(cycleRoot);
+    }
+    catch {
+        return [];
+    }
+    const prefix = `${seriesId}-c`;
+    return entries
+        .filter((name) => name.startsWith(prefix) && /^\d+$/.test(name.slice(prefix.length)))
+        .map((name) => ({ number: Number(name.slice(prefix.length)), dir: path.join(cycleRoot, name) }))
+        .sort((a, b) => a.number - b.number);
+}
+//# sourceMappingURL=roots.js.map

package/dist/roots.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guyghost/swarm-dao-cli",
-  "version": "0.4.5",
+  "version": "0.6.0",
   "description": "Swarm DAO standalone CLI",
   "type": "module",
   "main": "./dist/cli.js",
@@ -25,7 +25,7 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@guyghost/swarm-dao-core": "^0.12.0",
+    "@guyghost/swarm-dao-core": "^0.12.1",
     "@guyghost/swarm-dao-graph": "^0.3.1",
     "@guyghost/swarm-dao-improvement": "^0.5.3",
     "@guyghost/swarm-dao-product": "^0.3.1"