@selvakumaresra/specship 0.1.1 → 0.1.3

package/dist/sync/worktree.d.ts

@@ -1,54 +0,0 @@
-/**
- * Git Worktree Awareness
- *
- * A SpecShip index lives in a `.specship/` directory and is resolved by
- * walking up parent directories to the nearest one (see
- * `findNearestSpecShipRoot`). That walk is unaware of git worktrees: when a
- * worktree is created *inside* the main checkout (e.g. some tools place them
- * under `.gitignore`d paths like `.claude/worktrees/<name>/`), a command run
- * from the worktree walks up and silently resolves the MAIN checkout's index.
- *
- * Every query then returns results from the main tree's code — usually a
- * different branch — rather than the worktree the user is actually editing.
- * Symbols added or changed only in the worktree are invisible. This module
- * detects that "borrowed index" situation so callers can warn about it.
- *
- * Detection is best-effort: when git is unavailable or the path isn't a repo,
- * it reports "no mismatch" and callers carry on unchanged.
- */
-/**
- * Absolute, symlink-resolved toplevel of the git working tree that `dir`
- * belongs to, or null when `dir` isn't inside a git repo (or git is missing).
- *
- * `git rev-parse --show-toplevel` returns the per-worktree root: the main
- * checkout and each linked worktree report their own distinct directory, which
- * is exactly the distinction this module relies on.
- */
-export declare function gitWorktreeRoot(dir: string): string | null;
-export interface WorktreeIndexMismatch {
-    /** The git working tree the command was run from. */
-    worktreeRoot: string;
-    /** The (different) working tree whose `.specship` index is being used. */
-    indexRoot: string;
-}
-/**
- * Detect when `startPath` lives in one git working tree but the resolved
- * SpecShip index (`indexRoot`) belongs to a *different* working tree.
- *
- * Returns null — meaning "nothing to warn about" — when:
- *   - `startPath` isn't in a git repo (or git is unavailable),
- *   - the index already lives in `startPath`'s own working tree, or
- *   - `indexRoot` isn't itself a working-tree root (an unrelated parent dir
- *     that merely happens to contain a `.specship/`), which keeps non-git
- *     and monorepo-subdir layouts from producing false warnings.
- */
-export declare function detectWorktreeIndexMismatch(startPath: string, indexRoot: string): WorktreeIndexMismatch | null;
-/** One-line-per-fact warning describing a detected mismatch. */
-export declare function worktreeMismatchWarning(m: WorktreeIndexMismatch): string;
-/**
- * Compact, single-line variant for prefixing a tool's result. Read tools
- * return their answer inline, so the heads-up has to ride on the same payload
- * the agent is already reading — a multi-line block would bury the result.
- */
-export declare function worktreeMismatchNotice(m: WorktreeIndexMismatch): string;
-//# sourceMappingURL=worktree.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/sync/worktree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY1D;AAED,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,qBAAqB,GAAG,IAAI,CAa9B;AAED,gEAAgE;AAChE,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,qBAAqB,GAAG,MAAM,CASxE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAOvE"}

package/dist/sync/worktree.js

@@ -1,137 +0,0 @@
-"use strict";
-/**
- * Git Worktree Awareness
- *
- * A SpecShip index lives in a `.specship/` directory and is resolved by
- * walking up parent directories to the nearest one (see
- * `findNearestSpecShipRoot`). That walk is unaware of git worktrees: when a
- * worktree is created *inside* the main checkout (e.g. some tools place them
- * under `.gitignore`d paths like `.claude/worktrees/<name>/`), a command run
- * from the worktree walks up and silently resolves the MAIN checkout's index.
- *
- * Every query then returns results from the main tree's code — usually a
- * different branch — rather than the worktree the user is actually editing.
- * Symbols added or changed only in the worktree are invisible. This module
- * detects that "borrowed index" situation so callers can warn about it.
- *
- * Detection is best-effort: when git is unavailable or the path isn't a repo,
- * it reports "no mismatch" and callers carry on unchanged.
- */
-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.gitWorktreeRoot = gitWorktreeRoot;
-exports.detectWorktreeIndexMismatch = detectWorktreeIndexMismatch;
-exports.worktreeMismatchWarning = worktreeMismatchWarning;
-exports.worktreeMismatchNotice = worktreeMismatchNotice;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const child_process_1 = require("child_process");
-/**
- * Absolute, symlink-resolved toplevel of the git working tree that `dir`
- * belongs to, or null when `dir` isn't inside a git repo (or git is missing).
- *
- * `git rev-parse --show-toplevel` returns the per-worktree root: the main
- * checkout and each linked worktree report their own distinct directory, which
- * is exactly the distinction this module relies on.
- */
-function gitWorktreeRoot(dir) {
-    try {
-        const out = (0, child_process_1.execFileSync)('git', ['rev-parse', '--show-toplevel'], {
-            cwd: dir,
-            encoding: 'utf8',
-            stdio: ['ignore', 'pipe', 'ignore'],
-            windowsHide: true,
-        }).trim();
-        return out ? realpath(out) : null;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Detect when `startPath` lives in one git working tree but the resolved
- * SpecShip index (`indexRoot`) belongs to a *different* working tree.
- *
- * Returns null — meaning "nothing to warn about" — when:
- *   - `startPath` isn't in a git repo (or git is unavailable),
- *   - the index already lives in `startPath`'s own working tree, or
- *   - `indexRoot` isn't itself a working-tree root (an unrelated parent dir
- *     that merely happens to contain a `.specship/`), which keeps non-git
- *     and monorepo-subdir layouts from producing false warnings.
- */
-function detectWorktreeIndexMismatch(startPath, indexRoot) {
-    const worktreeRoot = gitWorktreeRoot(startPath);
-    if (!worktreeRoot)
-        return null;
-    const resolvedIndexRoot = realpath(indexRoot);
-    if (worktreeRoot === resolvedIndexRoot)
-        return null;
-    // Only flag it when the index root is itself a real working-tree root. This
-    // distinguishes "borrowed another worktree's index" from "index sits in a
-    // plain ancestor directory", and avoids warning outside git entirely.
-    if (gitWorktreeRoot(resolvedIndexRoot) !== resolvedIndexRoot)
-        return null;
-    return { worktreeRoot, indexRoot: resolvedIndexRoot };
-}
-/** One-line-per-fact warning describing a detected mismatch. */
-function worktreeMismatchWarning(m) {
-    return (`This SpecShip index belongs to a different git working tree.\n` +
-        `  Running in: ${m.worktreeRoot}\n` +
-        `  Index from: ${m.indexRoot}\n` +
-        `Results reflect that tree's code (often a different branch), not this worktree — ` +
-        `symbols changed only here are missing. Run "specship init -i" in this worktree ` +
-        `for a worktree-local index.`);
-}
-/**
- * Compact, single-line variant for prefixing a tool's result. Read tools
- * return their answer inline, so the heads-up has to ride on the same payload
- * the agent is already reading — a multi-line block would bury the result.
- */
-function worktreeMismatchNotice(m) {
-    return (`⚠ SpecShip results below come from a different git worktree (${m.indexRoot}), ` +
-        `not where you're working (${m.worktreeRoot}) — they may reflect another branch, ` +
-        `and symbols changed only here are missing. Run "specship init -i" here for a ` +
-        `worktree-local index.`);
-}
-/** Resolve symlinks where possible so tmp/realpath quirks don't break equality. */
-function realpath(p) {
-    try {
-        return fs.realpathSync(path.resolve(p));
-    }
-    catch {
-        return path.resolve(p);
-    }
-}
-//# sourceMappingURL=worktree.js.map

package/dist/sync/worktree.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"worktree.js","sourceRoot":"","sources":["../../src/sync/worktree.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcH,0CAYC;AAoBD,kEAgBC;AAGD,0DASC;AAOD,wDAOC;AAtFD,uCAAyB;AACzB,2CAA6B;AAC7B,iDAA6C;AAE7C;;;;;;;GAOG;AACH,SAAgB,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,4BAAY,EAAC,KAAK,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE;YAChE,GAAG,EAAE,GAAG;YACR,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;YACnC,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AASD;;;;;;;;;;GAUG;AACH,SAAgB,2BAA2B,CACzC,SAAiB,EACjB,SAAiB;IAEjB,MAAM,YAAY,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAE/B,MAAM,iBAAiB,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC9C,IAAI,YAAY,KAAK,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAEpD,4EAA4E;IAC5E,0EAA0E;IAC1E,sEAAsE;IACtE,IAAI,eAAe,CAAC,iBAAiB,CAAC,KAAK,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAE1E,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC;AACxD,CAAC;AAED,gEAAgE;AAChE,SAAgB,uBAAuB,CAAC,CAAwB;IAC9D,OAAO,CACL,gEAAgE;QAChE,iBAAiB,CAAC,CAAC,YAAY,IAAI;QACnC,iBAAiB,CAAC,CAAC,SAAS,IAAI;QAChC,mFAAmF;QACnF,iFAAiF;QACjF,6BAA6B,CAC9B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,sBAAsB,CAAC,CAAwB;IAC7D,OAAO,CACL,gEAAgE,CAAC,CAAC,SAAS,KAAK;QAChF,6BAA6B,CAAC,CAAC,YAAY,uCAAuC;QAClF,+EAA+E;QAC/E,uBAAuB,CACxB,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,SAAS,QAAQ,CAAC,CAAS;IACzB,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}