dev-prism 0.2.0 → 0.4.0

package/dist/chunk-Y3GR6XK7.js

@@ -0,0 +1,71 @@
+// src/lib/worktree.ts
+import { existsSync, rmSync } from "fs";
+import { execa } from "execa";
+async function branchExists(projectRoot, branchName) {
+  try {
+    await execa("git", ["rev-parse", "--verify", branchName], {
+      cwd: projectRoot,
+      stdio: "pipe"
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function findNextSessionId(usedIds) {
+  for (let i = 1; i <= 999; i++) {
+    const sessionId = String(i).padStart(3, "0");
+    if (!usedIds.has(sessionId)) {
+      return sessionId;
+    }
+  }
+  throw new Error("No available session IDs (001-999 all in use)");
+}
+function generateDefaultBranchName(sessionId) {
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `session/${today}/${sessionId}`;
+}
+async function createWorktree(projectRoot, sessionDir, branchName) {
+  if (existsSync(sessionDir)) {
+    throw new Error(`Session directory already exists: ${sessionDir}`);
+  }
+  const exists = await branchExists(projectRoot, branchName);
+  if (exists) {
+    await execa("git", ["worktree", "add", sessionDir, branchName], {
+      cwd: projectRoot,
+      stdio: "inherit"
+    });
+  } else {
+    await execa("git", ["worktree", "add", sessionDir, "-b", branchName, "HEAD"], {
+      cwd: projectRoot,
+      stdio: "inherit"
+    });
+  }
+}
+async function removeWorktree(projectRoot, sessionDir, branchName) {
+  if (existsSync(sessionDir)) {
+    try {
+      await execa("git", ["worktree", "remove", "--force", sessionDir], {
+        cwd: projectRoot,
+        stdio: "inherit"
+      });
+    } catch {
+      rmSync(sessionDir, { recursive: true, force: true });
+    }
+  }
+  try {
+    await execa("git", ["branch", "-D", branchName], {
+      cwd: projectRoot,
+      stdio: "pipe"
+      // Don't show output, branch might not exist
+    });
+  } catch {
+  }
+}
+
+export {
+  findNextSessionId,
+  generateDefaultBranchName,
+  createWorktree,
+  removeWorktree
+};

package/dist/commands/claude.js

@@ -1,105 +1,6 @@
-// src/commands/claude.ts
-import { existsSync, mkdirSync, writeFileSync, readFileSync, appendFileSync } from "fs";
-import { join } from "path";
-import chalk from "chalk";
-var SKILL_CONTENT = `---
-allowed-tools: Bash(dev-prism *)
-description: Manage isolated development sessions (create, list, start, stop, destroy)
----
-
-# Dev Session Manager
-
-Manage isolated parallel development sessions using git worktrees and Docker.
-
-## Parse Intent from: $ARGUMENTS
-
-- "create" / "new" -> dev-prism create
-- "list" / "status" -> dev-prism list
-- "start <id>" -> dev-prism start <id>
-- "stop <id>" -> dev-prism stop <id>
-- "destroy <id>" -> dev-prism destroy <id>
-- "logs <id>" -> dev-prism logs <id>
-- "stop all" -> dev-prism stop-all
-- "prune" -> dev-prism prune
-
-## Commands
-
-Run from the project root (where session.config.mjs exists).
-
-After running commands, explain:
-1. What happened
-2. Relevant ports/paths
-3. Next steps
-
-Warn before destructive operations (destroy, prune).
-`;
-var CLAUDE_MD_SECTION = `
-## Dev Sessions
-
-Isolated parallel development sessions using git worktrees and Docker.
-
-### Commands
-\`\`\`bash
-dev-prism create [id]      # Create session (auto-assigns ID)
-dev-prism list             # Show all sessions with status
-dev-prism start <id>       # Start stopped session
-dev-prism stop <id>        # Stop session (preserves data)
-dev-prism stop-all         # Stop all running sessions
-dev-prism destroy <id>     # Remove session completely
-dev-prism logs <id>        # Stream Docker logs
-dev-prism prune            # Remove stopped sessions
-\`\`\`
-
-### Port Allocation
-Port = 47000 + (sessionId \xD7 100) + offset
-
-| Service | Offset | Session 001 |
-|---------|--------|-------------|
-| APP     | 0      | 47100       |
-| WEB     | 1      | 47101       |
-| POSTGRES| 10     | 47110       |
-
-### AI Notes
-- In sessions, use DATABASE_URL from \`.env.session\`
-- Run \`dev-prism list\` to discover ports
-- Commands run from project root, not session worktrees
-`;
-async function installClaude(projectRoot, options) {
-  const skillDir = join(projectRoot, ".claude", "commands");
-  const skillPath = join(skillDir, "session.md");
-  const claudeMdPath = join(projectRoot, "CLAUDE.md");
-  if (existsSync(skillPath) && !options.force) {
-    console.log(chalk.yellow(`Skill already exists: ${skillPath}`));
-    console.log(chalk.gray("Use --force to overwrite"));
-  } else {
-    mkdirSync(skillDir, { recursive: true });
-    writeFileSync(skillPath, SKILL_CONTENT);
-    console.log(chalk.green(`Created: ${skillPath}`));
-  }
-  const marker = "## Dev Sessions";
-  if (existsSync(claudeMdPath)) {
-    const content = readFileSync(claudeMdPath, "utf-8");
-    if (content.includes(marker)) {
-      if (options.force) {
-        const beforeSection = content.split(marker)[0];
-        writeFileSync(claudeMdPath, beforeSection.trimEnd() + CLAUDE_MD_SECTION);
-        console.log(chalk.green(`Updated: ${claudeMdPath}`));
-      } else {
-        console.log(chalk.yellow("CLAUDE.md already has Dev Sessions section"));
-        console.log(chalk.gray("Use --force to overwrite"));
-      }
-    } else {
-      appendFileSync(claudeMdPath, CLAUDE_MD_SECTION);
-      console.log(chalk.green(`Updated: ${claudeMdPath}`));
-    }
-  } else {
-    writeFileSync(claudeMdPath, `# Project
-${CLAUDE_MD_SECTION}`);
-    console.log(chalk.green(`Created: ${claudeMdPath}`));
-  }
-  console.log(chalk.blue("\nClaude Code integration installed!"));
-  console.log(chalk.gray("Use /session in Claude Code to manage sessions."));
-}
+import {
+  installClaude
+} from "../chunk-7YGOMAJG.js";
 export {
   installClaude
 };

package/dist/commands/create.js

@@ -1,11 +1,12 @@
 import {
   createSession
-} from "../chunk-PS76Q3HD.js";
-import "../chunk-PJKUD2N2.js";
-import "../chunk-GWDGC2OE.js";
-import "../chunk-25WQHUYW.js";
+} from "../chunk-KZJE62TK.js";
+import "../chunk-J36LRUXM.js";
+import "../chunk-3ATDGV4Y.js";
+import "../chunk-Y3GR6XK7.js";
 import "../chunk-GBN67HYD.js";
-import "../chunk-LEHA65A7.js";
+import "../chunk-25WQHUYW.js";
+import "../chunk-H4HPDIY3.js";
 export {
   createSession
 };

package/dist/commands/destroy.js

@@ -1,9 +1,10 @@
 import {
   destroySession
-} from "../chunk-LDK6QMR6.js";
-import "../chunk-GWDGC2OE.js";
-import "../chunk-25WQHUYW.js";
+} from "../chunk-3NW2OWIU.js";
+import "../chunk-Y3GR6XK7.js";
 import "../chunk-GBN67HYD.js";
+import "../chunk-25WQHUYW.js";
+import "../chunk-H4HPDIY3.js";
 export {
   destroySession
 };

package/dist/commands/info.d.ts

@@ -0,0 +1,3 @@
+declare function showInfo(cwd: string): Promise<void>;
+
+export { showInfo };

package/dist/commands/info.js

@@ -0,0 +1,7 @@
+import {
+  showInfo
+} from "../chunk-JIU574KX.js";
+import "../chunk-GBN67HYD.js";
+export {
+  showInfo
+};

package/dist/commands/list.d.ts

@@ -1,3 +1,5 @@
-declare function listSessions(projectRoot: string): Promise<void>;
+declare function listSessions(projectRoot: string, options?: {
+    all?: boolean;
+}): Promise<void>;
 
 export { listSessions };

package/dist/commands/list.js

@@ -1,10 +1,10 @@
 import {
   listSessions
-} from "../chunk-35SHBLIZ.js";
-import "../chunk-PJKUD2N2.js";
-import "../chunk-GWDGC2OE.js";
-import "../chunk-25WQHUYW.js";
+} from "../chunk-NNVP5F6I.js";
+import "../chunk-3ATDGV4Y.js";
 import "../chunk-GBN67HYD.js";
+import "../chunk-25WQHUYW.js";
+import "../chunk-H4HPDIY3.js";
 export {
   listSessions
 };

package/dist/commands/logs.d.ts

@@ -0,0 +1,8 @@
+interface LogsOptions {
+    mode?: string;
+    without?: string[];
+    tail?: string;
+}
+declare function streamLogs(projectRoot: string, sessionId: string, options: LogsOptions): Promise<void>;
+
+export { type LogsOptions, streamLogs };

package/dist/commands/logs.js

@@ -0,0 +1,8 @@
+import {
+  streamLogs
+} from "../chunk-RC2AUYZ7.js";
+import "../chunk-25WQHUYW.js";
+import "../chunk-H4HPDIY3.js";
+export {
+  streamLogs
+};

package/dist/commands/prune.d.ts

@@ -0,0 +1,6 @@
+interface PruneOptions {
+    yes?: boolean;
+}
+declare function pruneSessions(projectRoot: string, options: PruneOptions): Promise<void>;
+
+export { type PruneOptions, pruneSessions };

package/dist/commands/prune.js

@@ -0,0 +1,10 @@
+import {
+  pruneSessions
+} from "../chunk-63II3EL4.js";
+import "../chunk-Y3GR6XK7.js";
+import "../chunk-GBN67HYD.js";
+import "../chunk-25WQHUYW.js";
+import "../chunk-H4HPDIY3.js";
+export {
+  pruneSessions
+};

package/dist/commands/start.d.ts

@@ -0,0 +1,7 @@
+interface StartOptions {
+    mode?: string;
+    without?: string[];
+}
+declare function startSession(projectRoot: string, sessionId: string, options: StartOptions): Promise<void>;
+
+export { type StartOptions, startSession };

package/dist/commands/start.js

@@ -0,0 +1,9 @@
+import {
+  startSession
+} from "../chunk-3TRRZEFR.js";
+import "../chunk-GBN67HYD.js";
+import "../chunk-25WQHUYW.js";
+import "../chunk-H4HPDIY3.js";
+export {
+  startSession
+};

package/dist/commands/stop-all.d.ts

@@ -0,0 +1,3 @@
+declare function stopAllSessions(projectRoot: string): Promise<void>;
+
+export { stopAllSessions };

package/dist/commands/stop-all.js

@@ -0,0 +1,9 @@
+import {
+  stopAllSessions
+} from "../chunk-OL25TBYX.js";
+import "../chunk-GBN67HYD.js";
+import "../chunk-25WQHUYW.js";
+import "../chunk-H4HPDIY3.js";
+export {
+  stopAllSessions
+};

package/dist/commands/stop.d.ts

@@ -0,0 +1,3 @@
+declare function stopSession(projectRoot: string, sessionId: string): Promise<void>;
+
+export { stopSession };

package/dist/commands/stop.js

@@ -0,0 +1,7 @@
+import {
+  stopSession
+} from "../chunk-SUMJLXT7.js";
+import "../chunk-H4HPDIY3.js";
+export {
+  stopSession
+};

package/dist/index.d.ts

@@ -1,6 +1,16 @@
 export { createSession } from './commands/create.js';
 export { destroySession } from './commands/destroy.js';
 export { listSessions } from './commands/list.js';
+export { showInfo } from './commands/info.js';
+export { startSession } from './commands/start.js';
+export { stopSession } from './commands/stop.js';
+export { stopAllSessions } from './commands/stop-all.js';
+export { pruneSessions } from './commands/prune.js';
+export { streamLogs } from './commands/logs.js';
+export { ClaudeOptions, installClaude } from './commands/claude.js';
 export { SessionConfig, loadConfig } from './lib/config.js';
 export { calculatePorts } from './lib/ports.js';
-export { findNextSessionId, generateDefaultBranchName } from './lib/worktree.js';
+export { generateDefaultBranchName } from './lib/worktree.js';
+export { SessionRow, SessionStore } from './lib/store.js';
+export { generateEnvContent, renderAppEnv, writeAppEnvFiles, writeEnvFile } from './lib/env.js';
+export { DockerComposeOptions, logs as dockerLogs, down, isRunning, ps, up } from './lib/docker.js';

package/dist/index.js

@@ -1,30 +1,80 @@
+import {
+  startSession
+} from "./chunk-3TRRZEFR.js";
+import {
+  stopAllSessions
+} from "./chunk-OL25TBYX.js";
+import {
+  stopSession
+} from "./chunk-SUMJLXT7.js";
+import {
+  installClaude
+} from "./chunk-7YGOMAJG.js";
 import {
   createSession
-} from "./chunk-PS76Q3HD.js";
+} from "./chunk-KZJE62TK.js";
+import {
+  generateEnvContent,
+  renderAppEnv,
+  writeAppEnvFiles,
+  writeEnvFile
+} from "./chunk-J36LRUXM.js";
 import {
   destroySession
-} from "./chunk-LDK6QMR6.js";
+} from "./chunk-3NW2OWIU.js";
+import {
+  showInfo
+} from "./chunk-JIU574KX.js";
 import {
   listSessions
-} from "./chunk-35SHBLIZ.js";
+} from "./chunk-NNVP5F6I.js";
 import {
   calculatePorts
-} from "./chunk-PJKUD2N2.js";
+} from "./chunk-3ATDGV4Y.js";
+import {
+  streamLogs
+} from "./chunk-RC2AUYZ7.js";
+import {
+  pruneSessions
+} from "./chunk-63II3EL4.js";
 import {
-  findNextSessionId,
   generateDefaultBranchName
-} from "./chunk-GWDGC2OE.js";
+} from "./chunk-Y3GR6XK7.js";
+import {
+  down,
+  isRunning,
+  logs,
+  ps,
+  up
+} from "./chunk-GBN67HYD.js";
 import {
   loadConfig
 } from "./chunk-25WQHUYW.js";
-import "./chunk-GBN67HYD.js";
-import "./chunk-LEHA65A7.js";
+import {
+  SessionStore
+} from "./chunk-H4HPDIY3.js";
 export {
+  SessionStore,
   calculatePorts,
   createSession,
   destroySession,
-  findNextSessionId,
+  logs as dockerLogs,
+  down,
   generateDefaultBranchName,
+  generateEnvContent,
+  installClaude,
+  isRunning,
   listSessions,
-  loadConfig
+  loadConfig,
+  pruneSessions,
+  ps,
+  renderAppEnv,
+  showInfo,
+  startSession,
+  stopAllSessions,
+  stopSession,
+  streamLogs,
+  up,
+  writeAppEnvFiles,
+  writeEnvFile
 };

package/dist/lib/env.d.ts

@@ -2,6 +2,7 @@ import { SessionConfig } from './config.js';
 
 declare function generateEnvContent(sessionId: string, ports: Record<string, number>, projectName: string): string;
 declare function writeEnvFile(sessionDir: string, sessionId: string, ports: Record<string, number>, projectName: string): string;
+declare function renderAppEnv(template: Record<string, string>, ports: Record<string, number>): Record<string, string>;
 declare function writeAppEnvFiles(config: SessionConfig, sessionDir: string, sessionId: string, ports: Record<string, number>): string[];
 
-export { generateEnvContent, writeAppEnvFiles, writeEnvFile };
+export { generateEnvContent, renderAppEnv, writeAppEnvFiles, writeEnvFile };

package/dist/lib/env.js

@@ -1,10 +1,12 @@
 import {
   generateEnvContent,
+  renderAppEnv,
   writeAppEnvFiles,
   writeEnvFile
-} from "../chunk-LEHA65A7.js";
+} from "../chunk-J36LRUXM.js";
 export {
   generateEnvContent,
+  renderAppEnv,
   writeAppEnvFiles,
   writeEnvFile
 };

package/dist/lib/ports.js

@@ -1,7 +1,7 @@
 import {
   calculatePorts,
   formatPortsTable
-} from "../chunk-PJKUD2N2.js";
+} from "../chunk-3ATDGV4Y.js";
 export {
   calculatePorts,
   formatPortsTable

package/dist/lib/store.d.ts

@@ -0,0 +1,46 @@
+interface SessionRow {
+    id: number;
+    session_id: string;
+    project_root: string;
+    session_dir: string;
+    branch: string;
+    mode: string;
+    in_place: number;
+    created_at: string;
+    destroyed_at: string | null;
+}
+declare class SessionStore {
+    private db;
+    constructor(dbPath?: string);
+    insert(row: {
+        sessionId: string;
+        projectRoot: string;
+        sessionDir: string;
+        branch?: string;
+        mode?: string;
+        inPlace?: boolean;
+    }): SessionRow;
+    /**
+     * Atomically remove any old destroyed row and insert a new one.
+     * Uses a transaction so the UNIQUE constraint prevents concurrent creates
+     * from claiming the same session ID.
+     */
+    reserve(row: {
+        sessionId: string;
+        projectRoot: string;
+        sessionDir: string;
+        branch?: string;
+        mode?: string;
+        inPlace?: boolean;
+    }): SessionRow;
+    listByProject(projectRoot: string): SessionRow[];
+    listAll(): SessionRow[];
+    findSession(projectRoot: string, sessionId: string): SessionRow | undefined;
+    findByDir(sessionDir: string): SessionRow | undefined;
+    getUsedSessionIds(projectRoot: string): Set<string>;
+    markDestroyed(projectRoot: string, sessionId: string): boolean;
+    remove(projectRoot: string, sessionId: string): boolean;
+    close(): void;
+}
+
+export { type SessionRow, SessionStore };

package/dist/lib/store.js

@@ -0,0 +1,6 @@
+import {
+  SessionStore
+} from "../chunk-H4HPDIY3.js";
+export {
+  SessionStore
+};

package/dist/lib/worktree.d.ts

@@ -1,16 +1,6 @@
-declare function findNextSessionId(projectRoot: string, sessionsDir?: string): Promise<string>;
+declare function findNextSessionId(usedIds: Set<string>): string;
 declare function generateDefaultBranchName(sessionId: string): string;
 declare function createWorktree(projectRoot: string, sessionDir: string, branchName: string): Promise<void>;
 declare function removeWorktree(projectRoot: string, sessionDir: string, branchName: string): Promise<void>;
-declare function listWorktrees(projectRoot: string): Promise<Array<{
-    path: string;
-    branch: string;
-    commit: string;
-}>>;
-declare function getSessionWorktrees(projectRoot: string): Promise<Array<{
-    sessionId: string;
-    path: string;
-    branch: string;
-}>>;
 
-export { createWorktree, findNextSessionId, generateDefaultBranchName, getSessionWorktrees, listWorktrees, removeWorktree };
+export { createWorktree, findNextSessionId, generateDefaultBranchName, removeWorktree };

package/dist/lib/worktree.js

@@ -2,15 +2,11 @@ import {
   createWorktree,
   findNextSessionId,
   generateDefaultBranchName,
-  getSessionWorktrees,
-  listWorktrees,
   removeWorktree
-} from "../chunk-GWDGC2OE.js";
+} from "../chunk-Y3GR6XK7.js";
 export {
   createWorktree,
   findNextSessionId,
   generateDefaultBranchName,
-  getSessionWorktrees,
-  listWorktrees,
   removeWorktree
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dev-prism",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Minimal CLI for isolated parallel development sessions using git worktrees and Docker Compose",
   "type": "module",
   "license": "MIT",
@@ -31,19 +31,29 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "scripts": {
-    "build": "tsup src/index.ts src/commands/create.ts src/commands/destroy.ts src/commands/list.ts src/commands/claude.ts src/lib/config.ts src/lib/docker.ts src/lib/env.ts src/lib/ports.ts src/lib/worktree.ts --format esm --dts",
+    "build": "tsup src/index.ts src/commands/create.ts src/commands/destroy.ts src/commands/list.ts src/commands/claude.ts src/commands/info.ts src/commands/start.ts src/commands/stop.ts src/commands/stop-all.ts src/commands/prune.ts src/commands/logs.ts src/lib/config.ts src/lib/docker.ts src/lib/env.ts src/lib/ports.ts src/lib/worktree.ts src/lib/store.ts --format esm --dts",
     "dev": "tsup src/index.ts --format esm --dts --watch",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
   },
   "dependencies": {
+    "better-sqlite3": "^11.7.0",
     "chalk": "^5.3.0",
     "commander": "^11.1.0",
     "execa": "^8.0.1"
   },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
     "@types/node": "^20.10.0",
     "tsup": "^8.0.1",
-    "typescript": "^5.3.2"
+    "typescript": "^5.3.2",
+    "vitest": "^3.0.0"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "better-sqlite3",
+      "esbuild"
+    ]
   },
   "engines": {
     "node": ">=18"