@selvakumaresra/specship 0.1.1 → 0.1.3

package/dist/resolution/path-aliases.d.ts

@@ -1,68 +0,0 @@
-/**
- * Project-level import-path alias loading.
- *
- * Reads `compilerOptions.paths` from `tsconfig.json` / `jsconfig.json`
- * at the project root and converts the patterns into a form the
- * import-resolver can consult.
- *
- * This is the single biggest blocker to accurate resolution on modern
- * JS/TS codebases: aliases like `@/components/Foo` (Next, Nuxt, Nest,
- * Vite scaffolds) point into a `paths` map the resolver previously
- * ignored — every import through an alias was treated as unresolvable
- * unless it happened to match the small hard-coded fallback list.
- *
- * Scope deliberately small for v1:
- *   - reads tsconfig.json, then jsconfig.json
- *   - honours top-level `compilerOptions.baseUrl` and `compilerOptions.paths`
- *   - supports `*` wildcard (the only TS-supported wildcard)
- *   - does NOT follow `extends` chains yet (most projects don't need it)
- *   - does NOT read Vite/webpack/Rollup configs (separate follow-up)
- *
- * The file is parsed as JSON-with-comments-tolerant — tsconfigs in the
- * wild routinely contain `//` and `/* *\/` comments and trailing
- * commas, which JSON.parse rejects. We strip those before parsing.
- */
-/** A single alias pattern from `compilerOptions.paths`. */
-export interface AliasPattern {
-    /** The literal prefix before `*` (or the whole pattern if no `*`). */
-    prefix: string;
-    /** The literal suffix after `*` (almost always empty). */
-    suffix: string;
-    /** Whether the pattern contains a `*` wildcard. */
-    hasWildcard: boolean;
-    /**
-     * Replacement templates. When `hasWildcard` is true, `*` in the
-     * replacement is filled with the captured wildcard portion of the
-     * import path. Stored relative to {@link AliasMap.baseUrl}.
-     * tsconfig allows multiple targets per alias (priority order).
-     */
-    replacements: string[];
-}
-export interface AliasMap {
-    /** Absolute path. The directory `compilerOptions.paths` is rooted at. */
-    baseUrl: string;
-    /**
-     * Patterns ordered by specificity: longer prefix first, then literal-
-     * before-wildcard, so the resolver tries the most-specific match.
-     */
-    patterns: AliasPattern[];
-}
-/**
- * Load aliases for `projectRoot`. Returns `null` when no tsconfig /
- * jsconfig is present or when the file has no usable `paths`.
- *
- * Cheap to call repeatedly — caching is the caller's job (the
- * resolver does it via {@link aliasCache}).
- */
-export declare function loadProjectAliases(projectRoot: string): AliasMap | null;
-/**
- * Resolve an import path through an {@link AliasMap}. Returns the list
- * of candidate filesystem paths (relative to `projectRoot`), in the
- * priority order defined by tsconfig (multiple replacements per alias
- * are tried in order). Returns `[]` when no alias matches.
- *
- * Callers still need to try each candidate with the language's
- * extension list — this function only does the alias rewrite.
- */
-export declare function applyAliases(importPath: string, aliases: AliasMap, projectRoot: string): string[];
-//# sourceMappingURL=path-aliases.d.ts.map

package/dist/resolution/path-aliases.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"path-aliases.d.ts","sourceRoot":"","sources":["../../src/resolution/path-aliases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,WAAW,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAmFD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAuDvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,QAAQ,EACjB,WAAW,EAAE,MAAM,GAClB,MAAM,EAAE,CA2BV"}

package/dist/resolution/path-aliases.js

@@ -1,238 +0,0 @@
-"use strict";
-/**
- * Project-level import-path alias loading.
- *
- * Reads `compilerOptions.paths` from `tsconfig.json` / `jsconfig.json`
- * at the project root and converts the patterns into a form the
- * import-resolver can consult.
- *
- * This is the single biggest blocker to accurate resolution on modern
- * JS/TS codebases: aliases like `@/components/Foo` (Next, Nuxt, Nest,
- * Vite scaffolds) point into a `paths` map the resolver previously
- * ignored — every import through an alias was treated as unresolvable
- * unless it happened to match the small hard-coded fallback list.
- *
- * Scope deliberately small for v1:
- *   - reads tsconfig.json, then jsconfig.json
- *   - honours top-level `compilerOptions.baseUrl` and `compilerOptions.paths`
- *   - supports `*` wildcard (the only TS-supported wildcard)
- *   - does NOT follow `extends` chains yet (most projects don't need it)
- *   - does NOT read Vite/webpack/Rollup configs (separate follow-up)
- *
- * The file is parsed as JSON-with-comments-tolerant — tsconfigs in the
- * wild routinely contain `//` and `/* *\/` comments and trailing
- * commas, which JSON.parse rejects. We strip those before parsing.
- */
-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.loadProjectAliases = loadProjectAliases;
-exports.applyAliases = applyAliases;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const errors_1 = require("../errors");
-/**
- * Strip JSONC comments + trailing commas so a tsconfig with the usual
- * VS Code-style annotations parses cleanly. Walks the source as a
- * tiny state machine that tracks string context — the previous
- * regex-only version corrupted any URL inside a string value
- * (`"baseUrl": "https://cdn.example.com"` had everything after `//`
- * truncated).
- */
-function stripJsonc(src) {
-    let out = '';
-    let i = 0;
-    let inString = false;
-    while (i < src.length) {
-        const ch = src[i];
-        if (inString) {
-            out += ch;
-            if (ch === '\\' && i + 1 < src.length) {
-                out += src[i + 1];
-                i += 2;
-                continue;
-            }
-            if (ch === '"')
-                inString = false;
-            i++;
-            continue;
-        }
-        if (ch === '"') {
-            inString = true;
-            out += ch;
-            i++;
-            continue;
-        }
-        if (ch === '/' && src[i + 1] === '/') {
-            while (i < src.length && src[i] !== '\n')
-                i++;
-            continue;
-        }
-        if (ch === '/' && src[i + 1] === '*') {
-            i += 2;
-            while (i < src.length && !(src[i] === '*' && src[i + 1] === '/'))
-                i++;
-            i += 2;
-            continue;
-        }
-        out += ch;
-        i++;
-    }
-    // Trailing commas before } or ] — outside strings, so safe to
-    // run on the comment-stripped output.
-    return out.replace(/,(\s*[}\]])/g, '$1');
-}
-function readTsconfigLike(filePath) {
-    try {
-        const raw = fs.readFileSync(filePath, 'utf-8');
-        const parsed = JSON.parse(stripJsonc(raw));
-        return parsed && typeof parsed === 'object' ? parsed : null;
-    }
-    catch (err) {
-        (0, errors_1.logDebug)('path-aliases: failed to parse', { filePath, err: String(err) });
-        return null;
-    }
-}
-function splitWildcard(pattern) {
-    const star = pattern.indexOf('*');
-    if (star === -1)
-        return { prefix: pattern, suffix: '', hasWildcard: false };
-    return {
-        prefix: pattern.slice(0, star),
-        suffix: pattern.slice(star + 1),
-        hasWildcard: true,
-    };
-}
-/**
- * Load aliases for `projectRoot`. Returns `null` when no tsconfig /
- * jsconfig is present or when the file has no usable `paths`.
- *
- * Cheap to call repeatedly — caching is the caller's job (the
- * resolver does it via {@link aliasCache}).
- */
-function loadProjectAliases(projectRoot) {
-    const candidates = ['tsconfig.json', 'jsconfig.json'];
-    let raw = null;
-    let usedFile = null;
-    for (const name of candidates) {
-        const p = path.join(projectRoot, name);
-        if (fs.existsSync(p)) {
-            raw = readTsconfigLike(p);
-            if (raw) {
-                usedFile = name;
-                break;
-            }
-        }
-    }
-    if (!raw)
-        return null;
-    const co = raw.compilerOptions ?? {};
-    const baseUrlRel = co.baseUrl ?? '.';
-    const baseUrl = path.resolve(projectRoot, baseUrlRel);
-    const paths = co.paths;
-    if (!paths || typeof paths !== 'object') {
-        // baseUrl alone isn't an "alias" per se; with no paths we'd just
-        // be redirecting the whole tree. Skip — the existing resolver
-        // already handles relative imports.
-        return null;
-    }
-    const patterns = [];
-    for (const [pattern, targets] of Object.entries(paths)) {
-        if (!Array.isArray(targets) || targets.length === 0)
-            continue;
-        const filtered = targets.filter((t) => typeof t === 'string');
-        if (filtered.length === 0)
-            continue;
-        const { prefix, suffix, hasWildcard } = splitWildcard(pattern);
-        patterns.push({ prefix, suffix, hasWildcard, replacements: filtered });
-    }
-    if (patterns.length === 0)
-        return null;
-    // Specificity sort: longer prefix first; literal patterns before
-    // wildcard patterns of the same prefix length. TypeScript itself
-    // uses a similar "most specific match wins" rule.
-    patterns.sort((a, b) => {
-        if (a.prefix.length !== b.prefix.length)
-            return b.prefix.length - a.prefix.length;
-        if (a.hasWildcard !== b.hasWildcard)
-            return a.hasWildcard ? 1 : -1;
-        return 0;
-    });
-    (0, errors_1.logDebug)('path-aliases loaded', {
-        file: usedFile,
-        baseUrl,
-        patternCount: patterns.length,
-    });
-    return { baseUrl, patterns };
-}
-/**
- * Resolve an import path through an {@link AliasMap}. Returns the list
- * of candidate filesystem paths (relative to `projectRoot`), in the
- * priority order defined by tsconfig (multiple replacements per alias
- * are tried in order). Returns `[]` when no alias matches.
- *
- * Callers still need to try each candidate with the language's
- * extension list — this function only does the alias rewrite.
- */
-function applyAliases(importPath, aliases, projectRoot) {
-    for (const pat of aliases.patterns) {
-        if (!importPath.startsWith(pat.prefix))
-            continue;
-        if (pat.suffix && !importPath.endsWith(pat.suffix))
-            continue;
-        let captured = '';
-        if (pat.hasWildcard) {
-            captured = importPath.slice(pat.prefix.length, importPath.length - pat.suffix.length);
-        }
-        else if (importPath !== pat.prefix) {
-            // Literal pattern must match exactly.
-            continue;
-        }
-        const out = [];
-        for (const target of pat.replacements) {
-            const filled = pat.hasWildcard ? target.replace('*', captured) : target;
-            // baseUrl is absolute; produce a path relative to projectRoot
-            const absolute = path.resolve(aliases.baseUrl, filled);
-            const relative = path.relative(projectRoot, absolute);
-            // Skip if the rewrite escapes the project root (unsafe + can't
-            // be looked up via the file index anyway).
-            if (relative.startsWith('..'))
-                continue;
-            out.push(relative.replace(/\\/g, '/'));
-        }
-        return out;
-    }
-    return [];
-}
-//# sourceMappingURL=path-aliases.js.map

package/dist/resolution/path-aliases.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"path-aliases.js","sourceRoot":"","sources":["../../src/resolution/path-aliases.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyHH,gDAuDC;AAWD,oCA+BC;AAxND,uCAAyB;AACzB,2CAA6B;AAC7B,sCAAqC;AA6BrC;;;;;;;GAOG;AACH,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QACnB,IAAI,QAAQ,EAAE,CAAC;YACb,GAAG,IAAI,EAAE,CAAC;YACV,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;gBACtC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;gBACnB,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,EAAE,KAAK,GAAG;gBAAE,QAAQ,GAAG,KAAK,CAAC;YACjC,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,QAAQ,GAAG,IAAI,CAAC;YAChB,GAAG,IAAI,EAAE,CAAC;YACV,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACrC,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;gBAAE,CAAC,EAAE,CAAC;YAC9C,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACrC,CAAC,IAAI,CAAC,CAAC;YACP,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;gBAAE,CAAC,EAAE,CAAC;YACtE,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,GAAG,IAAI,EAAE,CAAC;QACV,CAAC,EAAE,CAAC;IACN,CAAC;IACD,8DAA8D;IAC9D,sCAAsC;IACtC,OAAO,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;AAC3C,CAAC;AASD,SAAS,gBAAgB,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAgB,CAAC;QAC1D,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAA,iBAAQ,EAAC,+BAA+B,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IAKpC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,IAAI,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAC5E,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;QAC9B,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QAC/B,WAAW,EAAE,IAAI;KAClB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAC,WAAmB;IACpD,MAAM,UAAU,GAAG,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IACtD,IAAI,GAAG,GAAuB,IAAI,CAAC;IACnC,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YACrB,GAAG,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,GAAG,EAAE,CAAC;gBACR,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,MAAM,EAAE,GAAG,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC;IACrC,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,IAAI,GAAG,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAEtD,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC;IACvB,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,iEAAiE;QACjE,8DAA8D;QAC9D,oCAAoC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAC9D,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;QAC3E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACpC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QAC/D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,iEAAiE;IACjE,iEAAiE;IACjE,kDAAkD;IAClD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrB,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;QAClF,IAAI,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW;YAAE,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;IAEH,IAAA,iBAAQ,EAAC,qBAAqB,EAAE;QAC9B,IAAI,EAAE,QAAQ;QACd,OAAO;QACP,YAAY,EAAE,QAAQ,CAAC,MAAM;KAC9B,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAC1B,UAAkB,EAClB,OAAiB,EACjB,WAAmB;IAEnB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,SAAS;QACjD,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,SAAS;QAE7D,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;YACpB,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxF,CAAC;aAAM,IAAI,UAAU,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC;YACrC,sCAAsC;YACtC,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACxE,8DAA8D;YAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YACtD,+DAA+D;YAC/D,2CAA2C;YAC3C,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,SAAS;YACxC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/resolution/spec-link-resolver.d.ts

@@ -1,103 +0,0 @@
-/**
- * SpecLinkResolver
- *
- * Mirrors the role of `ReferenceResolver` for spec → code links. Each sync
- * cycle, this resolver:
- *
- *   1. For every changed file, walks spec_links whose `target_file_path`
- *      matches and re-resolves `resolved_node_id` against the current
- *      `nodes` table by (file_path, qualified_name, kind).
- *   2. Compares the resolved node's signature to `node_sig_at_link`. If
- *      changed → state transitions to `drifted (drift_axis='code')`.
- *   3. If no matching node exists → `resolved_node_id = NULL` and the link
- *      transitions to `orphaned` (unless already terminal-ish: `verified`,
- *      `broken` stay; orphaned is the new resting state).
- *   4. Spec hash drift is handled separately by the spec extraction stage
- *      (it calls `markSpecDrifted` directly).
- *
- * Why this is much simpler than ReferenceResolver:
- *   - No cross-file import / framework resolution. Links carry their own
- *     logical target (file + qualified_name) — no name-matching required.
- *   - No LRU caches needed: the SQLite index on
- *     (target_file_path, target_qualified_name) makes lookups O(log N).
- *
- * It also handles the inbound side: applying `SpecLinkCandidate[]` produced
- * by spec extractors (provenance='spec-declaration', confidence 0.7) and
- * by code-comment scanning (provenance='code-comment', confidence 0.9).
- * Highest-confidence signal wins per logical key — `upsertSpecLink` enforces
- * this.
- */
-import { Spec } from '../types';
-import { QueryBuilder } from '../db/queries';
-import { SpecQueries } from '../db/spec-queries';
-import { SpecLinkCandidate } from '../extraction/specs/types';
-export interface SpecLinkResolverOptions {
-    /**
-     * If true, log a one-line summary per resolved link.
-     */
-    verbose?: boolean;
-}
-export interface SpecLinkResolverStats {
-    scanned: number;
-    reresolved: number;
-    orphaned: number;
-    driftedCode: number;
-    candidatesApplied: number;
-    commentLinksApplied: number;
-}
-export declare class SpecLinkResolver {
-    private queries;
-    private specQueries;
-    private opts;
-    constructor(queries: QueryBuilder, specQueries: SpecQueries, opts?: SpecLinkResolverOptions);
-    /**
-     * Re-resolve spec_links for a set of changed files. Call this from the
-     * sync pipeline after code extraction completes for those files.
-     */
-    resolveLinksForFiles(changedFiles: string[]): SpecLinkResolverStats;
-    /**
-     * Re-resolve every spec_link in the database. Used by `indexAll` on a
-     * fresh build, and as a paranoia pass after large refactors.
-     */
-    resolveAll(): SpecLinkResolverStats;
-    /**
-     * Re-resolve all links whose logical target lives in `filePath`.
-     */
-    private resolveLinksForFile;
-    private resolveOneLink;
-    /**
-     * Look up a node by logical identity: (file_path, qualified_name).
-     * `kind` is a hint, not a hard filter — we prefer an exact-kind match
-     * but fall back to any kind on the same path/qname (a function turned
-     * method is still "the same logical symbol" from the spec's POV).
-     */
-    private findLogicalTarget;
-    /**
-     * Apply spec-declared `implementations:` links. Provenance = 'spec-declaration',
-     * confidence 0.7. Idempotent — upsert by logical key.
-     */
-    applyDeclarationCandidates(candidates: SpecLinkCandidate[], specsByIdForHash: Map<string, Spec>, stats?: SpecLinkResolverStats): void;
-    /**
-     * Scan node docstrings for `@implements REQ-X` markers and emit spec links.
-     *
-     * This is the load-bearing backstop when the agent forgets to call
-     * specship_link_assert: the spec link still gets created from the
-     * `// @implements REQ-X` comment in code. Provenance = 'code-comment',
-     * confidence 0.9.
-     *
-     * Called from the sync pipeline after code extraction for changed files.
-     * Bounded by the changed-files set — full-graph scans only on indexAll.
-     */
-    applyCodeCommentLinks(changedFiles: string[], stats?: SpecLinkResolverStats): void;
-    /**
-     * Mark every link of `specId` as `drifted(spec)` because the spec's
-     * `contentHash` changed since the link was established. Sticky states
-     * (`verified`, `broken`) are left alone.
-     *
-     * The agent's job after seeing drift: re-read the spec, update code if
-     * needed, call specship_link_verify to take state back to `verified`.
-     */
-    markSpecDrifted(specId: string, newSpecHash: string): number;
-    private makeStats;
-}
-//# sourceMappingURL=spec-link-resolver.d.ts.map

package/dist/resolution/spec-link-resolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec-link-resolver.d.ts","sourceRoot":"","sources":["../../src/resolution/spec-link-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAGL,IAAI,EAIL,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAY9D,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,IAAI,CAA0B;gBAGpC,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,WAAW,EACxB,IAAI,GAAE,uBAA4B;IAOpC;;;OAGG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,qBAAqB;IAQnE;;;OAGG;IACH,UAAU,IAAI,qBAAqB;IAQnC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,cAAc;IA+CtB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAwBzB;;;OAGG;IACH,0BAA0B,CACxB,UAAU,EAAE,iBAAiB,EAAE,EAC/B,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,EACnC,KAAK,CAAC,EAAE,qBAAqB,GAC5B,IAAI;IAgCP;;;;;;;;;;OAUG;IACH,qBAAqB,CACnB,YAAY,EAAE,MAAM,EAAE,EACtB,KAAK,CAAC,EAAE,qBAAqB,GAC5B,IAAI;IA4CP;;;;;;;OAOG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAgB5D,OAAO,CAAC,SAAS;CAUlB"}