create-claude-cabinet 0.8.5 → 0.9.0

package/lib/cli.js

@@ -33,7 +33,7 @@ const MODULES = {
     mandatory: false,
     default: true,
     lean: false,
-    templates: ['scripts/pib-db.js', 'scripts/pib-db-schema.sql'],
+    templates: ['scripts/pib-db.js', 'scripts/pib-db-schema.sql', 'scripts/work-tracker-server.mjs', 'scripts/work-tracker-ui.html'],
     needsDb: true,
   },
   'planning': {
@@ -42,7 +42,7 @@ const MODULES = {
     mandatory: false,
     default: true,
     lean: true,
-    templates: ['skills/plan', 'skills/execute', 'skills/investigate'],
+    templates: ['skills/plan', 'skills/execute', 'skills/execute-plans', 'skills/investigate'],
   },
   'compliance': {
     name: 'Compliance Stack (rules + enforcement)',
@@ -107,6 +107,22 @@ const MODULES = {
   },
 };
 
+/** Recursively collect all relative file paths under a directory. */
+function walkDir(dir, base) {
+  if (!base) base = dir;
+  const results = [];
+  if (!fs.existsSync(dir)) return results;
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      results.push(...walkDir(full, base));
+    } else {
+      results.push(path.relative(base, full));
+    }
+  }
+  return results;
+}
+
 // Signals that a directory contains a real project (not just empty)
 const PROJECT_SIGNALS = [
   'package.json', 'Cargo.toml', 'requirements.txt', 'pyproject.toml',
@@ -572,24 +588,152 @@ async function run() {
     }
   }
 
-  // --- Clean up files removed upstream ---
-  // Phase files are excluded from the manifest (they're user-customized),
-  // so skip them during cleanup even if they were in the old manifest.
+  // --- Manifest key migration (act:d1f16bee) ---
+  // When CC renames directories (e.g., perspectives/ → cabinet-*/), old manifest
+  // keys no longer match new template paths. Migrate keys BEFORE cleanup so the
+  // cleanup loop doesn't treat renamed files as removed.
+  if (Object.keys(existingManifest).length > 0) {
+    const existing = readMetadata(projectDir);
+    const fromVersion = existing.version;
+    let migrationCount = 0;
+    // v0.5.x → v0.6.x: perspectives/ → cabinet-*/
+    if (fromVersion && /^0\.[0-5]\./.test(fromVersion)) {
+      for (const key of Object.keys(existingManifest)) {
+        const match = key.match(/\.claude\/skills\/perspectives\/([^/]+)\//);
+        if (match) {
+          const newKey = key.replace(`perspectives/${match[1]}/`, `cabinet-${match[1]}/`);
+          existingManifest[newKey] = existingManifest[key];
+          delete existingManifest[key];
+          migrationCount++;
+        }
+      }
+    }
+    // Future manifest key migrations go here
+    if (migrationCount > 0) {
+      console.log(`  🔄 Migrated ${migrationCount} manifest key${migrationCount === 1 ? '' : 's'} for directory rename`);
+    }
+  }
+
+  // --- Clean up files removed upstream (safeguarded) ---
+  // Four safeguards prevent the v0.6.8 incident from recurring:
+  //   S1: Classify — only delete files that map to a known CC template path
+  //   S2: Scope — only delete files from modules the user selected
+  //   S3: Itemize — list all deletions and confirm before proceeding
+  //   S4: Backup — copy files to .cc-backup/<timestamp>/ before deletion
   if (Object.keys(existingManifest).length > 0) {
-    let totalRemoved = 0;
+    // S1: Build complete template path set (ALL modules) for classification
+    const allTemplatePaths = new Set();
+    for (const mod of Object.values(MODULES)) {
+      for (const tmpl of mod.templates || []) {
+        const srcPath = path.join(templateRoot, tmpl);
+        if (fs.existsSync(srcPath) && fs.statSync(srcPath).isDirectory()) {
+          for (const rel of walkDir(srcPath)) {
+            allTemplatePaths.add(manifestPath(tmpl) + '/' + rel);
+          }
+        } else if (fs.existsSync(srcPath)) {
+          allTemplatePaths.add(manifestPath(tmpl));
+        }
+      }
+    }
+
+    // S2: Build selected-module template paths for scoping
+    const selectedTemplatePaths = new Set();
+    for (const modKey of selectedModules) {
+      const mod = MODULES[modKey];
+      for (const tmpl of mod.templates || []) {
+        const srcPath = path.join(templateRoot, tmpl);
+        if (fs.existsSync(srcPath) && fs.statSync(srcPath).isDirectory()) {
+          for (const rel of walkDir(srcPath)) {
+            selectedTemplatePaths.add(manifestPath(tmpl) + '/' + rel);
+          }
+        } else if (fs.existsSync(srcPath)) {
+          selectedTemplatePaths.add(manifestPath(tmpl));
+        }
+      }
+    }
+
+    // Build CC template skill name set for project-skill guard (act:4ac281ba)
+    const ccSkillNames = new Set();
+    for (const mod of Object.values(MODULES)) {
+      for (const tmpl of mod.templates || []) {
+        if (tmpl.startsWith('skills/')) {
+          const skillName = tmpl.split('/')[1];
+          ccSkillNames.add(skillName);
+        }
+      }
+    }
+
+    // Collect files that would be removed
+    const toRemove = [];
     for (const oldPath of Object.keys(existingManifest)) {
       if (!allManifest[oldPath]) {
         // Skip phase files — they may be user-customized
         if (/\/phases\//.test(oldPath)) continue;
+
+        // S1: Only delete if the path maps to a known CC template
+        if (!allTemplatePaths.has(oldPath)) {
+          console.log(`  Keeping non-template file: ${oldPath}`);
+          continue;
+        }
+
+        // S2: Only delete from selected modules (don't purge deselected modules)
+        if (!selectedTemplatePaths.has(oldPath)) {
+          continue;
+        }
+
+        // Project-skill guard: never delete skills CC didn't create
+        const skillDirMatch = oldPath.match(/^\.claude\/skills\/([^/]+)\//);
+        if (skillDirMatch && !ccSkillNames.has(skillDirMatch[1])) {
+          console.log(`  Keeping project skill: ${oldPath}`);
+          continue;
+        }
+
         const fullPath = path.join(projectDir, oldPath);
         if (fs.existsSync(fullPath)) {
-          if (!flags.dryRun) fs.unlinkSync(fullPath);
-          totalRemoved++;
+          toRemove.push(oldPath);
         }
       }
     }
-    if (totalRemoved > 0) {
-      console.log(`  🧹 Removed ${totalRemoved} file${totalRemoved === 1 ? '' : 's'} no longer in upstream`);
+
+    // S3: Itemize and confirm before deleting
+    if (toRemove.length > 0) {
+      console.log(`\n  Files no longer in upstream (${toRemove.length}):`);
+      for (const f of toRemove) {
+        console.log(`    - ${f}`);
+      }
+
+      let confirmed = flags.yes;
+      if (!confirmed && !flags.dryRun) {
+        const response = await prompts({
+          type: 'confirm',
+          name: 'confirmed',
+          message: `Remove ${toRemove.length} file${toRemove.length === 1 ? '' : 's'}?`,
+          initial: false,
+        });
+        confirmed = response.confirmed;
+      }
+
+      if (confirmed && !flags.dryRun) {
+        // S4: Backup before deleting
+        const backupDir = path.join(projectDir, '.cc-backup', new Date().toISOString().replace(/[:.]/g, '-'));
+        fs.mkdirSync(backupDir, { recursive: true });
+        for (const filePath of toRemove) {
+          const src = path.join(projectDir, filePath);
+          const dest = path.join(backupDir, filePath);
+          fs.mkdirSync(path.dirname(dest), { recursive: true });
+          fs.copyFileSync(src, dest);
+        }
+        console.log(`  📦 Backed up ${toRemove.length} file${toRemove.length === 1 ? '' : 's'} to ${path.relative(projectDir, backupDir)}/`);
+
+        for (const filePath of toRemove) {
+          fs.unlinkSync(path.join(projectDir, filePath));
+        }
+        console.log(`  🧹 Removed ${toRemove.length} file${toRemove.length === 1 ? '' : 's'} no longer in upstream`);
+      } else if (flags.dryRun) {
+        console.log(`  [dry run — ${toRemove.length} file${toRemove.length === 1 ? '' : 's'} would be removed]`);
+      } else {
+        console.log('  Skipped file removal.');
+      }
     }
   }
 

package/lib/copy.js

@@ -45,6 +45,19 @@ async function walkAndCopy(srcRoot, destRoot, currentSrc, results, dryRun, skipC
       if (fs.existsSync(destPath)) {
         const existing = fs.readFileSync(destPath, 'utf8');
 
+        // Phase file guard (act:98d74381) — independent of skipPhases flag.
+        // If a phase file on disk has been customized (differs from template
+        // and isn't empty), never overwrite it regardless of other flags.
+        if (relPath.includes('phases' + path.sep) || relPath.includes('phases/')) {
+          const trimmedExisting = existing.trim();
+          if (trimmedExisting !== '' && trimmedExisting !== incoming.trim()) {
+            results.skipped.push(relPath);
+            results.manifest[relPath] = hashContent(existing);
+            console.log(`  Preserved customized phase: ${displayPath}`);
+            continue;
+          }
+        }
+
         if (existing === incoming) {
           results.skipped.push(relPath);
           results.manifest[relPath] = incomingHash;

package/lib/omega-setup.js

@@ -7,17 +7,18 @@ const OMEGA_HOME = path.join(os.homedir(), '.claude-cabinet');
 const VENV_DIR = path.join(OMEGA_HOME, 'omega-venv');
 const VENV_PYTHON = path.join(VENV_DIR, 'bin', 'python3');
 
-// Ordered by preference: stable Cellar symlinks first, newest Python first.
+// Ordered by preference: 3.13 first (ONNX runtime segfaults on 3.14 during
+// shutdown — exit 139, triggers macOS crash dialogs). 3.14 last as fallback.
 // Apple Silicon paths, then Intel Mac paths, then PATH fallback.
 const PYTHON_CANDIDATES = [
-  '/opt/homebrew/opt/python@3.14/bin/python3.14',
   '/opt/homebrew/opt/python@3.13/bin/python3.13',
   '/opt/homebrew/opt/python@3.12/bin/python3.12',
   '/opt/homebrew/opt/python@3.11/bin/python3.11',
-  '/usr/local/opt/python@3.14/bin/python3.14',
+  '/opt/homebrew/opt/python@3.14/bin/python3.14',
   '/usr/local/opt/python@3.13/bin/python3.13',
   '/usr/local/opt/python@3.12/bin/python3.12',
   '/usr/local/opt/python@3.11/bin/python3.11',
+  '/usr/local/opt/python@3.14/bin/python3.14',
   '/opt/homebrew/bin/python3',
   '/usr/local/bin/python3',
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-claude-cabinet",
-  "version": "0.8.5",
+  "version": "0.9.0",
   "description": "Claude Cabinet — opinionated process scaffolding for Claude Code projects",
   "bin": {
     "create-claude-cabinet": "bin/create-claude-cabinet.js"

package/templates/scripts/work-tracker-server.mjs

@@ -0,0 +1,188 @@
+/**
+ * Work tracker server — serves the work tracker UI and provides
+ * read/write access to pib.db (projects and actions).
+ *
+ * Usage: node work-tracker-server.mjs [--port 3458] [--db path/to/pib.db]
+ */
+
+import { createServer } from 'node:http';
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join, resolve } from 'node:path';
+import Database from 'better-sqlite3';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PORT = parseInt(process.env.PORT || process.argv.find((_, i, a) => a[i - 1] === '--port') || '3458');
+const DB_PATH = resolve(process.argv.find((_, i, a) => a[i - 1] === '--db') || 'pib.db');
+
+if (!existsSync(DB_PATH)) {
+  console.error(`Database not found: ${DB_PATH}`);
+  console.error('Run: node scripts/pib-db.js init');
+  process.exit(1);
+}
+
+const db = new Database(DB_PATH, { readonly: false });
+db.pragma('journal_mode = WAL');
+
+function json(res, data, status = 200) {
+  res.writeHead(status, {
+    'Content-Type': 'application/json',
+    'Access-Control-Allow-Origin': '*',
+    'Access-Control-Allow-Methods': 'GET, POST, PATCH, OPTIONS',
+    'Access-Control-Allow-Headers': 'Content-Type',
+  });
+  res.end(JSON.stringify(data));
+}
+
+async function readBody(req) {
+  let body = '';
+  for await (const chunk of req) body += chunk;
+  return JSON.parse(body);
+}
+
+const server = createServer(async (req, res) => {
+  const url = new URL(req.url, `http://localhost:${PORT}`);
+
+  if (req.method === 'OPTIONS') {
+    res.writeHead(204, {
+      'Access-Control-Allow-Origin': '*',
+      'Access-Control-Allow-Methods': 'GET, POST, PATCH, OPTIONS',
+      'Access-Control-Allow-Headers': 'Content-Type',
+    });
+    return res.end();
+  }
+
+  try {
+    // Serve HTML
+    if (req.method === 'GET' && url.pathname === '/') {
+      const html = await readFile(join(__dirname, 'work-tracker-ui.html'), 'utf-8');
+      res.writeHead(200, { 'Content-Type': 'text/html' });
+      return res.end(html);
+    }
+
+    // GET /api/projects — list projects with action counts
+    if (req.method === 'GET' && url.pathname === '/api/projects') {
+      const status = url.searchParams.get('status') || 'active';
+      const rows = db.prepare(`
+        SELECT p.*,
+          (SELECT COUNT(*) FROM actions a WHERE a.project_fid = p.fid AND a.completed = 0 AND a.deleted_at IS NULL) as open_actions,
+          (SELECT COUNT(*) FROM actions a WHERE a.project_fid = p.fid AND a.completed = 1) as done_actions,
+          (SELECT COUNT(*) FROM actions a WHERE a.project_fid = p.fid AND a.deleted_at IS NULL) as total_actions
+        FROM projects p
+        WHERE p.deleted_at IS NULL AND p.status = ?
+        ORDER BY p.created DESC
+      `).all(status);
+      return json(res, rows);
+    }
+
+    // GET /api/actions — list actions, optionally filtered
+    if (req.method === 'GET' && url.pathname === '/api/actions') {
+      const project = url.searchParams.get('project');
+      const status = url.searchParams.get('status'); // open, done, all
+      let query = `
+        SELECT a.*, p.name as project_name
+        FROM actions a
+        LEFT JOIN projects p ON a.project_fid = p.fid
+        WHERE a.deleted_at IS NULL
+      `;
+      const params = [];
+
+      if (project) {
+        query += ' AND a.project_fid = ?';
+        params.push(project);
+      }
+      if (status === 'open') {
+        query += ' AND a.completed = 0';
+      } else if (status === 'done') {
+        query += ' AND a.completed = 1';
+      }
+
+      query += ' ORDER BY a.completed ASC, a.flagged DESC, a.sort_order ASC, a.created DESC';
+      return json(res, db.prepare(query).all(...params));
+    }
+
+    // GET /api/action/:fid — single action with full notes
+    if (req.method === 'GET' && url.pathname.startsWith('/api/action/')) {
+      const fid = decodeURIComponent(url.pathname.slice('/api/action/'.length));
+      const row = db.prepare(`
+        SELECT a.*, p.name as project_name
+        FROM actions a
+        LEFT JOIN projects p ON a.project_fid = p.fid
+        WHERE a.fid = ?
+      `).get(fid);
+      if (!row) return json(res, { error: 'Not found' }, 404);
+      return json(res, row);
+    }
+
+    // PATCH /api/action/:fid — update action fields
+    if (req.method === 'PATCH' && url.pathname.startsWith('/api/action/')) {
+      const fid = decodeURIComponent(url.pathname.slice('/api/action/'.length));
+      const body = await readBody(req);
+      const allowed = ['text', 'status', 'completed', 'flagged', 'notes', 'due', 'tags', 'project_fid'];
+      const sets = [];
+      const params = [];
+      for (const [key, val] of Object.entries(body)) {
+        if (!allowed.includes(key)) continue;
+        sets.push(`${key} = ?`);
+        params.push(val);
+      }
+      if (body.completed === 1 && !body.completed_at) {
+        sets.push('completed_at = ?');
+        params.push(new Date().toISOString().split('T')[0]);
+      }
+      if (sets.length === 0) return json(res, { error: 'Nothing to update' }, 400);
+      params.push(fid);
+      db.prepare(`UPDATE actions SET ${sets.join(', ')} WHERE fid = ?`).run(...params);
+      return json(res, { ok: true });
+    }
+
+    // PATCH /api/project/:fid — update project fields
+    if (req.method === 'PATCH' && url.pathname.startsWith('/api/project/')) {
+      const fid = decodeURIComponent(url.pathname.slice('/api/project/'.length));
+      const body = await readBody(req);
+      const allowed = ['name', 'status', 'area', 'notes', 'due'];
+      const sets = [];
+      const params = [];
+      for (const [key, val] of Object.entries(body)) {
+        if (!allowed.includes(key)) continue;
+        sets.push(`${key} = ?`);
+        params.push(val);
+      }
+      if (body.status === 'done' && !body.completed_at) {
+        sets.push('completed_at = ?');
+        params.push(new Date().toISOString().split('T')[0]);
+      }
+      if (sets.length === 0) return json(res, { error: 'Nothing to update' }, 400);
+      params.push(fid);
+      db.prepare(`UPDATE projects SET ${sets.join(', ')} WHERE fid = ?`).run(...params);
+      return json(res, { ok: true });
+    }
+
+    // GET /api/stats — dashboard summary
+    if (req.method === 'GET' && url.pathname === '/api/stats') {
+      const projects = db.prepare(`
+        SELECT status, COUNT(*) as count FROM projects WHERE deleted_at IS NULL GROUP BY status
+      `).all();
+      const actions = db.prepare(`
+        SELECT
+          SUM(CASE WHEN completed = 0 THEN 1 ELSE 0 END) as open,
+          SUM(CASE WHEN completed = 1 THEN 1 ELSE 0 END) as done,
+          SUM(CASE WHEN flagged = 1 AND completed = 0 THEN 1 ELSE 0 END) as flagged
+        FROM actions WHERE deleted_at IS NULL
+      `).get();
+      return json(res, { projects, actions });
+    }
+
+    res.writeHead(404);
+    res.end('Not found');
+  } catch (err) {
+    console.error(err);
+    json(res, { error: err.message }, 500);
+  }
+});
+
+server.listen(PORT, () => {
+  console.log(`Work tracker at http://localhost:${PORT}`);
+  console.log(`Database: ${DB_PATH}`);
+});