smithers-orchestrator 0.25.0 → 0.25.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smithers-orchestrator",
-  "version": "0.25.0",
+  "version": "0.25.2",
   "description": "Public Smithers facade for durable coding-agent workflows and Gateway operation",
   "license": "MIT",
   "homepage": "https://smithers.sh",
@@ -92,28 +92,28 @@
     "incur": "^0.4.1",
     "react": "^19.2.5",
     "zod": "^4.3.6",
-    "@smithers-orchestrator/agents": "0.25.0",
-    "@smithers-orchestrator/components": "0.25.0",
-    "@smithers-orchestrator/control-plane": "0.25.0",
-    "@smithers-orchestrator/db": "0.25.0",
-    "@smithers-orchestrator/engine": "0.25.0",
-    "@smithers-orchestrator/driver": "0.25.0",
-    "@smithers-orchestrator/errors": "0.25.0",
-    "@smithers-orchestrator/gateway-client": "0.25.0",
-    "@smithers-orchestrator/gateway-react": "0.25.0",
-    "@smithers-orchestrator/graph": "0.25.0",
-    "@smithers-orchestrator/memory": "0.25.0",
-    "@smithers-orchestrator/observability": "0.25.0",
-    "@smithers-orchestrator/openapi": "0.25.0",
-    "@smithers-orchestrator/react-reconciler": "0.25.0",
-    "@smithers-orchestrator/sandbox": "0.25.0",
-    "@smithers-orchestrator/scorers": "0.25.0",
-    "@smithers-orchestrator/scheduler": "0.25.0",
-    "@smithers-orchestrator/server": "0.25.0",
-    "@smithers-orchestrator/time-travel": "0.25.0",
-    "@smithers-orchestrator/vcs": "0.25.0",
-    "@smithers-orchestrator/cli": "0.25.0",
-    "@smithers-orchestrator/tool-context": "0.25.0"
+    "@smithers-orchestrator/agents": "0.25.2",
+    "@smithers-orchestrator/components": "0.25.2",
+    "@smithers-orchestrator/control-plane": "0.25.2",
+    "@smithers-orchestrator/db": "0.25.2",
+    "@smithers-orchestrator/cli": "0.25.2",
+    "@smithers-orchestrator/driver": "0.25.2",
+    "@smithers-orchestrator/gateway-client": "0.25.2",
+    "@smithers-orchestrator/engine": "0.25.2",
+    "@smithers-orchestrator/graph": "0.25.2",
+    "@smithers-orchestrator/errors": "0.25.2",
+    "@smithers-orchestrator/gateway-react": "0.25.2",
+    "@smithers-orchestrator/memory": "0.25.2",
+    "@smithers-orchestrator/react-reconciler": "0.25.2",
+    "@smithers-orchestrator/observability": "0.25.2",
+    "@smithers-orchestrator/sandbox": "0.25.2",
+    "@smithers-orchestrator/scorers": "0.25.2",
+    "@smithers-orchestrator/openapi": "0.25.2",
+    "@smithers-orchestrator/server": "0.25.2",
+    "@smithers-orchestrator/scheduler": "0.25.2",
+    "@smithers-orchestrator/time-travel": "0.25.2",
+    "@smithers-orchestrator/tool-context": "0.25.2",
+    "@smithers-orchestrator/vcs": "0.25.2"
   },
   "optionalDependencies": {
     "@electric-sql/pglite": "0.5.1",

package/src/MigrateSmithersStoreOptions.ts

@@ -1,7 +1,8 @@
 export type MigrateSmithersStoreOptions = {
 	cwd?: string;
 	dbPath?: string;
-	to?: "pglite" | "postgres";
+	from?: "sqlite" | "pglite" | "postgres";
+	to?: "sqlite" | "pglite" | "postgres";
 	url?: string;
 	env?: Record<string, string | undefined>;
 	pgliteDataDir?: string;

package/src/OpenSmithersStoreOptions.ts

@@ -0,0 +1,9 @@
+import type { OpenSmithersBackendOptions } from "./OpenSmithersBackendOptions";
+
+export type OpenSmithersStoreOptions = OpenSmithersBackendOptions & {
+	mode?: "read" | "write";
+	wait?: {
+		timeoutMs?: number;
+		intervalMs?: number;
+	};
+};

package/src/OpenSmithersStoreResult.ts

@@ -0,0 +1,10 @@
+import type { SmithersDb } from "@smithers-orchestrator/db/adapter";
+import type { SmithersBackendChoice } from "./SmithersBackendChoice";
+
+export type OpenSmithersStoreResult = {
+	choice: SmithersBackendChoice;
+	adapter: SmithersDb;
+	db: unknown;
+	dbPath?: string;
+	cleanup: () => Promise<void> | void;
+};

package/src/ResolveSmithersBackendChoiceOptions.ts

@@ -2,6 +2,9 @@ export type ResolveSmithersBackendChoiceOptions = {
 	backend?: "sqlite" | "pglite" | "postgres";
 	cwd?: string;
 	dbPath?: string;
+	pgliteDataDir?: string;
+	connectionString?: string;
+	connection?: { query?: (...args: any[]) => Promise<any> };
 	configPath?: string;
 	env?: Record<string, string | undefined>;
 };

package/src/SmithersBackendChoice.ts

@@ -1,9 +1,20 @@
 export type SmithersBackendChoice = {
 	backend: "sqlite" | "pglite" | "postgres";
-	source: "options" | "env" | "config" | "default";
+	source: "options" | "env" | "config" | "marker" | "default";
 	dbPath: string;
 	workspaceRoot: string;
 	runCount: number;
 	schemaVersion: string;
+	sqlite: { dbPath: string; exists: boolean; runCount: number; schemaVersion: string };
+	pglite: { dataDir: string; exists: boolean; initialized: boolean; hasRunsTable?: boolean; runCount: number; schemaVersion: string; error?: string };
+	postgres: {
+		exists: boolean;
+		initialized: boolean;
+		hasRunsTable?: boolean;
+		runCount: number;
+		schemaVersion: string;
+		connectionString?: "set";
+		error?: string;
+	};
 	migratedMarker: boolean;
 };

package/src/SmithersMigrationResult.ts

@@ -1,9 +1,16 @@
 export type SmithersMigrationResult = {
-	backend: "pglite" | "postgres";
+	backend: "sqlite" | "pglite" | "postgres";
+	source: {
+		backend: "sqlite" | "pglite" | "postgres";
+		dbPath?: string;
+		dataDir?: string;
+		url?: string;
+	};
 	dbPath: string;
 	markerPath: string;
 	target: {
-		backend: "pglite" | "postgres";
+		backend: "sqlite" | "pglite" | "postgres";
+		dbPath?: string;
 		dataDir?: string;
 		url?: string;
 	};

package/src/bin/smithers-delegation.js

@@ -0,0 +1,98 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, parse, resolve } from "node:path";
+
+const WORKFLOW_PATH_COMMANDS = new Set([
+    "up",
+    "graph",
+    "fork",
+    "replay",
+    "revert",
+    "timetravel",
+]);
+const WORKFLOW_EXTENSIONS = new Set([".js", ".jsx", ".ts", ".tsx", ".mjs", ".mts"]);
+
+/**
+ * @param {string} value
+ */
+export function isOptionLike(value) {
+    return value.startsWith("-");
+}
+
+/**
+ * @param {string} value
+ */
+export function looksLikeWorkflowPath(value) {
+    if (isOptionLike(value))
+        return false;
+    return WORKFLOW_EXTENSIONS.has(parse(value).ext);
+}
+
+/**
+ * @param {string[]} args
+ */
+export function getExplicitWorkflowPath(args) {
+    if (args.length === 0)
+        return null;
+    if (looksLikeWorkflowPath(args[0]))
+        return args[0];
+    for (let index = 0; index < args.length; index++) {
+        const arg = args[index];
+        if (!WORKFLOW_PATH_COMMANDS.has(arg))
+            continue;
+        for (let nextIndex = index + 1; nextIndex < args.length; nextIndex++) {
+            const candidate = args[nextIndex];
+            if (looksLikeWorkflowPath(candidate))
+                return candidate;
+        }
+        return null;
+    }
+    for (const arg of args) {
+        if (looksLikeWorkflowPath(arg))
+            return arg;
+    }
+    return null;
+}
+
+/**
+ * Resolve the local `smithers-orchestrator` package's bin JS file under
+ * `<directory>/node_modules/`. Going through `package.json` (instead of the
+ * `.bin/smithers` shell shim npm/pnpm generate) is the whole point: the shim
+ * is `#!/bin/sh` and re-execing it with `process.execPath` (bun) makes bun
+ * parse shell as JavaScript, which crashes with `Expected ")" but found
+ * "$(echo "`.
+ *
+ * @param {string} directory
+ */
+export function resolveLocalSmithersBinJs(directory) {
+    const pkgJsonPath = resolve(directory, "node_modules/smithers-orchestrator/package.json");
+    if (!existsSync(pkgJsonPath))
+        return null;
+    let pkg;
+    try {
+        pkg = JSON.parse(readFileSync(pkgJsonPath, "utf8"));
+    } catch {
+        return null;
+    }
+    const binEntry = typeof pkg?.bin === "string" ? pkg.bin : pkg?.bin?.smithers;
+    if (typeof binEntry !== "string" || binEntry.length === 0)
+        return null;
+    const binPath = resolve(dirname(pkgJsonPath), binEntry);
+    return existsSync(binPath) ? binPath : null;
+}
+
+/**
+ * @param {string} cwd
+ * @param {string} workflowPath
+ */
+export function findNearestWorkflowLocalCli(cwd, workflowPath) {
+    let current = dirname(resolve(cwd, workflowPath));
+    while (true) {
+        const localBin = resolveLocalSmithersBinJs(current);
+        if (localBin)
+            return localBin;
+        const parent = dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}

package/src/bin/smithers.js

@@ -1,104 +1,13 @@
 #!/usr/bin/env bun
 import { spawn } from "node:child_process";
-import { existsSync, readFileSync, realpathSync } from "node:fs";
-import { dirname, parse, resolve } from "node:path";
+import { realpathSync } from "node:fs";
+import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-
-const WORKFLOW_PATH_COMMANDS = new Set([
-    "up",
-    "graph",
-    "fork",
-    "replay",
-    "revert",
-    "timetravel",
-]);
-const WORKFLOW_EXTENSIONS = new Set([".js", ".jsx", ".ts", ".tsx", ".mjs", ".mts"]);
-
-/**
- * @param {string} value
- */
-function isOptionLike(value) {
-    return value.startsWith("-");
-}
-
-/**
- * @param {string} value
- */
-function looksLikeWorkflowPath(value) {
-    if (isOptionLike(value))
-        return false;
-    return WORKFLOW_EXTENSIONS.has(parse(value).ext);
-}
-
-/**
- * @param {string[]} args
- */
-function getExplicitWorkflowPath(args) {
-    if (args.length === 0)
-        return null;
-    if (looksLikeWorkflowPath(args[0]))
-        return args[0];
-    for (let index = 0; index < args.length; index++) {
-        const arg = args[index];
-        if (!WORKFLOW_PATH_COMMANDS.has(arg))
-            continue;
-        for (let nextIndex = index + 1; nextIndex < args.length; nextIndex++) {
-            const candidate = args[nextIndex];
-            if (looksLikeWorkflowPath(candidate))
-                return candidate;
-        }
-        return null;
-    }
-    for (const arg of args) {
-        if (looksLikeWorkflowPath(arg))
-            return arg;
-    }
-    return null;
-}
-
-/**
- * Resolve the local `smithers-orchestrator` package's bin JS file under
- * `<directory>/node_modules/`. Going through `package.json` (instead of the
- * `.bin/smithers` shell shim npm/pnpm generate) is the whole point: the shim
- * is `#!/bin/sh` and re-execing it with `process.execPath` (bun) makes bun
- * parse shell as JavaScript, which crashes with `Expected ")" but found
- * "$(echo "`.
- *
- * @param {string} directory
- */
-function resolveLocalSmithersBinJs(directory) {
-    const pkgJsonPath = resolve(directory, "node_modules/smithers-orchestrator/package.json");
-    if (!existsSync(pkgJsonPath))
-        return null;
-    let pkg;
-    try {
-        pkg = JSON.parse(readFileSync(pkgJsonPath, "utf8"));
-    } catch {
-        return null;
-    }
-    const binEntry = typeof pkg?.bin === "string" ? pkg.bin : pkg?.bin?.smithers;
-    if (typeof binEntry !== "string" || binEntry.length === 0)
-        return null;
-    const binPath = resolve(dirname(pkgJsonPath), binEntry);
-    return existsSync(binPath) ? binPath : null;
-}
-
-/**
- * @param {string} cwd
- * @param {string} workflowPath
- */
-function findNearestWorkflowLocalCli(cwd, workflowPath) {
-    let current = dirname(resolve(cwd, workflowPath));
-    while (true) {
-        const localBin = resolveLocalSmithersBinJs(current);
-        if (localBin)
-            return localBin;
-        const parent = dirname(current);
-        if (parent === current)
-            return null;
-        current = parent;
-    }
-}
+import {
+    getExplicitWorkflowPath,
+    findNearestWorkflowLocalCli,
+    resolveLocalSmithersBinJs,
+} from "./smithers-delegation.js";
 
 /**
  * When a workflow directory (`.smithers/`) exists in the user's cwd and it's

package/src/index.js

@@ -188,6 +188,7 @@ export { runJj, getJjPointer, revertToJjPointer, isJjRepo, workspaceAdd, workspa
 // Core API
 export { createSmithers, createSmithersPostgres } from "./create.js";
 export { openSmithersBackend } from "./openSmithersBackend.js";
+export { openSmithersStore } from "./openSmithersStore.js";
 export { resolveSmithersBackendChoice } from "./resolveSmithersBackendChoice.js";
 export { migrateSmithersStore } from "./migrateSmithersStore.js";
 export {