@untangle-code/cli 0.0.0-stage → 0.1.0

package/dist/commands/graph/boundaries.js

@@ -0,0 +1,141 @@
+import { createHash } from "node:crypto";
+import { readFileSync, realpathSync, statSync } from "node:fs";
+import path from "node:path";
+import { analyzeFrontendBoundaries } from "@untangle-code/core";
+import { enumFlag, integerFlag, stringFlag } from "../../cli/args.js";
+import { EXIT, OperationalError, UsageError } from "../../cli/exit.js";
+import { line } from "../../cli/io.js";
+import { loadWorkspace } from "../../cli/workspace.js";
+import { httpServicesFileSchema } from "./boundaries-input.js";
+function inside(root, candidate) {
+    const relative = path.relative(root, candidate);
+    return relative !== ".." && !relative.startsWith(".." + path.sep) && !path.isAbsolute(relative);
+}
+function readServices(root, requested) {
+    const selected = requested ?? ".untangle/services.json";
+    const candidate = path.resolve(root, selected);
+    if (!inside(root, candidate))
+        throw new UsageError("Service configuration must be inside the project root.");
+    const controlPath = path.relative(root, candidate).split(path.sep).join("/");
+    let physical;
+    try {
+        physical = realpathSync(candidate);
+    }
+    catch (error) {
+        if (requested === undefined && error.code === "ENOENT") {
+            return {
+                services: [],
+                control: { path: controlPath, status: "missing" },
+                verify: () => {
+                    try {
+                        realpathSync(candidate);
+                    }
+                    catch (failure) {
+                        if (failure.code === "ENOENT")
+                            return;
+                        throw failure;
+                    }
+                    throw new OperationalError("Service configuration appeared during the analysis; repeat it.");
+                },
+            };
+        }
+        throw new OperationalError("Service configuration could not be read.");
+    }
+    if (!inside(root, physical))
+        throw new UsageError("Service configuration resolves outside the project root.");
+    const stat = statSync(physical);
+    if (!stat.isFile() || stat.size > 1024 * 1024)
+        throw new UsageError("Service configuration must be a regular JSON file no larger than 1 MiB.");
+    const bytes = readFileSync(physical);
+    let raw;
+    try {
+        raw = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
+    }
+    catch {
+        throw new UsageError("Service configuration is not valid UTF-8 JSON.");
+    }
+    const parsed = httpServicesFileSchema.safeParse(raw);
+    if (!parsed.success)
+        throw new UsageError("Invalid service configuration: " +
+            parsed.error.issues.map((issue) => issue.path.join(".") + ": " + issue.message).join("; "));
+    const digest = (value) => createHash("sha256").update(value).digest("hex");
+    const contentHash = digest(bytes);
+    return {
+        services: parsed.data.services.map((service) => ({
+            id: service.id,
+            frontendRoots: service.frontendRoots,
+            backendRoots: service.backendRoots,
+            ...(service.sameOrigin === undefined ? {} : { sameOrigin: service.sameOrigin }),
+            ...(service.origins === undefined ? {} : { origins: service.origins }),
+        })),
+        control: { path: controlPath, status: "loaded", contentHash },
+        verify: () => {
+            if (realpathSync(candidate) !== physical || digest(readFileSync(physical)) !== contentHash)
+                throw new OperationalError("Service configuration changed during the analysis; repeat it.");
+        },
+    };
+}
+export async function runBoundaries(ctx, args) {
+    const allowed = new Set(["root", "services", "path", "max-relations", "format"]);
+    for (const flag of Object.keys(args.flags))
+        if (!allowed.has(flag))
+            throw new UsageError(`Option --${flag} is not supported by graph boundaries.`);
+    const format = enumFlag(args, "format", ["text", "json"], "text");
+    const maxRelations = integerFlag(args, "max-relations", 200);
+    if (maxRelations < 1 || maxRelations > 1000)
+        throw new UsageError("--max-relations must be between 1 and 1000.");
+    const rootFlag = stringFlag(args, "root");
+    const workspace = loadWorkspace({
+        cwd: path.resolve(ctx.cwd, rootFlag ?? "."),
+        env: ctx.env,
+        strict: true,
+    });
+    const root = realpathSync(rootFlag === undefined ? workspace.root : path.resolve(ctx.cwd, rootFlag));
+    const services = readServices(root, stringFlag(args, "services"));
+    const selectedPath = stringFlag(args, "path");
+    if (selectedPath !== undefined &&
+        (!selectedPath ||
+            selectedPath.length > 4096 ||
+            selectedPath.startsWith("/") ||
+            /[:\\*?[\]{}]/u.test(selectedPath) ||
+            selectedPath.split("/").some((part) => !part || part === "." || part === "..")))
+        throw new UsageError("--path must be one literal repository-relative file path.");
+    const repository = (workspace.config.repositories ?? []).find((entry) => path.resolve(workspace.load.sources.configBaseDir, entry.path) === root);
+    const report = await analyzeFrontendBoundaries({
+        root,
+        services: services.services,
+        maxRelations,
+        ...(selectedPath === undefined ? {} : { path: selectedPath }),
+        ...(repository?.exclude === undefined
+            ? {}
+            : { inventoryScope: { additionalDefaultExcludes: repository.exclude } }),
+        signal: ctx.signal,
+    });
+    ctx.signal.throwIfAborted();
+    services.verify();
+    const data = { ...report, servicesManifest: services.control };
+    if (format === "json")
+        line(ctx.io, JSON.stringify(data, null, 2));
+    else {
+        line(ctx.io, `Frontend/backend HTTP dependencies: ${report.status}; sources ${report.freshness.status}`);
+        line(ctx.io, `${report.http.summary.endpoints} endpoints; ${report.http.summary.requests} requests: ${report.http.summary.resolved} resolved, ${report.http.summary.ambiguous} ambiguous, ${report.http.summary.unresolved} unresolved.`);
+        for (const request of report.http.requests) {
+            line(ctx.io, `${request.source.path}:${request.source.range.startLine} ${request.method ?? "?"} ${request.path ?? "?"} [${request.status}]`);
+            for (const target of request.targets) {
+                const route = target.provenance.find((item) => item.kind === "route");
+                line(ctx.io, `  -> ${target.serviceId ?? "unbound"} ${target.handler}${route ? " " + route.path + ":" + route.range.startLine : ""}`);
+            }
+            if (request.reason)
+                line(ctx.io, "  " + request.reason);
+        }
+        for (const importer of report.importContext.requestImporters)
+            line(ctx.io, `Import context: ${importer.path} -> ${importer.requestPath} (${importer.distance} import edges; no function-call proof)`);
+        line(ctx.io, `Feature associations: ${report.features.associationCount}; declared dependsOn remains unchanged.`);
+        if (report.truncation.truncated)
+            line(ctx.io, "Output was truncated; inspect the JSON counts and limits.");
+        for (const limitation of report.limitations)
+            line(ctx.io, "Limit: " + limitation);
+    }
+    return report.freshness.status === "stale" ? EXIT.environment : EXIT.ok;
+}
+//# sourceMappingURL=boundaries.js.map

package/dist/commands/graph/boundaries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundaries.js","sourceRoot":"","sources":["../../../src/commands/graph/boundaries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAmB,MAAM,mBAAmB,CAAC;AAEvF,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAQ/D,SAAS,MAAM,CAAC,IAAY,EAAE,SAAiB;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAChD,OAAO,QAAQ,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AAClG,CAAC;AAED,SAAS,YAAY,CACnB,IAAY,EACZ,SAA6B;IAM7B,MAAM,QAAQ,GAAG,SAAS,IAAI,yBAAyB,CAAC;IACxD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC;QAC1B,MAAM,IAAI,UAAU,CAAC,wDAAwD,CAAC,CAAC;IACjF,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7E,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,SAAS,KAAK,SAAS,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClF,OAAO;gBACL,QAAQ,EAAE,EAAE;gBACZ,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE;gBACjD,MAAM,EAAE,GAAG,EAAE;oBACX,IAAI,CAAC;wBACH,YAAY,CAAC,SAAS,CAAC,CAAC;oBAC1B,CAAC;oBAAC,OAAO,OAAO,EAAE,CAAC;wBACjB,IAAK,OAAiC,CAAC,IAAI,KAAK,QAAQ;4BAAE,OAAO;wBACjE,MAAM,OAAO,CAAC;oBAChB,CAAC;oBACD,MAAM,IAAI,gBAAgB,CACxB,gEAAgE,CACjE,CAAC;gBACJ,CAAC;aACF,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,gBAAgB,CAAC,0CAA0C,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC;QACzB,MAAM,IAAI,UAAU,CAAC,0DAA0D,CAAC,CAAC;IACnF,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI;QAC3C,MAAM,IAAI,UAAU,CAAC,yEAAyE,CAAC,CAAC;IAClG,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,UAAU,CAAC,gDAAgD,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,OAAO;QACjB,MAAM,IAAI,UAAU,CAClB,iCAAiC;YAC/B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC7F,CAAC;IACJ,MAAM,MAAM,GAAG,CAAC,KAAiB,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvF,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC/C,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;YAC/E,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;SACvE,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE;QAC7D,MAAM,EAAE,GAAG,EAAE;YACX,IAAI,YAAY,CAAC,SAAS,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,KAAK,WAAW;gBACxF,MAAM,IAAI,gBAAgB,CAAC,+DAA+D,CAAC,CAAC;QAChG,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAmB,EAAE,IAAgB;IACvE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YACpB,MAAM,IAAI,UAAU,CAAC,YAAY,IAAI,wCAAwC,CAAC,CAAC;IACnF,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAU,EAAE,MAAM,CAAC,CAAC;IAC3E,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC;IAC7D,IAAI,YAAY,GAAG,CAAC,IAAI,YAAY,GAAG,IAAI;QACzC,MAAM,IAAI,UAAU,CAAC,6CAA6C,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,aAAa,CAAC;QAC9B,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,IAAI,GAAG,CAAC;QAC3C,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,YAAY,CACvB,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAC1E,CAAC;IACF,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9C,IACE,YAAY,KAAK,SAAS;QAC1B,CAAC,CAAC,YAAY;YACZ,YAAY,CAAC,MAAM,GAAG,IAAI;YAC1B,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC;YAC1B,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC;YACpC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC;QAEjF,MAAM,IAAI,UAAU,CAAC,2DAA2D,CAAC,CAAC;IACpF,MAAM,UAAU,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,CAC3D,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CACnF,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC;QAC7C,IAAI;QACJ,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,YAAY;QACZ,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QAC7D,GAAG,CAAC,UAAU,EAAE,OAAO,KAAK,SAAS;YACnC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,yBAAyB,EAAE,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1E,MAAM,EAAE,GAAG,CAAC,MAAM;KACnB,CAAC,CAAC;IACH,GAAG,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,CAAC;IAClB,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,EAAE,gBAAgB,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC/D,IAAI,MAAM,KAAK,MAAM;QAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;SAC9D,CAAC;QACJ,IAAI,CACF,GAAG,CAAC,EAAE,EACN,uCAAuC,MAAM,CAAC,MAAM,aAAa,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAC3F,CAAC;QACF,IAAI,CACF,GAAG,CAAC,EAAE,EACN,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,eAAe,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,cAAc,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,cAAc,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,eAAe,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,cAAc,CAC5N,CAAC;QACF,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC3C,IAAI,CACF,GAAG,CAAC,EAAE,EACN,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,IAAI,IAAI,GAAG,KAAK,OAAO,CAAC,MAAM,GAAG,CAC/H,CAAC;YACF,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACrC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;gBACtE,IAAI,CACF,GAAG,CAAC,EAAE,EACN,QAAQ,MAAM,CAAC,SAAS,IAAI,SAAS,IAAI,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,IAAI,GAAG,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CACxH,CAAC;YACJ,CAAC;YACD,IAAI,OAAO,CAAC,MAAM;gBAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,gBAAgB;YAC1D,IAAI,CACF,GAAG,CAAC,EAAE,EACN,mBAAmB,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,WAAW,KAAK,QAAQ,CAAC,QAAQ,wCAAwC,CAC1H,CAAC;QACJ,IAAI,CACF,GAAG,CAAC,EAAE,EACN,yBAAyB,MAAM,CAAC,QAAQ,CAAC,gBAAgB,yCAAyC,CACnG,CAAC;QACF,IAAI,MAAM,CAAC,UAAU,CAAC,SAAS;YAC7B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,2DAA2D,CAAC,CAAC;QAC5E,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW;YAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1E,CAAC"}

package/dist/commands/graph/bounds.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Memory-bounded projection of one file's direct edges.
+ *
+ * Persisted snapshots already keep their edges in canonical order. Iterating
+ * that snapshot directly avoids materialising the complete high-degree result
+ * returned by `RestoredFileGraph.edgesFrom` immediately before JSON encoding.
+ * We still count every matching edge so the visible omission count is exact.
+ */
+export declare function boundDirectEdges<T extends {
+    readonly fromFileId: string;
+}>(candidates: Iterable<T>, fromFileId: string, maxEdges: number): {
+    edges: T[];
+    truncated: boolean;
+    omittedCount: number;
+};
+//# sourceMappingURL=bounds.d.ts.map

package/dist/commands/graph/bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.d.ts","sourceRoot":"","sources":["../../../src/commands/graph/bounds.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EACxE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,EACvB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAY1D"}

package/dist/commands/graph/bounds.js

@@ -0,0 +1,22 @@
+/**
+ * Memory-bounded projection of one file's direct edges.
+ *
+ * Persisted snapshots already keep their edges in canonical order. Iterating
+ * that snapshot directly avoids materialising the complete high-degree result
+ * returned by `RestoredFileGraph.edgesFrom` immediately before JSON encoding.
+ * We still count every matching edge so the visible omission count is exact.
+ */
+export function boundDirectEdges(candidates, fromFileId, maxEdges) {
+    const edges = [];
+    let matchingCount = 0;
+    for (const edge of candidates) {
+        if (edge.fromFileId !== fromFileId)
+            continue;
+        matchingCount += 1;
+        if (edges.length < maxEdges)
+            edges.push(edge);
+    }
+    const omittedCount = matchingCount - edges.length;
+    return { edges, truncated: omittedCount > 0, omittedCount };
+}
+//# sourceMappingURL=bounds.js.map

package/dist/commands/graph/bounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.js","sourceRoot":"","sources":["../../../src/commands/graph/bounds.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAuB,EACvB,UAAkB,EAClB,QAAgB;IAEhB,MAAM,KAAK,GAAQ,EAAE,CAAC;IACtB,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU;YAAE,SAAS;QAC7C,aAAa,IAAI,CAAC,CAAC;QACnB,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,YAAY,GAAG,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC;IAClD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC;AAC9D,CAAC"}

package/dist/commands/graph/category-clusters.d.ts

@@ -0,0 +1,20 @@
+import type { FeaturePoint3D } from "./feature-3d.js";
+import type { FeatureMapEdgeV1, FeatureMapNodeV1 } from "./feature-model.js";
+export type CategoryClusterDimension = "code" | "test" | "owner" | "intent" | "unmapped";
+export type CategoryClusterNode = Pick<FeatureMapNodeV1, "id" | "kind"> & Partial<Pick<FeatureMapNodeV1, "label" | "path" | "details" | "status">>;
+export interface CategoryClusterGroup {
+    id: string;
+    kind: "category" | "shared" | "unassigned";
+    label: string;
+    center: FeaturePoint3D;
+    memberIds: string[];
+}
+export interface CategoryClusterLayout {
+    positions: Record<string, FeaturePoint3D>;
+    groups: CategoryClusterGroup[];
+    memberships: Record<string, string[]>;
+    description: string;
+}
+/** Self-contained browser geometry; context paths are declarations, never inferred ownership. */
+export declare function createCategoryClusterLayout(nodes: readonly CategoryClusterNode[], edges: readonly Pick<FeatureMapEdgeV1, "from" | "to" | "kind">[], dimension: CategoryClusterDimension): CategoryClusterLayout;
+//# sourceMappingURL=category-clusters.d.ts.map

package/dist/commands/graph/category-clusters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-clusters.d.ts","sourceRoot":"","sources":["../../../src/commands/graph/category-clusters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;AACzF,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,MAAM,CAAC,GACrE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC;AAE3E,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,iGAAiG;AACjG,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,KAAK,EAAE,SAAS,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC,EAAE,EAChE,SAAS,EAAE,wBAAwB,GAClC,qBAAqB,CAsKvB"}

package/dist/commands/graph/category-clusters.js

@@ -0,0 +1,158 @@
+/** Self-contained browser geometry; context paths are declarations, never inferred ownership. */
+export function createCategoryClusterLayout(nodes, edges, dimension) {
+    const compare = (a, b) => (a < b ? -1 : a > b ? 1 : 0);
+    const descriptions = {
+        code: "Code areas use repository-relative directories. Other nodes show declared feature context.",
+        test: "Test areas use repository-relative directories. Other nodes show declared feature context.",
+        owner: "Ownership groups use declared roles and feature scopes. They do not establish file ownership.",
+        intent: "Vision / Spec groups use source paths and declared feature scopes, not semantic similarity.",
+        unmapped: "Unassigned files use repository-relative directories. Declared context stays separate.",
+    };
+    if (!Object.hasOwn(descriptions, dimension))
+        throw new RangeError("Unknown grouping category.");
+    const ordered = [...nodes].sort((a, b) => compare(a.id, b.id));
+    const byId = new Map(ordered.map((node) => [node.id, node]));
+    const features = new Set(ordered.filter((node) => node.kind === "feature").map((node) => node.id));
+    const memberships = Object.create(null);
+    const positions = Object.create(null);
+    const buckets = new Map();
+    const anchorBuckets = new Map();
+    const featureBuckets = new Map([...features].map((id) => [id, new Set()]));
+    const linkedFeatures = new Map(ordered.map((node) => [node.id, new Set()]));
+    const compatible = {
+        feature: [],
+        code: ["code", "test"],
+        test: ["code", "test"],
+        owner: ["ownership"],
+        intent: ["intent"],
+        unmapped: [],
+    };
+    const targetRelations = {
+        code: "code",
+        test: "test",
+        owner: "ownership",
+        intent: "intent",
+        unmapped: null,
+    };
+    for (const node of ordered) {
+        const roles = node.details?.["roles"];
+        const hasRole = (role) => (node.kind === "code" || node.kind === "test") &&
+            Array.isArray(roles) &&
+            roles.includes(role);
+        const anchor = dimension === "code"
+            ? node.kind === "code" || node.kind === "unmapped" || hasRole("code")
+            : dimension === "test"
+                ? node.kind === "test" || hasRole("test")
+                : node.kind === dimension;
+        if (!anchor)
+            continue;
+        let key;
+        let label;
+        if (dimension === "owner") {
+            key = node.id;
+            label = node.label || node.id;
+            if (node.status === "missing")
+                label += " (missing ownership)";
+        }
+        else if (dimension === "intent") {
+            key = node.path || "(no source path)";
+            label = node.path || "Intent without a source path";
+        }
+        else if (!node.path) {
+            key = "(no source path)";
+            label = "Files without a source path";
+        }
+        else {
+            const directories = node.path.replaceAll("\\", "/").split("/").slice(0, -1);
+            key = directories.slice(0, 2).join("/") || ".";
+            label = key === "." ? "Repository root" : key;
+        }
+        const id = dimension !== "owner" && !node.path ? `missing:${dimension}` : `${dimension}:${key}`;
+        if (!buckets.has(id))
+            buckets.set(id, { label, sortKey: key, memberIds: [] });
+        anchorBuckets.set(node.id, id);
+    }
+    if (dimension !== "unmapped") {
+        for (const edge of edges) {
+            const fromFeature = features.has(edge.from);
+            const toFeature = features.has(edge.to);
+            if (fromFeature === toFeature)
+                continue;
+            const feature = fromFeature ? edge.from : edge.to;
+            const member = byId.get(fromFeature ? edge.to : edge.from);
+            if (!member || !compatible[member.kind].includes(edge.kind))
+                continue;
+            linkedFeatures.get(member.id).add(feature);
+            const bucket = anchorBuckets.get(member.id);
+            if (bucket !== undefined && edge.kind === targetRelations[dimension])
+                featureBuckets.get(feature).add(bucket);
+        }
+    }
+    const shared = [];
+    const outside = [];
+    for (const node of ordered) {
+        const anchor = anchorBuckets.get(node.id);
+        const categories = anchor !== undefined
+            ? [anchor]
+            : [
+                ...new Set((node.kind === "feature" ? [node.id] : [...linkedFeatures.get(node.id)]).flatMap((id) => [...featureBuckets.get(id)])),
+            ].sort(compare);
+        memberships[node.id] = categories;
+        if (categories.length === 1)
+            buckets.get(categories[0]).memberIds.push(node.id);
+        else if (categories.length > 1)
+            shared.push(node.id);
+        else
+            outside.push(node.id);
+    }
+    const primary = [...buckets].sort(([a, first], [b, second]) => compare(first.sortKey, second.sortKey) || compare(a, b));
+    const columns = Math.max(1, Math.ceil(Math.sqrt(primary.length * 1.3)));
+    const rows = Math.ceil(primary.length / columns);
+    const stepX = Math.min(140, 700 / Math.max(1, columns - 1));
+    const stepY = Math.min(110, 400 / Math.max(1, rows - 1));
+    const radius = primary.length === 1 ? 140 : Math.min(50, Math.min(stepX, stepY) * 0.4);
+    const goldenAngle = Math.PI * (3 - Math.sqrt(5));
+    const groups = [];
+    function placeMembers(ids, center, extent) {
+        ids.forEach((id, index) => {
+            const orbit = extent * (0.12 + 0.88 * Math.sqrt((index + 0.5) / ids.length));
+            const kind = byId.get(id).kind;
+            const depth = kind === "test" ? 1 : kind === "owner" ? 0.5 : kind === "intent" ? -0.5 : -1;
+            positions[id] = {
+                x: center.x + Math.cos(index * goldenAngle) * orbit,
+                y: center.y + Math.sin(index * goldenAngle) * orbit,
+                z: center.z + extent * (depth * 0.2 + ((index % 7) - 3) * 0.035),
+            };
+        });
+    }
+    primary.forEach(([id, bucket], index) => {
+        const row = Math.floor(index / columns);
+        const rowSize = Math.min(columns, primary.length - row * columns);
+        const center = {
+            x: ((index % columns) - (rowSize - 1) / 2) * stepX,
+            y: -65 + (row - (rows - 1) / 2) * stepY,
+            z: ((index % 3) - 1) * 12,
+        };
+        placeMembers(bucket.memberIds, center, radius);
+        groups.push({ id, kind: "category", label: bucket.label, center, memberIds: bucket.memberIds });
+    });
+    function addContext(kind, label, ids, x) {
+        if (ids.length === 0)
+            return;
+        const center = primary.length === 0 ? { x: 0, y: 0, z: 0 } : { x, y: 270, z: 0 };
+        const extent = primary.length === 0 ? 190 : Math.min(85, 65 + Math.sqrt(ids.length) * 0.75);
+        placeMembers(ids, center, extent);
+        groups.push({ id: `context:${dimension}:${kind}`, kind, label, center, memberIds: ids });
+    }
+    const outsideLabels = {
+        code: "Outside declared code context",
+        test: "Outside declared test context",
+        owner: "No declared ownership context",
+        intent: "No declared vision / spec context",
+        unmapped: "Declared context",
+    };
+    addContext("shared", "Shared context", shared, -175);
+    addContext("unassigned", outsideLabels[dimension], outside, 175);
+    return { positions, groups, memberships, description: descriptions[dimension] };
+}
+//# sourceMappingURL=category-clusters.js.map

package/dist/commands/graph/category-clusters.js.map

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

package/dist/commands/graph/feature-3d.d.ts

@@ -0,0 +1,22 @@
+import type { FeatureMapEdgeV1, FeatureMapNodeV1 } from "./feature-model.js";
+export interface FeaturePoint3D {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface FeatureCamera3D {
+    yaw: number;
+    pitch: number;
+}
+/** Stable spatial grouping follows declared edges. Distance is a layout choice, not evidence. */
+export declare function createFeatureWoolLayout(nodes: readonly Pick<FeatureMapNodeV1, "id" | "kind">[], edges: readonly Pick<FeatureMapEdgeV1, "from" | "to">[]): Record<string, FeaturePoint3D>;
+/** Rotate in world space, then project with a camera outside every bounded layout point. */
+export declare function projectFeaturePoint(point: FeaturePoint3D, camera: FeatureCamera3D): {
+    x: number;
+    y: number;
+    depth: number;
+    scale: number;
+};
+/** Sample a cubic thread in 3D before projection; rotation changes the whole thread. */
+export declare function createFeatureThread(from: FeaturePoint3D, to: FeaturePoint3D, camera: FeatureCamera3D, winding: number, grouping?: number): string;
+//# sourceMappingURL=feature-3d.d.ts.map

package/dist/commands/graph/feature-3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-3d.d.ts","sourceRoot":"","sources":["../../../src/commands/graph/feature-3d.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iGAAiG;AACjG,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,MAAM,CAAC,EAAE,EACvD,KAAK,EAAE,SAAS,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC,EAAE,GACtD,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAwDhC;AAED,4FAA4F;AAC5F,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,eAAe,GACtB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAWxD;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,cAAc,EACpB,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM,EACf,QAAQ,SAAI,GACX,MAAM,CAyCR"}

package/dist/commands/graph/feature-3d.js

@@ -0,0 +1,114 @@
+/** Stable spatial grouping follows declared edges. Distance is a layout choice, not evidence. */
+export function createFeatureWoolLayout(nodes, edges) {
+    const positions = Object.create(null);
+    const ordered = [...nodes].sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+    const features = ordered.filter((node) => node.kind === "feature");
+    const featureIds = new Set(features.map((node) => node.id));
+    const adjacency = new Map();
+    for (const edge of edges) {
+        if (featureIds.has(edge.from)) {
+            if (!adjacency.has(edge.to))
+                adjacency.set(edge.to, new Set());
+            adjacency.get(edge.to).add(edge.from);
+        }
+        if (featureIds.has(edge.to)) {
+            if (!adjacency.has(edge.from))
+                adjacency.set(edge.from, new Set());
+            adjacency.get(edge.from).add(edge.to);
+        }
+    }
+    const goldenAngle = Math.PI * (3 - Math.sqrt(5));
+    function sphere(index, count, radius) {
+        const y = 1 - (2 * (index + 0.5)) / Math.max(1, count);
+        const ring = Math.sqrt(Math.max(0, 1 - y * y));
+        return {
+            x: Math.cos(index * goldenAngle) * ring * radius,
+            y: y * radius,
+            z: Math.sin(index * goldenAngle) * ring * radius,
+        };
+    }
+    features.forEach((node, index) => {
+        positions[node.id] =
+            features.length === 1 ? { x: 0, y: 0, z: 0 } : sphere(index, features.length, 200);
+    });
+    const other = ordered.filter((node) => node.kind !== "feature");
+    other.forEach((node, index) => {
+        const linked = [...(adjacency.get(node.id) ?? [])].sort();
+        if (linked.length === 0) {
+            positions[node.id] = sphere(index, other.length, 335 + (index % 7) * 5);
+            return;
+        }
+        const center = { x: 0, y: 0, z: 0 };
+        for (const id of linked) {
+            const point = positions[id];
+            center.x += point.x / linked.length;
+            center.y += point.y / linked.length;
+            center.z += point.z / linked.length;
+        }
+        const radius = node.kind === "code" ? 88 : node.kind === "test" ? 118 : 150;
+        const offset = sphere(index, other.length, radius + (index % 11) * 2);
+        positions[node.id] = {
+            x: center.x + offset.x,
+            y: center.y + offset.y,
+            z: center.z + offset.z,
+        };
+    });
+    return positions;
+}
+/** Rotate in world space, then project with a camera outside every bounded layout point. */
+export function projectFeaturePoint(point, camera) {
+    const cosYaw = Math.cos(camera.yaw);
+    const sinYaw = Math.sin(camera.yaw);
+    const x = point.x * cosYaw + point.z * sinYaw;
+    const z = point.z * cosYaw - point.x * sinYaw;
+    const cosPitch = Math.cos(camera.pitch);
+    const sinPitch = Math.sin(camera.pitch);
+    const y = point.y * cosPitch - z * sinPitch;
+    const depth = point.y * sinPitch + z * cosPitch;
+    const scale = 1000 / (1000 - depth);
+    return { x: 650 + x * scale, y: 410 + y * scale, depth, scale };
+}
+/** Sample a cubic thread in 3D before projection; rotation changes the whole thread. */
+export function createFeatureThread(from, to, camera, winding, grouping = 0) {
+    const twist = Math.max(-1, Math.min(1, winding)) * 90;
+    const a = { x: from.x * 0.35 + twist, y: from.y * 0.35 - twist, z: from.z * 0.35 + twist };
+    const b = { x: to.x * 0.35 - twist, y: to.y * 0.35 + twist, z: to.z * 0.35 - twist };
+    const amount = Number.isFinite(grouping) ? Math.max(0, Math.min(1, grouping)) : 0;
+    if (amount > 0) {
+        const dx = to.x - from.x;
+        const dy = to.y - from.y;
+        const dz = to.z - from.z;
+        const length = Math.hypot(dx, dy, dz);
+        const bend = Math.max(-1, Math.min(1, winding)) * Math.min(24, length * 0.12);
+        const normal = Math.hypot(dx, dy) || 1;
+        const offset = { x: (-dy / normal) * bend, y: (dx / normal) * bend, z: bend * 0.35 };
+        const localA = {
+            x: from.x + dx / 3 + offset.x,
+            y: from.y + dy / 3 + offset.y,
+            z: from.z + dz / 3 + offset.z,
+        };
+        const localB = {
+            x: from.x + (dx * 2) / 3 + offset.x,
+            y: from.y + (dy * 2) / 3 + offset.y,
+            z: from.z + (dz * 2) / 3 + offset.z,
+        };
+        for (const coordinate of ["x", "y", "z"]) {
+            a[coordinate] += (localA[coordinate] - a[coordinate]) * amount;
+            b[coordinate] += (localB[coordinate] - b[coordinate]) * amount;
+        }
+    }
+    const parts = [];
+    for (let i = 0; i <= 18; i += 1) {
+        const t = i / 18;
+        const s = 1 - t;
+        const point = {
+            x: s ** 3 * from.x + 3 * s ** 2 * t * a.x + 3 * s * t ** 2 * b.x + t ** 3 * to.x,
+            y: s ** 3 * from.y + 3 * s ** 2 * t * a.y + 3 * s * t ** 2 * b.y + t ** 3 * to.y,
+            z: s ** 3 * from.z + 3 * s ** 2 * t * a.z + 3 * s * t ** 2 * b.z + t ** 3 * to.z,
+        };
+        const projected = projectFeaturePoint(point, camera);
+        parts.push(`${i === 0 ? "M" : "L"}${projected.x.toFixed(2)},${projected.y.toFixed(2)}`);
+    }
+    return parts.join(" ");
+}
+//# sourceMappingURL=feature-3d.js.map

package/dist/commands/graph/feature-3d.js.map

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

package/dist/commands/graph/feature-clusters.d.ts

@@ -0,0 +1,17 @@
+import type { FeaturePoint3D } from "./feature-3d.js";
+import type { FeatureMapEdgeV1, FeatureMapNodeV1 } from "./feature-model.js";
+export interface FeatureClusterGroup {
+    id: string;
+    kind: "feature" | "shared" | "unassigned";
+    featureId?: string;
+    center: FeaturePoint3D;
+    memberIds: string[];
+}
+export interface FeatureClusterLayout {
+    positions: Record<string, FeaturePoint3D>;
+    groups: FeatureClusterGroup[];
+    memberships: Record<string, string[]>;
+}
+/** Declared membership determines each island; spatial distance proves nothing beyond layout. */
+export declare function createFeatureClusterLayout(nodes: readonly Pick<FeatureMapNodeV1, "id" | "kind">[], edges: readonly Pick<FeatureMapEdgeV1, "from" | "to" | "kind">[]): FeatureClusterLayout;
+//# sourceMappingURL=feature-clusters.d.ts.map

package/dist/commands/graph/feature-clusters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-clusters.d.ts","sourceRoot":"","sources":["../../../src/commands/graph/feature-clusters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACvC;AAED,iGAAiG;AACjG,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,SAAS,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,MAAM,CAAC,EAAE,EACvD,KAAK,EAAE,SAAS,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC,EAAE,GAC/D,oBAAoB,CAuGtB"}