@selvakumaresra/specship 0.1.3 → 0.3.0

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

@@ -0,0 +1,19 @@
+/**
+ * Registry of supported agent targets.
+ *
+ * Currently Claude-only. The interface is preserved so re-adding another
+ * agent is one new file in `targets/` plus one entry below.
+ */
+import { AgentTarget, Location, TargetId } from './types';
+export declare const ALL_TARGETS: readonly AgentTarget[];
+export declare function getTarget(id: string): AgentTarget | undefined;
+export declare function listTargetIds(): TargetId[];
+/**
+ * Run `detect()` for every target at the given location. Returns the
+ * registry zipped with detection results.
+ */
+export declare function detectAll(loc: Location): Array<{
+    target: AgentTarget;
+    detection: ReturnType<AgentTarget['detect']>;
+}>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/installer/targets/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG1D,eAAO,MAAM,WAAW,EAAE,SAAS,WAAW,EAAkC,CAAC;AAEjF,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE7D;AAED,wBAAgB,aAAa,IAAI,QAAQ,EAAE,CAE1C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC9C,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC9C,CAAC,CAKD"}

package/dist/installer/targets/registry.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Registry of supported agent targets.
+ *
+ * Currently Claude-only. The interface is preserved so re-adding another
+ * agent is one new file in `targets/` plus one entry below.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_TARGETS = void 0;
+exports.getTarget = getTarget;
+exports.listTargetIds = listTargetIds;
+exports.detectAll = detectAll;
+const claude_1 = require("./claude");
+exports.ALL_TARGETS = Object.freeze([claude_1.claudeTarget]);
+function getTarget(id) {
+    return exports.ALL_TARGETS.find((t) => t.id === id);
+}
+function listTargetIds() {
+    return exports.ALL_TARGETS.map((t) => t.id);
+}
+/**
+ * Run `detect()` for every target at the given location. Returns the
+ * registry zipped with detection results.
+ */
+function detectAll(loc) {
+    return exports.ALL_TARGETS.map((target) => ({
+        target,
+        detection: target.detect(loc),
+    }));
+}
+//# sourceMappingURL=registry.js.map

package/dist/installer/targets/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/installer/targets/registry.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAOH,8BAEC;AAED,sCAEC;AAMD,8BAQC;AAxBD,qCAAwC;AAE3B,QAAA,WAAW,GAA2B,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAY,CAAC,CAAC,CAAC;AAEjF,SAAgB,SAAS,CAAC,EAAU;IAClC,OAAO,mBAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,SAAgB,aAAa;IAC3B,OAAO,mBAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,SAAgB,SAAS,CAAC,GAAa;IAIrC,OAAO,mBAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClC,MAAM;QACN,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;KAC9B,CAAC,CAAC,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,62 @@
+/**
+ * Helpers used by the Claude target implementation.
+ *
+ * Historically these were shared across multiple `AgentTarget`
+ * implementations (Cursor, Codex, opencode, …); the fork is
+ * Claude-only now, but the helpers are kept in their own file so the
+ * Claude target stays focused on Claude-specific layout.
+ */
+/**
+ * The MCP-server config block specship injects into Claude's MCP
+ * config (`~/.claude.json` or `./.mcp.json`).
+ */
+export declare function getMcpServerConfig(): {
+    type: string;
+    command: string;
+    args: string[];
+};
+/**
+ * Permissions list for Claude `settings.json`. Permission strings
+ * follow Claude's `mcp__<server>__<tool>` format.
+ */
+export declare function getSpecShipPermissions(): string[];
+/**
+ * Read a JSON file, returning `{}` when missing or unparseable.
+ *
+ * Unparseable files are backed up to `<path>.backup` BEFORE we return
+ * `{}` — so an idempotent re-run never silently deletes a user's
+ * existing config that happened to break JSON parse temporarily.
+ */
+export declare function readJsonFile(filePath: string): Record<string, any>;
+/**
+ * Write a file atomically: write to `<path>.tmp.<pid>`, then rename.
+ *
+ * Prevents corruption if the process crashes mid-write. The temp
+ * file is cleaned up on rename failure.
+ */
+export declare function atomicWriteFileSync(filePath: string, content: string): void;
+/**
+ * Atomic JSON write. Trailing newline matches the convention every
+ * existing target had — preserves diff-friendly file shape.
+ */
+export declare function writeJsonFile(filePath: string, data: Record<string, any>): void;
+/**
+ * Compare two JSON values for deep equality, ignoring key order.
+ *
+ * Used for idempotency: when the on-disk config already exactly
+ * matches what we'd write, return action=`unchanged` instead of
+ * re-writing (and emitting a confusing "Updated" log line).
+ */
+export declare function jsonDeepEqual(a: unknown, b: unknown): boolean;
+/**
+ * Strip a marker-delimited section from a markdown-ish file. Used by
+ * the Claude target's uninstall to remove a legacy `## SpecShip` block
+ * a pre-#529 install wrote into CLAUDE.md (between
+ * `<!-- SPECSHIP_START -->` / `<!-- SPECSHIP_END -->`). If the file
+ * becomes empty after removal, delete it.
+ *
+ * Returns `removed` when content was stripped, `not-found` when
+ * the markers weren't present, `kept` when the file didn't exist.
+ */
+export declare function removeMarkedSection(filePath: string, startMarker: string, endMarker: string): 'removed' | 'not-found' | 'kept';
+//# sourceMappingURL=shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/installer/targets/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAMtF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAWjD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAelE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAa3E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAE/E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAiB7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,SAAS,GAAG,WAAW,GAAG,MAAM,CAwBlC"}

package/dist/installer/targets/shared.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * Helpers used by the Claude target implementation.
+ *
+ * Historically these were shared across multiple `AgentTarget`
+ * implementations (Cursor, Codex, opencode, …); the fork is
+ * Claude-only now, but the helpers are kept in their own file so the
+ * Claude target stays focused on Claude-specific layout.
+ */
+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.getMcpServerConfig = getMcpServerConfig;
+exports.getSpecShipPermissions = getSpecShipPermissions;
+exports.readJsonFile = readJsonFile;
+exports.atomicWriteFileSync = atomicWriteFileSync;
+exports.writeJsonFile = writeJsonFile;
+exports.jsonDeepEqual = jsonDeepEqual;
+exports.removeMarkedSection = removeMarkedSection;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * The MCP-server config block specship injects into Claude's MCP
+ * config (`~/.claude.json` or `./.mcp.json`).
+ */
+function getMcpServerConfig() {
+    return {
+        type: 'stdio',
+        command: 'specship',
+        args: ['serve', '--mcp'],
+    };
+}
+/**
+ * Permissions list for Claude `settings.json`. Permission strings
+ * follow Claude's `mcp__<server>__<tool>` format.
+ */
+function getSpecShipPermissions() {
+    return [
+        'mcp__specship__specship_explore',
+        'mcp__specship__specship_search',
+        'mcp__specship__specship_node',
+        'mcp__specship__specship_callers',
+        'mcp__specship__specship_callees',
+        'mcp__specship__specship_impact',
+        'mcp__specship__specship_files',
+        'mcp__specship__specship_status',
+    ];
+}
+/**
+ * Read a JSON file, returning `{}` when missing or unparseable.
+ *
+ * Unparseable files are backed up to `<path>.backup` BEFORE we return
+ * `{}` — so an idempotent re-run never silently deletes a user's
+ * existing config that happened to break JSON parse temporarily.
+ */
+function readJsonFile(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return {};
+    }
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.warn(`  Warning: Could not parse ${path.basename(filePath)}: ${msg}`);
+        console.warn(`  A backup will be created before overwriting.`);
+        try {
+            fs.copyFileSync(filePath, filePath + '.backup');
+        }
+        catch { /* ignore backup failure */ }
+        return {};
+    }
+}
+/**
+ * Write a file atomically: write to `<path>.tmp.<pid>`, then rename.
+ *
+ * Prevents corruption if the process crashes mid-write. The temp
+ * file is cleaned up on rename failure.
+ */
+function atomicWriteFileSync(filePath, content) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const tmpPath = filePath + '.tmp.' + process.pid;
+    try {
+        fs.writeFileSync(tmpPath, content);
+        fs.renameSync(tmpPath, filePath);
+    }
+    catch (err) {
+        try {
+            fs.unlinkSync(tmpPath);
+        }
+        catch { /* ignore */ }
+        throw err;
+    }
+}
+/**
+ * Atomic JSON write. Trailing newline matches the convention every
+ * existing target had — preserves diff-friendly file shape.
+ */
+function writeJsonFile(filePath, data) {
+    atomicWriteFileSync(filePath, JSON.stringify(data, null, 2) + '\n');
+}
+/**
+ * Compare two JSON values for deep equality, ignoring key order.
+ *
+ * Used for idempotency: when the on-disk config already exactly
+ * matches what we'd write, return action=`unchanged` instead of
+ * re-writing (and emitting a confusing "Updated" log line).
+ */
+function jsonDeepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== typeof b)
+        return false;
+    if (a === null || b === null)
+        return a === b;
+    if (typeof a !== 'object')
+        return false;
+    if (Array.isArray(a) !== Array.isArray(b))
+        return false;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length)
+            return false;
+        return a.every((v, i) => jsonDeepEqual(v, b[i]));
+    }
+    const ao = a;
+    const bo = b;
+    const ak = Object.keys(ao).sort();
+    const bk = Object.keys(bo).sort();
+    if (ak.length !== bk.length)
+        return false;
+    if (!ak.every((k, i) => k === bk[i]))
+        return false;
+    return ak.every((k) => jsonDeepEqual(ao[k], bo[k]));
+}
+/**
+ * Strip a marker-delimited section from a markdown-ish file. Used by
+ * the Claude target's uninstall to remove a legacy `## SpecShip` block
+ * a pre-#529 install wrote into CLAUDE.md (between
+ * `<!-- SPECSHIP_START -->` / `<!-- SPECSHIP_END -->`). If the file
+ * becomes empty after removal, delete it.
+ *
+ * Returns `removed` when content was stripped, `not-found` when
+ * the markers weren't present, `kept` when the file didn't exist.
+ */
+function removeMarkedSection(filePath, startMarker, endMarker) {
+    if (!fs.existsSync(filePath))
+        return 'kept';
+    let content;
+    try {
+        content = fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return 'kept';
+    }
+    const startIdx = content.indexOf(startMarker);
+    const endIdx = content.indexOf(endMarker);
+    if (startIdx === -1 || endIdx <= startIdx)
+        return 'not-found';
+    const before = content.substring(0, startIdx).trimEnd();
+    const after = content.substring(endIdx + endMarker.length).trimStart();
+    const joined = before + (before && after ? '\n\n' : '') + after;
+    if (joined.trim() === '') {
+        try {
+            fs.unlinkSync(filePath);
+        }
+        catch { /* ignore */ }
+    }
+    else {
+        atomicWriteFileSync(filePath, joined.trim() + '\n');
+    }
+    return 'removed';
+}
+//# sourceMappingURL=shared.js.map

package/dist/installer/targets/shared.js.map

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

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

@@ -0,0 +1,76 @@
+/**
+ * Agent target abstraction for the installer.
+ *
+ * Historically multi-target (Claude Code, Cursor, Codex, opencode, …); the
+ * fork is Claude-only now. The interface is preserved so the Claude target's
+ * structure (detect/install/uninstall/printConfig/describePaths) stays clean
+ * and testable, and so re-adding another agent in the future is one new file
+ * + one registry entry. See `targets/registry.ts`.
+ */
+export type Location = 'global' | 'local';
+/** Stable string id for the lone supported target. */
+export type TargetId = 'claude';
+/**
+ * Result of `target.detect(location)`.
+ *
+ * `installed` is a best-effort heuristic that the agent's CLI / app /
+ * config dir is present on this system. `alreadyConfigured` reports
+ * whether specship has already been wired in at this location —
+ * drives the "Updated"-vs-"Added" log line.
+ */
+export interface DetectionResult {
+    installed: boolean;
+    alreadyConfigured: boolean;
+    /** Path inspected; surfaced in diagnostic / dry-run output. */
+    configPath?: string;
+}
+/**
+ * What `target.install(location)` actually changed on disk. The
+ * orchestrator renders one log line per file using `action`.
+ *
+ * `unchanged` means we touched the file but its contents were already
+ * what we'd write — used for byte-identical idempotent re-runs.
+ */
+export interface WriteResult {
+    files: Array<{
+        path: string;
+        action: 'created' | 'updated' | 'unchanged' | 'removed' | 'not-found' | 'kept';
+    }>;
+    /** Optional one-line notes the orchestrator surfaces verbatim. */
+    notes?: string[];
+}
+export interface InstallOptions {
+    /**
+     * Whether to write Claude's permissions / auto-allow surface
+     * (`settings.json`). When false, only the MCP server entry is written.
+     */
+    autoAllow: boolean;
+}
+export interface AgentTarget {
+    /** Stable id; matches the `TargetId` union. */
+    readonly id: TargetId;
+    /** Human-readable name shown in prompts and log lines. */
+    readonly displayName: string;
+    /** Optional URL for "where do I learn more about this agent." */
+    readonly docsUrl?: string;
+    /** Whether this target supports the given install location. */
+    supportsLocation(loc: Location): boolean;
+    detect(loc: Location): DetectionResult;
+    install(loc: Location, opts: InstallOptions): WriteResult;
+    /**
+     * Inverse of install. Removes only what install would have written;
+     * preserves sibling MCP servers, sibling permissions, and unrelated
+     * markdown sections. Must be safe to call when nothing was ever
+     * installed (returns `not-found` actions).
+     */
+    uninstall(loc: Location): WriteResult;
+    /**
+     * Print the MCP-server snippet a user would paste manually. Used by
+     * `specship install --print-config` and the README. Must NOT touch
+     * the filesystem.
+     */
+    printConfig(loc: Location): string;
+    /** Filesystem paths this target would write to at this location. */
+    describePaths(loc: Location): string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/installer/targets/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1C,sDAAsD;AACtD,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAEhC;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;KAChF,CAAC,CAAC;IACH,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzC,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,eAAe,CAAC;IACvC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,WAAW,CAAC;IAC1D;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC;IACtC;;;;OAIG;IACH,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAAC;IACnC,oEAAoE;IACpE,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,EAAE,CAAC;CACxC"}

package/dist/installer/targets/types.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Agent target abstraction for the installer.
+ *
+ * Historically multi-target (Claude Code, Cursor, Codex, opencode, …); the
+ * fork is Claude-only now. The interface is preserved so the Claude target's
+ * structure (detect/install/uninstall/printConfig/describePaths) stays clean
+ * and testable, and so re-adding another agent in the future is one new file
+ * + one registry entry. See `targets/registry.ts`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/installer/targets/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/installer/targets/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

package/dist/isolation/worktree.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Git worktree isolation for workflow runs.
+ *
+ * Mirrors Archon's `WorktreeProvider` contract (packages/isolation/src/providers/worktree.ts:115-260):
+ *   - `envId` IS the filesystem path of the worktree (envId = workingPath).
+ *   - `create()` adds a worktree on a deterministic branch.
+ *   - `destroy()` removes the worktree (best-effort) and persists the
+ *     terminal state to `isolation_environments`.
+ *
+ * Why the contract: making envId self-describing means a workflow run's
+ * working directory is recoverable from the DB row alone — no extra
+ * mapping table. The partial unique index on `isolation_environments`
+ * with `WHERE status = 'active'` prevents duplicate live worktrees for
+ * the same (workflow_name, workflow_run_id).
+ *
+ * Workflow runs that don't need a fresh checkout (`worktree.enabled: false`
+ * on the workflow definition) skip this entirely and run in `cwd`.
+ */
+import { IsolationEnvironment } from '../types';
+import { SpecQueries } from '../db/spec-queries';
+export interface WorktreeCreateRequest {
+    /** Project root (the git repo this worktree branches from). */
+    repoRoot: string;
+    /** Workflow definition's `name` (e.g., "spec-implement"). */
+    workflowName: string;
+    /** The workflow run ID this worktree belongs to. */
+    workflowRunId: string;
+    /**
+     * Branch to base off. Defaults to the current branch of repoRoot.
+     * The new worktree's branch always starts from this.
+     */
+    baseBranch?: string;
+    /**
+     * Override the auto-generated branch name. Default: `specship/wf-<workflowName>-<shortRunId>`.
+     */
+    branchName?: string;
+}
+export declare class WorktreeProvider {
+    private specQueries;
+    constructor(specQueries: SpecQueries);
+    /**
+     * Create a git worktree for a workflow run. Returns the IsolationEnvironment
+     * record (id = workingPath). Throws on git command failure since a
+     * worktree-required workflow can't proceed without it.
+     */
+    create(req: WorktreeCreateRequest): IsolationEnvironment;
+    /**
+     * Destroy a worktree. Fire-and-forget — logs warnings but never throws.
+     * After this returns, the row is marked status='destroyed' so the
+     * partial unique index permits a fresh worktree for the same run.
+     */
+    destroy(envId: string, options?: {
+        force?: boolean;
+    }): void;
+    /**
+     * Tear down every active worktree owned by this specship instance.
+     * Useful at process shutdown or `specship workflow gc`.
+     */
+    destroyAllActive(options?: {
+        force?: boolean;
+    }): number;
+    private currentBranch;
+    private isVerbose;
+}
+//# sourceMappingURL=worktree.d.ts.map

package/dist/isolation/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/isolation/worktree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAiDD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAAc;gBAErB,WAAW,EAAE,WAAW;IAIpC;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,qBAAqB,GAAG,oBAAoB;IAqExD;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IA6C/D;;;OAGG;IACH,gBAAgB,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,MAAM;IAc3D,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,SAAS;CAGlB"}