@tryjourney/architecture 0.3.0 → 0.3.1

package/dist/deep.d.ts

@@ -1,4 +1,6 @@
 import type { ArchitectureGraphV3, ArchitectureProposalSet, DeepScanResult } from "./types.js";
+/** Keep generated and previously cached v3 graphs inside the shared API contract. */
+export declare function normalizeArchitectureGraph(graph: ArchitectureGraphV3): ArchitectureGraphV3;
 export declare function applyVerifiedProposals(root: string, base: ArchitectureGraphV3, proposals: ArchitectureProposalSet, analyzerVersion?: string): {
     graph: ArchitectureGraphV3;
     accepted: number;

package/dist/deep.js

@@ -13,6 +13,9 @@ const RULE_VERSION = "3.0.0";
 const ID = /^[a-z0-9][a-z0-9:_-]{0,199}$/;
 const CATEGORIES = ["manifest", "entry-point", "route", "import", "runtime-call", "deployment", "configuration", "documentation"];
 const STRONG = new Set(["manifest", "entry-point", "route", "runtime-call", "deployment"]);
+const MAX_EVIDENCE = 30;
+const MAX_FILES = 100;
+const MAX_DETAILS = 100;
 const proposalSchema = {
     type: "object",
     additionalProperties: false,
@@ -93,6 +96,33 @@ function verifyEvidence(root, evidence) {
 function normalizeEvidence(evidence, detector) {
     return evidence.map((item) => ({ ...item, detector }));
 }
+function uniqueBounded(values, key, maximum) {
+    const seen = new Set();
+    return values.filter((value) => { const id = key(value); if (seen.has(id))
+        return false; seen.add(id); return true; }).slice(0, maximum);
+}
+function boundedEvidence(evidence) {
+    const assisted = evidence.filter((item) => item.detector === "codex-proposal");
+    const deterministic = evidence.filter((item) => item.detector !== "codex-proposal");
+    return uniqueBounded([...assisted, ...deterministic], (item) => `${item.path}\0${item.line}\0${item.end_line ?? ""}\0${item.category}`, MAX_EVIDENCE);
+}
+/** Keep generated and previously cached v3 graphs inside the shared API contract. */
+export function normalizeArchitectureGraph(graph) {
+    const copy = structuredClone(graph);
+    copy.components = copy.components.map((component) => {
+        const evidence = boundedEvidence(component.evidence);
+        return {
+            ...component,
+            technology: [...new Set(component.technology)].slice(0, 30),
+            evidence,
+            files: uniqueBounded([...evidence.map((item) => item.path), ...component.files], (value) => value, MAX_FILES),
+            details: uniqueBounded(component.details, (item) => JSON.stringify(item), MAX_DETAILS),
+        };
+    });
+    copy.connections = copy.connections.map((connection) => ({ ...connection, evidence: boundedEvidence(connection.evidence) }));
+    copy.analysis.incomplete_reasons = [...new Set(copy.analysis.incomplete_reasons)].slice(0, 50);
+    return copy;
+}
 function evidenceText(root, evidence) {
     return evidence.map((item) => { try {
         return readFileSync(resolve(root, item.path), "utf8");
@@ -206,7 +236,7 @@ export function applyVerifiedProposals(root, base, proposals, analyzerVersion) {
     graph.analysis.incomplete_reasons = proposals.unresolved.map((item) => item.question).slice(0, 50);
     graph.components.sort((a, b) => a.id.localeCompare(b.id));
     graph.connections.sort((a, b) => a.id.localeCompare(b.id));
-    return { graph, accepted, rejected };
+    return { graph: normalizeArchitectureGraph(graph), accepted, rejected };
 }
 function codexVersion(root) {
     try {

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import type { Change, Graph } from "./types.js";
 export * from "./types.js";
-export { applyVerifiedProposals, codexAnalyzerAvailability, deepScan } from "./deep.js";
+export { applyVerifiedProposals, codexAnalyzerAvailability, deepScan, normalizeArchitectureGraph } from "./deep.js";
 export declare function readExclusions(root: string): string[];
 export declare function scan(root: string, extraExclusions?: string[]): Graph;
 export declare function fingerprint(graph: Graph): string;

package/dist/index.js

@@ -4,7 +4,7 @@ import { existsSync, lstatSync, readdirSync, readFileSync, statSync } from "node
 import { basename, dirname, extname, join, relative, resolve, sep } from "node:path";
 import ts from "typescript";
 export * from "./types.js";
-export { applyVerifiedProposals, codexAnalyzerAvailability, deepScan } from "./deep.js";
+export { applyVerifiedProposals, codexAnalyzerAvailability, deepScan, normalizeArchitectureGraph } from "./deep.js";
 const VERSION = "3.0.0";
 const RULE_VERSION = "3.0.0";
 const MAX_FILES = 20_000;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryjourney/architecture",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Deterministic, privacy-preserving architecture scanning for Journey",
   "keywords": [
     "journey",