@backthread/extractor 0.1.0

package/dist/framework/python-orm/python-orm.d.ts

@@ -0,0 +1,19 @@
+import type { DetectMatch, FrameworkAdapter } from '../types.js';
+/** Canonical ORM families this adapter recognizes (PEP 503 normalized dep names). */
+export type PyOrm = 'sqlalchemy' | 'sqlmodel' | 'tortoise-orm' | 'beanie' | 'peewee';
+/** The deterministic Python-ORM signal set (declared dependency names only). */
+export interface PyOrmSignals {
+    /** Detected ORM families, in ORM_ORDER. */
+    orms: PyOrm[];
+}
+/** Gather the signal set for a single root dir (reads manifests only). */
+export declare function gatherPyOrmSignals(baseDir: string): PyOrmSignals;
+/**
+ * Decide Python-ORM usage from the signal set. Any recognized ORM dep is
+ * sufficient; confidence rises when SQLAlchemy AND SQLModel are both declared
+ * (the canonical modern stack). Returns null → generic-Python fallthrough,
+ * byte-for-byte unchanged.
+ */
+export declare function scorePyOrm(s: PyOrmSignals, rootPath?: string): DetectMatch | null;
+export declare const pythonOrmAdapter: FrameworkAdapter;
+//# sourceMappingURL=python-orm.d.ts.map

package/dist/framework/python-orm/python-orm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-orm.d.ts","sourceRoot":"","sources":["../../../src/framework/python-orm/python-orm.ts"],"names":[],"mappings":"AAiEA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAOjB,MAAM,aAAa,CAAC;AAMrB,qFAAqF;AACrF,MAAM,MAAM,KAAK,GAAG,YAAY,GAAG,UAAU,GAAG,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAKrF,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,IAAI,EAAE,KAAK,EAAE,CAAC;CACf;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAGhE;AA6CD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,SAAK,GAAG,WAAW,GAAG,IAAI,CAU7E;AAiaD,eAAO,MAAM,gBAAgB,EAAE,gBA8C9B,CAAC"}

package/dist/framework/python-orm/python-orm.js

@@ -0,0 +1,516 @@
+// the Python ORM entity FrameworkAdapter. The ORM *entity* surface,
+// framework-independent: it works WITH or WITHOUT a web framework (co-fires with
+// the FastAPI adapter on a FastAPI+SQLModel repo; runs alone on a plain
+// SQLAlchemy service). Sibling of, NOT the same as, the TS `orm` adapter
+// (Prisma/Drizzle/TypeORM/Mongoose) — this one reads Python via the shared
+// pure-syntactic Pyright parse (scripts/ingest/framework/python/{py-ast,analyze}),
+// install-free + never executes repo code.
+//
+//   * detect()        — a `sqlalchemy` / `sqlmodel` dependency (+ tortoise-orm /
+//                       beanie / peewee widen the marker heuristic). PURE scorer.
+//   * roleTags        — a module that DECLARES ORM entities → role 'model' on the
+//                       LOCKED `service` Module-kind (roles are metadata; the
+//                       module's `kind` is unchanged, and NEVER a new kind).
+//   * syntheticEdges  — a `relationship()` / `Mapped["Other"]` / `ForeignKey(
+//                       "other.id")` between entity classes in DIFFERENT modules
+//                       → a 'calls' edge between the two model MODULES (a FK is a
+//                       structural data relationship; 'calls' is the neutral
+//                       8-verb verb — 'reads'/'writes' would imply runtime data
+//                       flow a schema relationship doesn't express). File-id
+//                       endpoints; intra-file relationships collapse (self-edge).
+//   * groupingPrior   — a `models/`-ish directory (or a cluster of ≥2 entity
+//                       files, or a lone `models.py`) → a 'Data Model' subsystem.
+//
+// DESIGN NOTE (, NO schema change): entities are surfaced via role-tags +
+// relationship EDGES between the EXISTING model modules — NOT as new entity
+// sub-nodes (that would be a domain-model change beyond this issue). The moat
+// (the *why*) is unaffected; this only makes the data layer legible.
+//
+// Entity detection (marker-base-class heuristic, gated by the detected ORM so a
+// bare `class X(Model)` in a non-ORM repo never matches):
+//   * SQLAlchemy 2.0 — `class X(Base)` / a `DeclarativeBase` subclass carrying
+//                      `Mapped[…]` / `mapped_column()` / `Column()` markers.
+//   * SQLModel       — `class X(…, table=True)` (a non-table SQLModel is a schema,
+//                      not a table — correctly excluded).
+//   * Tortoise/Peewee— `class X(Model)`.  Beanie — `class X(Document)`.
+//
+// Unresolvable relationship / FK targets DEGRADE + LOG (no silent caps).
+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 { parsePythonScope } from '../python/analyze.js';
+import { annotationChain, callCallee, classBaseChains, className, classKeywordArg, collectClassBody, isTrueConstant, keywordArg, nameValue, positionalArgs, stringValue, subscriptArgs, PN, } from '../python/py-ast.js';
+// Canonical ordering — deterministic metadata order regardless of manifest order.
+const ORM_ORDER = ['sqlalchemy', 'sqlmodel', 'tortoise-orm', 'beanie', 'peewee'];
+/** Gather the signal set for a single root dir (reads manifests only). */
+export function gatherPyOrmSignals(baseDir) {
+    const deps = readPythonDeps(baseDir);
+    return { orms: ORM_ORDER.filter((o) => deps.has(o)) };
+}
+// 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 hold a Python manifest — the shallow search
+ * for a nested backend (`backend/` | `server/` | `api/`) where the ORM commonly
+ * lives in a frontend+backend monorepo. Sorted → deterministic first-match.
+ */
+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 Python-ORM usage from the signal set. Any recognized ORM dep is
+ * sufficient; confidence rises when SQLAlchemy AND SQLModel are both declared
+ * (the canonical modern stack). Returns null → generic-Python fallthrough,
+ * byte-for-byte unchanged.
+ */
+export function scorePyOrm(s, rootPath = '') {
+    if (s.orms.length === 0)
+        return null;
+    let confidence = 0.8;
+    if (s.orms.includes('sqlalchemy') && s.orms.includes('sqlmodel'))
+        confidence += 0.1;
+    return {
+        adapter: 'python-orm',
+        confidence: clampConfidence(confidence),
+        rootPath,
+        metadata: { orms: s.orms, variant: s.orms.join('+') },
+    };
+}
+// ---------------------------------------------------------------------------
+// Role vocabulary → locked MODULE_KINDS. A module that DECLARES ORM entities is a
+// model/data-layer module → role 'model' on the LOCKED `service` kind (the same
+// kind the TS `orm` adapter's 'repository' role maps onto — roles are metadata,
+// NEVER a new Module-kind). Priority slots with the cross-adapter data-layer tier
+// (below request-spine handlers, alongside the TS 'repository' role).
+const MODEL_ROLE = 'model';
+const MODEL_KIND = 'service';
+const MODEL_PRIORITY = 2;
+// SQLAlchemy field/relationship marker calls (a class body carrying any of these
+// is a mapped entity even when its base was renamed away from `Base`).
+const SQLA_FIELD_MARKERS = new Set(['mapped_column', 'Column', 'relationship']);
+// The SQLAlchemy 2.0 typed-attribute wrapper — `Mapped[…]`.
+const MAPPED = 'Mapped';
+// The relationship constructor call names — SQLAlchemy `relationship()` +
+// SQLModel `Relationship()`.
+const RELATIONSHIP_CALLS = new Set(['relationship', 'Relationship']);
+// The foreign-key markers — SQLAlchemy `ForeignKey("t.col")` (bare or nested in
+// mapped_column/Column) + SQLModel `Field(foreign_key="t.col")`.
+const FOREIGN_KEY = 'ForeignKey';
+const FIELD = 'Field';
+// Directory / file basenames that name a data-model home.
+const MODELS_DIR_NAMES = new Set([
+    'models', 'model', 'entities', 'entity', 'schemas', 'schema', 'orm', 'db', 'database', 'domain', 'tables',
+]);
+// Alembic / migration files define HISTORICAL table snapshots, not the live
+// domain model — never index them as entities (mirrors the TS `orm` adapter's
+// MIGRATION_PATH_RE). Excluding them keeps edges pointing at the real model
+// module and avoids mis-tagging a migration as a 'model'.
+const MIGRATION_PATH_RE = /(^|\/)(migrations?|alembic|versions)(\/|$)/i;
+// Memoized on the FrameworkContext OBJECT (not repoDir) so groupingPrior +
+// syntheticEdges + roleTags share ONE parse, while the merge walk's per-checkpoint
+// ctx gets a fresh analysis. Mirrors fastapi / nest / RN.
+const ANALYSIS_CACHE = new WeakMap();
+function chainLast(c) {
+    return c.path.length ? c.path[c.path.length - 1] : c.root;
+}
+function slugify(s) {
+    return s
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+function humanize(s) {
+    const words = s
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/[_\-.]+/g, ' ')
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean);
+    if (words.length === 0)
+        return s;
+    return words.map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');
+}
+function dirOf(fileId) {
+    const i = fileId.lastIndexOf('/');
+    return i >= 0 ? fileId.slice(0, i) : '';
+}
+function dirBase(dir) {
+    if (dir === '')
+        return 'root';
+    const i = dir.lastIndexOf('/');
+    return i >= 0 ? dir.slice(i + 1) : dir;
+}
+function addEdge(edges, from, to, relation) {
+    if (from === to)
+        return; // intra-file relationship collapses; the step drops self-edges too
+    const key = `${from}→${to}:calls`;
+    if (!edges.has(key)) {
+        edges.set(key, {
+            source: from,
+            target: to,
+            kind: 'calls',
+            metadata: { framework: 'python-orm', relation },
+        });
+    }
+}
+// A class body carries a SQLAlchemy mapping marker (a `mapped_column()`/`Column()`/
+// `relationship()` call, or a `Mapped[…]` typed attribute) — the robust signal
+// when the declarative base was renamed away from the literal `Base`.
+function hasSqlaBodyMarker(body) {
+    for (const call of body.calls) {
+        const cc = callCallee(call);
+        if (cc && SQLA_FIELD_MARKERS.has(chainLast(cc)))
+            return true;
+    }
+    for (const ta of body.typeAnnotations) {
+        const head = annotationChain(ta.d.annotation);
+        if (head && chainLast(head) === MAPPED)
+            return true;
+    }
+    return false;
+}
+// Is this class a mapped ORM entity? Gated by the detected ORM family so a
+// coincidental `class X(Model)` in a repo that doesn't use Tortoise/Peewee never
+// matches. `table=True` alone (SQLModel) is authoritative regardless of base.
+function isEntityClass(cls, body, detected) {
+    const bases = classBaseChains(cls).map(chainLast);
+    const hasBase = (n) => bases.includes(n);
+    // SQLModel — the `table=True` keyword is the table marker (a base-schema
+    // SQLModel without it is NOT a table). Independent of the exact base name so
+    // `class Hero(HeroBase, table=True)` still matches.
+    if (detected.has('sqlmodel') && isTrueConstant(classKeywordArg(cls, 'table')))
+        return true;
+    // SQLAlchemy declarative — the conventional `Base` user-base, or (renamed base /
+    // classic) any body mapping marker. A bare `class Base(DeclarativeBase): pass`
+    // (no `Base` in its OWN bases, no markers) is correctly NOT an entity.
+    if (detected.has('sqlalchemy') || detected.has('sqlmodel')) {
+        if (hasBase('Base'))
+            return true;
+        if (hasSqlaBodyMarker(body))
+            return true;
+    }
+    // Tortoise / Peewee active-record base, Beanie ODM document.
+    if ((detected.has('tortoise-orm') || detected.has('peewee')) && hasBase('Model'))
+        return true;
+    if (detected.has('beanie') && hasBase('Document'))
+        return true;
+    return false;
+}
+// The explicit `__tablename__ = "…"` of a class body, or undefined.
+function explicitTableName(body) {
+    for (const a of body.assignments) {
+        if (nameValue(a.d.leftExpr) === '__tablename__') {
+            const v = stringValue(a.d.rightExpr);
+            if (v)
+                return v;
+        }
+    }
+    return undefined;
+}
+// Recursively collect the class-name-ish leaves of a subscript's argument
+// expressions: string forward-refs (`"Address"`), bare names (`Address`), and the
+// inner refs of nested subscripts (`list["Address"]`, `Optional["Address"]`).
+// Non-entity leaves (`int`, `str`, `list`) are harmless — they simply don't
+// resolve against the entity map, so no edge is drawn.
+function collectRefLeaves(exprs) {
+    const out = [];
+    for (const e of exprs) {
+        const s = stringValue(e);
+        if (s) {
+            out.push(s);
+            continue;
+        }
+        const n = nameValue(e);
+        if (n) {
+            out.push(n);
+            continue;
+        }
+        if (e.nodeType === PN.Index)
+            out.push(...collectRefLeaves(subscriptArgs(e)));
+    }
+    return out;
+}
+// Is `expr` a `relationship(...)` / `Relationship(...)` constructor call?
+function isRelationshipCall(expr) {
+    if (!expr || expr.nodeType !== PN.Call)
+        return false;
+    const cc = callCallee(expr);
+    return !!cc && RELATIONSHIP_CALLS.has(chainLast(cc));
+}
+// The relationship / FK targets an entity class body references — covering BOTH
+// the SQLAlchemy 2.0 and the SQLModel spellings:
+//   * `relationship("Other")` / `Relationship(...)` positional/`argument=` name.
+//   * `attr: Mapped["Other"] = relationship()` / `attr: "Other" = Relationship()`
+//     / `attr: list["Other"] = Relationship()` — refs from the LEFT annotation of
+//     any attribute assigned a relationship call (SQLModel drops the `Mapped[…]`).
+//   * bare `attr: Mapped["Other"]` typed relationships (gated on the `Mapped[…]`
+//     head so scalar `Mapped[int]` never counts).
+//   * `ForeignKey("other.id")` (bare or nested in mapped_column/Column) +
+//     SQLModel `Field(foreign_key="other.id")` → the referenced TABLE.
+function relationshipTargets(body) {
+    const out = [];
+    const pushTable = (s) => {
+        const table = s?.split('.')[0];
+        if (table)
+            out.push({ kind: 'table', name: table });
+    };
+    // (1) calls — relationship/Relationship positional class ref; ForeignKey / Field
+    //     foreign-key → the referenced table.
+    for (const call of body.calls) {
+        const cc = callCallee(call);
+        if (!cc)
+            continue;
+        const m = chainLast(cc);
+        if (RELATIONSHIP_CALLS.has(m)) {
+            const arg = positionalArgs(call)[0] ?? keywordArg(call, 'argument');
+            const nm = stringValue(arg) ?? nameValue(arg);
+            if (nm)
+                out.push({ kind: 'class', name: nm });
+        }
+        else if (m === FOREIGN_KEY) {
+            pushTable(stringValue(positionalArgs(call)[0]));
+        }
+        else if (m === FIELD) {
+            pushTable(stringValue(keywordArg(call, 'foreign_key')));
+        }
+    }
+    // (2) `attr: <annotation> = relationship()/Relationship()` — the target class(es)
+    //     from the LEFT annotation (handles SQLModel's plain `"Other"`/`list["Other"]`
+    //     as well as SQLAlchemy's `Mapped["Other"]`).
+    for (const a of body.assignments) {
+        const left = a.d.leftExpr;
+        if (left.nodeType !== PN.TypeAnnotation)
+            continue;
+        if (!isRelationshipCall(a.d.rightExpr))
+            continue;
+        for (const nm of collectRefLeaves([left.d.annotation])) {
+            out.push({ kind: 'class', name: nm });
+        }
+    }
+    // (3) bare `attr: Mapped["Other"]` (no assignment) — Mapped-gated so scalars skip.
+    for (const ta of body.typeAnnotations) {
+        const head = annotationChain(ta.d.annotation);
+        if (!head || chainLast(head) !== MAPPED)
+            continue;
+        for (const nm of collectRefLeaves(subscriptArgs(ta.d.annotation))) {
+            out.push({ kind: 'class', name: nm });
+        }
+    }
+    return out;
+}
+// Deterministic, collision-free group ids ( discipline): sorted by dir, a
+// bare slug goes to the first claimant; collisions take a `-<dirBase>` then `-<n>`
+// suffix. Identical run-to-run (the snapshot grouping-stability invariant).
+function assignGroups(seeds) {
+    const taken = new Set();
+    const byDir = [...seeds].sort((a, b) => (a.dir < b.dir ? -1 : a.dir > b.dir ? 1 : 0));
+    const groups = [];
+    for (const seed of byDir) {
+        let id = seed.baseSlug;
+        if (taken.has(id))
+            id = `${seed.baseSlug}-${slugify(dirBase(seed.dir)) || 'dir'}`;
+        let n = 2;
+        while (taken.has(id))
+            id = `${seed.baseSlug}-${n++}`;
+        taken.add(id);
+        groups.push({ id, label: seed.label, fileIds: [...seed.fileIds].sort() });
+    }
+    return groups.sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+}
+// Group entity files into 'Data Model' subsystem(s): one per directory that is
+// models-ish-named OR holds a cluster of ≥2 entity files. A single scattered
+// `models.py` (e.g. a per-domain `incident/models.py`) is deliberately LEFT to
+// directory grouping — grouping it here would fragment a per-domain layout into
+// dozens of identical 'Data Model' boxes and override the more informative
+// domain subsystem ( review).
+function buildGroups(entityFiles) {
+    const byDir = new Map();
+    for (const f of entityFiles) {
+        const dir = dirOf(f);
+        (byDir.get(dir) ?? byDir.set(dir, []).get(dir)).push(f);
+    }
+    const seeds = [];
+    for (const [dir, files] of byDir) {
+        const modelsDir = MODELS_DIR_NAMES.has(dirBase(dir).toLowerCase());
+        const cluster = files.length >= 2;
+        if (!(modelsDir || cluster))
+            continue;
+        const label = modelsDir ? 'Data Model' : humanize(dirBase(dir));
+        seeds.push({ dir, baseSlug: slugify(label) || 'data-model', label, fileIds: files });
+    }
+    return assignGroups(seeds);
+}
+function analyzePyOrm(ctx) {
+    const detected = new Set((ctx.match.metadata?.orms ?? []).filter(Boolean));
+    if (detected.size === 0)
+        return { groups: [], edges: [], roles: new Map() };
+    const scope = parsePythonScope(ctx);
+    const fileIds = [...scope.parsed.keys()].sort();
+    const diag = { unresolvedTargets: new Set(), duplicateClasses: new Set() };
+    const entities = [];
+    const entityFiles = new Set();
+    const classToFile = new Map(); // className → module (first/smallest fileId wins)
+    const tableToFile = new Map(); // tablename → module (first wins)
+    // Pass 1 — find entity classes; index them by class name + table name.
+    for (const fileId of fileIds) {
+        if (MIGRATION_PATH_RE.test(fileId))
+            continue; // historical snapshot, not the live model
+        const parsed = scope.parsed.get(fileId);
+        if (!parsed)
+            continue;
+        for (const cls of parsed.nodes.classes) {
+            const name = className(cls);
+            if (!name)
+                continue;
+            const body = collectClassBody(cls);
+            if (!isEntityClass(cls, body, detected))
+                continue;
+            entityFiles.add(fileId);
+            entities.push({ fileId, name, targets: relationshipTargets(body) });
+            if (classToFile.has(name))
+                diag.duplicateClasses.add(name);
+            else
+                classToFile.set(name, fileId);
+            const tables = new Set([name.toLowerCase()]);
+            const explicit = explicitTableName(body);
+            if (explicit) {
+                tables.add(explicit);
+                tables.add(explicit.toLowerCase());
+            }
+            for (const t of tables)
+                if (!tableToFile.has(t))
+                    tableToFile.set(t, fileId);
+        }
+    }
+    // Pass 2 — resolve relationship / FK targets to entity modules → 'calls' edges.
+    const edges = new Map();
+    for (const ent of entities) {
+        for (const t of ent.targets) {
+            let to;
+            if (t.kind === 'class')
+                to = classToFile.get(t.name);
+            else
+                to = tableToFile.get(t.name) ?? tableToFile.get(t.name.toLowerCase());
+            if (to)
+                addEdge(edges, ent.fileId, to, t.kind === 'table' ? 'foreign-key' : 'relationship');
+            else
+                diag.unresolvedTargets.add(`${ent.fileId}: ${ent.name} → ${t.kind}:${t.name}`);
+        }
+    }
+    // Roles — every entity module is a 'model' (service kind).
+    const roles = new Map();
+    for (const fileId of [...entityFiles].sort()) {
+        roles.set(fileId, {
+            role: MODEL_ROLE,
+            kind: MODEL_KIND,
+            priority: MODEL_PRIORITY,
+            metadata: { framework: 'python-orm' },
+        });
+    }
+    const groups = buildGroups([...entityFiles]);
+    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 : 0);
+    // Positive signal for validation (mirrors fastapi/nest's log line).
+    if (roles.size > 0 || groups.length > 0 || sortedEdges.length > 0) {
+        console.log(`  [python-orm] ${entityFiles.size} model module(s) · ${groups.length} data-model group(s) · ${sortedEdges.length} relationship edge(s)`);
+    }
+    // No silent caps (locked): log everything that degraded.
+    if (diag.unresolvedTargets.size > 0 || diag.duplicateClasses.size > 0) {
+        const parts = [];
+        if (diag.unresolvedTargets.size > 0) {
+            parts.push(`${diag.unresolvedTargets.size} unresolvable target(s): ${[...diag.unresolvedTargets].sort().slice(0, 10).join(' · ')}`);
+        }
+        if (diag.duplicateClasses.size > 0) {
+            parts.push(`${diag.duplicateClasses.size} duplicate class name(s): ${[...diag.duplicateClasses].sort().join(', ')}`);
+        }
+        console.log(`  [python-orm] degraded: ${parts.join(' · ')} (logged, not silently dropped)`);
+    }
+    return { groups, edges: sortedEdges, roles };
+}
+function getAnalysis(ctx) {
+    let a = ANALYSIS_CACHE.get(ctx);
+    if (!a) {
+        a = analyzePyOrm(ctx);
+        ANALYSIS_CACHE.set(ctx, a);
+    }
+    return a;
+}
+// ---------------------------------------------------------------------------
+// The adapter.
+export const pythonOrmAdapter = {
+    name: 'python-orm',
+    async detect(ctx) {
+        const { base, rootPath } = resolveBase(ctx);
+        // Root scan first (a repo whose pyproject is at root reports rootPath '').
+        const rootMatch = scorePyOrm(gatherPyOrmSignals(base), rootPath);
+        if (rootMatch)
+            return rootMatch;
+        // Shallow-scan an immediate `backend/` | `server/` | `api/` package for a
+        // nested ORM manifest (a frontend+backend monorepo) — only when not already
+        // scoped to a workspace package (the per-package fan-out path).
+        if (!ctx.packageDir) {
+            for (const sub of shallowManifestSubdirs(base)) {
+                const m = scorePyOrm(gatherPyOrmSignals(join(base, sub)), sub);
+                if (m)
+                    return m;
+            }
+        }
+        return null;
+    },
+    // A `models/`-ish directory / entity cluster → a 'Data Model' subsystem,
+    // authoritative over directory grouping (the fastapi/nest mechanism). Fully
+    // deterministic (path-derived) → no classificationsNeeded.
+    async groupingPrior(ctx) {
+        return { groups: getAnalysis(ctx).groups };
+    },
+    // relationship() / Mapped["Other"] / ForeignKey("other.id") between entity
+    // modules → 'calls' edges (file-id endpoints; the step resolves to modules,
+    // drops self-edges, dedupes, 8-verb-validates).
+    async syntheticEdges(ctx) {
+        return getAnalysis(ctx).edges;
+    },
+    // Each ORM-entity module → role 'model' on the LOCKED `service` kind. 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 groups/edges/roles.
+    scansSourcePath(path) {
+        return path.endsWith('.py') || path.endsWith('.pyi');
+    },
+};
+//# sourceMappingURL=python-orm.js.map

package/dist/framework/python-orm/python-orm.js.map

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

package/dist/framework/react-native/react-native.d.ts

@@ -0,0 +1,35 @@
+import type { DetectMatch, FrameworkAdapter } from '../types.js';
+/** The deterministic RN/Expo signal set read from a repo (or workspace package). */
+export interface ReactNativeSignals {
+    hasReactNativeDep: boolean;
+    hasExpoDep: boolean;
+    hasAppJson: boolean;
+    hasAppConfig: boolean;
+    hasMetroConfig: boolean;
+    hasRnConfig: boolean;
+    hasIosDir: boolean;
+    hasAndroidDir: boolean;
+}
+/** Gather the signal set for a single root dir. */
+export declare function gatherReactNativeSignals(baseDir: string): ReactNativeSignals;
+/**
+ * Decide RN/Expo from the signal set. Returns a DetectMatch, or null if the
+ * signals are too weak/ambiguous to claim the stack (so the generic-TS
+ * fallthrough stays intact).
+ *
+ * A SUFFICIENT (match-on-its-own) signal is one of:
+ *   * a `react-native` or `expo` dep                  — the authoritative signal
+ *   * metro.config.* or react-native.config.*         — RN-toolchain-specific
+ *   * BOTH ios/ and android/ native dirs              — a built RN project
+ *
+ * app.json / app.config / a single native dir are SUPPORTING signals (they
+ * raise confidence) but never sufficient alone — app.json in particular is too
+ * generic to claim a stack on its own.
+ *
+ * Variant: `expo` dep (or an `app.config.*` dynamic config) ⇒ 'expo', else
+ * 'bare'. Recorded in metadata + reflected in confidence.
+ */
+export declare function scoreReactNative(s: ReactNativeSignals, rootPath?: string): DetectMatch | null;
+export type ReactNativeRole = 'navigator' | 'nativeModule' | 'screen' | 'hook' | 'component';
+export declare const reactNativeAdapter: FrameworkAdapter;
+//# sourceMappingURL=react-native.d.ts.map

package/dist/framework/react-native/react-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-native.d.ts","sourceRoot":"","sources":["../../../src/framework/react-native/react-native.ts"],"names":[],"mappings":"AAkDA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAOjB,MAAM,aAAa,CAAC;AAgCrB,oFAAoF;AACpF,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,mDAAmD;AACnD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAY5E;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,kBAAkB,EAAE,QAAQ,SAAK,GAAG,WAAW,GAAG,IAAI,CAuCzF;AAoCD,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAilC7F,eAAO,MAAM,kBAAkB,EAAE,gBAgDhC,CAAC"}