@specship/specship 0.11.0

package/dist/installer/index.js

@@ -0,0 +1,442 @@
+"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 3b: status-line segment (SHIP-STATUSLINE-DOC). Strictly opt-in. Only
+    // offered when no status line is configured; if one already exists we never
+    // touch it and instead show the composable snippet. `--statusline` /
+    // `--no-statusline` skip the prompt; `--yes` leaves it off (opt-in default).
+    let installStatusLine = false;
+    if (opts.statusLine !== undefined) {
+        installStatusLine = opts.statusLine;
+    }
+    else if (!useDefaults) {
+        const state = (0, claude_1.statusLineState)(location);
+        if (state === 'foreign') {
+            clack.note((0, claude_1.getStatusLineSnippet)(), 'You already have a status line — add SpecShip to it');
+        }
+        else {
+            const ans = await clack.confirm({
+                message: 'Add a SpecShip status-line segment? (shows index sync state, drift, and calls this session)',
+                initialValue: false,
+            });
+            if (clack.isCancel(ans)) {
+                clack.cancel('Installation cancelled.');
+                process.exit(0);
+            }
+            installStatusLine = ans;
+        }
+    }
+    // Step 4: write Claude config. The governance tier is opt-in
+    // (INSTALL-WEDGE-DOC): only an explicit `sdd: true` (from `--sdd`) installs it;
+    // a default install provisions the retrieval tier alone.
+    const result = claude_1.claudeTarget.install(location, { autoAllow, sdd: opts.sdd, installStatusLine });
+    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/init-offer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Install-time "index the current project?" decision (REQ-HANDSHAKE-004).
+ *
+ * `specship install` run inside an un-indexed git repo offers to build that
+ * project's index in the same breath, so the user's first project is activated
+ * without a separate, forgettable `init` step. It never silently auto-indexes,
+ * and it never offers a re-index for an already-indexed project.
+ */
+export type InstallInitDecision = 
+/** Do nothing (already indexed, not a project, or an explicit opt-out). */
+'skip'
+/** Ask the user interactively whether to build the index. */
+ | 'offer'
+/** Build the index without prompting (the non-interactive `--yes` default). */
+ | 'auto-index';
+export interface InstallInitContext {
+    /** Is the install running inside a git repository? */
+    isGitRepo: boolean;
+    /** Does the project already have a `.specship/` index? */
+    isInitialized: boolean;
+    /** Was `--yes` (non-interactive) passed? */
+    yes: boolean;
+    /** Was `--skip-index` passed? */
+    skipIndex: boolean;
+}
+/**
+ * Decide whether install should index the current project. Pure so the policy
+ * is unit-tested independently of the prompt + indexing glue.
+ */
+export declare function decideInstallInit(ctx: InstallInitContext): InstallInitDecision;
+//# sourceMappingURL=init-offer.d.ts.map

package/dist/installer/init-offer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-offer.d.ts","sourceRoot":"","sources":["../../src/installer/init-offer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,mBAAmB;AAC7B,2EAA2E;AACzE,MAAM;AACR,6DAA6D;GAC3D,OAAO;AACT,+EAA+E;GAC7E,YAAY,CAAC;AAEjB,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,aAAa,EAAE,OAAO,CAAC;IACvB,4CAA4C;IAC5C,GAAG,EAAE,OAAO,CAAC;IACb,iCAAiC;IACjC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,kBAAkB,GAAG,mBAAmB,CAU9E"}

package/dist/installer/init-offer.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Install-time "index the current project?" decision (REQ-HANDSHAKE-004).
+ *
+ * `specship install` run inside an un-indexed git repo offers to build that
+ * project's index in the same breath, so the user's first project is activated
+ * without a separate, forgettable `init` step. It never silently auto-indexes,
+ * and it never offers a re-index for an already-indexed project.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decideInstallInit = decideInstallInit;
+/**
+ * Decide whether install should index the current project. Pure so the policy
+ * is unit-tested independently of the prompt + indexing glue.
+ */
+function decideInstallInit(ctx) {
+    // An explicit opt-out wins in any mode — "do not index" means don't even ask.
+    if (ctx.skipIndex)
+        return 'skip';
+    // Already activated: refreshing is `sync`/`index`'s job, not the install prompt.
+    if (ctx.isInitialized)
+        return 'skip';
+    // Only offer inside an actual project.
+    if (!ctx.isGitRepo)
+        return 'skip';
+    // Inside an un-indexed git repo: index by default under --yes (activation is
+    // the priority), otherwise ask.
+    return ctx.yes ? 'auto-index' : 'offer';
+}
+//# sourceMappingURL=init-offer.js.map

package/dist/installer/init-offer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-offer.js","sourceRoot":"","sources":["../../src/installer/init-offer.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAyBH,8CAUC;AAdD;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,GAAuB;IACvD,8EAA8E;IAC9E,IAAI,GAAG,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC;IACjC,iFAAiF;IACjF,IAAI,GAAG,CAAC,aAAa;QAAE,OAAO,MAAM,CAAC;IACrC,uCAAuC;IACvC,IAAI,CAAC,GAAG,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC;IAClC,6EAA6E;IAC7E,gCAAgC;IAChC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC;AAC1C,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * 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 rules written into the project CLAUDE.md.
+ * A repo's CLAUDE.md takes precedence over a skill's own description, so these
+ * deterministically flip feature/bug work to spec-author-first, and steer
+ * claude.ai/design links to the design loop. Kept to ordering rules only — they
+ * 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;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAiBxC"}

package/dist/installer/instructions-template.js

@@ -0,0 +1,57 @@
+"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 rules written into the project CLAUDE.md.
+ * A repo's CLAUDE.md takes precedence over a skill's own description, so these
+ * deterministically flip feature/bug work to spec-author-first, and steer
+ * claude.ai/design links to the design loop. Kept to ordering rules only — they
+ * 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-spec implement`). This rule intentionally takes',
+        "precedence over a skill's own \"use me first\" guidance.",
+        '',
+        'When the user shares a **claude.ai/design** link (or references a Claude Design',
+        'project), recommend **`/ss-design-loop`** first and get explicit confirmation',
+        'before proceeding — even mid spec-author. That is the design→code path: taste',
+        'the design with the user → snapshot → spec → review → `/ss-spec implement`.',
+        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;;;AAwBH,0CAiBC;AAvCD,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;;;;;;GAMG;AACH,SAAgB,eAAe;IAC7B,OAAO;QACL,kCAA0B;QAC1B,uCAAuC;QACvC,EAAE;QACF,+EAA+E;QAC/E,iFAAiF;QACjF,8EAA8E;QAC9E,sFAAsF;QACtF,0DAA0D;QAC1D,EAAE;QACF,iFAAiF;QACjF,+EAA+E;QAC/E,+EAA+E;QAC/E,6EAA6E;QAC7E,gCAAwB;KACzB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}