@deksden-com/dd-flow-cli 0.1.0

package/dist/storage/database.js

@@ -0,0 +1,325 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createRequire } from "node:module";
+import { ensureDir } from "./paths.js";
+import { AppError } from "../shared/errors.js";
+const require = createRequire(import.meta.url);
+const { DatabaseSync } = require("node:sqlite");
+export function getDatabase(ddFlowHome) {
+    ensureDir(ddFlowHome);
+    const dbPath = path.join(ddFlowHome, "db.sqlite");
+    const db = new DatabaseSync(dbPath);
+    configureDatabase(db);
+    db.exec("PRAGMA foreign_keys = ON");
+    migrate(db);
+    return {
+        path: dbPath,
+        exec: (sql) => db.exec(sql),
+        run: (sql, params = []) => db.prepare(sql).run(...params),
+        get: (sql, params = []) => db.prepare(sql).get(...params),
+        all: (sql, params = []) => db.prepare(sql).all(...params)
+    };
+}
+function configureDatabase(db) {
+    db.exec(`
+    PRAGMA busy_timeout = 4000;
+    PRAGMA journal_mode = WAL;
+    PRAGMA synchronous = NORMAL;
+  `);
+}
+function migrate(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS projects (
+      id TEXT PRIMARY KEY,
+      short_id TEXT,
+      slug TEXT,
+      root TEXT NOT NULL UNIQUE,
+      status TEXT NOT NULL DEFAULT 'active',
+      state_root TEXT,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS protocols (
+      id TEXT PRIMARY KEY,
+      handshake_id TEXT NOT NULL,
+      project_id TEXT NOT NULL,
+      project_root TEXT NOT NULL,
+      status TEXT NOT NULL,
+      stage TEXT NOT NULL,
+      next_action TEXT,
+      route_json TEXT NOT NULL,
+      workspace_json TEXT NOT NULL,
+      blockers_json TEXT NOT NULL,
+      active_def_json TEXT NOT NULL,
+      state_path TEXT NOT NULL,
+      plan_path TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      FOREIGN KEY(project_id) REFERENCES projects(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS plans (
+      protocol_id TEXT PRIMARY KEY,
+      plan_json TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      FOREIGN KEY(protocol_id) REFERENCES protocols(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS audit_events (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      protocol_id TEXT,
+      project_id TEXT,
+      event_type TEXT NOT NULL,
+      forced INTEGER NOT NULL DEFAULT 0,
+      reason TEXT,
+      payload_json TEXT NOT NULL,
+      created_at TEXT NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS merge_queue (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      protocol_id TEXT NOT NULL UNIQUE,
+      project_id TEXT NOT NULL,
+      status TEXT NOT NULL,
+      claimed_by_session_id TEXT,
+      claimed_at TEXT,
+      attempts_count INTEGER NOT NULL DEFAULT 0,
+      last_reason TEXT,
+      completed_at TEXT,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS merge_sessions (
+      session_id TEXT NOT NULL,
+      project_id TEXT NOT NULL,
+      status TEXT NOT NULL,
+      current_protocol_id TEXT,
+      stop_reason TEXT,
+      started_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      stopped_at TEXT,
+      PRIMARY KEY (session_id, project_id),
+      FOREIGN KEY(project_id) REFERENCES projects(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS lanes (
+      project_id TEXT NOT NULL,
+      name TEXT NOT NULL,
+      workspace_path TEXT NOT NULL,
+      expected_branch TEXT,
+      status TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      PRIMARY KEY (project_id, name),
+      FOREIGN KEY(project_id) REFERENCES projects(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS lane_locks (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      project_id TEXT NOT NULL,
+      lane TEXT NOT NULL,
+      worker_id TEXT NOT NULL,
+      status TEXT NOT NULL,
+      lease_token TEXT NOT NULL,
+      acquired_at TEXT NOT NULL,
+      heartbeat_at TEXT NOT NULL,
+      expires_at TEXT NOT NULL,
+      released_at TEXT,
+      reason TEXT,
+      metadata_json TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      FOREIGN KEY(project_id) REFERENCES projects(id)
+    );
+
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_lane_locks_one_active
+      ON lane_locks(project_id, lane)
+      WHERE status = 'active';
+
+    CREATE TABLE IF NOT EXISTS hook_installations (
+      project_id TEXT NOT NULL,
+      scope TEXT NOT NULL,
+      config_path TEXT NOT NULL,
+      content_hash TEXT NOT NULL,
+      installed INTEGER NOT NULL,
+      drift_status TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      PRIMARY KEY (project_id, scope),
+      FOREIGN KEY(project_id) REFERENCES projects(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS codex_home_profiles (
+      id TEXT PRIMARY KEY,
+      project_id TEXT NOT NULL,
+      profile TEXT NOT NULL,
+      source_home TEXT NOT NULL,
+      target_home TEXT NOT NULL,
+      config_path TEXT NOT NULL,
+      hooks_path TEXT NOT NULL,
+      status TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      last_checked_at TEXT,
+      last_drift_status TEXT NOT NULL,
+      UNIQUE(project_id, profile),
+      FOREIGN KEY(project_id) REFERENCES projects(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS codex_session_bindings (
+      session_id TEXT NOT NULL,
+      project_id TEXT NOT NULL,
+      protocol_id TEXT,
+      handshake_id TEXT,
+      cwd TEXT,
+      transcript_path TEXT,
+      status TEXT NOT NULL,
+      continuation_count INTEGER NOT NULL DEFAULT 0,
+      last_action_hash TEXT,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      PRIMARY KEY(session_id, project_id),
+      FOREIGN KEY(project_id) REFERENCES projects(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS project_config (
+      project_id TEXT NOT NULL,
+      key TEXT NOT NULL,
+      value_json TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      PRIMARY KEY(project_id, key),
+      FOREIGN KEY(project_id) REFERENCES projects(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS flow_sessions (
+      session_id TEXT NOT NULL,
+      project_id TEXT NOT NULL,
+      project_root TEXT NOT NULL,
+      flow_kind TEXT NOT NULL,
+      status TEXT NOT NULL,
+      run_id TEXT,
+      protocol_id TEXT,
+      worker_id TEXT,
+      workspace_path TEXT NOT NULL,
+      continuation_policy TEXT NOT NULL,
+      current_stage TEXT,
+      next_action TEXT,
+      last_action_hash TEXT,
+      continuation_count INTEGER NOT NULL DEFAULT 0,
+      stop_reason TEXT,
+      transcript_path TEXT,
+      cwd TEXT,
+      metadata_json TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      stopped_at TEXT,
+      PRIMARY KEY(session_id, project_id),
+      FOREIGN KEY(project_id) REFERENCES projects(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS flow_runs (
+      id TEXT PRIMARY KEY,
+      short_id TEXT NOT NULL,
+      slug TEXT NOT NULL,
+      project_id TEXT NOT NULL,
+      project_root TEXT NOT NULL,
+      workspace_root TEXT NOT NULL,
+      flow_kind TEXT NOT NULL,
+      subject_type TEXT NOT NULL,
+      subject_id TEXT NOT NULL,
+      status TEXT NOT NULL,
+      verdict TEXT NOT NULL,
+      next_action TEXT,
+      runtime_path TEXT NOT NULL,
+      run_dir TEXT NOT NULL,
+      run_index_path TEXT NOT NULL,
+      index_json TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      completed_at TEXT,
+      FOREIGN KEY(project_id) REFERENCES projects(id)
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_flow_runs_project_updated
+      ON flow_runs(project_id, updated_at DESC);
+
+    CREATE INDEX IF NOT EXISTS idx_flow_runs_short_id
+      ON flow_runs(short_id);
+
+    CREATE TABLE IF NOT EXISTS pending_flow_session_bindings (
+      session_id TEXT NOT NULL,
+      project_id TEXT NOT NULL,
+      payload_json TEXT NOT NULL,
+      cwd TEXT,
+      transcript_path TEXT,
+      turn_id TEXT,
+      status TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      PRIMARY KEY(session_id, project_id),
+      FOREIGN KEY(project_id) REFERENCES projects(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS codex_hook_events (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      project_id TEXT NOT NULL,
+      protocol_id TEXT,
+      session_id TEXT,
+      turn_id TEXT,
+      event_name TEXT NOT NULL,
+      tool_name TEXT,
+      status TEXT NOT NULL,
+      sanitized_summary TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      FOREIGN KEY(project_id) REFERENCES projects(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS worktree_records (
+      protocol_id TEXT PRIMARY KEY,
+      project_id TEXT NOT NULL,
+      integration_branch TEXT,
+      feature_branch TEXT NOT NULL,
+      base_ref TEXT NOT NULL,
+      worktree_path TEXT NOT NULL,
+      worktrunk_metadata_json TEXT NOT NULL,
+      bootstrap_status TEXT NOT NULL,
+      status TEXT NOT NULL,
+      last_command_result_json TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      closed_at TEXT,
+      FOREIGN KEY(protocol_id) REFERENCES protocols(id),
+      FOREIGN KEY(project_id) REFERENCES projects(id)
+    );
+  `);
+    ensureColumn(db, "projects", "short_id", "ALTER TABLE projects ADD COLUMN short_id TEXT");
+    ensureColumn(db, "projects", "slug", "ALTER TABLE projects ADD COLUMN slug TEXT");
+    ensureColumn(db, "projects", "status", "ALTER TABLE projects ADD COLUMN status TEXT NOT NULL DEFAULT 'active'");
+    ensureColumn(db, "projects", "state_root", "ALTER TABLE projects ADD COLUMN state_root TEXT");
+    db.exec("CREATE UNIQUE INDEX IF NOT EXISTS idx_projects_short_id ON projects(short_id) WHERE short_id IS NOT NULL");
+    ensureColumn(db, "merge_queue", "claimed_by_session_id", "ALTER TABLE merge_queue ADD COLUMN claimed_by_session_id TEXT");
+    ensureColumn(db, "merge_queue", "claimed_at", "ALTER TABLE merge_queue ADD COLUMN claimed_at TEXT");
+    ensureColumn(db, "merge_queue", "attempts_count", "ALTER TABLE merge_queue ADD COLUMN attempts_count INTEGER NOT NULL DEFAULT 0");
+    ensureColumn(db, "merge_queue", "last_reason", "ALTER TABLE merge_queue ADD COLUMN last_reason TEXT");
+    ensureColumn(db, "merge_queue", "completed_at", "ALTER TABLE merge_queue ADD COLUMN completed_at TEXT");
+    ensureColumn(db, "codex_session_bindings", "continuation_count", "ALTER TABLE codex_session_bindings ADD COLUMN continuation_count INTEGER NOT NULL DEFAULT 0");
+    ensureColumn(db, "codex_session_bindings", "last_action_hash", "ALTER TABLE codex_session_bindings ADD COLUMN last_action_hash TEXT");
+    ensureColumn(db, "flow_sessions", "current_stage", "ALTER TABLE flow_sessions ADD COLUMN current_stage TEXT");
+    ensureColumn(db, "flow_sessions", "next_action", "ALTER TABLE flow_sessions ADD COLUMN next_action TEXT");
+    ensureColumn(db, "flow_sessions", "metadata_json", "ALTER TABLE flow_sessions ADD COLUMN metadata_json TEXT NOT NULL DEFAULT '{}'");
+    ensureColumn(db, "flow_sessions", "run_id", "ALTER TABLE flow_sessions ADD COLUMN run_id TEXT");
+}
+function ensureColumn(db, table, column, sql) {
+    const columns = db.prepare(`PRAGMA table_info(${table})`).all();
+    if (!columns.some((entry) => entry.name === column)) {
+        db.exec(sql);
+    }
+}
+export function ensureReadableFile(file) {
+    if (!fs.existsSync(file) || !fs.statSync(file).isFile()) {
+        throw new AppError("not_found", `File does not exist: ${file}`, 1);
+    }
+}

package/dist/storage/paths.js

@@ -0,0 +1,56 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { AppError } from "../shared/errors.js";
+export function resolveDdFlowHome(env) {
+    return path.resolve(env.DD_FLOW_HOME ?? path.join(os.homedir(), ".dd-flow"));
+}
+export function ensureDir(dir) {
+    fs.mkdirSync(dir, { recursive: true });
+}
+export function resolveProjectRoot(root) {
+    const absolute = path.resolve(root);
+    if (!fs.existsSync(absolute)) {
+        throw new AppError("not_found", `Project root does not exist: ${absolute}`, 1);
+    }
+    return fs.realpathSync(absolute);
+}
+export function protocolDir(projectRoot, protocolId) {
+    return path.join(projectRoot, ".memory-bank", "protocol", protocolId);
+}
+export function runtimeProtocolDir(ddFlowHome, projectId, protocolId) {
+    return path.join(projectRuntimeRoot(ddFlowHome, projectId), "protocols", protocolId);
+}
+export function runtimeStateJsonPath(ddFlowHome, projectId, protocolId) {
+    return path.join(runtimeProtocolDir(ddFlowHome, projectId, protocolId), "state.json");
+}
+export function runtimePlanJsonPath(ddFlowHome, projectId, protocolId) {
+    return path.join(runtimeProtocolDir(ddFlowHome, projectId, protocolId), "plan.json");
+}
+export function runtimeRunDir(ddFlowHome, projectId, runId) {
+    return path.join(projectRuntimeRoot(ddFlowHome, projectId), "runs", runId);
+}
+export function runtimeRunJsonPath(ddFlowHome, projectId, runId) {
+    return path.join(runtimeRunDir(ddFlowHome, projectId, runId), "run.json");
+}
+export function userFacingRunDir(workspaceRoot, runId) {
+    return path.join(workspaceRoot, ".tasks", "dd-flow-runs", runId);
+}
+export function userFacingRunIndexPath(workspaceRoot, runId) {
+    return path.join(userFacingRunDir(workspaceRoot, runId), "run-index.json");
+}
+export function stateJsonPath(projectRoot, protocolId) {
+    return path.join(protocolDir(projectRoot, protocolId), "state.json");
+}
+export function planJsonPath(projectRoot, protocolId) {
+    return path.join(protocolDir(projectRoot, protocolId), "plan.json");
+}
+export function projectHome(ddFlowHome, projectId) {
+    return path.join(ddFlowHome, "projects", projectId);
+}
+export function projectRuntimeRoot(ddFlowHome, projectId) {
+    return path.join(projectHome(ddFlowHome, projectId), "runtime");
+}
+export function projectCheckoutRoot(ddFlowHome, projectId) {
+    return path.join(projectHome(ddFlowHome, projectId), "checkouts");
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@deksden-com/dd-flow-cli",
+  "version": "0.1.0",
+  "description": "Mechanical runtime CLI for dd-flow workflows.",
+  "type": "module",
+  "bin": {
+    "dd-flow": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=26.0.0",
+    "pnpm": ">=10.0.0"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.31.0",
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^24.10.1",
+    "eslint": "^9.39.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.47.0",
+    "vitest": "^4.0.13"
+  },
+  "dependencies": {
+    "ajv": "^8.20.0",
+    "smol-toml": "^1.6.1",
+    "yaml": "^2.9.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/copy-assets.mjs",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --max-warnings=0",
+    "test": "vitest run",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "pnpm run build && changeset publish"
+  }
+}