@specship/specship-win32-arm64 0.11.7 → 0.11.9

package/lib/dist/bin/specship.js

@@ -115,11 +115,79 @@ async function loadServerPackage() {
  * The JSONL ingest watcher now ships inside `@specship/specship-server`
  * itself — `createServer({ ingest: true })` starts it. No separate package.
  */
+/**
+ * Claude Code's slug encoding (every non-alphanumeric char → '-') is lossy,
+ * so decoding by mapping '-' back to '/' mangles any path containing
+ * hyphens/dots/underscores. Recover real paths from `~/.claude.json` (its
+ * `projects` object is keyed by real absolute paths), then from a `"cwd"`
+ * value in the slug's newest transcript, before falling back to the lossy
+ * decode. Mirrors `packages/server/src/ingest/project-paths.ts`
+ * (REQ-SLUGRES-004) — the server package depends on this one, so the CLI
+ * can't import it.
+ */
+function buildClaudeSlugIndex() {
+    const bySlug = new Map();
+    try {
+        const raw = fs.readFileSync(path.join(os.homedir(), '.claude.json'), 'utf8');
+        const parsed = JSON.parse(raw);
+        for (const realPath of Object.keys(parsed.projects ?? {})) {
+            bySlug.set(realPath.replace(/[^A-Za-z0-9]/g, '-'), realPath);
+        }
+    }
+    catch { /* missing or malformed — sniff/fallback below still work */ }
+    return bySlug;
+}
+function sniffClaudeSlugCwd(claudeRoot, slug) {
+    const dir = path.join(claudeRoot, slug);
+    let newest = null;
+    try {
+        for (const f of fs.readdirSync(dir, { withFileTypes: true })) {
+            if (!f.isFile() || !f.name.toLowerCase().endsWith('.jsonl'))
+                continue;
+            const st = fs.statSync(path.join(dir, f.name));
+            if (!newest || st.mtimeMs > newest.mtimeMs)
+                newest = { file: f.name, mtimeMs: st.mtimeMs };
+        }
+    }
+    catch {
+        return null;
+    }
+    if (!newest)
+        return null;
+    try {
+        const fd = fs.openSync(path.join(dir, newest.file), 'r');
+        let chunk;
+        try {
+            const buf = Buffer.alloc(64 * 1024);
+            const read = fs.readSync(fd, buf, 0, buf.length, 0);
+            chunk = buf.toString('utf8', 0, read);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        const m = /"cwd"\s*:\s*"((?:[^"\\]|\\.)*)"/.exec(chunk);
+        if (!m)
+            return null;
+        let cwd = JSON.parse(`"${m[1]}"`);
+        // Accept the cwd or an ancestor of it — sessions may record a subdir.
+        for (;;) {
+            if (cwd.replace(/[^A-Za-z0-9]/g, '-') === slug)
+                return cwd;
+            const parent = path.dirname(cwd);
+            if (parent === cwd)
+                return null;
+            cwd = parent;
+        }
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * Auto-pick a default project for `specship serve --ui` when the user
  * didn't pass `-p` and the cwd isn't initialized either. Walks
  * `~/.claude/projects/*` (Claude Code's per-project transcript dirs),
- * decodes each slug back to a real path, and returns the most-recently-
+ * resolves each slug back to a real path, and returns the most-recently-
  * touched one that's still on disk AND has been `specship init`'d.
  *
  * Returns null when nothing qualifies — the server boots projectless and
@@ -134,13 +202,15 @@ async function pickRecentInitializedProject() {
     catch {
         return null;
     }
+    const slugIndex = buildClaudeSlugIndex();
     const candidates = [];
     for (const ent of entries) {
         if (!ent.isDirectory())
             continue;
         const slug = ent.name;
-        // Same encoding the server's decodeProjectSlug uses: '-' → '/'.
-        const decoded = slug.startsWith('-') ? '/' + slug.slice(1).replace(/-/g, '/') : slug;
+        const decoded = slugIndex.get(slug) ??
+            sniffClaudeSlugCwd(claudeRoot, slug) ??
+            (slug.startsWith('-') ? '/' + slug.slice(1).replace(/-/g, '/') : slug);
         try {
             const st = fs.statSync(decoded);
             if (!st.isDirectory())
@@ -769,9 +839,28 @@ function main() {
     program
         .command('sync [path]')
         .description('Sync changes since last index')
-        .option('-q, --quiet', 'Suppress output (for git hooks)')
+        .option('-q, --quiet', 'Suppress output (for git hooks); drift-transition notices still print')
+        .option('--drift-summary', 'After syncing, print a one-line drifted-link summary when the queue is non-empty (for the SessionStart hook)')
         .action(async (pathArg, options) => {
         const projectPath = resolveProjectPath(pathArg);
+        // One line per link that TRANSITIONED into drifted this sync
+        // (REQ-DRIFT-PUSH-001). Deliberately printed even under --quiet — the
+        // auto-sync hook runs with --quiet, and these notices are its payload.
+        const pushDriftNotices = (result) => {
+            for (const t of result.driftedTransitions ?? []) {
+                console.log(`⚠ spec drift: ${t.specId} ${t.fromState}→drifted (${t.symbol} ${t.axis === 'spec' ? 'spec changed' : 'changed'}) — ` +
+                    `re-assert with specship_link_assert, or run /specship:check fix ${t.specId}`);
+            }
+        };
+        // One-line drift-queue summary, only when non-empty (REQ-DRIFT-PUSH-002).
+        const pushDriftSummary = (cg) => {
+            if (!options.driftSummary)
+                return;
+            const drifted = cg.getSpecQueries().getLinksByState(['drifted']).length;
+            if (drifted > 0) {
+                console.log(`⚠ ${drifted} spec link(s) drifted — review with /specship:check drifted`);
+            }
+        };
         try {
             if (!(0, directory_1.isInitialized)(projectPath)) {
                 if (!options.quiet) {
@@ -782,7 +871,9 @@ function main() {
             const { default: SpecShip } = await loadSpecShip();
             const cg = await SpecShip.open(projectPath);
             if (options.quiet) {
-                await cg.sync();
+                const result = await cg.sync();
+                pushDriftNotices(result);
+                pushDriftSummary(cg);
                 cg.destroy();
                 return;
             }
@@ -809,6 +900,8 @@ function main() {
                     details.push(`Removed: ${result.filesRemoved}`);
                 clack.log.info(`${details.join(', ')} ${(0, glyphs_1.getGlyphs)().dash} ${formatNumber(result.nodesUpdated)} nodes in ${formatDuration(result.durationMs)}`);
             }
+            pushDriftNotices(result);
+            pushDriftSummary(cg);
             clack.outro('Done');
             cg.destroy();
         }
@@ -1450,11 +1543,18 @@ function main() {
      * GATING check fails. Which checks gate vs advise is configured in
      * specship.config.json `enforce.gate`; with no config every check is advisory
      * and the command exits 0 (opt-in — never breaks an existing repo).
+     *
+     * The graduation ramp (REQ-ENFORCE-004): `--strict` gates every check for
+     * one run; `--enable-gate <checks...>` persists gating into the config and
+     * then runs; an advisory run with would-be-gating findings ends by printing
+     * the exact `--enable-gate` command that turns the gate on.
      */
     program
         .command('check [path]')
         .description('Run the enforcement gate (drift + fitness + maintainability + behaviour); exits non-zero on a gating failure')
         .option('-j, --json', 'Output as JSON')
+        .option('--strict', 'Treat every check as gating for this run only (nothing read from or written to config)')
+        .option('--enable-gate <checks...>', 'Persist gating for the named checks into specship.config.json, then run the gate')
         .action(async (pathArg, options) => {
         const projectPath = resolveProjectPath(pathArg);
         try {
@@ -1462,9 +1562,25 @@ function main() {
                 error(`SpecShip not initialized in ${projectPath}`);
                 process.exit(1);
             }
+            const enforce = await Promise.resolve().then(() => __importStar(require('../enforce/enforce')));
+            // --enable-gate writes the opt-in config, then falls through to a
+            // normal run so the user immediately sees the gate with teeth
+            // (REQ-ENFORCE-004.A1).
+            if (options.enableGate?.length) {
+                const invalid = options.enableGate.filter((c) => !enforce.ALL_CHECKS.includes(c));
+                if (invalid.length) {
+                    error(`Unknown check(s): ${invalid.join(', ')}. Valid: ${enforce.ALL_CHECKS.join(', ')}`);
+                    process.exit(1);
+                }
+                const enabled = enforce.enableGateChecks(projectPath, options.enableGate);
+                if (enabled.length) {
+                    success(`Gating enabled for ${enabled.join(', ')} — written to specship.config.json.`);
+                }
+            }
             const { default: SpecShip } = await loadSpecShip();
             const cg = await SpecShip.open(projectPath);
-            const r = cg.getEnforce();
+            // --strict gates everything for this run only (REQ-ENFORCE-004.A2).
+            const r = options.strict ? cg.getEnforce(enforce.strictEnforceConfig()) : cg.getEnforce();
             if (options.json) {
                 console.log(JSON.stringify(r, null, 2));
                 cg.destroy();
@@ -1486,6 +1602,16 @@ function main() {
                 success(r.gatedFailures.length === 0 && r.checks.some((c) => c.gating)
                     ? 'All gating checks pass.'
                     : 'Pass (no gating checks failed).');
+                // The advisory sell (REQ-ENFORCE-004.A1): findings that would fail
+                // a gated run end the report with the exact opt-in command.
+                const wouldGate = r.checks.filter((c) => !c.gating && !c.passed).map((c) => c.check);
+                if (wouldGate.length) {
+                    const total = r.checks
+                        .filter((c) => wouldGate.includes(c.check))
+                        .reduce((n, c) => n + c.findings.length, 0);
+                    console.log(chalk.dim(`\n  ${total} advisory finding(s) would fail a gated run.` +
+                        `\n  Enable: specship check --enable-gate ${wouldGate.join(' ')}\n`));
+                }
                 cg.destroy();
                 return;
             }
@@ -2184,14 +2310,14 @@ function main() {
     });
     /**
      * specship starter-prompt — print the manufactured first-run flow/impact prompt
-     * (ACTIVATION-DOC). The single delivery mechanism for the bare `/ss-explore`
+     * (ACTIVATION-DOC). The single delivery mechanism for the bare `/specship:explore`
      * door: it self-gates (prints nothing if the index can't be queried —
      * REQ-ACTIVATION-004) and self-retires (prints nothing once a real specship
      * lookup has been recorded this session — REQ-ACTIVATION-003).
      */
     program
         .command('starter-prompt [path]')
-        .description('Print a suggested first flow/impact prompt for this project (used by the /ss-explore door).')
+        .description('Print a suggested first flow/impact prompt for this project (used by the /specship:explore door).')
         .option('-j, --json', 'Output as JSON')
         .action(async (pathArg, options) => {
         const projectRoot = path.resolve(pathArg ?? process.cwd());
@@ -2278,7 +2404,7 @@ function main() {
         if (shouldNudge(prompt)) {
             const additionalContext = 'This repo uses spec-driven development (SpecShip). Before any brainstorming or ' +
                 'planning skill, FIRST invoke spec-author to author the spec under specs/ for this ' +
-                'work — the spec is the contract; implement from it with /ss-spec implement.';
+                'work — the spec is the contract; implement from it with /specship:spec implement.';
             process.stdout.write(JSON.stringify({ hookSpecificOutput: { hookEventName: 'UserPromptSubmit', additionalContext } }) + '\n');
         }
         process.exit(0);
@@ -2370,12 +2496,12 @@ function main() {
     });
     // @implements REQ-DOMAIN-003
     // Thin surface over the read-only gap-seed pass (SpecShip.getDomainGapSeed,
-    // REQ-DOMAIN-003) so the `/ss-spec domain` capture command can cite the SAME real
+    // REQ-DOMAIN-003) so the `/specship:spec domain` capture command can cite the SAME real
     // undocumented entities/specs the library computes (REQ-DOMAIN-004.A4) without a
     // new MCP tool (REQ-DOMAIN-005) or a runtime package import. Writes nothing.
     program
         .command('domain-gaps [path]')
-        .description('List code entities and specs not yet covered by a domain fact (the domain gap-seed). Feeds the /ss-spec domain capture interview.')
+        .description('List code entities and specs not yet covered by a domain fact (the domain gap-seed). Feeds the /specship:spec domain capture interview.')
         .option('-l, --limit <n>', 'max entities and specs to print in text mode (default: 50)')
         .option('--json', 'emit JSON')
         .action(async (pathArg, options) => {
@@ -2418,7 +2544,7 @@ function main() {
                     if (seed.specs.length > limit)
                         console.log(`  … and ${seed.specs.length - limit} more`);
                 }
-                console.log(`\nCapture a fact for any of these with \`/ss-spec domain\`.`);
+                console.log(`\nCapture a fact for any of these with \`/specship:spec domain\`.`);
             }
             /* eslint-enable no-console */
         }
@@ -2544,7 +2670,7 @@ function main() {
                 }
                 else {
                     // eslint-disable-next-line no-console
-                    console.log('No specs or briefs found. Author one with /ss-spec new.');
+                    console.log('No specs or briefs found. Author one with /specship:spec new.');
                 }
                 return;
             }