@selvakumaresra/specship 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@selvakumaresra/specship",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Supercharge Claude Code with semantic code intelligence. 94% fewer tool calls • 77% faster exploration • 100% local.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -28,7 +28,10 @@
     "test:watch": "vitest",
     "test:eval": "vitest run __tests__/evaluation/",
     "eval": "npm run build && npx tsx __tests__/evaluation/runner.ts",
-    "clean": "node -e \"const fs=require('fs');fs.rmSync('dist',{recursive:true,force:true})\""
+    "clean": "node -e \"const fs=require('fs');fs.rmSync('dist',{recursive:true,force:true})\"",
+    "sync:shim": "node scripts/sync-shim-version.mjs",
+    "version": "npm run sync:shim",
+    "release:shim": "node scripts/sync-shim-version.mjs && cd packages/specship-shim && npm publish --access public"
   },
   "keywords": [
     "code-intelligence",
@@ -56,10 +59,12 @@
     "@types/better-sqlite3": "^7.6.0",
     "@types/node": "^20.19.30",
     "@types/picomatch": "^4.0.2",
-    "better-sqlite3": "^11.10.0",
     "typescript": "^5.0.0",
     "vitest": "^2.1.9"
   },
+  "optionalDependencies": {
+    "better-sqlite3": "^11.10.0"
+  },
   "engines": {
     "node": ">=20.0.0 <25.0.0"
   }

package/scripts/sync-shim-version.mjs

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+/**
+ * Sync `packages/specship-shim/package.json` against the root version.
+ *
+ * The unscoped `specship-cli` shim has one dependency — `@selvakumaresra/specship`
+ * pinned to a specific version (NOT a range, because the shim's whole job is
+ * to deliver THE matching CLI). So every root release needs the shim's:
+ *   - `version`                              → the root's new version
+ *   - `dependencies["@selvakumaresra/specship"]` → exact match, same pin
+ *
+ * Wired into the root package's `version` lifecycle, this runs automatically
+ * when `npm version <bump>` mutates the root. After it runs, the modified
+ * shim package.json is `git add`-ed into the same version-bump commit so the
+ * release stays atomic.
+ *
+ * Usage (manual): `npm run sync:shim`
+ * Usage (auto):   triggered by `npm version patch|minor|major` via the
+ *                 root `version` script.
+ */
+import { execSync } from 'node:child_process';
+import { readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const repoRoot = path.resolve(here, '..');
+const rootPkgPath = path.join(repoRoot, 'package.json');
+const shimPkgPath = path.join(repoRoot, 'packages', 'specship-shim', 'package.json');
+
+function readJson(p) { return JSON.parse(readFileSync(p, 'utf-8')); }
+function writeJson(p, obj) { writeFileSync(p, JSON.stringify(obj, null, 2) + '\n'); }
+
+const rootPkg = readJson(rootPkgPath);
+const shimPkg = readJson(shimPkgPath);
+const rootName = rootPkg.name; // e.g. @selvakumaresra/specship
+const target = rootPkg.version;
+
+const changes = [];
+if (shimPkg.version !== target) {
+  changes.push(`version: ${shimPkg.version} → ${target}`);
+  shimPkg.version = target;
+}
+shimPkg.dependencies ??= {};
+const currentPin = shimPkg.dependencies[rootName];
+if (currentPin !== target) {
+  changes.push(`dep ${rootName}: ${currentPin ?? '(missing)'} → ${target}`);
+  shimPkg.dependencies[rootName] = target;
+}
+
+if (changes.length === 0) {
+  console.log(`[sync-shim] already in sync at ${target}`);
+  process.exit(0);
+}
+
+writeJson(shimPkgPath, shimPkg);
+console.log(`[sync-shim] updated packages/specship-shim/package.json:`);
+for (const c of changes) console.log(`           - ${c}`);
+
+// Stage the change so `npm version` rolls it into the same commit.
+try {
+  execSync('git add packages/specship-shim/package.json', { cwd: repoRoot, stdio: 'inherit' });
+} catch {
+  // Not in a git repo (or git unavailable) — fine; sync still happened on disk.
+}

package/dist/bin/node-version-check.d.ts

@@ -1,37 +0,0 @@
-/**
- * Node.js version compatibility check.
- *
- * Node 25.x has a V8 turboshaft WASM JIT Zone allocator bug that
- * reliably crashes SpecShip with `Fatal process out of memory: Zone`
- * during tree-sitter grammar compilation. This module owns the
- * user-facing banner shown before exit. Kept side-effect-free so it's
- * safe to import from tests without triggering CLI bootstrap.
- */
-/**
- * Build the bordered banner shown when SpecShip detects an
- * unsupported Node.js major version (currently 25+). Pinned via unit
- * test so the recovery commands and override instructions can't be
- * silently stripped by future edits.
- *
- * Uses ASCII glyphs to stay readable on Windows OEM-codepage consoles
- * (see ../ui/glyphs.ts for the rationale).
- */
-export declare function buildNode25BlockBanner(nodeVersion: string): string;
-/**
- * Lowest supported Node.js major version. Matches the `engines` floor in
- * package.json. Below this, SpecShip relies on language features / native APIs
- * that aren't present, and the combination is untested. `engines` alone only
- * *warns* on install (unless the user set `engine-strict`), so the CLI bootstrap
- * also hard-blocks here to actually enforce the floor.
- */
-export declare const MIN_NODE_MAJOR = 20;
-/**
- * Build the bordered banner shown when SpecShip detects a Node.js major below
- * {@link MIN_NODE_MAJOR}. Pinned via unit test so the recovery commands and the
- * override env var can't be silently stripped by future edits.
- *
- * Uses ASCII glyphs to stay readable on Windows OEM-codepage consoles
- * (see ../ui/glyphs.ts for the rationale).
- */
-export declare function buildNodeTooOldBanner(nodeVersion: string): string;
-//# sourceMappingURL=node-version-check.d.ts.map

package/dist/bin/node-version-check.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"node-version-check.d.ts","sourceRoot":"","sources":["../../src/bin/node-version-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAmBlE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAkBjE"}

package/dist/bin/node-version-check.js

@@ -1,79 +0,0 @@
-"use strict";
-/**
- * Node.js version compatibility check.
- *
- * Node 25.x has a V8 turboshaft WASM JIT Zone allocator bug that
- * reliably crashes SpecShip with `Fatal process out of memory: Zone`
- * during tree-sitter grammar compilation. This module owns the
- * user-facing banner shown before exit. Kept side-effect-free so it's
- * safe to import from tests without triggering CLI bootstrap.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MIN_NODE_MAJOR = void 0;
-exports.buildNode25BlockBanner = buildNode25BlockBanner;
-exports.buildNodeTooOldBanner = buildNodeTooOldBanner;
-/**
- * Build the bordered banner shown when SpecShip detects an
- * unsupported Node.js major version (currently 25+). Pinned via unit
- * test so the recovery commands and override instructions can't be
- * silently stripped by future edits.
- *
- * Uses ASCII glyphs to stay readable on Windows OEM-codepage consoles
- * (see ../ui/glyphs.ts for the rationale).
- */
-function buildNode25BlockBanner(nodeVersion) {
-    const sep = '-'.repeat(72);
-    return [
-        sep,
-        `[SpecShip] Unsupported Node.js version: ${nodeVersion}`,
-        sep,
-        'Node.js 25.x has a V8 WASM JIT (turboshaft) Zone allocator bug that',
-        'crashes with `Fatal process out of memory: Zone` when SpecShip',
-        'compiles tree-sitter grammars. SpecShip WILL crash on this Node',
-        'version mid-indexing. See https://github.com/selvakumarEsra/specship/issues/81',
-        '',
-        'Fix: install Node.js 22 LTS:',
-        '  nvm install 22 && nvm use 22                          # nvm',
-        '  brew install node@22 && brew link --overwrite --force node@22  # Homebrew',
-        '',
-        'To override (NOT recommended - you will likely OOM):',
-        '  SPECSHIP_ALLOW_UNSAFE_NODE=1 specship ...',
-        sep,
-    ].join('\n');
-}
-/**
- * Lowest supported Node.js major version. Matches the `engines` floor in
- * package.json. Below this, SpecShip relies on language features / native APIs
- * that aren't present, and the combination is untested. `engines` alone only
- * *warns* on install (unless the user set `engine-strict`), so the CLI bootstrap
- * also hard-blocks here to actually enforce the floor.
- */
-exports.MIN_NODE_MAJOR = 20;
-/**
- * Build the bordered banner shown when SpecShip detects a Node.js major below
- * {@link MIN_NODE_MAJOR}. Pinned via unit test so the recovery commands and the
- * override env var can't be silently stripped by future edits.
- *
- * Uses ASCII glyphs to stay readable on Windows OEM-codepage consoles
- * (see ../ui/glyphs.ts for the rationale).
- */
-function buildNodeTooOldBanner(nodeVersion) {
-    const sep = '-'.repeat(72);
-    return [
-        sep,
-        `[SpecShip] Unsupported Node.js version: ${nodeVersion}`,
-        sep,
-        `SpecShip requires Node.js ${exports.MIN_NODE_MAJOR} or newer. Older versions lack`,
-        'language features and native APIs SpecShip depends on, and are not',
-        'tested or supported.',
-        '',
-        'Fix: install Node.js 22 LTS:',
-        '  nvm install 22 && nvm use 22                          # nvm',
-        '  brew install node@22 && brew link --overwrite --force node@22  # Homebrew',
-        '',
-        'To override (NOT recommended - unsupported):',
-        '  SPECSHIP_ALLOW_UNSAFE_NODE=1 specship ...',
-        sep,
-    ].join('\n');
-}
-//# sourceMappingURL=node-version-check.js.map

package/dist/bin/node-version-check.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"node-version-check.js","sourceRoot":"","sources":["../../src/bin/node-version-check.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAWH,wDAmBC;AAmBD,sDAkBC;AAjED;;;;;;;;GAQG;AACH,SAAgB,sBAAsB,CAAC,WAAmB;IACxD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,OAAO;QACL,GAAG;QACH,2CAA2C,WAAW,EAAE;QACxD,GAAG;QACH,qEAAqE;QACrE,gEAAgE;QAChE,iEAAiE;QACjE,gFAAgF;QAChF,EAAE;QACF,8BAA8B;QAC9B,+DAA+D;QAC/D,6EAA6E;QAC7E,EAAE;QACF,sDAAsD;QACtD,6CAA6C;QAC7C,GAAG;KACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACU,QAAA,cAAc,GAAG,EAAE,CAAC;AAEjC;;;;;;;GAOG;AACH,SAAgB,qBAAqB,CAAC,WAAmB;IACvD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,OAAO;QACL,GAAG;QACH,2CAA2C,WAAW,EAAE;QACxD,GAAG;QACH,6BAA6B,sBAAc,gCAAgC;QAC3E,oEAAoE;QACpE,sBAAsB;QACtB,EAAE;QACF,8BAA8B;QAC9B,+DAA+D;QAC/D,6EAA6E;QAC7E,EAAE;QACF,8CAA8C;QAC9C,6CAA6C;QAC7C,GAAG;KACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/bin/specship.d.ts

@@ -1,25 +0,0 @@
-#!/usr/bin/env node
-/**
- * SpecShip CLI
- *
- * Command-line interface for SpecShip code intelligence.
- *
- * Usage:
- *   specship                    Run interactive installer (when no args)
- *   specship install            Run interactive installer
- *   specship uninstall          Remove SpecShip from your agents
- *   specship init [path]        Initialize SpecShip in a project
- *   specship uninit [path]      Remove SpecShip from a project
- *   specship index [path]       Index all files in the project
- *   specship sync [path]        Sync changes since last index
- *   specship status [path]      Show index status
- *   specship query <search>     Search for symbols
- *   specship files [options]    Show project file structure
- *   specship context <task>     Build context for a task
- *   specship callers <symbol>   Find what calls a function/method
- *   specship callees <symbol>   Find what a function/method calls
- *   specship impact <symbol>    Analyze what code is affected by changing a symbol
- *   specship affected [files]   Find test files affected by changes
- */
-export {};
-//# sourceMappingURL=specship.d.ts.map

package/dist/bin/specship.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"specship.d.ts","sourceRoot":"","sources":["../../src/bin/specship.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;GAqBG"}