@neurcode-ai/cli 0.9.31 → 0.9.33

package/dist/utils/plan-slo.d.ts

@@ -0,0 +1,73 @@
+export type PlanSloIntentMode = 'implementation' | 'analysis';
+export type PlanSloCoverageLevel = 'high' | 'medium' | 'low';
+export type PlanSloCoverageStatus = 'sufficient' | 'warning' | 'insufficient';
+export type PlanSloEscalationPolicyReason = 'enabled' | 'env_disabled' | 'canary_excluded' | 'kill_switch_cooldown';
+export interface PlanSloEvent {
+    schemaVersion: 1;
+    timestamp: string;
+    intentMode: PlanSloIntentMode;
+    cached: boolean;
+    success: boolean;
+    exitCode: number;
+    elapsedMs: number;
+    rssKb: number;
+    coverageScore: number | null;
+    coverageLevel: PlanSloCoverageLevel | null;
+    coverageStatus: PlanSloCoverageStatus | null;
+    adaptiveEscalationTriggered: boolean;
+    adaptiveEscalationReason: string | null;
+    adaptiveEscalationDeepenedFiles: number;
+    escalationPolicyEnabled: boolean | null;
+    escalationPolicyReason: PlanSloEscalationPolicyReason | null;
+    escalationCanaryPercent: number | null;
+    escalationCanaryBucket: number | null;
+    escalationKillSwitchTripped: boolean;
+    escalationKillSwitchCooldownUntil: string | null;
+    fileTreeCount: number | null;
+    filesUsedForGeneration: number | null;
+}
+export interface PlanSloEventInput {
+    timestamp?: string;
+    intentMode: PlanSloIntentMode;
+    cached: boolean;
+    success: boolean;
+    exitCode: number;
+    elapsedMs: number;
+    rssKb: number;
+    coverageScore?: number | null;
+    coverageLevel?: PlanSloCoverageLevel | null;
+    coverageStatus?: PlanSloCoverageStatus | null;
+    adaptiveEscalationTriggered?: boolean;
+    adaptiveEscalationReason?: string | null;
+    adaptiveEscalationDeepenedFiles?: number;
+    escalationPolicyEnabled?: boolean | null;
+    escalationPolicyReason?: PlanSloEscalationPolicyReason | null;
+    escalationCanaryPercent?: number | null;
+    escalationCanaryBucket?: number | null;
+    escalationKillSwitchTripped?: boolean;
+    escalationKillSwitchCooldownUntil?: string | null;
+    fileTreeCount?: number | null;
+    filesUsedForGeneration?: number | null;
+}
+export interface PlanEscalationGuardState {
+    version: 1;
+    updatedAt: string;
+    consecutiveBreaches: number;
+    lastBreachAt?: string;
+    lastReason?: string;
+    cooldownUntil?: string;
+}
+export interface PlanEscalationGuardSnapshot {
+    path: string;
+    present: boolean;
+    cooldownActive: boolean;
+    cooldownUntil: string | null;
+    state: PlanEscalationGuardState | null;
+}
+export declare function getPlanSloLogPath(projectRoot: string): string;
+export declare function getPlanEscalationGuardPath(projectRoot: string): string;
+export declare function prunePlanSloLog(projectRoot: string, nowMs?: number): void;
+export declare function appendPlanSloEvent(projectRoot: string, input: PlanSloEventInput): PlanSloEvent;
+export declare function readPlanSloEvents(projectRoot: string): PlanSloEvent[];
+export declare function readPlanEscalationGuardSnapshot(projectRoot: string, nowMs?: number): PlanEscalationGuardSnapshot;
+//# sourceMappingURL=plan-slo.d.ts.map

package/dist/utils/plan-slo.d.ts.map

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

package/dist/utils/plan-slo.js

@@ -0,0 +1,271 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPlanSloLogPath = getPlanSloLogPath;
+exports.getPlanEscalationGuardPath = getPlanEscalationGuardPath;
+exports.prunePlanSloLog = prunePlanSloLog;
+exports.appendPlanSloEvent = appendPlanSloEvent;
+exports.readPlanSloEvents = readPlanSloEvents;
+exports.readPlanEscalationGuardSnapshot = readPlanEscalationGuardSnapshot;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const PLAN_SLO_LOG_FILENAME = 'plan-slo.jsonl';
+const ESCALATION_GUARD_FILENAME = 'asset-map-escalation-guard.json';
+const DEFAULT_PLAN_SLO_LOG_MAX_EVENTS = 2000;
+const DEFAULT_PLAN_SLO_LOG_MAX_DAYS = 30;
+function toFiniteInteger(value, fallback) {
+    if (!Number.isFinite(value))
+        return fallback;
+    return Math.max(0, Math.floor(value));
+}
+function toNullableFiniteInteger(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return null;
+    return Math.max(0, Math.floor(value));
+}
+function toNullableString(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value : null;
+}
+function toNullableBoolean(value) {
+    if (typeof value === 'boolean')
+        return value;
+    return null;
+}
+function parseNonNegativeInt(raw) {
+    if (!raw || !raw.trim())
+        return null;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed < 0)
+        return null;
+    return Math.floor(parsed);
+}
+function resolvePlanSloMaxEvents() {
+    const parsed = parseNonNegativeInt(process.env.NEURCODE_PLAN_SLO_LOG_MAX_EVENTS);
+    return parsed === null ? DEFAULT_PLAN_SLO_LOG_MAX_EVENTS : parsed;
+}
+function resolvePlanSloMaxDays() {
+    const parsed = parseNonNegativeInt(process.env.NEURCODE_PLAN_SLO_LOG_MAX_DAYS);
+    return parsed === null ? DEFAULT_PLAN_SLO_LOG_MAX_DAYS : parsed;
+}
+function parseEventLine(line) {
+    if (!line.trim())
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== 'object')
+        return null;
+    const data = parsed;
+    if (data.schemaVersion !== 1)
+        return null;
+    if (typeof data.timestamp !== 'string')
+        return null;
+    if (data.intentMode !== 'implementation' && data.intentMode !== 'analysis')
+        return null;
+    if (typeof data.cached !== 'boolean')
+        return null;
+    if (typeof data.success !== 'boolean')
+        return null;
+    if (typeof data.exitCode !== 'number')
+        return null;
+    if (typeof data.elapsedMs !== 'number')
+        return null;
+    if (typeof data.rssKb !== 'number')
+        return null;
+    const coverageLevelValue = data.coverageLevel;
+    const coverageLevel = coverageLevelValue === 'high' || coverageLevelValue === 'medium' || coverageLevelValue === 'low'
+        ? coverageLevelValue
+        : null;
+    const coverageStatusValue = data.coverageStatus;
+    const coverageStatus = coverageStatusValue === 'sufficient' || coverageStatusValue === 'warning' || coverageStatusValue === 'insufficient'
+        ? coverageStatusValue
+        : null;
+    const escalationPolicyReasonValue = data.escalationPolicyReason;
+    const escalationPolicyReason = escalationPolicyReasonValue === 'enabled' ||
+        escalationPolicyReasonValue === 'env_disabled' ||
+        escalationPolicyReasonValue === 'canary_excluded' ||
+        escalationPolicyReasonValue === 'kill_switch_cooldown'
+        ? escalationPolicyReasonValue
+        : null;
+    return {
+        schemaVersion: 1,
+        timestamp: data.timestamp,
+        intentMode: data.intentMode,
+        cached: data.cached,
+        success: data.success,
+        exitCode: toFiniteInteger(data.exitCode, 0),
+        elapsedMs: toFiniteInteger(data.elapsedMs, 0),
+        rssKb: toFiniteInteger(data.rssKb, 0),
+        coverageScore: toNullableFiniteInteger(data.coverageScore),
+        coverageLevel,
+        coverageStatus,
+        adaptiveEscalationTriggered: data.adaptiveEscalationTriggered === true,
+        adaptiveEscalationReason: toNullableString(data.adaptiveEscalationReason),
+        adaptiveEscalationDeepenedFiles: toFiniteInteger(typeof data.adaptiveEscalationDeepenedFiles === 'number' ? data.adaptiveEscalationDeepenedFiles : 0, 0),
+        escalationPolicyEnabled: toNullableBoolean(data.escalationPolicyEnabled),
+        escalationPolicyReason,
+        escalationCanaryPercent: toNullableFiniteInteger(data.escalationCanaryPercent),
+        escalationCanaryBucket: toNullableFiniteInteger(data.escalationCanaryBucket),
+        escalationKillSwitchTripped: data.escalationKillSwitchTripped === true,
+        escalationKillSwitchCooldownUntil: toNullableString(data.escalationKillSwitchCooldownUntil),
+        fileTreeCount: toNullableFiniteInteger(data.fileTreeCount),
+        filesUsedForGeneration: toNullableFiniteInteger(data.filesUsedForGeneration),
+    };
+}
+function getPlanSloLogPath(projectRoot) {
+    return (0, path_1.join)(projectRoot, '.neurcode', PLAN_SLO_LOG_FILENAME);
+}
+function getPlanEscalationGuardPath(projectRoot) {
+    return (0, path_1.join)(projectRoot, '.neurcode', ESCALATION_GUARD_FILENAME);
+}
+function prunePlanSloLog(projectRoot, nowMs = Date.now()) {
+    const maxEvents = resolvePlanSloMaxEvents();
+    const maxDays = resolvePlanSloMaxDays();
+    if (maxEvents === 0 && maxDays === 0) {
+        return;
+    }
+    const sloPath = getPlanSloLogPath(projectRoot);
+    if (!(0, fs_1.existsSync)(sloPath)) {
+        return;
+    }
+    let raw;
+    try {
+        raw = (0, fs_1.readFileSync)(sloPath, 'utf-8');
+    }
+    catch {
+        return;
+    }
+    if (!raw.trim()) {
+        return;
+    }
+    const cutoffMs = maxDays > 0 ? nowMs - maxDays * 24 * 60 * 60 * 1000 : null;
+    const lines = raw.split('\n').map((line) => line.trim()).filter(Boolean);
+    const retained = [];
+    let changed = false;
+    for (const line of lines) {
+        const parsed = parseEventLine(line);
+        if (!parsed) {
+            changed = true;
+            continue;
+        }
+        if (cutoffMs !== null) {
+            const timestampMs = Date.parse(parsed.timestamp);
+            if (Number.isFinite(timestampMs) && timestampMs < cutoffMs) {
+                changed = true;
+                continue;
+            }
+        }
+        retained.push(JSON.stringify(parsed));
+    }
+    if (maxEvents > 0 && retained.length > maxEvents) {
+        retained.splice(0, retained.length - maxEvents);
+        changed = true;
+    }
+    if (!changed && retained.length === lines.length) {
+        return;
+    }
+    const nextContent = retained.length > 0 ? `${retained.join('\n')}\n` : '';
+    (0, fs_1.writeFileSync)(sloPath, nextContent, 'utf-8');
+}
+function appendPlanSloEvent(projectRoot, input) {
+    const event = {
+        schemaVersion: 1,
+        timestamp: input.timestamp || new Date().toISOString(),
+        intentMode: input.intentMode,
+        cached: input.cached === true,
+        success: input.success === true,
+        exitCode: toFiniteInteger(input.exitCode, 1),
+        elapsedMs: toFiniteInteger(input.elapsedMs, 0),
+        rssKb: toFiniteInteger(input.rssKb, 0),
+        coverageScore: toNullableFiniteInteger(input.coverageScore),
+        coverageLevel: input.coverageLevel || null,
+        coverageStatus: input.coverageStatus || null,
+        adaptiveEscalationTriggered: input.adaptiveEscalationTriggered === true,
+        adaptiveEscalationReason: input.adaptiveEscalationReason || null,
+        adaptiveEscalationDeepenedFiles: toFiniteInteger(input.adaptiveEscalationDeepenedFiles || 0, 0),
+        escalationPolicyEnabled: typeof input.escalationPolicyEnabled === 'boolean' ? input.escalationPolicyEnabled : null,
+        escalationPolicyReason: input.escalationPolicyReason || null,
+        escalationCanaryPercent: toNullableFiniteInteger(input.escalationCanaryPercent),
+        escalationCanaryBucket: toNullableFiniteInteger(input.escalationCanaryBucket),
+        escalationKillSwitchTripped: input.escalationKillSwitchTripped === true,
+        escalationKillSwitchCooldownUntil: input.escalationKillSwitchCooldownUntil || null,
+        fileTreeCount: toNullableFiniteInteger(input.fileTreeCount),
+        filesUsedForGeneration: toNullableFiniteInteger(input.filesUsedForGeneration),
+    };
+    const sloPath = getPlanSloLogPath(projectRoot);
+    const sloDir = (0, path_1.join)(projectRoot, '.neurcode');
+    if (!(0, fs_1.existsSync)(sloDir)) {
+        (0, fs_1.mkdirSync)(sloDir, { recursive: true });
+    }
+    (0, fs_1.appendFileSync)(sloPath, JSON.stringify(event) + '\n', 'utf-8');
+    prunePlanSloLog(projectRoot);
+    return event;
+}
+function readPlanSloEvents(projectRoot) {
+    const pathValue = getPlanSloLogPath(projectRoot);
+    if (!(0, fs_1.existsSync)(pathValue)) {
+        return [];
+    }
+    try {
+        const raw = (0, fs_1.readFileSync)(pathValue, 'utf-8');
+        const lines = raw.split('\n');
+        const events = [];
+        for (const line of lines) {
+            const parsed = parseEventLine(line);
+            if (parsed) {
+                events.push(parsed);
+            }
+        }
+        return events;
+    }
+    catch {
+        return [];
+    }
+}
+function readPlanEscalationGuardSnapshot(projectRoot, nowMs = Date.now()) {
+    const pathValue = getPlanEscalationGuardPath(projectRoot);
+    if (!(0, fs_1.existsSync)(pathValue)) {
+        return {
+            path: pathValue,
+            present: false,
+            cooldownActive: false,
+            cooldownUntil: null,
+            state: null,
+        };
+    }
+    try {
+        const raw = JSON.parse((0, fs_1.readFileSync)(pathValue, 'utf-8'));
+        const state = {
+            version: 1,
+            updatedAt: typeof raw.updatedAt === 'string' ? raw.updatedAt : new Date(0).toISOString(),
+            consecutiveBreaches: typeof raw.consecutiveBreaches === 'number' && Number.isFinite(raw.consecutiveBreaches) && raw.consecutiveBreaches > 0
+                ? Math.floor(raw.consecutiveBreaches)
+                : 0,
+            lastBreachAt: typeof raw.lastBreachAt === 'string' ? raw.lastBreachAt : undefined,
+            lastReason: typeof raw.lastReason === 'string' ? raw.lastReason : undefined,
+            cooldownUntil: typeof raw.cooldownUntil === 'string' ? raw.cooldownUntil : undefined,
+        };
+        const cooldownUntilMs = state.cooldownUntil ? Date.parse(state.cooldownUntil) : NaN;
+        const cooldownActive = Number.isFinite(cooldownUntilMs) && cooldownUntilMs > nowMs;
+        return {
+            path: pathValue,
+            present: true,
+            cooldownActive,
+            cooldownUntil: state.cooldownUntil || null,
+            state,
+        };
+    }
+    catch {
+        return {
+            path: pathValue,
+            present: false,
+            cooldownActive: false,
+            cooldownUntil: null,
+            state: null,
+        };
+    }
+}
+//# sourceMappingURL=plan-slo.js.map

package/dist/utils/plan-slo.js.map

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

package/dist/utils/project-root.d.ts

@@ -9,10 +9,11 @@
  * - Walk up from the current working directory and pick the nearest ancestor
  *   that contains `.neurcode/config.json` (linked project marker).
  * - Also treat legacy `neurcode.config.json` as a marker for older setups.
- * - If nothing is found, fall back to the starting directory (preserves current behavior).
- *
- * Note: We intentionally do NOT fall back to git root here. Linking a subdirectory
- * (monorepo package) should remain possible without surprises.
+ * - If the current directory is inside a git repository, do not search above
+ *   that repository root. This prevents accidental cross-repo leakage.
+ * - Cross-repo root overrides are denied by default, but can be explicitly
+ *   allowed via `.neurcode/repo-links.json` (`neurcode repo link ...`).
+ * - If nothing is found, fall back to the starting directory.
  */
 export declare function resolveNeurcodeProjectRoot(startDir?: string): string;
 //# sourceMappingURL=project-root.d.ts.map

package/dist/utils/project-root.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-root.d.ts","sourceRoot":"","sources":["../../src/utils/project-root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,wBAAgB,0BAA0B,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAyBnF"}
+{"version":3,"file":"project-root.d.ts","sourceRoot":"","sources":["../../src/utils/project-root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAgDH,wBAAgB,0BAA0B,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,CA8DnF"}

package/dist/utils/project-root.js

@@ -10,35 +10,110 @@
  * - Walk up from the current working directory and pick the nearest ancestor
  *   that contains `.neurcode/config.json` (linked project marker).
  * - Also treat legacy `neurcode.config.json` as a marker for older setups.
- * - If nothing is found, fall back to the starting directory (preserves current behavior).
- *
- * Note: We intentionally do NOT fall back to git root here. Linking a subdirectory
- * (monorepo package) should remain possible without surprises.
+ * - If the current directory is inside a git repository, do not search above
+ *   that repository root. This prevents accidental cross-repo leakage.
+ * - Cross-repo root overrides are denied by default, but can be explicitly
+ *   allowed via `.neurcode/repo-links.json` (`neurcode repo link ...`).
+ * - If nothing is found, fall back to the starting directory.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveNeurcodeProjectRoot = resolveNeurcodeProjectRoot;
+const child_process_1 = require("child_process");
 const fs_1 = require("fs");
 const path_1 = require("path");
+const repo_links_1 = require("./repo-links");
+function canonicalizePath(pathValue) {
+    try {
+        return (0, fs_1.realpathSync)(pathValue);
+    }
+    catch {
+        return (0, path_1.resolve)(pathValue);
+    }
+}
+function getGitRoot(startDir) {
+    try {
+        const output = (0, child_process_1.execSync)('git rev-parse --show-toplevel', {
+            cwd: startDir,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        return output ? canonicalizePath(output) : null;
+    }
+    catch {
+        return null;
+    }
+}
+function isPathWithin(parent, candidate) {
+    const rel = (0, path_1.relative)(parent, candidate);
+    return rel === '' || (!rel.startsWith('..') && !(0, path_1.isAbsolute)(rel));
+}
+function findNearestRepoLinksRoot(startDir, boundary) {
+    let dir = startDir;
+    while (true) {
+        const linksPath = (0, path_1.join)(dir, '.neurcode', 'repo-links.json');
+        if ((0, fs_1.existsSync)(linksPath)) {
+            return dir;
+        }
+        if (boundary && dir === boundary)
+            break;
+        const parent = (0, path_1.dirname)(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
 function resolveNeurcodeProjectRoot(startDir = process.cwd()) {
+    const resolvedStart = canonicalizePath(startDir);
+    const gitRoot = getGitRoot(resolvedStart);
+    const homeDir = canonicalizePath(process.env.HOME || process.env.USERPROFILE || resolvedStart);
     const override = process.env.NEURCODE_PROJECT_ROOT || process.env.NEURCODE_ROOT;
     if (override && override.trim()) {
-        return (0, path_1.resolve)(override.trim());
+        const overridePath = canonicalizePath(override.trim());
+        if (gitRoot &&
+            !isPathWithin(gitRoot, overridePath) &&
+            process.env.NEURCODE_ALLOW_CROSS_REPO_ROOT !== '1') {
+            const linksRoot = findNearestRepoLinksRoot(resolvedStart, gitRoot);
+            const explicitlyLinked = linksRoot
+                ? (0, repo_links_1.isRepoPathExplicitlyLinked)(linksRoot, overridePath)
+                : false;
+            if (explicitlyLinked) {
+                return overridePath;
+            }
+            // Ignore invalid cross-repo override and continue with normal root resolution.
+        }
+        else {
+            return overridePath;
+        }
     }
-    let dir = (0, path_1.resolve)(startDir);
+    let dir = resolvedStart;
+    const boundary = gitRoot || null;
     while (true) {
         const neurcodeConfig = (0, path_1.join)(dir, '.neurcode', 'config.json');
         if ((0, fs_1.existsSync)(neurcodeConfig)) {
+            if (dir === homeDir &&
+                dir !== resolvedStart &&
+                process.env.NEURCODE_ALLOW_HOME_ROOT !== '1') {
+                return resolvedStart;
+            }
             return dir;
         }
         const legacyLocalConfig = (0, path_1.join)(dir, 'neurcode.config.json');
         if ((0, fs_1.existsSync)(legacyLocalConfig)) {
+            if (dir === homeDir &&
+                dir !== resolvedStart &&
+                process.env.NEURCODE_ALLOW_HOME_ROOT !== '1') {
+                return resolvedStart;
+            }
             return dir;
         }
+        if (boundary && dir === boundary)
+            break;
         const parent = (0, path_1.dirname)(dir);
         if (parent === dir)
             break;
         dir = parent;
     }
-    return (0, path_1.resolve)(startDir);
+    return resolvedStart;
 }
 //# sourceMappingURL=project-root.js.map

package/dist/utils/project-root.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-root.js","sourceRoot":"","sources":["../../src/utils/project-root.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;AAKH,gEAyBC;AA5BD,2BAAgC;AAChC,+BAA8C;AAE9C,SAAgB,0BAA0B,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IACzE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAChF,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,OAAO,IAAA,cAAO,EAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,GAAG,GAAG,IAAA,cAAO,EAAC,QAAQ,CAAC,CAAC;IAE5B,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,cAAc,GAAG,IAAA,WAAI,EAAC,GAAG,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;QAC7D,IAAI,IAAA,eAAU,EAAC,cAAc,CAAC,EAAE,CAAC;YAC/B,OAAO,GAAG,CAAC;QACb,CAAC;QAED,MAAM,iBAAiB,GAAG,IAAA,WAAI,EAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;QAC5D,IAAI,IAAA,eAAU,EAAC,iBAAiB,CAAC,EAAE,CAAC;YAClC,OAAO,GAAG,CAAC;QACb,CAAC;QAED,MAAM,MAAM,GAAG,IAAA,cAAO,EAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IAED,OAAO,IAAA,cAAO,EAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"project-root.js","sourceRoot":"","sources":["../../src/utils/project-root.ts"],"names":[],"mappings":"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"}

package/dist/utils/repo-links.d.ts

@@ -0,0 +1,17 @@
+export interface RepoLinkEntry {
+    alias: string;
+    path: string;
+    linkedAt: string;
+}
+export declare function canonicalizeRepoPath(pathValue: string): string;
+export declare function getRepoLinksPath(projectRoot: string): string;
+export declare function loadRepoLinks(projectRoot: string): RepoLinkEntry[];
+export declare function saveRepoLinks(projectRoot: string, links: RepoLinkEntry[]): void;
+export declare function upsertRepoLink(projectRoot: string, input: {
+    path: string;
+    alias?: string;
+}): RepoLinkEntry;
+export declare function removeRepoLink(projectRoot: string, aliasOrPath: string): RepoLinkEntry | null;
+export declare function findRepoLink(projectRoot: string, aliasOrPath: string): RepoLinkEntry | null;
+export declare function isRepoPathExplicitlyLinked(projectRoot: string, candidatePath: string): boolean;
+//# sourceMappingURL=repo-links.d.ts.map

package/dist/utils/repo-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-links.d.ts","sourceRoot":"","sources":["../../src/utils/repo-links.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAUD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAM9D;AA8BD,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,EAAE,CAoBlE;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI,CAY/E;AAED,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE;IACL,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,aAAa,CAoBf;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAmB7F;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAS3F;AAED,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAS9F"}