@monoes/monograph 1.0.0 → 1.2.0

package/dist/src/error/fallow-error.d.ts

@@ -0,0 +1,50 @@
+export type FallowErrorKind = {
+    kind: 'FileReadError';
+    path: string;
+    cause?: string;
+} | {
+    kind: 'ParseError';
+    path?: string;
+    message: string;
+} | {
+    kind: 'ResolveError';
+    specifier: string;
+    fromFile?: string;
+} | {
+    kind: 'ConfigError';
+    field?: string;
+    message: string;
+} | {
+    kind: 'GitError';
+    command: string;
+    message: string;
+} | {
+    kind: 'IoError';
+    message: string;
+};
+export interface FallowErrorOptions {
+    code?: string;
+    help?: string;
+    context?: string;
+}
+export declare class FallowError extends Error {
+    readonly errorKind: FallowErrorKind;
+    readonly code?: string;
+    readonly help?: string;
+    readonly context?: string;
+    constructor(kind: FallowErrorKind, opts?: FallowErrorOptions);
+    withHelp(help: string): FallowError;
+    withContext(context: string): FallowError;
+    withCode(code: string): FallowError;
+    format(): string;
+    static formatMessage(kind: FallowErrorKind): string;
+    static fileRead(filePath: string, cause?: string): FallowError;
+    static parse(message: string, filePath?: string): FallowError;
+    static resolve(specifier: string, fromFile?: string): FallowError;
+    static config(message: string, field?: string): FallowError;
+    static git(command: string, message: string): FallowError;
+    static io(message: string): FallowError;
+}
+export declare function isFallowError(err: unknown): err is FallowError;
+export declare function formatFallowError(err: unknown): string;
+//# sourceMappingURL=fallow-error.d.ts.map

package/dist/src/error/fallow-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallow-error.d.ts","sourceRoot":"","sources":["../../../src/error/fallow-error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEd,IAAI,EAAE,eAAe,EAAE,IAAI,GAAE,kBAAuB;IAShE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAInC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;IAIzC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAInC,MAAM,IAAI,MAAM;IAQhB,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM;IAWnD,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW;IAI9D,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW;IAI7D,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW;IAIjE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW;IAI3D,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW;IAIzD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;CAGxC;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAE9D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAItD"}

package/dist/src/error/fallow-error.js

@@ -0,0 +1,72 @@
+export class FallowError extends Error {
+    errorKind;
+    code;
+    help;
+    context;
+    constructor(kind, opts = {}) {
+        super(FallowError.formatMessage(kind));
+        this.name = 'FallowError';
+        this.errorKind = kind;
+        this.code = opts.code;
+        this.help = opts.help;
+        this.context = opts.context;
+    }
+    withHelp(help) {
+        return new FallowError(this.errorKind, { code: this.code, help, context: this.context });
+    }
+    withContext(context) {
+        return new FallowError(this.errorKind, { code: this.code, help: this.help, context });
+    }
+    withCode(code) {
+        return new FallowError(this.errorKind, { code, help: this.help, context: this.context });
+    }
+    format() {
+        const parts = [this.message];
+        if (this.code)
+            parts.unshift(`[${this.code}]`);
+        if (this.context)
+            parts.push(`  Context: ${this.context}`);
+        if (this.help)
+            parts.push(`  Help: ${this.help}`);
+        return parts.join('\n');
+    }
+    static formatMessage(kind) {
+        switch (kind.kind) {
+            case 'FileReadError': return `Failed to read file: ${kind.path}${kind.cause ? ` (${kind.cause})` : ''}`;
+            case 'ParseError': return `Parse error${kind.path ? ` in ${kind.path}` : ''}: ${kind.message}`;
+            case 'ResolveError': return `Cannot resolve '${kind.specifier}'${kind.fromFile ? ` from ${kind.fromFile}` : ''}`;
+            case 'ConfigError': return `Configuration error${kind.field ? ` (${kind.field})` : ''}: ${kind.message}`;
+            case 'GitError': return `Git error running '${kind.command}': ${kind.message}`;
+            case 'IoError': return `I/O error: ${kind.message}`;
+        }
+    }
+    static fileRead(filePath, cause) {
+        return new FallowError({ kind: 'FileReadError', path: filePath, cause }, { code: 'E001' });
+    }
+    static parse(message, filePath) {
+        return new FallowError({ kind: 'ParseError', path: filePath, message }, { code: 'E002' });
+    }
+    static resolve(specifier, fromFile) {
+        return new FallowError({ kind: 'ResolveError', specifier, fromFile }, { code: 'E003' });
+    }
+    static config(message, field) {
+        return new FallowError({ kind: 'ConfigError', field, message }, { code: 'E004' });
+    }
+    static git(command, message) {
+        return new FallowError({ kind: 'GitError', command, message }, { code: 'E005' });
+    }
+    static io(message) {
+        return new FallowError({ kind: 'IoError', message }, { code: 'E006' });
+    }
+}
+export function isFallowError(err) {
+    return err instanceof FallowError;
+}
+export function formatFallowError(err) {
+    if (err instanceof FallowError)
+        return err.format();
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+//# sourceMappingURL=fallow-error.js.map

package/dist/src/error/fallow-error.js.map

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

package/dist/src/error.d.ts

@@ -0,0 +1,20 @@
+export type OutputFormat = 'text' | 'json' | 'compact';
+export interface MonographError {
+    code: string;
+    message: string;
+    details?: string;
+}
+export declare function emitError(message: string, exitCode: number, output: OutputFormat): MonographError;
+export declare function formatError(err: MonographError, output: OutputFormat): string;
+export declare class MonographAnalysisError extends Error {
+    readonly code: string;
+    readonly details?: string | undefined;
+    constructor(message: string, code: string, details?: string | undefined);
+}
+export declare class MonographConfigError extends MonographAnalysisError {
+    constructor(message: string, details?: string);
+}
+export declare class MonographResolveError extends MonographAnalysisError {
+    constructor(message: string, details?: string);
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/src/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,cAAc,CAQjG;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAG7E;AAED,qBAAa,sBAAuB,SAAQ,KAAK;aAG7B,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,MAAM;gBAFhC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,YAAA;CAKnC;AAED,qBAAa,oBAAqB,SAAQ,sBAAsB;gBAClD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAI9C;AAED,qBAAa,qBAAsB,SAAQ,sBAAsB;gBACnD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAI9C"}

package/dist/src/error.js

@@ -0,0 +1,38 @@
+export function emitError(message, exitCode, output) {
+    const err = { code: `E${exitCode}`, message };
+    if (output === 'json') {
+        process.stderr.write(JSON.stringify({ error: err }) + '\n');
+    }
+    else {
+        process.stderr.write(`Error: ${message}\n`);
+    }
+    return err;
+}
+export function formatError(err, output) {
+    if (output === 'json')
+        return JSON.stringify({ error: err });
+    return `Error [${err.code}]: ${err.message}${err.details ? '\n' + err.details : ''}`;
+}
+export class MonographAnalysisError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'MonographAnalysisError';
+    }
+}
+export class MonographConfigError extends MonographAnalysisError {
+    constructor(message, details) {
+        super(message, 'CONFIG_ERROR', details);
+        this.name = 'MonographConfigError';
+    }
+}
+export class MonographResolveError extends MonographAnalysisError {
+    constructor(message, details) {
+        super(message, 'RESOLVE_ERROR', details);
+        this.name = 'MonographResolveError';
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/src/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,QAAgB,EAAE,MAAoB;IAC/E,MAAM,GAAG,GAAmB,EAAE,IAAI,EAAE,IAAI,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC;IAC9D,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAmB,EAAE,MAAoB;IACnE,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7D,OAAO,UAAU,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACvF,CAAC;AAED,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAG7B;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,OAAgB;QAEhC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAS;QAGhC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,sBAAsB;IAC9D,YAAY,OAAe,EAAE,OAAgB;QAC3C,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,sBAAsB;IAC/D,YAAY,OAAe,EAAE,OAAgB;QAC3C,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/dist/src/export/adjacency-matrix.d.ts

@@ -0,0 +1,32 @@
+import type { MonographNode, MonographEdge } from '../types.js';
+import type { MonographDb } from '../storage/db.js';
+export interface AdjacencyMatrix {
+    /** Ordered node ids (row/column headers). */
+    nodeIds: string[];
+    /** Ordered node names, parallel to nodeIds. */
+    nodeNames: string[];
+    /** n×n matrix where matrix[i][j] = number of edges from nodeIds[i] to nodeIds[j]. */
+    matrix: number[][];
+}
+/**
+ * Build an adjacency matrix from a set of nodes and edges.
+ *
+ * Multi-edges (same source→target pair) are counted, so the matrix
+ * contains edge-counts rather than simple 0/1 booleans.
+ *
+ * @param nodes - The node list (defines row/column order).
+ * @param edges - The edge list.
+ * @returns An AdjacencyMatrix with nodeIds, nodeNames, and the n×n matrix.
+ */
+export declare function buildAdjacencyMatrix(nodes: MonographNode[], edges: MonographEdge[]): AdjacencyMatrix;
+/**
+ * Build an adjacency matrix directly from a MonographDb.
+ * Optionally restrict to a subset of node ids.
+ */
+export declare function buildAdjacencyMatrixFromDb(db: MonographDb, nodeIds?: string[]): AdjacencyMatrix;
+/**
+ * Serialise an AdjacencyMatrix to a CSV string.
+ * The first row and first column are node names (headers).
+ */
+export declare function adjacencyMatrixToCsv(am: AdjacencyMatrix): string;
+//# sourceMappingURL=adjacency-matrix.d.ts.map

package/dist/src/export/adjacency-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adjacency-matrix.d.ts","sourceRoot":"","sources":["../../../src/export/adjacency-matrix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qFAAqF;IACrF,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;CACpB;AAID;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EAAE,EACtB,KAAK,EAAE,aAAa,EAAE,GACrB,eAAe,CAwBjB;AAID;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,WAAW,EACf,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,eAAe,CA+CjB;AAID;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,eAAe,GAAG,MAAM,CAOhE"}

package/dist/src/export/adjacency-matrix.js

@@ -0,0 +1,88 @@
+// ── Builder ────────────────────────────────────────────────────────────────────
+/**
+ * Build an adjacency matrix from a set of nodes and edges.
+ *
+ * Multi-edges (same source→target pair) are counted, so the matrix
+ * contains edge-counts rather than simple 0/1 booleans.
+ *
+ * @param nodes - The node list (defines row/column order).
+ * @param edges - The edge list.
+ * @returns An AdjacencyMatrix with nodeIds, nodeNames, and the n×n matrix.
+ */
+export function buildAdjacencyMatrix(nodes, edges) {
+    const nodeIds = nodes.map(n => n.id);
+    const nodeNames = nodes.map(n => n.name);
+    const indexMap = new Map(nodeIds.map((id, i) => [id, i]));
+    const n = nodeIds.length;
+    if (n > 5000) {
+        throw new Error(`adjacency matrix would be ${n}×${n} (${n * n} cells). ` +
+            'Pass a pre-filtered node list via the nodeIds parameter, or use a different export format.');
+    }
+    const matrix = Array.from({ length: n }, () => new Array(n).fill(0));
+    for (const edge of edges) {
+        const si = indexMap.get(edge.sourceId);
+        const ti = indexMap.get(edge.targetId);
+        if (si !== undefined && ti !== undefined) {
+            matrix[si][ti]++;
+        }
+    }
+    return { nodeIds, nodeNames, matrix };
+}
+// ── DB-backed variant ──────────────────────────────────────────────────────────
+/**
+ * Build an adjacency matrix directly from a MonographDb.
+ * Optionally restrict to a subset of node ids.
+ */
+export function buildAdjacencyMatrixFromDb(db, nodeIds) {
+    let nodeRows;
+    if (nodeIds && nodeIds.length > 0) {
+        const ph = nodeIds.map(() => '?').join(',');
+        nodeRows = db
+            .prepare(`SELECT id, name FROM nodes WHERE id IN (${ph})`)
+            .all(...nodeIds);
+    }
+    else {
+        nodeRows = db.prepare('SELECT id, name FROM nodes').all();
+    }
+    const nodes = nodeRows.map(r => ({
+        id: r.id,
+        label: 'Function', // placeholder; only id/name needed here
+        name: r.name,
+        normLabel: r.name.toLowerCase(),
+        isExported: false,
+    }));
+    const nodeIdSet = new Set(nodeRows.map(r => r.id));
+    let edgeRows;
+    if (nodeIds && nodeIds.length > 0) {
+        const ph = nodeIds.map(() => '?').join(',');
+        edgeRows = db
+            .prepare(`SELECT source_id, target_id FROM edges WHERE source_id IN (${ph}) AND target_id IN (${ph})`)
+            .all(...nodeIds, ...nodeIds);
+    }
+    else {
+        edgeRows = db.prepare('SELECT source_id, target_id FROM edges').all();
+    }
+    const edges = edgeRows
+        .filter(r => nodeIdSet.has(r.source_id) && nodeIdSet.has(r.target_id))
+        .map((r, i) => ({
+        id: `e${i}`,
+        sourceId: r.source_id,
+        targetId: r.target_id,
+        relation: 'REFERENCES',
+        confidence: 'EXTRACTED',
+        confidenceScore: 1,
+    }));
+    return buildAdjacencyMatrix(nodes, edges);
+}
+// ── CSV serialiser ─────────────────────────────────────────────────────────────
+/**
+ * Serialise an AdjacencyMatrix to a CSV string.
+ * The first row and first column are node names (headers).
+ */
+export function adjacencyMatrixToCsv(am) {
+    const escape = (s) => `"${s.replace(/"/g, '""')}"`;
+    const header = ['', ...am.nodeNames.map(escape)].join(',');
+    const rows = am.matrix.map((row, i) => [escape(am.nodeNames[i]), ...row.map(String)].join(','));
+    return [header, ...rows].join('\n');
+}
+//# sourceMappingURL=adjacency-matrix.js.map

package/dist/src/export/adjacency-matrix.js.map

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

package/dist/src/export/analysis-json.d.ts

@@ -0,0 +1,39 @@
+export declare const ANALYSIS_JSON_SCHEMA_VERSION = 1;
+export interface AnalysisEnvelopeOptions {
+    elapsedMs?: number;
+    entryCount?: number;
+    schemaVersion?: number;
+}
+export interface AnalysisResultsEnvelope {
+    schemaVersion: number;
+    kind: 'analysis';
+    elapsedMs: number;
+    entryCount: number;
+    totalIssues: number;
+    results: unknown;
+}
+export interface HealthResultsEnvelope {
+    schemaVersion: number;
+    kind: 'health';
+    elapsedMs: number;
+    totalFindings: number;
+    includesExplanations: boolean;
+    results: unknown;
+}
+export interface DuplicationResultsEnvelope {
+    schemaVersion: number;
+    kind: 'duplication';
+    elapsedMs: number;
+    cloneGroups: number;
+    includesExplanations: boolean;
+    results: unknown;
+}
+export declare function buildAnalysisResultsEnvelope(results: unknown, totalIssues: number, opts?: AnalysisEnvelopeOptions): AnalysisResultsEnvelope;
+export declare function buildHealthResultsEnvelope(results: unknown, totalFindings: number, opts?: AnalysisEnvelopeOptions & {
+    includesExplanations?: boolean;
+}): HealthResultsEnvelope;
+export declare function buildDuplicationResultsEnvelope(results: unknown, cloneGroups: number, opts?: AnalysisEnvelopeOptions & {
+    includesExplanations?: boolean;
+}): DuplicationResultsEnvelope;
+export declare function stripRootPrefix(obj: unknown, rootPrefix: string): unknown;
+//# sourceMappingURL=analysis-json.d.ts.map

package/dist/src/export/analysis-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-json.d.ts","sourceRoot":"","sources":["../../../src/export/analysis-json.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,uBAA4B,GACjC,uBAAuB,CASzB;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,MAAM,EACrB,IAAI,GAAE,uBAAuB,GAAG;IAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAO,GACtE,qBAAqB,CASvB;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,uBAAuB,GAAG;IAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAO,GACtE,0BAA0B,CAS5B;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAIzE"}

package/dist/src/export/analysis-json.js

@@ -0,0 +1,38 @@
+// Schema-versioned JSON envelope builders for CLI analysis results.
+export const ANALYSIS_JSON_SCHEMA_VERSION = 1;
+export function buildAnalysisResultsEnvelope(results, totalIssues, opts = {}) {
+    return {
+        schemaVersion: opts.schemaVersion ?? ANALYSIS_JSON_SCHEMA_VERSION,
+        kind: 'analysis',
+        elapsedMs: opts.elapsedMs ?? 0,
+        entryCount: opts.entryCount ?? 0,
+        totalIssues,
+        results,
+    };
+}
+export function buildHealthResultsEnvelope(results, totalFindings, opts = {}) {
+    return {
+        schemaVersion: opts.schemaVersion ?? ANALYSIS_JSON_SCHEMA_VERSION,
+        kind: 'health',
+        elapsedMs: opts.elapsedMs ?? 0,
+        totalFindings,
+        includesExplanations: opts.includesExplanations ?? false,
+        results,
+    };
+}
+export function buildDuplicationResultsEnvelope(results, cloneGroups, opts = {}) {
+    return {
+        schemaVersion: opts.schemaVersion ?? ANALYSIS_JSON_SCHEMA_VERSION,
+        kind: 'duplication',
+        elapsedMs: opts.elapsedMs ?? 0,
+        cloneGroups,
+        includesExplanations: opts.includesExplanations ?? false,
+        results,
+    };
+}
+export function stripRootPrefix(obj, rootPrefix) {
+    const json = JSON.stringify(obj);
+    const escaped = rootPrefix.replace(/[/\\]/g, s => `\\${s}`);
+    return JSON.parse(json.replace(new RegExp(escaped, 'g'), ''));
+}
+//# sourceMappingURL=analysis-json.js.map

package/dist/src/export/analysis-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-json.js","sourceRoot":"","sources":["../../../src/export/analysis-json.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAmC9C,MAAM,UAAU,4BAA4B,CAC1C,OAAgB,EAChB,WAAmB,EACnB,OAAgC,EAAE;IAElC,OAAO;QACL,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,4BAA4B;QACjE,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC;QAC9B,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,CAAC;QAChC,WAAW;QACX,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,OAAgB,EAChB,aAAqB,EACrB,OAAqE,EAAE;IAEvE,OAAO;QACL,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,4BAA4B;QACjE,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC;QAC9B,aAAa;QACb,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,IAAI,KAAK;QACxD,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,OAAgB,EAChB,WAAmB,EACnB,OAAqE,EAAE;IAEvE,OAAO;QACL,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,4BAA4B;QACjE,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC;QAC9B,WAAW;QACX,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,IAAI,KAAK;QACxD,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAY,EAAE,UAAkB;IAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/src/export/badge.d.ts

@@ -0,0 +1,23 @@
+export interface BadgeOptions {
+    label?: string;
+    value: string;
+    color?: string;
+    uniqueId?: string;
+}
+/** Map a letter grade to a shield-style hex color (without leading #). */
+export declare function gradeToColor(grade: string): string;
+/**
+ * Generate a self-contained shields.io-style SVG health-grade badge.
+ * Returns the SVG string; callers can write it to a file or embed it inline.
+ */
+export declare function generateBadge(options: BadgeOptions): string;
+export type HealthGradeLetter = 'A' | 'B' | 'C' | 'D' | 'F';
+export interface HealthBadgeOptions {
+    grade: HealthGradeLetter;
+    score: number;
+    label?: string;
+    ansiColors?: boolean;
+}
+export declare function renderHealthTerminalBadge(opts: HealthBadgeOptions): string;
+export declare function healthScoreToGrade(score: number): HealthGradeLetter;
+//# sourceMappingURL=badge.d.ts.map

package/dist/src/export/badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../../src/export/badge.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASlD;AAOD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAoC3D;AAID,MAAM,MAAM,iBAAiB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,iBAAiB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAaD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAQ1E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAMnE"}

package/dist/src/export/badge.js

@@ -0,0 +1,83 @@
+/** Map a letter grade to a shield-style hex color (without leading #). */
+export function gradeToColor(grade) {
+    switch (grade.trim().toUpperCase()) {
+        case 'A': return '4c1';
+        case 'B': return '97ca00';
+        case 'C': return 'dfb317';
+        case 'D': return 'fe7d37';
+        case 'F': return 'e05d44';
+        default: return '9f9f9f';
+    }
+}
+/** Approximate text width using Verdana 11px metrics: ~6.5px per char + 10px padding. */
+function textWidth(text) {
+    return Math.round(text.length * 6.5 + 10);
+}
+/**
+ * Generate a self-contained shields.io-style SVG health-grade badge.
+ * Returns the SVG string; callers can write it to a file or embed it inline.
+ */
+export function generateBadge(options) {
+    const label = options.label ?? 'monograph';
+    const { value } = options;
+    const id = options.uniqueId ?? 'mg';
+    // Determine color: caller-supplied (strip leading #) or derived from grade
+    let colorHex;
+    if (options.color) {
+        colorHex = options.color.replace(/^#/, '');
+    }
+    else {
+        colorHex = gradeToColor(value);
+    }
+    const labelW = textWidth(label);
+    const valueW = textWidth(value);
+    const totalW = labelW + valueW;
+    // X centres for text (SVG font-size="110" means 11px in a 10x-scaled coordinate space)
+    const lx = Math.round(labelW / 2);
+    const rx = labelW + Math.round(valueW / 2);
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${totalW}" height="20">
+  <linearGradient id="${id}-lg" x2="0" y2="100%">
+    <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+    <stop offset="1" stop-opacity=".1"/>
+  </linearGradient>
+  <rect width="${totalW}" height="20" rx="3" fill="#555"/>
+  <rect x="${labelW}" width="${valueW}" height="20" rx="3" fill="#${colorHex}"/>
+  <rect width="${totalW}" height="20" rx="3" fill="url(#${id}-lg)"/>
+  <g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" font-size="110">
+    <text x="${lx * 10}" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="${(labelW - 10) * 10}">${label}</text>
+    <text x="${lx * 10}" y="140" transform="scale(.1)" textLength="${(labelW - 10) * 10}">${label}</text>
+    <text x="${rx * 10}" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="${(valueW - 10) * 10}">${value}</text>
+    <text x="${rx * 10}" y="140" transform="scale(.1)" textLength="${(valueW - 10) * 10}">${value}</text>
+  </g>
+</svg>`;
+}
+const GRADE_ANSI_BG = {
+    A: '\x1b[42m', // green
+    B: '\x1b[32m', // dark green
+    C: '\x1b[43m', // yellow
+    D: '\x1b[33m', // dark yellow
+    F: '\x1b[41m', // red
+};
+const ANSI_RESET = '\x1b[0m';
+const ANSI_BOLD = '\x1b[1m';
+export function renderHealthTerminalBadge(opts) {
+    const label = opts.label ?? 'health';
+    const score = Math.round(opts.score);
+    if (!opts.ansiColors) {
+        return `[${label}: ${opts.grade} (${score}/100)]`;
+    }
+    const bg = GRADE_ANSI_BG[opts.grade];
+    return `${ANSI_BOLD}${bg} ${label.toUpperCase()}: ${opts.grade} (${score}/100) ${ANSI_RESET}`;
+}
+export function healthScoreToGrade(score) {
+    if (score >= 90)
+        return 'A';
+    if (score >= 75)
+        return 'B';
+    if (score >= 60)
+        return 'C';
+    if (score >= 45)
+        return 'D';
+    return 'F';
+}
+//# sourceMappingURL=badge.js.map

package/dist/src/export/badge.js.map

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

package/dist/src/export/codeclimate.d.ts

@@ -0,0 +1,46 @@
+import type { MonographDb } from '../storage/db.js';
+export interface CodeClimateIssue {
+    type: 'issue';
+    check_name: string;
+    description: string;
+    categories: string[];
+    fingerprint: string;
+    severity: 'blocker' | 'critical' | 'major' | 'minor' | 'info';
+    location: {
+        path: string;
+        lines: {
+            begin: number;
+            end?: number;
+        };
+    };
+}
+/**
+ * Export CodeClimate-compatible issue list from the monograph DB.
+ * Returns a JSON-serialisable array of issues.
+ */
+export declare function exportCodeClimate(db: MonographDb, repoRoot?: string): CodeClimateIssue[];
+export interface CodeClimateHealthIssue extends CodeClimateIssue {
+    categories: ['Complexity'];
+}
+export interface CodeClimateDuplicationIssue extends CodeClimateIssue {
+    categories: ['Duplication'];
+}
+export interface HealthFindingInput {
+    filePath: string;
+    functionName: string;
+    startLine: number;
+    endLine: number;
+    severity: 'major' | 'minor' | 'critical' | 'info';
+    crapScore: number;
+    cyclomatic: number;
+}
+export interface DuplicationFindingInput {
+    filePath: string;
+    startLine: number;
+    endLine: number;
+    groupId: number;
+    duplicatedLines: number;
+}
+export declare function exportHealthCodeClimate(findings: HealthFindingInput[]): CodeClimateIssue[];
+export declare function exportDuplicationCodeClimate(findings: DuplicationFindingInput[]): CodeClimateIssue[];
+//# sourceMappingURL=codeclimate.d.ts.map

package/dist/src/export/codeclimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeclimate.d.ts","sourceRoot":"","sources":["../../../src/export/codeclimate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IAC9D,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACxC,CAAC;CACH;AA+CD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,EAAE,CA6ExF;AAID,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,UAAU,EAAE,CAAC,YAAY,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,2BAA4B,SAAQ,gBAAgB;IACnE,UAAU,EAAE,CAAC,aAAa,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB;AAQD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,gBAAgB,EAAE,CAU1F;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,uBAAuB,EAAE,GAAG,gBAAgB,EAAE,CAUpG"}