@hasna/loops 0.3.17 → 0.3.19

package/README.md

@@ -318,9 +318,10 @@ them with `no_tmux_dispatch=true` metadata. Use `--dry-run --json` before
 turning it into a production loop.
 
 `hygiene names` reports canonical `machine-*` or `repo-<name>-*` loop names and
-renames only with `--apply`. `hygiene duplicates` groups loops with the same
-normalized name, cwd, and schedule. `hygiene scripts` inventories loops whose
-command still references `~/.hasna/loops/scripts`.
+renames only with `--apply`. Apply mode writes a SQLite backup under
+`<LOOPS_DATA_DIR>/backups` before changing loop names. `hygiene duplicates`
+groups loops with the same normalized name, cwd, and schedule. `hygiene scripts`
+inventories loops whose command still references `~/.hasna/loops/scripts`.
 
 Archive loops when retiring old automation but preserving history:
 

package/dist/cli/index.js

@@ -2196,8 +2196,10 @@ class Store {
 
 // src/cli/index.ts
 import { createHash as createHash2 } from "crypto";
-import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
+import { existsSync as existsSync3, mkdirSync as mkdirSync5, readFileSync as readFileSync2, writeFileSync as writeFileSync3 } from "fs";
 import { spawnSync as spawnSync5 } from "child_process";
+import { join as join3 } from "path";
+import { Database as Database2 } from "bun:sqlite";
 import { Command } from "commander";
 
 // src/lib/format.ts
@@ -4640,6 +4642,7 @@ function runDoctor(store) {
 // src/lib/health.ts
 import { createHash } from "crypto";
 var EVIDENCE_CHARS = 2000;
+var FINGERPRINT_EVIDENCE_CHARS = 120;
 var CLASSIFICATIONS = [
   "rate_limit",
   "auth",
@@ -4668,6 +4671,15 @@ function stableFingerprint(parts) {
   return createHash("sha256").update(parts.join(`
 `)).digest("hex").slice(0, 16);
 }
+function stableFailureFingerprint(run, classification) {
+  return stableFingerprint([
+    run.loopId,
+    classification,
+    String(run.status),
+    String(run.exitCode ?? ""),
+    (run.error ?? run.stderr ?? run.stdout ?? "").replace(/\d{4}-\d{2}-\d{2}T\S+/g, "<timestamp>").slice(0, FINGERPRINT_EVIDENCE_CHARS)
+  ]);
+}
 function healthRun(run) {
   return {
     ...run,
@@ -4701,14 +4713,7 @@ function classifyRunFailure(run) {
     classification = "sigsegv";
   return {
     classification,
-    fingerprint: stableFingerprint([
-      run.loopId,
-      run.loopName,
-      run.status,
-      classification,
-      String(run.exitCode ?? ""),
-      (run.error ?? run.stderr ?? run.stdout ?? "").slice(0, 500)
-    ]),
+    fingerprint: stableFailureFingerprint(run, classification),
     evidence: {
       error: bounded(run.error),
       stdout: bounded(run.stdout),
@@ -4824,7 +4829,7 @@ function expectationForLoop(store, loop) {
   };
 }
 function buildHealthReport(store, opts = {}) {
-  const loops = store.listLoops({ includeArchived: opts.includeArchived, limit: opts.limit ?? 200 });
+  const loops = store.listLoops({ includeArchived: opts.includeArchived, limit: opts.limit ?? 200 }).filter((loop) => opts.includeInactive || loop.status === "active" || loop.status === "paused");
   const expectations = loops.map((loop) => expectationForLoop(store, loop));
   const classifications = Object.fromEntries(CLASSIFICATIONS.map((key) => [key, 0]));
   for (const expectation of expectations) {
@@ -4928,8 +4933,9 @@ function canonicalName(loop) {
     newName: name
   };
 }
-function ensureUnique(changes) {
-  const used = new Set;
+function ensureUnique(changes, existingNames = []) {
+  const oldNames = new Set(changes.map((change) => change.oldName));
+  const used = new Set([...existingNames].filter((name) => !oldNames.has(name)));
   for (const change of changes) {
     let candidate = change.newName;
     if (!used.has(candidate)) {
@@ -4959,6 +4965,7 @@ function managedLoops(store, opts) {
   return loops.filter((loop) => loop.status === "active" || loop.status === "paused");
 }
 function buildNameHygieneReport(store, opts = {}) {
+  const allLoops = store.listLoops({ includeArchived: true, limit: 1e4 });
   const changes = managedLoops(store, opts).map((loop) => {
     const canonical = canonicalName(loop);
     return {
@@ -4967,8 +4974,9 @@ function buildNameHygieneReport(store, opts = {}) {
       changed: loop.name !== canonical.newName
     };
   });
-  ensureUnique(changes);
+  ensureUnique(changes, allLoops.map((loop) => loop.name));
   const changed = changes.filter((change) => change.changed);
+  const conflicts = changes.filter((change) => allLoops.some((loop) => loop.name === change.newName && loop.id !== change.id));
   if (opts.apply) {
     for (const change of changed)
       store.renameLoop(change.id, change.newName);
@@ -4979,7 +4987,8 @@ function buildNameHygieneReport(store, opts = {}) {
     applied: Boolean(opts.apply),
     checked: changes.length,
     changed: changed.length,
-    changes
+    changes,
+    conflicts
   };
 }
 function baseName(name) {
@@ -5033,14 +5042,33 @@ function commandText(loop) {
     return "";
   return [loop.target.command, ...loop.target.args ?? []].join(" ");
 }
+function scriptNeedles(scriptsDir) {
+  const home = process.env.HOME ?? "/home/hasna";
+  const normalized = scriptsDir.replace(/\/+$/g, "");
+  const values = [
+    normalized,
+    `${normalized}/`,
+    "~/.hasna/loops/scripts",
+    "~/.hasna/loops/scripts/",
+    "$HOME/.hasna/loops/scripts",
+    "$HOME/.hasna/loops/scripts/",
+    "${HOME}/.hasna/loops/scripts",
+    "${HOME}/.hasna/loops/scripts/",
+    `${home}/.hasna/loops/scripts`,
+    `${home}/.hasna/loops/scripts/`,
+    "/.hasna/loops/scripts/"
+  ];
+  return [...new Set(values)];
+}
 function buildScriptInventoryReport(store, opts = {}) {
   const scriptsDir = opts.scriptsDir ?? `${process.env.HOME ?? "/home/hasna"}/.hasna/loops/scripts`;
+  const needles = scriptNeedles(scriptsDir);
   const loops = managedLoops(store, { includeInactive: opts.includeInactive, includeStopped: true, limit: opts.limit });
   const scriptBacked = loops.map((loop) => {
     const text = commandText(loop);
     if (!text)
       return;
-    const matches = [scriptsDir, "/.hasna/loops/scripts/"].filter((needle) => text.includes(needle));
+    const matches = needles.filter((needle) => text.includes(needle));
     if (!matches.length)
       return;
     return {
@@ -5063,7 +5091,7 @@ function buildScriptInventoryReport(store, opts = {}) {
 // package.json
 var package_default = {
   name: "@hasna/loops",
-  version: "0.3.17",
+  version: "0.3.19",
   description: "Persistent local loop and workflow runner for deterministic commands and headless AI coding agents",
   type: "module",
   main: "dist/index.js",
@@ -5433,7 +5461,7 @@ function renderBoundedAgentWorkerVerifierWorkflow(input) {
   ].join(`
 `);
   return {
-    name: input.name ?? `bounded-agent-${stableIndex(seed, 65535).toString(16)}-worker-verifier`,
+    name: input.name ?? `bounded-agent-${stableIndex(seed, 4294967295).toString(16).padStart(8, "0")}-worker-verifier`,
     description: `Bounded worker/verifier workflow for ${input.objective.slice(0, 180)}`,
     version: 1,
     steps: [
@@ -5716,6 +5744,19 @@ function ensureTodosTaskList(project, slug, name, description) {
     throw new Error(`todos task list not found after ensure: ${slug}`);
   return found.id;
 }
+function backupLoopsDatabase(reason) {
+  const stamp = new Date().toISOString().replace(/[-:]/g, "").replace(/\..+$/, "Z");
+  const backupDir = join3(dataDir(), "backups");
+  mkdirSync5(backupDir, { recursive: true, mode: 448 });
+  const backupPath = join3(backupDir, `loops.db.bak-${reason}-${stamp}`);
+  const db = new Database2(dbPath(), { readonly: true });
+  try {
+    writeFileSync3(backupPath, db.serialize(), { mode: 384 });
+  } finally {
+    db.close();
+  }
+  return backupPath;
+}
 function eventData(event) {
   const data = event.data;
   if (data && typeof data === "object" && !Array.isArray(data))
@@ -6468,10 +6509,10 @@ var health = program.command("health").description("summarize loop health and la
     store.close();
   }
 });
-health.command("route-tasks").description("upsert deduped todos tasks for failed loop health expectations").option("--project <path>", "todos project path", defaultLoopsProject()).option("--task-list <slug>", "todos task-list slug", "loop-error-self-heal").option("--limit <n>", "maximum loops to inspect", "200").option("--max-actions <n>", "maximum todos tasks to upsert", "5").option("--dry-run", "print intended task upserts without mutating todos").option("--json", "print JSON").action((opts) => {
+health.command("route-tasks").description("upsert deduped todos tasks for failed loop health expectations").option("--project <path>", "todos project path", defaultLoopsProject()).option("--task-list <slug>", "todos task-list slug", "loop-error-self-heal").option("--limit <n>", "maximum loops to inspect", "200").option("--max-actions <n>", "maximum todos tasks to upsert", "5").option("--include-inactive", "also route stopped or expired loops").option("--dry-run", "print intended task upserts without mutating todos").option("--json", "print JSON").action((opts) => {
   const store = new Store;
   try {
-    const report = buildHealthReport(store, { limit: Number(opts.limit) });
+    const report = buildHealthReport(store, { limit: Number(opts.limit), includeInactive: Boolean(opts.includeInactive) });
     const failures = report.expectations.filter((entry) => !entry.ok && entry.recommendedTask).slice(0, Number(opts.maxActions));
     const listId = opts.dryRun ? undefined : ensureTodosTaskList(opts.project, opts.taskList, "Loop Error Self Heal", "Deduped OpenLoops health expectation failures routed by loops health route-tasks.");
     const actions = failures.map((expectation) => {
@@ -6534,16 +6575,20 @@ var hygiene = program.command("hygiene").description("deterministic OpenLoops hy
 hygiene.command("names").description("check or apply canonical machine-/repo-prefixed loop names").option("--apply", "rename loops in-place").option("--include-stopped", "include stopped loops").option("--include-inactive", "include stopped, expired, and archived loops").option("--limit <n>", "maximum loops to inspect", "1000").option("--json", "print JSON").action((opts) => {
   const store = new Store;
   try {
+    const backupPath = opts.apply ? backupLoopsDatabase("name-hygiene") : undefined;
     const report = buildNameHygieneReport(store, {
       apply: Boolean(opts.apply),
       includeStopped: Boolean(opts.includeStopped),
       includeInactive: Boolean(opts.includeInactive),
       limit: Number(opts.limit)
     });
+    const output = backupPath ? { ...report, backupPath } : report;
     if (isJson() || opts.json)
-      console.log(JSON.stringify(report, null, 2));
+      console.log(JSON.stringify(output, null, 2));
     else {
       console.log(`hygiene_names checked=${report.checked} changed=${report.changed} applied=${report.applied}`);
+      if (backupPath)
+        console.log(`backup=${backupPath}`);
       for (const change of report.changes.filter((entry) => entry.changed)) {
         console.log(`${report.applied ? "renamed" : "would-rename"} ${change.id} ${change.oldName} -> ${change.newName}`);
       }

package/dist/daemon/index.js

@@ -4419,7 +4419,7 @@ function enableStartup(result) {
 // package.json
 var package_default = {
   name: "@hasna/loops",
-  version: "0.3.17",
+  version: "0.3.19",
   description: "Persistent local loop and workflow runner for deterministic commands and headless AI coding agents",
   type: "module",
   main: "dist/index.js",

package/dist/index.js

@@ -4397,7 +4397,7 @@ function renderBoundedAgentWorkerVerifierWorkflow(input) {
   ].join(`
 `);
   return {
-    name: input.name ?? `bounded-agent-${stableIndex(seed, 65535).toString(16)}-worker-verifier`,
+    name: input.name ?? `bounded-agent-${stableIndex(seed, 4294967295).toString(16).padStart(8, "0")}-worker-verifier`,
     description: `Bounded worker/verifier workflow for ${input.objective.slice(0, 180)}`,
     version: 1,
     steps: [
@@ -4735,6 +4735,7 @@ function runDoctor(store) {
 // src/lib/health.ts
 import { createHash } from "crypto";
 var EVIDENCE_CHARS = 2000;
+var FINGERPRINT_EVIDENCE_CHARS = 120;
 var CLASSIFICATIONS = [
   "rate_limit",
   "auth",
@@ -4763,6 +4764,15 @@ function stableFingerprint(parts) {
   return createHash("sha256").update(parts.join(`
 `)).digest("hex").slice(0, 16);
 }
+function stableFailureFingerprint(run, classification) {
+  return stableFingerprint([
+    run.loopId,
+    classification,
+    String(run.status),
+    String(run.exitCode ?? ""),
+    (run.error ?? run.stderr ?? run.stdout ?? "").replace(/\d{4}-\d{2}-\d{2}T\S+/g, "<timestamp>").slice(0, FINGERPRINT_EVIDENCE_CHARS)
+  ]);
+}
 function healthRun(run) {
   return {
     ...run,
@@ -4796,14 +4806,7 @@ function classifyRunFailure(run) {
     classification = "sigsegv";
   return {
     classification,
-    fingerprint: stableFingerprint([
-      run.loopId,
-      run.loopName,
-      run.status,
-      classification,
-      String(run.exitCode ?? ""),
-      (run.error ?? run.stderr ?? run.stdout ?? "").slice(0, 500)
-    ]),
+    fingerprint: stableFailureFingerprint(run, classification),
     evidence: {
       error: bounded(run.error),
       stdout: bounded(run.stdout),
@@ -4919,7 +4922,7 @@ function expectationForLoop(store, loop) {
   };
 }
 function buildHealthReport(store, opts = {}) {
-  const loops2 = store.listLoops({ includeArchived: opts.includeArchived, limit: opts.limit ?? 200 });
+  const loops2 = store.listLoops({ includeArchived: opts.includeArchived, limit: opts.limit ?? 200 }).filter((loop) => opts.includeInactive || loop.status === "active" || loop.status === "paused");
   const expectations = loops2.map((loop) => expectationForLoop(store, loop));
   const classifications = Object.fromEntries(CLASSIFICATIONS.map((key) => [key, 0]));
   for (const expectation of expectations) {
@@ -5022,8 +5025,9 @@ function canonicalName(loop) {
     newName: name
   };
 }
-function ensureUnique(changes) {
-  const used = new Set;
+function ensureUnique(changes, existingNames = []) {
+  const oldNames = new Set(changes.map((change) => change.oldName));
+  const used = new Set([...existingNames].filter((name) => !oldNames.has(name)));
   for (const change of changes) {
     let candidate = change.newName;
     if (!used.has(candidate)) {
@@ -5053,6 +5057,7 @@ function managedLoops(store, opts) {
   return loops2.filter((loop) => loop.status === "active" || loop.status === "paused");
 }
 function buildNameHygieneReport(store, opts = {}) {
+  const allLoops = store.listLoops({ includeArchived: true, limit: 1e4 });
   const changes = managedLoops(store, opts).map((loop) => {
     const canonical = canonicalName(loop);
     return {
@@ -5061,8 +5066,9 @@ function buildNameHygieneReport(store, opts = {}) {
       changed: loop.name !== canonical.newName
     };
   });
-  ensureUnique(changes);
+  ensureUnique(changes, allLoops.map((loop) => loop.name));
   const changed = changes.filter((change) => change.changed);
+  const conflicts = changes.filter((change) => allLoops.some((loop) => loop.name === change.newName && loop.id !== change.id));
   if (opts.apply) {
     for (const change of changed)
       store.renameLoop(change.id, change.newName);
@@ -5073,7 +5079,8 @@ function buildNameHygieneReport(store, opts = {}) {
     applied: Boolean(opts.apply),
     checked: changes.length,
     changed: changed.length,
-    changes
+    changes,
+    conflicts
   };
 }
 function baseName(name) {
@@ -5127,14 +5134,33 @@ function commandText(loop) {
     return "";
   return [loop.target.command, ...loop.target.args ?? []].join(" ");
 }
+function scriptNeedles(scriptsDir) {
+  const home = process.env.HOME ?? "/home/hasna";
+  const normalized = scriptsDir.replace(/\/+$/g, "");
+  const values = [
+    normalized,
+    `${normalized}/`,
+    "~/.hasna/loops/scripts",
+    "~/.hasna/loops/scripts/",
+    "$HOME/.hasna/loops/scripts",
+    "$HOME/.hasna/loops/scripts/",
+    "${HOME}/.hasna/loops/scripts",
+    "${HOME}/.hasna/loops/scripts/",
+    `${home}/.hasna/loops/scripts`,
+    `${home}/.hasna/loops/scripts/`,
+    "/.hasna/loops/scripts/"
+  ];
+  return [...new Set(values)];
+}
 function buildScriptInventoryReport(store, opts = {}) {
   const scriptsDir = opts.scriptsDir ?? `${process.env.HOME ?? "/home/hasna"}/.hasna/loops/scripts`;
+  const needles = scriptNeedles(scriptsDir);
   const loops2 = managedLoops(store, { includeInactive: opts.includeInactive, includeStopped: true, limit: opts.limit });
   const scriptBacked = loops2.map((loop) => {
     const text = commandText(loop);
     if (!text)
       return;
-    const matches = [scriptsDir, "/.hasna/loops/scripts/"].filter((needle) => text.includes(needle));
+    const matches = needles.filter((needle) => text.includes(needle));
     if (!matches.length)
       return;
     return {

package/dist/lib/health.d.ts

@@ -66,5 +66,6 @@ export declare function classifyRunFailure(run: LoopRun): RunFailureSignal | und
 export declare function expectationForLoop(store: Store, loop: Loop): LoopExpectationResult;
 export declare function buildHealthReport(store: Store, opts?: {
     includeArchived?: boolean;
+    includeInactive?: boolean;
     limit?: number;
 }): LoopsHealthReport;

package/dist/lib/hygiene.d.ts

@@ -16,6 +16,7 @@ export interface NameHygieneReport {
     checked: number;
     changed: number;
     changes: NameHygieneChange[];
+    conflicts: NameHygieneChange[];
 }
 export interface DuplicateOverlapGroup {
     key: string;

package/docs/USAGE.md

@@ -325,10 +325,11 @@ loops hygiene scripts --json
 ```
 
 `hygiene names` reports canonical `machine-*` or `repo-<name>-*` loop names and
-only renames when `--apply` is present. `hygiene duplicates` groups loops with
-the same normalized name, cwd, and schedule. `hygiene scripts` inventories loops
-whose command still references `~/.hasna/loops/scripts`; use it as a migration
-gate before deleting local scripts.
+only renames when `--apply` is present. Apply mode writes a SQLite backup under
+`<LOOPS_DATA_DIR>/backups` before changing loop names. `hygiene duplicates`
+groups loops with the same normalized name, cwd, and schedule. `hygiene scripts`
+inventories loops whose command still references `~/.hasna/loops/scripts`; use
+it as a migration gate before deleting local scripts.
 
 Archive loops when retiring old automation but preserving history:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/loops",
-  "version": "0.3.17",
+  "version": "0.3.19",
   "description": "Persistent local loop and workflow runner for deterministic commands and headless AI coding agents",
   "type": "module",
   "main": "dist/index.js",