specweave 0.32.10 → 0.33.2

package/dist/src/utils/session-registry.js

@@ -0,0 +1,480 @@
+/**
+ * Session Registry - Central tracking for all Claude Code sessions and child processes
+ *
+ * Provides atomic file-based operations for tracking active sessions, detecting
+ * stale/zombie processes, and coordinating cleanup across multiple sessions.
+ *
+ * Key Features:
+ * - Atomic operations using temp file + rename pattern
+ * - File locking via mkdir (cross-platform atomic operation)
+ * - Automatic corruption recovery with JSON validation
+ * - Concurrent-safe updates from multiple processes
+ *
+ * Registry Location: `.specweave/state/.session-registry.json`
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { consoleLogger } from './logger.js';
+const REGISTRY_FILENAME = '.session-registry.json';
+const LOCK_TIMEOUT_MS = 5000; // 5 seconds max wait for lock
+const LOCK_CHECK_INTERVAL_MS = 50; // Check lock every 50ms
+const REGISTRY_VERSION = '1.0.0';
+export class SessionRegistry {
+    constructor(projectRoot, options = {}) {
+        this.logger = options.logger ?? consoleLogger;
+        const stateDir = path.join(projectRoot, '.specweave', 'state');
+        // Ensure state directory exists
+        if (!fs.existsSync(stateDir)) {
+            fs.mkdirSync(stateDir, { recursive: true });
+        }
+        this.registryPath = path.join(stateDir, REGISTRY_FILENAME);
+        this.lockPath = path.join(stateDir, `${REGISTRY_FILENAME}.lock`);
+    }
+    /**
+     * Acquires an exclusive lock on the registry file
+     *
+     * Uses mkdir as an atomic operation (works cross-platform)
+     * Waits up to LOCK_TIMEOUT_MS before failing
+     *
+     * @returns true if lock acquired, false if timeout
+     */
+    async acquireLock() {
+        const startTime = Date.now();
+        while (Date.now() - startTime < LOCK_TIMEOUT_MS) {
+            try {
+                // mkdir is atomic on all platforms
+                fs.mkdirSync(this.lockPath, { recursive: false });
+                // Write our PID to lock directory for debugging
+                const lockPidFile = path.join(this.lockPath, 'pid');
+                fs.writeFileSync(lockPidFile, String(process.pid));
+                return true;
+            }
+            catch (err) {
+                if (err.code !== 'EEXIST') {
+                    this.logger.error('Failed to acquire lock:', err);
+                    return false;
+                }
+                // Lock exists, wait and retry
+                await new Promise((resolve) => setTimeout(resolve, LOCK_CHECK_INTERVAL_MS));
+            }
+        }
+        this.logger.error(`Lock acquisition timeout after ${LOCK_TIMEOUT_MS}ms`);
+        return false;
+    }
+    /**
+     * Releases the lock on the registry file
+     */
+    releaseLock() {
+        try {
+            // Remove PID file first
+            const lockPidFile = path.join(this.lockPath, 'pid');
+            if (fs.existsSync(lockPidFile)) {
+                fs.unlinkSync(lockPidFile);
+            }
+            // Remove lock directory
+            fs.rmdirSync(this.lockPath);
+        }
+        catch (err) {
+            this.logger.error('Failed to release lock:', err);
+        }
+    }
+    /**
+     * Reads the registry file with corruption recovery
+     *
+     * If registry doesn't exist, creates a new empty one
+     * If registry is corrupted (invalid JSON), creates backup and reinitializes
+     *
+     * @returns The current registry state
+     */
+    readRegistry() {
+        // If registry doesn't exist, create empty one
+        if (!fs.existsSync(this.registryPath)) {
+            return this.createEmptyRegistry();
+        }
+        try {
+            const content = fs.readFileSync(this.registryPath, 'utf-8');
+            const registry = JSON.parse(content);
+            // Validate basic structure
+            if (!registry.sessions || typeof registry.sessions !== 'object') {
+                throw new Error('Invalid registry structure: missing sessions object');
+            }
+            if (!registry.version) {
+                // Migrate old registry without version
+                registry.version = REGISTRY_VERSION;
+            }
+            return registry;
+        }
+        catch (err) {
+            this.logger.error('Registry corrupted, creating backup and reinitializing:', err);
+            // Backup corrupted registry
+            const backupPath = `${this.registryPath}.corrupted.${Date.now()}`;
+            try {
+                fs.copyFileSync(this.registryPath, backupPath);
+                this.logger.info(`Corrupted registry backed up to: ${backupPath}`);
+            }
+            catch (backupErr) {
+                this.logger.error('Failed to backup corrupted registry:', backupErr);
+            }
+            // Create new empty registry
+            return this.createEmptyRegistry();
+        }
+    }
+    /**
+     * Writes registry to disk atomically
+     *
+     * Uses temp file + rename pattern for atomic write
+     * This ensures registry is never left in a corrupted state
+     *
+     * @param registry - The registry state to write
+     */
+    writeRegistry(registry) {
+        const tempPath = `${this.registryPath}.tmp.${process.pid}`;
+        try {
+            // Write to temp file with pretty formatting
+            fs.writeFileSync(tempPath, JSON.stringify(registry, null, 2), 'utf-8');
+            // Atomic rename (overwrites existing file)
+            fs.renameSync(tempPath, this.registryPath);
+        }
+        catch (err) {
+            this.logger.error('Failed to write registry:', err);
+            // Clean up temp file if it exists
+            if (fs.existsSync(tempPath)) {
+                try {
+                    fs.unlinkSync(tempPath);
+                }
+                catch (cleanupErr) {
+                    // Ignore cleanup errors
+                }
+            }
+            throw err;
+        }
+    }
+    /**
+     * Creates a new empty registry
+     */
+    createEmptyRegistry() {
+        return {
+            sessions: {},
+            last_cleanup: new Date().toISOString(),
+            version: REGISTRY_VERSION,
+        };
+    }
+    /**
+     * Registers a new session in the registry
+     *
+     * @param sessionId - Unique session identifier
+     * @param pid - Process ID of the session
+     * @param options - Optional configuration
+     * @returns true if registration successful
+     */
+    async registerSession(sessionId, pid, options = {}) {
+        const lockAcquired = await this.acquireLock();
+        if (!lockAcquired) {
+            this.logger.error('Failed to acquire lock for session registration');
+            return false;
+        }
+        try {
+            const registry = this.readRegistry();
+            const now = new Date().toISOString();
+            // Check if session already exists
+            if (registry.sessions[sessionId]) {
+                this.logger.warn(`Session ${sessionId} already registered, updating...`);
+            }
+            // Create session entry
+            const sessionInfo = {
+                session_id: sessionId,
+                pid,
+                type: options.type ?? 'claude-code',
+                start_time: now,
+                last_heartbeat: now,
+                status: 'active',
+                child_pids: [],
+                parent_session: options.parent_session,
+                metadata: options.metadata,
+            };
+            registry.sessions[sessionId] = sessionInfo;
+            this.writeRegistry(registry);
+            this.logger.info(`Registered session: ${sessionId} (PID: ${pid})`);
+            return true;
+        }
+        finally {
+            this.releaseLock();
+        }
+    }
+    /**
+     * Updates the heartbeat timestamp for a session
+     *
+     * @param sessionId - Session to update
+     * @returns true if update successful
+     */
+    async updateHeartbeat(sessionId) {
+        const lockAcquired = await this.acquireLock();
+        if (!lockAcquired) {
+            return false;
+        }
+        try {
+            const registry = this.readRegistry();
+            const session = registry.sessions[sessionId];
+            if (!session) {
+                this.logger.error(`Session not found: ${sessionId}`);
+                return false;
+            }
+            session.last_heartbeat = new Date().toISOString();
+            session.status = 'active'; // Reset to active on heartbeat
+            this.writeRegistry(registry);
+            return true;
+        }
+        finally {
+            this.releaseLock();
+        }
+    }
+    /**
+     * Adds a child process PID to a session
+     *
+     * @param sessionId - Parent session ID
+     * @param childPid - Child process PID to add
+     * @returns true if successful
+     */
+    async addChildProcess(sessionId, childPid) {
+        const lockAcquired = await this.acquireLock();
+        if (!lockAcquired) {
+            return false;
+        }
+        try {
+            const registry = this.readRegistry();
+            const session = registry.sessions[sessionId];
+            if (!session) {
+                this.logger.error(`Session not found: ${sessionId}`);
+                return false;
+            }
+            if (!session.child_pids) {
+                session.child_pids = [];
+            }
+            // Avoid duplicates
+            if (!session.child_pids.includes(childPid)) {
+                session.child_pids.push(childPid);
+                this.writeRegistry(registry);
+                this.logger.info(`Added child PID ${childPid} to session ${sessionId}`);
+            }
+            return true;
+        }
+        finally {
+            this.releaseLock();
+        }
+    }
+    /**
+     * Removes a session from the registry
+     *
+     * @param sessionId - Session to remove
+     * @returns true if successful
+     */
+    async removeSession(sessionId) {
+        const lockAcquired = await this.acquireLock();
+        if (!lockAcquired) {
+            return false;
+        }
+        try {
+            const registry = this.readRegistry();
+            if (!registry.sessions[sessionId]) {
+                this.logger.warn(`Session not found for removal: ${sessionId}`);
+                return false;
+            }
+            delete registry.sessions[sessionId];
+            this.writeRegistry(registry);
+            this.logger.info(`Removed session: ${sessionId}`);
+            return true;
+        }
+        finally {
+            this.releaseLock();
+        }
+    }
+    /**
+     * Gets a session by ID
+     *
+     * @param sessionId - Session to retrieve
+     * @returns Session info or undefined
+     */
+    async getSession(sessionId) {
+        const lockAcquired = await this.acquireLock();
+        if (!lockAcquired) {
+            return undefined;
+        }
+        try {
+            const registry = this.readRegistry();
+            return registry.sessions[sessionId];
+        }
+        finally {
+            this.releaseLock();
+        }
+    }
+    /**
+     * Gets all sessions
+     *
+     * @returns Array of all session info
+     */
+    async getAllSessions() {
+        const lockAcquired = await this.acquireLock();
+        if (!lockAcquired) {
+            return [];
+        }
+        try {
+            const registry = this.readRegistry();
+            return Object.values(registry.sessions);
+        }
+        finally {
+            this.releaseLock();
+        }
+    }
+    /**
+     * Updates the status of a session
+     *
+     * @param sessionId - Session to update
+     * @param status - New status
+     * @returns true if successful
+     */
+    async updateStatus(sessionId, status) {
+        const lockAcquired = await this.acquireLock();
+        if (!lockAcquired) {
+            return false;
+        }
+        try {
+            const registry = this.readRegistry();
+            const session = registry.sessions[sessionId];
+            if (!session) {
+                this.logger.error(`Session not found: ${sessionId}`);
+                return false;
+            }
+            session.status = status;
+            this.writeRegistry(registry);
+            return true;
+        }
+        finally {
+            this.releaseLock();
+        }
+    }
+    /**
+     * Gets all stale sessions based on heartbeat threshold
+     *
+     * A session is considered stale if its last_heartbeat is older than
+     * the specified threshold.
+     *
+     * @param thresholdSeconds - Max age of last heartbeat before considered stale
+     * @returns Array of stale session info with staleness details
+     */
+    async getStaleSessions(thresholdSeconds) {
+        const lockAcquired = await this.acquireLock();
+        if (!lockAcquired) {
+            return [];
+        }
+        try {
+            const registry = this.readRegistry();
+            const now = Date.now();
+            const staleSessions = [];
+            for (const session of Object.values(registry.sessions)) {
+                const lastHeartbeat = new Date(session.last_heartbeat).getTime();
+                const ageSec = (now - lastHeartbeat) / 1000;
+                if (ageSec > thresholdSeconds) {
+                    // Check if PID still exists (cross-platform)
+                    const pidExists = await this.checkPidExists(session.pid);
+                    staleSessions.push({
+                        session,
+                        stale_duration_seconds: ageSec,
+                        pid_exists: pidExists,
+                    });
+                    // Mark session as stale
+                    session.status = 'stale';
+                }
+            }
+            // Update registry with stale statuses
+            if (staleSessions.length > 0) {
+                this.writeRegistry(registry);
+            }
+            return staleSessions;
+        }
+        finally {
+            this.releaseLock();
+        }
+    }
+    /**
+     * Cleans up old sessions based on retention period
+     *
+     * Removes sessions that have been completed or stale for longer
+     * than the retention period.
+     *
+     * @param retentionHours - How long to keep old sessions (in hours)
+     * @returns Number of sessions removed
+     */
+    async cleanupOldSessions(retentionHours) {
+        const lockAcquired = await this.acquireLock();
+        if (!lockAcquired) {
+            return 0;
+        }
+        try {
+            const registry = this.readRegistry();
+            const now = Date.now();
+            const retentionMs = retentionHours * 60 * 60 * 1000;
+            const sessionsToRemove = [];
+            for (const [sessionId, session] of Object.entries(registry.sessions)) {
+                // Only clean up completed or stale sessions
+                if (session.status !== 'completed' && session.status !== 'stale') {
+                    continue;
+                }
+                // Check age based on last_heartbeat
+                const lastActivity = new Date(session.last_heartbeat).getTime();
+                const ageMs = now - lastActivity;
+                if (ageMs > retentionMs) {
+                    sessionsToRemove.push(sessionId);
+                }
+            }
+            // Remove old sessions
+            for (const sessionId of sessionsToRemove) {
+                delete registry.sessions[sessionId];
+                this.logger.info(`Cleaned up old session: ${sessionId} (age: ${Math.floor((now - new Date(registry.sessions[sessionId]?.last_heartbeat || now).getTime()) / 3600000)}h)`);
+            }
+            // Update last_cleanup timestamp
+            registry.last_cleanup = new Date().toISOString();
+            if (sessionsToRemove.length > 0) {
+                this.writeRegistry(registry);
+            }
+            return sessionsToRemove.length;
+        }
+        finally {
+            this.releaseLock();
+        }
+    }
+    /**
+     * Checks if a PID exists (cross-platform)
+     *
+     * Uses kill -0 on Unix-like systems, which doesn't actually send a signal
+     * but checks if the process exists.
+     *
+     * @param pid - Process ID to check
+     * @returns true if process exists
+     */
+    async checkPidExists(pid) {
+        try {
+            // On Unix-like systems (macOS, Linux), kill -0 checks process existence
+            // without actually sending a signal
+            if (process.platform === 'win32') {
+                // Windows: use tasklist
+                const { execSync } = await import('child_process');
+                const output = execSync(`tasklist /FI "PID eq ${pid}" /NH`, {
+                    encoding: 'utf-8',
+                    stdio: ['ignore', 'pipe', 'ignore'],
+                });
+                return output.includes(String(pid));
+            }
+            else {
+                // Unix-like (macOS, Linux)
+                const { execSync } = await import('child_process');
+                execSync(`kill -0 ${pid}`, { stdio: 'ignore' });
+                return true;
+            }
+        }
+        catch {
+            // Process doesn't exist or we don't have permission
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=session-registry.js.map

package/dist/src/utils/session-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-registry.js","sourceRoot":"","sources":["../../../src/utils/session-registry.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.32.10",
+  "version": "0.33.2",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",
@@ -19,9 +19,12 @@
     "prepublishOnly": "npm run rebuild",
     "test:unit": "vitest run tests/unit --coverage",
     "test:integration": "vitest run tests/integration --coverage",
+    "test:lifecycle": "npm run test:unit && npm run test:integration",
+    "test:e2e:lifecycle": "vitest run tests/e2e/normal-session-lifecycle.e2e.ts tests/e2e/crash-recovery.e2e.ts tests/e2e/multiple-sessions.e2e.ts",
+    "test:performance": "ts-node tests/performance/session-registry-bench.ts && bash tests/performance/heartbeat-overhead-bench.sh && ts-node tests/performance/compare-to-baseline.ts",
     "test:smoke": "bash tests/smoke/smoke-test.sh",
     "test:e2e": "playwright test tests/e2e/ --grep-invert=\"(should default to claude adapter|should use claude adapter when explicitly requested|should use generic adapter|should create .claude|should initialize project with specweave init|should create correct directory structure|should handle non-interactive mode correctly|should validate config.json structure|should create .specweave directory structure|should create CLAUDE.md and AGENTS.md|should initialize git repository|should install SpecWeave|should scaffold SaaS|should create proper directory|should create required configuration|should install core skills|should install core agents|should have deployment|should have Stripe|ADO Sync|Increment Discipline Blocking|Self-Reflection|Increment Discipline Enforcement)\"",
-    "test:all": "npm run test:unit && npm run test:integration && npm run test:e2e",
+    "test:all": "npm run test:unit && npm run test:integration && npm run test:e2e && npm run test:e2e:lifecycle",
     "test:coverage": "vitest run --coverage",
     "test": "npm run test:smoke",
     "benchmark": "ts-node tests/performance/run-all-benchmarks.ts",

package/plugins/specweave/commands/specweave-living-docs.md

@@ -31,6 +31,7 @@ Launch the Living Docs Builder independently of `specweave init`. This is essent
 | `--sources <folders>` | Additional doc folders (comma-separated): `docs/,wiki/` |
 | `--depends-on <jobIds>` | Wait for jobs before starting (comma-separated) |
 | `--foreground` | Run in current session instead of background |
+| `--full` | Force full rebuild by clearing cache and checkpoints (bypasses incremental mode) |
 
 ---
 
@@ -73,6 +74,9 @@ Launch the Living Docs Builder independently of `specweave init`. This is essent
 
 # AI-powered deep analysis (FREE with MAX subscription)
 /specweave:living-docs --depth deep-native --priority core,api
+
+# Force full rebuild (clears cache and checkpoints)
+/specweave:living-docs --full --depth standard
 ```
 
 ---
@@ -220,6 +224,44 @@ The job will:
 
 ---
 
+## Update Summary (v0.33.0+)
+
+After completion, you'll see a detailed summary showing:
+
+```
+✅ LIVING DOCS UPDATE COMPLETE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 SUMMARY:
+
+  Discovery: Discovered 3 repos (2,845 files)
+    Duration: 5s
+
+  Analysis: Analyzed 3 repos
+    Duration: 127s
+
+  Synthesis: Generated 12 ADRs, 4 teams
+    Duration: 43s
+
+  Files Created: 47
+    • .specweave/docs/internal/repos/main/overview.md
+    • .specweave/docs/internal/repos/main/api-surface.md
+    • .specweave/docs/internal/architecture/system-architecture.md
+    • .specweave/docs/internal/architecture/adr/0001-typescript-migration.md
+    • .specweave/docs/internal/architecture/adr/0002-plugin-system.md
+    ... and 42 more
+
+  Files Updated: 8
+    • .specweave/docs/internal/modules/auth.md
+    • .specweave/docs/internal/modules/payments.md
+    ... and 6 more
+
+  Total Duration: 175s
+  Mode: INCREMENTAL (cache used)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
 ## Output Files
 
 After completion:

package/plugins/specweave/hooks/hooks.json

@@ -69,6 +69,16 @@
             "command": "bash -c 'W=\"${CLAUDE_PLUGIN_ROOT}/hooks/universal/fail-fast-wrapper.sh\"; S=\"${CLAUDE_PLUGIN_ROOT}/hooks/v2/guards/increment-duplicate-guard.sh\"; [[ -x \"$W\" ]] && exec \"$W\" \"$S\" || (cat >/dev/null && printf \"{\\\"decision\\\":\\\"allow\\\"}\")'"
           }
         ]
+      },
+      {
+        "matcher": "Write",
+        "matcher_content": "\\.specweave/increments/\\d{3,4}E?-[^/]+/[^/]+$",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash -c 'W=\"${CLAUDE_PLUGIN_ROOT}/hooks/universal/fail-fast-wrapper.sh\"; S=\"${CLAUDE_PLUGIN_ROOT}/hooks/v2/guards/increment-root-guard.sh\"; [[ -x \"$W\" ]] && exec \"$W\" \"$S\" || (cat >/dev/null && printf \"{\\\"decision\\\":\\\"allow\\\"}\")'"
+          }
+        ]
       }
     ],
     "PostToolUse": [

package/plugins/specweave/hooks/lib/update-active-increment.sh

@@ -37,7 +37,7 @@ mkdir -p "$STATE_DIR" 2>/dev/null || true
 # ============================================================================
 # SCAN ALL INCREMENTS FOR ACTIVE STATUS
 # ============================================================================
-# Strategy: Scan metadata.json files for status=active|planning|in-progress
+# Strategy: Scan metadata.json files for status=active|planning|backlog|ready_for_review
 # This matches what ActiveIncrementManager.smartUpdate() does in TypeScript
 
 ACTIVE_IDS=()
@@ -54,7 +54,7 @@ while IFS= read -r metadata_file; do
   fi
 
   # Check if status is active-like
-  if [[ "$status" == "active" ]] || [[ "$status" == "planning" ]] || [[ "$status" == "in-progress" ]]; then
+  if [[ "$status" == "active" ]] || [[ "$status" == "planning" ]] || [[ "$status" == "backlog" ]] || [[ "$status" == "ready_for_review" ]]; then
     increment_id=$(basename "$(dirname "$metadata_file")")
     ACTIVE_IDS+=("$increment_id")
     echo "[$(date)] update-active-increment: Found active: $increment_id (status: $status)" >> "$DEBUG_LOG" 2>/dev/null || true

package/plugins/specweave/hooks/lib/update-status-line.sh

@@ -129,7 +129,7 @@ while IFS= read -r metadata_file; do
   fi
 
   # Check if active
-  if [[ "$status" == "active" || "$status" == "planning" || "$status" == "in-progress" ]]; then
+  if [[ "$status" == "active" || "$status" == "planning" || "$status" == "backlog" || "$status" == "ready_for_review" ]]; then
     OPEN_COUNT=$((OPEN_COUNT + 1))
     increment_id=$(basename "$(dirname "$metadata_file")")
 

package/plugins/specweave/hooks/post-increment-status-change.sh

@@ -62,7 +62,7 @@ echo "[$(date)] 📊 Status changed: $NEW_STATUS" >> "$DEBUG_LOG" 2>/dev/null ||
 
 # Validate status
 case "$NEW_STATUS" in
-  paused|resumed|abandoned|active|in-progress)
+  paused|abandoned|active|planning|backlog|ready_for_review|completed)
     ;;
   *)
     echo "[$(date)] ⚠️  Unknown status: $NEW_STATUS (skipping sync)" >> "$DEBUG_LOG" 2>/dev/null || true
@@ -107,11 +107,11 @@ fi
 # ============================================================================
 
 case "$NEW_STATUS" in
-  resumed|active|in-progress)
+  active|planning|backlog|ready_for_review)
     # ========================================================================
     # REOPEN GitHub Issues (NEW)
     # ========================================================================
-    # When increment is resumed, reopen all closed GitHub issues
+    # When increment becomes active (including resumed from pause), reopen all closed GitHub issues
     echo "[$(date)] ▶️  Status is $NEW_STATUS - checking if issues need reopening" >> "$DEBUG_LOG" 2>/dev/null || true
 
     if command -v node &> /dev/null; then

package/plugins/specweave/hooks/post-metadata-change.sh

@@ -224,7 +224,7 @@ case "$CURRENT_STATUS" in
     bash "$HOOK_DIR/lib/update-status-line.sh" --force 2>/dev/null || true
     ;;
 
-  active|planning|in-progress)
+  active|planning|backlog|ready_for_review)
     # Increment became active - MUST register in active-increment.json!
     # CRITICAL FIX (v0.26.15): post-task-completion.sh depends on this file
     # Without registration, ALL sync operations are skipped!