@specship/specship-win32-arm64 0.15.0 → 0.16.0

package/lib/dist/activation/steering.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Retrieval steering nudge (STEER-HOOK-DOC).
+ *
+ * Coverage that the agent never exercises is worthless: dynamic-dispatch
+ * synthesizers repeatedly probe-validate but show "agent A/B null" because
+ * the agent reaches for Read/Grep before specship. The only channel that
+ * measurably fixed adoption was high-salience per-prompt steering
+ * (`--append-system-prompt`); low-salience channels (MCP initialize
+ * instructions, tool descriptions) failed across wording variants. This
+ * module is that channel, shipped as an installer-written `UserPromptSubmit`
+ * hook (REQ-STEER-001) whose command is `specship steer-nudge`.
+ */
+/**
+ * The one steering line injected per prompt. Kept short (~40 tokens) — it is
+ * added to EVERY prompt in an initialized project, so brevity is the cost
+ * ceiling. Wording is A/B-gated before default-on release (REQ-STEER-003).
+ */
+export declare const STEERING_TEXT: string;
+/**
+ * Decide whether to emit the steering line (REQ-STEER-002): silent unless the
+ * project is initialized (`.specship/` exists at cwd), and silent when the
+ * user opted out via `SPECSHIP_NO_STEERING=1`. Uninitialized projects and
+ * opted-out users get zero prompt noise.
+ */
+export declare function buildSteeringNudge(cwd: string, env?: NodeJS.ProcessEnv): string | null;
+//# sourceMappingURL=steering.d.ts.map

package/lib/dist/activation/steering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steering.d.ts","sourceRoot":"","sources":["../../src/activation/steering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAI0C,CAAC;AAErE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,IAAI,CAQf"}

package/lib/dist/activation/steering.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Retrieval steering nudge (STEER-HOOK-DOC).
+ *
+ * Coverage that the agent never exercises is worthless: dynamic-dispatch
+ * synthesizers repeatedly probe-validate but show "agent A/B null" because
+ * the agent reaches for Read/Grep before specship. The only channel that
+ * measurably fixed adoption was high-salience per-prompt steering
+ * (`--append-system-prompt`); low-salience channels (MCP initialize
+ * instructions, tool descriptions) failed across wording variants. This
+ * module is that channel, shipped as an installer-written `UserPromptSubmit`
+ * hook (REQ-STEER-001) whose command is `specship steer-nudge`.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STEERING_TEXT = void 0;
+exports.buildSteeringNudge = buildSteeringNudge;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * The one steering line injected per prompt. Kept short (~40 tokens) — it is
+ * added to EVERY prompt in an initialized project, so brevity is the cost
+ * ceiling. Wording is A/B-gated before default-on release (REQ-STEER-003).
+ */
+exports.STEERING_TEXT = 'This project has a SpecShip code-graph index. For structure/flow questions ' +
+    '("how does X work / reach Y", "who calls Z", architecture, impact), call ' +
+    'mcp__specship__specship_explore with the relevant symbol names FIRST — before ' +
+    'any Read/Grep — and treat the source it returns as already read.';
+/**
+ * Decide whether to emit the steering line (REQ-STEER-002): silent unless the
+ * project is initialized (`.specship/` exists at cwd), and silent when the
+ * user opted out via `SPECSHIP_NO_STEERING=1`. Uninitialized projects and
+ * opted-out users get zero prompt noise.
+ */
+function buildSteeringNudge(cwd, env = process.env) {
+    if (env.SPECSHIP_NO_STEERING === '1')
+        return null;
+    try {
+        if (!fs.statSync(path.join(cwd, '.specship')).isDirectory())
+            return null;
+    }
+    catch {
+        return null;
+    }
+    return exports.STEERING_TEXT;
+}
+//# sourceMappingURL=steering.js.map

package/lib/dist/activation/steering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steering.js","sourceRoot":"","sources":["../../src/activation/steering.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsBH,gDAWC;AA/BD,uCAAyB;AACzB,2CAA6B;AAE7B;;;;GAIG;AACU,QAAA,aAAa,GACxB,6EAA6E;IAC7E,2EAA2E;IAC3E,gFAAgF;IAChF,kEAAkE,CAAC;AAErE;;;;;GAKG;AACH,SAAgB,kBAAkB,CAChC,GAAW,EACX,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,GAAG,CAAC,oBAAoB,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAClD,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,EAAE;YAAE,OAAO,IAAI,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,qBAAa,CAAC;AACvB,CAAC"}

package/lib/dist/bin/specship.js

@@ -2133,6 +2133,8 @@ function main() {
         .option('-y, --yes', 'Non-interactive: defaults to --location=local, auto-allow on')
         .option('--no-permissions', 'Skip writing the auto-allow permissions list')
         .option('--sdd', 'Also install the spec-driven-development governance tier (spec/authoring/review/design commands + the spec-author nudge hook). Off by default — a plain install provisions only the retrieval tier.')
+        .option('--with-jira', 'Enable the optional JIRA integration (talks to your Atlassian instance; off by default — the core install is 100% local)')
+        .option('--with-designer', 'Enable the optional Designer integration (EXPERIMENTAL — drives claude.ai/design via a debug Chrome session and may break without notice; off by default)')
         .option('--statusline', 'Wire the SpecShip status-line segment into Claude (skips the prompt; never overwrites an existing status line)')
         .option('--skip-statusline', 'Do not add the status-line segment (skips the prompt)')
         .option('--skip-index', 'Do not offer to index the current project (an explicit opt-out for automation)')
@@ -2182,6 +2184,8 @@ function main() {
                 location: opts.location,
                 autoAllow,
                 sdd: opts.sdd === true ? true : undefined,
+                withJira: opts.withJira === true ? true : undefined,
+                withDesigner: opts.withDesigner === true ? true : undefined,
                 statusLine,
                 yes: opts.yes,
             });
@@ -2365,6 +2369,62 @@ function main() {
         }
         process.exit(0);
     });
+    /**
+     * specship steer-nudge (STEER-HOOK-DOC)
+     *
+     * Internal UserPromptSubmit hook command: inject the one-line retrieval
+     * steering nudge — the high-salience channel that measurably fixes
+     * specship-tool adoption. Exits 0 with empty output when the project has no
+     * `.specship/` index or `SPECSHIP_NO_STEERING=1` is set (REQ-STEER-002).
+     */
+    program
+        .command('steer-nudge')
+        .description('Internal hook: steer flow/structure questions to specship_explore (UserPromptSubmit)')
+        .action(async () => {
+        // Prefer the hook payload's cwd (Claude Code sends it on stdin) so the
+        // check targets the project the prompt belongs to, not wherever the hook
+        // process happened to spawn.
+        let cwd = process.cwd();
+        let transcriptPath = null;
+        const chunks = [];
+        try {
+            for await (const c of process.stdin)
+                chunks.push(c);
+        }
+        catch { /* no stdin — fall back to process.cwd() */ }
+        const raw = Buffer.concat(chunks).toString('utf-8').trim();
+        if (raw) {
+            try {
+                const parsed = JSON.parse(raw);
+                if (typeof parsed?.cwd === 'string' && parsed.cwd.length > 0)
+                    cwd = parsed.cwd;
+                if (typeof parsed?.transcript_path === 'string' && parsed.transcript_path.length > 0) {
+                    transcriptPath = parsed.transcript_path;
+                }
+            }
+            catch { /* not JSON — keep process.cwd() */ }
+        }
+        // Record the session's model from the transcript tail (MODCTX-DOC,
+        // REQ-MODCTX-001.A4) — the primary detection channel, present on every
+        // default install. Fires per prompt so mid-session /model switches
+        // track; runs even when the steering text is suppressed, but only in
+        // initialized projects. Best-effort: never fails the hook.
+        if (transcriptPath && fs.existsSync(path.join(cwd, '.specship'))) {
+            try {
+                const { readModelFromTranscript, recordSessionModel } = await Promise.resolve().then(() => __importStar(require('../mcp/model-context')));
+                const model = readModelFromTranscript(transcriptPath);
+                if (model)
+                    recordSessionModel(cwd, model);
+            }
+            catch { /* telemetry must never break the hook */ }
+        }
+        const { buildSteeringNudge } = await Promise.resolve().then(() => __importStar(require('../activation/steering')));
+        const additionalContext = buildSteeringNudge(cwd);
+        if (additionalContext) {
+            process.stdout.write(JSON.stringify({ hookSpecificOutput: { hookEventName: 'UserPromptSubmit', additionalContext } }) + '\n');
+        }
+        process.exit(0);
+    });
     /**
      * specship uninstall
      *
@@ -2698,7 +2758,7 @@ function main() {
     });
     program
         .command('workflow <action> [arg]')
-        .description('Workflow engine: list | run <name> | resume <runId> | cancel <runId> | approve <runId> | reject <runId> | runs')
+        .description('Workflow engine: list | run <name> | resume <runId> | cancel <runId> | approve <runId> | reject <runId> | purge <runId> | runs')
         .option('-i, --input <kv...>', 'workflow inputs as KEY=VALUE (repeatable)')
         .option('--path <projectRoot>', 'project root (default: cwd)')
         .option('--comment <text>', 'comment for approve/reject')
@@ -2889,9 +2949,23 @@ function main() {
                         error('workflow reject requires a runId');
                         process.exit(1);
                     }
-                    executor.reject(arg, options.reason);
+                    executor.reject(arg, options.reason ?? options.comment);
+                    // eslint-disable-next-line no-console
+                    console.log(`Run ${arg} rejected — parked with its worktree and artifacts intact.\n` +
+                        `  Revise:  specship workflow resume ${arg}   (runs the gate's on_reject prompt with your feedback, then re-pauses for review)\n` +
+                        `  Discard: specship workflow purge ${arg}    (removes the worktree — the only way anything is deleted)`);
+                    break;
+                }
+                case 'purge': {
+                    if (!arg) {
+                        error('workflow purge requires a runId');
+                        process.exit(1);
+                    }
+                    const purged = executor.purge(arg);
                     // eslint-disable-next-line no-console
-                    console.log(`Run ${arg} rejected`);
+                    console.log(purged.worktreeRemoved
+                        ? `Run ${arg} purged — worktree removed (${purged.workingPath ?? 'path unknown'}). Artifacts and the run record are kept.`
+                        : `Run ${arg} had no worktree — nothing to remove. Artifacts and the run record are kept.`);
                     break;
                 }
                 case 'runs': {
@@ -2916,7 +2990,7 @@ function main() {
                     break;
                 }
                 default:
-                    error(`Unknown workflow action "${action}". Use: list | run | resume | cancel | approve | reject | runs`);
+                    error(`Unknown workflow action "${action}". Use: list | run | resume | cancel | approve | reject | purge | runs`);
                     process.exit(1);
             }
         }