@c4a/extract 0.5.33-alpha.3 → 0.5.33-alpha.4

package/bin/c4a-extract-code.js

@@ -13557,6 +13557,90 @@ var jsonl = (rows) => rows.map((row) => JSON.stringify(row)).join(`
 ` : "");
 var manifestText = (value) => JSON.stringify(value, null, 2) + `
 `;
+var buildCodeSymbolLocator = (packageName, symbolId, symbol) => `${packageName}:${symbolId}:${symbol.kind}:${symbol.file}:${symbol.line}-${symbol.endLine}`;
+var buildCodeSymbolIdentityKey = (packageName, rootSymbolId, symbolId, kind, hasParent) => hasParent ? `${packageName}|root:${rootSymbolId}|owned:${symbolId}|${kind}` : `${packageName}|root:${symbolId}|${kind}`;
+function applyCodeSymbolIdentity(symbol, context) {
+  const segment = symbol.name;
+  const symbolId = symbol.symbol_id ?? (context.parentSymbolId ? `${context.parentSymbolId}.${segment}` : segment);
+  const rootSymbolId = symbol.root_symbol_id ?? context.rootSymbolId ?? symbolId;
+  const memberPath = symbol.member_path ?? [...context.parentPath ?? [], segment];
+  const hasParent = context.parentSymbolId !== undefined || symbol.parent_symbol_id !== undefined;
+  const parentSymbolId = symbol.parent_symbol_id ?? context.parentSymbolId;
+  const members = symbol.members?.map((member) => applyCodeSymbolIdentity(member, {
+    packageName: context.packageName,
+    parentSymbolId: symbolId,
+    rootSymbolId,
+    parentPath: memberPath
+  }));
+  return {
+    ...symbol,
+    symbol_id: symbolId,
+    identity_key: symbol.identity_key ?? buildCodeSymbolIdentityKey(context.packageName, rootSymbolId, symbolId, symbol.kind, hasParent),
+    display_name: symbol.display_name ?? symbol.name,
+    member_path: memberPath,
+    root_symbol_id: rootSymbolId,
+    ...parentSymbolId !== undefined ? { parent_symbol_id: parentSymbolId } : {},
+    symbol_locator: symbol.symbol_locator ?? buildCodeSymbolLocator(context.packageName, symbolId, symbol),
+    ...members && members.length > 0 ? { members } : {}
+  };
+}
+function applySymbolIdentities(symbols, packageName) {
+  return symbols.map((symbol) => applyCodeSymbolIdentity(symbol, { packageName }));
+}
+function assertIdentityApplied(symbol) {
+  if (!symbol.symbol_id || !symbol.identity_key || !symbol.display_name || !symbol.root_symbol_id || !symbol.symbol_locator || !symbol.member_path || symbol.member_path.length === 0) {
+    throw new Error(`flattenSymbols requires applied code symbol identity fields for "${symbol.name}"`);
+  }
+}
+var buildSymbolHashId = (packageName, modulePath, symbol, symbolId, identityKey, locator) => hashStable({
+  packageName,
+  modulePath,
+  symbolId,
+  identityKey,
+  locator,
+  name: symbol.name,
+  kind: symbol.kind,
+  visibility: symbol.visibility,
+  file: symbol.file,
+  line: symbol.line,
+  endLine: symbol.endLine,
+  params: symbol.params ?? null,
+  returnType: symbol.returnType ?? null,
+  typeAnnotation: symbol.typeAnnotation ?? null,
+  extends: symbol.extends ?? null,
+  implements: symbol.implements ?? null,
+  doc: symbol.doc ?? null,
+  propsType: symbol.propsType ?? null,
+  unionValues: symbol.unionValues ?? null
+});
+function flattenSymbols(symbols, packageName, modulePath) {
+  const out = [];
+  const walk = (list) => {
+    for (const symbol of list) {
+      assertIdentityApplied(symbol);
+      const { members, ...rest } = symbol;
+      out.push({
+        ...rest,
+        package: packageName,
+        package_name: packageName,
+        symbol_id: symbol.symbol_id,
+        identity_key: symbol.identity_key,
+        display_name: symbol.display_name,
+        member_path: symbol.member_path,
+        root_symbol_id: symbol.root_symbol_id,
+        symbol_locator: symbol.symbol_locator,
+        hash_id: buildSymbolHashId(packageName, modulePath, rest, symbol.symbol_id, symbol.identity_key, symbol.symbol_locator),
+        ...symbol.parent_symbol_id !== undefined ? { parent_symbol_id: symbol.parent_symbol_id } : {},
+        modulePath,
+        module_path: modulePath
+      });
+      if (members && members.length > 0)
+        walk(members);
+    }
+  };
+  walk(symbols);
+  return out;
+}
 var hasOwn = (value, key) => Object.prototype.hasOwnProperty.call(value, key);
 var canonicalizeCodeVersionLabel = (value) => {
   const trimmed = value.trim();
@@ -13623,26 +13707,6 @@ var metaText = (manifest, source2, rows) => {
   };
   return manifestText(meta);
 };
-function flattenSymbols(symbols, packageName, modulePath) {
-  const out = [];
-  const walk = (list) => {
-    for (const symbol of list) {
-      const { members, ...rest } = symbol;
-      out.push({
-        ...rest,
-        package: packageName,
-        package_name: packageName,
-        symbol_id: symbol.name,
-        modulePath,
-        module_path: modulePath
-      });
-      if (members && members.length > 0)
-        walk(members);
-    }
-  };
-  walk(symbols);
-  return out;
-}
 var buildHashId = (packageName, dirCommit, moduleContentHash, dirty = false) => {
   const base = dirty && moduleContentHash ? `pkg:${packageName}:${dirCommit}:dirty:${moduleContentHash}` : `pkg:${packageName}:${dirCommit}`;
   return sha256(base);

package/index.js

@@ -15248,6 +15248,10 @@ var symbolParamSchema = exports_external.object({
   name: exports_external.string().min(1),
   type: exports_external.string().min(1).nullable()
 });
+var symbolRenameEvidenceSchema = exports_external.object({
+  previous_identity_key: exports_external.string().min(1),
+  reason: exports_external.string().min(1)
+});
 var symbolInfoSchema = exports_external.lazy(() => exports_external.object({
   name: exports_external.string().min(1),
   kind: symbolKindSchema2,
@@ -15255,6 +15259,14 @@ var symbolInfoSchema = exports_external.lazy(() => exports_external.object({
   file: exports_external.string().min(1),
   line: exports_external.number().int().positive(),
   endLine: exports_external.number().int().positive(),
+  symbol_id: exports_external.string().min(1).optional(),
+  identity_key: exports_external.string().min(1).optional(),
+  display_name: exports_external.string().min(1).optional(),
+  member_path: exports_external.array(exports_external.string().min(1)).optional(),
+  root_symbol_id: exports_external.string().min(1).optional(),
+  parent_symbol_id: exports_external.string().min(1).optional(),
+  symbol_locator: exports_external.string().min(1).optional(),
+  rename_evidence: exports_external.array(symbolRenameEvidenceSchema).optional(),
   members: exports_external.array(symbolInfoSchema).optional(),
   params: exports_external.array(symbolParamSchema).optional(),
   returnType: exports_external.string().min(1).nullable().optional(),
@@ -16011,6 +16023,90 @@ var jsonl = (rows) => rows.map((row) => JSON.stringify(row)).join(`
 ` : "");
 var manifestText = (value) => JSON.stringify(value, null, 2) + `
 `;
+var buildCodeSymbolLocator = (packageName, symbolId, symbol) => `${packageName}:${symbolId}:${symbol.kind}:${symbol.file}:${symbol.line}-${symbol.endLine}`;
+var buildCodeSymbolIdentityKey = (packageName, rootSymbolId, symbolId, kind, hasParent) => hasParent ? `${packageName}|root:${rootSymbolId}|owned:${symbolId}|${kind}` : `${packageName}|root:${symbolId}|${kind}`;
+function applyCodeSymbolIdentity(symbol, context) {
+  const segment = symbol.name;
+  const symbolId = symbol.symbol_id ?? (context.parentSymbolId ? `${context.parentSymbolId}.${segment}` : segment);
+  const rootSymbolId = symbol.root_symbol_id ?? context.rootSymbolId ?? symbolId;
+  const memberPath = symbol.member_path ?? [...context.parentPath ?? [], segment];
+  const hasParent = context.parentSymbolId !== undefined || symbol.parent_symbol_id !== undefined;
+  const parentSymbolId = symbol.parent_symbol_id ?? context.parentSymbolId;
+  const members = symbol.members?.map((member) => applyCodeSymbolIdentity(member, {
+    packageName: context.packageName,
+    parentSymbolId: symbolId,
+    rootSymbolId,
+    parentPath: memberPath
+  }));
+  return {
+    ...symbol,
+    symbol_id: symbolId,
+    identity_key: symbol.identity_key ?? buildCodeSymbolIdentityKey(context.packageName, rootSymbolId, symbolId, symbol.kind, hasParent),
+    display_name: symbol.display_name ?? symbol.name,
+    member_path: memberPath,
+    root_symbol_id: rootSymbolId,
+    ...parentSymbolId !== undefined ? { parent_symbol_id: parentSymbolId } : {},
+    symbol_locator: symbol.symbol_locator ?? buildCodeSymbolLocator(context.packageName, symbolId, symbol),
+    ...members && members.length > 0 ? { members } : {}
+  };
+}
+function applySymbolIdentities(symbols, packageName) {
+  return symbols.map((symbol) => applyCodeSymbolIdentity(symbol, { packageName }));
+}
+function assertIdentityApplied(symbol) {
+  if (!symbol.symbol_id || !symbol.identity_key || !symbol.display_name || !symbol.root_symbol_id || !symbol.symbol_locator || !symbol.member_path || symbol.member_path.length === 0) {
+    throw new Error(`flattenSymbols requires applied code symbol identity fields for "${symbol.name}"`);
+  }
+}
+var buildSymbolHashId = (packageName, modulePath, symbol, symbolId, identityKey, locator) => hashStable({
+  packageName,
+  modulePath,
+  symbolId,
+  identityKey,
+  locator,
+  name: symbol.name,
+  kind: symbol.kind,
+  visibility: symbol.visibility,
+  file: symbol.file,
+  line: symbol.line,
+  endLine: symbol.endLine,
+  params: symbol.params ?? null,
+  returnType: symbol.returnType ?? null,
+  typeAnnotation: symbol.typeAnnotation ?? null,
+  extends: symbol.extends ?? null,
+  implements: symbol.implements ?? null,
+  doc: symbol.doc ?? null,
+  propsType: symbol.propsType ?? null,
+  unionValues: symbol.unionValues ?? null
+});
+function flattenSymbols(symbols, packageName, modulePath) {
+  const out2 = [];
+  const walk = (list) => {
+    for (const symbol of list) {
+      assertIdentityApplied(symbol);
+      const { members, ...rest } = symbol;
+      out2.push({
+        ...rest,
+        package: packageName,
+        package_name: packageName,
+        symbol_id: symbol.symbol_id,
+        identity_key: symbol.identity_key,
+        display_name: symbol.display_name,
+        member_path: symbol.member_path,
+        root_symbol_id: symbol.root_symbol_id,
+        symbol_locator: symbol.symbol_locator,
+        hash_id: buildSymbolHashId(packageName, modulePath, rest, symbol.symbol_id, symbol.identity_key, symbol.symbol_locator),
+        ...symbol.parent_symbol_id !== undefined ? { parent_symbol_id: symbol.parent_symbol_id } : {},
+        modulePath,
+        module_path: modulePath
+      });
+      if (members && members.length > 0)
+        walk(members);
+    }
+  };
+  walk(symbols);
+  return out2;
+}
 var hasOwn = (value, key) => Object.prototype.hasOwnProperty.call(value, key);
 var canonicalizeCodeVersionLabel = (value) => {
   const trimmed = value.trim();
@@ -16077,26 +16173,6 @@ var metaText = (manifest, source2, rows) => {
   };
   return manifestText(meta);
 };
-function flattenSymbols(symbols, packageName, modulePath) {
-  const out2 = [];
-  const walk = (list) => {
-    for (const symbol of list) {
-      const { members, ...rest } = symbol;
-      out2.push({
-        ...rest,
-        package: packageName,
-        package_name: packageName,
-        symbol_id: symbol.name,
-        modulePath,
-        module_path: modulePath
-      });
-      if (members && members.length > 0)
-        walk(members);
-    }
-  };
-  walk(symbols);
-  return out2;
-}
 var buildHashId = (packageName, dirCommit, moduleContentHash, dirty = false) => {
   const base = dirty && moduleContentHash ? `pkg:${packageName}:${dirCommit}:dirty:${moduleContentHash}` : `pkg:${packageName}:${dirCommit}`;
   return sha256(base);
@@ -16548,6 +16624,7 @@ var detectTechStack = async (repoPath) => {
   return labels;
 };
 export {
+  symbolRenameEvidenceSchema,
   symbolParamSchema,
   symbolInfoSchema,
   symbolDiffSchema,
@@ -16603,7 +16680,10 @@ export {
   buildHashId,
   buildEdgeHashId,
   buildDigestData,
+  buildCodeSymbolLocator,
+  buildCodeSymbolIdentityKey,
   buildCodeSnapshot,
+  applySymbolIdentities,
   SCAN_EXCLUDED_DIRS,
   PACKAGE_JSON,
   ExtractionPluginRegistry

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/extract",
-  "version": "0.5.33-alpha.3",
+  "version": "0.5.33-alpha.4",
   "type": "module",
   "bin": {
     "c4a-extract-code": "./bin/c4a-extract-code.js"