gitnexus 1.4.10 → 1.5.0

package/dist/core/ingestion/field-extractors/configs/csharp.js

@@ -1,6 +1,6 @@
 // gitnexus/src/core/ingestion/field-extractors/configs/csharp.ts
-import { SupportedLanguages } from '../../../../config/supported-languages.js';
-import { findVisibility, hasKeyword, hasModifier } from './helpers.js';
+import { SupportedLanguages } from 'gitnexus-shared';
+import { findVisibility, hasKeyword, hasModifier, collectModifierTexts } from './helpers.js';
 import { extractSimpleTypeName } from '../../type-extractors/shared.js';
 const CSHARP_VIS = new Set(['public', 'private', 'protected', 'internal']);
 /**
@@ -62,6 +62,12 @@ export const csharpConfig = {
         return undefined;
     },
     extractVisibility(node) {
+        // Detect compound C# visibilities: protected internal, private protected
+        const mods = collectModifierTexts(node);
+        if (mods.has('protected') && mods.has('internal'))
+            return 'protected internal';
+        if (mods.has('private') && mods.has('protected'))
+            return 'private protected';
         return findVisibility(node, CSHARP_VIS, 'private', 'modifier');
     },
     isStatic(node) {
@@ -70,4 +76,41 @@ export const csharpConfig = {
     isReadonly(node) {
         return hasKeyword(node, 'readonly') || hasModifier(node, 'modifier', 'readonly');
     },
+    extractPrimaryFields(ownerNode, context) {
+        // C# record positional parameters become public init-only properties.
+        // C# 12 class primary constructor parameters are captured as private fields.
+        // The parameter_list has no field name — find it by type.
+        let paramList = null;
+        for (let i = 0; i < ownerNode.namedChildCount; i++) {
+            const child = ownerNode.namedChild(i);
+            if (child?.type === 'parameter_list') {
+                paramList = child;
+                break;
+            }
+        }
+        if (!paramList)
+            return [];
+        const isRecord = ownerNode.type === 'record_declaration';
+        const fields = [];
+        for (let i = 0; i < paramList.namedChildCount; i++) {
+            const param = paramList.namedChild(i);
+            if (!param || param.type !== 'parameter')
+                continue;
+            const nameNode = param.childForFieldName('name');
+            const typeNode = param.childForFieldName('type');
+            if (!nameNode)
+                continue;
+            fields.push({
+                name: nameNode.text,
+                type: typeNode ? (extractSimpleTypeName(typeNode) ?? typeNode.text?.trim() ?? null) : null,
+                // Record params are public init-only properties; class params are private captured fields
+                visibility: isRecord ? 'public' : 'private',
+                isStatic: false,
+                isReadonly: isRecord, // record properties are init-only (readonly)
+                sourceFile: context.filePath,
+                line: param.startPosition.row + 1,
+            });
+        }
+        return fields;
+    },
 };

package/dist/core/ingestion/field-extractors/configs/dart.js

@@ -1,5 +1,5 @@
 // gitnexus/src/core/ingestion/field-extractors/configs/dart.ts
-import { SupportedLanguages } from '../../../../config/supported-languages.js';
+import { SupportedLanguages } from 'gitnexus-shared';
 import { hasKeyword } from './helpers.js';
 import { extractSimpleTypeName } from '../../type-extractors/shared.js';
 /**
@@ -42,8 +42,10 @@ export const dartConfig = {
         // declaration > type_identifier (first named child usually)
         for (let i = 0; i < node.namedChildCount; i++) {
             const child = node.namedChild(i);
-            if (child && (child.type === 'type_identifier' || child.type === 'generic_type'
-                || child.type === 'function_type')) {
+            if (child &&
+                (child.type === 'type_identifier' ||
+                    child.type === 'generic_type' ||
+                    child.type === 'function_type')) {
                 return extractSimpleTypeName(child) ?? child.text?.trim();
             }
         }

package/dist/core/ingestion/field-extractors/configs/go.js

@@ -1,5 +1,5 @@
 // gitnexus/src/core/ingestion/field-extractors/configs/go.ts
-import { SupportedLanguages } from '../../../../config/supported-languages.js';
+import { SupportedLanguages } from 'gitnexus-shared';
 import { extractSimpleTypeName } from '../../type-extractors/shared.js';
 /**
  * Go field extraction config.
@@ -12,9 +12,7 @@ import { extractSimpleTypeName } from '../../type-extractors/shared.js';
  */
 export const goConfig = {
     language: SupportedLanguages.Go,
-    typeDeclarationNodes: [
-        'type_declaration',
-    ],
+    typeDeclarationNodes: ['type_declaration'],
     fieldNodeTypes: ['field_declaration'],
     bodyNodeTypes: ['field_declaration_list'],
     defaultVisibility: 'package',
@@ -49,9 +47,7 @@ export const goConfig = {
         const text = name?.text;
         if (text && text.length > 0) {
             const first = text.charAt(0);
-            return first === first.toUpperCase() && first !== first.toLowerCase()
-                ? 'public'
-                : 'package';
+            return first === first.toUpperCase() && first !== first.toLowerCase() ? 'public' : 'package';
         }
         return 'package';
     },

package/dist/core/ingestion/field-extractors/configs/helpers.d.ts

@@ -42,3 +42,8 @@ export declare function typeFromAnnotation(node: SyntaxNode): string | undefined
  * and return its text via extractSimpleTypeName.
  */
 export declare function typeFromDescendant(node: SyntaxNode, types: ReadonlySet<string>): string | undefined;
+/**
+ * Collect all modifier keyword texts from a declaration node's named `modifier` children.
+ * Used by C# configs to detect compound visibilities (protected internal, private protected).
+ */
+export declare function collectModifierTexts(node: SyntaxNode): Set<string>;

package/dist/core/ingestion/field-extractors/configs/helpers.js

@@ -132,3 +132,17 @@ export function typeFromDescendant(node, types) {
     }
     return undefined;
 }
+/**
+ * Collect all modifier keyword texts from a declaration node's named `modifier` children.
+ * Used by C# configs to detect compound visibilities (protected internal, private protected).
+ */
+export function collectModifierTexts(node) {
+    const result = new Set();
+    for (let i = 0; i < node.namedChildCount; i++) {
+        const child = node.namedChild(i);
+        if (child && child.type === 'modifier') {
+            result.add(child.text.trim());
+        }
+    }
+    return result;
+}

package/dist/core/ingestion/field-extractors/configs/jvm.js

@@ -1,5 +1,5 @@
 // gitnexus/src/core/ingestion/field-extractors/configs/jvm.ts
-import { SupportedLanguages } from '../../../../config/supported-languages.js';
+import { SupportedLanguages } from 'gitnexus-shared';
 import { findVisibility, hasKeyword, hasModifier, typeFromField } from './helpers.js';
 import { extractSimpleTypeName } from '../../type-extractors/shared.js';
 // ---------------------------------------------------------------------------
@@ -62,10 +62,7 @@ export const javaConfig = {
 const KOTLIN_VIS = new Set(['public', 'private', 'protected', 'internal']);
 export const kotlinConfig = {
     language: SupportedLanguages.Kotlin,
-    typeDeclarationNodes: [
-        'class_declaration',
-        'object_declaration',
-    ],
+    typeDeclarationNodes: ['class_declaration', 'object_declaration'],
     fieldNodeTypes: ['property_declaration'],
     bodyNodeTypes: ['class_body'],
     defaultVisibility: 'public',
@@ -92,8 +89,11 @@ export const kotlinConfig = {
             if (child?.type === 'variable_declaration') {
                 for (let j = 0; j < child.namedChildCount; j++) {
                     const t = child.namedChild(j);
-                    if (t && (t.type === 'user_type' || t.type === 'type_identifier'
-                        || t.type === 'nullable_type' || t.type === 'generic_type')) {
+                    if (t &&
+                        (t.type === 'user_type' ||
+                            t.type === 'type_identifier' ||
+                            t.type === 'nullable_type' ||
+                            t.type === 'generic_type')) {
                         return extractSimpleTypeName(t) ?? t.text?.trim();
                     }
                 }

package/dist/core/ingestion/field-extractors/configs/php.js

@@ -1,5 +1,5 @@
 // gitnexus/src/core/ingestion/field-extractors/configs/php.ts
-import { SupportedLanguages } from '../../../../config/supported-languages.js';
+import { SupportedLanguages } from 'gitnexus-shared';
 import { findVisibility, hasKeyword } from './helpers.js';
 import { extractSimpleTypeName } from '../../type-extractors/shared.js';
 const PHP_VIS = new Set(['public', 'private', 'protected']);
@@ -11,11 +11,7 @@ const PHP_VIS = new Set(['public', 'private', 'protected']);
  */
 export const phpConfig = {
     language: SupportedLanguages.PHP,
-    typeDeclarationNodes: [
-        'class_declaration',
-        'interface_declaration',
-        'trait_declaration',
-    ],
+    typeDeclarationNodes: ['class_declaration', 'interface_declaration', 'trait_declaration'],
     fieldNodeTypes: ['property_declaration'],
     bodyNodeTypes: ['declaration_list'],
     defaultVisibility: 'public',
@@ -24,8 +20,7 @@ export const phpConfig = {
         for (let i = 0; i < node.namedChildCount; i++) {
             const child = node.namedChild(i);
             if (child?.type === 'property_element') {
-                const varName = child.childForFieldName('name')
-                    ?? child.firstNamedChild;
+                const varName = child.childForFieldName('name') ?? child.firstNamedChild;
                 if (varName) {
                     // strip leading $ from PHP variable names
                     const text = varName.text;
@@ -47,9 +42,12 @@ export const phpConfig = {
             const child = node.namedChild(i);
             if (!child)
                 continue;
-            if (child.type === 'union_type' || child.type === 'named_type'
-                || child.type === 'optional_type' || child.type === 'primitive_type'
-                || child.type === 'intersection_type' || child.type === 'nullable_type') {
+            if (child.type === 'union_type' ||
+                child.type === 'named_type' ||
+                child.type === 'optional_type' ||
+                child.type === 'primitive_type' ||
+                child.type === 'intersection_type' ||
+                child.type === 'nullable_type') {
                 return extractSimpleTypeName(child) ?? child.text?.trim();
             }
         }

package/dist/core/ingestion/field-extractors/configs/python.js

@@ -1,5 +1,5 @@
 // gitnexus/src/core/ingestion/field-extractors/configs/python.ts
-import { SupportedLanguages } from '../../../../config/supported-languages.js';
+import { SupportedLanguages } from 'gitnexus-shared';
 import { extractSimpleTypeName } from '../../type-extractors/shared.js';
 /**
  * Python field extraction config.

package/dist/core/ingestion/field-extractors/configs/ruby.js

@@ -1,5 +1,5 @@
 // gitnexus/src/core/ingestion/field-extractors/configs/ruby.ts
-import { SupportedLanguages } from '../../../../config/supported-languages.js';
+import { SupportedLanguages } from 'gitnexus-shared';
 /**
  * Collect all field names declared by an `attr_accessor`, `attr_reader`, or
  * `attr_writer` call node.  A single call may list multiple symbols:
@@ -10,8 +10,9 @@ function extractAttrNames(node) {
     if (!method)
         return [];
     const methodName = method.text;
-    if (methodName !== 'attr_accessor' && methodName !== 'attr_reader'
-        && methodName !== 'attr_writer') {
+    if (methodName !== 'attr_accessor' &&
+        methodName !== 'attr_reader' &&
+        methodName !== 'attr_writer') {
         return [];
     }
     const args = node.childForFieldName('arguments');

package/dist/core/ingestion/field-extractors/configs/rust.js

@@ -1,5 +1,5 @@
 // gitnexus/src/core/ingestion/field-extractors/configs/rust.ts
-import { SupportedLanguages } from '../../../../config/supported-languages.js';
+import { SupportedLanguages } from 'gitnexus-shared';
 import { extractSimpleTypeName } from '../../type-extractors/shared.js';
 import { hasKeyword } from './helpers.js';
 /**
@@ -11,10 +11,7 @@ import { hasKeyword } from './helpers.js';
  */
 export const rustConfig = {
     language: SupportedLanguages.Rust,
-    typeDeclarationNodes: [
-        'struct_item',
-        'enum_item',
-    ],
+    typeDeclarationNodes: ['struct_item', 'enum_item'],
     fieldNodeTypes: ['field_declaration'],
     bodyNodeTypes: ['field_declaration_list'],
     defaultVisibility: 'private',

package/dist/core/ingestion/field-extractors/configs/swift.js

@@ -1,8 +1,14 @@
 // gitnexus/src/core/ingestion/field-extractors/configs/swift.ts
-import { SupportedLanguages } from '../../../../config/supported-languages.js';
+import { SupportedLanguages } from 'gitnexus-shared';
 import { hasKeyword, findVisibility } from './helpers.js';
 import { extractSimpleTypeName } from '../../type-extractors/shared.js';
-const SWIFT_VIS = new Set(['public', 'private', 'fileprivate', 'internal', 'open']);
+const SWIFT_VIS = new Set([
+    'public',
+    'private',
+    'fileprivate',
+    'internal',
+    'open',
+]);
 /**
  * Swift field extraction config.
  *
@@ -11,11 +17,7 @@ const SWIFT_VIS = new Set(['public', 'private', 'fileprivate', 'internal', 'open
  */
 export const swiftConfig = {
     language: SupportedLanguages.Swift,
-    typeDeclarationNodes: [
-        'class_declaration',
-        'struct_declaration',
-        'protocol_declaration',
-    ],
+    typeDeclarationNodes: ['class_declaration', 'struct_declaration', 'protocol_declaration'],
     fieldNodeTypes: ['property_declaration'],
     bodyNodeTypes: ['class_body', 'protocol_body'],
     defaultVisibility: 'internal',

package/dist/core/ingestion/field-extractors/configs/typescript-javascript.js

@@ -1,5 +1,5 @@
 // gitnexus/src/core/ingestion/field-extractors/configs/typescript-javascript.ts
-import { SupportedLanguages } from '../../../../config/supported-languages.js';
+import { SupportedLanguages } from 'gitnexus-shared';
 import { hasKeyword, findVisibility, typeFromAnnotation } from './helpers.js';
 const VISIBILITY_KEYWORDS = new Set(['public', 'private', 'protected']);
 const shared = {
@@ -8,11 +8,7 @@ const shared = {
         'abstract_class_declaration',
         'interface_declaration',
     ],
-    fieldNodeTypes: [
-        'public_field_definition',
-        'property_signature',
-        'field_definition',
-    ],
+    fieldNodeTypes: ['public_field_definition', 'property_signature', 'field_definition'],
     bodyNodeTypes: ['class_body', 'interface_body', 'object_type'],
     defaultVisibility: 'public',
     extractName(node) {

package/dist/core/ingestion/field-extractors/generic.d.ts

@@ -6,9 +6,9 @@
  * BaseFieldExtractor whose behaviour is entirely driven by FieldExtractionConfig.
  */
 import type { SyntaxNode } from '../utils/ast-helpers.js';
-import { SupportedLanguages } from '../../../config/supported-languages.js';
+import { SupportedLanguages } from 'gitnexus-shared';
 import type { FieldExtractor } from '../field-extractor.js';
-import type { FieldVisibility } from '../field-types.js';
+import type { FieldExtractorContext, FieldInfo, FieldVisibility } from '../field-types.js';
 export interface FieldExtractionConfig {
     language: SupportedLanguages;
     /** AST node types that are class/struct/interface declarations */
@@ -39,6 +39,9 @@ export interface FieldExtractionConfig {
     isStatic: (node: SyntaxNode) => boolean;
     /** Check if a field is readonly/final/const */
     isReadonly: (node: SyntaxNode) => boolean;
+    /** Extract fields from primary constructor parameters on the owner node itself
+     *  (e.g. C# record positional parameters, C# 12 class primary constructors). */
+    extractPrimaryFields?: (ownerNode: SyntaxNode, context: FieldExtractorContext) => FieldInfo[];
 }
 /**
  * Create a FieldExtractor from a declarative config.

package/dist/core/ingestion/field-extractors/generic.js

@@ -31,6 +31,12 @@ export function createFieldExtractor(config) {
             for (const body of bodies) {
                 this.extractFieldsFromBody(body, context, fields);
             }
+            // Extract fields from primary constructor parameters (e.g. C# records)
+            if (config.extractPrimaryFields) {
+                const primaryFields = config.extractPrimaryFields(node, context);
+                for (const f of primaryFields)
+                    fields.push(f);
+            }
             return { ownerFqn, fields, nestedTypes: [] };
         }
         // ------------------------------------------------------------------

package/dist/core/ingestion/field-extractors/typescript.d.ts

@@ -1,5 +1,5 @@
 import type { SyntaxNode } from '../utils/ast-helpers.js';
-import { SupportedLanguages } from '../../../config/supported-languages.js';
+import { SupportedLanguages } from 'gitnexus-shared';
 import { BaseFieldExtractor } from '../field-extractor.js';
 import type { FieldExtractorContext, ExtractedFields, FieldVisibility } from '../field-types.js';
 /**

package/dist/core/ingestion/field-extractors/typescript.js

@@ -1,5 +1,5 @@
 // gitnexus/src/core/ingestion/field-extractors/typescript.ts
-import { SupportedLanguages } from '../../../config/supported-languages.js';
+import { SupportedLanguages } from 'gitnexus-shared';
 import { BaseFieldExtractor } from '../field-extractor.js';
 /**
  * Hand-written TypeScript field extractor.

package/dist/core/ingestion/field-types.d.ts

@@ -1,15 +1,17 @@
 import type { TypeEnvironment } from './type-env.js';
 import type { SymbolTable } from './symbol-table.js';
-import { SupportedLanguages } from '../../config/supported-languages.js';
+import { SupportedLanguages } from 'gitnexus-shared';
 /**
  * Visibility levels used across all supported languages.
  * - public / private / protected: universal modifiers
  * - internal: C#, Kotlin (assembly/module scope)
+ * - protected internal: C# (accessible by same assembly OR derived classes)
+ * - private protected: C# (accessible by derived classes within same assembly)
  * - package: Java (package-private, no keyword)
  * - fileprivate: Swift (file scope)
  * - open: Swift (subclassable across modules)
  */
-export type FieldVisibility = 'public' | 'private' | 'protected' | 'internal' | 'package' | 'fileprivate' | 'open';
+export type FieldVisibility = 'public' | 'private' | 'protected' | 'internal' | 'protected internal' | 'private protected' | 'package' | 'fileprivate' | 'open';
 /**
  * Represents a field or property within a class/struct/interface
  */

package/dist/core/ingestion/filesystem-walker.js

@@ -74,8 +74,8 @@ export const readFileContents = async (repoPath, relativePaths) => {
  */
 export const walkRepository = async (repoPath, onProgress) => {
     const scanned = await walkRepositoryPaths(repoPath, onProgress);
-    const contents = await readFileContents(repoPath, scanned.map(f => f.path));
+    const contents = await readFileContents(repoPath, scanned.map((f) => f.path));
     return scanned
-        .filter(f => contents.has(f.path))
-        .map(f => ({ path: f.path, content: contents.get(f.path) }));
+        .filter((f) => contents.has(f.path))
+        .map((f) => ({ path: f.path, content: contents.get(f.path) }));
 };

package/dist/core/ingestion/framework-detection.d.ts

@@ -9,7 +9,7 @@
  * DESIGN: Returns null for unknown frameworks, which causes a 1.0 multiplier
  * (no bonus, no penalty) - same behavior as before this feature.
  */
-import { SupportedLanguages } from '../../config/supported-languages.js';
+import { SupportedLanguages } from 'gitnexus-shared';
 export interface FrameworkHint {
     framework: string;
     entryPointMultiplier: number;