specweave 1.0.579 → 1.0.581

package/dist/src/core/reflect-nudge/aggregator.js

@@ -0,0 +1,80 @@
+/**
+ * Reflect-nudge aggregator — groups refinement signals by target skill,
+ * applies the ≥3 signal threshold, and ranks by severity × recency.
+ *
+ * Shared by the session-end nudge (picks the top suggestion) and the
+ * `sw:reflect --status` dashboard section (lists everything above threshold).
+ *
+ * @module core/reflect-nudge/aggregator
+ */
+import { readSignals } from '../skill-signals/reader.js';
+/** Minimum number of refinement signals a skill needs to surface. */
+export const REFINEMENT_SUGGESTION_THRESHOLD = 3;
+const SEVERITY_RANK = {
+    high: 3,
+    medium: 2,
+    low: 1,
+};
+/**
+ * Aggregate signals from disk and return skills meeting the threshold,
+ * sorted by severity × recency (descending).
+ *
+ * `threshold` defaults to {@link REFINEMENT_SUGGESTION_THRESHOLD}. Pass `1`
+ * for the nudge path (which wants the top suggestion regardless of total).
+ */
+export async function aggregateSuggestions(signalsFilePath, opts = {}) {
+    const threshold = opts.threshold ?? REFINEMENT_SUGGESTION_THRESHOLD;
+    const file = await readSignals(signalsFilePath);
+    const refinements = file.signals.filter((s) => s.type === 'refinement');
+    const bySkill = new Map();
+    for (const sig of refinements) {
+        const list = bySkill.get(sig.targetSkill) ?? [];
+        list.push(sig);
+        bySkill.set(sig.targetSkill, list);
+    }
+    const suggestions = [];
+    for (const [slug, signals] of bySkill) {
+        if (signals.length < threshold)
+            continue;
+        suggestions.push(toSuggestion(slug, signals));
+    }
+    return suggestions.sort(compareBySeverityThenRecency);
+}
+function toSuggestion(slug, signals) {
+    const countsBySource = {
+        'judge-llm': 0,
+        rubric: 0,
+        'code-reviewer': 0,
+    };
+    let highestSeverity = 'low';
+    let lastDetectedAt = signals[0].detectedAt;
+    let mostRecent = signals[0];
+    for (const s of signals) {
+        countsBySource[s.source] += 1;
+        if (SEVERITY_RANK[s.severity] > SEVERITY_RANK[highestSeverity]) {
+            highestSeverity = s.severity;
+        }
+        if (s.detectedAt > lastDetectedAt) {
+            lastDetectedAt = s.detectedAt;
+            mostRecent = s;
+        }
+    }
+    return {
+        slug,
+        totalCount: signals.length,
+        countsBySource,
+        highestSeverity,
+        severityScore: SEVERITY_RANK[highestSeverity],
+        lastDetectedAt,
+        sampleEvidence: mostRecent.evidence,
+    };
+}
+function compareBySeverityThenRecency(a, b) {
+    const sev = b.severityScore - a.severityScore;
+    if (sev !== 0)
+        return sev;
+    if (a.lastDetectedAt === b.lastDetectedAt)
+        return 0;
+    return a.lastDetectedAt < b.lastDetectedAt ? 1 : -1;
+}
+//# sourceMappingURL=aggregator.js.map

package/dist/src/core/reflect-nudge/aggregator.js.map

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

package/dist/src/core/reflect-nudge/eligibility.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Nudge eligibility — checks whether the session-end prompt should be
+ * shown at /sw:done close time (AC-US3-01, AC-US3-02).
+ *
+ * @module core/reflect-nudge/eligibility
+ */
+import { type SkillSuggestion } from './aggregator.js';
+export interface NudgeEligibility {
+    shouldNudge: boolean;
+    reason: 'disabled' | 'no-signal' | 'has-refinement' | 'has-learning';
+    topRefinement: SkillSuggestion | null;
+    hasHighConfidenceLearning: boolean;
+}
+export interface EligibilityOptions {
+    /** Project root — defaults to cwd. */
+    projectRoot?: string;
+    /** Increment ID, used to scope the learning-window check. */
+    incrementId: string;
+    /** Override the autoNudge config flag (for tests). */
+    autoNudge?: boolean;
+}
+/**
+ * Evaluate whether to show the session-end nudge. Never throws; failure
+ * to read state is treated as "no signal".
+ */
+export declare function checkNudgeEligibility(opts: EligibilityOptions): Promise<NudgeEligibility>;
+//# sourceMappingURL=eligibility.d.ts.map

package/dist/src/core/reflect-nudge/eligibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eligibility.d.ts","sourceRoot":"","sources":["../../../../src/core/reflect-nudge/eligibility.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE7E,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,gBAAgB,GAAG,cAAc,CAAC;IACrE,aAAa,EAAE,eAAe,GAAG,IAAI,CAAC;IACtC,yBAAyB,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CA2C3B"}

package/dist/src/core/reflect-nudge/eligibility.js

@@ -0,0 +1,114 @@
+/**
+ * Nudge eligibility — checks whether the session-end prompt should be
+ * shown at /sw:done close time (AC-US3-01, AC-US3-02).
+ *
+ * @module core/reflect-nudge/eligibility
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { aggregateSuggestions } from './aggregator.js';
+/**
+ * Evaluate whether to show the session-end nudge. Never throws; failure
+ * to read state is treated as "no signal".
+ */
+export async function checkNudgeEligibility(opts) {
+    const root = opts.projectRoot ?? process.cwd();
+    const autoNudge = opts.autoNudge ?? readAutoNudge(root);
+    if (!autoNudge) {
+        return {
+            shouldNudge: false,
+            reason: 'disabled',
+            topRefinement: null,
+            hasHighConfidenceLearning: false,
+        };
+    }
+    const signalsPath = path.join(root, '.specweave', 'state', 'skill-signals.json');
+    const suggestions = await aggregateSuggestions(signalsPath, { threshold: 1 }).catch(() => []);
+    const topRefinement = suggestions[0] ?? null;
+    const hasHighConfidenceLearning = detectFreshLearning(root, opts.incrementId);
+    if (topRefinement) {
+        return {
+            shouldNudge: true,
+            reason: 'has-refinement',
+            topRefinement,
+            hasHighConfidenceLearning,
+        };
+    }
+    if (hasHighConfidenceLearning) {
+        return {
+            shouldNudge: true,
+            reason: 'has-learning',
+            topRefinement: null,
+            hasHighConfidenceLearning: true,
+        };
+    }
+    return {
+        shouldNudge: false,
+        reason: 'no-signal',
+        topRefinement: null,
+        hasHighConfidenceLearning: false,
+    };
+}
+// ── Internals ────────────────────────────────────────────────────────
+function readAutoNudge(root) {
+    try {
+        const configPath = path.join(root, '.specweave', 'config.json');
+        if (!fs.existsSync(configPath))
+            return true;
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        if (config?.reflect?.autoNudge === false)
+            return false;
+        return true;
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * A "high-confidence learning" at close time is a skill-memory file under
+ * `.specweave/skill-memories/` whose mtime is newer than the increment's
+ * metadata.json mtime — i.e. something written during the session.
+ *
+ * This is a heuristic, not a guarantee. On read errors we return false,
+ * which just means the nudge falls back to the refinement-only path.
+ */
+function detectFreshLearning(root, incrementId) {
+    try {
+        const memoriesDir = path.join(root, '.specweave', 'skill-memories');
+        if (!fs.existsSync(memoriesDir))
+            return false;
+        const metadataPath = resolveMetadataPath(root, incrementId);
+        if (!metadataPath)
+            return false;
+        const since = fs.statSync(metadataPath).mtimeMs;
+        const files = fs.readdirSync(memoriesDir).filter((f) => f.endsWith('.md'));
+        for (const f of files) {
+            const stat = fs.statSync(path.join(memoriesDir, f));
+            if (stat.mtimeMs > since)
+                return true;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+function resolveMetadataPath(root, incrementId) {
+    try {
+        const incrementsDir = path.join(root, '.specweave', 'increments');
+        if (!fs.existsSync(incrementsDir))
+            return null;
+        for (const entry of fs.readdirSync(incrementsDir)) {
+            if (entry === incrementId || entry.startsWith(`${incrementId}-`)) {
+                const candidate = path.join(incrementsDir, entry, 'metadata.json');
+                if (fs.existsSync(candidate))
+                    return candidate;
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=eligibility.js.map

package/dist/src/core/reflect-nudge/eligibility.js.map

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

package/dist/src/core/reflect-nudge/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Barrel export for the reflect-nudge module.
+ *
+ * Consumers: `completeIncrement` (session-end nudge at /sw:done close),
+ * `sw:reflect --status` (dashboard section).
+ *
+ * @module core/reflect-nudge
+ */
+export { aggregateSuggestions, REFINEMENT_SUGGESTION_THRESHOLD, type SkillSuggestion, } from './aggregator.js';
+export { checkNudgeEligibility, type NudgeEligibility } from './eligibility.js';
+export { renderNudgePrompt, type NudgeInputs } from './prompt-renderer.js';
+export { promptNudge, type PromptResponse, type PromptOptions } from './interactive-prompt.js';
+export { runSessionEndNudge, type NudgeRunResult } from './session-end-nudge.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/reflect-nudge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/reflect-nudge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,oBAAoB,EACpB,+BAA+B,EAC/B,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE3E,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE/F,OAAO,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/core/reflect-nudge/index.js

@@ -0,0 +1,14 @@
+/**
+ * Barrel export for the reflect-nudge module.
+ *
+ * Consumers: `completeIncrement` (session-end nudge at /sw:done close),
+ * `sw:reflect --status` (dashboard section).
+ *
+ * @module core/reflect-nudge
+ */
+export { aggregateSuggestions, REFINEMENT_SUGGESTION_THRESHOLD, } from './aggregator.js';
+export { checkNudgeEligibility } from './eligibility.js';
+export { renderNudgePrompt } from './prompt-renderer.js';
+export { promptNudge } from './interactive-prompt.js';
+export { runSessionEndNudge } from './session-end-nudge.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/reflect-nudge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/reflect-nudge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,oBAAoB,EACpB,+BAA+B,GAEhC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,qBAAqB,EAAyB,MAAM,kBAAkB,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAoB,MAAM,sBAAsB,CAAC;AAE3E,OAAO,EAAE,WAAW,EAA2C,MAAM,yBAAyB,CAAC;AAE/F,OAAO,EAAE,kBAAkB,EAAuB,MAAM,wBAAwB,CAAC"}

package/dist/src/core/reflect-nudge/interactive-prompt.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Session-end nudge printer with 5-second input timeout.
+ *
+ * Prints the prompt line to stdout; waits up to `timeoutMs` for a single
+ * character on stdin. Non-TTY, empty input, "N", "n", or timeout → treated
+ * as declined (AC-US3-03). Only explicit "y"/"Y" is accepted.
+ *
+ * Per AC-US3-04 this module NEVER executes the suggested command — it
+ * only returns the user's response to the caller.
+ *
+ * @module core/reflect-nudge/interactive-prompt
+ */
+export interface PromptOptions {
+    /** Timeout in milliseconds before defaulting to No. Default: 5000. */
+    timeoutMs?: number;
+    /** Override the stdin/stdout streams (mainly for tests). */
+    stdin?: NodeJS.ReadableStream;
+    stdout?: NodeJS.WritableStream;
+}
+export type PromptResponse = 'yes' | 'no' | 'timeout' | 'non-tty';
+/**
+ * Print `line` and wait for a y/N answer. Returns which branch fired.
+ *
+ * Non-interactive contexts (piped stdin, CI, auto-mode) short-circuit
+ * immediately to `'non-tty'` — treated as a decline.
+ */
+export declare function promptNudge(line: string, opts?: PromptOptions): Promise<PromptResponse>;
+//# sourceMappingURL=interactive-prompt.d.ts.map

package/dist/src/core/reflect-nudge/interactive-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-prompt.d.ts","sourceRoot":"","sources":["../../../../src/core/reflect-nudge/interactive-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;CAChC;AAED,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;AAElE;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,cAAc,CAAC,CAuCzB"}

package/dist/src/core/reflect-nudge/interactive-prompt.js

@@ -0,0 +1,52 @@
+/**
+ * Session-end nudge printer with 5-second input timeout.
+ *
+ * Prints the prompt line to stdout; waits up to `timeoutMs` for a single
+ * character on stdin. Non-TTY, empty input, "N", "n", or timeout → treated
+ * as declined (AC-US3-03). Only explicit "y"/"Y" is accepted.
+ *
+ * Per AC-US3-04 this module NEVER executes the suggested command — it
+ * only returns the user's response to the caller.
+ *
+ * @module core/reflect-nudge/interactive-prompt
+ */
+import * as readline from 'readline';
+/**
+ * Print `line` and wait for a y/N answer. Returns which branch fired.
+ *
+ * Non-interactive contexts (piped stdin, CI, auto-mode) short-circuit
+ * immediately to `'non-tty'` — treated as a decline.
+ */
+export async function promptNudge(line, opts = {}) {
+    const stdin = opts.stdin ?? process.stdin;
+    const stdout = opts.stdout ?? process.stdout;
+    const timeoutMs = opts.timeoutMs ?? 5000;
+    stdout.write(`${line}\n`);
+    const isInteractive = typeof stdin.isTTY !== 'undefined'
+        ? Boolean(stdin.isTTY)
+        : true;
+    if (!isInteractive) {
+        return 'non-tty';
+    }
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({ input: stdin, output: stdout, terminal: false });
+        let settled = false;
+        const done = (response) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            rl.close();
+            resolve(response);
+        };
+        const timer = setTimeout(() => done('timeout'), timeoutMs);
+        rl.once('line', (input) => {
+            const trimmed = input.trim().toLowerCase();
+            done(trimmed === 'y' || trimmed === 'yes' ? 'yes' : 'no');
+        });
+        rl.once('close', () => {
+            done('no');
+        });
+    });
+}
+//# sourceMappingURL=interactive-prompt.js.map

package/dist/src/core/reflect-nudge/interactive-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-prompt.js","sourceRoot":"","sources":["../../../../src/core/reflect-nudge/interactive-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAYrC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,OAAsB,EAAE;IAExB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;IAEzC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IAE1B,MAAM,aAAa,GACjB,OAAQ,KAA2B,CAAC,KAAK,KAAK,WAAW;QACvD,CAAC,CAAC,OAAO,CAAE,KAA2B,CAAC,KAAK,CAAC;QAC7C,CAAC,CAAC,IAAI,CAAC;IAEX,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,EAAE;QAC7C,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QACvF,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,IAAI,GAAG,CAAC,QAAwB,EAAQ,EAAE;YAC9C,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpB,CAAC,CAAC;QAEF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;QAE3D,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YAChC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3C,IAAI,CAAC,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACpB,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/core/reflect-nudge/prompt-renderer.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Renders the one-line session-end nudge prompt shown at /sw:done close.
+ *
+ * Format (AC-US3-01): `Detected: <short summary> — run <command>? (y/N)`
+ *
+ * Picks between refinement and learning suggestions deterministically —
+ * prefers highest-severity refinement over highest-confidence learning so
+ * repeat invocations with the same state render the same prompt.
+ *
+ * @module core/reflect-nudge/prompt-renderer
+ */
+import type { SkillSuggestion } from './aggregator.js';
+export interface NudgeInputs {
+    /** Top refinement suggestion (threshold=1 aggregator output), or null. */
+    topRefinement: SkillSuggestion | null;
+    /** True when a high-confidence learning was captured this session. */
+    hasHighConfidenceLearning: boolean;
+}
+/**
+ * Returns the nudge line, or null if nothing should be printed.
+ */
+export declare function renderNudgePrompt(inputs: NudgeInputs): string | null;
+//# sourceMappingURL=prompt-renderer.d.ts.map

package/dist/src/core/reflect-nudge/prompt-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-renderer.d.ts","sourceRoot":"","sources":["../../../../src/core/reflect-nudge/prompt-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,aAAa,EAAE,eAAe,GAAG,IAAI,CAAC;IACtC,sEAAsE;IACtE,yBAAyB,EAAE,OAAO,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAapE"}

package/dist/src/core/reflect-nudge/prompt-renderer.js

@@ -0,0 +1,26 @@
+/**
+ * Renders the one-line session-end nudge prompt shown at /sw:done close.
+ *
+ * Format (AC-US3-01): `Detected: <short summary> — run <command>? (y/N)`
+ *
+ * Picks between refinement and learning suggestions deterministically —
+ * prefers highest-severity refinement over highest-confidence learning so
+ * repeat invocations with the same state render the same prompt.
+ *
+ * @module core/reflect-nudge/prompt-renderer
+ */
+/**
+ * Returns the nudge line, or null if nothing should be printed.
+ */
+export function renderNudgePrompt(inputs) {
+    const { topRefinement, hasHighConfidenceLearning } = inputs;
+    if (topRefinement) {
+        const count = topRefinement.totalCount;
+        return `Detected: ${topRefinement.slug} (${count} ${count === 1 ? 'signal' : 'signals'}) — run \`sw:skill-refine ${topRefinement.slug}\`? (y/N)`;
+    }
+    if (hasHighConfidenceLearning) {
+        return 'Detected: new learning worth persisting — run `sw:reflect`? (y/N)';
+    }
+    return null;
+}
+//# sourceMappingURL=prompt-renderer.js.map

package/dist/src/core/reflect-nudge/prompt-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-renderer.js","sourceRoot":"","sources":["../../../../src/core/reflect-nudge/prompt-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,MAAM,EAAE,aAAa,EAAE,yBAAyB,EAAE,GAAG,MAAM,CAAC;IAE5D,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,CAAC;QACvC,OAAO,aAAa,aAAa,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,6BAA6B,aAAa,CAAC,IAAI,WAAW,CAAC;IACnJ,CAAC;IAED,IAAI,yBAAyB,EAAE,CAAC;QAC9B,OAAO,mEAAmE,CAAC;IAC7E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/core/reflect-nudge/session-end-nudge.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Orchestrator for the /sw:done close-path nudge.
+ *
+ * Composes eligibility + renderer + prompt. Single entry point consumed
+ * by `completeIncrement` so the close-path adds <100ms even when no
+ * signals are present (spec: Non-Functional Performance).
+ *
+ * @module core/reflect-nudge/session-end-nudge
+ */
+import { type PromptResponse, type PromptOptions } from './interactive-prompt.js';
+export interface NudgeRunResult {
+    printed: boolean;
+    response: PromptResponse | 'skipped';
+    reason: 'disabled' | 'no-signal' | 'has-refinement' | 'has-learning';
+}
+export interface NudgeRunOptions {
+    projectRoot?: string;
+    incrementId: string;
+    /** Suppress side effects (fully silent). Used when the caller is silent/json. */
+    silent?: boolean;
+    /** Overrides forwarded to the interactive prompt — stdin/stdout/timeout. */
+    prompt?: PromptOptions;
+    /** Override autoNudge for tests. */
+    autoNudge?: boolean;
+}
+/**
+ * Run the nudge. Never throws; any failure returns `{printed: false, response: 'skipped'}`.
+ * Caller should not branch on the response — AC-US3-04 forbids auto-execution.
+ */
+export declare function runSessionEndNudge(opts: NudgeRunOptions): Promise<NudgeRunResult>;
+//# sourceMappingURL=session-end-nudge.d.ts.map

package/dist/src/core/reflect-nudge/session-end-nudge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-end-nudge.d.ts","sourceRoot":"","sources":["../../../../src/core/reflect-nudge/session-end-nudge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAe,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE/F,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAC;IACrC,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,gBAAgB,GAAG,cAAc,CAAC;CACtE;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,oCAAoC;IACpC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,cAAc,CAAC,CA8BzB"}

package/dist/src/core/reflect-nudge/session-end-nudge.js

@@ -0,0 +1,44 @@
+/**
+ * Orchestrator for the /sw:done close-path nudge.
+ *
+ * Composes eligibility + renderer + prompt. Single entry point consumed
+ * by `completeIncrement` so the close-path adds <100ms even when no
+ * signals are present (spec: Non-Functional Performance).
+ *
+ * @module core/reflect-nudge/session-end-nudge
+ */
+import { checkNudgeEligibility } from './eligibility.js';
+import { renderNudgePrompt } from './prompt-renderer.js';
+import { promptNudge } from './interactive-prompt.js';
+/**
+ * Run the nudge. Never throws; any failure returns `{printed: false, response: 'skipped'}`.
+ * Caller should not branch on the response — AC-US3-04 forbids auto-execution.
+ */
+export async function runSessionEndNudge(opts) {
+    if (opts.silent) {
+        return { printed: false, response: 'skipped', reason: 'disabled' };
+    }
+    try {
+        const eligibility = await checkNudgeEligibility({
+            projectRoot: opts.projectRoot,
+            incrementId: opts.incrementId,
+            autoNudge: opts.autoNudge,
+        });
+        if (!eligibility.shouldNudge) {
+            return { printed: false, response: 'skipped', reason: eligibility.reason };
+        }
+        const line = renderNudgePrompt({
+            topRefinement: eligibility.topRefinement,
+            hasHighConfidenceLearning: eligibility.hasHighConfidenceLearning,
+        });
+        if (!line) {
+            return { printed: false, response: 'skipped', reason: eligibility.reason };
+        }
+        const response = await promptNudge(line, opts.prompt);
+        return { printed: true, response, reason: eligibility.reason };
+    }
+    catch {
+        return { printed: false, response: 'skipped', reason: 'no-signal' };
+    }
+}
+//# sourceMappingURL=session-end-nudge.js.map

package/dist/src/core/reflect-nudge/session-end-nudge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-end-nudge.js","sourceRoot":"","sources":["../../../../src/core/reflect-nudge/session-end-nudge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,WAAW,EAA2C,MAAM,yBAAyB,CAAC;AAmB/F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAqB;IAErB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACrE,CAAC;IAED,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,qBAAqB,CAAC;YAC9C,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;YAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;QAC7E,CAAC;QAED,MAAM,IAAI,GAAG,iBAAiB,CAAC;YAC7B,aAAa,EAAE,WAAW,CAAC,aAAa;YACxC,yBAAyB,EAAE,WAAW,CAAC,yBAAyB;SACjE,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;QAC7E,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACtD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACtE,CAAC;AACH,CAAC"}

package/dist/src/core/reflection/reflect-handler.d.ts

@@ -29,6 +29,8 @@ export interface ReflectConfig {
     model: ClaudeModel;
     /** Maximum learnings per session */
     maxLearningsPerSession: number;
+    /** Session-end nudge on /sw:done close (default: true). Set false to disable. */
+    autoNudge: boolean;
 }
 /**
  * Default configuration

package/dist/src/core/reflection/reflect-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reflect-handler.d.ts","sourceRoot":"","sources":["../../../../src/core/reflection/reflect-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAAqC,KAAK,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAWvG;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,mDAAmD;IACnD,KAAK,EAAE,WAAW,CAAC;IACnB,oCAAoC;IACpC,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,GAAG,EAAE,OAAO,CAAC;IACb,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,oBAAoB;IACpB,YAAY,EAAE;QACZ,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,yBAAyB;IACzB,SAAS,EAAE;QACT,cAAc,EAAE,aAAa,EAAE,CAAC;KACjC,CAAC;IACF,uBAAuB;IACvB,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,yBAAyB,EAAE,MAAM,CAAC;QAClC,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAyZD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CA4BpE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,CAAC,CA2GxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAqDjE;AAoDD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAyFlG;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAsC5E"}
+{"version":3,"file":"reflect-handler.d.ts","sourceRoot":"","sources":["../../../../src/core/reflection/reflect-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAAqC,KAAK,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAWvG;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,mDAAmD;IACnD,KAAK,EAAE,WAAW,CAAC;IACnB,oCAAoC;IACpC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iFAAiF;IACjF,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAKpC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,GAAG,EAAE,OAAO,CAAC;IACb,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,oBAAoB;IACpB,YAAY,EAAE;QACZ,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,yBAAyB;IACzB,SAAS,EAAE;QACT,cAAc,EAAE,aAAa,EAAE,CAAC;KACjC,CAAC;IACF,uBAAuB;IACvB,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,yBAAyB,EAAE,MAAM,CAAC;QAClC,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAyZD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CA+BpE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,CAAC,CA2GxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAqDjE;AAoDD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAyFlG;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAsC5E"}

package/dist/src/core/reflection/reflect-handler.js

@@ -30,6 +30,7 @@ export const DEFAULT_REFLECT_CONFIG = {
     enabled: true,
     model: 'haiku',
     maxLearningsPerSession: 3,
+    autoNudge: true,
 };
 /**
  * Known SpecWeave skills/plugins for validation
@@ -403,6 +404,9 @@ export function readReflectConfig(projectRoot) {
             if (typeof configContent.reflect.maxLearningsPerSession === 'number') {
                 config.maxLearningsPerSession = configContent.reflect.maxLearningsPerSession;
             }
+            if (typeof configContent.reflect.autoNudge === 'boolean') {
+                config.autoNudge = configContent.reflect.autoNudge;
+            }
         }
     }
     catch {