@specship/specship-win32-arm64 0.16.0 → 0.18.0

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

@@ -16,11 +16,20 @@
  * ceiling. Wording is A/B-gated before default-on release (REQ-STEER-003).
  */
 export declare const STEERING_TEXT: string;
+/**
+ * The haiku-tier template (LOWMODEL-DOC, REQ-LOWMODEL-002): small models
+ * follow prescriptive templates far better than principles, and fan-out
+ * (subagents) multiplies their cost and confusion. Kept under ~80 tokens
+ * (REQ-LOWMODEL-002.A2).
+ */
+export declare const STEERING_TEXT_HAIKU: 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.
+ * opted-out users get zero prompt noise. Tier-aware (REQ-LOWMODEL-002):
+ * haiku sessions get the prescriptive template; sonnet and frontier keep the
+ * standard line.
  */
-export declare function buildSteeringNudge(cwd: string, env?: NodeJS.ProcessEnv): string | null;
+export declare function buildSteeringNudge(cwd: string, env?: NodeJS.ProcessEnv, homedir?: string): string | null;
 //# sourceMappingURL=steering.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"steering.d.ts","sourceRoot":"","sources":["../../src/activation/steering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAKJ,CAAC;AAEvB;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,QAIqC,CAAC;AAEtE;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAUf"}

package/lib/dist/activation/steering.js

@@ -45,27 +45,44 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STEERING_TEXT = void 0;
+exports.STEERING_TEXT_HAIKU = exports.STEERING_TEXT = void 0;
 exports.buildSteeringNudge = buildSteeringNudge;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const model_context_1 = require("../mcp/model-context");
+const runtime_settings_1 = require("../config/runtime-settings");
 /**
  * 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.';
+exports.STEERING_TEXT = 'This project has a SpecShip code-graph index. Before reading or editing ANY ' +
+    'code for a task — understanding, implementing, fixing, refactoring — call ' +
+    'mcp__specship__specship_explore with the relevant symbol/file names FIRST. ' +
+    'Treat the source it returns as already read; use Read/Grep only for content ' +
+    'it did not return.';
+/**
+ * The haiku-tier template (LOWMODEL-DOC, REQ-LOWMODEL-002): small models
+ * follow prescriptive templates far better than principles, and fan-out
+ * (subagents) multiplies their cost and confusion. Kept under ~80 tokens
+ * (REQ-LOWMODEL-002.A2).
+ */
+exports.STEERING_TEXT_HAIKU = 'This project has a SpecShip index. For any code question, call exactly: ' +
+    'mcp__specship__specship_explore with the symbol/file names from the question. ' +
+    'ONE call, then answer from its output — the source it returns is already read. ' +
+    'Do not spawn subagents. Do not Read/Grep files the tool returned.';
 /**
  * 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.
+ * opted-out users get zero prompt noise. Tier-aware (REQ-LOWMODEL-002):
+ * haiku sessions get the prescriptive template; sonnet and frontier keep the
+ * standard line.
  */
-function buildSteeringNudge(cwd, env = process.env) {
-    if (env.SPECSHIP_NO_STEERING === '1')
+function buildSteeringNudge(cwd, env = process.env, homedir) {
+    // RUNSET-DOC: the opt-out resolves env > project .specship/settings.json >
+    // ~/.specship/settings.json, so a repo can silence steering durably.
+    if ((0, runtime_settings_1.resolveSetting)('SPECSHIP_NO_STEERING', cwd, env, homedir) === '1')
         return null;
     try {
         if (!fs.statSync(path.join(cwd, '.specship')).isDirectory())
@@ -74,6 +91,6 @@ function buildSteeringNudge(cwd, env = process.env) {
     catch {
         return null;
     }
-    return exports.STEERING_TEXT;
+    return (0, model_context_1.detectModelTier)(cwd, env, homedir) === 'haiku' ? exports.STEERING_TEXT_HAIKU : exports.STEERING_TEXT;
 }
 //# sourceMappingURL=steering.js.map

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

@@ -1 +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"}
+{"version":3,"file":"steering.js","sourceRoot":"","sources":["../../src/activation/steering.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCH,gDAcC;AAnDD,uCAAyB;AACzB,2CAA6B;AAC7B,wDAAuD;AACvD,iEAA4D;AAE5D;;;;GAIG;AACU,QAAA,aAAa,GACxB,8EAA8E;IAC9E,4EAA4E;IAC5E,6EAA6E;IAC7E,8EAA8E;IAC9E,oBAAoB,CAAC;AAEvB;;;;;GAKG;AACU,QAAA,mBAAmB,GAC9B,0EAA0E;IAC1E,gFAAgF;IAChF,iFAAiF;IACjF,mEAAmE,CAAC;AAEtE;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAChC,GAAW,EACX,MAAyB,OAAO,CAAC,GAAG,EACpC,OAAgB;IAEhB,2EAA2E;IAC3E,qEAAqE;IACrE,IAAI,IAAA,iCAAc,EAAC,sBAAsB,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACnF,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,IAAA,+BAAe,EAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,2BAAmB,CAAC,CAAC,CAAC,qBAAa,CAAC;AAC9F,CAAC"}

package/lib/dist/bin/specship.js

@@ -1279,6 +1279,8 @@ function main() {
         .command('reflect [path]')
         .description('Mine ingested transcripts for self-improvement proposals (memory rules, skills, hooks)')
         .option('-j, --json', 'Output as JSON')
+        .option('--capture', 'Capture a routine as a skill proposal: --title required, content on stdin (LEARN-DOC)')
+        .option('--title <title>', 'Title for --capture')
         .action(async (pathArg, options) => {
         const projectPath = resolveProjectPath(pathArg);
         try {
@@ -1288,6 +1290,33 @@ function main() {
             }
             const { default: SpecShip } = await loadSpecShip();
             const cg = await SpecShip.open(projectPath);
+            // Explicit capture door (LEARN-DOC, REQ-LEARN-002): crystallize a
+            // distilled routine into a human-gated skill proposal. Content on
+            // stdin so multi-line routines survive shell quoting.
+            if (options.capture) {
+                if (!options.title || !options.title.trim()) {
+                    error('--capture requires --title "<what this routine does>"');
+                    process.exit(1);
+                }
+                const chunks = [];
+                for await (const c of process.stdin)
+                    chunks.push(c);
+                const content = Buffer.concat(chunks).toString('utf-8').trim();
+                if (!content) {
+                    error('--capture expects the routine content on stdin (pipe or heredoc)');
+                    process.exit(1);
+                }
+                const p = cg.reflectCapture({ title: options.title, content });
+                if (options.json) {
+                    console.log(JSON.stringify(p, null, 2));
+                }
+                else {
+                    info(`Captured as proposal ${p.contentHash.slice(0, 12)} (${p.state}): ${p.title}`);
+                    info('Review and apply it from the dashboard Improvements page (preview-diff → confirm).');
+                }
+                cg.destroy();
+                return;
+            }
             const result = cg.reflectAnalyze();
             if (options.json) {
                 console.log(JSON.stringify(result, null, 2));
@@ -2132,7 +2161,8 @@ function main() {
         .option('-l, --location <where>', 'Install location: "global" or "local". Default: prompt (local)')
         .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('--sdd', '(default) Install the spec-driven-development governance tier (spec/authoring/review/design commands + the spec-author nudge hook)')
+        .option('--no-sdd', 'Skip the governance tier — retrieval-only install (the pre-0.18 default)')
         .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)')
@@ -2183,7 +2213,9 @@ function main() {
                 target: opts.target,
                 location: opts.location,
                 autoAllow,
-                sdd: opts.sdd === true ? true : undefined,
+                // SDD/governance is default-ON (INSTALL-WEDGE-DOC v2): commander's
+                // --no-sdd sets opts.sdd=false; otherwise install the full surface.
+                sdd: opts.sdd === false ? false : true,
                 withJira: opts.withJira === true ? true : undefined,
                 withDesigner: opts.withDesigner === true ? true : undefined,
                 statusLine,