@c4a/extract 0.5.29-beta.21 → 0.5.29-beta.29

package/bin/c4a-extract-code.js

@@ -13291,6 +13291,41 @@ function createPathMatcher(rules) {
   const isExcluded = rules.exclude.length > 0 ? import_picomatch.default(rules.exclude, { dot: false }) : () => false;
   return (path) => isIncluded(path) && !isExcluded(path);
 }
+// ../core/src/utils/version.ts
+var VERSION_LABEL_REGEX = /^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-(alpha|beta|rc)\.(0|[1-9]\d*))?$/i;
+function encodePrerelease(channel, sequence) {
+  if (!channel) {
+    return 99;
+  }
+  const index = Number.parseInt(sequence ?? "", 10);
+  if (!Number.isInteger(index) || index <= 0 || index > 29) {
+    return null;
+  }
+  switch (channel.toLowerCase()) {
+    case "alpha":
+      return index;
+    case "beta":
+      return 30 + index;
+    case "rc":
+      return 60 + index;
+    default:
+      return null;
+  }
+}
+function encodeVersionLabel(label) {
+  const match = VERSION_LABEL_REGEX.exec(label.trim());
+  if (!match) {
+    return null;
+  }
+  const major = Number.parseInt(match[1] ?? "", 10);
+  const minor = Number.parseInt(match[2] ?? "", 10);
+  const patch = Number.parseInt(match[3] ?? "", 10);
+  const prerelease = encodePrerelease(match[4], match[5]);
+  if (!Number.isInteger(major) || !Number.isInteger(minor) || !Number.isInteger(patch) || prerelease === null) {
+    return null;
+  }
+  return major * 1e6 + minor * 1e4 + patch * 100 + prerelease;
+}
 // ../core/src/constants.ts
 var SCAN_EXCLUDED_DIRS = new Set([
   ".git",
@@ -13494,6 +13529,7 @@ var generateSymbolDiff = (current, previous) => {
 
 // src/codeSnapshot.ts
 var sha256 = (value) => `sha256:${contentHash(value)}`;
+var FALLBACK_VERSION_LABEL = "0.0.1";
 var stableStringify = (value) => {
   if (value === null || typeof value !== "object")
     return JSON.stringify(value);
@@ -13522,6 +13558,32 @@ var jsonl = (rows) => rows.map((row) => JSON.stringify(row)).join(`
 var manifestText = (value) => JSON.stringify(value, null, 2) + `
 `;
 var hasOwn = (value, key) => Object.prototype.hasOwnProperty.call(value, key);
+var canonicalizeCodeVersionLabel = (value) => {
+  const trimmed = value.trim();
+  if (!trimmed || encodeVersionLabel(trimmed) === null)
+    return null;
+  return trimmed.replace(/^v/iu, "").replace(/-(alpha|beta|rc)\./iu, (match) => match.toLowerCase());
+};
+var normalizeDoc = (value) => {
+  if (typeof value !== "string")
+    return;
+  const normalized = value.replace(/\r\n?/gu, `
+`).replace(/[ \t]+$/gmu, "").trim();
+  return normalized.length > 0 ? normalized : undefined;
+};
+var resolveVersion = (label, source2) => {
+  const canonical = typeof label === "string" ? canonicalizeCodeVersionLabel(label) : null;
+  if (canonical) {
+    return { version_label: canonical, version_source: source2 ?? "package-json" };
+  }
+  return { version_label: FALLBACK_VERSION_LABEL, version_source: "fallback-0.0.1" };
+};
+var commonVersionField = (rows, field) => {
+  const values = new Set(rows.map((row) => row[field]));
+  if (values.size === 0)
+    return;
+  return values.size === 1 ? Array.from(values)[0] : "mixed";
+};
 var commonCommit = (rows) => {
   const commits = new Set(rows.digests.map((row) => row.dir_commit).filter((commit) => commit && commit !== "unknown"));
   return commits.size === 1 ? Array.from(commits)[0] : null;
@@ -13544,7 +13606,8 @@ var metaText = (manifest, source2, rows) => {
       dir_commit: digestByModule.get(row.module_path)?.dir_commit ?? "unknown",
       module_content_hash: digestByModule.get(row.module_path)?.module_content_hash ?? "",
       dirty: digestByModule.get(row.module_path)?.dirty ?? false,
-      version_label: row.version_label
+      version_label: row.version_label,
+      version_source: row.version_source
     })),
     snapshot_id: manifest.snapshot_id,
     source_slug: manifest.source_slug,
@@ -13552,6 +13615,8 @@ var metaText = (manifest, source2, rows) => {
     snapshot_content_hash: manifest.snapshot_content_hash,
     toolchain: manifest.toolchain,
     version_policy: source2.version_policy,
+    ...manifest.version_label ? { version_label: manifest.version_label } : {},
+    ...manifest.version_source ? { version_source: manifest.version_source } : {},
     head_commit: manifest.head_commit,
     dirty: manifest.dirty,
     ...manifest.worktree_content_hash ? { worktree_content_hash: manifest.worktree_content_hash } : {}
@@ -13563,7 +13628,14 @@ function flattenSymbols(symbols, packageName, modulePath) {
   const walk = (list) => {
     for (const symbol of list) {
       const { members, ...rest } = symbol;
-      out.push({ ...rest, package: packageName, modulePath });
+      out.push({
+        ...rest,
+        package: packageName,
+        package_name: packageName,
+        symbol_id: symbol.name,
+        modulePath,
+        module_path: modulePath
+      });
       if (members && members.length > 0)
         walk(members);
     }
@@ -13576,35 +13648,80 @@ var buildHashId = (packageName, dirCommit, moduleContentHash, dirty = false) =>
   return sha256(base);
 };
 var buildSourceFileHashId = (packageName, sourceCommit) => sha256(`pkg:${packageName}:${sourceCommit ?? "unknown"}`);
+var buildPackageHashId = (packageName, modulePath, version2, description) => hashStable({ packageName, modulePath, version: version2 ?? null, description: description ?? null });
+var buildEdgeHashId = (edge2, packageName, modulePath, versionLabel) => hashStable({
+  packageName,
+  modulePath,
+  type: edge2.type,
+  from: edge2.from,
+  to: edge2.to,
+  isExternal: edge2.isExternal,
+  grounding: edge2.grounding,
+  source: edge2.source,
+  line: edge2.line ?? null,
+  versionLabel
+});
 var buildDigestData = (input) => {
   const digest = generateDigest(input.extraction);
   const moduleContentHash = hashStable(digest);
   const dirty = input.dirty ?? false;
+  const rawVersionLabel = input.versionLabel !== undefined ? input.versionLabel : input.extraction.package.version;
+  const version2 = resolveVersion(rawVersionLabel, input.versionSource);
+  const doc = normalizeDoc(input.moduleDoc);
   return {
     hash_id: buildHashId(input.extraction.package.name, input.dirCommit, moduleContentHash, dirty),
     module_name: input.moduleName,
     module_path: input.modulePath,
     package_name: input.extraction.package.name,
     dir_commit: input.dirCommit,
-    version_label: input.versionLabel !== undefined ? input.versionLabel : input.extraction.package.version ?? null,
+    ...version2,
     module_content_hash: moduleContentHash,
     dirty,
+    ...doc ? { doc } : {},
     digest
   };
 };
-var packageRowFor = (result) => ({
-  name: result.extraction.package.name,
-  kind: result.extraction.package.kind,
-  language: result.extraction.package.language,
-  modulePath: result.module.path,
-  ...result.extraction.package.version ? { version: result.extraction.package.version } : {}
-});
-var edgeRowsFor = (result) => result.extraction.relations.map((edge2) => ({
+var packageDescriptionFor = (result) => {
+  const packageManifest = result.sourceInfo.manifests.find((manifest) => manifest.type === "package.json");
+  const content = packageManifest?.content;
+  if (!content || typeof content !== "object" || Array.isArray(content))
+    return;
+  return normalizeDoc(content.description);
+};
+var packageRowFor = (result) => {
+  const version2 = result.extraction.package.version;
+  const description = packageDescriptionFor(result);
+  return {
+    name: result.extraction.package.name,
+    kind: result.extraction.package.kind,
+    language: result.extraction.package.language,
+    modulePath: result.module.path,
+    hash_id: buildPackageHashId(result.extraction.package.name, result.module.path, version2, description),
+    ...version2 ? { version: version2 } : {},
+    ...description ? { description } : {}
+  };
+};
+var edgeRowsFor = (result, versionLabel) => result.extraction.relations.map((edge2) => ({
   ...edge2,
   package: result.extraction.package.name,
-  modulePath: result.module.path
+  package_name: result.extraction.package.name,
+  modulePath: result.module.path,
+  module_path: result.module.path,
+  version_label: versionLabel,
+  hash_id: buildEdgeHashId(edge2, result.extraction.package.name, result.module.path, versionLabel)
 }));
 var byteLength = (value) => Buffer.byteLength(value, "utf-8");
+var edgeSortKey = (edge2) => [
+  edge2.modulePath,
+  edge2.from,
+  edge2.type,
+  edge2.to,
+  edge2.line == null ? "" : String(edge2.line).padStart(12, "0"),
+  edge2.source,
+  edge2.grounding,
+  String(edge2.isExternal),
+  edge2.hash_id
+].join("\x00");
 var buildCodeSnapshot = (input) => {
   const capturedAt = input.capturedAt ?? new Date().toISOString();
   const rows = {
@@ -13617,6 +13734,7 @@ var buildCodeSnapshot = (input) => {
   for (const result of input.results) {
     const dirCommit = input.dirCommits?.[result.module.path] ?? result.extraction.meta.commitHash ?? "unknown";
     const versionLabel = input.versionLabels && hasOwn(input.versionLabels, result.module.path) ? input.versionLabels[result.module.path] ?? null : result.extraction.package.version ?? null;
+    const versionSource = input.versionSources && hasOwn(input.versionSources, result.module.path) ? input.versionSources[result.module.path] : undefined;
     const dirty2 = input.dirtyModules?.[result.module.path] ?? false;
     const digestRow = buildDigestData({
       moduleName: result.module.name,
@@ -13624,11 +13742,13 @@ var buildCodeSnapshot = (input) => {
       extraction: result.extraction,
       dirCommit,
       versionLabel,
+      ...versionSource ? { versionSource } : {},
+      ...result.moduleDoc ? { moduleDoc: result.moduleDoc } : {},
       dirty: dirty2
     });
     rows.packages.push(packageRowFor(result));
     rows.symbols.push(...flattenSymbols(result.extraction.symbols, result.extraction.package.name, result.module.path));
-    rows.edges.push(...edgeRowsFor(result));
+    rows.edges.push(...edgeRowsFor(result, digestRow.version_label));
     rows.digests.push(digestRow);
     rows.sourceFiles.push({
       source_id: input.sourceId,
@@ -13636,6 +13756,7 @@ var buildCodeSnapshot = (input) => {
       hash_id: buildSourceFileHashId(result.extraction.package.name, input.sourceCommit),
       digest_hash_id: digestRow.hash_id,
       version_label: digestRow.version_label,
+      version_source: digestRow.version_source,
       branch: null,
       package_name: result.extraction.package.name,
       module_path: result.module.path
@@ -13643,7 +13764,7 @@ var buildCodeSnapshot = (input) => {
   }
   rows.packages.sort((left, right) => left.modulePath.localeCompare(right.modulePath));
   rows.symbols.sort((left, right) => `${left.modulePath}:${left.name}:${left.file}:${left.line}`.localeCompare(`${right.modulePath}:${right.name}:${right.file}:${right.line}`));
-  rows.edges.sort((left, right) => `${left.modulePath}:${left.from}:${left.type}:${left.to}`.localeCompare(`${right.modulePath}:${right.from}:${right.type}:${right.to}`));
+  rows.edges.sort((left, right) => edgeSortKey(left).localeCompare(edgeSortKey(right)));
   rows.digests.sort((left, right) => left.module_path.localeCompare(right.module_path));
   rows.sourceFiles.sort((left, right) => left.module_path.localeCompare(right.module_path));
   const sourceHashInput = {
@@ -13669,6 +13790,14 @@ var buildCodeSnapshot = (input) => {
     version_policy: input.versionPolicy ?? "package-version",
     captured_at: capturedAt
   };
+  const commonVersionLabel = commonVersionField(rows.digests, "version_label");
+  const commonVersionSource = commonVersionField(rows.digests, "version_source");
+  if (commonVersionLabel && commonVersionLabel !== "mixed") {
+    source2.version_label = commonVersionLabel;
+  }
+  if (commonVersionSource) {
+    source2.version_source = commonVersionSource;
+  }
   const files = {
     "source.yaml": manifestText(source2),
     "digests.jsonl": jsonl(rows.digests),
@@ -13689,6 +13818,8 @@ var buildCodeSnapshot = (input) => {
     script_hash: input.scriptHash,
     toolchain: input.toolchain,
     version_policy: source2.version_policy,
+    ...source2.version_label ? { version_label: source2.version_label } : {},
+    ...source2.version_source ? { version_source: source2.version_source } : {},
     snapshot_content_hash: snapshotContentHash,
     ...input.worktreeContentHash ? { worktree_content_hash: input.worktreeContentHash } : {},
     module_count: rows.packages.length,
@@ -14173,6 +14304,25 @@ var normalizeExtractionPaths = (extraction, entryDetection, modulePath, commitHa
   entryDetection: prefixEntryDetectionPaths(entryDetection, modulePath),
   extraction: prefixExtractionPaths(extraction, modulePath, commitHash)
 });
+var extractLeadingJsDoc = (source2) => {
+  const match = source2.match(/^\s*\/\*\*([\s\S]*?)\*\//u);
+  if (!match?.[1])
+    return;
+  const doc = match[1].replace(/^\s*\* ?/gmu, "").replace(/\r\n?/gu, `
+`).replace(/[ \t]+$/gmu, "").trim();
+  return doc.length > 0 ? doc : undefined;
+};
+var extractModuleDoc = async (entryDetection, fs) => {
+  const entries = [...entryDetection.entries].sort((left, right) => left.path.localeCompare(right.path));
+  for (const entry of entries) {
+    try {
+      const doc = extractLeadingJsDoc(await fs.readFile(entry.path));
+      if (doc)
+        return doc;
+    } catch {}
+  }
+  return;
+};
 var noModuleError = (modulePath, repoPath) => ({
   module_name: modulePath,
   module_path: modulePath,
@@ -14238,6 +14388,7 @@ var runRepositoryExtraction = async (input) => {
     });
     const entryDetection = await plugin.detectEntries(manifest, fs);
     input.onProgress?.({ phase: "parsing", progress: 20, module_name: module.name, module_path: module.path });
+    const moduleDoc = await extractModuleDoc(entryDetection, fs);
     const rawExtraction = await plugin.extractSymbols(entryDetection.entries, fs);
     const commitHash = input.moduleCommits?.[module.path] ?? input.commitHash ?? rawExtraction.meta.commitHash ?? null;
     const normalized = normalizeExtractionPaths(rawExtraction, entryDetection, module.path, commitHash);
@@ -14246,6 +14397,7 @@ var runRepositoryExtraction = async (input) => {
       module,
       sourceInfo,
       entryDetection: normalized.entryDetection,
+      ...moduleDoc ? { moduleDoc } : {},
       extraction: normalized.extraction
     });
   }

package/index.js

@@ -15031,6 +15031,41 @@ function createPathMatcher(rules) {
   const isExcluded = rules.exclude.length > 0 ? import_picomatch.default(rules.exclude, { dot: false }) : () => false;
   return (path) => isIncluded(path) && !isExcluded(path);
 }
+// ../core/src/utils/version.ts
+var VERSION_LABEL_REGEX = /^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-(alpha|beta|rc)\.(0|[1-9]\d*))?$/i;
+function encodePrerelease(channel, sequence) {
+  if (!channel) {
+    return 99;
+  }
+  const index = Number.parseInt(sequence ?? "", 10);
+  if (!Number.isInteger(index) || index <= 0 || index > 29) {
+    return null;
+  }
+  switch (channel.toLowerCase()) {
+    case "alpha":
+      return index;
+    case "beta":
+      return 30 + index;
+    case "rc":
+      return 60 + index;
+    default:
+      return null;
+  }
+}
+function encodeVersionLabel(label) {
+  const match = VERSION_LABEL_REGEX.exec(label.trim());
+  if (!match) {
+    return null;
+  }
+  const major = Number.parseInt(match[1] ?? "", 10);
+  const minor = Number.parseInt(match[2] ?? "", 10);
+  const patch = Number.parseInt(match[3] ?? "", 10);
+  const prerelease = encodePrerelease(match[4], match[5]);
+  if (!Number.isInteger(major) || !Number.isInteger(minor) || !Number.isInteger(patch) || prerelease === null) {
+    return null;
+  }
+  return major * 1e6 + minor * 1e4 + patch * 100 + prerelease;
+}
 // ../core/src/constants.ts
 var SCAN_EXCLUDED_DIRS = new Set([
   ".git",
@@ -15847,6 +15882,25 @@ var normalizeExtractionPaths = (extraction, entryDetection, modulePath, commitHa
   entryDetection: prefixEntryDetectionPaths(entryDetection, modulePath),
   extraction: prefixExtractionPaths(extraction, modulePath, commitHash)
 });
+var extractLeadingJsDoc = (source2) => {
+  const match = source2.match(/^\s*\/\*\*([\s\S]*?)\*\//u);
+  if (!match?.[1])
+    return;
+  const doc = match[1].replace(/^\s*\* ?/gmu, "").replace(/\r\n?/gu, `
+`).replace(/[ \t]+$/gmu, "").trim();
+  return doc.length > 0 ? doc : undefined;
+};
+var extractModuleDoc = async (entryDetection, fs2) => {
+  const entries = [...entryDetection.entries].sort((left, right) => left.path.localeCompare(right.path));
+  for (const entry of entries) {
+    try {
+      const doc = extractLeadingJsDoc(await fs2.readFile(entry.path));
+      if (doc)
+        return doc;
+    } catch {}
+  }
+  return;
+};
 var noModuleError = (modulePath, repoPath) => ({
   module_name: modulePath,
   module_path: modulePath,
@@ -15912,6 +15966,7 @@ var runRepositoryExtraction = async (input) => {
     });
     const entryDetection = await plugin.detectEntries(manifest, fs2);
     input.onProgress?.({ phase: "parsing", progress: 20, module_name: module2.name, module_path: module2.path });
+    const moduleDoc = await extractModuleDoc(entryDetection, fs2);
     const rawExtraction = await plugin.extractSymbols(entryDetection.entries, fs2);
     const commitHash = input.moduleCommits?.[module2.path] ?? input.commitHash ?? rawExtraction.meta.commitHash ?? null;
     const normalized = normalizeExtractionPaths(rawExtraction, entryDetection, module2.path, commitHash);
@@ -15920,6 +15975,7 @@ var runRepositoryExtraction = async (input) => {
       module: module2,
       sourceInfo,
       entryDetection: normalized.entryDetection,
+      ...moduleDoc ? { moduleDoc } : {},
       extraction: normalized.extraction
     });
   }
@@ -15927,6 +15983,7 @@ var runRepositoryExtraction = async (input) => {
 };
 // src/codeSnapshot.ts
 var sha256 = (value) => `sha256:${contentHash(value)}`;
+var FALLBACK_VERSION_LABEL = "0.0.1";
 var stableStringify = (value) => {
   if (value === null || typeof value !== "object")
     return JSON.stringify(value);
@@ -15955,6 +16012,32 @@ var jsonl = (rows) => rows.map((row) => JSON.stringify(row)).join(`
 var manifestText = (value) => JSON.stringify(value, null, 2) + `
 `;
 var hasOwn = (value, key) => Object.prototype.hasOwnProperty.call(value, key);
+var canonicalizeCodeVersionLabel = (value) => {
+  const trimmed = value.trim();
+  if (!trimmed || encodeVersionLabel(trimmed) === null)
+    return null;
+  return trimmed.replace(/^v/iu, "").replace(/-(alpha|beta|rc)\./iu, (match) => match.toLowerCase());
+};
+var normalizeDoc = (value) => {
+  if (typeof value !== "string")
+    return;
+  const normalized = value.replace(/\r\n?/gu, `
+`).replace(/[ \t]+$/gmu, "").trim();
+  return normalized.length > 0 ? normalized : undefined;
+};
+var resolveVersion = (label, source2) => {
+  const canonical = typeof label === "string" ? canonicalizeCodeVersionLabel(label) : null;
+  if (canonical) {
+    return { version_label: canonical, version_source: source2 ?? "package-json" };
+  }
+  return { version_label: FALLBACK_VERSION_LABEL, version_source: "fallback-0.0.1" };
+};
+var commonVersionField = (rows, field) => {
+  const values = new Set(rows.map((row) => row[field]));
+  if (values.size === 0)
+    return;
+  return values.size === 1 ? Array.from(values)[0] : "mixed";
+};
 var commonCommit = (rows) => {
   const commits = new Set(rows.digests.map((row) => row.dir_commit).filter((commit) => commit && commit !== "unknown"));
   return commits.size === 1 ? Array.from(commits)[0] : null;
@@ -15977,7 +16060,8 @@ var metaText = (manifest, source2, rows) => {
       dir_commit: digestByModule.get(row.module_path)?.dir_commit ?? "unknown",
       module_content_hash: digestByModule.get(row.module_path)?.module_content_hash ?? "",
       dirty: digestByModule.get(row.module_path)?.dirty ?? false,
-      version_label: row.version_label
+      version_label: row.version_label,
+      version_source: row.version_source
     })),
     snapshot_id: manifest.snapshot_id,
     source_slug: manifest.source_slug,
@@ -15985,6 +16069,8 @@ var metaText = (manifest, source2, rows) => {
     snapshot_content_hash: manifest.snapshot_content_hash,
     toolchain: manifest.toolchain,
     version_policy: source2.version_policy,
+    ...manifest.version_label ? { version_label: manifest.version_label } : {},
+    ...manifest.version_source ? { version_source: manifest.version_source } : {},
     head_commit: manifest.head_commit,
     dirty: manifest.dirty,
     ...manifest.worktree_content_hash ? { worktree_content_hash: manifest.worktree_content_hash } : {}
@@ -15996,7 +16082,14 @@ function flattenSymbols(symbols, packageName, modulePath) {
   const walk = (list) => {
     for (const symbol of list) {
       const { members, ...rest } = symbol;
-      out2.push({ ...rest, package: packageName, modulePath });
+      out2.push({
+        ...rest,
+        package: packageName,
+        package_name: packageName,
+        symbol_id: symbol.name,
+        modulePath,
+        module_path: modulePath
+      });
       if (members && members.length > 0)
         walk(members);
     }
@@ -16009,35 +16102,80 @@ var buildHashId = (packageName, dirCommit, moduleContentHash, dirty = false) =>
   return sha256(base);
 };
 var buildSourceFileHashId = (packageName, sourceCommit) => sha256(`pkg:${packageName}:${sourceCommit ?? "unknown"}`);
+var buildPackageHashId = (packageName, modulePath, version2, description) => hashStable({ packageName, modulePath, version: version2 ?? null, description: description ?? null });
+var buildEdgeHashId = (edge2, packageName, modulePath, versionLabel) => hashStable({
+  packageName,
+  modulePath,
+  type: edge2.type,
+  from: edge2.from,
+  to: edge2.to,
+  isExternal: edge2.isExternal,
+  grounding: edge2.grounding,
+  source: edge2.source,
+  line: edge2.line ?? null,
+  versionLabel
+});
 var buildDigestData = (input) => {
   const digest = generateDigest(input.extraction);
   const moduleContentHash = hashStable(digest);
   const dirty = input.dirty ?? false;
+  const rawVersionLabel = input.versionLabel !== undefined ? input.versionLabel : input.extraction.package.version;
+  const version2 = resolveVersion(rawVersionLabel, input.versionSource);
+  const doc = normalizeDoc(input.moduleDoc);
   return {
     hash_id: buildHashId(input.extraction.package.name, input.dirCommit, moduleContentHash, dirty),
     module_name: input.moduleName,
     module_path: input.modulePath,
     package_name: input.extraction.package.name,
     dir_commit: input.dirCommit,
-    version_label: input.versionLabel !== undefined ? input.versionLabel : input.extraction.package.version ?? null,
+    ...version2,
     module_content_hash: moduleContentHash,
     dirty,
+    ...doc ? { doc } : {},
     digest
   };
 };
-var packageRowFor = (result) => ({
-  name: result.extraction.package.name,
-  kind: result.extraction.package.kind,
-  language: result.extraction.package.language,
-  modulePath: result.module.path,
-  ...result.extraction.package.version ? { version: result.extraction.package.version } : {}
-});
-var edgeRowsFor = (result) => result.extraction.relations.map((edge2) => ({
+var packageDescriptionFor = (result) => {
+  const packageManifest = result.sourceInfo.manifests.find((manifest) => manifest.type === "package.json");
+  const content = packageManifest?.content;
+  if (!content || typeof content !== "object" || Array.isArray(content))
+    return;
+  return normalizeDoc(content.description);
+};
+var packageRowFor = (result) => {
+  const version2 = result.extraction.package.version;
+  const description = packageDescriptionFor(result);
+  return {
+    name: result.extraction.package.name,
+    kind: result.extraction.package.kind,
+    language: result.extraction.package.language,
+    modulePath: result.module.path,
+    hash_id: buildPackageHashId(result.extraction.package.name, result.module.path, version2, description),
+    ...version2 ? { version: version2 } : {},
+    ...description ? { description } : {}
+  };
+};
+var edgeRowsFor = (result, versionLabel) => result.extraction.relations.map((edge2) => ({
   ...edge2,
   package: result.extraction.package.name,
-  modulePath: result.module.path
+  package_name: result.extraction.package.name,
+  modulePath: result.module.path,
+  module_path: result.module.path,
+  version_label: versionLabel,
+  hash_id: buildEdgeHashId(edge2, result.extraction.package.name, result.module.path, versionLabel)
 }));
 var byteLength = (value) => Buffer.byteLength(value, "utf-8");
+var edgeSortKey = (edge2) => [
+  edge2.modulePath,
+  edge2.from,
+  edge2.type,
+  edge2.to,
+  edge2.line == null ? "" : String(edge2.line).padStart(12, "0"),
+  edge2.source,
+  edge2.grounding,
+  String(edge2.isExternal),
+  edge2.hash_id
+].join("\x00");
 var buildCodeSnapshot = (input) => {
   const capturedAt = input.capturedAt ?? new Date().toISOString();
   const rows = {
@@ -16050,6 +16188,7 @@ var buildCodeSnapshot = (input) => {
   for (const result of input.results) {
     const dirCommit = input.dirCommits?.[result.module.path] ?? result.extraction.meta.commitHash ?? "unknown";
     const versionLabel = input.versionLabels && hasOwn(input.versionLabels, result.module.path) ? input.versionLabels[result.module.path] ?? null : result.extraction.package.version ?? null;
+    const versionSource = input.versionSources && hasOwn(input.versionSources, result.module.path) ? input.versionSources[result.module.path] : undefined;
     const dirty2 = input.dirtyModules?.[result.module.path] ?? false;
     const digestRow = buildDigestData({
       moduleName: result.module.name,
@@ -16057,11 +16196,13 @@ var buildCodeSnapshot = (input) => {
       extraction: result.extraction,
       dirCommit,
       versionLabel,
+      ...versionSource ? { versionSource } : {},
+      ...result.moduleDoc ? { moduleDoc: result.moduleDoc } : {},
       dirty: dirty2
     });
     rows.packages.push(packageRowFor(result));
     rows.symbols.push(...flattenSymbols(result.extraction.symbols, result.extraction.package.name, result.module.path));
-    rows.edges.push(...edgeRowsFor(result));
+    rows.edges.push(...edgeRowsFor(result, digestRow.version_label));
     rows.digests.push(digestRow);
     rows.sourceFiles.push({
       source_id: input.sourceId,
@@ -16069,6 +16210,7 @@ var buildCodeSnapshot = (input) => {
       hash_id: buildSourceFileHashId(result.extraction.package.name, input.sourceCommit),
       digest_hash_id: digestRow.hash_id,
       version_label: digestRow.version_label,
+      version_source: digestRow.version_source,
       branch: null,
       package_name: result.extraction.package.name,
       module_path: result.module.path
@@ -16076,7 +16218,7 @@ var buildCodeSnapshot = (input) => {
   }
   rows.packages.sort((left, right) => left.modulePath.localeCompare(right.modulePath));
   rows.symbols.sort((left, right) => `${left.modulePath}:${left.name}:${left.file}:${left.line}`.localeCompare(`${right.modulePath}:${right.name}:${right.file}:${right.line}`));
-  rows.edges.sort((left, right) => `${left.modulePath}:${left.from}:${left.type}:${left.to}`.localeCompare(`${right.modulePath}:${right.from}:${right.type}:${right.to}`));
+  rows.edges.sort((left, right) => edgeSortKey(left).localeCompare(edgeSortKey(right)));
   rows.digests.sort((left, right) => left.module_path.localeCompare(right.module_path));
   rows.sourceFiles.sort((left, right) => left.module_path.localeCompare(right.module_path));
   const sourceHashInput = {
@@ -16102,6 +16244,14 @@ var buildCodeSnapshot = (input) => {
     version_policy: input.versionPolicy ?? "package-version",
     captured_at: capturedAt
   };
+  const commonVersionLabel = commonVersionField(rows.digests, "version_label");
+  const commonVersionSource = commonVersionField(rows.digests, "version_source");
+  if (commonVersionLabel && commonVersionLabel !== "mixed") {
+    source2.version_label = commonVersionLabel;
+  }
+  if (commonVersionSource) {
+    source2.version_source = commonVersionSource;
+  }
   const files = {
     "source.yaml": manifestText(source2),
     "digests.jsonl": jsonl(rows.digests),
@@ -16122,6 +16272,8 @@ var buildCodeSnapshot = (input) => {
     script_hash: input.scriptHash,
     toolchain: input.toolchain,
     version_policy: source2.version_policy,
+    ...source2.version_label ? { version_label: source2.version_label } : {},
+    ...source2.version_source ? { version_source: source2.version_source } : {},
     snapshot_content_hash: snapshotContentHash,
     ...input.worktreeContentHash ? { worktree_content_hash: input.worktreeContentHash } : {},
     module_count: rows.packages.length,
@@ -16445,8 +16597,11 @@ export {
   detectModuleAt,
   createModuleFileSystem,
   codeExtractRunnerInputSchema,
+  canonicalizeCodeVersionLabel,
   buildSourceFileHashId,
+  buildPackageHashId,
   buildHashId,
+  buildEdgeHashId,
   buildDigestData,
   buildCodeSnapshot,
   SCAN_EXCLUDED_DIRS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/extract",
-  "version": "0.5.29-beta.21",
+  "version": "0.5.29-beta.29",
   "type": "module",
   "bin": {
     "c4a-extract-code": "./bin/c4a-extract-code.js"