@backthread/extractor 0.1.0

package/dist/framework/contribute-step.js

@@ -0,0 +1,403 @@
+// (Slice A) — the GENERIC framework contribution-consumption step.
+//
+// The post-cluster sibling of scripts/ingest/infra/infra-step.ts. Where the
+// detect-step ( Slice 1) only LOGS the detected-stack manifest, THIS step
+// is what finally consumes it: for every detected adapter it runs the
+// `syntheticEdges` + `roleTags` hooks and folds their contributions into the
+// render graph. It is FRAMEWORK-AGNOSTIC — the RN adapter is the first client,
+// and Next/Nest/Node/ORM reuse it unchanged.
+//
+// Founder decision (2026-06-26): render-only, POST-CLUSTER ("connect now, group
+// later") — this runs AFTER clusterGraph + enrich, BEFORE assemble.
+//
+// What it does:
+//   * resolves each contribution's FILE-id endpoints → MODULE ids via the
+//     cluster's fileModuleMap (a screen file lands in its module);
+//   * DROPS self-edges (intra-module navigation collapses) + dedupes on
+//     (source, target, kind); validates every edge is one of the 8 verbs
+//     (parseEdgeKind — the same fail-loud boundary assemble + persist trust);
+//   * collapses role tags to ONE per module (highest RoleTag.priority, lexical
+//     tiebreak) — pure metadata; the module's `kind` is UNCHANGED (roles never
+//     widen the Module-kind enum);
+//   * consumes each adapter's `groupingPrior` (FrameworkGroup[]) and
+//     OVERRIDES the subsystem of every claimed module (see SUBSYSTEM OVERRIDE
+//     below). This is the only place that mutates `cluster`;
+//   * LOGS counts + everything unresolved/dropped — no silent caps.
+//
+// ── SUBSYSTEM OVERRIDE — the shared framework-grouping mechanism ──
+// A framework's `groupingPrior` declares the AUTHORITATIVE grouping (a NestJS
+// `@Module`, a Next route group): a named set of FILE ids that belong in ONE
+// subsystem regardless of where they sit on disk. We resolve each group's files
+// to MODULE ids and, for every claimed module, set its subsystem to the group.
+//
+// HOW (without touching assemble / cluster code): subsystems are computed inside
+// assemble by computeSubsystems(cluster.modules), whose precedence is
+//     external  >  workspace-package (packageId)  >  directory.
+// `packageId` is the EXISTING "a declared boundary beats directory
+// clustering" lever, read ONLY by computeSubsystems. A framework group is exactly
+// that shape, so we ride it: we MUTATE the claimed ClusteredModule in place —
+// packageId = `<adapter>:<group.id>` (namespaced, deterministic, never an index),
+// packageName = the group label, packageRole = cleared (a framework group is a
+// domain boundary, not an app/lib/tooling package). assemble then renders the
+// override naturally. This runs BEFORE assemble, so the rendered grouping — and
+// the semantic-zoom subsystem super-nodes that aggregate by `Module.subsystem`
+// — reflect it with no change to the zoom machinery.
+//
+// PRECEDENCE we implement: framework group  >  workspace-package  >  directory.
+// (We overwrite packageId, so the group beats both an inherited workspace package
+// AND the directory heuristic.) `external` / infra-namespaced modules are NEVER
+// claimed (they have no source files in a group anyway, and we skip them
+// defensively), so the `external` subsystem still wins — the partition stays total.
+//
+// A module claimed by more than one group goes to the group that claims the MOST
+// of its files (lexical group-id tiebreak); the collision is LOGGED, never a
+// silent pick. When no adapter supplies a group, this is a complete no-op — the
+// cluster is untouched and assemble is byte-identical (the headline invariant).
+//
+// Detection runs INTERNALLY here (not reusing the once-per-clone detect-step log)
+// so the manifest matches THIS tree: the hosted merge walk re-runs the step at
+// each checkpoint's checked-out tree, and a repo may have adopted RN partway
+// through its history. Cheap (file-exists + one package.json read per adapter).
+//
+// Degrade, don't abort (mirrors extractInfra's call-site discipline): a malformed
+// adapter must never sink an otherwise-good snapshot — a throw anywhere degrades
+// to the empty contribution + a warning, and the snapshot assembles without it.
+import { ModuleId, parseEdgeKind } from '../types.js';
+import { crossLanguageApiEdges } from '../graph/cross-language.js';
+import { registerBuiltinFrameworkAdapters } from './register.js';
+import { detectFrameworks, listFrameworkAdapters } from './registry.js';
+const EMPTY = {
+    edges: [],
+    roles: new Map(),
+    subsystems: new Map(),
+    counts: {
+        adapters: 0,
+        rawEdges: 0,
+        edges: 0,
+        droppedSelf: 0,
+        droppedUnresolved: 0,
+        droppedBadKind: 0,
+        roles: 0,
+        groups: 0,
+        groupedModules: 0,
+        droppedGroupUnresolved: 0,
+    },
+};
+export async function contributeFrameworkGraph(args) {
+    const { repoDir, graph, cluster } = args;
+    try {
+        registerBuiltinFrameworkAdapters();
+        const manifest = await detectFrameworks(repoDir);
+        // the cross-language full-stack seam (frontend→backend HTTP-API
+        // edges) is computed from the graph + a direct FastAPI-surface parse, NOT from
+        // the framework manifest, so it fires even when the FastAPI backend sits in a
+        // nested package the root detect didn't claim. Empty for a single-language repo
+        // (so single-language output stays byte-identical). File-id space; folded
+        // through the SAME resolve/dedup as the adapters' syntheticEdges below.
+        let xlangEdges = [];
+        try {
+            xlangEdges = crossLanguageApiEdges({ repoDir, graph });
+        }
+        catch (err) {
+            console.warn(`  ⚠ cross-language linking failed (${err.message}) — continuing without the full-stack seam`);
+        }
+        if (manifest.matches.length === 0 && xlangEdges.length === 0) {
+            // No framework detected AND no cross-language seam → generic behavior unchanged.
+            return EMPTY;
+        }
+        const adaptersByName = new Map(listFrameworkAdapters().map((a) => [a.name, a]));
+        const moduleIds = new Set(cluster.modules.map((m) => m.id));
+        const fileModuleMap = cluster.fileModuleMap;
+        // file id or module id → module id (or null when it resolves to nothing on
+        // the canvas — a dropped file, or an endpoint outside the cluster).
+        const resolve = (id) => {
+            if (moduleIds.has(id))
+                return id;
+            const viaFile = fileModuleMap[id];
+            if (viaFile && moduleIds.has(viaFile))
+                return viaFile;
+            return null;
+        };
+        const edgesByKey = new Map();
+        // moduleId → the highest-priority role seen + the distinct roles that landed
+        // on it (for the collapse log).
+        const roleByModule = new Map();
+        const distinctRolesByModule = new Map();
+        let rawEdges = 0;
+        let droppedSelf = 0;
+        let droppedUnresolved = 0;
+        let droppedBadKind = 0;
+        const unresolvedEndpoints = new Set();
+        // grouping priors collected across adapters, namespaced by adapter
+        // (`<adapter>:<group.id>`) so two adapters' groups never collide. Resolved +
+        // applied as a subsystem override AFTER the loop (see below).
+        const groupsByKey = new Map();
+        let rawGroups = 0;
+        let droppedGroupUnresolved = 0;
+        for (const match of manifest.matches) {
+            const adapter = adaptersByName.get(match.adapter);
+            if (!adapter)
+                continue;
+            const ctx = {
+                repoDir,
+                rootPath: match.rootPath,
+                match,
+                graph,
+                cluster: { fileModuleMap, moduleIds },
+            };
+            // --- syntheticEdges ---------------------------------------------------
+            if (adapter.syntheticEdges) {
+                let fwEdges = [];
+                try {
+                    fwEdges = await adapter.syntheticEdges(ctx);
+                }
+                catch (err) {
+                    console.warn(`  ⚠ framework adapter '${match.adapter}' syntheticEdges failed (${err.message}) — skipping its edges`);
+                    fwEdges = [];
+                }
+                for (const fe of fwEdges) {
+                    rawEdges++;
+                    const src = resolve(fe.source);
+                    const tgt = resolve(fe.target);
+                    if (!src || !tgt) {
+                        droppedUnresolved++;
+                        if (!src)
+                            unresolvedEndpoints.add(fe.source);
+                        if (!tgt)
+                            unresolvedEndpoints.add(fe.target);
+                        continue;
+                    }
+                    if (src === tgt) {
+                        // Intra-module contribution (e.g. navigation within one cluster)
+                        // collapses to a self-edge — dropped at the producer, exactly as
+                        // aggregateModuleEdges + the infra join do.
+                        droppedSelf++;
+                        continue;
+                    }
+                    let kind;
+                    try {
+                        kind = parseEdgeKind(fe.kind);
+                    }
+                    catch (err) {
+                        // A non-8-verb framework edge is a producer bug; drop + log it
+                        // rather than sink the snapshot (degrade-on-throw).
+                        droppedBadKind++;
+                        console.warn(`  ⚠ framework adapter '${match.adapter}' emitted ${err.message}`);
+                        continue;
+                    }
+                    const key = `${src}→${tgt}:${kind}`;
+                    if (!edgesByKey.has(key)) {
+                        edgesByKey.set(key, { source: ModuleId(src), target: ModuleId(tgt), kind });
+                    }
+                }
+            }
+            // --- roleTags ---------------------------------------------------------
+            if (adapter.roleTags) {
+                let tags = new Map();
+                try {
+                    tags = await adapter.roleTags(ctx);
+                }
+                catch (err) {
+                    console.warn(`  ⚠ framework adapter '${match.adapter}' roleTags failed (${err.message}) — skipping its roles`);
+                    tags = new Map();
+                }
+                for (const [endpoint, tag] of tags) {
+                    const moduleId = resolve(endpoint);
+                    if (!moduleId) {
+                        unresolvedEndpoints.add(endpoint);
+                        continue;
+                    }
+                    let seen = distinctRolesByModule.get(moduleId);
+                    if (!seen) {
+                        seen = new Set();
+                        distinctRolesByModule.set(moduleId, seen);
+                    }
+                    seen.add(tag.role);
+                    const cur = roleByModule.get(moduleId);
+                    if (cur === undefined || beats(tag, cur))
+                        roleByModule.set(moduleId, tag);
+                }
+            }
+            // --- groupingPrior ------------------------------------------
+            // Collect now (in FILE-id space); resolve + apply as a subsystem override
+            // after the loop, so a group spanning several adapters'/modules' files is
+            // arbitrated globally. classificationsNeeded is deferred (not run here).
+            if (adapter.groupingPrior) {
+                let prior;
+                try {
+                    prior = await adapter.groupingPrior(ctx);
+                }
+                catch (err) {
+                    console.warn(`  ⚠ framework adapter '${match.adapter}' groupingPrior failed (${err.message}) — skipping its groups`);
+                    prior = undefined;
+                }
+                for (const group of prior?.groups ?? []) {
+                    rawGroups++;
+                    // Namespace the id by adapter (the documented FrameworkGroup contract)
+                    // so it's a unique, deterministic subsystem id across adapters.
+                    const key = `${match.adapter}:${group.id}`;
+                    const existing = groupsByKey.get(key);
+                    if (existing)
+                        existing.fileIds.push(...group.fileIds);
+                    else
+                        groupsByKey.set(key, { label: group.label, fileIds: [...group.fileIds] });
+                }
+            }
+        }
+        // --- cross-language full-stack seam ----------------------------
+        // Fold the frontend→backend HTTP-API edges through the SAME file-id→module
+        // resolution + self-edge drop + 8-verb validation + dedup as the adapter
+        // syntheticEdges above (so a seam edge that duplicates a structural edge, or
+        // collapses to one module, is handled identically).
+        for (const fe of xlangEdges) {
+            rawEdges++;
+            const src = resolve(fe.source);
+            const tgt = resolve(fe.target);
+            if (!src || !tgt) {
+                droppedUnresolved++;
+                if (!src)
+                    unresolvedEndpoints.add(fe.source);
+                if (!tgt)
+                    unresolvedEndpoints.add(fe.target);
+                continue;
+            }
+            if (src === tgt) {
+                droppedSelf++;
+                continue;
+            }
+            let kind;
+            try {
+                kind = parseEdgeKind(fe.kind);
+            }
+            catch (err) {
+                droppedBadKind++;
+                console.warn(`  ⚠ cross-language edge emitted ${err.message}`);
+                continue;
+            }
+            const key = `${src}→${tgt}:${kind}`;
+            if (!edgesByKey.has(key)) {
+                edgesByKey.set(key, { source: ModuleId(src), target: ModuleId(tgt), kind });
+            }
+        }
+        if (xlangEdges.length > 0) {
+            console.log(`  [cross-language] ${xlangEdges.length} frontend→backend API edge(s) contributed`);
+        }
+        // --- apply the grouping override -------------------------------
+        // Resolve every group's FILE ids → MODULE ids, tally per-module group claims,
+        // assign each claimed module to the group claiming the MOST of its files
+        // (lexical group-key tiebreak), and MUTATE that ClusteredModule's packageId/
+        // packageName so assemble's computeSubsystems renders the framework grouping
+        // (precedence: framework group > workspace-package > directory). See the
+        // SUBSYSTEM OVERRIDE note at the top of this file.
+        const subsystems = new Map();
+        if (groupsByKey.size > 0) {
+            const moduleById = new Map(cluster.modules.map((m) => [m.id, m]));
+            // moduleId → groupKey → count of that group's files landing in the module.
+            const claims = new Map();
+            const labelByKey = new Map();
+            const unresolvedGroupFiles = new Set();
+            for (const [key, group] of groupsByKey) {
+                labelByKey.set(key, group.label);
+                for (const fileId of group.fileIds) {
+                    const moduleId = resolve(fileId);
+                    const mod = moduleId ? moduleById.get(moduleId) : undefined;
+                    // Never claim an external / infra-namespaced module (it has no source
+                    // dir → it belongs to the fixed `external` subsystem, which outranks).
+                    if (!moduleId || !mod || mod.kind === 'external' || moduleId.includes(':')) {
+                        droppedGroupUnresolved++;
+                        unresolvedGroupFiles.add(fileId);
+                        continue;
+                    }
+                    let byKey = claims.get(moduleId);
+                    if (!byKey) {
+                        byKey = new Map();
+                        claims.set(moduleId, byKey);
+                    }
+                    byKey.set(key, (byKey.get(key) ?? 0) + 1);
+                }
+            }
+            // Deterministic assignment + collision logging (no silent pick).
+            for (const moduleId of [...claims.keys()].sort()) {
+                const byKey = claims.get(moduleId);
+                let winner = '';
+                let winnerCount = -1;
+                for (const [key, count] of byKey) {
+                    if (count > winnerCount || (count === winnerCount && key < winner)) {
+                        winner = key;
+                        winnerCount = count;
+                    }
+                }
+                if (byKey.size > 1) {
+                    const all = [...byKey.entries()].map(([k, c]) => `${k}×${c}`).sort().join(', ');
+                    console.log(`  [framework] module '${moduleId}' claimed by ${byKey.size} groups {${all}} → kept '${winner}'`);
+                }
+                const mod = moduleById.get(moduleId);
+                const label = labelByKey.get(winner) ?? winner;
+                // The override: ride 's packageId lever (read ONLY by
+                // computeSubsystems). Clear packageRole — a framework group is a domain
+                // boundary, not an app/lib/tooling package.
+                mod.packageId = winner;
+                mod.packageName = label;
+                mod.packageRole = undefined;
+                subsystems.set(moduleId, { id: winner, label });
+            }
+            // No silent caps: log group files that didn't resolve to a claimable
+            // module (mirrors the unresolved-endpoints log on the edges path).
+            if (unresolvedGroupFiles.size > 0) {
+                const sample = [...unresolvedGroupFiles].sort().slice(0, 10);
+                console.log(`  [framework] ${unresolvedGroupFiles.size} group file(s) didn't resolve to a claimable module (not regrouped): ${sample.join(', ')}` +
+                    (unresolvedGroupFiles.size > sample.length ? ' …' : ''));
+            }
+        }
+        // No silent caps: log unresolved endpoints + per-module role collapses.
+        if (unresolvedEndpoints.size > 0) {
+            const sample = [...unresolvedEndpoints].sort().slice(0, 10);
+            console.log(`  [framework] ${unresolvedEndpoints.size} endpoint(s) didn't resolve to a module (dropped): ${sample.join(', ')}` +
+                (unresolvedEndpoints.size > sample.length ? ' …' : ''));
+        }
+        for (const [moduleId, set] of distinctRolesByModule) {
+            if (set.size > 1) {
+                const winner = roleByModule.get(moduleId)?.role;
+                console.log(`  [framework] module '${moduleId}' had ${set.size} roles {${[...set].sort().join(', ')}} → kept '${winner}'`);
+            }
+        }
+        const edges = [...edgesByKey.values()];
+        console.log(`→ framework contributions: ${edges.length} edge(s)` +
+            (droppedSelf ? ` · ${droppedSelf} self-edge(s) collapsed` : '') +
+            (droppedUnresolved ? ` · ${droppedUnresolved} unresolved` : '') +
+            (droppedBadKind ? ` · ${droppedBadKind} bad-kind` : '') +
+            ` · ${roleByModule.size} role(s)` +
+            (subsystems.size ? ` · ${subsystems.size} module(s) regrouped into ${new Set([...subsystems.values()].map((s) => s.id)).size} subsystem(s)` : ''));
+        return {
+            edges,
+            roles: roleByModule,
+            subsystems,
+            counts: {
+                adapters: manifest.matches.length,
+                rawEdges,
+                edges: edges.length,
+                droppedSelf,
+                droppedUnresolved,
+                droppedBadKind,
+                roles: roleByModule.size,
+                groups: rawGroups,
+                groupedModules: subsystems.size,
+                droppedGroupUnresolved,
+            },
+        };
+    }
+    catch (err) {
+        console.warn(`  ⚠ framework contribution failed (${err.message}) — continuing without framework edges/roles`);
+        return EMPTY;
+    }
+}
+// Higher RoleTag.priority wins; lexical role tiebreak keeps it deterministic
+// regardless of adapter/iteration order.
+function beats(incoming, incumbent) {
+    const a = incoming.priority ?? 0;
+    const b = incumbent.priority ?? 0;
+    if (a !== b)
+        return a > b;
+    return incoming.role < incumbent.role;
+}
+//# sourceMappingURL=contribute-step.js.map

package/dist/framework/contribute-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribute-step.js","sourceRoot":"","sources":["../../src/framework/contribute-step.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,sEAAsE;AACtE,6EAA6E;AAC7E,+EAA+E;AAC/E,6CAA6C;AAC7C,EAAE;AACF,gFAAgF;AAChF,oEAAoE;AACpE,EAAE;AACF,gBAAgB;AAChB,0EAA0E;AAC1E,mEAAmE;AACnE,wEAAwE;AACxE,yEAAyE;AACzE,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,mCAAmC;AACnC,qEAAqE;AACrE,8EAA8E;AAC9E,6DAA6D;AAC7D,oEAAoE;AACpE,EAAE;AACF,qEAAqE;AACrE,8EAA8E;AAC9E,6EAA6E;AAC7E,gFAAgF;AAChF,+EAA+E;AAC/E,EAAE;AACF,iFAAiF;AACjF,sEAAsE;AACtE,gEAAgE;AAChE,mEAAmE;AACnE,kFAAkF;AAClF,8EAA8E;AAC9E,kFAAkF;AAClF,+EAA+E;AAC/E,8EAA8E;AAC9E,gFAAgF;AAChF,+EAA+E;AAC/E,qDAAqD;AACrD,EAAE;AACF,gFAAgF;AAChF,kFAAkF;AAClF,gFAAgF;AAChF,yEAAyE;AACzE,oFAAoF;AACpF,EAAE;AACF,iFAAiF;AACjF,6EAA6E;AAC7E,gFAAgF;AAChF,gFAAgF;AAChF,EAAE;AACF,kFAAkF;AAClF,+EAA+E;AAC/E,6EAA6E;AAC7E,gFAAgF;AAChF,EAAE;AACF,kFAAkF;AAClF,iFAAiF;AACjF,gFAAgF;AAEhF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAa,MAAM,aAAa,CAAC;AAGjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,gCAAgC,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AA6BxE,MAAM,KAAK,GAA2B;IACpC,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,IAAI,GAAG,EAAE;IAChB,UAAU,EAAE,IAAI,GAAG,EAAE;IACrB,MAAM,EAAE;QACN,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,KAAK,EAAE,CAAC;QACR,WAAW,EAAE,CAAC;QACd,iBAAiB,EAAE,CAAC;QACpB,cAAc,EAAE,CAAC;QACjB,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,CAAC;QACT,cAAc,EAAE,CAAC;QACjB,sBAAsB,EAAE,CAAC;KAC1B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAI9C;IACC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACzC,IAAI,CAAC;QACH,gCAAgC,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAEjD,gEAAgE;QAChE,+EAA+E;QAC/E,8EAA8E;QAC9E,gFAAgF;QAChF,0EAA0E;QAC1E,wEAAwE;QACxE,IAAI,UAAU,GAAoB,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,UAAU,GAAG,qBAAqB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CACV,sCAAuC,GAAa,CAAC,OAAO,4CAA4C,CACzG,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7D,iFAAiF;YACjF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,GAAG,CAC5B,qBAAqB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAChD,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5D,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC5C,2EAA2E;QAC3E,oEAAoE;QACpE,MAAM,OAAO,GAAG,CAAC,EAAU,EAAiB,EAAE;YAC5C,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,OAAO,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,OAAO,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;gBAAE,OAAO,OAAO,CAAC;YACtD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,GAAG,EAAgB,CAAC;QAC3C,6EAA6E;QAC7E,gCAAgC;QAChC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAmB,CAAC;QAChD,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAuB,CAAC;QAC7D,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAC1B,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;QAE9C,mEAAmE;QACnE,6EAA6E;QAC7E,8DAA8D;QAC9D,MAAM,WAAW,GAAG,IAAI,GAAG,EAAgD,CAAC;QAC5E,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,sBAAsB,GAAG,CAAC,CAAC;QAE/B,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,MAAM,GAAG,GAAqB;gBAC5B,OAAO;gBACP,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,KAAK;gBACL,KAAK;gBACL,OAAO,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE;aACtC,CAAC;YAEF,yEAAyE;YACzE,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;gBAC3B,IAAI,OAAO,GAAG,EAA0E,CAAC;gBACzF,IAAI,CAAC;oBACH,OAAO,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;gBAC9C,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,CACV,0BAA0B,KAAK,CAAC,OAAO,4BAA6B,GAAa,CAAC,OAAO,wBAAwB,CAClH,CAAC;oBACF,OAAO,GAAG,EAAE,CAAC;gBACf,CAAC;gBACD,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;oBACzB,QAAQ,EAAE,CAAC;oBACX,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;oBAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;oBAC/B,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;wBACjB,iBAAiB,EAAE,CAAC;wBACpB,IAAI,CAAC,GAAG;4BAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;wBAC7C,IAAI,CAAC,GAAG;4BAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;wBAC7C,SAAS;oBACX,CAAC;oBACD,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;wBAChB,iEAAiE;wBACjE,iEAAiE;wBACjE,4CAA4C;wBAC5C,WAAW,EAAE,CAAC;wBACd,SAAS;oBACX,CAAC;oBACD,IAAI,IAAI,CAAC;oBACT,IAAI,CAAC;wBACH,IAAI,GAAG,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;oBAChC,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,+DAA+D;wBAC/D,oDAAoD;wBACpD,cAAc,EAAE,CAAC;wBACjB,OAAO,CAAC,IAAI,CAAC,0BAA0B,KAAK,CAAC,OAAO,aAAc,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;wBAC3F,SAAS;oBACX,CAAC;oBACD,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;oBACpC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBACzB,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC9E,CAAC;gBACH,CAAC;YACH,CAAC;YAED,yEAAyE;YACzE,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACrB,IAAI,IAAI,GAAG,IAAI,GAAG,EAAmB,CAAC;gBACtC,IAAI,CAAC;oBACH,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBACrC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,CACV,0BAA0B,KAAK,CAAC,OAAO,sBAAuB,GAAa,CAAC,OAAO,wBAAwB,CAC5G,CAAC;oBACF,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;gBACnB,CAAC;gBACD,KAAK,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;oBACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;oBACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;wBACd,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;wBAClC,SAAS;oBACX,CAAC;oBACD,IAAI,IAAI,GAAG,qBAAqB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;wBACV,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;wBACjB,qBAAqB,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;oBAC5C,CAAC;oBACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBACnB,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACvC,IAAI,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC;wBAAE,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;gBAC5E,CAAC;YACH,CAAC;YAED,+DAA+D;YAC/D,0EAA0E;YAC1E,0EAA0E;YAC1E,yEAAyE;YACzE,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;gBAC1B,IAAI,KAAK,CAAC;gBACV,IAAI,CAAC;oBACH,KAAK,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;gBAC3C,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,CACV,0BAA0B,KAAK,CAAC,OAAO,2BAA4B,GAAa,CAAC,OAAO,yBAAyB,CAClH,CAAC;oBACF,KAAK,GAAG,SAAS,CAAC;gBACpB,CAAC;gBACD,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;oBACxC,SAAS,EAAE,CAAC;oBACZ,uEAAuE;oBACvE,gEAAgE;oBAChE,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;oBAC3C,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACtC,IAAI,QAAQ;wBAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;;wBACjD,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACjF,CAAC;YACH,CAAC;QACH,CAAC;QAED,kEAAkE;QAClE,2EAA2E;QAC3E,yEAAyE;QACzE,6EAA6E;QAC7E,oDAAoD;QACpD,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,QAAQ,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YAC/B,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACjB,iBAAiB,EAAE,CAAC;gBACpB,IAAI,CAAC,GAAG;oBAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;gBAC7C,IAAI,CAAC,GAAG;oBAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;gBAC7C,SAAS;YACX,CAAC;YACD,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;gBAChB,WAAW,EAAE,CAAC;gBACd,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC;YACT,IAAI,CAAC;gBACH,IAAI,GAAG,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YAChC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,cAAc,EAAE,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,mCAAoC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC1E,SAAS;YACX,CAAC;YACD,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YACpC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,sBAAsB,UAAU,CAAC,MAAM,2CAA2C,CAAC,CAAC;QAClG,CAAC;QAED,kEAAkE;QAClE,8EAA8E;QAC9E,yEAAyE;QACzE,6EAA6E;QAC7E,6EAA6E;QAC7E,yEAAyE;QACzE,mDAAmD;QACnD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyC,CAAC;QACpE,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAClE,2EAA2E;YAC3E,MAAM,MAAM,GAAG,IAAI,GAAG,EAA+B,CAAC;YACtD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;YAC7C,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAU,CAAC;YAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC;gBACvC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;gBACjC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oBACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;oBACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC5D,sEAAsE;oBACtE,uEAAuE;oBACvE,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC3E,sBAAsB,EAAE,CAAC;wBACzB,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;wBACjC,SAAS;oBACX,CAAC;oBACD,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACjC,IAAI,CAAC,KAAK,EAAE,CAAC;wBACX,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;wBAClB,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;oBAC9B,CAAC;oBACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;YAED,iEAAiE;YACjE,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;gBACjD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;gBACpC,IAAI,MAAM,GAAG,EAAE,CAAC;gBAChB,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC;gBACrB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;oBACjC,IAAI,KAAK,GAAG,WAAW,IAAI,CAAC,KAAK,KAAK,WAAW,IAAI,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC;wBACnE,MAAM,GAAG,GAAG,CAAC;wBACb,WAAW,GAAG,KAAK,CAAC;oBACtB,CAAC;gBACH,CAAC;gBACD,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;oBACnB,MAAM,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAChF,OAAO,CAAC,GAAG,CAAC,yBAAyB,QAAQ,gBAAgB,KAAK,CAAC,IAAI,YAAY,GAAG,aAAa,MAAM,GAAG,CAAC,CAAC;gBAChH,CAAC;gBACD,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;gBACtC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC;gBAC/C,sDAAsD;gBACtD,wEAAwE;gBACxE,4CAA4C;gBAC5C,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC;gBACvB,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC;gBACxB,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC;gBAC5B,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,CAAC;YAED,qEAAqE;YACrE,mEAAmE;YACnE,IAAI,oBAAoB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBAClC,MAAM,MAAM,GAAG,CAAC,GAAG,oBAAoB,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC7D,OAAO,CAAC,GAAG,CACT,iBAAiB,oBAAoB,CAAC,IAAI,wEAAwE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBACnI,CAAC,oBAAoB,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAC1D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,wEAAwE;QACxE,IAAI,mBAAmB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,CAAC,GAAG,mBAAmB,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5D,OAAO,CAAC,GAAG,CACT,iBAAiB,mBAAmB,CAAC,IAAI,sDAAsD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBAChH,CAAC,mBAAmB,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CACzD,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,qBAAqB,EAAE,CAAC;YACpD,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACjB,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;gBAChD,OAAO,CAAC,GAAG,CACT,yBAAyB,QAAQ,SAAS,GAAG,CAAC,IAAI,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,MAAM,GAAG,CAC9G,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CACT,8BAA8B,KAAK,CAAC,MAAM,UAAU;YAClD,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,WAAW,yBAAyB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,CAAC,iBAAiB,CAAC,CAAC,CAAC,MAAM,iBAAiB,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,cAAc,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,MAAM,YAAY,CAAC,IAAI,UAAU;YACjC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,6BAA6B,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CACpJ,CAAC;QAEF,OAAO;YACL,KAAK;YACL,KAAK,EAAE,YAAY;YACnB,UAAU;YACV,MAAM,EAAE;gBACN,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM;gBACjC,QAAQ;gBACR,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,WAAW;gBACX,iBAAiB;gBACjB,cAAc;gBACd,KAAK,EAAE,YAAY,CAAC,IAAI;gBACxB,MAAM,EAAE,SAAS;gBACjB,cAAc,EAAE,UAAU,CAAC,IAAI;gBAC/B,sBAAsB;aACvB;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CACV,sCAAuC,GAAa,CAAC,OAAO,8CAA8C,CAC3G,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,yCAAyC;AACzC,SAAS,KAAK,CAAC,QAAiB,EAAE,SAAkB;IAClD,MAAM,CAAC,GAAG,QAAQ,CAAC,QAAQ,IAAI,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,SAAS,CAAC,QAAQ,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,QAAQ,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;AACxC,CAAC"}

package/dist/framework/detect-step.d.ts

@@ -0,0 +1,8 @@
+import type { FrameworkManifest } from './types.js';
+/**
+ * Register the builtin framework adapters, detect the repo's stack, log the
+ * manifest, and return it. Cheap + deterministic; safe to call once per ingest
+ * before extraction.
+ */
+export declare function detectFrameworkStack(repoDir: string): Promise<FrameworkManifest>;
+//# sourceMappingURL=detect-step.d.ts.map

package/dist/framework/detect-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-step.d.ts","sourceRoot":"","sources":["../../src/framework/detect-step.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkBtF"}

package/dist/framework/detect-step.js

@@ -0,0 +1,54 @@
+// the framework-detection pipeline step.
+//
+// Mirrors scripts/ingest/infra/infra-step.ts (registerBuiltins → run): a single
+// entry point both the local CLI (cli.ts) and the hosted container (container.ts)
+// call IDENTICALLY, so the two twins stay mirrored. It registers the builtin
+// adapters, runs the cheap detection gate, LOGS the detected-stack manifest, and
+// returns it.
+//
+// SLICE 1: nothing downstream consumes the manifest yet — this step only logs.
+// Generic-TS behavior is byte-for-byte unchanged when the manifest is empty (the
+// detection is read-only: package.json reads + config-file existence checks, no
+// mutation, no effect on the assembled snapshot). Adapters consume the manifest
+// starting in .
+import { registerBuiltinFrameworkAdapters } from './register.js';
+import { detectFrameworks } from './registry.js';
+/**
+ * Register the builtin framework adapters, detect the repo's stack, log the
+ * manifest, and return it. Cheap + deterministic; safe to call once per ingest
+ * before extraction.
+ */
+export async function detectFrameworkStack(repoDir) {
+    // Degrade, don't abort (mirrors extractInfra's call-site discipline in cli.ts /
+    // container.ts): framework detection is purely ADDITIVE + log-only this slice,
+    // so a throwing adapter must never sink an otherwise-good ingest. RN's detect()
+    // can't throw today (all fs reads are guarded), but the contract invites more
+    // adapters — catch here, once, so BOTH call sites inherit the guarantee and stay
+    // identical, and fall through to the empty-manifest generic-TS path on failure.
+    try {
+        registerBuiltinFrameworkAdapters();
+        const manifest = await detectFrameworks(repoDir);
+        logManifest(manifest);
+        return manifest;
+    }
+    catch (err) {
+        console.warn(`  ⚠ framework detection failed (${err.message}) — continuing without a framework manifest`);
+        return { root: repoDir, matches: [] };
+    }
+}
+// No silent caps ( constraint 7): log exactly what's detected (or the
+// empty fallthrough), with each adapter's variant, root, and confidence.
+function logManifest(manifest) {
+    if (manifest.matches.length === 0) {
+        console.log('→ framework detection: none — generic TS fallthrough');
+        return;
+    }
+    const summary = manifest.matches
+        .map((m) => {
+        const variant = typeof m.metadata?.variant === 'string' ? ` (${m.metadata.variant})` : '';
+        return `${m.adapter}${variant} @ ${m.rootPath || '.'} · conf ${m.confidence.toFixed(2)}`;
+    })
+        .join(', ');
+    console.log(`→ framework detection: ${manifest.matches.length} stack(s) — ${summary}`);
+}
+//# sourceMappingURL=detect-step.js.map

package/dist/framework/detect-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-step.js","sourceRoot":"","sources":["../../src/framework/detect-step.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,gFAAgF;AAChF,kFAAkF;AAClF,6EAA6E;AAC7E,iFAAiF;AACjF,cAAc;AACd,EAAE;AACF,+EAA+E;AAC/E,iFAAiF;AACjF,gFAAgF;AAChF,gFAAgF;AAChF,gBAAgB;AAEhB,OAAO,EAAE,gCAAgC,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAe;IACxD,gFAAgF;IAChF,+EAA+E;IAC/E,gFAAgF;IAChF,8EAA8E;IAC9E,iFAAiF;IACjF,gFAAgF;IAChF,IAAI,CAAC;QACH,gCAAgC,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACjD,WAAW,CAAC,QAAQ,CAAC,CAAC;QACtB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CACV,mCAAoC,GAAa,CAAC,OAAO,6CAA6C,CACvG,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACxC,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,yEAAyE;AACzE,SAAS,WAAW,CAAC,QAA2B;IAC9C,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;QACpE,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO;SAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,QAAQ,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1F,OAAO,GAAG,CAAC,CAAC,OAAO,GAAG,OAAO,MAAM,CAAC,CAAC,QAAQ,IAAI,GAAG,WAAW,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3F,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,0BAA0B,QAAQ,CAAC,OAAO,CAAC,MAAM,eAAe,OAAO,EAAE,CAAC,CAAC;AACzF,CAAC"}

package/dist/framework/detect-util.d.ts

@@ -0,0 +1,24 @@
+import type { FrameworkDetectContext } from './types.js';
+/**
+ * The merged dependency map from a package.json (`dependencies` +
+ * `devDependencies`); `{}` on any read/parse error. Deterministic — no source,
+ * no install, just the manifest.
+ */
+export declare function readDeps(baseDir: string): Record<string, string>;
+/** True if any of `names` exists as a file/dir directly under `baseDir`. */
+export declare function existsAny(baseDir: string, names: readonly string[]): boolean;
+/** True if `rel` is an existing directory under `baseDir`. */
+export declare function isDir(baseDir: string, rel: string): boolean;
+/**
+ * Resolve the base dir + repo-relative posix rootPath a detect pass should scan.
+ * Mirrors the RN adapter: a workspace `packageDir` (the per-package fan-out shape,
+ * ) scopes the scan + reports its repo-relative path; absent ⇒ the repo
+ * root (`''`). Path is posix-normalized so manifests are stable cross-platform.
+ */
+export declare function resolveBase(ctx: FrameworkDetectContext): {
+    base: string;
+    rootPath: string;
+};
+/** Clamp a raw confidence sum into the [0,1] DetectMatch range, 2-dp stable. */
+export declare function clampConfidence(raw: number): number;
+//# sourceMappingURL=detect-util.d.ts.map

package/dist/framework/detect-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-util.d.ts","sourceRoot":"","sources":["../../src/framework/detect-util.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUhE;AAED,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAE5E;AAED,8DAA8D;AAC9D,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAM3D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,sBAAsB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAQ3F;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/framework/detect-util.js

@@ -0,0 +1,59 @@
+// (Slice 2) — shared detection helpers for the manifest+config-existence
+// adapters (Next / Nest / Node / ORM).
+//
+// Every Slice-2 adapter keeps the SAME pure-builder / fs-adapter split the React
+// Native adapter established: a thin fs layer (gather*Signals) reads package.json
+// deps + config-file EXISTENCE only — never source content (never-store-source) —
+// and a PURE scorer (score*) turns the deterministic signal set into a DetectMatch
+// (or null = no match = generic-TS fallthrough). These helpers are the bits the
+// four adapters would otherwise duplicate verbatim, factored once. (The RN adapter
+// predates this and inlines its own copies — intentionally left untouched.)
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+/**
+ * The merged dependency map from a package.json (`dependencies` +
+ * `devDependencies`); `{}` on any read/parse error. Deterministic — no source,
+ * no install, just the manifest.
+ */
+export function readDeps(baseDir) {
+    try {
+        const pkg = JSON.parse(readFileSync(join(baseDir, 'package.json'), 'utf8'));
+        return { ...(pkg.dependencies ?? {}), ...(pkg.devDependencies ?? {}) };
+    }
+    catch {
+        return {};
+    }
+}
+/** True if any of `names` exists as a file/dir directly under `baseDir`. */
+export function existsAny(baseDir, names) {
+    return names.some((n) => existsSync(join(baseDir, n)));
+}
+/** True if `rel` is an existing directory under `baseDir`. */
+export function isDir(baseDir, rel) {
+    try {
+        return statSync(join(baseDir, rel)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve the base dir + repo-relative posix rootPath a detect pass should scan.
+ * Mirrors the RN adapter: a workspace `packageDir` (the per-package fan-out shape,
+ * ) scopes the scan + reports its repo-relative path; absent ⇒ the repo
+ * root (`''`). Path is posix-normalized so manifests are stable cross-platform.
+ */
+export function resolveBase(ctx) {
+    if (ctx.packageDir) {
+        return {
+            base: ctx.packageDir,
+            rootPath: relative(ctx.repoDir, ctx.packageDir).split('\\').join('/'),
+        };
+    }
+    return { base: ctx.repoDir, rootPath: '' };
+}
+/** Clamp a raw confidence sum into the [0,1] DetectMatch range, 2-dp stable. */
+export function clampConfidence(raw) {
+    return Math.min(1, Math.max(0, Number(raw.toFixed(2))));
+}
+//# sourceMappingURL=detect-util.js.map

package/dist/framework/detect-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-util.js","sourceRoot":"","sources":["../../src/framework/detect-util.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,uCAAuC;AACvC,EAAE;AACF,iFAAiF;AACjF,kFAAkF;AAClF,kFAAkF;AAClF,mFAAmF;AACnF,gFAAgF;AAChF,mFAAmF;AACnF,4EAA4E;AAE5E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG3C;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAGzE,CAAC;QACF,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,KAAwB;IACjE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,KAAK,CAAC,OAAe,EAAE,GAAW;IAChD,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,GAA2B;IACrD,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QACnB,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,UAAU;YACpB,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;SACtE,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAC7C,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/framework/django/django.d.ts

@@ -0,0 +1,22 @@
+import type { DetectMatch, FrameworkAdapter } from '../types.js';
+/** The deterministic Django signal set (dependency names + file existence). */
+export interface DjangoSignals {
+    hasDjango: boolean;
+    hasDrf: boolean;
+    hasNinja: boolean;
+    hasManagePy: boolean;
+    hasSettings: boolean;
+}
+/** Gather the signal set for a single root dir (reads manifests + file existence). */
+export declare function gatherDjangoSignals(baseDir: string): DjangoSignals;
+/**
+ * Decide Django from the signal set. `django` (dep) is the authoritative signal;
+ * absent it, a `manage.py` + a settings module is Django-unique enough to claim at
+ * lower confidence. DRF / Ninja only ride in metadata (they enable their passes,
+ * they don't decide the stack). Returns null → generic-Python fallthrough,
+ * byte-for-byte unchanged.
+ */
+export declare function scoreDjango(s: DjangoSignals, rootPath?: string): DetectMatch | null;
+export type DjangoRole = 'view' | 'command' | 'model' | 'app-config';
+export declare const djangoAdapter: FrameworkAdapter;
+//# sourceMappingURL=django.d.ts.map

package/dist/framework/django/django.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"django.d.ts","sourceRoot":"","sources":["../../../src/framework/django/django.ts"],"names":[],"mappings":"AAsEA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAOjB,MAAM,aAAa,CAAC;AAMrB,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAoFD,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CASlE;AA6BD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,aAAa,EAAE,QAAQ,SAAK,GAAG,WAAW,GAAG,IAAI,CA6B/E;AAQD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,CAAC;AA+uBrE,eAAO,MAAM,aAAa,EAAE,gBA8C3B,CAAC"}