@regression-io/claude-config 0.36.18 → 0.37.3

package/config-loader.js

@@ -28,7 +28,7 @@ const { init, show } = require('./lib/init');
 const { memoryList, memoryInit, memoryAdd, memorySearch } = require('./lib/memory');
 const { envList, envSet, envUnset } = require('./lib/env');
 const { getProjectsRegistryPath, loadProjectsRegistry, saveProjectsRegistry, projectList, projectAdd, projectRemove } = require('./lib/projects');
-const { getWorkstreamsPath, loadWorkstreams, saveWorkstreams, workstreamList, workstreamCreate, workstreamUpdate, workstreamDelete, workstreamUse, workstreamActive, workstreamAddProject, workstreamRemoveProject, workstreamInject, workstreamDetect, workstreamGet } = require('./lib/workstreams');
+const { getWorkstreamsPath, loadWorkstreams, saveWorkstreams, workstreamList, workstreamCreate, workstreamUpdate, workstreamDelete, workstreamUse, workstreamActive, workstreamAddProject, workstreamRemoveProject, workstreamInject, workstreamDetect, workstreamGet, getActiveWorkstream, countWorkstreamsForProject, workstreamInstallHook, workstreamDeactivate } = require('./lib/workstreams');
 const { getActivityPath, getDefaultActivity, loadActivity, saveActivity, detectProjectRoot, activityLog, activitySummary, generateWorkstreamName, activitySuggestWorkstreams, activityClear } = require('./lib/activity');
 const { getSmartSyncPath, loadSmartSyncPrefs, saveSmartSyncPrefs, smartSyncRememberChoice, smartSyncDismissNudge, smartSyncUpdateSettings, smartSyncDetect, smartSyncCheckNudge, smartSyncHandleAction, smartSyncStatus } = require('./lib/smart-sync');
 const { runCli } = require('./lib/cli');
@@ -128,6 +128,10 @@ class ClaudeConfigManager {
   workstreamInject(silent) { return workstreamInject(this.installDir, silent); }
   workstreamDetect(dir) { return workstreamDetect(this.installDir, dir); }
   workstreamGet(id) { return workstreamGet(this.installDir, id); }
+  getActiveWorkstream() { return getActiveWorkstream(this.installDir); }
+  countWorkstreamsForProject(projectPath) { return countWorkstreamsForProject(this.installDir, projectPath); }
+  workstreamInstallHook() { return workstreamInstallHook(); }
+  workstreamDeactivate() { return workstreamDeactivate(); }
 
   // Activity
   getActivityPath() { return getActivityPath(this.installDir); }

package/lib/cli.js

@@ -112,12 +112,16 @@ function runCli(manager) {
         const ws = manager.workstreamActive();
         if (ws) {
           console.log(`Active: ${ws.name}`);
-          if (ws.projects.length > 0) {
+          if (ws.projects && ws.projects.length > 0) {
             console.log(`Projects: ${ws.projects.map(p => path.basename(p)).join(', ')}`);
           }
         } else {
           console.log('No active workstream');
         }
+      } else if (args[1] === 'install-hook') {
+        manager.workstreamInstallHook();
+      } else if (args[1] === 'deactivate') {
+        manager.workstreamDeactivate();
       } else {
         manager.workstreamList();
       }
@@ -189,12 +193,17 @@ Workstream Commands:
   workstream                 List all workstreams
   workstream create "Name"   Create new workstream
   workstream delete <name>   Delete workstream
-  workstream use <name>      Set active workstream
+  workstream use <name>      Set active workstream (global)
   workstream active          Show current active workstream
+  workstream deactivate      Show how to deactivate workstream
   workstream add <ws> <path>     Add project to workstream
   workstream remove <ws> <path>  Remove project from workstream
-  workstream inject [--silent] Output active workstream rules (for hooks)
+  workstream inject [--silent]   Output restriction + context (for hooks)
   workstream detect [path]   Detect workstream for directory
+  workstream install-hook    Install pre-prompt hook for injection
+
+  Per-session activation (enables parallel work):
+    export CLAUDE_WORKSTREAM=<name-or-id>
 
 Registry Commands:
   registry                       List MCPs in global registry

package/lib/constants.js

@@ -2,7 +2,7 @@
  * Constants and tool path configurations
  */
 
-const VERSION = '0.36.17';
+const VERSION = '0.37.2';
 
 // Tool-specific path configurations
 const TOOL_PATHS = {

package/lib/workstreams.js

@@ -188,11 +188,10 @@ function workstreamUse(installDir, idOrName) {
 }
 
 /**
- * Get active workstream
+ * Get active workstream (uses env var or file-based activeId)
  */
 function workstreamActive(installDir) {
-  const data = loadWorkstreams(installDir);
-  return data.workstreams.find(w => w.id === data.activeId) || null;
+  return getActiveWorkstream(installDir);
 }
 
 /**
@@ -253,23 +252,81 @@ function workstreamRemoveProject(installDir, idOrName, projectPath) {
 }
 
 /**
- * Inject active workstream rules into Claude context
+ * Get active workstream - checks env var first, then falls back to file
+ */
+function getActiveWorkstream(installDir) {
+  const data = loadWorkstreams(installDir);
+
+  // Check env var first (per-session activation)
+  const envWorkstream = process.env.CLAUDE_WORKSTREAM;
+  if (envWorkstream) {
+    const ws = data.workstreams.find(
+      w => w.id === envWorkstream || w.name.toLowerCase() === envWorkstream.toLowerCase()
+    );
+    if (ws) return ws;
+  }
+
+  // Fall back to file-based activeId
+  return data.workstreams.find(w => w.id === data.activeId) || null;
+}
+
+/**
+ * Inject active workstream context into Claude - includes restriction and context
  */
 function workstreamInject(installDir, silent = false) {
-  const active = workstreamActive(installDir);
+  const active = getActiveWorkstream(installDir);
 
   if (!active) {
     if (!silent) console.log('No active workstream');
     return null;
   }
 
-  if (!active.rules || active.rules.trim() === '') {
-    if (!silent) console.log(`Workstream "${active.name}" has no rules defined`);
-    return null;
+  // Build the injection output
+  const lines = [];
+
+  // Header
+  lines.push(`## Active Workstream: ${active.name}`);
+  lines.push('');
+
+  // Restriction section (always include if there are projects)
+  if (active.projects && active.projects.length > 0) {
+    lines.push('### Restriction');
+    lines.push('');
+    lines.push('You are working within a scoped workstream. You may ONLY access files within these directories:');
+    lines.push('');
+    for (const p of active.projects) {
+      const displayPath = p.replace(process.env.HOME || '', '~');
+      lines.push(`- ${displayPath}`);
+    }
+    lines.push('');
+    lines.push('**Do NOT read, write, search, or reference files outside these directories.**');
+    lines.push('');
   }
 
-  const header = `## Active Workstream: ${active.name}\n\n`;
-  const output = header + active.rules;
+  // Context section (user-defined context/rules)
+  const context = active.context || active.rules || '';
+  if (context.trim()) {
+    lines.push('### Context');
+    lines.push('');
+    lines.push(context.trim());
+    lines.push('');
+  }
+
+  // Repositories table
+  if (active.projects && active.projects.length > 0) {
+    lines.push('### Repositories in this Workstream');
+    lines.push('');
+    lines.push('| Repository | Path |');
+    lines.push('|------------|------|');
+    for (const p of active.projects) {
+      const name = path.basename(p);
+      const displayPath = p.replace(process.env.HOME || '', '~');
+      lines.push(`| ${name} | ${displayPath} |`);
+    }
+    lines.push('');
+  }
+
+  const output = lines.join('\n');
 
   if (!silent) {
     console.log(output);
@@ -315,6 +372,76 @@ function workstreamGet(installDir, id) {
   return data.workstreams.find(w => w.id === id) || null;
 }
 
+/**
+ * Count how many workstreams include a given project path
+ */
+function countWorkstreamsForProject(installDir, projectPath) {
+  const data = loadWorkstreams(installDir);
+  const absPath = path.resolve(projectPath.replace(/^~/, process.env.HOME || ''));
+  return data.workstreams.filter(ws =>
+    ws.projects && ws.projects.includes(absPath)
+  ).length;
+}
+
+/**
+ * Install the pre-prompt hook for workstream injection
+ */
+function workstreamInstallHook() {
+  const hookDir = path.join(process.env.HOME || '', '.claude', 'hooks');
+  const hookPath = path.join(hookDir, 'pre-prompt.sh');
+
+  // Ensure hooks directory exists
+  if (!fs.existsSync(hookDir)) {
+    fs.mkdirSync(hookDir, { recursive: true });
+  }
+
+  const hookContent = `#!/bin/bash
+# Claude Code pre-prompt hook for workstream injection
+# Installed by claude-config
+
+# Check for active workstream via env var or file
+if [ -n "$CLAUDE_WORKSTREAM" ] || claude-config workstream active >/dev/null 2>&1; then
+  claude-config workstream inject --silent
+fi
+`;
+
+  // Check if hook already exists
+  if (fs.existsSync(hookPath)) {
+    const existing = fs.readFileSync(hookPath, 'utf8');
+    if (existing.includes('claude-config workstream inject')) {
+      console.log('✓ Workstream hook already installed');
+      return true;
+    }
+    // Append to existing hook
+    fs.appendFileSync(hookPath, '\n' + hookContent);
+    console.log('✓ Appended workstream injection to existing pre-prompt hook');
+  } else {
+    fs.writeFileSync(hookPath, hookContent);
+    fs.chmodSync(hookPath, '755');
+    console.log('✓ Installed pre-prompt hook at ~/.claude/hooks/pre-prompt.sh');
+  }
+
+  console.log('\nWorkstream injection is now active. When a workstream is active,');
+  console.log('Claude will see the restriction and context at the start of each prompt.');
+  console.log('\nTo activate a workstream for this session:');
+  console.log('  export CLAUDE_WORKSTREAM=<name-or-id>');
+  console.log('\nOr use the global active workstream:');
+  console.log('  claude-config workstream use <name>');
+
+  return true;
+}
+
+/**
+ * Deactivate workstream (output shell command to unset env var)
+ */
+function workstreamDeactivate() {
+  console.log('To deactivate the workstream for this session, run:');
+  console.log('  unset CLAUDE_WORKSTREAM');
+  console.log('\nOr to clear the global active workstream:');
+  console.log('  claude-config workstream use --clear');
+  return true;
+}
+
 module.exports = {
   getWorkstreamsPath,
   loadWorkstreams,
@@ -330,4 +457,8 @@ module.exports = {
   workstreamInject,
   workstreamDetect,
   workstreamGet,
+  getActiveWorkstream,
+  countWorkstreamsForProject,
+  workstreamInstallHook,
+  workstreamDeactivate,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@regression-io/claude-config",
-  "version": "0.36.18",
+  "version": "0.37.3",
   "description": "Configuration management UI for Claude Code and Antigravity - manage MCPs, rules, commands, memory, and project folders",
   "author": "regression.io",
   "main": "config-loader.js",