@selvakumaresra/specship 0.1.3 → 0.4.0

package/dist/installer/index.js

@@ -0,0 +1,416 @@
+"use strict";
+/**
+ * SpecShip Installer (Claude Code only).
+ *
+ * Writes the specship MCP server config + auto-allow permissions into
+ * Claude Code at the chosen location (global / local). Uses
+ * @clack/prompts for the interactive UI; `runInstallerWithOptions` is
+ * the non-interactive entry called from the `--target` / `--yes` CLI
+ * flags. (The `--target` flag is preserved for backwards compatibility
+ * but only accepts `claude` / `auto` / `all` / `none`.)
+ */
+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.hasPermissions = exports.hasMcpConfig = exports.writePermissions = exports.writeMcpConfig = void 0;
+exports.runInstaller = runInstaller;
+exports.runInstallerWithOptions = runInstallerWithOptions;
+exports.uninstallTargets = uninstallTargets;
+exports.runUninstaller = runUninstaller;
+exports.offerWatchFallback = offerWatchFallback;
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const claude_1 = require("./targets/claude");
+const glyphs_1 = require("../ui/glyphs");
+// Import the lightweight submodules directly (not the ../sync barrel, which
+// re-exports FileWatcher and would transitively pull in ../extraction — the
+// installer must stay importable even when native modules can't load).
+const watch_policy_1 = require("../sync/watch-policy");
+const git_hooks_1 = require("../sync/git-hooks");
+// Backwards-compat: keep these named exports — downstream code may
+// import them. The shim in `config-writer.ts` continues to re-export
+// them too.
+var config_writer_1 = require("./config-writer");
+Object.defineProperty(exports, "writeMcpConfig", { enumerable: true, get: function () { return config_writer_1.writeMcpConfig; } });
+Object.defineProperty(exports, "writePermissions", { enumerable: true, get: function () { return config_writer_1.writePermissions; } });
+Object.defineProperty(exports, "hasMcpConfig", { enumerable: true, get: function () { return config_writer_1.hasMcpConfig; } });
+Object.defineProperty(exports, "hasPermissions", { enumerable: true, get: function () { return config_writer_1.hasPermissions; } });
+// Dynamic import helper — tsc compiles import() to require() in CJS mode,
+// which fails for ESM-only packages. This bypasses the transformation.
+// eslint-disable-next-line @typescript-eslint/no-implied-eval
+const importESM = new Function('specifier', 'return import(specifier)');
+function formatNumber(n) {
+    return n.toLocaleString();
+}
+function getVersion() {
+    try {
+        const packageJsonPath = path.join(__dirname, '..', '..', 'package.json');
+        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+        return packageJson.version;
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/**
+ * Interactive entry — `specship install` with no args runs this.
+ */
+async function runInstaller() {
+    return runInstallerWithOptions({});
+}
+async function runInstallerWithOptions(opts) {
+    const clack = await importESM('@clack/prompts');
+    clack.intro(`SpecShip v${getVersion()}`);
+    const useDefaults = opts.yes === true;
+    // `--target=none` — explicit skip, matches the historical contract.
+    if (opts.target === 'none') {
+        clack.outro('Skipped — no agent configured.');
+        return;
+    }
+    // Any other value is accepted (claude / auto / all / undefined); we
+    // only have one target to write.
+    if (opts.target !== undefined
+        && !['claude', 'auto', 'all'].includes(opts.target)) {
+        throw new Error(`Unknown --target value "${opts.target}". This build is Claude-only; ` +
+            `accepted values are 'claude' (default), 'auto', 'all', or 'none'.`);
+    }
+    // Step 1: install the specship CLI on PATH (always offered; skipped
+    // with --yes since CI assumes it's there).
+    if (!useDefaults) {
+        const shouldInstallGlobally = await clack.confirm({
+            message: 'Install the specship CLI on your PATH? (Required so Claude Code can launch the MCP server)',
+            initialValue: true,
+        });
+        if (clack.isCancel(shouldInstallGlobally)) {
+            clack.cancel('Installation cancelled.');
+            process.exit(0);
+        }
+        if (shouldInstallGlobally) {
+            const s = clack.spinner();
+            s.start('Installing specship CLI...');
+            try {
+                (0, child_process_1.execSync)('npm install -g @selvakumaresra/specship', { stdio: 'pipe', windowsHide: true });
+                s.stop('Installed specship CLI on PATH');
+            }
+            catch {
+                s.stop('Could not install (permission denied)');
+                clack.log.warn('Try: sudo npm install -g @selvakumaresra/specship');
+            }
+        }
+        else {
+            clack.log.info('Skipped CLI install — Claude Code will not be able to launch the MCP server without it');
+        }
+    }
+    // Step 2: global vs local. Default is **local** so the SpecShip MCP
+    // surface (tool list, server instructions) only appears in Claude
+    // Code sessions opened against projects that have actually opted in.
+    // Global is still supported via `--location global`; pick it when you
+    // want the tools advertised in every project regardless.
+    let location;
+    if (opts.location) {
+        location = opts.location;
+    }
+    else if (useDefaults) {
+        location = 'local';
+    }
+    else {
+        const sel = await clack.select({
+            message: 'Apply Claude Code config to just this project, or all of them?',
+            options: [
+                { value: 'local', label: 'Just this project (recommended)', hint: './.mcp.json + ./.claude/settings.json' },
+                { value: 'global', label: 'All projects', hint: '~/.claude.json + ~/.claude/settings.json' },
+            ],
+            initialValue: 'local',
+        });
+        if (clack.isCancel(sel)) {
+            clack.cancel('Installation cancelled.');
+            process.exit(0);
+        }
+        location = sel;
+    }
+    // Step 3: auto-allow permissions.
+    let autoAllow;
+    if (opts.autoAllow !== undefined) {
+        autoAllow = opts.autoAllow;
+    }
+    else if (useDefaults) {
+        autoAllow = true;
+    }
+    else {
+        const ans = await clack.confirm({
+            message: 'Auto-allow SpecShip commands? (Skips permission prompts in Claude Code)',
+            initialValue: true,
+        });
+        if (clack.isCancel(ans)) {
+            clack.cancel('Installation cancelled.');
+            process.exit(0);
+        }
+        autoAllow = ans;
+    }
+    // Step 4: write Claude config. Spec-driven steering is on by default;
+    // only an explicit `sdd: false` (from `--no-sdd`) skips it.
+    const result = claude_1.claudeTarget.install(location, { autoAllow, sdd: opts.sdd });
+    for (const file of result.files) {
+        const verb = file.action === 'unchanged'
+            ? 'Unchanged'
+            : file.action === 'created' ? 'Created'
+                : file.action === 'removed' ? 'Removed'
+                    : 'Updated';
+        clack.log.success(`Claude Code: ${verb} ${tildify(file.path)}`);
+    }
+    for (const note of result.notes ?? []) {
+        clack.log.info(`Claude Code: ${note}`);
+    }
+    // Step 5: for local install, initialize the project.
+    if (location === 'local') {
+        await initializeLocalProject(clack, useDefaults);
+    }
+    if (location === 'global') {
+        clack.note('cd your-project\nspecship init -i', 'Quick start');
+    }
+    clack.outro('Done! Restart Claude Code to use SpecShip.');
+}
+/**
+ * Pure uninstall sweep — no prompts. Exposed (and unit-tested)
+ * separately from the clack UI so the aggregation logic can be
+ * asserted directly. Safe to call when nothing was installed (target
+ * uninstall returns `not-found` actions).
+ */
+function uninstallTargets(targets, location) {
+    return targets.map((target) => {
+        if (!target.supportsLocation(location)) {
+            const only = location === 'local' ? 'global' : 'local';
+            return {
+                id: target.id,
+                displayName: target.displayName,
+                status: 'unsupported',
+                removedPaths: [],
+                notes: [`no ${location} config — this agent is ${only}-only`],
+            };
+        }
+        const result = target.uninstall(location);
+        const removedPaths = result.files
+            .filter((f) => f.action === 'removed')
+            .map((f) => f.path);
+        return {
+            id: target.id,
+            displayName: target.displayName,
+            status: removedPaths.length > 0 ? 'removed' : 'not-configured',
+            removedPaths,
+            notes: result.notes ?? [],
+        };
+    });
+}
+/**
+ * Interactive uninstaller — the inverse of `runInstallerWithOptions`.
+ * Asks global-vs-local, then sweeps Claude Code's config at that
+ * location. Removes only what install wrote (MCP server entry,
+ * permissions) — never the `.specship/` index, which `specship
+ * uninit` owns.
+ */
+async function runUninstaller(opts) {
+    const clack = await importESM('@clack/prompts');
+    clack.intro(`SpecShip v${getVersion()} — uninstall`);
+    const useDefaults = opts.yes === true;
+    if (opts.target === 'none') {
+        clack.outro('Skipped — nothing to uninstall.');
+        return;
+    }
+    if (opts.target !== undefined
+        && !['claude', 'auto', 'all'].includes(opts.target)) {
+        throw new Error(`Unknown --target value "${opts.target}". This build is Claude-only; ` +
+            `accepted values are 'claude' (default), 'auto', 'all', or 'none'.`);
+    }
+    // Step 1: location. Default tracks install (now local), so a user
+    // who ran `specship install --yes` and `specship uninstall --yes`
+    // touches the same files on both sides.
+    let location;
+    if (opts.location) {
+        location = opts.location;
+    }
+    else if (useDefaults) {
+        location = 'local';
+    }
+    else {
+        const sel = await clack.select({
+            message: 'Remove SpecShip from just this project, or all of them?',
+            options: [
+                { value: 'local', label: 'Just this project (local)', hint: './.mcp.json + ./.claude/settings.json' },
+                { value: 'global', label: 'All projects (global)', hint: '~/.claude.json + ~/.claude/settings.json' },
+            ],
+            initialValue: 'local',
+        });
+        if (clack.isCancel(sel)) {
+            clack.cancel('Uninstall cancelled.');
+            process.exit(0);
+        }
+        location = sel;
+    }
+    // Step 2: sweep + feedback. uninstallTargets always returns one
+    // report per input target — the non-null assertion is safe.
+    const report = uninstallTargets([claude_1.claudeTarget], location)[0];
+    if (report.status === 'removed') {
+        for (const p of report.removedPaths) {
+            clack.log.success(`Claude Code: removed ${tildify(p)}`);
+        }
+    }
+    else if (report.status === 'not-configured') {
+        clack.log.info(`Claude Code: not configured — nothing to remove`);
+    }
+    else {
+        clack.log.info(`Claude Code: skipped — ${report.notes[0] ?? 'unsupported location'}`);
+    }
+    // Step 3: for local uninstall, the index dir is separate.
+    if (location === 'local' && fs.existsSync(path.join(process.cwd(), '.specship'))) {
+        clack.log.info('The .specship/ index for this project is still here. Run `specship uninit` to delete it.');
+    }
+    // Step 4: summary.
+    if (report.status === 'removed') {
+        clack.outro('Removed SpecShip from Claude Code. Restart it to apply.');
+    }
+    else {
+        clack.outro(`SpecShip was not configured in Claude Code at the ${location} location — nothing to remove.`);
+    }
+}
+/**
+ * Replace home-directory prefix in a path with `~/` for cleaner log
+ * lines. Pure cosmetic.
+ */
+function tildify(p) {
+    const home = require('os').homedir();
+    if (p.startsWith(home + path.sep))
+        return '~' + p.substring(home.length);
+    return p;
+}
+/**
+ * Initialize SpecShip in the current project (for local installs), then
+ * offer the watch fallback when the live watcher won't run here (see
+ * offerWatchFallback).
+ */
+async function initializeLocalProject(clack, useDefaults = false) {
+    const projectPath = process.cwd();
+    let SpecShip;
+    try {
+        SpecShip = (await Promise.resolve().then(() => __importStar(require('../index')))).default;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        clack.log.error(`Could not load native modules: ${msg}`);
+        clack.log.info('Skipping project initialization. Run "specship init -i" later.');
+        return;
+    }
+    // Check if already initialized
+    if (SpecShip.isInitialized(projectPath)) {
+        clack.log.info('SpecShip already initialized in this project');
+        await offerWatchFallback(clack, projectPath, { yes: useDefaults });
+        return;
+    }
+    // Initialize
+    const cg = await SpecShip.init(projectPath);
+    clack.log.success('Created .specship/ directory');
+    // Index the project with shimmer progress (worker thread for smooth animation)
+    const { createShimmerProgress } = await Promise.resolve().then(() => __importStar(require('../ui/shimmer-progress')));
+    process.stdout.write(`\x1b[2m${(0, glyphs_1.getGlyphs)().rail}\x1b[0m\n`);
+    const progress = createShimmerProgress();
+    const result = await cg.indexAll({
+        onProgress: progress.onProgress,
+    });
+    await progress.stop();
+    if (result.filesErrored > 0) {
+        clack.log.success(`Indexed ${formatNumber(result.filesIndexed)} files (${formatNumber(result.filesErrored)} failed, ${formatNumber(result.nodesCreated)} symbols)`);
+    }
+    else {
+        clack.log.success(`Indexed ${formatNumber(result.filesIndexed)} files (${formatNumber(result.nodesCreated)} symbols)`);
+    }
+    cg.close();
+    await offerWatchFallback(clack, projectPath, { yes: useDefaults });
+}
+/**
+ * When the live file watcher will be disabled for this project (e.g. WSL2
+ * /mnt drives, or SPECSHIP_NO_WATCH), the index would silently go stale.
+ * Offer to keep it fresh automatically via git hooks instead of manual
+ * `specship sync`. No-op on environments where the watcher runs normally.
+ */
+async function offerWatchFallback(clack, projectPath, opts = {}) {
+    const reason = (0, watch_policy_1.watchDisabledReason)(projectPath);
+    if (!reason)
+        return; // Watcher runs normally — nothing to set up.
+    clack.log.warn(`Live file watching is disabled here — ${reason}.`);
+    clack.log.info('Until you re-sync, the SpecShip index stays frozen — it will not pick up edits on its own.');
+    // No git repo → the commit-hook path doesn't apply; point at manual sync.
+    if (!(0, git_hooks_1.isGitRepo)(projectPath)) {
+        clack.log.info('Run `specship sync` after changing files to refresh the index.');
+        return;
+    }
+    // Already wired up on a previous run — confirm and move on without nagging.
+    if ((0, git_hooks_1.isSyncHookInstalled)(projectPath)) {
+        clack.log.info('Git sync hooks are already installed — the index refreshes after commit / pull / checkout.');
+        return;
+    }
+    let choice;
+    if (opts.yes) {
+        choice = 'hook';
+    }
+    else {
+        const sel = await clack.select({
+            message: 'How should SpecShip keep its index fresh?',
+            options: [
+                { value: 'hook', label: 'Sync on git commit / pull / checkout', hint: 'installs git hooks (recommended)' },
+                { value: 'manual', label: 'I\'ll run `specship sync` myself', hint: 'fully manual' },
+            ],
+            initialValue: 'hook',
+        });
+        if (clack.isCancel(sel)) {
+            clack.log.info('Skipped — run `specship sync` after changes to refresh the index.');
+            return;
+        }
+        choice = sel;
+    }
+    if (choice === 'manual') {
+        clack.log.info('Run `specship sync` after changing files to refresh the index.');
+        return;
+    }
+    const result = (0, git_hooks_1.installGitSyncHook)(projectPath);
+    if (result.installed.length > 0) {
+        clack.log.success(`Installed git ${result.installed.join(', ')} hook${result.installed.length > 1 ? 's' : ''} — ` +
+            'the index refreshes in the background after each.');
+        clack.log.info('Run `specship sync` anytime to refresh immediately.');
+    }
+    else {
+        clack.log.warn(`Could not install git hooks${result.skipped ? ` (${result.skipped})` : ''}. ` +
+            'Run `specship sync` after changes instead.');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/installer/index.js.map

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

package/dist/installer/instructions-template.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Marker constants for the legacy agent-instructions block.
+ *
+ * Specship used to write a `## SpecShip` usage guide into each
+ * agent's instructions file (CLAUDE.md / AGENTS.md / GEMINI.md /
+ * specship.mdc / Kiro steering doc). That duplicated the guidance the
+ * MCP server already emits in its `initialize` response — every agent
+ * read the same playbook twice each turn (issue #529). The installer no
+ * longer writes an instructions file; the MCP server instructions in
+ * `mcp/server-instructions.ts` are the single source of truth.
+ *
+ * These markers are retained so install (self-heal on upgrade) and
+ * uninstall can find and strip the block a previous install wrote.
+ */
+/** Markers used by the marker-based section removal. */
+export declare const SPECSHIP_SECTION_START = "<!-- SPECSHIP_START -->";
+export declare const SPECSHIP_SECTION_END = "<!-- SPECSHIP_END -->";
+/**
+ * Markers for the spec-driven-development steering block (SDD-INSTALL-DOC).
+ *
+ * DISTINCT from the legacy `SPECSHIP_START/END` pair on purpose: this block is
+ * a tiny ordering RULE, not the MCP tool playbook that #529 removed. Keeping
+ * its own markers lets install/uninstall manage it independently and never
+ * resurrects the duplicated-instructions problem.
+ */
+export declare const SPECSHIP_SDD_SECTION_START = "<!-- SPECSHIP_SDD_START -->";
+export declare const SPECSHIP_SDD_SECTION_END = "<!-- SPECSHIP_SDD_END -->";
+/**
+ * The spec-driven-development steering rule written into the project CLAUDE.md.
+ * A repo's CLAUDE.md takes precedence over a skill's own description, so this
+ * deterministically flips feature/bug work to spec-author-first. Kept to the
+ * ordering rule only — it MUST NOT duplicate the MCP server instructions.
+ */
+export declare function getSddRuleBlock(): string;
+//# sourceMappingURL=instructions-template.d.ts.map

package/dist/installer/instructions-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions-template.d.ts","sourceRoot":"","sources":["../../src/installer/instructions-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,wDAAwD;AACxD,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAChE,eAAO,MAAM,oBAAoB,0BAA0B,CAAC;AAE5D;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,gCAAgC,CAAC;AACxE,eAAO,MAAM,wBAAwB,8BAA8B,CAAC;AAEpE;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAYxC"}

package/dist/installer/instructions-template.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Marker constants for the legacy agent-instructions block.
+ *
+ * Specship used to write a `## SpecShip` usage guide into each
+ * agent's instructions file (CLAUDE.md / AGENTS.md / GEMINI.md /
+ * specship.mdc / Kiro steering doc). That duplicated the guidance the
+ * MCP server already emits in its `initialize` response — every agent
+ * read the same playbook twice each turn (issue #529). The installer no
+ * longer writes an instructions file; the MCP server instructions in
+ * `mcp/server-instructions.ts` are the single source of truth.
+ *
+ * These markers are retained so install (self-heal on upgrade) and
+ * uninstall can find and strip the block a previous install wrote.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SPECSHIP_SDD_SECTION_END = exports.SPECSHIP_SDD_SECTION_START = exports.SPECSHIP_SECTION_END = exports.SPECSHIP_SECTION_START = void 0;
+exports.getSddRuleBlock = getSddRuleBlock;
+/** Markers used by the marker-based section removal. */
+exports.SPECSHIP_SECTION_START = '<!-- SPECSHIP_START -->';
+exports.SPECSHIP_SECTION_END = '<!-- SPECSHIP_END -->';
+/**
+ * Markers for the spec-driven-development steering block (SDD-INSTALL-DOC).
+ *
+ * DISTINCT from the legacy `SPECSHIP_START/END` pair on purpose: this block is
+ * a tiny ordering RULE, not the MCP tool playbook that #529 removed. Keeping
+ * its own markers lets install/uninstall manage it independently and never
+ * resurrects the duplicated-instructions problem.
+ */
+exports.SPECSHIP_SDD_SECTION_START = '<!-- SPECSHIP_SDD_START -->';
+exports.SPECSHIP_SDD_SECTION_END = '<!-- SPECSHIP_SDD_END -->';
+/**
+ * The spec-driven-development steering rule written into the project CLAUDE.md.
+ * A repo's CLAUDE.md takes precedence over a skill's own description, so this
+ * deterministically flips feature/bug work to spec-author-first. Kept to the
+ * ordering rule only — it MUST NOT duplicate the MCP server instructions.
+ */
+function getSddRuleBlock() {
+    return [
+        exports.SPECSHIP_SDD_SECTION_START,
+        '## Spec-driven development (SpecShip)',
+        '',
+        "For feature or bug work in this repo, FIRST invoke SpecShip's **spec-author**",
+        'to author the spec under `specs/` — before any brainstorming or planning skill.',
+        'Spec-driven development is canonical here: the spec is the contract, and the',
+        'implementation follows from it (`/ss-implement`). This rule intentionally takes',
+        "precedence over a skill's own \"use me first\" guidance.",
+        exports.SPECSHIP_SDD_SECTION_END,
+    ].join('\n');
+}
+//# sourceMappingURL=instructions-template.js.map

package/dist/installer/instructions-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions-template.js","sourceRoot":"","sources":["../../src/installer/instructions-template.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAuBH,0CAYC;AAjCD,wDAAwD;AAC3C,QAAA,sBAAsB,GAAG,yBAAyB,CAAC;AACnD,QAAA,oBAAoB,GAAG,uBAAuB,CAAC;AAE5D;;;;;;;GAOG;AACU,QAAA,0BAA0B,GAAG,6BAA6B,CAAC;AAC3D,QAAA,wBAAwB,GAAG,2BAA2B,CAAC;AAEpE;;;;;GAKG;AACH,SAAgB,eAAe;IAC7B,OAAO;QACL,kCAA0B;QAC1B,uCAAuC;QACvC,EAAE;QACF,+EAA+E;QAC/E,iFAAiF;QACjF,8EAA8E;QAC9E,iFAAiF;QACjF,0DAA0D;QAC1D,gCAAwB;KACzB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/installer/targets/claude.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Claude Code target. Writes:
+ *
+ *   - MCP server entry to `~/.claude.json` (global = user scope, loads
+ *     in every project) or `./.mcp.json` (local = project scope, the
+ *     file Claude Code actually reads for a single project). See the
+ *     scope table at https://code.claude.com/docs/en/mcp.
+ *   - Permissions to `~/.claude/settings.json` (global) or
+ *     `./.claude/settings.json` (local), gated on `autoAllow`.
+ *   - Instructions to `~/.claude/CLAUDE.md` (global) or
+ *     `./.claude/CLAUDE.md` (local).
+ *
+ * Earlier versions wrote the local MCP entry to `./.claude.json` — a
+ * file Claude Code never reads — so the server silently never loaded
+ * until the user manually renamed it to `.mcp.json` (issue #207). We
+ * now write `./.mcp.json` and migrate any stale `./.claude.json` entry
+ * out of the way on install and uninstall.
+ */
+import { AgentTarget, Location, WriteResult } from './types';
+/**
+ * Per-file write helpers, exported so the legacy `config-writer.ts`
+ * shim can call only the named operation (writeMcpConfig writes ONLY
+ * the MCP entry, etc.) instead of `claudeTarget.install()` which
+ * writes all three files. Without this split the shims silently
+ * cause side effects callers don't expect.
+ */
+export declare function writeMcpEntry(loc: Location): WriteResult['files'][number];
+/**
+ * Remove stale **pre-0.8** specship auto-sync hooks
+ * (`specship mark-dirty` / `specship sync-if-dirty`) from Claude
+ * `settings.json`. Safe to call from both `install` (self-heal on
+ * upgrade) and `uninstall`. Exported so it can be unit-tested directly.
+ */
+export declare function cleanupLegacyHooks(loc: Location): WriteResult['files'][number];
+/**
+ * Remove the current-release auto-sync hooks (`specship sync --quiet`)
+ * written by `writeHooksEntry`. Uninstall-only — install would
+ * destroy its own write if this ran there.
+ */
+export declare function cleanupCurrentHooks(loc: Location): WriteResult['files'][number];
+export declare function writePermissionsEntry(loc: Location): WriteResult['files'][number];
+/**
+ * Strip the marker-delimited SpecShip block from CLAUDE.md if a prior
+ * install wrote one. Specship no longer maintains an instructions file
+ * (issue #529) — the MCP server's `initialize` instructions are the
+ * single source of truth — so both install (self-heal on upgrade) and
+ * uninstall call this. `removeMarkedSection` returns `not-found`/`kept`
+ * when there's nothing to strip; the install caller drops those from
+ * the report so a fresh install stays quiet.
+ */
+export declare function removeInstructionsEntry(loc: Location): WriteResult['files'][number];
+/**
+ * Write specship's auto-sync hooks into Claude `settings.json`. Merges
+ * idempotently into any user-defined hooks: a matcher group sharing our
+ * exact matcher string is reused; sibling matchers / events / events are
+ * untouched. Returns `unchanged` when our two hook commands are already
+ * present byte-for-byte in the right places.
+ *
+ * Gated by `install()` on `autoAllow` — same posture as the permissions
+ * list. The matching uninstall lives in `cleanupLegacyHooks` (whose
+ * matcher predicate covers BOTH the new `specship sync --quiet` form
+ * and the legacy `specship mark-dirty`/`sync-if-dirty` forms).
+ */
+export declare function writeHooksEntry(loc: Location): WriteResult['files'][number];
+/**
+ * Write the spec-driven-development UserPromptSubmit nudge hook into
+ * `settings.json` (SDD-INSTALL-DOC, REQ-SDD-002). Same idempotent merge as
+ * the auto-sync hooks; gated by `install()` on `opts.sdd` rather than
+ * `autoAllow`, since it's part of the SDD steering feature.
+ */
+export declare function writeSddHookEntry(loc: Location): WriteResult['files'][number];
+/** Remove the SDD nudge hook written by `writeSddHookEntry`. Uninstall-only. */
+export declare function cleanupSddHooks(loc: Location): WriteResult['files'][number];
+/**
+ * Write the spec-driven-development steering rule into the project CLAUDE.md
+ * (SDD-INSTALL-DOC, REQ-SDD-001). Idempotent + marker-delimited so the user's
+ * surrounding content is untouched and a re-run reports `unchanged`. Distinct
+ * markers from the legacy #529 block — this is the ordering rule, not the MCP
+ * playbook.
+ */
+export declare function writeSddInstructionsEntry(loc: Location): WriteResult['files'][number];
+/** Inverse of `writeSddInstructionsEntry`: strip the SDD rule block. */
+export declare function removeSddInstructionsEntry(loc: Location): WriteResult['files'][number];
+/**
+ * Copy our shipped slash commands (commands/ss-*.md) into the user's
+ * commands dir (~/.claude/commands/ globally, ./.claude/commands/
+ * locally). Per-file idempotent: a destination with identical bytes is
+ * reported `unchanged`. Sibling user-written .md files in the same dir
+ * are never touched.
+ */
+export declare function writeCommandsEntries(loc: Location): WriteResult['files'];
+/**
+ * Remove legacy `cg-*.md` slash commands left behind by a pre-v0.2
+ * installer. Called from `install()` so an upgrade self-heals (the user
+ * doesn't end up with both prefixes side-by-side cluttering their
+ * autocomplete) and from `uninstall()` so the legacy files don't
+ * persist after specship is removed. Sibling user-written .md files
+ * in the same dir are never touched — only the exact filenames in
+ * LEGACY_SHIPPED_COMMANDS are candidates.
+ */
+export declare function cleanupLegacyCommandsEntries(loc: Location): WriteResult['files'];
+/**
+ * Copy our shipped subagent (agents/specship-explorer.md) into the
+ * user's agents dir. Same idempotency contract as writeCommandsEntries.
+ */
+export declare function writeAgentsEntries(loc: Location): WriteResult['files'];
+/**
+ * Inverse of writeCommandsEntries: delete each cg-*.md we shipped, if
+ * present. A file the user replaced with their own content is still
+ * removed — match the existing uninstall posture for files specship
+ * owns (the user can re-add their version after).
+ */
+export declare function removeCommandsEntries(loc: Location): WriteResult['files'];
+/** Inverse of writeAgentsEntries. */
+export declare function removeAgentsEntries(loc: Location): WriteResult['files'];
+export declare const claudeTarget: AgentTarget;
+//# sourceMappingURL=claude.d.ts.map

package/dist/installer/targets/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/installer/targets/claude.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,EACL,WAAW,EAGX,QAAQ,EACR,WAAW,EACZ,MAAM,SAAS,CAAC;AA2VjB;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAsBzE;AAgHD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAE9E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAE/E;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAoBjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAInF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAE7E;AAqDD,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAIrF;AAED,wEAAwE;AACxE,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAItF;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAExE;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAOhF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAEzE;AAED,qCAAqC;AACrC,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAEvE;AAsBD,eAAO,MAAM,YAAY,EAAE,WAAoC,CAAC"}