npm - specweave - Versions diffs - 1.0.588 → 1.0.590 - Mend

specweave 1.0.588 → 1.0.590

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (31) hide show

package/.claude-plugin/marketplace.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "1.0.586",
+  "version": "1.0.590",
   "description": "SpecWeave - Spec-Driven Development Framework. PM-led planning, intelligent model selection, living documentation, multi-tool support.",
   "owner": {
     "name": "Anton Abyzov",
@@ -12,7 +12,7 @@
       "description": "SpecWeave unified plugin — increment lifecycle, living docs, PM-led planning, GitHub/JIRA/ADO sync, docs generation, release management, diagrams, AI media",
       "source": "./plugins/specweave",
       "category": "development",
-      "version": "1.0.586",
+      "version": "1.0.590",
       "author": {
         "name": "Anton Abyzov",
         "email": "anton.abyzov@gmail.com"

package/dist/src/core/hooks/handlers/hook-router.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"hook-router.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/hook-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,YAAY,CAAC;~~AAgBxD~~;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CAwFrB"}
1	+ {"version":3,"file":"hook-router.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/hook-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,YAAY,CAAC;AAyBxD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CAwFrB"}

package/dist/src/core/hooks/handlers/hook-router.js CHANGED Viewed

@@ -19,6 +19,15 @@ const HANDLERS = {
     // Gated Stop variant — fires only under an active auto session (AC-US7-02).
     // Maps the module's `handleStop` export onto the router's `handle` contract.
     'stop': () => import('./pre-compact.js').then((m) => ({ handle: m.handleStop })),
+    // Restored in 0870 — these were dead since 0f81519b1 (hooks.json invoked them
+    // but the router never registered them, so they silently no-op'd).
+    'session-start': () => import('./session-start.js'),
+    'post-tool-use': () => import('./post-tool-use.js'),
+    'post-tool-use-analytics': () => import('./post-tool-use-analytics.js'),
+    'stop-reflect': () => import('./stop-reflect.js'),
+    'stop-sync': () => import('./stop-sync.js'),
+    // Real blocking auto-loop driver (0870 rewrite — see stop-auto.ts).
+    'stop-auto': () => import('./stop-auto.js'),
 };
 /**
  * Route a hook event to the correct handler.

package/dist/src/core/hooks/handlers/hook-router.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"hook-router.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/hook-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,+EAA+E;AAC/E,MAAM,QAAQ,GAAyD;IACrE,oBAAoB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAAC;IAC7D,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC;IACjD,qEAAqE;IACrE,aAAa,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAC/C,4EAA4E;IAC5E,6EAA6E;IAC7E,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;~~CACjF~~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"}
1	+ {"version":3,"file":"hook-router.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/hook-router.ts"],"names":[],"mappings":"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"}

package/dist/src/core/hooks/handlers/post-tool-use-analytics.d.ts ADDED Viewed

@@ -0,0 +1,11 @@
+/**
+ * PostToolUse analytics handler — tracks Skill and Task (subagent) usage.
+ *
+ * Appends events to `<stateDir>/analytics/events.jsonl`.
+ * Non-blocking, never throws.
+ *
+ * @module core/hooks/handlers/post-tool-use-analytics
+ */
+import type { HandlerFn } from './types.js';
+export declare const handle: HandlerFn;
+//# sourceMappingURL=post-tool-use-analytics.d.ts.map

package/dist/src/core/hooks/handlers/post-tool-use-analytics.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"post-tool-use-analytics.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/post-tool-use-analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,YAAY,CAAC;AA0BvD,eAAO,MAAM,MAAM,EAAE,SAoCpB,CAAC"}

package/dist/src/core/hooks/handlers/post-tool-use-analytics.js ADDED Viewed

@@ -0,0 +1,75 @@
+/**
+ * PostToolUse analytics handler — tracks Skill and Task (subagent) usage.
+ *
+ * Appends events to `<stateDir>/analytics/events.jsonl`.
+ * Non-blocking, never throws.
+ *
+ * @module core/hooks/handlers/post-tool-use-analytics
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+const CONTINUE = { continue: true };
+function getToolInput(input) {
+    return (input.tool_input ?? input.toolInput ?? {});
+}
+function resolveToolName(input) {
+    const explicit = (input.tool_name ?? input.toolName ?? '');
+    if (explicit)
+        return explicit;
+    // Fallback: detect from input fields
+    const ti = getToolInput(input);
+    if (ti.skill)
+        return 'Skill';
+    if (ti.subagent_type)
+        return 'Task';
+    return '';
+}
+function extractPlugin(skillName) {
+    if (!skillName.includes(':'))
+        return 'specweave';
+    const prefix = skillName.split(':')[0];
+    return prefix === 'sw' ? 'specweave' : prefix;
+}
+export const handle = async (input, context) => {
+    const toolName = resolveToolName(input);
+    const ti = getToolInput(input);
+    if (toolName === 'Skill') {
+        const skillName = (ti.skill ?? '');
+        if (!skillName)
+            return CONTINUE;
+        const plugin = extractPlugin(skillName);
+        const event = {
+            timestamp: context.timestamp,
+            type: 'skill',
+            name: skillName,
+            success: true,
+            plugin,
+        };
+        appendEvent(context.stateDir, event);
+        return CONTINUE;
+    }
+    if (toolName === 'Task') {
+        const agentType = (ti.subagent_type ?? 'general');
+        const event = {
+            timestamp: context.timestamp,
+            type: 'agent',
+            name: agentType,
+            success: true,
+            plugin: 'specweave',
+        };
+        appendEvent(context.stateDir, event);
+        return CONTINUE;
+    }
+    return CONTINUE;
+};
+function appendEvent(stateDir, event) {
+    try {
+        const analyticsDir = path.join(stateDir, 'analytics');
+        fs.mkdirSync(analyticsDir, { recursive: true });
+        fs.appendFileSync(path.join(analyticsDir, 'events.jsonl'), JSON.stringify(event) + '\n');
+    }
+    catch {
+        // Never throw from analytics
+    }
+}
+//# sourceMappingURL=post-tool-use-analytics.js.map

package/dist/src/core/hooks/handlers/post-tool-use-analytics.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"post-tool-use-analytics.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/post-tool-use-analytics.ts"],"names":[],"mappings":"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"}

package/dist/src/core/hooks/handlers/post-tool-use.d.ts ADDED Viewed

@@ -0,0 +1,11 @@
+/**
+ * PostToolUse hook handler — non-blocking event detector and queue writer.
+ *
+ * Detects changes to increment files and queues events to pending.jsonl
+ * for later processing by stop-sync.
+ *
+ * @module core/hooks/handlers/post-tool-use
+ */
+import type { HandlerFn } from './types.js';
+export declare const handle: HandlerFn;
+//# sourceMappingURL=post-tool-use.d.ts.map

package/dist/src/core/hooks/handlers/post-tool-use.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"post-tool-use.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/post-tool-use.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,YAAY,CAAC;AA2CvD,eAAO,MAAM,MAAM,EAAE,SA+CpB,CAAC"}

package/dist/src/core/hooks/handlers/post-tool-use.js ADDED Viewed

@@ -0,0 +1,76 @@
+/**
+ * PostToolUse hook handler — non-blocking event detector and queue writer.
+ *
+ * Detects changes to increment files and queues events to pending.jsonl
+ * for later processing by stop-sync.
+ *
+ * @module core/hooks/handlers/post-tool-use
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+const CONTINUE = { continue: true };
+function getToolInput(input) {
+    return (input.tool_input ?? input.toolInput ?? {});
+}
+function getFilePath(input) {
+    const ti = getToolInput(input);
+    return (ti.file_path ?? '');
+}
+function extractIncrementId(filePath) {
+    const match = filePath.match(/(\d{4}-[^/]+)/);
+    return match ? match[1] : null;
+}
+function queueEvent(stateDir, event, incrementId, timestamp, data) {
+    try {
+        const queueDir = path.join(stateDir, 'event-queue');
+        fs.mkdirSync(queueDir, { recursive: true });
+        const entry = {
+            event,
+            incrementId,
+            timestamp,
+            ...(data ? { data } : {}),
+        };
+        fs.appendFileSync(path.join(queueDir, 'pending.jsonl'), JSON.stringify(entry) + '\n');
+    }
+    catch {
+        // Never throw from event queuing
+    }
+}
+export const handle = async (input, context) => {
+    const filePath = getFilePath(input);
+    // Ignore non-increment files
+    if (!filePath.includes('.specweave/increments/')) {
+        return CONTINUE;
+    }
+    const incrementId = extractIncrementId(filePath);
+    if (!incrementId)
+        return CONTINUE;
+    const basename = path.basename(filePath);
+    // metadata.json → detect status changes
+    if (basename === 'metadata.json') {
+        try {
+            if (fs.existsSync(filePath)) {
+                const raw = fs.readFileSync(filePath, 'utf-8');
+                const meta = JSON.parse(raw);
+                const status = meta.status ?? 'unknown';
+                queueEvent(context.stateDir, 'increment.status_changed', incrementId, context.timestamp, { field: 'status', value: status });
+            }
+        }
+        catch {
+            // Read failure — skip silently
+        }
+        return CONTINUE;
+    }
+    // tasks.md → queue task.updated
+    if (basename === 'tasks.md') {
+        queueEvent(context.stateDir, 'task.updated', incrementId, context.timestamp);
+        return CONTINUE;
+    }
+    // spec.md → queue spec.updated
+    if (basename === 'spec.md') {
+        queueEvent(context.stateDir, 'spec.updated', incrementId, context.timestamp);
+        return CONTINUE;
+    }
+    return CONTINUE;
+};
+//# sourceMappingURL=post-tool-use.js.map

package/dist/src/core/hooks/handlers/post-tool-use.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"post-tool-use.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/post-tool-use.ts"],"names":[],"mappings":"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"}

package/dist/src/core/hooks/handlers/session-start.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+/**
+ * Session-start hook handler — session initialization.
+ *
+ * Clears stale auto-mode files, resets context pressure,
+ * and performs baseline prompt health check.
+ */
+import type { HandlerFn } from './types.js';
+export declare const handle: HandlerFn;
+//# sourceMappingURL=session-start.d.ts.map

package/dist/src/core/hooks/handlers/session-start.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"session-start.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/session-start.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAkC5C,eAAO,MAAM,MAAM,EAAE,SA6EpB,CAAC"}

package/dist/src/core/hooks/handlers/session-start.js ADDED Viewed

@@ -0,0 +1,111 @@
+/**
+ * Session-start hook handler — session initialization.
+ *
+ * Clears stale auto-mode files, resets context pressure,
+ * and performs baseline prompt health check.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+const STALE_THRESHOLD_MS = 24 * 60 * 60 * 1000; // 24 hours
+const WARNING_THRESHOLD = 80000;
+const CRITICAL_THRESHOLD = 120000;
+const SYSTEM_ESTIMATE = 12000;
+const SKILL_BUDGET = 15000;
+const HOOK_PER_TURN = 3000;
+function isStale(filePath) {
+    try {
+        const stat = fs.statSync(filePath);
+        return Date.now() - stat.mtimeMs > STALE_THRESHOLD_MS;
+    }
+    catch {
+        return false;
+    }
+}
+function safeRemove(filePath) {
+    try {
+        fs.unlinkSync(filePath);
+    }
+    catch {
+        // Ignore
+    }
+}
+function fileSize(filePath) {
+    try {
+        return fs.statSync(filePath).size;
+    }
+    catch {
+        return 0;
+    }
+}
+export const handle = async (_input, context) => {
+    const { projectRoot, stateDir, logsDir, timestamp } = context;
+    try {
+        fs.mkdirSync(stateDir, { recursive: true });
+    }
+    catch {
+        return { continue: true };
+    }
+    // --- Auto-mode cleanup: remove stale session files (>24h) ---
+    const autoFile = path.join(stateDir, 'auto-mode.json');
+    if (fs.existsSync(autoFile) && isStale(autoFile)) {
+        safeRemove(autoFile);
+        safeRemove(path.join(stateDir, '.stop-auto-dedup'));
+        safeRemove(path.join(stateDir, '.stop-auto-dedup-prev'));
+        safeRemove(path.join(stateDir, '.stop-auto-turns'));
+        try {
+            fs.mkdirSync(logsDir, { recursive: true });
+            fs.appendFileSync(path.join(logsDir, 'session.log'), `[${timestamp}] SessionStart: Cleared stale auto-mode session files (>24h)\n`);
+        }
+        catch {
+            // Never throw from logging
+        }
+    }
+    // --- Context pressure reset ---
+    safeRemove(path.join(stateDir, 'context-pressure.json'));
+    safeRemove(path.join(stateDir, 'prompt-health-alert.json'));
+    // --- Baseline health check ---
+    try {
+        const claudeMdSize = fileSize(path.join(projectRoot, 'CLAUDE.md'));
+        const memoryDir = path.join(projectRoot, '.claude', 'projects');
+        let memoryMdSize = 0;
+        try {
+            // Find MEMORY.md in any project subdirectory
+            if (fs.existsSync(memoryDir)) {
+                const entries = fs.readdirSync(memoryDir, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (entry.isDirectory()) {
+                        const memPath = path.join(memoryDir, entry.name, 'memory', 'MEMORY.md');
+                        memoryMdSize += fileSize(memPath);
+                    }
+                }
+            }
+        }
+        catch {
+            // Best-effort
+        }
+        const baseline = claudeMdSize + memoryMdSize + SYSTEM_ESTIMATE + SKILL_BUDGET + HOOK_PER_TURN;
+        let warningLevel = 'normal';
+        if (baseline > CRITICAL_THRESHOLD) {
+            warningLevel = 'critical';
+        }
+        else if (baseline > WARNING_THRESHOLD) {
+            warningLevel = 'warning';
+        }
+        const health = {
+            baseline,
+            claudeMdSize,
+            memoryMdSize,
+            skillBudget: SKILL_BUDGET,
+            systemEstimate: SYSTEM_ESTIMATE,
+            hookPerTurn: HOOK_PER_TURN,
+            warningLevel,
+            checkedAt: timestamp,
+        };
+        fs.writeFileSync(path.join(stateDir, 'prompt-health.json'), JSON.stringify(health));
+    }
+    catch {
+        // Health check is best-effort
+    }
+    return { continue: true };
+};
+//# sourceMappingURL=session-start.js.map

package/dist/src/core/hooks/handlers/session-start.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"session-start.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/session-start.ts"],"names":[],"mappings":"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"}

package/dist/src/core/hooks/handlers/stop-auto.d.ts ADDED Viewed

@@ -0,0 +1,22 @@
+/**
+ * Stop-auto hook handler — the autonomous-loop driver for `/sw:auto`.
+ *
+ * Fires when a session ends. Unlike the other Stop hooks, this one is allowed to
+ * BLOCK so that Claude Code re-prompts the model and the auto loop continues
+ * (see plugins/specweave/skills/auto/SKILL.md "Core Loop"):
+ *
+ *   IMPLEMENT -> TEST -> FIX -> PASS -> NEXT -> ... -> ALL DONE -> sw:done --auto
+ *
+ * Decision table (any throw short-circuits to `approve` so ordinary sessions are
+ * never trapped):
+ *
+ *   no auto-mode.json | active !== true | stale      -> reset .stop-auto-turns; { approve }
+ *   turns > auto.maxTurns (default 20)                -> clear counter;          { approve }  // safety stop
+ *   0 pending tasks AND all ACs satisfied             -> clear counter;          { block: all_complete_needs_closure }
+ *   otherwise (work remains)                          -> increment counter;      { block: <P> task(s) / <A> AC(s) remain }
+ *
+ * @module core/hooks/handlers/stop-auto
+ */
+import type { HandlerFn } from './types.js';
+export declare const handle: HandlerFn;
+//# sourceMappingURL=stop-auto.d.ts.map

package/dist/src/core/hooks/handlers/stop-auto.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"stop-auto.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/stop-auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AAsJzD,eAAO,MAAM,MAAM,EAAE,SAiEpB,CAAC"}

package/dist/src/core/hooks/handlers/stop-auto.js ADDED Viewed

@@ -0,0 +1,227 @@
+/**
+ * Stop-auto hook handler — the autonomous-loop driver for `/sw:auto`.
+ *
+ * Fires when a session ends. Unlike the other Stop hooks, this one is allowed to
+ * BLOCK so that Claude Code re-prompts the model and the auto loop continues
+ * (see plugins/specweave/skills/auto/SKILL.md "Core Loop"):
+ *
+ *   IMPLEMENT -> TEST -> FIX -> PASS -> NEXT -> ... -> ALL DONE -> sw:done --auto
+ *
+ * Decision table (any throw short-circuits to `approve` so ordinary sessions are
+ * never trapped):
+ *
+ *   no auto-mode.json | active !== true | stale      -> reset .stop-auto-turns; { approve }
+ *   turns > auto.maxTurns (default 20)                -> clear counter;          { approve }  // safety stop
+ *   0 pending tasks AND all ACs satisfied             -> clear counter;          { block: all_complete_needs_closure }
+ *   otherwise (work remains)                          -> increment counter;      { block: <P> task(s) / <A> AC(s) remain }
+ *
+ * @module core/hooks/handlers/stop-auto
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logHook } from './utils.js';
+import { calculateProgressFromTasksFile } from '../../../progress/us-progress-tracker.js';
+/** Read JSON safely, return null on error */
+function readJsonSafe(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** Resolve the auto-mode session file (per-session if present, else global). */
+function getSessionPath(stateDir) {
+    const sessionId = process.env.CLAUDE_SESSION_ID;
+    if (sessionId) {
+        const perSession = path.join(stateDir, 'sessions', sessionId, 'auto-mode.json');
+        if (fs.existsSync(perSession))
+            return perSession;
+    }
+    return path.join(stateDir, 'auto-mode.json');
+}
+/** True when the session file's mtime is older than maxSessionAge seconds. */
+function isSessionStale(sessionPath, maxSessionAge) {
+    try {
+        const ageMs = Date.now() - fs.statSync(sessionPath).mtimeMs;
+        return ageMs > maxSessionAge * 1000;
+    }
+    catch {
+        return true;
+    }
+}
+const TURNS_FILE = '.stop-auto-turns';
+function readTurns(stateDir) {
+    try {
+        const n = parseInt(fs.readFileSync(path.join(stateDir, TURNS_FILE), 'utf8').trim(), 10);
+        return Number.isFinite(n) && n >= 0 ? n : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function writeTurns(stateDir, n) {
+    try {
+        fs.mkdirSync(stateDir, { recursive: true });
+        fs.writeFileSync(path.join(stateDir, TURNS_FILE), String(n));
+    }
+    catch {
+        // Never throw from counter bookkeeping
+    }
+}
+function resetTurns(stateDir) {
+    try {
+        fs.unlinkSync(path.join(stateDir, TURNS_FILE));
+    }
+    catch {
+        // Already absent — fine
+    }
+}
+/** Count satisfied/total ACs from a spec.md by `- [ ]`/`- [x]` AC lines. */
+function countAcs(specPath) {
+    let total = 0;
+    let satisfied = 0;
+    try {
+        const text = fs.readFileSync(specPath, 'utf8');
+        for (const line of text.split('\n')) {
+            // Match an AC checkbox line: `- [ ] **AC-US1-01**: ...` (id optional but must mention AC).
+            const m = line.match(/^\s*-\s*\[([ xX])\]\s*\*{0,2}AC[-\w]/);
+            if (!m)
+                continue;
+            total++;
+            if (m[1].toLowerCase() === 'x')
+                satisfied++;
+        }
+    }
+    catch {
+        // No spec / unreadable — treat as no ACs.
+    }
+    return { total, satisfied };
+}
+/** Increment ids from the session marker, falling back to an active-increment scan. */
+function resolveIncrementIds(session, projectRoot) {
+    const fromMarker = Array.isArray(session.incrementIds)
+        ? session.incrementIds.filter((x) => typeof x === 'string')
+        : [];
+    if (fromMarker.length > 0)
+        return fromMarker;
+    const incDir = path.join(projectRoot, '.specweave', 'increments');
+    const active = [];
+    try {
+        for (const dir of fs.readdirSync(incDir)) {
+            const meta = readJsonSafe(path.join(incDir, dir, 'metadata.json'));
+            if (meta && (meta.status === 'active' || meta.status === 'in-progress')) {
+                active.push(dir);
+            }
+        }
+    }
+    catch {
+        // No increments dir — empty.
+    }
+    return active;
+}
+/** Resolve the on-disk increment directory for an id (exact, else prefix match). */
+function findIncrementDir(projectRoot, id) {
+    const incDir = path.join(projectRoot, '.specweave', 'increments');
+    const exact = path.join(incDir, id);
+    if (fs.existsSync(exact))
+        return exact;
+    try {
+        const prefix = id.match(/^\d{4}/)?.[0] ?? id;
+        for (const dir of fs.readdirSync(incDir)) {
+            if (dir.startsWith(prefix))
+                return path.join(incDir, dir);
+        }
+    }
+    catch {
+        // fall through
+    }
+    return null;
+}
+/** Aggregate remaining work (pending tasks + unsatisfied ACs) across increments. */
+async function computeRemaining(projectRoot, incrementIds) {
+    let pendingTasks = 0;
+    let pendingAcs = 0;
+    let primaryId = incrementIds[0] ?? '';
+    for (const id of incrementIds) {
+        const dir = findIncrementDir(projectRoot, id);
+        if (!dir)
+            continue;
+        // Tasks — prefer the shared parser for accurate same-line/status handling.
+        const tasksPath = path.join(dir, 'tasks.md');
+        if (fs.existsSync(tasksPath)) {
+            try {
+                const progress = await calculateProgressFromTasksFile(tasksPath);
+                pendingTasks += progress.pendingTasks + progress.inProgressTasks;
+            }
+            catch {
+                // Unparseable tasks file — skip its tasks.
+            }
+        }
+        // ACs — parse spec.md checkbox lines.
+        const { total, satisfied } = countAcs(path.join(dir, 'spec.md'));
+        pendingAcs += total - satisfied;
+    }
+    return { pendingTasks, pendingAcs, primaryId };
+}
+export const handle = async (_input, context) => {
+    const { stateDir, projectRoot, configPath } = context;
+    try {
+        // 1. No auto session -> approve (and make sure the counter is reset).
+        const sessionPath = getSessionPath(stateDir);
+        const session = fs.existsSync(sessionPath) ? readJsonSafe(sessionPath) : null;
+        if (!session || session.active !== true) {
+            resetTurns(stateDir);
+            logHook(context, 'stop-auto', 'No active auto session — approve');
+            return { decision: 'approve' };
+        }
+        // 2. Stale session -> approve.
+        const config = readJsonSafe(configPath);
+        const maxSessionAge = config?.auto?.maxSessionAge ?? 7200;
+        if (isSessionStale(sessionPath, maxSessionAge)) {
+            resetTurns(stateDir);
+            logHook(context, 'stop-auto', 'Stale auto session — approve');
+            return { decision: 'approve' };
+        }
+        // 3. Turn-counter safety stop -> approve.
+        const maxTurns = config?.auto?.maxTurns ?? 20;
+        const turns = readTurns(stateDir);
+        if (turns > maxTurns) {
+            resetTurns(stateDir);
+            logHook(context, 'stop-auto', `Safety stop: turns ${turns} > maxTurns ${maxTurns} — approve`);
+            return { decision: 'approve' };
+        }
+        // 4. Compute remaining work.
+        const incrementIds = resolveIncrementIds(session, projectRoot);
+        // No increment to act on (empty marker + none active) -> approve rather than
+        // spuriously blocking for closure on a 0/0 count.
+        if (incrementIds.length === 0) {
+            resetTurns(stateDir);
+            logHook(context, 'stop-auto', 'Auto session active but no increment to work on — approve');
+            return { decision: 'approve' };
+        }
+        const { pendingTasks, pendingAcs, primaryId } = await computeRemaining(projectRoot, incrementIds);
+        const idLabel = primaryId || incrementIds[0] || 'active increment';
+        // 5. All complete -> block for closure (the trigger sw:auto consumes).
+        if (pendingTasks === 0 && pendingAcs === 0) {
+            resetTurns(stateDir);
+            logHook(context, 'stop-auto', `${idLabel}: all_complete_needs_closure`);
+            return {
+                decision: 'block',
+                reason: `${idLabel}: all_complete_needs_closure — run sw:done --auto ${idLabel}`,
+            };
+        }
+        // 6. Work remains -> block to continue + increment the counter.
+        writeTurns(stateDir, turns + 1);
+        const userGoal = typeof session.userGoal === 'string' && session.userGoal ? session.userGoal : '';
+        const reason = `${idLabel}: ${pendingTasks} task(s) / ${pendingAcs} AC(s) remain. Run sw:do to continue.` +
+            (userGoal ? ` Goal: ${userGoal}` : '');
+        logHook(context, 'stop-auto', reason);
+        return { decision: 'block', reason };
+    }
+    catch {
+        // Never throw — any failure must not trap the session.
+        return { decision: 'approve' };
+    }
+};
+//# sourceMappingURL=stop-auto.js.map

package/dist/src/core/hooks/handlers/stop-auto.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"stop-auto.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/stop-auto.ts"],"names":[],"mappings":"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"}

package/dist/src/core/hooks/handlers/stop-reflect.d.ts ADDED Viewed

@@ -0,0 +1,14 @@
+/**
+ * Stop-reflect hook handler.
+ *
+ * Fires when a session ends. Checks if reflection is enabled in config.
+ * If enabled, logs that reflection was requested (actual reflection logic
+ * will call `specweave reflect-stop` CLI in a follow-up).
+ *
+ * NEVER blocks — always returns approve.
+ *
+ * @module core/hooks/handlers/stop-reflect
+ */
+import type { HandlerFn } from './types.js';
+export declare const handle: HandlerFn;
+//# sourceMappingURL=stop-reflect.d.ts.map

package/dist/src/core/hooks/handlers/stop-reflect.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"stop-reflect.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/stop-reflect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAe5C,eAAO,MAAM,MAAM,EAAE,SAgBpB,CAAC"}

package/dist/src/core/hooks/handlers/stop-reflect.js ADDED Viewed

@@ -0,0 +1,43 @@
+/**
+ * Stop-reflect hook handler.
+ *
+ * Fires when a session ends. Checks if reflection is enabled in config.
+ * If enabled, logs that reflection was requested (actual reflection logic
+ * will call `specweave reflect-stop` CLI in a follow-up).
+ *
+ * NEVER blocks — always returns approve.
+ *
+ * @module core/hooks/handlers/stop-reflect
+ */
+import * as fs from 'fs';
+import { logHook } from './utils.js';
+/** Check if reflect is enabled in config. Default: true */
+function isReflectEnabled(configPath) {
+    try {
+        if (!fs.existsSync(configPath))
+            return true;
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        // Note: explicit false check — missing key defaults to enabled
+        return config.reflect?.enabled !== false;
+    }
+    catch {
+        return true; // Default enabled on error
+    }
+}
+export const handle = async (input, context) => {
+    try {
+        const enabled = isReflectEnabled(context.configPath);
+        if (!enabled) {
+            logHook(context, 'stop-reflect', 'Reflection disabled in config');
+            return { decision: 'approve' };
+        }
+        // Reflection is enabled — log intent
+        logHook(context, 'stop-reflect', 'Reflection requested at session end');
+        return { decision: 'approve' };
+    }
+    catch {
+        // Never throw — always approve
+        return { decision: 'approve' };
+    }
+};
+//# sourceMappingURL=stop-reflect.js.map

package/dist/src/core/hooks/handlers/stop-reflect.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"stop-reflect.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/stop-reflect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,2DAA2D;AAC3D,SAAS,gBAAgB,CAAC,UAAkB;IAC1C,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/D,+DAA+D;QAC/D,OAAO,MAAM,CAAC,OAAO,EAAE,OAAO,KAAK,KAAK,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,2BAA2B;IAC1C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAc,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IACxD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAErD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,+BAA+B,CAAC,CAAC;YAClE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QACjC,CAAC;QAED,qCAAqC;QACrC,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,qCAAqC,CAAC,CAAC;QACxE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;QAC/B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;AACH,CAAC,CAAC"}

package/dist/src/core/hooks/handlers/stop-sync.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+/**
+ * Stop-sync hook handler.
+ *
+ * Fires at session end (after stop-reflect and stop-auto). Reads pending
+ * sync events, deduplicates by increment ID, logs sync intent, and clears
+ * the event queue. Actual sync calls (LivingDocsSync, GitHub/JIRA/ADO)
+ * will be added in a follow-up.
+ *
+ * NEVER blocks — always returns approve.
+ *
+ * @module core/hooks/handlers/stop-sync
+ */
+import type { HandlerFn } from './types.js';
+export declare const handle: HandlerFn;
+//# sourceMappingURL=stop-sync.d.ts.map

package/dist/src/core/hooks/handlers/stop-sync.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"stop-sync.d.ts","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/stop-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAoB5C,eAAO,MAAM,MAAM,EAAE,SA+CpB,CAAC"}

package/dist/src/core/hooks/handlers/stop-sync.js ADDED Viewed

@@ -0,0 +1,68 @@
+/**
+ * Stop-sync hook handler.
+ *
+ * Fires at session end (after stop-reflect and stop-auto). Reads pending
+ * sync events, deduplicates by increment ID, logs sync intent, and clears
+ * the event queue. Actual sync calls (LivingDocsSync, GitHub/JIRA/ADO)
+ * will be added in a follow-up.
+ *
+ * NEVER blocks — always returns approve.
+ *
+ * @module core/hooks/handlers/stop-sync
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logHook } from './utils.js';
+/** Parse a JSONL line safely */
+function parseEventLine(line) {
+    try {
+        return JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+}
+export const handle = async (input, context) => {
+    try {
+        const pendingPath = path.join(context.stateDir, 'event-queue', 'pending.jsonl');
+        // 1. Check if pending events exist
+        if (!fs.existsSync(pendingPath)) {
+            logHook(context, 'stop-sync', 'No pending events');
+            return { decision: 'approve' };
+        }
+        const content = fs.readFileSync(pendingPath, 'utf8').trim();
+        if (!content) {
+            logHook(context, 'stop-sync', 'No pending events');
+            return { decision: 'approve' };
+        }
+        // 2. Parse and deduplicate events by increment ID
+        const lines = content.split('\n').filter((l) => l.trim());
+        const seenIncrements = new Set();
+        for (const line of lines) {
+            const event = parseEventLine(line);
+            if (!event?.incrementId)
+                continue;
+            const incId = event.incrementId;
+            if (seenIncrements.has(incId))
+                continue;
+            seenIncrements.add(incId);
+            logHook(context, 'stop-sync', `Sync requested for increment: ${incId} (event: ${event.event ?? 'unknown'})`);
+        }
+        // 3. Clear processed events
+        try {
+            fs.writeFileSync(pendingPath, '');
+        }
+        catch {
+            // Non-critical — events may be re-processed next time
+        }
+        if (seenIncrements.size > 0) {
+            logHook(context, 'stop-sync', `Processed ${seenIncrements.size} unique increment(s)`);
+        }
+        return { decision: 'approve' };
+    }
+    catch {
+        // Never throw — always approve
+        return { decision: 'approve' };
+    }
+};
+//# sourceMappingURL=stop-sync.js.map

package/dist/src/core/hooks/handlers/stop-sync.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"stop-sync.js","sourceRoot":"","sources":["../../../../../src/core/hooks/handlers/stop-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAUrC,gCAAgC;AAChC,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAgB,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAc,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IACxD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;QAEhF,mCAAmC;QACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC;YACnD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC;YACnD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QACjC,CAAC;QAED,kDAAkD;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1D,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;QAEzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,KAAK,EAAE,WAAW;gBAAE,SAAS;YAElC,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC;YAChC,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAS;YAExC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC1B,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,iCAAiC,KAAK,YAAY,KAAK,CAAC,KAAK,IAAI,SAAS,GAAG,CAAC,CAAC;QAC/G,CAAC;QAED,4BAA4B;QAC5B,IAAI,CAAC;YACH,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,sDAAsD;QACxD,CAAC;QAED,IAAI,cAAc,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,aAAa,cAAc,CAAC,IAAI,sBAAsB,CAAC,CAAC;QACxF,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;QAC/B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;AACH,CAAC,CAAC"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "1.0.588",
+  "version": "1.0.590",
   "description": "100+ domain-expert AI skills — PM, Architect, Frontend, QA, Security and more. Skills learn your team's patterns permanently. Spec-first planning, autonomous execution, multi-agent teams, synced to GitHub/JIRA. Claude Code, Cursor, Copilot & more.",
   "type": "module",
   "main": "dist/index.js",
@@ -10,10 +10,12 @@
   "scripts": {
     "preinstall": "node scripts/check-node-version.js || exit 0",
     "preuninstall": "node scripts/preuninstall.cjs",
-    "version": "node scripts/build/auto-changelog.js && git add CHANGELOG.md",
+    "version": "node scripts/build/auto-changelog.js && node scripts/build/stamp-plugin-version.cjs && git add CHANGELOG.md plugins/specweave/.claude-plugin/plugin.json .claude-plugin/marketplace.json",
     "postversion": "echo '✅ Version bumped with CHANGELOG entry'",
     "clean": "rm -rf dist/",
-    "build": "tsc && npm run build:dashboard && npm run copy:locales && npm run copy:plugins && npm run copy:hook-deps && npm run copy:adapters",
+    "build": "tsc && npm run build:dashboard && npm run copy:locales && npm run copy:plugins && npm run copy:hook-deps && npm run copy:adapters && npm run stamp:plugin-version",
+    "stamp:plugin-version": "node scripts/build/stamp-plugin-version.cjs",
+    "validate:versions": "node scripts/validation/validate-versions.cjs",
     "build:dashboard": "npx vite build --config src/dashboard/client/vite.config.ts",
     "copy:adapters": "node scripts/build/copy-adapters.js",
     "rebuild": "npm run clean && npm run build",
@@ -21,7 +23,7 @@
     "copy:plugins": "node scripts/build/copy-plugin-js.js",
     "copy:hook-deps": "node scripts/build/copy-hook-dependencies.js",
     "dev": "tsc --watch",
-    "prepublishOnly": "npm run rebuild",
+    "prepublishOnly": "npm run rebuild && npm run validate:versions",
     "test:unit": "vitest run tests/unit --coverage",
     "test:unit:fast": "vitest run --config vitest.unit.config.ts",
     "test:integration": "vitest run tests/integration --coverage",

package/plugins/specweave/.claude-plugin/plugin.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "sw",
   "description": "SpecWeave unified plugin. Provides increment planning (PM, Architect, Tech Lead agents), specification generation, TDD workflow, living docs sync, brownfield support, GitHub/JIRA/ADO bidirectional sync, documentation generation, release management, architecture diagrams, and AI media generation.",
-  "version": "1.0.586",
+  "version": "1.0.590",
   "author": {
     "name": "SpecWeave Team",
     "url": "https://spec-weave.com"

package/plugins/specweave/hooks/hooks.json CHANGED Viewed

@@ -89,6 +89,11 @@
             "type": "command",
             "command": "bash -c 'command -v specweave &>/dev/null && specweave hook stop-sync || { cat >/dev/null; echo \"{\\\"decision\\\":\\\"approve\\\"}\"; }'",
             "timeout": 15000
+          },
+          {
+            "type": "command",
+            "command": "bash -c 'command -v specweave &>/dev/null && specweave hook stop || { cat >/dev/null; echo \"{\\\"decision\\\":\\\"approve\\\"}\"; }'",
+            "timeout": 15000
           }
         ]
       }