@backthread/extractor 0.1.0

package/dist/framework/celery/celery.js

@@ -0,0 +1,524 @@
+// the Celery FrameworkAdapter. Extracted from the FastAPI adapter's
+// gated Celery pass into a DEDICATED, standalone adapter that fires for
+// ANY Celery repo (not only FastAPI + Celery), and DEEPENED: Celery Beat periodic
+// schedules and `chain`/`group`/`chord` canvas composition.
+//
+// Celery declares its background-task surface with decorators + a broker config,
+// which we read STATICALLY (install-free, never-store-source — a pure syntactic
+// Pyright parse via the shared Python core; never executes repo code), and persist
+// only the derived edges/roles:
+//
+//   * detect()        — the `celery` dependency (a `celery-*` / `django-celery-*`
+//                       / `flower` extension raises confidence); shallow nested
+//                       scan for a `backend/`|`worker/`|`server/` package (mirrors
+//                       FastAPI's ).
+//   * roleTags        — a Celery TASK (`@shared_task`, `@app.task`/`@celery_app.task`
+//                       incl. an imported Celery app cross-file) → `task`; a Beat
+//                       PERIODIC task (`@periodic_task`, or a task referenced by a
+//                       `beat_schedule` config entry) → `scheduled-task`. Both map
+//                       onto the LOCKED `job` MODULE_KIND (own-code triggered by a
+//                       queue / schedule, not a request); never a new kind — only
+//                       `role` renders.
+//   * syntheticEdges  — the async wiring the import graph would render as a plain
+//                       call or miss entirely: `.delay()`/`.apply_async()`/`.s()`/
+//                       `.si()` enqueue (kind 'publishes'); `chain(a.s(), b.s())`
+//                       sequential composition → task→task 'publishes'; `chord`
+//                       header→callback 'publishes'; and a `beat_schedule` entry →
+//                       its scheduled task (kind 'publishes', relation 'beat-schedule').
+//
+// The adapter is IMPORT-GATED (`@shared_task`/`chain`/`group`/`chord`/`Celery`
+// are only honored when imported from a `celery` module in that file), so an
+// unrelated `itertools.chain(...)` or a foreign `@task` never produces a false
+// edge/role. Unresolvable enqueue / composition / schedule targets DEGRADE + LOG —
+// no silent caps.
+//
+// NOTE: Grouping is intentionally NOT contributed — Celery has no per-domain
+// structural unit like a FastAPI router / Flask blueprint; task files stay in the
+// host framework's / directory grouping. This matches the  behavior the
+// adapter extracts (roles + edges only).
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { clampConfidence, resolveBase } from '../detect-util.js';
+import { readPythonDeps } from '../../graph/python-manifest.js';
+import { syntacticResolve } from '../../graph/python-adapter.js';
+import { parsePythonScope } from '../python/analyze.js';
+import { callCallee, dictEntries, keywordArg, memberChain, nameValue, positionalArgs, stringValue, PN, } from '../python/py-ast.js';
+/** Gather the signal set for a single root dir (reads manifests only). */
+export function gatherCelerySignals(baseDir) {
+    const deps = readPythonDeps(baseDir);
+    return {
+        hasCelery: deps.has('celery'),
+        // A Beat/monitoring extension is a strong secondary signal this really is a
+        // Celery deployment (vs. `celery` pulled in transitively).
+        hasCeleryExtension: [...deps].some((d) => d === 'flower' || d.startsWith('celery-') || d.startsWith('django-celery')),
+    };
+}
+// Non-source dirs the nested scan skips (cheap + can't hold a first-party manifest).
+const NESTED_SKIP_DIRS = new Set([
+    'node_modules',
+    'dist',
+    'build',
+    'out',
+    'coverage',
+    'venv',
+    '.venv',
+    '__pycache__',
+    'site-packages',
+]);
+/** True if `dir` holds a Python manifest worth scanning for deps. */
+function hasPythonManifest(dir) {
+    return (existsSync(join(dir, 'pyproject.toml')) ||
+        existsSync(join(dir, 'setup.py')) ||
+        existsSync(join(dir, 'setup.cfg')) ||
+        existsSync(join(dir, 'requirements.txt')));
+}
+/**
+ * Immediate subdirs (depth 1) that contain a Python manifest — the shallow search
+ * for a nested Celery worker (`backend/` | `worker/` | `server/`). Sorted, so the
+ * first-match pick is deterministic; skips dot-dirs + non-source dirs to stay cheap.
+ */
+function shallowManifestSubdirs(base) {
+    let entries;
+    try {
+        entries = readdirSync(base, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const e of entries) {
+        if (!e.isDirectory() || e.name.startsWith('.') || NESTED_SKIP_DIRS.has(e.name))
+            continue;
+        if (hasPythonManifest(join(base, e.name)))
+            out.push(e.name);
+    }
+    return out.sort();
+}
+/**
+ * Decide Celery from the signal set. `celery` is REQUIRED; a Beat/monitoring
+ * extension raises confidence. Returns null → generic-Python fallthrough,
+ * byte-for-byte unchanged.
+ */
+export function scoreCelery(s, rootPath = '') {
+    if (!s.hasCelery)
+        return null;
+    let confidence = 0.8;
+    if (s.hasCeleryExtension)
+        confidence += 0.1;
+    return {
+        adapter: 'celery',
+        confidence: clampConfidence(confidence),
+        rootPath,
+        metadata: {
+            signals: { celery: s.hasCelery, celeryExtension: s.hasCeleryExtension },
+        },
+    };
+}
+const ROLE_PRIORITY = {
+    'scheduled-task': 6,
+    task: 5,
+};
+const ROLE_KIND = {
+    'scheduled-task': 'job',
+    task: 'job',
+};
+// Celery enqueue methods: `.delay()` / `.apply_async()` (immediate) + `.s()` /
+// `.si()` (signature / immutable-signature — a task reference wired into a canvas).
+const ENQUEUE_METHODS = new Set(['delay', 'apply_async', 's', 'si']);
+// Celery canvas composition primitives (imported from `celery`).
+const COMPOSITION_NAMES = new Set(['chain', 'group', 'chord']);
+// The `celery`-origin symbols this adapter honors — import-gated, so a foreign
+// `@task` / `itertools.chain` never fires. `task` covers the legacy bare
+// `from celery import task` decorator; `Celery` covers an aliased app import.
+const CELERY_SYMBOLS = new Set([
+    'shared_task',
+    'task',
+    'periodic_task',
+    'chain',
+    'group',
+    'chord',
+    'Celery',
+]);
+// Names a `beat_schedule` config binds to (module-level or `app.conf.<name>`).
+const BEAT_SCHEDULE_NAMES = new Set(['beat_schedule', 'CELERYBEAT_SCHEDULE', 'CELERY_BEAT_SCHEDULE']);
+// Memoized on the FrameworkContext OBJECT (not repoDir) so syntheticEdges +
+// roleTags share ONE parse, while the merge walk's per-checkpoint ctx gets a fresh
+// analysis — no cross-tree staleness. Mirrors fastapi / flask / nest.
+const ANALYSIS_CACHE = new WeakMap();
+function addRole(map, fileId, role) {
+    const cur = map.get(fileId);
+    if (cur === undefined ||
+        ROLE_PRIORITY[role] > ROLE_PRIORITY[cur] ||
+        (ROLE_PRIORITY[role] === ROLE_PRIORITY[cur] && role < cur)) {
+        map.set(fileId, role);
+    }
+}
+function addEdge(edges, from, to, kind, relation) {
+    if (from === to)
+        return; // self-references collapse; the contribute-step drops self-edges too
+    const key = `${from}→${to}:${kind}`;
+    if (!edges.has(key)) {
+        edges.set(key, { source: from, target: to, kind, metadata: { framework: 'celery', relation } });
+    }
+}
+// The constructor name of an `x = Ctor(...)` assignment RHS (last chain segment,
+// so both `Celery(...)` and `celery.Celery(...)` read as 'Celery'), or undefined.
+function assignedCtorName(rhs) {
+    if (rhs.nodeType !== PN.Call)
+        return undefined;
+    const callee = callCallee(rhs);
+    if (!callee)
+        return undefined;
+    return callee.path.length ? callee.path[callee.path.length - 1] : callee.root;
+}
+// A decorator's callee chain (`@app.task(...)` → root 'app', path ['task'];
+// `@shared_task` → root 'shared_task', path []). The decorator expr is either a
+// call (with args) or a bare name/attribute.
+function decoratorChain(deco) {
+    const expr = deco.d.expr;
+    if (expr.nodeType === PN.Call)
+        return callCallee(expr);
+    return memberChain(expr);
+}
+// The final segment of an assignment LHS (`beat_schedule` → 'beat_schedule';
+// `app.conf.beat_schedule` → 'beat_schedule'), or undefined for a non-name LHS.
+function assignmentTargetName(leftExpr) {
+    const chain = memberChain(leftExpr);
+    if (!chain)
+        return undefined;
+    return chain.path.length ? chain.path[chain.path.length - 1] : chain.root;
+}
+/**
+ * Per-file `localName → canonical celery symbol` map for `from celery(.*) import X`
+ * (`from celery import shared_task, chain` / `from celery.decorators import
+ * periodic_task` / `from celery import Celery as C`). Import-gating: a symbol is
+ * only honored when it genuinely came from a `celery` module in THIS file.
+ */
+function celeryImportNames(imports) {
+    const out = new Map();
+    for (const imp of imports) {
+        if (imp.nodeType !== PN.ImportFrom)
+            continue;
+        const from = imp;
+        if (from.d.module.d.leadingDots !== 0)
+            continue; // celery is an absolute import
+        const parts = from.d.module.d.nameParts.map((p) => p.d.value);
+        if (parts[0] !== 'celery')
+            continue; // celery / celery.canvas / celery.schedules / …
+        for (const spec of from.d.imports) {
+            const imported = spec.d.name.d.value;
+            const local = spec.d.alias ? spec.d.alias.d.value : imported;
+            if (CELERY_SYMBOLS.has(imported))
+                out.set(local, imported);
+        }
+    }
+    return out;
+}
+function analyzeCelery(ctx) {
+    const { parsed, internalIds, roots } = parsePythonScope(ctx);
+    // Pass 1 — per-file celery `import` gates + Celery() app object variables
+    // (file-scoped, matching how these module-level singletons are used).
+    const celeryImportsByFile = new Map();
+    const celeryVarsByFile = new Map();
+    for (const [id, file] of parsed) {
+        const celeryImports = celeryImportNames(file.nodes.imports);
+        celeryImportsByFile.set(id, celeryImports);
+        const celeryVars = new Set();
+        for (const a of file.nodes.assignments) {
+            const target = nameValue(a.d.leftExpr);
+            if (!target)
+                continue;
+            const ctor = assignedCtorName(a.d.rightExpr);
+            // Direct `Celery(...)` or an aliased-import `C(...)` where `C` came from celery.
+            if (ctor && (ctor === 'Celery' || celeryImports.get(ctor) === 'Celery'))
+                celeryVars.add(target);
+        }
+        celeryVarsByFile.set(id, celeryVars);
+    }
+    // Files that construct a Celery() app — so a `@<imported_app>.task` in ANOTHER
+    // file (the common `from proj.celery import app` + `@app.task` layout) is
+    // recognized as a task, not just a same-file `@celery_app.task`.
+    const celeryAppFiles = new Set();
+    for (const [f, vars] of celeryVarsByFile)
+        if (vars.size > 0)
+            celeryAppFiles.add(f);
+    const roleByFile = new Map();
+    const edges = new Map();
+    const diag = {
+        unresolvedEnqueues: new Set(),
+        unresolvedComposition: new Set(),
+        unresolvedSchedules: new Set(),
+    };
+    // Resolve a canvas member expression to its task file id:
+    //   `task.s(...)` / `task.si(...)` → the `task` root (path ['s'|'si'])
+    //   `task` (bare Name)             → the imported task
+    // Deeper chains (`mod.task.s()`) degrade to undefined. Same-file tasks resolve
+    // to `thisFile` (a self-edge, dropped by addEdge) via a local-def fallback.
+    function resolveCanvasTask(expr, thisFile, binds, localDefs) {
+        if (!expr)
+            return undefined;
+        let root;
+        if (expr.nodeType === PN.Call) {
+            const callee = callCallee(expr);
+            if (callee && callee.path.length === 1 && (callee.path[0] === 's' || callee.path[0] === 'si')) {
+                root = callee.root;
+            }
+        }
+        else {
+            const chain = memberChain(expr);
+            if (chain && chain.path.length === 0)
+                root = chain.root;
+        }
+        if (root === undefined)
+            return undefined;
+        return binds.get(root) ?? (localDefs.has(root) ? thisFile : undefined);
+    }
+    // The header tasks of a `chord(header, callback)`: a `group(...)` call's args,
+    // a list literal's items, or a single task. The `group` is import-gated
+    // (canonical), so an aliased `group as g` header still resolves.
+    function resolveChordHeader(header, thisFile, binds, localDefs, celeryImports) {
+        if (!header)
+            return [];
+        if (header.nodeType === PN.Call) {
+            const callee = callCallee(header);
+            if (callee && callee.path.length === 0 && celeryImports.get(callee.root) === 'group') {
+                return positionalArgs(header).map((m) => resolveCanvasTask(m, thisFile, binds, localDefs));
+            }
+        }
+        if (header.nodeType === PN.List) {
+            return header.d.items.map((m) => resolveCanvasTask(m, thisFile, binds, localDefs));
+        }
+        return [resolveCanvasTask(header, thisFile, binds, localDefs)];
+    }
+    // Read a `beat_schedule = { name: { 'task': 'dotted.path', … }, … }` config,
+    // resolve each entry's task to a file, tag it `scheduled-task`, and add a
+    // config→task 'publishes' edge (relation 'beat-schedule').
+    function readBeatSchedule(scheduleExpr, configFile, binds) {
+        for (const entry of dictEntries(scheduleExpr)) {
+            const spec = entry.valueExpr; // the per-entry `{ 'task': …, 'schedule': … }` dict
+            const taskExpr = dictEntries(spec).find((e) => stringValue(e.keyExpr) === 'task')?.valueExpr;
+            if (!taskExpr)
+                continue;
+            const target = resolveBeatTask(taskExpr, configFile, binds);
+            if (target) {
+                addRole(roleByFile, target, 'scheduled-task');
+                addEdge(edges, configFile, target, 'publishes', 'beat-schedule');
+            }
+            else {
+                const label = stringValue(taskExpr) ?? nameValue(taskExpr) ?? '<expr>';
+                diag.unresolvedSchedules.add(`${configFile}: beat_schedule task ${label}`);
+            }
+        }
+    }
+    // Resolve a beat entry's `'task'` value to a file id: a dotted string
+    // (`'app.workers.tasks.add'` → its module `app.workers.tasks`) or a bare
+    // task reference resolved through the file's import bindings.
+    function resolveBeatTask(taskExpr, fromFile, binds) {
+        const dotted = stringValue(taskExpr);
+        if (dotted) {
+            const segs = dotted.split('.');
+            if (segs.length < 2)
+                return undefined; // need module.function
+            const modulePath = segs.slice(0, -1).join('.');
+            return syntacticResolve(modulePath, fromFile, internalIds, roots);
+        }
+        const chain = memberChain(taskExpr);
+        return chain ? binds.get(chain.root) : undefined;
+    }
+    for (const [id, file] of parsed) {
+        const celeryImports = celeryImportsByFile.get(id);
+        const celeryVars = celeryVarsByFile.get(id);
+        const binds = file.bindings;
+        const localDefs = new Set();
+        for (const fn of file.nodes.functions) {
+            const n = nameValue(fn.d.name);
+            if (n)
+                localDefs.add(n);
+        }
+        // Task + periodic decorators.
+        for (const fn of file.nodes.functions) {
+            for (const deco of fn.d.decorators) {
+                const chain = decoratorChain(deco);
+                if (!chain)
+                    continue;
+                if (chain.path.length === 0) {
+                    // Bare `@shared_task` / `@task` / `@periodic_task` — import-gated to celery.
+                    const canonical = celeryImports.get(chain.root);
+                    if (canonical === 'periodic_task')
+                        addRole(roleByFile, id, 'scheduled-task');
+                    else if (canonical === 'shared_task' || canonical === 'task')
+                        addRole(roleByFile, id, 'task');
+                }
+                else if (chain.path.length === 1 && chain.path[0] === 'task') {
+                    // `@<celeryapp>.task` — the app is defined here OR imported from a file
+                    // that constructs a Celery() app.
+                    const importedApp = binds.get(chain.root);
+                    if (celeryVars.has(chain.root) || (importedApp !== undefined && celeryAppFiles.has(importedApp))) {
+                        addRole(roleByFile, id, 'task');
+                    }
+                }
+            }
+        }
+        // Enqueue + canvas-composition + beat-config-update edges.
+        for (const call of file.nodes.calls) {
+            const callee = callCallee(call);
+            if (!callee)
+                continue;
+            // A bare celery-origin composition primitive (import-gated → canonical, so an
+            // aliased `chain as c` still resolves; a foreign `itertools.chain` yields
+            // undefined and is skipped). `group(...)` maps here too but emits no
+            // task→task edge (its members run in parallel).
+            const compositionSym = callee.path.length === 0 ? celeryImports.get(callee.root) : undefined;
+            if (callee.path.length === 1 && ENQUEUE_METHODS.has(callee.path[0])) {
+                // `sometask.delay(...)` / `.apply_async()` / `.s()` / `.si()` — the callee
+                // root is the imported task function; a same-file task is a self-edge.
+                const obj = callee.root;
+                const target = binds.get(obj) ?? (localDefs.has(obj) ? id : undefined);
+                if (target)
+                    addEdge(edges, id, target, 'publishes', 'celery-enqueue');
+                else
+                    diag.unresolvedEnqueues.add(`${id}: ${obj}.${callee.path[0]}(…)`);
+            }
+            else if (compositionSym && COMPOSITION_NAMES.has(compositionSym)) {
+                const args = positionalArgs(call);
+                if (compositionSym === 'chain') {
+                    // Sequential pipe: consecutive resolvable members → task→task publishes.
+                    // Log each unresolved member once (at its own index), then link the
+                    // resolved consecutive pairs (never bridging across an unknown).
+                    const resolved = args.map((m) => resolveCanvasTask(m, id, binds, localDefs));
+                    resolved.forEach((r, idx) => {
+                        if (!r)
+                            diag.unresolvedComposition.add(`${id}: chain(…) member ${idx} unresolved`);
+                    });
+                    for (let i = 0; i < resolved.length - 1; i++) {
+                        const a = resolved[i];
+                        const b = resolved[i + 1];
+                        if (a && b)
+                            addEdge(edges, a, b, 'publishes', 'chain');
+                    }
+                }
+                else if (compositionSym === 'chord') {
+                    // header (a group / list / single) → callback.
+                    const callback = keywordArg(call, 'body') ?? args[1];
+                    const cbFile = resolveCanvasTask(callback, id, binds, localDefs);
+                    const header = resolveChordHeader(args[0], id, binds, localDefs, celeryImports);
+                    if (cbFile) {
+                        for (const ht of header) {
+                            if (ht)
+                                addEdge(edges, ht, cbFile, 'publishes', 'chord');
+                            else
+                                diag.unresolvedComposition.add(`${id}: chord(…) header member unresolved`);
+                        }
+                    }
+                    else {
+                        diag.unresolvedComposition.add(`${id}: chord(…) callback unresolved`);
+                    }
+                }
+                // `group(...)` (compositionSym === 'group') → no task→task ordering edge
+                // (each member's `.s()` is already a call-site publishes above).
+            }
+            // `app.conf.update(beat_schedule={…})` — a beat config passed as a kwarg.
+            const beatKwarg = keywordArg(call, 'beat_schedule');
+            if (beatKwarg)
+                readBeatSchedule(beatKwarg, id, binds);
+        }
+        // `beat_schedule = {…}` / `CELERY_BEAT_SCHEDULE = {…}` / `app.conf.beat_schedule = {…}`.
+        for (const a of file.nodes.assignments) {
+            const name = assignmentTargetName(a.d.leftExpr);
+            if (name && BEAT_SCHEDULE_NAMES.has(name))
+                readBeatSchedule(a.d.rightExpr, id, binds);
+        }
+    }
+    const roles = new Map();
+    for (const [fileId, role] of roleByFile) {
+        roles.set(fileId, {
+            role,
+            kind: ROLE_KIND[role],
+            priority: ROLE_PRIORITY[role],
+            metadata: { framework: 'celery' },
+        });
+    }
+    const sortedEdges = [...edges.values()].sort((a, b) => a.source < b.source
+        ? -1
+        : a.source > b.source
+            ? 1
+            : a.target < b.target
+                ? -1
+                : a.target > b.target
+                    ? 1
+                    : a.kind < b.kind
+                        ? -1
+                        : a.kind > b.kind
+                            ? 1
+                            : 0);
+    // Positive signal for validation (mirrors fastapi / flask / nest's log line).
+    if (roleByFile.size > 0 || sortedEdges.length > 0) {
+        console.log(`  [celery] ${roleByFile.size} role(s) · ${sortedEdges.length} edge(s)`);
+    }
+    // No silent caps (locked): log everything that degraded.
+    if (diag.unresolvedEnqueues.size > 0 ||
+        diag.unresolvedComposition.size > 0 ||
+        diag.unresolvedSchedules.size > 0) {
+        const parts = [];
+        if (diag.unresolvedEnqueues.size > 0) {
+            parts.push(`${diag.unresolvedEnqueues.size} unresolvable enqueue(s): ${[...diag.unresolvedEnqueues].sort().slice(0, 10).join(' · ')}`);
+        }
+        if (diag.unresolvedComposition.size > 0) {
+            parts.push(`${diag.unresolvedComposition.size} unresolvable composition(s): ${[...diag.unresolvedComposition].sort().slice(0, 10).join(' · ')}`);
+        }
+        if (diag.unresolvedSchedules.size > 0) {
+            parts.push(`${diag.unresolvedSchedules.size} unresolvable schedule(s): ${[...diag.unresolvedSchedules].sort().slice(0, 10).join(' · ')}`);
+        }
+        console.log(`  [celery] degraded: ${parts.join(' · ')} (logged, not silently dropped)`);
+    }
+    return { edges: sortedEdges, roles };
+}
+function getAnalysis(ctx) {
+    let a = ANALYSIS_CACHE.get(ctx);
+    if (!a) {
+        a = analyzeCelery(ctx);
+        ANALYSIS_CACHE.set(ctx, a);
+    }
+    return a;
+}
+// ---------------------------------------------------------------------------
+// The adapter. Roles + edges only — no groupingPrior (Celery has no per-domain
+// structural unit; task files stay in the host framework's / directory grouping).
+export const celeryAdapter = {
+    name: 'celery',
+    async detect(ctx) {
+        const { base, rootPath } = resolveBase(ctx);
+        // Root scan first (a repo whose manifest is at root reports rootPath '').
+        const rootMatch = scoreCelery(gatherCelerySignals(base), rootPath);
+        if (rootMatch)
+            return rootMatch;
+        // A Celery worker often lives one dir down (a `backend/` | `worker/` |
+        // `server/` package). Shallow-scan immediate subdirs and scope to it. Only
+        // when NOT already scoped to a workspace package (the  path).
+        if (!ctx.packageDir) {
+            for (const sub of shallowManifestSubdirs(base)) {
+                const m = scoreCelery(gatherCelerySignals(join(base, sub)), sub);
+                if (m)
+                    return m;
+            }
+        }
+        return null;
+    },
+    // `.delay`/`.apply_async`/`.s`/`.si` enqueue + chain/chord composition + beat
+    // schedule → 'publishes'. File-id endpoints; the step resolves to modules,
+    // drops self-edges, dedupes, 8-verb-validates.
+    async syntheticEdges(ctx) {
+        return getAnalysis(ctx).edges;
+    },
+    // task / scheduled-task → job. METADATA; the module's `kind` is unchanged.
+    async roleTags(ctx) {
+        return getAnalysis(ctx).roles;
+    },
+    // The hooks READ SOURCE (Python). Declare the paths the diff-driven hosted walk
+    // must treat as framework-relevant. Never-store-source holds: parse server-side,
+    // persist only the derived edges/roles.
+    scansSourcePath(path) {
+        return path.endsWith('.py') || path.endsWith('.pyi');
+    },
+};
+//# sourceMappingURL=celery.js.map

package/dist/framework/celery/celery.js.map

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

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

@@ -0,0 +1,38 @@
+import { type Edge } from '../types.js';
+import type { ClusterResult } from '../cluster/louvain.js';
+import type { NormalizedGraph } from '../graph/types.js';
+import type { RoleTag } from './types.js';
+export interface FrameworkContributions {
+    /** Module-resolved, self-edge-free, deduped, 8-verb-validated edges. */
+    edges: Edge[];
+    /** moduleId → RoleTag (collapsed to the highest-priority role per module). */
+    roles: Map<string, RoleTag>;
+    /**
+     * moduleId → the adapter-authoritative subsystem assigned to it (the
+     * namespaced group id + its label). Informational/observability: the ACTUAL
+     * effect is the in-place override of `cluster.modules[].packageId/packageName`
+     * (see below), so assemble's computeSubsystems renders the framework grouping.
+     */
+    subsystems: Map<string, {
+        id: string;
+        label: string;
+    }>;
+    counts: {
+        adapters: number;
+        rawEdges: number;
+        edges: number;
+        droppedSelf: number;
+        droppedUnresolved: number;
+        droppedBadKind: number;
+        roles: number;
+        groups: number;
+        groupedModules: number;
+        droppedGroupUnresolved: number;
+    };
+}
+export declare function contributeFrameworkGraph(args: {
+    repoDir: string;
+    graph: NormalizedGraph;
+    cluster: ClusterResult;
+}): Promise<FrameworkContributions>;
+//# sourceMappingURL=contribute-step.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contribute-step.d.ts","sourceRoot":"","sources":["../../src/framework/contribute-step.ts"],"names":[],"mappings":"AAiEA,OAAO,EAA2B,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzD,OAAO,KAAK,EAAqD,OAAO,EAAE,MAAM,YAAY,CAAC;AAE7F,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,8EAA8E;IAC9E,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5B;;;;;OAKG;IACH,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,cAAc,EAAE,MAAM,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,MAAM,CAAC;QACvB,sBAAsB,EAAE,MAAM,CAAC;KAChC,CAAC;CACH;AAoBD,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;CACxB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAsUlC"}