@monoes/monograph 1.1.0 → 1.2.0

package/dist/src/config/workspace.js

@@ -0,0 +1,106 @@
+// Discovers monorepo workspace packages, detects undeclared workspaces,
+// and parses tsconfig rootDir.
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+function readJson(path) {
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function discoverWorkspaces(root) {
+    const pkgPath = join(root, 'package.json');
+    const pkg = readJson(pkgPath);
+    if (!pkg)
+        return [];
+    const patterns = [];
+    if (Array.isArray(pkg['workspaces'])) {
+        patterns.push(...pkg['workspaces']);
+    }
+    else if (typeof pkg['workspaces'] === 'object' && pkg['workspaces'] !== null) {
+        const ws = pkg['workspaces'];
+        if (Array.isArray(ws['packages']))
+            patterns.push(...ws['packages']);
+    }
+    const results = [];
+    for (const pattern of patterns) {
+        const base = pattern.replace(/\/\*$/, '');
+        const dir = resolve(root, base);
+        if (!existsSync(dir))
+            continue;
+        try {
+            const entries = readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const wsPkgPath = join(dir, entry.name, 'package.json');
+                const wsPkg = readJson(wsPkgPath);
+                if (!wsPkg)
+                    continue;
+                results.push({
+                    name: wsPkg['name'] ?? entry.name,
+                    rootPath: resolve(dir, entry.name),
+                    packageJson: wsPkg,
+                });
+            }
+        }
+        catch { /* skip unreadable dirs */ }
+    }
+    return results;
+}
+export function findUndeclaredWorkspaces(root, declared, ignores = []) {
+    const declaredPaths = new Set(declared.map(w => resolve(w.rootPath)));
+    const diagnostics = [];
+    const packagesDir = join(root, 'packages');
+    if (!existsSync(packagesDir))
+        return diagnostics;
+    try {
+        const entries = readdirSync(packagesDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (ignores.includes(entry.name))
+                continue;
+            const candidate = resolve(packagesDir, entry.name);
+            if (declaredPaths.has(candidate))
+                continue;
+            const hasPkg = existsSync(join(candidate, 'package.json'));
+            if (hasPkg) {
+                diagnostics.push({
+                    kind: 'undeclaredWorkspace',
+                    message: `Directory "${entry.name}" has package.json but is not in workspaces`,
+                    path: candidate,
+                });
+            }
+        }
+    }
+    catch { /* skip */ }
+    return diagnostics;
+}
+export function parseTsconfigRootDir(tsconfigPath) {
+    const json = readJson(tsconfigPath);
+    if (!json)
+        return null;
+    const co = json['compilerOptions'];
+    const rootDir = co?.['rootDir'];
+    return typeof rootDir === 'string' ? rootDir : null;
+}
+export function findUndeclaredWorkspacesEnhanced(root, declared, ignores = []) {
+    const basic = findUndeclaredWorkspaces(root, declared, ignores);
+    return basic.map(d => ({
+        ...d,
+        suggestion: `Add "${d.path.replace(root, '').replace(/^\//, '')}" to the workspaces array in package.json`,
+    }));
+}
+export function validateWorkspaceDeclarations(declared, root) {
+    const diagnostics = [];
+    for (const ws of declared) {
+        if (!ws.packageJson['name']) {
+            diagnostics.push({ kind: 'missingPackageJson', message: `Workspace at "${ws.rootPath.replace(root, '')}" has no name field`, path: ws.rootPath });
+        }
+    }
+    return diagnostics;
+}
+//# sourceMappingURL=workspace.js.map

package/dist/src/config/workspace.js.map

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

package/dist/src/coverage/cloud-client.d.ts

@@ -0,0 +1,61 @@
+export type CloudRuntimeRiskBand = 'hot' | 'warm' | 'cold' | 'unknown';
+export type CloudTrackingState = 'tracked' | 'untracked' | 'partial';
+export type CloudRuntimeWarning = 'low_traffic' | 'short_window' | 'partial_coverage';
+export interface CloudRuntimeBlastRadiusEntry {
+    callerName: string;
+    callerFile: string;
+    callerLine: number;
+    trafficWeight: number;
+}
+export interface CloudRuntimeImportanceEntry {
+    name: string;
+    filePath: string;
+    importanceScore: number;
+}
+export interface CloudRuntimeFunction {
+    name: string;
+    filePath: string;
+    startLine: number;
+    hitCount: number;
+    riskBand: CloudRuntimeRiskBand;
+    importanceScore: number;
+    blastRadius: CloudRuntimeBlastRadiusEntry[];
+}
+export interface CloudRuntimeSummary {
+    totalFunctions: number;
+    hotFunctions: number;
+    coldFunctions: number;
+    unknownFunctions: number;
+    observationWindowDays: number;
+    trackingState: CloudTrackingState;
+    warnings: CloudRuntimeWarning[];
+}
+export interface CloudRuntimeContext {
+    projectId: string;
+    environment: string;
+    commitSha?: string;
+    period: string;
+    summary: CloudRuntimeSummary;
+    functions: CloudRuntimeFunction[];
+    importanceEntries: CloudRuntimeImportanceEntry[];
+}
+export type CloudErrorKind = 'AuthError' | 'TierRequired' | 'NetworkError' | 'ValidationError' | 'NotFound' | 'RateLimited';
+export interface CloudError {
+    kind: CloudErrorKind;
+    message: string;
+    exitCode: number;
+}
+export interface CloudRequest {
+    projectId: string;
+    environment?: string;
+    commitSha?: string;
+    period?: string;
+    apiKey?: string;
+    apiBase?: string;
+}
+/** Build the URL for a cloud runtime context request. */
+export declare function buildCloudRequestUrl(base: string, req: CloudRequest): string;
+/** Fetch runtime coverage context from the cloud API (stub — real impl requires HTTP client). */
+export declare function fetchRuntimeContext(req: CloudRequest): Promise<CloudRuntimeContext | CloudError>;
+export declare function isCloudError(v: CloudRuntimeContext | CloudError): v is CloudError;
+//# sourceMappingURL=cloud-client.d.ts.map

package/dist/src/coverage/cloud-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-client.d.ts","sourceRoot":"","sources":["../../../src/coverage/cloud-client.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AACvE,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AACrE,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,cAAc,GAAG,kBAAkB,CAAC;AAEtF,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,4BAA4B,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,kBAAkB,CAAC;IAClC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,mBAAmB,CAAC;IAC7B,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,iBAAiB,EAAE,2BAA2B,EAAE,CAAC;CAClD;AAED,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,cAAc,GACd,cAAc,GACd,iBAAiB,GACjB,UAAU,GACV,aAAa,CAAC;AAElB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,CAQ5E;AAED,iGAAiG;AACjG,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,mBAAmB,GAAG,UAAU,CAAC,CAoB3C;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,mBAAmB,GAAG,UAAU,GAAG,CAAC,IAAI,UAAU,CAEjF"}

package/dist/src/coverage/cloud-client.js

@@ -0,0 +1,46 @@
+// Types and stub for fetching production runtime coverage from a remote API.
+/** Build the URL for a cloud runtime context request. */
+export function buildCloudRequestUrl(base, req) {
+    const params = new URLSearchParams();
+    if (req.environment)
+        params.set('environment', req.environment);
+    if (req.commitSha)
+        params.set('commit_sha', req.commitSha);
+    if (req.period)
+        params.set('period', req.period);
+    const qs = params.toString();
+    const encoded = encodeURIComponent(req.projectId);
+    return `${base}/projects/${encoded}/runtime-context${qs ? '?' + qs : ''}`;
+}
+/** Fetch runtime coverage context from the cloud API (stub — real impl requires HTTP client). */
+export async function fetchRuntimeContext(req) {
+    const base = req.apiBase ?? 'https://api.fallow.cloud/v1';
+    const url = buildCloudRequestUrl(base, req);
+    let res;
+    try {
+        res = await fetch(url, {
+            headers: {
+                Authorization: `Bearer ${req.apiKey ?? ''}`,
+                Accept: 'application/json',
+            },
+        });
+    }
+    catch (e) {
+        return { kind: 'NetworkError', message: String(e), exitCode: 3 };
+    }
+    if (res.status === 401)
+        return { kind: 'AuthError', message: 'Invalid API key', exitCode: 4 };
+    if (res.status === 402)
+        return { kind: 'TierRequired', message: 'Feature requires paid tier', exitCode: 5 };
+    if (res.status === 429)
+        return { kind: 'RateLimited', message: 'Rate limit exceeded', exitCode: 6 };
+    if (res.status === 404)
+        return { kind: 'NotFound', message: `Project ${req.projectId} not found`, exitCode: 7 };
+    if (!res.ok)
+        return { kind: 'ValidationError', message: `HTTP ${res.status}`, exitCode: 8 };
+    return (await res.json());
+}
+export function isCloudError(v) {
+    return v.kind !== undefined && v.exitCode !== undefined;
+}
+//# sourceMappingURL=cloud-client.js.map

package/dist/src/coverage/cloud-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-client.js","sourceRoot":"","sources":["../../../src/coverage/cloud-client.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAwE7E,yDAAyD;AACzD,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,GAAiB;IAClE,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,IAAI,GAAG,CAAC,WAAW;QAAE,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IAChE,IAAI,GAAG,CAAC,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3D,IAAI,GAAG,CAAC,MAAM;QAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClD,OAAO,GAAG,IAAI,aAAa,OAAO,mBAAmB,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC5E,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAiB;IAEjB,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,IAAI,6BAA6B,CAAC;IAC1D,MAAM,GAAG,GAAG,oBAAoB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC5C,IAAI,GAAa,CAAC;IAClB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YACrB,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE;gBAC3C,MAAM,EAAE,kBAAkB;aAC3B;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACnE,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC9F,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,4BAA4B,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC5G,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACpG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,GAAG,CAAC,SAAS,YAAY,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAChH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC5F,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAwB,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAmC;IAC9D,OAAQ,CAAgB,CAAC,IAAI,KAAK,SAAS,IAAK,CAAgB,CAAC,QAAQ,KAAK,SAAS,CAAC;AAC1F,CAAC"}

package/dist/src/coverage/runtime.d.ts

@@ -0,0 +1,36 @@
+import type { MonographDb } from '../storage/db.js';
+export type RuntimeClassification = 'SafeToDelete' | 'ReviewRequired' | 'LowTraffic' | 'Active' | 'CoverageUnavailable';
+export interface FunctionCoverageEntry {
+    nodeId: string;
+    name: string;
+    filePath: string | null;
+    startLine: number | null;
+    covered: boolean;
+    callCount: number;
+    classification: RuntimeClassification;
+}
+export interface RuntimeCoverageReport {
+    entries: FunctionCoverageEntry[];
+    safeToDelete: number;
+    reviewRequired: number;
+    active: number;
+    coverageUnavailable: number;
+    blastRadius: string[];
+}
+export interface V8CoverageFunction {
+    functionName: string;
+    url: string;
+    ranges: Array<{
+        startOffset: number;
+        endOffset: number;
+        count: number;
+    }>;
+}
+export interface V8Coverage {
+    result: Array<{
+        url: string;
+        functions: V8CoverageFunction[];
+    }>;
+}
+export declare function analyzeRuntimeCoverage(db: MonographDb, coverage: V8Coverage, repoRoot?: string): RuntimeCoverageReport;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/src/coverage/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/coverage/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,MAAM,qBAAqB,GAC7B,cAAc,GACd,gBAAgB,GAChB,YAAY,GACZ,QAAQ,GACR,qBAAqB,CAAC;AAE1B,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,qBAAqB,CAAC;CACvC;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAGD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,KAAK,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,kBAAkB,EAAE,CAAC;KACjC,CAAC,CAAC;CACJ;AAeD,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,UAAU,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,qBAAqB,CA6LvB"}

package/dist/src/coverage/runtime.js

@@ -0,0 +1,187 @@
+export function analyzeRuntimeCoverage(db, coverage, repoRoot) {
+    // Build a map: filePath -> Map<functionName, CoverageMapEntry>
+    const fileCoverageMap = new Map();
+    for (const scriptCov of coverage.result) {
+        let filePath = scriptCov.url;
+        // Strip file:// prefix
+        if (filePath.startsWith('file://')) {
+            filePath = filePath.slice('file://'.length);
+        }
+        // Resolve relative to repoRoot if provided and path is relative
+        if (repoRoot && !filePath.startsWith('/')) {
+            filePath = repoRoot.replace(/\/$/, '') + '/' + filePath;
+        }
+        const fnMap = fileCoverageMap.get(filePath) ?? new Map();
+        for (const fn of scriptCov.functions) {
+            const covered = fn.ranges.some(r => r.count > 0);
+            const callCount = fn.ranges.reduce((max, r) => Math.max(max, r.count), 0);
+            const existing = fnMap.get(fn.functionName);
+            if (!existing || callCount > existing.callCount) {
+                fnMap.set(fn.functionName, { covered, callCount });
+            }
+        }
+        fileCoverageMap.set(filePath, fnMap);
+    }
+    // Helper: normalize a file path for lookup
+    function normalizeForLookup(fp) {
+        return fp.replace(/\\/g, '/');
+    }
+    // Build alternate lookup: basename -> filePath list
+    const filePathIndex = new Map();
+    for (const fp of fileCoverageMap.keys()) {
+        const norm = normalizeForLookup(fp);
+        filePathIndex.set(norm, (filePathIndex.get(norm) ?? []).concat(fp));
+        // Also store by just the filename for relative matching
+        const parts = norm.split('/');
+        const base = parts[parts.length - 1];
+        if (base && base !== norm) {
+            filePathIndex.set(base, (filePathIndex.get(base) ?? []).concat(fp));
+        }
+    }
+    // Compute total call count across all functions for LowTraffic threshold
+    let totalCallCount = 0;
+    for (const fnMap of fileCoverageMap.values()) {
+        for (const entry of fnMap.values()) {
+            totalCallCount += entry.callCount;
+        }
+    }
+    const lowTrafficThreshold = totalCallCount * 0.05;
+    // Query all Symbol nodes that are Functions/Methods
+    const rows = db.prepare(`
+    SELECT id, name, file_path, start_line, properties
+    FROM nodes
+    WHERE label IN ('Function', 'Method')
+  `).all();
+    const entries = [];
+    for (const row of rows) {
+        const props = row.properties ? JSON.parse(row.properties) : {};
+        const reachabilityRole = props.reachabilityRole ?? '';
+        let fnEntry = null;
+        if (row.file_path) {
+            const normFilePath = normalizeForLookup(row.file_path);
+            // Try exact match first
+            const exactFnMap = fileCoverageMap.get(normFilePath) ?? fileCoverageMap.get(row.file_path);
+            if (exactFnMap) {
+                const match = exactFnMap.get(row.name);
+                if (match)
+                    fnEntry = match;
+                // If no exact function name match, aggregate all functions for this file
+                if (!fnEntry) {
+                    // Best-effort: file is covered if any function is covered
+                    let fileCovered = false;
+                    let fileMaxCount = 0;
+                    for (const e of exactFnMap.values()) {
+                        if (e.covered)
+                            fileCovered = true;
+                        fileMaxCount = Math.max(fileMaxCount, e.callCount);
+                    }
+                    if (exactFnMap.size > 0) {
+                        fnEntry = { covered: fileCovered, callCount: fileMaxCount };
+                    }
+                }
+            }
+            else {
+                // Try relative path matching
+                for (const [covPath, fnMap] of fileCoverageMap.entries()) {
+                    if (covPath.endsWith(normFilePath) || normFilePath.endsWith(covPath.replace(/.*\//, ''))) {
+                        const match = fnMap.get(row.name);
+                        if (match) {
+                            fnEntry = match;
+                            break;
+                        }
+                        // Aggregate file-level coverage
+                        let fileCovered = false;
+                        let fileMaxCount = 0;
+                        for (const e of fnMap.values()) {
+                            if (e.covered)
+                                fileCovered = true;
+                            fileMaxCount = Math.max(fileMaxCount, e.callCount);
+                        }
+                        if (fnMap.size > 0) {
+                            fnEntry = { covered: fileCovered, callCount: fileMaxCount };
+                            break;
+                        }
+                    }
+                }
+            }
+        }
+        let classification;
+        let covered = false;
+        let callCount = 0;
+        if (!fnEntry) {
+            classification = 'CoverageUnavailable';
+        }
+        else {
+            covered = fnEntry.covered;
+            callCount = fnEntry.callCount;
+            if (!covered && reachabilityRole === 'unreachable') {
+                classification = 'SafeToDelete';
+            }
+            else if (covered && reachabilityRole === 'unreachable') {
+                classification = 'ReviewRequired';
+            }
+            else if (covered && callCount < lowTrafficThreshold) {
+                classification = 'LowTraffic';
+            }
+            else if (covered) {
+                classification = 'Active';
+            }
+            else {
+                // not covered, not unreachable — treat as unavailable
+                classification = 'CoverageUnavailable';
+            }
+        }
+        entries.push({
+            nodeId: row.id,
+            name: row.name,
+            filePath: row.file_path,
+            startLine: row.start_line,
+            covered,
+            callCount,
+            classification,
+        });
+    }
+    // Aggregate counts
+    let safeToDelete = 0;
+    let reviewRequired = 0;
+    let active = 0;
+    let coverageUnavailable = 0;
+    const blastRadiusSet = new Set();
+    for (const entry of entries) {
+        switch (entry.classification) {
+            case 'SafeToDelete':
+                safeToDelete++;
+                break;
+            case 'ReviewRequired':
+                reviewRequired++;
+                break;
+            case 'Active':
+                active++;
+                break;
+            case 'CoverageUnavailable':
+                coverageUnavailable++;
+                break;
+        }
+        // BlastRadius: Active nodes with reachabilityRole === 'runtime'
+        if (entry.classification === 'Active' && entry.filePath) {
+            const nodeProps = entries.find(e => e.nodeId === entry.nodeId);
+            // Re-query to get reachabilityRole for blast radius check
+            const nodeRow = db.prepare(`SELECT properties FROM nodes WHERE id = ?`).get(entry.nodeId);
+            if (nodeRow) {
+                const p = nodeRow.properties ? JSON.parse(nodeRow.properties) : {};
+                if (p.reachabilityRole === 'runtime') {
+                    blastRadiusSet.add(entry.filePath);
+                }
+            }
+        }
+    }
+    return {
+        entries,
+        safeToDelete,
+        reviewRequired,
+        active,
+        coverageUnavailable,
+        blastRadius: Array.from(blastRadiusSet),
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/src/coverage/runtime.js.map

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

package/dist/src/coverage/upload-inventory.d.ts

@@ -0,0 +1,29 @@
+export declare const INVENTORY_MAX_FUNCTIONS = 200000;
+export interface InventoryFunction {
+    name: string;
+    filePath: string;
+    startLine: number;
+    endLine: number;
+}
+export interface UploadInventoryArgs {
+    projectId: string;
+    root: string;
+    pathPrefix?: string;
+    apiKey?: string;
+    apiBase?: string;
+    failOnDirty?: boolean;
+}
+export interface UploadInventoryResult {
+    uploaded: number;
+    skipped: number;
+    warnings: string[];
+}
+/** Rebase container WORKDIR path prefix to repo-relative path. */
+export declare function normalizePathPrefix(raw: string): string;
+/** Attempt to derive a project ID slug from a git remote URL. */
+export declare function parseGitRemoteToProjectId(url: string): string;
+/** Extract function inventory from a source text (heuristic, no full AST). */
+export declare function extractFunctionInventory(source: string, filePath: string): InventoryFunction[];
+/** Upload a function inventory to the cloud API. */
+export declare function uploadInventory(args: UploadInventoryArgs, functions: InventoryFunction[]): Promise<UploadInventoryResult>;
+//# sourceMappingURL=upload-inventory.d.ts.map

package/dist/src/coverage/upload-inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-inventory.d.ts","sourceRoot":"","sources":["../../../src/coverage/upload-inventory.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,uBAAuB,SAAU,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,iEAAiE;AACjE,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED,8EAA8E;AAC9E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAe9F;AAED,oDAAoD;AACpD,wBAAsB,eAAe,CACnC,IAAI,EAAE,mBAAmB,EACzB,SAAS,EAAE,iBAAiB,EAAE,GAC7B,OAAO,CAAC,qBAAqB,CAAC,CAuBhC"}

package/dist/src/coverage/upload-inventory.js

@@ -0,0 +1,51 @@
+// Walks source files, extracts function declarations, and uploads a keyed inventory
+// for the "untracked functions" three-state coverage model.
+export const INVENTORY_MAX_FUNCTIONS = 200_000;
+/** Rebase container WORKDIR path prefix to repo-relative path. */
+export function normalizePathPrefix(raw) {
+    return raw.replace(/\\/g, '/').replace(/\/$/, '');
+}
+/** Attempt to derive a project ID slug from a git remote URL. */
+export function parseGitRemoteToProjectId(url) {
+    const match = url.match(/[:/]([^/]+\/[^/]+?)(?:\.git)?$/);
+    return match ? match[1].replace('/', '_') : 'unknown';
+}
+/** Extract function inventory from a source text (heuristic, no full AST). */
+export function extractFunctionInventory(source, filePath) {
+    const results = [];
+    const lines = source.split('\n');
+    const funcRe = /(?:^|\s)(?:function|async function|const|let|var)\s+([a-zA-Z_$][\w$]*)\s*(?:=\s*(?:async\s*)?\(|[(<])/;
+    const arrowRe = /(?:^|\s)(?:const|let|var)\s+([a-zA-Z_$][\w$]*)\s*=\s*(?:async\s*)?\(/;
+    const methodRe = /^\s*(?:async\s+)?([a-zA-Z_$][\w$]*)\s*\(/;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const m = funcRe.exec(line) ?? arrowRe.exec(line) ?? methodRe.exec(line);
+        if (m && m[1] && !['if', 'while', 'for', 'switch', 'catch'].includes(m[1])) {
+            results.push({ name: m[1], filePath, startLine: i + 1, endLine: i + 1 });
+        }
+    }
+    return results;
+}
+/** Upload a function inventory to the cloud API. */
+export async function uploadInventory(args, functions) {
+    const base = args.apiBase ?? 'https://api.fallow.cloud/v1';
+    const capped = functions.slice(0, INVENTORY_MAX_FUNCTIONS);
+    const warnings = [];
+    if (functions.length > INVENTORY_MAX_FUNCTIONS) {
+        warnings.push(`Inventory capped at ${INVENTORY_MAX_FUNCTIONS} functions (${functions.length} found)`);
+    }
+    const res = await fetch(`${base}/projects/${encodeURIComponent(args.projectId)}/inventory`, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${args.apiKey ?? ''}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ functions: capped, pathPrefix: args.pathPrefix }),
+    });
+    if (!res.ok) {
+        warnings.push(`Upload failed: HTTP ${res.status}`);
+        return { uploaded: 0, skipped: functions.length, warnings };
+    }
+    return { uploaded: capped.length, skipped: functions.length - capped.length, warnings };
+}
+//# sourceMappingURL=upload-inventory.js.map

package/dist/src/coverage/upload-inventory.js.map

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

package/dist/src/coverage/upload-source-maps.d.ts

@@ -0,0 +1,30 @@
+export interface UploadSourceMapsArgs {
+    projectId: string;
+    sourceDir: string;
+    include?: string[];
+    exclude?: string[];
+    stripPath?: string;
+    concurrency?: number;
+    retries?: number;
+    failFast?: boolean;
+    apiKey?: string;
+    apiBase?: string;
+}
+export interface SourceMapFile {
+    originalPath: string;
+    uploadPath: string;
+    sizeBytes: number;
+}
+export interface UploadSourceMapsResult {
+    uploaded: number;
+    failed: number;
+    skipped: number;
+    warnings: string[];
+}
+/** Strip a path prefix from a file path. */
+export declare function applyStripPath(filePath: string, strip: string): string;
+/** Collect .map files from a directory (shallow heuristic — no actual fs walk in library mode). */
+export declare function collectSourceMaps(files: string[], include?: string[], exclude?: string[], stripPath?: string): SourceMapFile[];
+/** Upload source map files to the cloud API. */
+export declare function uploadSourceMaps(args: UploadSourceMapsArgs, files: SourceMapFile[]): Promise<UploadSourceMapsResult>;
+//# sourceMappingURL=upload-source-maps.d.ts.map

package/dist/src/coverage/upload-source-maps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-source-maps.d.ts","sourceRoot":"","sources":["../../../src/coverage/upload-source-maps.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,4CAA4C;AAC5C,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAItE;AAED,mGAAmG;AACnG,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,GAAE,MAAM,EAAiB,EAChC,OAAO,GAAE,MAAM,EAAqB,EACpC,SAAS,CAAC,EAAE,MAAM,GACjB,aAAa,EAAE,CAUjB;AAED,gDAAgD;AAChD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,aAAa,EAAE,GACrB,OAAO,CAAC,sBAAsB,CAAC,CAuCjC"}