@neurcode-ai/cli 0.9.30 → 0.9.32

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"}

package/dist/utils/repo-links.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canonicalizeRepoPath = canonicalizeRepoPath;
+exports.getRepoLinksPath = getRepoLinksPath;
+exports.loadRepoLinks = loadRepoLinks;
+exports.saveRepoLinks = saveRepoLinks;
+exports.upsertRepoLink = upsertRepoLink;
+exports.removeRepoLink = removeRepoLink;
+exports.findRepoLink = findRepoLink;
+exports.isRepoPathExplicitlyLinked = isRepoPathExplicitlyLinked;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const REPO_LINKS_FILENAME = 'repo-links.json';
+function canonicalizeRepoPath(pathValue) {
+    try {
+        return (0, fs_1.realpathSync)(pathValue);
+    }
+    catch {
+        return (0, path_1.resolve)(pathValue);
+    }
+}
+function isPathWithin(parent, candidate) {
+    const rel = (0, path_1.relative)(parent, candidate);
+    return rel === '' || (!rel.startsWith('..') && !(0, path_1.isAbsolute)(rel));
+}
+function normalizeAlias(input) {
+    const trimmed = input.trim().toLowerCase();
+    if (!trimmed)
+        return '';
+    return trimmed.replace(/[^a-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '');
+}
+function dedupeByAliasAndPath(links) {
+    const byAlias = new Map();
+    for (const link of links) {
+        const aliasKey = normalizeAlias(link.alias);
+        const normalizedPath = canonicalizeRepoPath(link.path);
+        if (!aliasKey || !normalizedPath)
+            continue;
+        if (!byAlias.has(aliasKey)) {
+            byAlias.set(aliasKey, {
+                alias: aliasKey,
+                path: normalizedPath,
+                linkedAt: link.linkedAt || new Date().toISOString(),
+            });
+        }
+    }
+    return Array.from(byAlias.values()).sort((a, b) => a.alias.localeCompare(b.alias));
+}
+function getRepoLinksPath(projectRoot) {
+    return (0, path_1.join)(projectRoot, '.neurcode', REPO_LINKS_FILENAME);
+}
+function loadRepoLinks(projectRoot) {
+    const pathValue = getRepoLinksPath(projectRoot);
+    if (!(0, fs_1.existsSync)(pathValue)) {
+        return [];
+    }
+    try {
+        const parsed = JSON.parse((0, fs_1.readFileSync)(pathValue, 'utf-8'));
+        if (!parsed || parsed.version !== 1 || !Array.isArray(parsed.links)) {
+            return [];
+        }
+        return dedupeByAliasAndPath(parsed.links.map((link) => ({
+            alias: typeof link.alias === 'string' ? link.alias : '',
+            path: typeof link.path === 'string' ? link.path : '',
+            linkedAt: typeof link.linkedAt === 'string' ? link.linkedAt : '',
+        })));
+    }
+    catch {
+        return [];
+    }
+}
+function saveRepoLinks(projectRoot, links) {
+    const pathValue = getRepoLinksPath(projectRoot);
+    const dir = (0, path_1.join)(projectRoot, '.neurcode');
+    if (!(0, fs_1.existsSync)(dir)) {
+        (0, fs_1.mkdirSync)(dir, { recursive: true });
+    }
+    const payload = {
+        version: 1,
+        updatedAt: new Date().toISOString(),
+        links: dedupeByAliasAndPath(links),
+    };
+    (0, fs_1.writeFileSync)(pathValue, JSON.stringify(payload, null, 2) + '\n', 'utf-8');
+}
+function upsertRepoLink(projectRoot, input) {
+    const current = loadRepoLinks(projectRoot);
+    const canonicalPath = canonicalizeRepoPath(input.path);
+    const aliasInput = input.alias?.trim() || (0, path_1.basename)(canonicalPath);
+    const alias = normalizeAlias(aliasInput);
+    if (!alias) {
+        throw new Error('Alias could not be derived from provided input.');
+    }
+    const filtered = current.filter((link) => normalizeAlias(link.alias) !== alias && canonicalizeRepoPath(link.path) !== canonicalPath);
+    const next = {
+        alias,
+        path: canonicalPath,
+        linkedAt: new Date().toISOString(),
+    };
+    filtered.push(next);
+    saveRepoLinks(projectRoot, filtered);
+    return next;
+}
+function removeRepoLink(projectRoot, aliasOrPath) {
+    const current = loadRepoLinks(projectRoot);
+    const canonical = canonicalizeRepoPath(aliasOrPath);
+    const alias = normalizeAlias(aliasOrPath);
+    const removed = current.find((link) => normalizeAlias(link.alias) === alias || canonicalizeRepoPath(link.path) === canonical);
+    if (!removed) {
+        return null;
+    }
+    const remaining = current.filter((link) => normalizeAlias(link.alias) !== normalizeAlias(removed.alias) &&
+        canonicalizeRepoPath(link.path) !== canonicalizeRepoPath(removed.path));
+    saveRepoLinks(projectRoot, remaining);
+    return removed;
+}
+function findRepoLink(projectRoot, aliasOrPath) {
+    const canonical = canonicalizeRepoPath(aliasOrPath);
+    const alias = normalizeAlias(aliasOrPath);
+    for (const link of loadRepoLinks(projectRoot)) {
+        if (normalizeAlias(link.alias) === alias || canonicalizeRepoPath(link.path) === canonical) {
+            return link;
+        }
+    }
+    return null;
+}
+function isRepoPathExplicitlyLinked(projectRoot, candidatePath) {
+    const canonicalCandidate = canonicalizeRepoPath(candidatePath);
+    for (const link of loadRepoLinks(projectRoot)) {
+        const canonicalLink = canonicalizeRepoPath(link.path);
+        if (canonicalLink === canonicalCandidate || isPathWithin(canonicalLink, canonicalCandidate)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=repo-links.js.map

package/dist/utils/repo-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-links.js","sourceRoot":"","sources":["../../src/utils/repo-links.ts"],"names":[],"mappings":";;AAiBA,oDAMC;AA8BD,4CAEC;AAED,sCAoBC;AAED,sCAYC;AAED,wCA0BC;AAED,wCAmBC;AAED,oCASC;AAED,gEASC;AAlKD,2BAAsF;AACtF,+BAAqE;AAcrE,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAE9C,SAAgB,oBAAoB,CAAC,SAAiB;IACpD,IAAI,CAAC;QACH,OAAO,IAAA,iBAAY,EAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAA,cAAO,EAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,MAAc,EAAE,SAAiB;IACrD,MAAM,GAAG,GAAG,IAAA,eAAQ,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACxC,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAA,iBAAU,EAAC,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAsB;IAClD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IACjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,cAAc,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,CAAC,QAAQ,IAAI,CAAC,cAAc;YAAE,SAAS;QAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE;gBACpB,KAAK,EAAE,QAAQ;gBACf,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AACrF,CAAC;AAED,SAAgB,gBAAgB,CAAC,WAAmB;IAClD,OAAO,IAAA,WAAI,EAAC,WAAW,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC;AAC7D,CAAC;AAED,SAAgB,aAAa,CAAC,WAAmB;IAC/C,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAChD,IAAI,CAAC,IAAA,eAAU,EAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,SAAS,EAAE,OAAO,CAAC,CAA2B,CAAC;QACtF,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACpE,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,oBAAoB,CACzB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1B,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YACvD,IAAI,EAAE,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;YACpD,QAAQ,EAAE,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;SACjE,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAgB,aAAa,CAAC,WAAmB,EAAE,KAAsB;IACvE,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAA,eAAU,EAAC,GAAG,CAAC,EAAE,CAAC;QACrB,IAAA,cAAS,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,OAAO,GAAkB;QAC7B,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,KAAK,EAAE,oBAAoB,CAAC,KAAK,CAAC;KACnC,CAAC;IACF,IAAA,kBAAa,EAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED,SAAgB,cAAc,CAC5B,WAAmB,EACnB,KAGC;IAED,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,IAAA,eAAQ,EAAC,aAAa,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAC7B,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,aAAa,CACpG,CAAC;IACF,MAAM,IAAI,GAAkB;QAC1B,KAAK;QACL,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACnC,CAAC;IACF,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,aAAa,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,cAAc,CAAC,WAAmB,EAAE,WAAmB;IACrE,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAE1C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAC1B,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,SAAS,CAChG,CAAC;IACF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAC9B,CAAC,IAAI,EAAE,EAAE,CACP,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC;QAC5D,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC,CACzE,CAAC;IACF,aAAa,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACtC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,YAAY,CAAC,WAAmB,EAAE,WAAmB;IACnE,MAAM,SAAS,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9C,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAC1F,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,0BAA0B,CAAC,WAAmB,EAAE,aAAqB;IACnF,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAC/D,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9C,MAAM,aAAa,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,aAAa,KAAK,kBAAkB,IAAI,YAAY,CAAC,aAAa,EAAE,kBAAkB,CAAC,EAAE,CAAC;YAC5F,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neurcode-ai/cli",
-  "version": "0.9.30",
+  "version": "0.9.32",
   "description": "Neurcode CLI - AI code governance and diff analysis",
   "bin": {
     "neurcode": "dist/index.js"
@@ -45,10 +45,10 @@
     "ts-morph": "^24.0.0",
     "uuid": "^9.0.1",
     "zod": "^4.3.5",
-    "@neurcode-ai/core": "0.1.0",
-    "@neurcode-ai/brain": "0.1.0",
     "@neurcode-ai/analysis": "0.1.0",
-    "@neurcode-ai/policy": "0.1.0"
+    "@neurcode-ai/policy": "0.1.0",
+    "@neurcode-ai/brain": "0.1.0",
+    "@neurcode-ai/core": "0.1.0"
   },
   "publishConfig": {
     "access": "public"