@selvakumaresra/specship 0.1.3 → 0.4.0

package/dist/directory.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Directory Management
+ *
+ * Manages the .specship/ directory structure for SpecShip data.
+ *
+ * Layout: `<projectRoot>/.specship/` holds the SQLite index, lock file,
+ * daemon PID, workflow artifacts, logs, and project-level workflow
+ * definitions. The directory lives **inside the project** by design so
+ * that team-shared assets — notably `.specship/workflows/*.yaml` — are
+ * checked in alongside the code they govern. Per-machine files (the DB,
+ * the lock, the daemon socket, log output) are gitignored by the
+ * `.gitignore` written into the folder on init.
+ */
+/**
+ * SpecShip directory name
+ */
+export declare const SPECSHIP_DIR = ".specship";
+/**
+ * Get the .specship directory path for a project. All callers that
+ * compose subdirectories (artifacts, logs, lock files, daemon PID)
+ * should funnel through here so the layout has one source of truth.
+ */
+export declare function getSpecShipDir(projectRoot: string): string;
+/**
+ * Check if a project has been initialized with SpecShip.
+ * Requires both .specship/ directory AND specship.db to exist.
+ */
+export declare function isInitialized(projectRoot: string): boolean;
+/**
+ * Find the nearest parent directory containing .specship/
+ *
+ * Walks up from the given path to find a SpecShip-initialized project,
+ * similar to how git finds .git/ directories.
+ *
+ * @param startPath - Directory to start searching from
+ * @returns The project root containing .specship/, or null if not found
+ */
+export declare function findNearestSpecShipRoot(startPath: string): string | null;
+/**
+ * Create the .specship directory structure
+ * Note: Only throws if specship.db already exists, not just if .specship/ exists.
+ */
+export declare function createDirectory(projectRoot: string): void;
+/**
+ * Remove the .specship directory
+ */
+export declare function removeDirectory(projectRoot: string): void;
+/**
+ * Get all files in the .specship directory
+ */
+export declare function listDirectoryContents(projectRoot: string): string[];
+/**
+ * Get the total size of the .specship directory in bytes
+ */
+export declare function getDirectorySize(projectRoot: string): number;
+/**
+ * Ensure a subdirectory exists within .specship
+ */
+export declare function ensureSubdirectory(projectRoot: string, subdirName: string): string;
+/**
+ * Check if the .specship directory has valid structure
+ */
+export declare function validateDirectory(projectRoot: string): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=directory.d.ts.map

package/dist/directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../src/directory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH;;GAEG;AACH,eAAO,MAAM,YAAY,cAAc,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAQ1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBxE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CA6BzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAuBzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CA8BnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA+B5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAYlF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG;IACtD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CA8BA"}

package/dist/directory.js

@@ -0,0 +1,267 @@
+"use strict";
+/**
+ * Directory Management
+ *
+ * Manages the .specship/ directory structure for SpecShip data.
+ *
+ * Layout: `<projectRoot>/.specship/` holds the SQLite index, lock file,
+ * daemon PID, workflow artifacts, logs, and project-level workflow
+ * definitions. The directory lives **inside the project** by design so
+ * that team-shared assets — notably `.specship/workflows/*.yaml` — are
+ * checked in alongside the code they govern. Per-machine files (the DB,
+ * the lock, the daemon socket, log output) are gitignored by the
+ * `.gitignore` written into the folder on init.
+ */
+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.SPECSHIP_DIR = void 0;
+exports.getSpecShipDir = getSpecShipDir;
+exports.isInitialized = isInitialized;
+exports.findNearestSpecShipRoot = findNearestSpecShipRoot;
+exports.createDirectory = createDirectory;
+exports.removeDirectory = removeDirectory;
+exports.listDirectoryContents = listDirectoryContents;
+exports.getDirectorySize = getDirectorySize;
+exports.ensureSubdirectory = ensureSubdirectory;
+exports.validateDirectory = validateDirectory;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * SpecShip directory name
+ */
+exports.SPECSHIP_DIR = '.specship';
+/**
+ * Get the .specship directory path for a project. All callers that
+ * compose subdirectories (artifacts, logs, lock files, daemon PID)
+ * should funnel through here so the layout has one source of truth.
+ */
+function getSpecShipDir(projectRoot) {
+    return path.join(projectRoot, exports.SPECSHIP_DIR);
+}
+/**
+ * Check if a project has been initialized with SpecShip.
+ * Requires both .specship/ directory AND specship.db to exist.
+ */
+function isInitialized(projectRoot) {
+    const specshipDir = getSpecShipDir(projectRoot);
+    if (!fs.existsSync(specshipDir) || !fs.statSync(specshipDir).isDirectory()) {
+        return false;
+    }
+    // Must have specship.db, not just .specship folder
+    const dbPath = path.join(specshipDir, 'specship.db');
+    return fs.existsSync(dbPath);
+}
+/**
+ * Find the nearest parent directory containing .specship/
+ *
+ * Walks up from the given path to find a SpecShip-initialized project,
+ * similar to how git finds .git/ directories.
+ *
+ * @param startPath - Directory to start searching from
+ * @returns The project root containing .specship/, or null if not found
+ */
+function findNearestSpecShipRoot(startPath) {
+    let current = path.resolve(startPath);
+    const root = path.parse(current).root;
+    while (current !== root) {
+        if (isInitialized(current)) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break; // Reached filesystem root
+        current = parent;
+    }
+    // Check root as well
+    if (isInitialized(current)) {
+        return current;
+    }
+    return null;
+}
+/**
+ * Create the .specship directory structure
+ * Note: Only throws if specship.db already exists, not just if .specship/ exists.
+ */
+function createDirectory(projectRoot) {
+    const specshipDir = getSpecShipDir(projectRoot);
+    const dbPath = path.join(specshipDir, 'specship.db');
+    // Only throw if SpecShip is actually initialized (db exists)
+    // .specship/ folder alone is fine
+    if (fs.existsSync(dbPath)) {
+        throw new Error(`SpecShip already initialized in ${projectRoot}`);
+    }
+    // Create main directory (if it doesn't exist)
+    fs.mkdirSync(specshipDir, { recursive: true });
+    // Create .gitignore inside .specship (if it doesn't exist)
+    const gitignorePath = path.join(specshipDir, '.gitignore');
+    if (!fs.existsSync(gitignorePath)) {
+        const gitignoreContent = `# SpecShip data files — local to each machine, not for committing.
+# Ignore everything in .specship/ except this file itself, so transient
+# files (the database, daemon.pid, sockets, logs) never show up in git.
+# Team-shared content (workflows/*.yaml) should be explicitly !-allowed
+# below if you want it tracked.
+*
+!.gitignore
+!workflows/
+!workflows/**
+`;
+        fs.writeFileSync(gitignorePath, gitignoreContent, 'utf-8');
+    }
+}
+/**
+ * Remove the .specship directory
+ */
+function removeDirectory(projectRoot) {
+    const specshipDir = getSpecShipDir(projectRoot);
+    if (!fs.existsSync(specshipDir)) {
+        return;
+    }
+    // Verify .specship is a real directory, not a symlink pointing elsewhere
+    const lstat = fs.lstatSync(specshipDir);
+    if (lstat.isSymbolicLink()) {
+        // Only remove the symlink itself, never follow it for recursive delete
+        fs.unlinkSync(specshipDir);
+        return;
+    }
+    if (!lstat.isDirectory()) {
+        // Not a directory - remove the single file
+        fs.unlinkSync(specshipDir);
+        return;
+    }
+    // Recursively remove directory
+    fs.rmSync(specshipDir, { recursive: true, force: true });
+}
+/**
+ * Get all files in the .specship directory
+ */
+function listDirectoryContents(projectRoot) {
+    const specshipDir = getSpecShipDir(projectRoot);
+    if (!fs.existsSync(specshipDir)) {
+        return [];
+    }
+    const files = [];
+    function walkDir(dir, prefix = '') {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
+            // Skip symlinks to prevent following links outside .specship
+            if (entry.isSymbolicLink()) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                walkDir(path.join(dir, entry.name), relativePath);
+            }
+            else {
+                files.push(relativePath);
+            }
+        }
+    }
+    walkDir(specshipDir);
+    return files;
+}
+/**
+ * Get the total size of the .specship directory in bytes
+ */
+function getDirectorySize(projectRoot) {
+    const specshipDir = getSpecShipDir(projectRoot);
+    if (!fs.existsSync(specshipDir)) {
+        return 0;
+    }
+    let totalSize = 0;
+    function walkDir(dir) {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            // Skip symlinks to prevent following links outside .specship
+            if (entry.isSymbolicLink()) {
+                continue;
+            }
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walkDir(fullPath);
+            }
+            else {
+                const stats = fs.statSync(fullPath);
+                totalSize += stats.size;
+            }
+        }
+    }
+    walkDir(specshipDir);
+    return totalSize;
+}
+/**
+ * Ensure a subdirectory exists within .specship
+ */
+function ensureSubdirectory(projectRoot, subdirName) {
+    if (subdirName.includes('..') || subdirName.includes(path.sep) || subdirName.includes('/')) {
+        throw new Error(`Invalid subdirectory name: ${subdirName}`);
+    }
+    const subdirPath = path.join(getSpecShipDir(projectRoot), subdirName);
+    if (!fs.existsSync(subdirPath)) {
+        fs.mkdirSync(subdirPath, { recursive: true });
+    }
+    return subdirPath;
+}
+/**
+ * Check if the .specship directory has valid structure
+ */
+function validateDirectory(projectRoot) {
+    const errors = [];
+    const specshipDir = getSpecShipDir(projectRoot);
+    if (!fs.existsSync(specshipDir)) {
+        errors.push('SpecShip directory does not exist');
+        return { valid: false, errors };
+    }
+    if (!fs.statSync(specshipDir).isDirectory()) {
+        errors.push('.specship exists but is not a directory');
+        return { valid: false, errors };
+    }
+    // Auto-repair missing .gitignore (non-critical file)
+    const gitignorePath = path.join(specshipDir, '.gitignore');
+    if (!fs.existsSync(gitignorePath)) {
+        try {
+            const gitignoreContent = `# SpecShip data files — local to each machine, not for committing.\n# Ignore everything in .specship/ except this file itself, so transient\n# files (the database, daemon.pid, sockets, logs) never show up in git.\n*\n!.gitignore\n`;
+            fs.writeFileSync(gitignorePath, gitignoreContent, 'utf-8');
+        }
+        catch {
+            // Non-fatal: warn but don't block
+            errors.push('.gitignore missing in .specship directory and could not be created');
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=directory.js.map

package/dist/directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.js","sourceRoot":"","sources":["../src/directory.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeH,wCAEC;AAMD,sCAQC;AAWD,0DAmBC;AAMD,0CA6BC;AAKD,0CAuBC;AAKD,sDA8BC;AAKD,4CA+BC;AAKD,gDAYC;AAKD,8CAiCC;AAxPD,uCAAyB;AACzB,2CAA6B;AAE7B;;GAEG;AACU,QAAA,YAAY,GAAG,WAAW,CAAC;AAExC;;;;GAIG;AACH,SAAgB,cAAc,CAAC,WAAmB;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,oBAAY,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,WAAmB;IAC/C,MAAM,WAAW,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,mDAAmD;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACrD,OAAO,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,uBAAuB,CAAC,SAAiB;IACvD,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IAEtC,OAAO,OAAO,KAAK,IAAI,EAAE,CAAC;QACxB,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,MAAM,CAAC,0BAA0B;QACzD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,qBAAqB;IACrB,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,WAAmB;IACjD,MAAM,WAAW,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAErD,6DAA6D;IAC7D,kCAAkC;IAClC,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,mCAAmC,WAAW,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,8CAA8C;IAC9C,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,2DAA2D;IAC3D,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC3D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,MAAM,gBAAgB,GAAG;;;;;;;;;CAS5B,CAAC;QAEE,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,WAAmB;IACjD,MAAM,WAAW,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAEhD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO;IACT,CAAC;IAED,yEAAyE;IACzE,MAAM,KAAK,GAAG,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACxC,IAAI,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;QAC3B,uEAAuE;QACvE,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACzB,2CAA2C;QAC3C,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,+BAA+B;IAC/B,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,WAAmB;IACvD,MAAM,WAAW,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAEhD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,SAAS,OAAO,CAAC,GAAW,EAAE,SAAiB,EAAE;QAC/C,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAE7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;YAErE,6DAA6D;YAC7D,IAAI,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;gBAC3B,SAAS;YACX,CAAC;YAED,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,WAAW,CAAC,CAAC;IACrB,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,WAAmB;IAClD,MAAM,WAAW,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAEhD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,SAAS,OAAO,CAAC,GAAW;QAC1B,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAE7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,6DAA6D;YAC7D,IAAI,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;gBAC3B,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAE5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,OAAO,CAAC,QAAQ,CAAC,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACpC,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,WAAW,CAAC,CAAC;IACrB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,WAAmB,EAAE,UAAkB;IACxE,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3F,MAAM,IAAI,KAAK,CAAC,8BAA8B,UAAU,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC,CAAC;IAEtE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,WAAmB;IAInD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAEhD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACjD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACvD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,qDAAqD;IACrD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC3D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,gBAAgB,GAAG,wOAAwO,CAAC;YAClQ,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;YAClC,MAAM,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,136 @@
+/**
+ * SpecShip Error Classes
+ *
+ * Custom error types for better error handling and debugging.
+ *
+ * @module errors
+ *
+ * @example
+ * ```typescript
+ * import { FileError, ParseError, setLogger, silentLogger } from 'specship';
+ *
+ * // Catch specific error types
+ * try {
+ *   await cg.indexAll();
+ * } catch (error) {
+ *   if (error instanceof FileError) {
+ *     console.log(`File error at ${error.filePath}: ${error.message}`);
+ *   } else if (error instanceof ParseError) {
+ *     console.log(`Parse error at ${error.filePath}:${error.line}`);
+ *   }
+ * }
+ *
+ * // Disable logging for tests
+ * setLogger(silentLogger);
+ * ```
+ */
+/**
+ * Base error class for all SpecShip errors.
+ *
+ * All SpecShip-specific errors extend this class, allowing you to catch
+ * all SpecShip errors with a single catch block.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await cg.indexAll();
+ * } catch (error) {
+ *   if (error instanceof SpecShipError) {
+ *     console.log(`SpecShip error [${error.code}]: ${error.message}`);
+ *   }
+ * }
+ * ```
+ */
+export declare class SpecShipError extends Error {
+    /** Error code for categorization (e.g., 'FILE_ERROR', 'PARSE_ERROR') */
+    readonly code: string;
+    /** Additional context about the error */
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, code: string, context?: Record<string, unknown>);
+}
+/**
+ * Error reading or accessing files
+ */
+export declare class FileError extends SpecShipError {
+    readonly filePath: string;
+    constructor(message: string, filePath: string, cause?: Error);
+}
+/**
+ * Error parsing source code
+ */
+export declare class ParseError extends SpecShipError {
+    readonly filePath: string;
+    readonly line?: number;
+    readonly column?: number;
+    constructor(message: string, filePath: string, options?: {
+        line?: number;
+        column?: number;
+        cause?: Error;
+    });
+}
+/**
+ * Error with database operations
+ */
+export declare class DatabaseError extends SpecShipError {
+    readonly operation: string;
+    constructor(message: string, operation: string, cause?: Error);
+}
+/**
+ * Error with search operations
+ */
+export declare class SearchError extends SpecShipError {
+    readonly query: string;
+    constructor(message: string, query: string, cause?: Error);
+}
+/**
+ * Error with vector/embedding operations
+ */
+export declare class VectorError extends SpecShipError {
+    constructor(message: string, operation: string, cause?: Error);
+}
+/**
+ * Error with configuration
+ */
+export declare class ConfigError extends SpecShipError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Simple logger for SpecShip operations
+ *
+ * By default, logs to console.warn for warnings and console.error for errors.
+ * Can be configured to use custom logging.
+ */
+export interface Logger {
+    debug(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+}
+/**
+ * Default console-based logger
+ */
+export declare const defaultLogger: Logger;
+/**
+ * Silent logger (no output) - useful for tests
+ */
+export declare const silentLogger: Logger;
+/**
+ * Set the global logger
+ */
+export declare function setLogger(logger: Logger): void;
+/**
+ * Get the current logger
+ */
+export declare function getLogger(): Logger;
+/**
+ * Log a debug message
+ */
+export declare function logDebug(message: string, context?: Record<string, unknown>): void;
+/**
+ * Log a warning message
+ */
+export declare function logWarn(message: string, context?: Record<string, unknown>): void;
+/**
+ * Log an error message
+ */
+export declare function logError(message: string, context?: Record<string, unknown>): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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