@hasna/workflows 0.1.2 → 0.1.3

package/README.md

@@ -102,7 +102,7 @@ console.log(svc.health());
 |---|---|---|
 | `HASNA_WORKFLOWS_PORT` / `WORKFLOWS_PORT` | serve port | 8790 |
 | `HASNA_WORKFLOWS_HOST` / `WORKFLOWS_HOST` | serve bind host | 127.0.0.1 |
-| `HASNA_WORKFLOWS_DATA_DIR` / `WORKFLOWS_DATA_DIR` | data directory | `~/.hasna/workflows` |
+| `HASNA_WORKFLOWS_DATA_DIR` / `WORKFLOWS_DATA_DIR` | data directory | `~/.hasna/workflows` (the @hasna/paths XDG data home `~/.local/share/hasna/workflows` is adopted once `HASNA_DATA_HOME` is set or the store is migrated there) |
 
 The server data backend is sqlite (default) or postgresql when
 `HASNA_WORKFLOWS_DATABASE_URL` is set.

package/dist/agent-tools.js

@@ -1411,9 +1411,9 @@ class WorkflowsDaemon {
     }
     const output = { ok: result.ok, exitCode: result.exitCode, output: result.output, durationMs: result.durationMs };
     if (!result.ok) {
-      const retriesLeft = (node.maxRetries ?? 0) + 1 - nodeRow.attempts;
-      if (retriesLeft > 0) {
-        this.store.bumpAttemptsNode(nodeRow.id);
+      const shouldRetry = nodeRow.attempts < (node.maxRetries ?? 0);
+      this.store.bumpAttemptsNode(nodeRow.id);
+      if (shouldRetry) {
         this.store.setRunNodeStatus(nodeRow.id, "pending", { error: result.error ?? `exit ${result.exitCode}` });
         return { kind: "advanced", nodeId };
       }

package/dist/cli/index.js

@@ -443,16 +443,13 @@ var init_lanes = __esm(() => {
 
 // src/cli/index.ts
 import { Command } from "commander";
-import { existsSync as existsSync2, mkdirSync as mkdirSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2, rmSync } from "fs";
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2, rmSync } from "fs";
 import { hostname } from "os";
 import { join as join4 } from "path";
-
-// src/service.ts
-import { join as join3 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/workflows",
-  version: "0.1.2",
+  version: "0.1.3",
   description: "Universal graph workflow app \u2014 graph language (start/step/decision/while/end), three-table store, session WAL, daemon with claims/leases, four lane adapters (claude/codex/cursor/grok), and a full CLI on four surfaces",
   type: "module",
   main: "./dist/index.js",
@@ -522,9 +519,10 @@ var package_default = {
   author: "Hasna",
   license: "Apache-2.0",
   dependencies: {
-    "@anthropic-ai/claude-agent-sdk": "^0.3.234",
+    "@anthropic-ai/claude-agent-sdk": "0.3.234",
     "@cursor/sdk": "^1.0.28",
-    "@openai/codex-sdk": "^0.147.0",
+    "@hasna/paths": "0.1.0",
+    "@openai/codex-sdk": "0.147.0",
     commander: "^13.1.0"
   },
   devDependencies: {
@@ -1535,9 +1533,9 @@ class WorkflowsDaemon {
     }
     const output = { ok: result.ok, exitCode: result.exitCode, output: result.output, durationMs: result.durationMs };
     if (!result.ok) {
-      const retriesLeft = (node.maxRetries ?? 0) + 1 - nodeRow.attempts;
-      if (retriesLeft > 0) {
-        this.store.bumpAttemptsNode(nodeRow.id);
+      const shouldRetry = nodeRow.attempts < (node.maxRetries ?? 0);
+      this.store.bumpAttemptsNode(nodeRow.id);
+      if (shouldRetry) {
         this.store.setRunNodeStatus(nodeRow.id, "pending", { error: result.error ?? `exit ${result.exitCode}` });
         return { kind: "advanced", nodeId };
       }
@@ -1669,17 +1667,44 @@ async function runGraphToCompletion(store, wal, graph, context, options = {}) {
   return store.getRun(run.id);
 }
 
+// src/paths.ts
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { dataDir } from "@hasna/paths";
+var APP = "workflows";
+var STORE_DB_FILE = "workflows.db";
+function getHomeDir(env = process.env) {
+  return env["HOME"] || env["USERPROFILE"] || homedir();
+}
+function getLegacyDataDir(env = process.env) {
+  return join(getHomeDir(env), ".hasna", APP);
+}
+function getResolverDataDir(env = process.env) {
+  return dataDir({ app: APP, home: getHomeDir(env), env });
+}
+function adoptResolverDataDir(resolved, env = process.env) {
+  const dataOverride = env.HASNA_DATA_HOME;
+  if (typeof dataOverride === "string" && dataOverride.trim().length > 0)
+    return true;
+  return existsSync(join(resolved, STORE_DB_FILE));
+}
+function getEffectiveDataDir(env = process.env) {
+  const resolved = getResolverDataDir(env);
+  return adoptResolverDataDir(resolved, env) ? resolved : getLegacyDataDir(env);
+}
+
 // src/store.ts
 import { Database } from "bun:sqlite";
 import { mkdirSync } from "fs";
-import { join } from "path";
+import { join as join2 } from "path";
 import { randomUUID } from "crypto";
 function nowIso2() {
   return new Date().toISOString();
 }
-function openStore(dataDir) {
-  mkdirSync(dataDir, { recursive: true });
-  const db = new Database(join(dataDir, "workflows.db"));
+function openStore(dataDir2) {
+  mkdirSync(dataDir2, { recursive: true });
+  const db = new Database(join2(dataDir2, "workflows.db"));
   db.exec("PRAGMA journal_mode = WAL");
   db.exec("PRAGMA foreign_keys = ON");
   db.exec(`
@@ -1857,8 +1882,8 @@ function openStore(dataDir) {
 
 // src/wal.ts
 import { createHash as createHash3 } from "crypto";
-import { appendFileSync, existsSync, mkdirSync as mkdirSync2, readFileSync, renameSync, truncateSync, writeFileSync } from "fs";
-import { join as join2 } from "path";
+import { appendFileSync, existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync, renameSync, truncateSync, writeFileSync } from "fs";
+import { join as join3 } from "path";
 var WAL_FILE_NAME = "session.wal";
 var SESSIONS_DIR_NAME = "sessions";
 var MAX_WAL_BYTES = 256 * 1024 * 1024;
@@ -1873,11 +1898,11 @@ class SessionWAL {
   constructor(filePath) {
     this.filePath = filePath;
   }
-  static open(dataDir) {
-    mkdirSync2(join2(dataDir, SESSIONS_DIR_NAME), { recursive: true });
-    const canonical = join2(dataDir, SESSIONS_DIR_NAME, WAL_FILE_NAME);
-    const legacy = join2(dataDir, WAL_FILE_NAME);
-    if (existsSync(legacy) && !existsSync(canonical)) {
+  static open(dataDir2) {
+    mkdirSync2(join3(dataDir2, SESSIONS_DIR_NAME), { recursive: true });
+    const canonical = join3(dataDir2, SESSIONS_DIR_NAME, WAL_FILE_NAME);
+    const legacy = join3(dataDir2, WAL_FILE_NAME);
+    if (existsSync2(legacy) && !existsSync2(canonical)) {
       try {
         renameSync(legacy, canonical);
       } catch {
@@ -2008,11 +2033,10 @@ function envInt(names, fallback) {
   return Number.isFinite(parsed) ? parsed : fallback;
 }
 function resolveWorkflowsConfig(overrides = {}) {
-  const home = process.env.HOME ?? process.env.USERPROFILE ?? ".";
   return {
     port: overrides.port ?? envInt(["HASNA_WORKFLOWS_PORT", "WORKFLOWS_PORT"], DEFAULT_PORT),
     host: overrides.host ?? envString(["HASNA_WORKFLOWS_HOST", "WORKFLOWS_HOST"]) ?? DEFAULT_HOST,
-    dataDir: overrides.dataDir ?? envString(["HASNA_WORKFLOWS_DATA_DIR", "WORKFLOWS_DATA_DIR"]) ?? join3(home, ".hasna", "workflows"),
+    dataDir: overrides.dataDir ?? envString(["HASNA_WORKFLOWS_DATA_DIR", "WORKFLOWS_DATA_DIR"]) ?? getEffectiveDataDir(),
     apiUrl: overrides.apiUrl ?? envString(["WORKFLOWS_API_URL"]),
     apiKey: overrides.apiKey ?? envString(["WORKFLOWS_API_KEY"])
   };
@@ -2403,7 +2427,7 @@ program.command("init").description("Create the store layout (workflows/, sessio
   const store = openStore(config.dataDir);
   store.close();
   const target = file ?? join4(config.dataDir, "workflows", "demo.json");
-  if (existsSync2(target)) {
+  if (existsSync3(target)) {
     console.error(`refusing to overwrite existing file ${target}`);
     process.exit(1);
   }
@@ -2690,16 +2714,16 @@ program.command("machines").description("List observed machines or report this m
       case "status": {
         const replay = wal.replay();
         const pidFile = join4(config.dataDir, "daemon.pid");
-        const pid = existsSync2(pidFile) ? readFileSync2(pidFile, "utf8").trim() : null;
+        const pid = existsSync3(pidFile) ? readFileSync2(pidFile, "utf8").trim() : null;
         const running = pid !== null && processAlive(Number(pid));
         const report = {
           hostname: hostname(),
           pid: process.pid,
           dataDir: config.dataDir,
           layout: {
-            workflows: existsSync2(join4(config.dataDir, "workflows")),
-            sessions: existsSync2(join4(config.dataDir, SESSIONS_DIR_NAME)),
-            db: existsSync2(join4(config.dataDir, "workflows.db"))
+            workflows: existsSync3(join4(config.dataDir, "workflows")),
+            sessions: existsSync3(join4(config.dataDir, SESSIONS_DIR_NAME)),
+            db: existsSync3(join4(config.dataDir, "workflows.db"))
           },
           store: {
             tables: store.listTables(),
@@ -2812,7 +2836,7 @@ program.command("daemon").description("Run or inspect the daemon").argument("<ac
       }
     }
     case "status": {
-      if (!existsSync2(statusFile)) {
+      if (!existsSync3(statusFile)) {
         if (opts.json) {
           console.log(JSON.stringify({ running: false, lastReap: null }));
         } else {
@@ -2821,7 +2845,7 @@ program.command("daemon").description("Run or inspect the daemon").argument("<ac
         return;
       }
       const lastReap = JSON.parse(readFileSync2(statusFile, "utf8"));
-      const pid = existsSync2(pidFile) ? readFileSync2(pidFile, "utf8").trim() : null;
+      const pid = existsSync3(pidFile) ? readFileSync2(pidFile, "utf8").trim() : null;
       const running = pid !== null && processAlive(Number(pid));
       if (opts.json) {
         console.log(JSON.stringify({ running, pid, lastReap }, null, 2));
@@ -2831,7 +2855,7 @@ program.command("daemon").description("Run or inspect the daemon").argument("<ac
       return;
     }
     case "stop": {
-      if (!existsSync2(pidFile)) {
+      if (!existsSync3(pidFile)) {
         console.error("no daemon pid file \u2014 nothing to stop");
         process.exit(1);
       }

package/dist/index.js

@@ -439,13 +439,10 @@ var init_lanes = __esm(() => {
     ["grok", createGrokAdapter()]
   ]);
 });
-
-// src/service.ts
-import { join as join3 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/workflows",
-  version: "0.1.2",
+  version: "0.1.3",
   description: "Universal graph workflow app \u2014 graph language (start/step/decision/while/end), three-table store, session WAL, daemon with claims/leases, four lane adapters (claude/codex/cursor/grok), and a full CLI on four surfaces",
   type: "module",
   main: "./dist/index.js",
@@ -515,9 +512,10 @@ var package_default = {
   author: "Hasna",
   license: "Apache-2.0",
   dependencies: {
-    "@anthropic-ai/claude-agent-sdk": "^0.3.234",
+    "@anthropic-ai/claude-agent-sdk": "0.3.234",
     "@cursor/sdk": "^1.0.28",
-    "@openai/codex-sdk": "^0.147.0",
+    "@hasna/paths": "0.1.0",
+    "@openai/codex-sdk": "0.147.0",
     commander: "^13.1.0"
   },
   devDependencies: {
@@ -1500,9 +1498,9 @@ class WorkflowsDaemon {
     }
     const output = { ok: result.ok, exitCode: result.exitCode, output: result.output, durationMs: result.durationMs };
     if (!result.ok) {
-      const retriesLeft = (node.maxRetries ?? 0) + 1 - nodeRow.attempts;
-      if (retriesLeft > 0) {
-        this.store.bumpAttemptsNode(nodeRow.id);
+      const shouldRetry = nodeRow.attempts < (node.maxRetries ?? 0);
+      this.store.bumpAttemptsNode(nodeRow.id);
+      if (shouldRetry) {
         this.store.setRunNodeStatus(nodeRow.id, "pending", { error: result.error ?? `exit ${result.exitCode}` });
         return { kind: "advanced", nodeId };
       }
@@ -1634,17 +1632,44 @@ async function runGraphToCompletion(store, wal, graph, context, options = {}) {
   return store.getRun(run.id);
 }
 
+// src/paths.ts
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { dataDir } from "@hasna/paths";
+var APP = "workflows";
+var STORE_DB_FILE = "workflows.db";
+function getHomeDir(env = process.env) {
+  return env["HOME"] || env["USERPROFILE"] || homedir();
+}
+function getLegacyDataDir(env = process.env) {
+  return join(getHomeDir(env), ".hasna", APP);
+}
+function getResolverDataDir(env = process.env) {
+  return dataDir({ app: APP, home: getHomeDir(env), env });
+}
+function adoptResolverDataDir(resolved, env = process.env) {
+  const dataOverride = env.HASNA_DATA_HOME;
+  if (typeof dataOverride === "string" && dataOverride.trim().length > 0)
+    return true;
+  return existsSync(join(resolved, STORE_DB_FILE));
+}
+function getEffectiveDataDir(env = process.env) {
+  const resolved = getResolverDataDir(env);
+  return adoptResolverDataDir(resolved, env) ? resolved : getLegacyDataDir(env);
+}
+
 // src/store.ts
 import { Database } from "bun:sqlite";
 import { mkdirSync } from "fs";
-import { join } from "path";
+import { join as join2 } from "path";
 import { randomUUID } from "crypto";
 function nowIso2() {
   return new Date().toISOString();
 }
-function openStore(dataDir) {
-  mkdirSync(dataDir, { recursive: true });
-  const db = new Database(join(dataDir, "workflows.db"));
+function openStore(dataDir2) {
+  mkdirSync(dataDir2, { recursive: true });
+  const db = new Database(join2(dataDir2, "workflows.db"));
   db.exec("PRAGMA journal_mode = WAL");
   db.exec("PRAGMA foreign_keys = ON");
   db.exec(`
@@ -1822,8 +1847,8 @@ function openStore(dataDir) {
 
 // src/wal.ts
 import { createHash as createHash3 } from "crypto";
-import { appendFileSync, existsSync, mkdirSync as mkdirSync2, readFileSync, renameSync, truncateSync, writeFileSync } from "fs";
-import { join as join2 } from "path";
+import { appendFileSync, existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync, renameSync, truncateSync, writeFileSync } from "fs";
+import { join as join3 } from "path";
 var WAL_FILE_NAME = "session.wal";
 var SESSIONS_DIR_NAME = "sessions";
 var MAX_WAL_BYTES = 256 * 1024 * 1024;
@@ -1838,11 +1863,11 @@ class SessionWAL {
   constructor(filePath) {
     this.filePath = filePath;
   }
-  static open(dataDir) {
-    mkdirSync2(join2(dataDir, SESSIONS_DIR_NAME), { recursive: true });
-    const canonical = join2(dataDir, SESSIONS_DIR_NAME, WAL_FILE_NAME);
-    const legacy = join2(dataDir, WAL_FILE_NAME);
-    if (existsSync(legacy) && !existsSync(canonical)) {
+  static open(dataDir2) {
+    mkdirSync2(join3(dataDir2, SESSIONS_DIR_NAME), { recursive: true });
+    const canonical = join3(dataDir2, SESSIONS_DIR_NAME, WAL_FILE_NAME);
+    const legacy = join3(dataDir2, WAL_FILE_NAME);
+    if (existsSync2(legacy) && !existsSync2(canonical)) {
       try {
         renameSync(legacy, canonical);
       } catch {
@@ -1973,11 +1998,10 @@ function envInt(names, fallback) {
   return Number.isFinite(parsed) ? parsed : fallback;
 }
 function resolveWorkflowsConfig(overrides = {}) {
-  const home = process.env.HOME ?? process.env.USERPROFILE ?? ".";
   return {
     port: overrides.port ?? envInt(["HASNA_WORKFLOWS_PORT", "WORKFLOWS_PORT"], DEFAULT_PORT),
     host: overrides.host ?? envString(["HASNA_WORKFLOWS_HOST", "WORKFLOWS_HOST"]) ?? DEFAULT_HOST,
-    dataDir: overrides.dataDir ?? envString(["HASNA_WORKFLOWS_DATA_DIR", "WORKFLOWS_DATA_DIR"]) ?? join3(home, ".hasna", "workflows"),
+    dataDir: overrides.dataDir ?? envString(["HASNA_WORKFLOWS_DATA_DIR", "WORKFLOWS_DATA_DIR"]) ?? getEffectiveDataDir(),
     apiUrl: overrides.apiUrl ?? envString(["WORKFLOWS_API_URL"]),
     apiKey: overrides.apiKey ?? envString(["WORKFLOWS_API_KEY"])
   };

package/dist/mcp/index.js

@@ -1415,9 +1415,9 @@ class WorkflowsDaemon {
     }
     const output = { ok: result.ok, exitCode: result.exitCode, output: result.output, durationMs: result.durationMs };
     if (!result.ok) {
-      const retriesLeft = (node.maxRetries ?? 0) + 1 - nodeRow.attempts;
-      if (retriesLeft > 0) {
-        this.store.bumpAttemptsNode(nodeRow.id);
+      const shouldRetry = nodeRow.attempts < (node.maxRetries ?? 0);
+      this.store.bumpAttemptsNode(nodeRow.id);
+      if (shouldRetry) {
         this.store.setRunNodeStatus(nodeRow.id, "pending", { error: result.error ?? `exit ${result.exitCode}` });
         return { kind: "advanced", nodeId };
       }
@@ -1974,13 +1974,10 @@ async function callWorkflowTool(service, name, args) {
       throw new Error(`Unknown tool: ${name}`);
   }
 }
-
-// src/service.ts
-import { join as join3 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/workflows",
-  version: "0.1.2",
+  version: "0.1.3",
   description: "Universal graph workflow app \u2014 graph language (start/step/decision/while/end), three-table store, session WAL, daemon with claims/leases, four lane adapters (claude/codex/cursor/grok), and a full CLI on four surfaces",
   type: "module",
   main: "./dist/index.js",
@@ -2050,9 +2047,10 @@ var package_default = {
   author: "Hasna",
   license: "Apache-2.0",
   dependencies: {
-    "@anthropic-ai/claude-agent-sdk": "^0.3.234",
+    "@anthropic-ai/claude-agent-sdk": "0.3.234",
     "@cursor/sdk": "^1.0.28",
-    "@openai/codex-sdk": "^0.147.0",
+    "@hasna/paths": "0.1.0",
+    "@openai/codex-sdk": "0.147.0",
     commander: "^13.1.0"
   },
   devDependencies: {
@@ -2064,6 +2062,33 @@ var package_default = {
   }
 };
 
+// src/paths.ts
+import { existsSync as existsSync2 } from "fs";
+import { homedir } from "os";
+import { join as join3 } from "path";
+import { dataDir } from "@hasna/paths";
+var APP = "workflows";
+var STORE_DB_FILE = "workflows.db";
+function getHomeDir(env = process.env) {
+  return env["HOME"] || env["USERPROFILE"] || homedir();
+}
+function getLegacyDataDir(env = process.env) {
+  return join3(getHomeDir(env), ".hasna", APP);
+}
+function getResolverDataDir(env = process.env) {
+  return dataDir({ app: APP, home: getHomeDir(env), env });
+}
+function adoptResolverDataDir(resolved, env = process.env) {
+  const dataOverride = env.HASNA_DATA_HOME;
+  if (typeof dataOverride === "string" && dataOverride.trim().length > 0)
+    return true;
+  return existsSync2(join3(resolved, STORE_DB_FILE));
+}
+function getEffectiveDataDir(env = process.env) {
+  const resolved = getResolverDataDir(env);
+  return adoptResolverDataDir(resolved, env) ? resolved : getLegacyDataDir(env);
+}
+
 // src/service.ts
 var DEFAULT_PORT = 8790;
 var DEFAULT_HOST = "127.0.0.1";
@@ -2086,11 +2111,10 @@ function envInt(names, fallback) {
   return Number.isFinite(parsed) ? parsed : fallback;
 }
 function resolveWorkflowsConfig(overrides = {}) {
-  const home = process.env.HOME ?? process.env.USERPROFILE ?? ".";
   return {
     port: overrides.port ?? envInt(["HASNA_WORKFLOWS_PORT", "WORKFLOWS_PORT"], DEFAULT_PORT),
     host: overrides.host ?? envString(["HASNA_WORKFLOWS_HOST", "WORKFLOWS_HOST"]) ?? DEFAULT_HOST,
-    dataDir: overrides.dataDir ?? envString(["HASNA_WORKFLOWS_DATA_DIR", "WORKFLOWS_DATA_DIR"]) ?? join3(home, ".hasna", "workflows"),
+    dataDir: overrides.dataDir ?? envString(["HASNA_WORKFLOWS_DATA_DIR", "WORKFLOWS_DATA_DIR"]) ?? getEffectiveDataDir(),
     apiUrl: overrides.apiUrl ?? envString(["WORKFLOWS_API_URL"]),
     apiKey: overrides.apiKey ?? envString(["WORKFLOWS_API_KEY"])
   };

package/dist/serve/index.js

@@ -440,13 +440,10 @@ var init_lanes = __esm(() => {
     ["grok", createGrokAdapter()]
   ]);
 });
-
-// src/service.ts
-import { join as join3 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/workflows",
-  version: "0.1.2",
+  version: "0.1.3",
   description: "Universal graph workflow app \u2014 graph language (start/step/decision/while/end), three-table store, session WAL, daemon with claims/leases, four lane adapters (claude/codex/cursor/grok), and a full CLI on four surfaces",
   type: "module",
   main: "./dist/index.js",
@@ -516,9 +513,10 @@ var package_default = {
   author: "Hasna",
   license: "Apache-2.0",
   dependencies: {
-    "@anthropic-ai/claude-agent-sdk": "^0.3.234",
+    "@anthropic-ai/claude-agent-sdk": "0.3.234",
     "@cursor/sdk": "^1.0.28",
-    "@openai/codex-sdk": "^0.147.0",
+    "@hasna/paths": "0.1.0",
+    "@openai/codex-sdk": "0.147.0",
     commander: "^13.1.0"
   },
   devDependencies: {
@@ -1501,9 +1499,9 @@ class WorkflowsDaemon {
     }
     const output = { ok: result.ok, exitCode: result.exitCode, output: result.output, durationMs: result.durationMs };
     if (!result.ok) {
-      const retriesLeft = (node.maxRetries ?? 0) + 1 - nodeRow.attempts;
-      if (retriesLeft > 0) {
-        this.store.bumpAttemptsNode(nodeRow.id);
+      const shouldRetry = nodeRow.attempts < (node.maxRetries ?? 0);
+      this.store.bumpAttemptsNode(nodeRow.id);
+      if (shouldRetry) {
         this.store.setRunNodeStatus(nodeRow.id, "pending", { error: result.error ?? `exit ${result.exitCode}` });
         return { kind: "advanced", nodeId };
       }
@@ -1635,17 +1633,44 @@ async function runGraphToCompletion(store, wal, graph, context, options = {}) {
   return store.getRun(run.id);
 }
 
+// src/paths.ts
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { dataDir } from "@hasna/paths";
+var APP = "workflows";
+var STORE_DB_FILE = "workflows.db";
+function getHomeDir(env = process.env) {
+  return env["HOME"] || env["USERPROFILE"] || homedir();
+}
+function getLegacyDataDir(env = process.env) {
+  return join(getHomeDir(env), ".hasna", APP);
+}
+function getResolverDataDir(env = process.env) {
+  return dataDir({ app: APP, home: getHomeDir(env), env });
+}
+function adoptResolverDataDir(resolved, env = process.env) {
+  const dataOverride = env.HASNA_DATA_HOME;
+  if (typeof dataOverride === "string" && dataOverride.trim().length > 0)
+    return true;
+  return existsSync(join(resolved, STORE_DB_FILE));
+}
+function getEffectiveDataDir(env = process.env) {
+  const resolved = getResolverDataDir(env);
+  return adoptResolverDataDir(resolved, env) ? resolved : getLegacyDataDir(env);
+}
+
 // src/store.ts
 import { Database } from "bun:sqlite";
 import { mkdirSync } from "fs";
-import { join } from "path";
+import { join as join2 } from "path";
 import { randomUUID } from "crypto";
 function nowIso2() {
   return new Date().toISOString();
 }
-function openStore(dataDir) {
-  mkdirSync(dataDir, { recursive: true });
-  const db = new Database(join(dataDir, "workflows.db"));
+function openStore(dataDir2) {
+  mkdirSync(dataDir2, { recursive: true });
+  const db = new Database(join2(dataDir2, "workflows.db"));
   db.exec("PRAGMA journal_mode = WAL");
   db.exec("PRAGMA foreign_keys = ON");
   db.exec(`
@@ -1823,8 +1848,8 @@ function openStore(dataDir) {
 
 // src/wal.ts
 import { createHash as createHash3 } from "crypto";
-import { appendFileSync, existsSync, mkdirSync as mkdirSync2, readFileSync, renameSync, truncateSync, writeFileSync } from "fs";
-import { join as join2 } from "path";
+import { appendFileSync, existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync, renameSync, truncateSync, writeFileSync } from "fs";
+import { join as join3 } from "path";
 var WAL_FILE_NAME = "session.wal";
 var SESSIONS_DIR_NAME = "sessions";
 var MAX_WAL_BYTES = 256 * 1024 * 1024;
@@ -1839,11 +1864,11 @@ class SessionWAL {
   constructor(filePath) {
     this.filePath = filePath;
   }
-  static open(dataDir) {
-    mkdirSync2(join2(dataDir, SESSIONS_DIR_NAME), { recursive: true });
-    const canonical = join2(dataDir, SESSIONS_DIR_NAME, WAL_FILE_NAME);
-    const legacy = join2(dataDir, WAL_FILE_NAME);
-    if (existsSync(legacy) && !existsSync(canonical)) {
+  static open(dataDir2) {
+    mkdirSync2(join3(dataDir2, SESSIONS_DIR_NAME), { recursive: true });
+    const canonical = join3(dataDir2, SESSIONS_DIR_NAME, WAL_FILE_NAME);
+    const legacy = join3(dataDir2, WAL_FILE_NAME);
+    if (existsSync2(legacy) && !existsSync2(canonical)) {
       try {
         renameSync(legacy, canonical);
       } catch {
@@ -1974,11 +1999,10 @@ function envInt(names, fallback) {
   return Number.isFinite(parsed) ? parsed : fallback;
 }
 function resolveWorkflowsConfig(overrides = {}) {
-  const home = process.env.HOME ?? process.env.USERPROFILE ?? ".";
   return {
     port: overrides.port ?? envInt(["HASNA_WORKFLOWS_PORT", "WORKFLOWS_PORT"], DEFAULT_PORT),
     host: overrides.host ?? envString(["HASNA_WORKFLOWS_HOST", "WORKFLOWS_HOST"]) ?? DEFAULT_HOST,
-    dataDir: overrides.dataDir ?? envString(["HASNA_WORKFLOWS_DATA_DIR", "WORKFLOWS_DATA_DIR"]) ?? join3(home, ".hasna", "workflows"),
+    dataDir: overrides.dataDir ?? envString(["HASNA_WORKFLOWS_DATA_DIR", "WORKFLOWS_DATA_DIR"]) ?? getEffectiveDataDir(),
     apiUrl: overrides.apiUrl ?? envString(["WORKFLOWS_API_URL"]),
     apiKey: overrides.apiKey ?? envString(["WORKFLOWS_API_KEY"])
   };

package/dist/service.js

@@ -439,13 +439,10 @@ var init_lanes = __esm(() => {
     ["grok", createGrokAdapter()]
   ]);
 });
-
-// src/service.ts
-import { join as join3 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/workflows",
-  version: "0.1.2",
+  version: "0.1.3",
   description: "Universal graph workflow app \u2014 graph language (start/step/decision/while/end), three-table store, session WAL, daemon with claims/leases, four lane adapters (claude/codex/cursor/grok), and a full CLI on four surfaces",
   type: "module",
   main: "./dist/index.js",
@@ -515,9 +512,10 @@ var package_default = {
   author: "Hasna",
   license: "Apache-2.0",
   dependencies: {
-    "@anthropic-ai/claude-agent-sdk": "^0.3.234",
+    "@anthropic-ai/claude-agent-sdk": "0.3.234",
     "@cursor/sdk": "^1.0.28",
-    "@openai/codex-sdk": "^0.147.0",
+    "@hasna/paths": "0.1.0",
+    "@openai/codex-sdk": "0.147.0",
     commander: "^13.1.0"
   },
   devDependencies: {
@@ -1500,9 +1498,9 @@ class WorkflowsDaemon {
     }
     const output = { ok: result.ok, exitCode: result.exitCode, output: result.output, durationMs: result.durationMs };
     if (!result.ok) {
-      const retriesLeft = (node.maxRetries ?? 0) + 1 - nodeRow.attempts;
-      if (retriesLeft > 0) {
-        this.store.bumpAttemptsNode(nodeRow.id);
+      const shouldRetry = nodeRow.attempts < (node.maxRetries ?? 0);
+      this.store.bumpAttemptsNode(nodeRow.id);
+      if (shouldRetry) {
         this.store.setRunNodeStatus(nodeRow.id, "pending", { error: result.error ?? `exit ${result.exitCode}` });
         return { kind: "advanced", nodeId };
       }
@@ -1634,17 +1632,44 @@ async function runGraphToCompletion(store, wal, graph, context, options = {}) {
   return store.getRun(run.id);
 }
 
+// src/paths.ts
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { dataDir } from "@hasna/paths";
+var APP = "workflows";
+var STORE_DB_FILE = "workflows.db";
+function getHomeDir(env = process.env) {
+  return env["HOME"] || env["USERPROFILE"] || homedir();
+}
+function getLegacyDataDir(env = process.env) {
+  return join(getHomeDir(env), ".hasna", APP);
+}
+function getResolverDataDir(env = process.env) {
+  return dataDir({ app: APP, home: getHomeDir(env), env });
+}
+function adoptResolverDataDir(resolved, env = process.env) {
+  const dataOverride = env.HASNA_DATA_HOME;
+  if (typeof dataOverride === "string" && dataOverride.trim().length > 0)
+    return true;
+  return existsSync(join(resolved, STORE_DB_FILE));
+}
+function getEffectiveDataDir(env = process.env) {
+  const resolved = getResolverDataDir(env);
+  return adoptResolverDataDir(resolved, env) ? resolved : getLegacyDataDir(env);
+}
+
 // src/store.ts
 import { Database } from "bun:sqlite";
 import { mkdirSync } from "fs";
-import { join } from "path";
+import { join as join2 } from "path";
 import { randomUUID } from "crypto";
 function nowIso2() {
   return new Date().toISOString();
 }
-function openStore(dataDir) {
-  mkdirSync(dataDir, { recursive: true });
-  const db = new Database(join(dataDir, "workflows.db"));
+function openStore(dataDir2) {
+  mkdirSync(dataDir2, { recursive: true });
+  const db = new Database(join2(dataDir2, "workflows.db"));
   db.exec("PRAGMA journal_mode = WAL");
   db.exec("PRAGMA foreign_keys = ON");
   db.exec(`
@@ -1822,8 +1847,8 @@ function openStore(dataDir) {
 
 // src/wal.ts
 import { createHash as createHash3 } from "crypto";
-import { appendFileSync, existsSync, mkdirSync as mkdirSync2, readFileSync, renameSync, truncateSync, writeFileSync } from "fs";
-import { join as join2 } from "path";
+import { appendFileSync, existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync, renameSync, truncateSync, writeFileSync } from "fs";
+import { join as join3 } from "path";
 var WAL_FILE_NAME = "session.wal";
 var SESSIONS_DIR_NAME = "sessions";
 var MAX_WAL_BYTES = 256 * 1024 * 1024;
@@ -1838,11 +1863,11 @@ class SessionWAL {
   constructor(filePath) {
     this.filePath = filePath;
   }
-  static open(dataDir) {
-    mkdirSync2(join2(dataDir, SESSIONS_DIR_NAME), { recursive: true });
-    const canonical = join2(dataDir, SESSIONS_DIR_NAME, WAL_FILE_NAME);
-    const legacy = join2(dataDir, WAL_FILE_NAME);
-    if (existsSync(legacy) && !existsSync(canonical)) {
+  static open(dataDir2) {
+    mkdirSync2(join3(dataDir2, SESSIONS_DIR_NAME), { recursive: true });
+    const canonical = join3(dataDir2, SESSIONS_DIR_NAME, WAL_FILE_NAME);
+    const legacy = join3(dataDir2, WAL_FILE_NAME);
+    if (existsSync2(legacy) && !existsSync2(canonical)) {
       try {
         renameSync(legacy, canonical);
       } catch {
@@ -1973,11 +1998,10 @@ function envInt(names, fallback) {
   return Number.isFinite(parsed) ? parsed : fallback;
 }
 function resolveWorkflowsConfig(overrides = {}) {
-  const home = process.env.HOME ?? process.env.USERPROFILE ?? ".";
   return {
     port: overrides.port ?? envInt(["HASNA_WORKFLOWS_PORT", "WORKFLOWS_PORT"], DEFAULT_PORT),
     host: overrides.host ?? envString(["HASNA_WORKFLOWS_HOST", "WORKFLOWS_HOST"]) ?? DEFAULT_HOST,
-    dataDir: overrides.dataDir ?? envString(["HASNA_WORKFLOWS_DATA_DIR", "WORKFLOWS_DATA_DIR"]) ?? join3(home, ".hasna", "workflows"),
+    dataDir: overrides.dataDir ?? envString(["HASNA_WORKFLOWS_DATA_DIR", "WORKFLOWS_DATA_DIR"]) ?? getEffectiveDataDir(),
     apiUrl: overrides.apiUrl ?? envString(["WORKFLOWS_API_URL"]),
     apiKey: overrides.apiKey ?? envString(["WORKFLOWS_API_KEY"])
   };

package/hasna.contract.json

@@ -4,7 +4,7 @@
   "class": "service",
   "contractVersion": "v1",
   "kitVersion": "0.14.1",
-  "description": "Universal graph workflow app: graph language (start/step/decision/while/end), three-table run store, session WAL, claims/leases daemon, four lane adapters (claude, codex, cursor, grok), and a full CLI on four surfaces (CLI, MCP, serve, SDK).",
+  "description": "Universal graph workflow app: graph language (start/step/decision/while/end), three-table run store, session WAL, claims/leases daemon, four lane adapters (claude, codex, cursor, grok), and a full CLI on four surfaces (CLI, MCP, serve, SDK). Local state lives at the effective workflows data home (~/.hasna/workflows by default, resolved via @hasna/paths; the XDG data home is adopted once the store is migrated there or HASNA_DATA_HOME is set).",
   "bins": [
     "workflows",
     "workflows-mcp",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/workflows",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Universal graph workflow app — graph language (start/step/decision/while/end), three-table store, session WAL, daemon with claims/leases, four lane adapters (claude/codex/cursor/grok), and a full CLI on four surfaces",
   "type": "module",
   "main": "./dist/index.js",
@@ -70,9 +70,10 @@
   "author": "Hasna",
   "license": "Apache-2.0",
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.3.234",
+    "@anthropic-ai/claude-agent-sdk": "0.3.234",
     "@cursor/sdk": "^1.0.28",
-    "@openai/codex-sdk": "^0.147.0",
+    "@hasna/paths": "0.1.0",
+    "@openai/codex-sdk": "0.147.0",
     "commander": "^13.1.0"
   },
   "devDependencies": {

package/types/paths.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Workflows data-home resolution — the effective local data home for the
+ * @hasna/workflows package, resolved through @hasna/paths.
+ *
+ * Resolution order:
+ *   1. exact-app override — `HASNA_WORKFLOWS_DATA_DIR` / `WORKFLOWS_DATA_DIR`
+ *      (the shipped overrides, applied in `resolveWorkflowsConfig`) — wins
+ *      unconditionally;
+ *   2. the @hasna/paths data home (XDG / macOS home layout) once adopted;
+ *   3. otherwise the legacy `~/.hasna/workflows` default.
+ *
+ * Gated legacy adoption: the legacy `~/.hasna/workflows` home stays effective
+ * until the store has actually been migrated to the XDG data home
+ * (`workflows.db` exists at the resolver home) or the operator sets the
+ * data-kind override `HASNA_DATA_HOME`. An existing local store never becomes
+ * invisible on upgrade.
+ */
+/** The workflows app slug used by the @hasna/paths resolver. */
+export declare const APP: "workflows";
+/** The store database file name, the marker that a store lives at a data home. */
+export declare const STORE_DB_FILE = "workflows.db";
+/**
+ * The effective user home, mirroring the pre-existing resolution
+ * (`HOME` || `USERPROFILE` || os.homedir()).
+ */
+export declare function getHomeDir(env?: NodeJS.ProcessEnv): string;
+/** Pre-XDG legacy workflows data home: ~/.hasna/workflows. */
+export declare function getLegacyDataDir(env?: NodeJS.ProcessEnv): string;
+/**
+ * The @hasna/paths-resolved workflows data home (XDG / macOS home layout):
+ * `~/.local/share/hasna/workflows` on Linux, `~/Library/Application
+ * Support/Hasna/workflows` on macOS. The home override mirrors the
+ * pre-existing `$HOME`-first resolution so the resolver follows the same home
+ * the legacy path does.
+ */
+export declare function getResolverDataDir(env?: NodeJS.ProcessEnv): string;
+/**
+ * Whether the resolver (XDG) data home should be adopted as the effective
+ * workflows data home. The resolver home is adopted only when the operator
+ * has set `HASNA_DATA_HOME` (the data-kind override — a deliberate opt-in to
+ * the XDG layout) or the store has already been physically migrated there
+ * (`workflows.db` exists). A machine that only redirects another kind (e.g.
+ * cache to tmpfs) must NOT have its data home moved, and a live store at the
+ * legacy home must never become invisible on upgrade.
+ */
+export declare function adoptResolverDataDir(resolved: string, env?: NodeJS.ProcessEnv): boolean;
+/**
+ * The effective workflows data home: the resolver home once adopted,
+ * otherwise the legacy `~/.hasna/workflows` default.
+ */
+export declare function getEffectiveDataDir(env?: NodeJS.ProcessEnv): string;

package/types/types.d.ts

@@ -12,7 +12,9 @@ export interface WorkflowsConfig {
     port: number;
     /** Bind host for workflows-serve. Default 127.0.0.1. */
     host: string;
-    /** Data directory (store slice lands the db here). Default ~/.hasna/workflows. */
+    /** Data directory (store slice lands the db here). Default ~/.hasna/workflows,
+     * resolved through @hasna/paths once the XDG data home is adopted
+     * (HASNA_DATA_HOME set or the store migrated there). */
     dataDir: string;
     /** Optional client API URL (WORKFLOWS_API_URL) — consumed by later slices. */
     apiUrl?: string;