@suss/adapter-python 0.5.11 → 0.7.0

package/dist/index.cjs

@@ -15747,7 +15747,7 @@ function date4(params) {
 // ../../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../../ir-core/dist/chunk-WKR5SU4N.js
+// ../../ir-core/dist/chunk-TEXSN75M.js
 function gqlIdentityKey(typeName, fieldName) {
   return `gql:${typeName}.${fieldName}`;
 }
@@ -16116,27 +16116,41 @@ var runtimeConfigSemantics = defineBoundarySemantics({
     identityKey: () => null
   }
 });
-var StorageRelationalSemanticsSchema = external_exports.object({
-  name: external_exports.literal("storage-relational"),
-  storageSystem: external_exports.enum(["postgres", "mysql", "sqlite"]),
+var StorageSemanticsSchema = external_exports.object({
+  name: external_exports.literal("storage"),
   /**
-   * The ORM or driver scope. A single-database setup uses `"default"`,
-   * and a monorepo with several schemas gives each one its own value.
+   * Which store this is: postgres, mysql, sqlite, dynamodb. Two
+   * products' containers can share a name, so this keeps them apart,
+   * and it is what a finding message calls the store.
+   */
+  storageSystem: external_exports.string(),
+  /**
+   * The ORM, schema, or deployment scope. A single-database setup uses
+   * `"default"`, and a monorepo with several schemas gives each one its
+   * own value.
    */
   scope: external_exports.string(),
   /**
-   * The table or model name as the schema declares it, or null when
-   * the source states one this reader could not settle. A null table
-   * pairs with nothing, rather than with whatever its source text
-   * happens to spell.
+   * The table, bucket, collection, or index, as the source declares
+   * it, or null when the source states one this reader could not
+   * settle. A null container pairs with nothing, rather than with
+   * whatever its source text happens to spell.
+   */
+  container: external_exports.string().nullable(),
+  /**
+   * A secondary way into the container, a DynamoDB global secondary
+   * index or an Elasticsearch alias, each with its own key fields.
+   * Null means the container's own primary way in. A query through an
+   * index and a query through the table are different accesses, so
+   * they pair separately.
    */
-  table: external_exports.string().nullable()
+  accessPath: external_exports.string().nullable()
 });
-var storageRelationalSemantics = defineBoundarySemantics({
-  name: "storage-relational",
-  schema: StorageRelationalSemanticsSchema,
+var storageSemantics = defineBoundarySemantics({
+  name: "storage",
+  schema: StorageSemanticsSchema,
   behavior: {
-    /** A query returns rows, not a status and a body. */
+    /** A query returns rows or items, not a status and a body. */
     exchangesHttpResponses: false,
     reportsUnpairedItself: false,
     identityKey: () => null
@@ -16148,7 +16162,7 @@ var SemanticsSchema = external_exports.discriminatedUnion("name", [
   graphqlResolverSemantics.schema,
   graphqlOperationSemantics.schema,
   runtimeConfigSemantics.schema,
-  storageRelationalSemantics.schema,
+  storageSemantics.schema,
   messageBusSemantics.schema
 ]);
 var DEFINITIONS = [
@@ -16157,7 +16171,7 @@ var DEFINITIONS = [
   graphqlResolverSemantics,
   graphqlOperationSemantics,
   runtimeConfigSemantics,
-  storageRelationalSemantics,
+  storageSemantics,
   messageBusSemantics
 ];
 var BY_NAME = new Map(
@@ -16297,19 +16311,97 @@ function namedOrNull(value, field2) {
   }
   return value;
 }
-function storageRelationalBinding(opts) {
+function storageBinding(opts) {
   return {
-    transport: opts.storageSystem,
+    transport: opts.transport ?? opts.storageSystem,
     semantics: {
-      name: "storage-relational",
+      name: "storage",
       storageSystem: opts.storageSystem,
       scope: opts.scope,
-      table: namedOrNull(opts.table, "storage table")
+      container: namedOrNull(opts.container, "storage container"),
+      accessPath: opts.accessPath ?? null
     },
     recognition: opts.recognition
   };
 }
 
+// src/rawSql.ts
+var import_sql = require("@suss/sql");
+function rawSqlEffects(calls, options) {
+  if (options.patterns.length === 0) {
+    return [];
+  }
+  const effects = [];
+  for (const call of calls) {
+    const pattern = patternFor(call, options);
+    if (pattern === void 0) {
+      continue;
+    }
+    const statement = statementIn(call);
+    if (statement === null) {
+      continue;
+    }
+    for (const access of (0, import_sql.readSqlAccess)(statement, {
+      dialect: pattern.storageSystem
+    })) {
+      effects.push({
+        type: "interaction",
+        binding: storageBinding({
+          recognition: `python-${pattern.module}`,
+          storageSystem: pattern.storageSystem,
+          scope: pattern.module,
+          container: access.table
+        }),
+        callee: field(call, "function")?.text ?? "",
+        interaction: {
+          class: "storage-access",
+          kind: access.kind,
+          fields: access.fields,
+          ...access.selector.length > 0 ? { selector: access.selector } : {},
+          operation: field(call, "function")?.text ?? ""
+        }
+      });
+    }
+  }
+  return effects;
+}
+function patternFor(call, options) {
+  const callee = field(call, "function");
+  if (callee === null || callee.type !== "identifier") {
+    return void 0;
+  }
+  const from = options.facts.facts("pyImportedName").find((row) => String(row[0]) === `${options.filePath}#${callee.text}`);
+  if (from === void 0) {
+    return void 0;
+  }
+  const module2 = String(from[1]);
+  return options.patterns.find(
+    (pattern) => pattern.module === module2 && pattern.functions.includes(callee.text)
+  );
+}
+function statementIn(call) {
+  const args = field(call, "arguments");
+  const first = args?.namedChildren.find((child) => child !== null) ?? null;
+  if (first === null || first.type !== "string") {
+    return null;
+  }
+  const parts = [""];
+  for (const child of first.namedChildren) {
+    if (child === null) {
+      continue;
+    }
+    if (child.type === "string_content") {
+      parts[parts.length - 1] += child.text;
+      continue;
+    }
+    if (child.type === "interpolation") {
+      parts.push("");
+    }
+  }
+  const statement = (0, import_sql.sqlFromParts)(parts);
+  return statement.trim() === "" ? null : statement;
+}
+
 // src/facts/resolve.ts
 var import_datalog2 = require("@suss/datalog");
 
@@ -17160,11 +17252,11 @@ function effectFor(pattern, chain, options) {
   ];
   return {
     type: "interaction",
-    binding: storageRelationalBinding({
+    binding: storageBinding({
       recognition: "python-storage",
       storageSystem: pattern.storageSystem,
       scope: pattern.module,
-      table: chain.subject
+      container: chain.subject
     }),
     callee: chain.last.text,
     interaction: {
@@ -17907,10 +17999,17 @@ function buildRouteUnit(options) {
     () => readReturnAnnotation(definitionNode, enclosingScope, ctx)
   );
   const effects = invocationEffects(definitionNode);
-  const storage = storageLookup === void 0 ? [] : storageEffects(bodyCalls(definitionNode), {
-    ...storageLookup,
-    filePath: storageLookup.factsPath
-  });
+  const storage = storageLookup === void 0 ? [] : [
+    ...storageEffects(bodyCalls(definitionNode), {
+      ...storageLookup,
+      filePath: storageLookup.factsPath
+    }),
+    ...rawSqlEffects(bodyCalls(definitionNode), {
+      facts: storageLookup.facts,
+      filePath: storageLookup.factsPath,
+      patterns: storageLookup.rawSql ?? []
+    })
+  ];
   const perReturn = branchesFromReturns(
     readsReturnedStatus,
     definitionNode,
@@ -19266,6 +19365,7 @@ async function extractPythonProject(options) {
     (pack) => pack.discovery.some((pattern) => pattern.routerComposition !== void 0)
   );
   const storagePatterns = options.packs.flatMap((pack) => pack.storage ?? []);
+  const rawSqlPatterns = options.packs.flatMap((pack) => pack.rawSql ?? []);
   const needsValues = mountsRouters || storagePatterns.length > 0;
   const definitions = /* @__PURE__ */ new Map();
   for (const { file: file2, root, module: moduleBinding } of bound) {
@@ -19295,14 +19395,15 @@ async function extractPythonProject(options) {
       absoluteFile: file2,
       routerIndex,
       gapHandling,
-      ...storagePatterns.length > 0 ? {
+      ...storagePatterns.length > 0 || rawSqlPatterns.length > 0 ? {
         storage: {
           facts: db,
           factsPath: file2,
           patterns: storagePatterns,
           definitionAt: (key) => definitions.get(key),
           couldMatch,
-          leadsToStorage
+          leadsToStorage,
+          rawSql: rawSqlPatterns
         }
       } : {}
     });
@@ -19313,8 +19414,31 @@ async function extractPythonProject(options) {
       emitEntryFact(db, file2, raw.identity.range, raw.identity.name);
     }
   }
+  stampModuleImports(summaries, db, displayPathOf);
   return { summaries, facts: db };
 }
+function stampModuleImports(summaries, db, displayPathOf) {
+  const importsByFile = /* @__PURE__ */ new Map();
+  for (const [from, , to] of db.facts("pyImportResolved")) {
+    if (typeof from !== "string" || typeof to !== "string") {
+      continue;
+    }
+    const key = displayPathOf(from);
+    const seen = importsByFile.get(key) ?? /* @__PURE__ */ new Set();
+    seen.add(displayPathOf(to));
+    importsByFile.set(key, seen);
+  }
+  for (const summary of summaries) {
+    const imports = importsByFile.get(summary.location.file);
+    if (imports === void 0 || imports.size === 0) {
+      continue;
+    }
+    summary.metadata = {
+      ...summary.metadata ?? {},
+      moduleImports: [...imports].sort()
+    };
+  }
+}
 var SKIPPED_DIRECTORIES = /* @__PURE__ */ new Set([
   "__pycache__",
   ".venv",

package/dist/index.d.cts

@@ -189,6 +189,8 @@ interface PythonPack {
     projectModules?: string[];
     /** What the library's own database queries look like. The README says how one is matched. */
     storage?: StoragePattern[];
+    /** How the library lets a project hand the database SQL it wrote itself. */
+    rawSql?: RawSqlPattern[];
 }
 /**
  * A call talks to the database when the method behind it says it returns one
@@ -212,6 +214,20 @@ interface StoragePattern {
     /** Which database the library is talking to, for the boundary binding. */
     storageSystem: "postgres" | "mysql" | "sqlite";
 }
+/**
+ * The function a library gives a project for handing the database a
+ * statement written as SQL, and where it comes from. SQLAlchemy exports
+ * `text` from `sqlalchemy`. A local function of the same name is
+ * somebody else's, so the import is what settles a match.
+ */
+interface RawSqlPattern {
+    /** The module the function is imported from. */
+    module: string;
+    /** The functions that take a statement written as SQL. */
+    functions: string[];
+    /** Which database the library is talking to, for the boundary binding. */
+    storageSystem: "postgres" | "mysql" | "sqlite";
+}
 type PythonDiscoveryPattern = DecoratedClassRoute | DecoratedFunctionRoute;
 /** Conventions both kinds of route share. Each one describes what the library does, never a project's choice. */
 interface RouteConventions {
@@ -370,6 +386,8 @@ interface StorageLookup {
     readonly definitionAt: (key: string) => Node | undefined;
     readonly couldMatch: ReadonlySet<string>;
     readonly leadsToStorage: ReadonlySet<string>;
+    /** What a pack says about statements a project writes as SQL itself. */
+    readonly rawSql?: readonly RawSqlPattern[];
 }
 
 /**
@@ -551,4 +569,4 @@ declare function extractPythonProject(options: ExtractPythonOptions): Promise<Ex
 /** Every `.py` file under `root`, depth-first, skipping the usual non-source directories. */
 declare function findPythonFiles(root: string): string[];
 
-export { type AnnotationContext, type Binding, type BoundPythonFile, type DecoratedClassRoute, type DecoratedFunctionRoute, type DecoratorArg, type DecoratorClassification, type DiscoveryOptions, type ExtractPythonOptions, type ExtractPythonResult, type ModuleBinding, type ModuleResolution, type ModuleResolverOptions, type MountObjectCarrier, type MountObjectPrefix, type MountPrefixEffect, type NoValuePrefix, type PathRepeatedSlashes, type PrefixTrailingSlash, type PythonDiscoveryPattern, type PythonPack, type RelativeModuleSpec, type RouteConventions, type RoutePrefixResolution, type RouterComposition, type RouterIndex, type Scope, type ScopeKind, type StoragePattern, annotationToShape, bindModule, buildRouterIndex, classifyDecorator, containedValues, discoverUnits, emitEntryFact, emitModuleImportFacts, emitValueFacts, extractPythonProject, findPythonFiles, nodeId, objectReturnedBy, parsePython, resolveAbsoluteModule, resolveCalls, resolveModule, resolveName, resolveRelativeModule, shapeFromName, unitKey };
+export { type AnnotationContext, type Binding, type BoundPythonFile, type DecoratedClassRoute, type DecoratedFunctionRoute, type DecoratorArg, type DecoratorClassification, type DiscoveryOptions, type ExtractPythonOptions, type ExtractPythonResult, type ModuleBinding, type ModuleResolution, type ModuleResolverOptions, type MountObjectCarrier, type MountObjectPrefix, type MountPrefixEffect, type NoValuePrefix, type PathRepeatedSlashes, type PrefixTrailingSlash, type PythonDiscoveryPattern, type PythonPack, type RawSqlPattern, type RelativeModuleSpec, type RouteConventions, type RoutePrefixResolution, type RouterComposition, type RouterIndex, type Scope, type ScopeKind, type StoragePattern, annotationToShape, bindModule, buildRouterIndex, classifyDecorator, containedValues, discoverUnits, emitEntryFact, emitModuleImportFacts, emitValueFacts, extractPythonProject, findPythonFiles, nodeId, objectReturnedBy, parsePython, resolveAbsoluteModule, resolveCalls, resolveModule, resolveName, resolveRelativeModule, shapeFromName, unitKey };

package/dist/index.d.ts

@@ -189,6 +189,8 @@ interface PythonPack {
     projectModules?: string[];
     /** What the library's own database queries look like. The README says how one is matched. */
     storage?: StoragePattern[];
+    /** How the library lets a project hand the database SQL it wrote itself. */
+    rawSql?: RawSqlPattern[];
 }
 /**
  * A call talks to the database when the method behind it says it returns one
@@ -212,6 +214,20 @@ interface StoragePattern {
     /** Which database the library is talking to, for the boundary binding. */
     storageSystem: "postgres" | "mysql" | "sqlite";
 }
+/**
+ * The function a library gives a project for handing the database a
+ * statement written as SQL, and where it comes from. SQLAlchemy exports
+ * `text` from `sqlalchemy`. A local function of the same name is
+ * somebody else's, so the import is what settles a match.
+ */
+interface RawSqlPattern {
+    /** The module the function is imported from. */
+    module: string;
+    /** The functions that take a statement written as SQL. */
+    functions: string[];
+    /** Which database the library is talking to, for the boundary binding. */
+    storageSystem: "postgres" | "mysql" | "sqlite";
+}
 type PythonDiscoveryPattern = DecoratedClassRoute | DecoratedFunctionRoute;
 /** Conventions both kinds of route share. Each one describes what the library does, never a project's choice. */
 interface RouteConventions {
@@ -370,6 +386,8 @@ interface StorageLookup {
     readonly definitionAt: (key: string) => Node | undefined;
     readonly couldMatch: ReadonlySet<string>;
     readonly leadsToStorage: ReadonlySet<string>;
+    /** What a pack says about statements a project writes as SQL itself. */
+    readonly rawSql?: readonly RawSqlPattern[];
 }
 
 /**
@@ -551,4 +569,4 @@ declare function extractPythonProject(options: ExtractPythonOptions): Promise<Ex
 /** Every `.py` file under `root`, depth-first, skipping the usual non-source directories. */
 declare function findPythonFiles(root: string): string[];
 
-export { type AnnotationContext, type Binding, type BoundPythonFile, type DecoratedClassRoute, type DecoratedFunctionRoute, type DecoratorArg, type DecoratorClassification, type DiscoveryOptions, type ExtractPythonOptions, type ExtractPythonResult, type ModuleBinding, type ModuleResolution, type ModuleResolverOptions, type MountObjectCarrier, type MountObjectPrefix, type MountPrefixEffect, type NoValuePrefix, type PathRepeatedSlashes, type PrefixTrailingSlash, type PythonDiscoveryPattern, type PythonPack, type RelativeModuleSpec, type RouteConventions, type RoutePrefixResolution, type RouterComposition, type RouterIndex, type Scope, type ScopeKind, type StoragePattern, annotationToShape, bindModule, buildRouterIndex, classifyDecorator, containedValues, discoverUnits, emitEntryFact, emitModuleImportFacts, emitValueFacts, extractPythonProject, findPythonFiles, nodeId, objectReturnedBy, parsePython, resolveAbsoluteModule, resolveCalls, resolveModule, resolveName, resolveRelativeModule, shapeFromName, unitKey };
+export { type AnnotationContext, type Binding, type BoundPythonFile, type DecoratedClassRoute, type DecoratedFunctionRoute, type DecoratorArg, type DecoratorClassification, type DiscoveryOptions, type ExtractPythonOptions, type ExtractPythonResult, type ModuleBinding, type ModuleResolution, type ModuleResolverOptions, type MountObjectCarrier, type MountObjectPrefix, type MountPrefixEffect, type NoValuePrefix, type PathRepeatedSlashes, type PrefixTrailingSlash, type PythonDiscoveryPattern, type PythonPack, type RawSqlPattern, type RelativeModuleSpec, type RouteConventions, type RoutePrefixResolution, type RouterComposition, type RouterIndex, type Scope, type ScopeKind, type StoragePattern, annotationToShape, bindModule, buildRouterIndex, classifyDecorator, containedValues, discoverUnits, emitEntryFact, emitModuleImportFacts, emitValueFacts, extractPythonProject, findPythonFiles, nodeId, objectReturnedBy, parsePython, resolveAbsoluteModule, resolveCalls, resolveModule, resolveName, resolveRelativeModule, shapeFromName, unitKey };

package/dist/index.js

@@ -15703,7 +15703,7 @@ function date4(params) {
 // ../../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../../ir-core/dist/chunk-WKR5SU4N.js
+// ../../ir-core/dist/chunk-TEXSN75M.js
 function gqlIdentityKey(typeName, fieldName) {
   return `gql:${typeName}.${fieldName}`;
 }
@@ -16072,27 +16072,41 @@ var runtimeConfigSemantics = defineBoundarySemantics({
     identityKey: () => null
   }
 });
-var StorageRelationalSemanticsSchema = external_exports.object({
-  name: external_exports.literal("storage-relational"),
-  storageSystem: external_exports.enum(["postgres", "mysql", "sqlite"]),
+var StorageSemanticsSchema = external_exports.object({
+  name: external_exports.literal("storage"),
   /**
-   * The ORM or driver scope. A single-database setup uses `"default"`,
-   * and a monorepo with several schemas gives each one its own value.
+   * Which store this is: postgres, mysql, sqlite, dynamodb. Two
+   * products' containers can share a name, so this keeps them apart,
+   * and it is what a finding message calls the store.
+   */
+  storageSystem: external_exports.string(),
+  /**
+   * The ORM, schema, or deployment scope. A single-database setup uses
+   * `"default"`, and a monorepo with several schemas gives each one its
+   * own value.
    */
   scope: external_exports.string(),
   /**
-   * The table or model name as the schema declares it, or null when
-   * the source states one this reader could not settle. A null table
-   * pairs with nothing, rather than with whatever its source text
-   * happens to spell.
+   * The table, bucket, collection, or index, as the source declares
+   * it, or null when the source states one this reader could not
+   * settle. A null container pairs with nothing, rather than with
+   * whatever its source text happens to spell.
+   */
+  container: external_exports.string().nullable(),
+  /**
+   * A secondary way into the container, a DynamoDB global secondary
+   * index or an Elasticsearch alias, each with its own key fields.
+   * Null means the container's own primary way in. A query through an
+   * index and a query through the table are different accesses, so
+   * they pair separately.
    */
-  table: external_exports.string().nullable()
+  accessPath: external_exports.string().nullable()
 });
-var storageRelationalSemantics = defineBoundarySemantics({
-  name: "storage-relational",
-  schema: StorageRelationalSemanticsSchema,
+var storageSemantics = defineBoundarySemantics({
+  name: "storage",
+  schema: StorageSemanticsSchema,
   behavior: {
-    /** A query returns rows, not a status and a body. */
+    /** A query returns rows or items, not a status and a body. */
     exchangesHttpResponses: false,
     reportsUnpairedItself: false,
     identityKey: () => null
@@ -16104,7 +16118,7 @@ var SemanticsSchema = external_exports.discriminatedUnion("name", [
   graphqlResolverSemantics.schema,
   graphqlOperationSemantics.schema,
   runtimeConfigSemantics.schema,
-  storageRelationalSemantics.schema,
+  storageSemantics.schema,
   messageBusSemantics.schema
 ]);
 var DEFINITIONS = [
@@ -16113,7 +16127,7 @@ var DEFINITIONS = [
   graphqlResolverSemantics,
   graphqlOperationSemantics,
   runtimeConfigSemantics,
-  storageRelationalSemantics,
+  storageSemantics,
   messageBusSemantics
 ];
 var BY_NAME = new Map(
@@ -16253,19 +16267,97 @@ function namedOrNull(value, field2) {
   }
   return value;
 }
-function storageRelationalBinding(opts) {
+function storageBinding(opts) {
   return {
-    transport: opts.storageSystem,
+    transport: opts.transport ?? opts.storageSystem,
     semantics: {
-      name: "storage-relational",
+      name: "storage",
       storageSystem: opts.storageSystem,
       scope: opts.scope,
-      table: namedOrNull(opts.table, "storage table")
+      container: namedOrNull(opts.container, "storage container"),
+      accessPath: opts.accessPath ?? null
     },
     recognition: opts.recognition
   };
 }
 
+// src/rawSql.ts
+import { readSqlAccess, sqlFromParts } from "@suss/sql";
+function rawSqlEffects(calls, options) {
+  if (options.patterns.length === 0) {
+    return [];
+  }
+  const effects = [];
+  for (const call of calls) {
+    const pattern = patternFor(call, options);
+    if (pattern === void 0) {
+      continue;
+    }
+    const statement = statementIn(call);
+    if (statement === null) {
+      continue;
+    }
+    for (const access of readSqlAccess(statement, {
+      dialect: pattern.storageSystem
+    })) {
+      effects.push({
+        type: "interaction",
+        binding: storageBinding({
+          recognition: `python-${pattern.module}`,
+          storageSystem: pattern.storageSystem,
+          scope: pattern.module,
+          container: access.table
+        }),
+        callee: field(call, "function")?.text ?? "",
+        interaction: {
+          class: "storage-access",
+          kind: access.kind,
+          fields: access.fields,
+          ...access.selector.length > 0 ? { selector: access.selector } : {},
+          operation: field(call, "function")?.text ?? ""
+        }
+      });
+    }
+  }
+  return effects;
+}
+function patternFor(call, options) {
+  const callee = field(call, "function");
+  if (callee === null || callee.type !== "identifier") {
+    return void 0;
+  }
+  const from = options.facts.facts("pyImportedName").find((row) => String(row[0]) === `${options.filePath}#${callee.text}`);
+  if (from === void 0) {
+    return void 0;
+  }
+  const module = String(from[1]);
+  return options.patterns.find(
+    (pattern) => pattern.module === module && pattern.functions.includes(callee.text)
+  );
+}
+function statementIn(call) {
+  const args = field(call, "arguments");
+  const first = args?.namedChildren.find((child) => child !== null) ?? null;
+  if (first === null || first.type !== "string") {
+    return null;
+  }
+  const parts = [""];
+  for (const child of first.namedChildren) {
+    if (child === null) {
+      continue;
+    }
+    if (child.type === "string_content") {
+      parts[parts.length - 1] += child.text;
+      continue;
+    }
+    if (child.type === "interpolation") {
+      parts.push("");
+    }
+  }
+  const statement = sqlFromParts(parts);
+  return statement.trim() === "" ? null : statement;
+}
+
 // src/facts/resolve.ts
 import { deriveOnDemand, evaluate } from "@suss/datalog";
 
@@ -17116,11 +17208,11 @@ function effectFor(pattern, chain, options) {
   ];
   return {
     type: "interaction",
-    binding: storageRelationalBinding({
+    binding: storageBinding({
       recognition: "python-storage",
       storageSystem: pattern.storageSystem,
       scope: pattern.module,
-      table: chain.subject
+      container: chain.subject
     }),
     callee: chain.last.text,
     interaction: {
@@ -17863,10 +17955,17 @@ function buildRouteUnit(options) {
     () => readReturnAnnotation(definitionNode, enclosingScope, ctx)
   );
   const effects = invocationEffects(definitionNode);
-  const storage = storageLookup === void 0 ? [] : storageEffects(bodyCalls(definitionNode), {
-    ...storageLookup,
-    filePath: storageLookup.factsPath
-  });
+  const storage = storageLookup === void 0 ? [] : [
+    ...storageEffects(bodyCalls(definitionNode), {
+      ...storageLookup,
+      filePath: storageLookup.factsPath
+    }),
+    ...rawSqlEffects(bodyCalls(definitionNode), {
+      facts: storageLookup.facts,
+      filePath: storageLookup.factsPath,
+      patterns: storageLookup.rawSql ?? []
+    })
+  ];
   const perReturn = branchesFromReturns(
     readsReturnedStatus,
     definitionNode,
@@ -19222,6 +19321,7 @@ async function extractPythonProject(options) {
     (pack) => pack.discovery.some((pattern) => pattern.routerComposition !== void 0)
   );
   const storagePatterns = options.packs.flatMap((pack) => pack.storage ?? []);
+  const rawSqlPatterns = options.packs.flatMap((pack) => pack.rawSql ?? []);
   const needsValues = mountsRouters || storagePatterns.length > 0;
   const definitions = /* @__PURE__ */ new Map();
   for (const { file: file2, root, module: moduleBinding } of bound) {
@@ -19251,14 +19351,15 @@ async function extractPythonProject(options) {
       absoluteFile: file2,
       routerIndex,
       gapHandling,
-      ...storagePatterns.length > 0 ? {
+      ...storagePatterns.length > 0 || rawSqlPatterns.length > 0 ? {
         storage: {
           facts: db,
           factsPath: file2,
           patterns: storagePatterns,
           definitionAt: (key) => definitions.get(key),
           couldMatch,
-          leadsToStorage
+          leadsToStorage,
+          rawSql: rawSqlPatterns
         }
       } : {}
     });
@@ -19269,8 +19370,31 @@ async function extractPythonProject(options) {
       emitEntryFact(db, file2, raw.identity.range, raw.identity.name);
     }
   }
+  stampModuleImports(summaries, db, displayPathOf);
   return { summaries, facts: db };
 }
+function stampModuleImports(summaries, db, displayPathOf) {
+  const importsByFile = /* @__PURE__ */ new Map();
+  for (const [from, , to] of db.facts("pyImportResolved")) {
+    if (typeof from !== "string" || typeof to !== "string") {
+      continue;
+    }
+    const key = displayPathOf(from);
+    const seen = importsByFile.get(key) ?? /* @__PURE__ */ new Set();
+    seen.add(displayPathOf(to));
+    importsByFile.set(key, seen);
+  }
+  for (const summary of summaries) {
+    const imports = importsByFile.get(summary.location.file);
+    if (imports === void 0 || imports.size === 0) {
+      continue;
+    }
+    summary.metadata = {
+      ...summary.metadata ?? {},
+      moduleImports: [...imports].sort()
+    };
+  }
+}
 var SKIPPED_DIRECTORIES = /* @__PURE__ */ new Set([
   "__pycache__",
   ".venv",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suss/adapter-python",
-  "version": "0.5.11",
+  "version": "0.7.0",
   "type": "module",
   "description": "Python language adapter for suss — parses source with tree-sitter (WASM), resolves names with a lexical binder, and emits raw extractions for the suss pipeline.",
   "keywords": [
@@ -47,9 +47,10 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@suss/behavioral-ir": "0.5.11",
-    "@suss/datalog": "0.5.11",
-    "@suss/extractor": "0.5.11",
+    "@suss/behavioral-ir": "0.7.0",
+    "@suss/datalog": "0.7.0",
+    "@suss/extractor": "0.7.0",
+    "@suss/sql": "0.7.0",
     "web-tree-sitter": "^0.26.11"
   },
   "devDependencies": {