@sdd-method/sdd-cli 0.59.0 → 0.61.0

package/dist/lib/api-surface/analyzers/spring.js

@@ -0,0 +1,237 @@
+import { allBySuffix, findBySuffix } from "../file-set.js";
+// java-spring analyzer. Scans **/*.java for Spring-web controllers and outbound dependencies, and
+// pom.xml / build.gradle for the Java runtime version. application.yml/properties → shared_infra.
+const HTTP_METHOD_BY_ANNOTATION = {
+    GetMapping: "GET",
+    PostMapping: "POST",
+    PutMapping: "PUT",
+    DeleteMapping: "DELETE",
+    PatchMapping: "PATCH",
+};
+export async function analyzeSpring(fileSet) {
+    const javaFiles = allBySuffix(fileSet.files, ".java").filter((f) => !/(^|\/)(target|build)\//.test(f) && !/Test\.java$/.test(f));
+    const endpoints = [];
+    const downstream = [];
+    const sharedInfra = new Set();
+    const externalContracts = new Set();
+    for (const path of javaFiles) {
+        const src = await fileSet.read(path);
+        if (src === "")
+            continue;
+        collectEndpoints(src, path, endpoints);
+        collectDownstream(src, downstream, sharedInfra, externalContracts);
+    }
+    // Datasource / queue / topic names from config.
+    await collectConfigInfra(fileSet, sharedInfra);
+    const runtime = await detectJavaRuntime(fileSet);
+    dedupeDownstream(downstream);
+    endpoints.sort((a, b) => (a.path + a.method).localeCompare(b.path + b.method));
+    return {
+        stack: "java-spring",
+        component_type: "service",
+        endpoints,
+        dependencies: { downstream, upstream: [] },
+        external_contracts: [...externalContracts].sort(),
+        deployment: { runtime, shared_infra: [...sharedInfra].sort() },
+    };
+}
+function collectEndpoints(src, path, endpoints) {
+    const isController = /@(Rest)?Controller\b/.test(src);
+    if (!isController)
+        return;
+    const classBase = extractClassRequestMapping(src);
+    const classAuth = extractAuth(classLevelSlice(src));
+    // Walk method-mapping annotations. We pair each mapping annotation with the auth annotation(s)
+    // immediately preceding the method (within a small look-back window). The class-level
+    // @RequestMapping (which sits before the `class`/`interface` declaration) is the path prefix, not a
+    // method mapping — skip any mapping annotation that appears before the type declaration line.
+    const lines = src.split(/\r?\n/);
+    const typeDeclLine = lines.findIndex((l) => /\b(class|interface|enum)\s+\w+/.test(l));
+    for (let i = 0; i < lines.length; i++) {
+        if (typeDeclLine >= 0 && i < typeDeclLine)
+            continue;
+        const line = lines[i];
+        // @GetMapping("/x") / @PostMapping(value="/x") / @RequestMapping(value="/x", method=...).
+        const mappingM = line.match(/@(Get|Post|Put|Delete|Patch|Request)Mapping\b\s*(?:\(([^)]*)\))?/);
+        if (!mappingM)
+            continue;
+        const annotation = `${mappingM[1]}Mapping`;
+        const args = mappingM[2] ?? "";
+        let method = HTTP_METHOD_BY_ANNOTATION[annotation] ?? "";
+        if (annotation === "RequestMapping") {
+            const methodM = args.match(/method\s*=\s*(?:RequestMethod\.)?([A-Z]+)/);
+            method = methodM ? methodM[1] : "GET";
+        }
+        if (method === "")
+            method = "GET";
+        const subPath = extractPathArg(args);
+        const fullPath = joinPaths(classBase, subPath);
+        const methodAuth = extractAuth(lookBack(lines, i, 4)) || classAuth || "none";
+        endpoints.push({ method, path: fullPath, auth: methodAuth, handler: `${baseName(path)}` });
+    }
+}
+function classLevelSlice(src) {
+    // The annotations between the class's RequestMapping and the first method — best-effort: take the
+    // text up to the first mapping method annotation.
+    const idx = src.search(/@(Get|Post|Put|Delete|Patch)Mapping\b/);
+    return idx >= 0 ? src.slice(0, idx) : src;
+}
+function extractClassRequestMapping(src) {
+    // Class-level @RequestMapping("/x") sits before the class body's method mappings.
+    const m = src.match(/@RequestMapping\s*\(\s*([^)]*)\)/);
+    if (!m)
+        return "";
+    // Make sure this is the class-level one (appears before any method mapping).
+    const firstMethodMapping = src.search(/@(Get|Post|Put|Delete|Patch)Mapping\b/);
+    if (firstMethodMapping >= 0 && (m.index ?? 0) > firstMethodMapping)
+        return "";
+    return extractPathArg(m[1] ?? "");
+}
+function extractPathArg(args) {
+    // `"/events"` | `value = "/events"` | `path = "/events"` | `{"/a","/b"}` → first string literal.
+    const m = args.match(/(?:value|path)?\s*=?\s*\{?\s*"([^"]*)"/);
+    return m ? m[1] : "";
+}
+function extractAuth(text) {
+    const pre = text.match(/@PreAuthorize\s*\(\s*"([^"]+)"/);
+    if (pre)
+        return `preauthorize:${pre[1]}`;
+    const secured = text.match(/@Secured\s*\(\s*\{?\s*"?([^")}]+)/);
+    if (secured)
+        return `secured:${secured[1].trim()}`;
+    const roles = text.match(/@RolesAllowed\s*\(\s*\{?\s*"?([^")}]+)/);
+    if (roles)
+        return `roles:${roles[1].trim()}`;
+    return "";
+}
+function collectDownstream(src, downstream, sharedInfra, externalContracts) {
+    // @FeignClient(name = "x", url = "...") → feign.
+    for (const m of src.matchAll(/@FeignClient\s*\(([^)]*)\)/g)) {
+        const args = m[1] ?? "";
+        const name = args.match(/name\s*=\s*"([^"]+)"/)?.[1] ?? "feign-client";
+        const url = args.match(/url\s*=\s*"([^"]+)"/)?.[1];
+        downstream.push({ target: name, kind: "feign", detail: url ?? name, load_bearing: true });
+        if (url)
+            externalContracts.add(url);
+    }
+    // RestTemplate / WebClient → http.
+    if (/\bRestTemplate\b|\bWebClient\b/.test(src)) {
+        for (const m of src.matchAll(/["'](https?:\/\/[^"']+)["']/g)) {
+            downstream.push({ target: m[1], kind: "http", detail: m[1], load_bearing: false });
+            externalContracts.add(m[1]);
+        }
+        if (![...src.matchAll(/["'](https?:\/\/[^"']+)["']/g)].length) {
+            downstream.push({ target: "rest-client", kind: "http", detail: "RestTemplate/WebClient", load_bearing: false });
+        }
+    }
+    // @JmsListener / JmsTemplate → jms (+ destination literal where present).
+    for (const m of src.matchAll(/@JmsListener\s*\(([^)]*)\)/g)) {
+        const dest = (m[1] ?? "").match(/destination\s*=\s*"([^"]+)"/)?.[1] ?? "jms-destination";
+        downstream.push({ target: dest, kind: "jms", detail: dest, load_bearing: true });
+        sharedInfra.add(dest);
+    }
+    if (/\bJmsTemplate\b/.test(src)) {
+        downstream.push({ target: "jms", kind: "jms", detail: "JmsTemplate", load_bearing: true });
+    }
+    // @KafkaListener / KafkaTemplate → kafka.
+    for (const m of src.matchAll(/@KafkaListener\s*\(([^)]*)\)/g)) {
+        const topic = (m[1] ?? "").match(/topics\s*=\s*\{?\s*"([^"]+)"/)?.[1] ?? "kafka-topic";
+        downstream.push({ target: topic, kind: "kafka", detail: topic, load_bearing: true });
+        sharedInfra.add(topic);
+    }
+    if (/\bKafkaTemplate\b/.test(src)) {
+        downstream.push({ target: "kafka", kind: "kafka", detail: "KafkaTemplate producer", load_bearing: true });
+    }
+    // Spring Data repositories + entity/document annotations → datastore kind.
+    if (/interface\s+\w+\s+extends\s+\w*Repository\b/.test(src)) {
+        if (/@Document\b/.test(src)) {
+            downstream.push({ target: "mongo", kind: "mongo", detail: "Spring Data MongoRepository", load_bearing: true });
+        }
+        else if (/@Entity\b/.test(src)) {
+            downstream.push({ target: "jdbc", kind: "jdbc", detail: "Spring Data JpaRepository", load_bearing: true });
+        }
+        else {
+            downstream.push({ target: "datastore", kind: "jdbc", detail: "Spring Data Repository", load_bearing: true });
+        }
+    }
+    else if (/@Document\b/.test(src)) {
+        downstream.push({ target: "mongo", kind: "mongo", detail: "@Document entity", load_bearing: true });
+    }
+}
+async function collectConfigInfra(fileSet, sharedInfra) {
+    const configs = fileSet.files.filter((f) => /application(-[\w]+)?\.(ya?ml|properties)$/.test(f));
+    for (const path of configs) {
+        const src = await fileSet.read(path);
+        if (src === "")
+            continue;
+        // datasource url, kafka topics, jms queues, mongo uri.
+        for (const m of src.matchAll(/(?:datasource[._]url|spring\.datasource\.url)\s*[:=]\s*(\S+)/gi)) {
+            sharedInfra.add(`jdbc:${stripVar(m[1])}`);
+        }
+        for (const m of src.matchAll(/(?:topic|telemetrytopic)\s*[:=]\s*(\S+)/gi)) {
+            const v = stripVar(m[1]);
+            if (v)
+                sharedInfra.add(`topic:${v}`);
+        }
+        for (const m of src.matchAll(/(?:mongo[._]?uri|spring\.data\.mongodb\.uri)\s*[:=]\s*(\S+)/gi)) {
+            sharedInfra.add(`mongo:${stripVar(m[1])}`);
+        }
+        for (const m of src.matchAll(/bootstrap-servers\s*[:=]\s*(\S+)/gi)) {
+            sharedInfra.add(`kafka:${stripVar(m[1])}`);
+        }
+    }
+}
+function stripVar(v) {
+    // Keep env-var placeholders readable: `${GATEWAY_KAFKAPRODUCERTOPIC}` → GATEWAY_KAFKAPRODUCERTOPIC.
+    const m = v.match(/\$\{([^:}]+)/);
+    if (m)
+        return m[1];
+    return v.replace(/^['"]|['"]$/g, "").trim();
+}
+async function detectJavaRuntime(fileSet) {
+    const pom = findBySuffix(fileSet.files, "pom.xml");
+    if (pom) {
+        const src = await fileSet.read(pom);
+        const v = src.match(/<maven\.compiler\.release>\s*([\d.]+)/)?.[1] ??
+            src.match(/<maven\.compiler\.target>\s*([\d.]+)/)?.[1] ??
+            src.match(/<maven\.compiler\.source>\s*([\d.]+)/)?.[1] ??
+            src.match(/<java\.version>\s*([\d.]+)/)?.[1];
+        if (v)
+            return `java${v}`;
+    }
+    const gradle = findBySuffix(fileSet.files, "build.gradle");
+    if (gradle) {
+        const src = await fileSet.read(gradle);
+        const v = src.match(/JavaLanguageVersion\.of\(\s*([\d]+)\s*\)/)?.[1] ??
+            src.match(/(?:source|target)Compatibility\s*=?\s*['"]?(?:JavaVersion\.VERSION_)?([\d.]+)/)?.[1] ??
+            src.match(/java-openjdk(\d+)/)?.[1];
+        if (v)
+            return `java${v}`;
+    }
+    return "";
+}
+function joinPaths(base, sub) {
+    const b = base.replace(/\/$/, "");
+    const s = sub.startsWith("/") ? sub : sub ? `/${sub}` : "";
+    const joined = `${b}${s}`;
+    return joined.startsWith("/") ? joined : `/${joined}`;
+}
+function lookBack(lines, idx, n) {
+    return lines.slice(Math.max(0, idx - n), idx + 1).join("\n");
+}
+function baseName(p) {
+    return p.split("/").pop() ?? p;
+}
+function dedupeDownstream(deps) {
+    const seen = new Set();
+    for (let i = deps.length - 1; i >= 0; i--) {
+        const dep = deps[i];
+        const key = `${dep.kind}|${dep.detail}`;
+        if (seen.has(key))
+            deps.splice(i, 1);
+        else
+            seen.add(key);
+    }
+    deps.sort((a, b) => (a.kind + a.detail).localeCompare(b.kind + b.detail));
+}
+//# sourceMappingURL=spring.js.map

package/dist/lib/api-surface/analyzers/spring.js.map

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

package/dist/lib/api-surface/analyzers/terraform.d.ts

@@ -0,0 +1,4 @@
+import type { FileSet } from "../file-set.js";
+import type { AnalyzerResult } from "../types.js";
+export declare function analyzeTerraform(fileSet: FileSet): Promise<AnalyzerResult>;
+//# sourceMappingURL=terraform.d.ts.map

package/dist/lib/api-surface/analyzers/terraform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terraform.d.ts","sourceRoot":"","sources":["../../../../src/lib/api-surface/analyzers/terraform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAwB,MAAM,aAAa,CAAC;AA2BxE,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAqEhF"}

package/dist/lib/api-surface/analyzers/terraform.js

@@ -0,0 +1,109 @@
+import { allBySuffix } from "../file-set.js";
+// terraform analyzer. No endpoints. Enumerate `resource "<type>" "<name>"` (grouped by type with
+// counts), `data "<type>"`, `module "<name>"`, and IAM roles. Provisioned resources → shared_infra
+// + a provisioned_resources summary; IAM roles + module sources → deployment.notes.
+const RESOURCE_RE = /resource\s+"([^"]+)"\s+"([^"]+)"/g;
+const DATA_RE = /data\s+"([^"]+)"\s+"([^"]+)"/g;
+const MODULE_RE = /module\s+"([^"]+)"\s*\{/g;
+const MODULE_SOURCE_RE = /module\s+"([^"]+)"\s*\{[^}]*?source\s*=\s*"([^"]+)"/gs;
+const INFRA_RESOURCE_TYPES = new Set([
+    "aws_sqs_queue",
+    "aws_sns_topic",
+    "aws_dynamodb_table",
+    "aws_s3_bucket",
+    "aws_kinesis_stream",
+    "aws_lambda_function",
+    "aws_db_instance",
+    "aws_rds_cluster",
+    "aws_vpc",
+    "aws_cognito_user_pool",
+    "aws_cognito_identity_pool",
+    "aws_api_gateway_rest_api",
+    "aws_apigatewayv2_api",
+]);
+export async function analyzeTerraform(fileSet) {
+    const tfFiles = allBySuffix(fileSet.files, ".tf").filter((f) => !/(^|\/)\.terraform\//.test(f));
+    const resourceCounts = new Map();
+    const sharedInfra = new Set();
+    const downstream = [];
+    const dataSources = new Set();
+    const modules = new Set();
+    const iamRoles = [];
+    for (const path of tfFiles) {
+        const src = await fileSet.read(path);
+        if (src === "")
+            continue;
+        for (const m of src.matchAll(RESOURCE_RE)) {
+            const type = m[1];
+            const name = m[2];
+            resourceCounts.set(type, (resourceCounts.get(type) ?? 0) + 1);
+            if (type === "aws_iam_role" || /iam_(role|policy)/.test(type)) {
+                iamRoles.push(name);
+            }
+            if (INFRA_RESOURCE_TYPES.has(type)) {
+                sharedInfra.add(`${type}.${name}`);
+            }
+            pushDependency(type, name, downstream);
+        }
+        for (const m of src.matchAll(DATA_RE)) {
+            dataSources.add(`${m[1]}.${m[2]}`);
+        }
+        for (const m of src.matchAll(MODULE_RE)) {
+            modules.add(m[1]);
+        }
+        for (const m of src.matchAll(MODULE_SOURCE_RE)) {
+            modules.add(`${m[1]} (source=${m[2]})`);
+        }
+    }
+    const provisioned = [...resourceCounts.entries()]
+        .map(([type, count]) => ({ type, count }))
+        .sort((a, b) => b.count - a.count || a.type.localeCompare(b.type));
+    const notes = [];
+    if (iamRoles.length > 0) {
+        notes.push(`iam roles/policies: ${[...new Set(iamRoles)].sort().join(", ")}`);
+    }
+    if (dataSources.size > 0) {
+        notes.push(`data sources: ${[...dataSources].sort().join(", ")}`);
+    }
+    if (modules.size > 0) {
+        notes.push(`modules: ${[...modules].sort().join(", ")}`);
+    }
+    dedupeDownstream(downstream);
+    return {
+        stack: "terraform",
+        component_type: "infra",
+        endpoints: [],
+        dependencies: { downstream, upstream: [] },
+        external_contracts: [],
+        deployment: {
+            runtime: "terraform",
+            shared_infra: [...sharedInfra].sort(),
+            provisioned_resources: provisioned,
+            ...(notes.length > 0 ? { notes } : {}),
+        },
+    };
+}
+function pushDependency(type, name, downstream) {
+    const target = `${type}.${name}`;
+    if (type === "aws_sqs_queue")
+        downstream.push({ target, kind: "sqs", detail: name, load_bearing: true });
+    else if (type === "aws_sns_topic")
+        downstream.push({ target, kind: "sns", detail: name, load_bearing: true });
+    else if (type === "aws_dynamodb_table")
+        downstream.push({ target, kind: "dynamodb", detail: name, load_bearing: true });
+    else if (type === "aws_s3_bucket")
+        downstream.push({ target, kind: "s3", detail: name, load_bearing: false });
+}
+function dedupeDownstream(deps) {
+    const seen = new Set();
+    for (let i = deps.length - 1; i >= 0; i--) {
+        const dep = deps[i];
+        const key = `${dep.kind}|${dep.target}`;
+        if (seen.has(key))
+            deps.splice(i, 1);
+        else
+            seen.add(key);
+    }
+    deps.sort((a, b) => (a.kind + a.target).localeCompare(b.kind + b.target));
+}
+//# sourceMappingURL=terraform.js.map

package/dist/lib/api-surface/analyzers/terraform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terraform.js","sourceRoot":"","sources":["../../../../src/lib/api-surface/analyzers/terraform.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,iGAAiG;AACjG,mGAAmG;AACnG,oFAAoF;AAEpF,MAAM,WAAW,GAAG,mCAAmC,CAAC;AACxD,MAAM,OAAO,GAAG,+BAA+B,CAAC;AAChD,MAAM,SAAS,GAAG,0BAA0B,CAAC;AAC7C,MAAM,gBAAgB,GAAG,uDAAuD,CAAC;AAEjF,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,eAAe;IACf,eAAe;IACf,oBAAoB;IACpB,eAAe;IACf,oBAAoB;IACpB,qBAAqB;IACrB,iBAAiB;IACjB,iBAAiB;IACjB,SAAS;IACT,uBAAuB;IACvB,2BAA2B;IAC3B,0BAA0B;IAC1B,sBAAsB;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAgB;IACrD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,CACtD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CACtC,CAAC;IAEF,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,GAAG,KAAK,EAAE;YAAE,SAAS;QAEzB,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;YACnB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;YACnB,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9D,IAAI,IAAI,KAAK,cAAc,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9D,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;YACD,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,WAAW,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;YACrC,CAAC;YACD,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACzC,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACtC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;QACrB,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,GAAG,cAAc,CAAC,OAAO,EAAE,CAAC;SAC9C,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;SACzC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAErE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAE7B,OAAO;QACL,KAAK,EAAE,WAAW;QAClB,cAAc,EAAE,OAAO;QACvB,SAAS,EAAE,EAAE;QACb,YAAY,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC1C,kBAAkB,EAAE,EAAE;QACtB,UAAU,EAAE;YACV,OAAO,EAAE,WAAW;YACpB,YAAY,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,EAAE;YACrC,qBAAqB,EAAE,WAAW;YAClC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,IAAY,EAAE,UAAkC;IACpF,MAAM,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACjC,IAAI,IAAI,KAAK,eAAe;QAAE,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;SACpG,IAAI,IAAI,KAAK,eAAe;QAAE,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;SACzG,IAAI,IAAI,KAAK,oBAAoB;QAAE,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;SACnH,IAAI,IAAI,KAAK,eAAe;QAAE,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;AAChH,CAAC;AAED,SAAS,gBAAgB,CAAC,IAA4B;IACpD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACrB,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;;YAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5E,CAAC"}

package/dist/lib/api-surface/detect.d.ts

@@ -0,0 +1,8 @@
+import type { Stack } from "./types.js";
+export interface DetectSignals {
+    /** True when at least one Java file carries a Spring web controller annotation. */
+    readonly hasSpringController: boolean;
+}
+export declare function detectStack(files: readonly string[], signals?: DetectSignals): Stack;
+export declare function fileLooksLikeSpringController(source: string): boolean;
+//# sourceMappingURL=detect.d.ts.map

package/dist/lib/api-surface/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/lib/api-surface/detect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAiBxC,MAAM,WAAW,aAAa;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;CACvC;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,GAAE,aAA8C,GACtD,KAAK,CAkBP;AAKD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErE"}

package/dist/lib/api-surface/detect.js

@@ -0,0 +1,25 @@
+import { basename } from "node:path";
+export function detectStack(files, signals = { hasSpringController: false }) {
+    const names = files.map((f) => basename(f).toLowerCase());
+    const has = (pred) => names.some(pred);
+    const hasJavaBuild = has((n) => n === "pom.xml" || n === "build.gradle");
+    // (1) A Spring service ships as a Spring service even with a bundled IaC/serverless wrapper.
+    if (hasJavaBuild && signals.hasSpringController)
+        return "java-spring";
+    const hasServerless = has((n) => n === "serverless.yml" || n === "serverless.yaml");
+    if (hasServerless)
+        return "node-serverless";
+    const hasTerraform = files.some((f) => f.toLowerCase().endsWith(".tf"));
+    if (hasTerraform)
+        return "terraform";
+    const hasManifest = hasJavaBuild || has((n) => n === "package.json");
+    if (hasManifest)
+        return "library";
+    return "unknown";
+}
+/** Class/type-level annotation that marks a Spring web controller. */
+const SPRING_CONTROLLER_RE = /@(Rest)?Controller\b|@RequestMapping\b/;
+export function fileLooksLikeSpringController(source) {
+    return SPRING_CONTROLLER_RE.test(source);
+}
+//# sourceMappingURL=detect.js.map

package/dist/lib/api-surface/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../../src/lib/api-surface/detect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAuBrC,MAAM,UAAU,WAAW,CACzB,KAAwB,EACxB,UAAyB,EAAE,mBAAmB,EAAE,KAAK,EAAE;IAEvD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,CAAC,IAA4B,EAAW,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAExE,MAAM,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,cAAc,CAAC,CAAC;IACzE,6FAA6F;IAC7F,IAAI,YAAY,IAAI,OAAO,CAAC,mBAAmB;QAAE,OAAO,aAAa,CAAC;IAEtE,MAAM,aAAa,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,gBAAgB,IAAI,CAAC,KAAK,iBAAiB,CAAC,CAAC;IACpF,IAAI,aAAa;QAAE,OAAO,iBAAiB,CAAC;IAE5C,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,IAAI,YAAY;QAAE,OAAO,WAAW,CAAC;IAErC,MAAM,WAAW,GAAG,YAAY,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC;IACrE,IAAI,WAAW;QAAE,OAAO,SAAS,CAAC;IAElC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,sEAAsE;AACtE,MAAM,oBAAoB,GAAG,wCAAwC,CAAC;AAEtE,MAAM,UAAU,6BAA6B,CAAC,MAAc;IAC1D,OAAO,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC"}

package/dist/lib/api-surface/emit.d.ts

@@ -0,0 +1,4 @@
+import type { ApiSurface } from "./types.js";
+export declare function toYaml(surface: ApiSurface): string;
+export declare function toMarkdownBlock(surface: ApiSurface): string;
+//# sourceMappingURL=emit.d.ts.map

package/dist/lib/api-surface/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../src/lib/api-surface/emit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAO7C,wBAAgB,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAwDlD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAqD3D"}

package/dist/lib/api-surface/emit.js

@@ -0,0 +1,109 @@
+import { stringify as stringifyYaml } from "yaml";
+// Serialisers for an ApiSurface. `toYaml` produces the contracts/api-surface.yaml document (keys in a
+// stable, human-readable order; empty blocks omitted so non-endpoint stacks don't carry noise).
+// `toMarkdownBlock` produces the `## External Interfaces` + `## Dependency Graph` documentation block
+// the reverse rubric reads.
+export function toYaml(surface) {
+    // Build an ordered plain object so the YAML key order is deterministic and reads top-down.
+    const doc = {
+        repo: surface.repo,
+        profile: surface.profile,
+        component_type: surface.component_type,
+        domain: surface.domain,
+        stack: surface.stack,
+    };
+    if (surface.source_snapshot)
+        doc["source_snapshot"] = surface.source_snapshot;
+    doc["generated_by"] = surface.generated_by;
+    if (surface.endpoints.length > 0) {
+        doc["endpoints"] = surface.endpoints.map((e) => ({
+            method: e.method,
+            path: e.path,
+            auth: e.auth,
+            handler: e.handler,
+        }));
+    }
+    doc["dependencies"] = {
+        downstream: surface.dependencies.downstream.map((d) => ({
+            target: d.target,
+            kind: d.kind,
+            detail: d.detail,
+            load_bearing: d.load_bearing,
+        })),
+        upstream: surface.dependencies.upstream,
+    };
+    if (surface.external_contracts.length > 0) {
+        doc["external_contracts"] = surface.external_contracts;
+    }
+    const deployment = {
+        runtime: surface.deployment.runtime,
+        shared_infra: surface.deployment.shared_infra,
+    };
+    if (surface.deployment.provisioned_resources && surface.deployment.provisioned_resources.length > 0) {
+        deployment["provisioned_resources"] = surface.deployment.provisioned_resources;
+    }
+    if (surface.deployment.notes && surface.deployment.notes.length > 0) {
+        deployment["notes"] = surface.deployment.notes;
+    }
+    doc["deployment"] = deployment;
+    if (surface.public_api) {
+        const pub = {};
+        if (surface.public_api.package_name)
+            pub["package_name"] = surface.public_api.package_name;
+        pub["exports"] = surface.public_api.exports;
+        doc["public_api"] = pub;
+    }
+    doc["consumed_by"] = surface.consumed_by;
+    return stringifyYaml(doc, { lineWidth: 0 });
+}
+export function toMarkdownBlock(surface) {
+    const lines = [];
+    lines.push("## External Interfaces");
+    lines.push("");
+    if (surface.endpoints.length > 0) {
+        lines.push("| Method | Path | Auth | Handler |");
+        lines.push("| --- | --- | --- | --- |");
+        for (const e of surface.endpoints) {
+            lines.push(`| ${e.method} | ${e.path} | ${e.auth} | ${e.handler} |`);
+        }
+    }
+    else {
+        lines.push(`_No HTTP endpoints (${surface.stack} stack)._`);
+    }
+    lines.push("");
+    lines.push("## Dependency Graph");
+    lines.push("");
+    const down = surface.dependencies.downstream;
+    if (down.length > 0) {
+        lines.push("**Downstream:**");
+        lines.push("");
+        lines.push("| Target | Kind | Detail | Load-bearing |");
+        lines.push("| --- | --- | --- | --- |");
+        for (const d of down) {
+            lines.push(`| ${d.target} | ${d.kind} | ${d.detail} | ${d.load_bearing ? "yes" : "no"} |`);
+        }
+        lines.push("");
+    }
+    const up = surface.dependencies.upstream;
+    lines.push(`**Upstream:** ${up.length > 0 ? up.join(", ") : "_unknown_"}`);
+    lines.push("");
+    if (surface.external_contracts.length > 0) {
+        lines.push("**External contracts:** " + surface.external_contracts.join(", "));
+        lines.push("");
+    }
+    lines.push("## Deployment");
+    lines.push("");
+    lines.push(`- Runtime: ${surface.deployment.runtime || "_unknown_"}`);
+    if (surface.deployment.shared_infra.length > 0) {
+        lines.push(`- Shared infra: ${surface.deployment.shared_infra.join(", ")}`);
+    }
+    if (surface.deployment.provisioned_resources && surface.deployment.provisioned_resources.length > 0) {
+        const summary = surface.deployment.provisioned_resources
+            .map((r) => `${r.type} ×${r.count}`)
+            .join(", ");
+        lines.push(`- Provisioned: ${summary}`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=emit.js.map

package/dist/lib/api-surface/emit.js.map

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

package/dist/lib/api-surface/file-set.d.ts

@@ -0,0 +1,14 @@
+export interface FileSet {
+    readonly root: string;
+    /** Repo-relative POSIX-ish paths (forward slashes), files only. */
+    readonly files: readonly string[];
+    /** Read a relative path's UTF-8 content; "" when missing/unreadable. */
+    read(relPath: string): Promise<string>;
+}
+export declare function diskFileSet(root: string, files: readonly string[]): FileSet;
+/** Build a FileSet from an in-memory `{ path: content }` map — for tests. */
+export declare function inMemoryFileSet(entries: Readonly<Record<string, string>>, root?: string): FileSet;
+/** First file (by suffix match, case-insensitive) or null. */
+export declare function findBySuffix(files: readonly string[], suffix: string): string | null;
+export declare function allBySuffix(files: readonly string[], suffix: string): string[];
+//# sourceMappingURL=file-set.d.ts.map

package/dist/lib/api-surface/file-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-set.d.ts","sourceRoot":"","sources":["../../../src/lib/api-surface/file-set.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,wEAAwE;IACxE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAkB3E;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAC7B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACzC,IAAI,SAAa,GAChB,OAAO,CAQT;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGpF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAG9E"}

package/dist/lib/api-surface/file-set.js

@@ -0,0 +1,43 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+export function diskFileSet(root, files) {
+    const cache = new Map();
+    return {
+        root,
+        files,
+        async read(relPath) {
+            const cached = cache.get(relPath);
+            if (cached !== undefined)
+                return cached;
+            let content = "";
+            try {
+                content = await readFile(join(root, relPath), "utf-8");
+            }
+            catch {
+                content = "";
+            }
+            cache.set(relPath, content);
+            return content;
+        },
+    };
+}
+/** Build a FileSet from an in-memory `{ path: content }` map — for tests. */
+export function inMemoryFileSet(entries, root = "/virtual") {
+    return {
+        root,
+        files: Object.keys(entries),
+        async read(relPath) {
+            return entries[relPath] ?? "";
+        },
+    };
+}
+/** First file (by suffix match, case-insensitive) or null. */
+export function findBySuffix(files, suffix) {
+    const lower = suffix.toLowerCase();
+    return files.find((f) => f.toLowerCase().endsWith(lower)) ?? null;
+}
+export function allBySuffix(files, suffix) {
+    const lower = suffix.toLowerCase();
+    return files.filter((f) => f.toLowerCase().endsWith(lower));
+}
+//# sourceMappingURL=file-set.js.map

package/dist/lib/api-surface/file-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-set.js","sourceRoot":"","sources":["../../../src/lib/api-surface/file-set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAcjC,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,KAAwB;IAChE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,OAAO;QACL,IAAI;QACJ,KAAK;QACL,KAAK,CAAC,IAAI,CAAC,OAAe;YACxB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,MAAM,CAAC;YACxC,IAAI,OAAO,GAAG,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;YACzD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,GAAG,EAAE,CAAC;YACf,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC5B,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAC7B,OAAyC,EACzC,IAAI,GAAG,UAAU;IAEjB,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,OAAe;YACxB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAChC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,YAAY,CAAC,KAAwB,EAAE,MAAc;IACnE,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAwB,EAAE,MAAc;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9D,CAAC"}