@c4a/extract 0.6.4 → 0.6.5

package/README.md

@@ -25,6 +25,7 @@ interface ExtractionPlugin {
   id: string;
   languages: string[];
   packageManagers: string[];
+  manifestTypes?: ManifestInfo["type"][];
   canHandle(source: SourceInfo): boolean;
   detectEntries(manifest: ManifestInfo, fs: FileSystem): Promise<EntryDetectionResult>;
   extractSymbols(entries: EntryFile[], fs: FileSystem): Promise<ExtractionResult>;
@@ -35,6 +36,9 @@ interface ExtractionPlugin {
 Important constraints:
 
 - Plugins read through `FileSystem`; they should not access `node:fs` directly.
+- `manifestTypes` declares which manifest is passed to `detectEntries()`. It is
+  optional for a single-manifest module and required when a plugin accepts a
+  module containing multiple manifest types.
 - `detectEntries()` must return package identity, package kind, language, optional version, and entry files.
 - `extractSymbols()` must return `ExtractionResult` v2 with stable symbols and relations.
 - `detectEntries()` is called before `extractSymbols()`; plugins may keep per-detection package context between those calls.
@@ -171,6 +175,7 @@ export class PythonPlugin implements ExtractionPlugin {
   readonly id = "c4a-extract-python";
   readonly languages = ["python"];
   readonly packageManagers = ["pip"];
+  readonly manifestTypes: ManifestInfo["type"][] = ["pyproject.toml"];
 
   canHandle(source: SourceInfo): boolean {
     return source.manifests.some((manifest) => manifest.type === "pyproject.toml");

package/bin/c4a-extract-code.js

@@ -14284,12 +14284,22 @@ var loadSourceInfo = async (modulePath, fs) => {
       content: { raw: await fs.readFile(GO_MOD) }
     });
   }
+  const detectedLanguages = [
+    ...manifests.some((manifest) => manifest.type === GO_MOD) ? ["go"] : [],
+    ...manifests.some((manifest) => manifest.type === PACKAGE_JSON) ? ["typescript"] : []
+  ];
   return {
     path: normalizeRelativePath(modulePath),
     manifests,
-    ...manifests.some((manifest) => manifest.type === GO_MOD) ? { language: "go" } : manifests.some((manifest) => manifest.type === PACKAGE_JSON) ? { language: "typescript" } : {}
+    ...detectedLanguages.length === 1 ? { language: detectedLanguages[0] } : {}
   };
 };
+function manifestForPlugin(source, plugin) {
+  if (plugin.manifestTypes !== undefined) {
+    return source.manifests.find((manifest) => plugin.manifestTypes?.includes(manifest.type));
+  }
+  return source.manifests.length === 1 ? source.manifests[0] : undefined;
+}
 var prefixSymbolPaths = (symbol, modulePath) => ({
   ...symbol,
   ...symbol.file.trim() ? { file: resolveRepoRelativePath(modulePath, symbol.file) } : {},
@@ -14386,12 +14396,12 @@ var runRepositoryExtraction = async (input) => {
       });
       continue;
     }
-    const manifest = sourceInfo.manifests.find((candidate) => candidate.type === PACKAGE_JSON) ?? sourceInfo.manifests[0];
+    const manifest = manifestForPlugin(sourceInfo, plugin);
     if (!manifest) {
       moduleErrors.push({
         module_name: module.name,
         module_path: module.path,
-        error: `Module "${module.name}" has no supported manifest for extraction`
+        error: plugin.manifestTypes === undefined && sourceInfo.manifests.length > 1 ? `Extraction plugin "${plugin.id}" must declare manifestTypes for mixed-manifest module "${module.name}"` : `Module "${module.name}" has no manifest supported by extraction plugin "${plugin.id}"`
       });
       continue;
     }

package/index.js

@@ -14891,12 +14891,22 @@ var loadSourceInfo = async (modulePath, fs) => {
       content: { raw: await fs.readFile(GO_MOD) }
     });
   }
+  const detectedLanguages = [
+    ...manifests.some((manifest) => manifest.type === GO_MOD) ? ["go"] : [],
+    ...manifests.some((manifest) => manifest.type === PACKAGE_JSON) ? ["typescript"] : []
+  ];
   return {
     path: normalizeRelativePath(modulePath),
     manifests,
-    ...manifests.some((manifest) => manifest.type === GO_MOD) ? { language: "go" } : manifests.some((manifest) => manifest.type === PACKAGE_JSON) ? { language: "typescript" } : {}
+    ...detectedLanguages.length === 1 ? { language: detectedLanguages[0] } : {}
   };
 };
+function manifestForPlugin(source, plugin) {
+  if (plugin.manifestTypes !== undefined) {
+    return source.manifests.find((manifest) => plugin.manifestTypes?.includes(manifest.type));
+  }
+  return source.manifests.length === 1 ? source.manifests[0] : undefined;
+}
 var prefixSymbolPaths = (symbol, modulePath) => ({
   ...symbol,
   ...symbol.file.trim() ? { file: resolveRepoRelativePath(modulePath, symbol.file) } : {},
@@ -14993,12 +15003,12 @@ var runRepositoryExtraction = async (input) => {
       });
       continue;
     }
-    const manifest = sourceInfo.manifests.find((candidate) => candidate.type === PACKAGE_JSON) ?? sourceInfo.manifests[0];
+    const manifest = manifestForPlugin(sourceInfo, plugin);
     if (!manifest) {
       moduleErrors.push({
         module_name: module.name,
         module_path: module.path,
-        error: `Module "${module.name}" has no supported manifest for extraction`
+        error: plugin.manifestTypes === undefined && sourceInfo.manifests.length > 1 ? `Extraction plugin "${plugin.id}" must declare manifestTypes for mixed-manifest module "${module.name}"` : `Module "${module.name}" has no manifest supported by extraction plugin "${plugin.id}"`
       });
       continue;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/extract",
-  "version": "0.6.4",
+  "version": "0.6.5",
   "type": "module",
   "description": "Code extraction engine — Tree-sitter AST parsing and structural analysis",
   "license": "MIT",