openlore 2.0.2 → 2.0.3

package/dist/cli/manifest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/manifest/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAA4B,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,cAAc,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;KACvC,WAAW,CAAC,0FAA0F,CAAC;KACvG,MAAM,CAAC,cAAc,EAAE,iEAAiE,CAAC;KACzF,MAAM,CAAC,uBAAuB,EAAE,uDAAuD,CAAC;KACxF,MAAM,CAAC,mBAAmB,EAAE,yDAAyD,EAAE,KAAK,CAAC;KAC7F,MAAM,CAAC,qBAAqB,EAAE,+DAA+D,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;KACtH,MAAM,CAAC,KAAK,EAAE,IAAyB,EAAE,EAAE;IAC1C,OAAO,CAAC,IAAI,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC;AAEL,MAAM,kBAAkB,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;KAC/C,WAAW,CAAC,sEAAsE,CAAC;KACnF,QAAQ,CAAC,QAAQ,EAAE,uCAAuC,CAAC;KAC3D,MAAM,CAAC,CAAC,IAAY,EAAE,EAAE;IACvB,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;KACnD,WAAW,CAAC,qEAAqE,CAAC;KAClF,UAAU,CAAC,cAAc,CAAC;KAC1B,UAAU,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/cli/manifest/schema-validator.d.ts

@@ -0,0 +1,18 @@
+/**
+ * A deliberately tiny JSON Schema validator — just the subset used by
+ * schemas/openlore-manifest-v1.json. Avoids pulling in Ajv (a large dep) for a
+ * single internal schema, per spec-05's acceptance criteria.
+ *
+ * Supported keywords: type (string or array incl. "null"), const, enum,
+ * required, properties, additionalProperties (false only), items. The
+ * `integer` type is distinguished from `number`.
+ */
+export interface ValidationError {
+    path: string;
+    message: string;
+}
+type JsonSchema = Record<string, unknown>;
+/** Validate a parsed JSON value against a parsed JSON Schema. */
+export declare function validateAgainstSchema(value: unknown, schema: JsonSchema): ValidationError[];
+export {};
+//# sourceMappingURL=schema-validator.d.ts.map

package/dist/cli/manifest/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../../src/cli/manifest/schema-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAoE1C,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,eAAe,EAAE,CAI3F"}

package/dist/cli/manifest/schema-validator.js

@@ -0,0 +1,77 @@
+/**
+ * A deliberately tiny JSON Schema validator — just the subset used by
+ * schemas/openlore-manifest-v1.json. Avoids pulling in Ajv (a large dep) for a
+ * single internal schema, per spec-05's acceptance criteria.
+ *
+ * Supported keywords: type (string or array incl. "null"), const, enum,
+ * required, properties, additionalProperties (false only), items. The
+ * `integer` type is distinguished from `number`.
+ */
+function typeOf(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'array';
+    if (Number.isInteger(value))
+        return 'integer';
+    return typeof value; // 'number' | 'string' | 'boolean' | 'object'
+}
+/** Returns true if `value` satisfies a single JSON Schema `type` token. */
+function matchesType(value, type) {
+    const actual = typeOf(value);
+    if (type === 'number')
+        return actual === 'number' || actual === 'integer';
+    return actual === type;
+}
+function validateNode(value, schema, path, errors) {
+    // const
+    if ('const' in schema && value !== schema.const) {
+        errors.push({ path, message: `expected const ${JSON.stringify(schema.const)}, got ${JSON.stringify(value)}` });
+        return;
+    }
+    // type
+    if ('type' in schema) {
+        const types = Array.isArray(schema.type) ? schema.type : [schema.type];
+        if (!types.some(t => matchesType(value, t))) {
+            errors.push({ path, message: `expected type ${types.join('|')}, got ${typeOf(value)}` });
+            return;
+        }
+    }
+    // null short-circuits remaining checks
+    if (value === null)
+        return;
+    // enum
+    if (Array.isArray(schema.enum) && !schema.enum.includes(value)) {
+        errors.push({ path, message: `value ${JSON.stringify(value)} not in enum ${JSON.stringify(schema.enum)}` });
+    }
+    // object
+    if (typeOf(value) === 'object') {
+        const obj = value;
+        const props = schema.properties ?? {};
+        for (const req of schema.required ?? []) {
+            if (!(req in obj))
+                errors.push({ path: `${path}/${req}`, message: 'missing required property' });
+        }
+        if (schema.additionalProperties === false) {
+            for (const key of Object.keys(obj)) {
+                if (!(key in props))
+                    errors.push({ path: `${path}/${key}`, message: 'additional property not allowed' });
+            }
+        }
+        for (const [key, subSchema] of Object.entries(props)) {
+            if (key in obj)
+                validateNode(obj[key], subSchema, `${path}/${key}`, errors);
+        }
+    }
+    // array
+    if (typeOf(value) === 'array' && schema.items) {
+        value.forEach((item, i) => validateNode(item, schema.items, `${path}/${i}`, errors));
+    }
+}
+/** Validate a parsed JSON value against a parsed JSON Schema. */
+export function validateAgainstSchema(value, schema) {
+    const errors = [];
+    validateNode(value, schema, '', errors);
+    return errors;
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/cli/manifest/schema-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.js","sourceRoot":"","sources":["../../../src/cli/manifest/schema-validator.ts"],"names":[],"mappings":"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"}

package/dist/cli/manifest/validate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `openlore manifest validate <path>` — schema-check an existing manifest.
+ *
+ * Validates against the canonical JSON Schema shipped with OpenLore
+ * (schemas/openlore-manifest-v1.json), using the small in-repo validator
+ * rather than a heavyweight dependency.
+ */
+import { type ValidationError } from './schema-validator.js';
+/** Absolute path to the vendored manifest JSON Schema (ships in the package). */
+export declare function manifestSchemaPath(): string;
+export declare function loadManifestSchema(): Record<string, unknown>;
+/** Validate a parsed manifest object; returns the (possibly empty) error list. */
+export declare function validateManifest(manifest: unknown): ValidationError[];
+export declare function runManifestValidate(path: string): number;
+//# sourceMappingURL=validate.d.ts.map

package/dist/cli/manifest/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/cli/manifest/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEpF,iFAAiF;AACjF,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE5D;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,eAAe,EAAE,CAErE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA0BxD"}

package/dist/cli/manifest/validate.js

@@ -0,0 +1,51 @@
+/**
+ * `openlore manifest validate <path>` — schema-check an existing manifest.
+ *
+ * Validates against the canonical JSON Schema shipped with OpenLore
+ * (schemas/openlore-manifest-v1.json), using the small in-repo validator
+ * rather than a heavyweight dependency.
+ */
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { logger } from '../../utils/logger.js';
+import { validateAgainstSchema } from './schema-validator.js';
+/** Absolute path to the vendored manifest JSON Schema (ships in the package). */
+export function manifestSchemaPath() {
+    // src/cli/manifest/validate.ts → repo root → schemas/ (same depth in dist/).
+    return fileURLToPath(new URL('../../../schemas/openlore-manifest-v1.json', import.meta.url));
+}
+export function loadManifestSchema() {
+    return JSON.parse(readFileSync(manifestSchemaPath(), 'utf-8'));
+}
+/** Validate a parsed manifest object; returns the (possibly empty) error list. */
+export function validateManifest(manifest) {
+    return validateAgainstSchema(manifest, loadManifestSchema());
+}
+export function runManifestValidate(path) {
+    let raw;
+    try {
+        raw = readFileSync(path, 'utf-8');
+    }
+    catch {
+        logger.error(`Cannot read manifest: ${path}`);
+        return 2;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        logger.error(`Invalid JSON in ${path}: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    const errors = validateManifest(parsed);
+    if (errors.length === 0) {
+        logger.success(`${path} is a valid OpenLore manifest (v1).`);
+        return 0;
+    }
+    logger.error(`${path} failed schema validation (${errors.length} error(s)):`);
+    for (const e of errors)
+        logger.error(`  ${e.path || '/'}: ${e.message}`);
+    return 1;
+}
+//# sourceMappingURL=validate.js.map

package/dist/cli/manifest/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/cli/manifest/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAwB,MAAM,uBAAuB,CAAC;AAEpF,iFAAiF;AACjF,MAAM,UAAU,kBAAkB;IAChC,6EAA6E;IAC7E,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,4CAA4C,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,kBAAkB,EAAE,EAAE,OAAO,CAAC,CAA4B,CAAC;AAC5F,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,gBAAgB,CAAC,QAAiB;IAChD,OAAO,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,mBAAmB,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7F,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,qCAAqC,CAAC,CAAC;QAC7D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,8BAA8B,MAAM,CAAC,MAAM,aAAa,CAAC,CAAC;IAC9E,KAAK,MAAM,CAAC,IAAI,MAAM;QAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/core/scip/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * SCIP export — derives a valid `index.scip` payload from an OpenLore call
+ * graph.
+ *
+ * SCIP (Source Code Intelligence Protocol) is Sourcegraph's open successor to
+ * LSIF. This is a one-way interop export: the SQLite/JSON graph remains
+ * canonical, and we lossily project the subset of it that SCIP can model
+ * (functions → symbols, call edges → reference/definition occurrences).
+ *
+ * Guarantees:
+ *  - Deterministic: documents sorted by relative path, occurrences by
+ *    `(line, col)`, symbols deduplicated and sorted. Re-running on an unchanged
+ *    graph produces byte-identical output.
+ *  - Faithful or loud: if a node we export lacks a defining line (a range a
+ *    SCIP consumer expects), the export throws rather than emitting a malformed
+ *    index. Column-level precision is unavailable in the analyzer today, so we
+ *    emit zero-width ranges at column 0 and warn once.
+ *    TODO(spec-04-followup): column ranges in analyzer.
+ *  - TODO(spec-04-followup): scip import (consume external SCIP into the graph).
+ */
+import type { SerializedCallGraph } from '../analyzer/call-graph.js';
+import { type PackageInfo } from './moniker.js';
+export interface ExportScipOptions {
+    /** Absolute path to the project root. Emitted (URI-encoded) as project_root. */
+    projectRoot: string;
+    /** Package coordinates filling the SCIP `<package>` symbol slot. */
+    package: PackageInfo;
+    /** openlore's own version, emitted as tool_info.version. */
+    toolVersion: string;
+    /** Gitignore-style globs over repo-relative paths; if set, only matches participate. */
+    include?: string[];
+    /** Gitignore-style globs over repo-relative paths; matches are dropped. */
+    exclude?: string[];
+    /** Out-param: populated with summary statistics and warnings for the CLI. */
+    report?: ExportReport;
+}
+export interface ExportReport {
+    documentCount: number;
+    occurrenceCount: number;
+    symbolCount: number;
+    definitionCount: number;
+    /** Repo-relative paths whose language has no SCIP enum value. */
+    unspecifiedLanguageFiles: string[];
+    warnings: string[];
+}
+/**
+ * Build a deterministic SCIP `index.scip` payload from a serialized call graph.
+ * Returns the encoded protobuf bytes.
+ */
+export declare function exportScip(graph: SerializedCallGraph, options: ExportScipOptions): Buffer;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/scip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/scip/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAgB,MAAM,2BAA2B,CAAC;AAOnF,OAAO,EAAmC,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAEjF,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,OAAO,EAAE,WAAW,CAAC;IACrB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAqED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAqIzF"}

package/dist/core/scip/index.js

@@ -0,0 +1,210 @@
+/**
+ * SCIP export — derives a valid `index.scip` payload from an OpenLore call
+ * graph.
+ *
+ * SCIP (Source Code Intelligence Protocol) is Sourcegraph's open successor to
+ * LSIF. This is a one-way interop export: the SQLite/JSON graph remains
+ * canonical, and we lossily project the subset of it that SCIP can model
+ * (functions → symbols, call edges → reference/definition occurrences).
+ *
+ * Guarantees:
+ *  - Deterministic: documents sorted by relative path, occurrences by
+ *    `(line, col)`, symbols deduplicated and sorted. Re-running on an unchanged
+ *    graph produces byte-identical output.
+ *  - Faithful or loud: if a node we export lacks a defining line (a range a
+ *    SCIP consumer expects), the export throws rather than emitting a malformed
+ *    index. Column-level precision is unavailable in the analyzer today, so we
+ *    emit zero-width ranges at column 0 and warn once.
+ *    TODO(spec-04-followup): column ranges in analyzer.
+ *  - TODO(spec-04-followup): scip import (consume external SCIP into the graph).
+ */
+import { scipIndexType, SymbolRole, TextEncoding_UTF8, SymbolKind_Function, } from './schema.js';
+import { symbolMoniker, scipLanguageName } from './moniker.js';
+/**
+ * Compile a glob to a path-matching RegExp. Supports `*` (within a segment),
+ * `?`, `**` (across segments), and a globstar-plus-slash (zero or more leading
+ * path segments).
+ * Sufficient for the documented `--include`/`--exclude` patterns; not a full
+ * gitignore implementation.
+ */
+function globToRegExp(glob) {
+    let re = '';
+    for (let i = 0; i < glob.length; i++) {
+        const c = glob[i];
+        if (c === '*') {
+            if (glob[i + 1] === '*') {
+                if (glob[i + 2] === '/') {
+                    re += '(?:.*/)?';
+                    i += 2;
+                }
+                else {
+                    re += '.*';
+                    i += 1;
+                }
+            }
+            else {
+                re += '[^/]*';
+            }
+        }
+        else if (c === '?') {
+            re += '[^/]';
+        }
+        else if ('.+^${}()|[]\\'.includes(c)) {
+            re += '\\' + c;
+        }
+        else {
+            re += c;
+        }
+    }
+    return new RegExp('^' + re + '$');
+}
+/** True iff `relPath` matches any of the compiled glob patterns. */
+function matchesAny(relPath, patterns) {
+    return patterns.some(p => p.test(relPath));
+}
+/** Normalize a node's file path to a POSIX repo-relative path. */
+function toRelPath(filePath, projectRoot) {
+    let p = filePath.replace(/\\/g, '/');
+    const root = projectRoot.replace(/\\/g, '/').replace(/\/$/, '');
+    if (p.startsWith(root + '/'))
+        p = p.slice(root.length + 1);
+    return p.replace(/^\.\//, '').replace(/^\/+/, '');
+}
+/**
+ * Build a deterministic SCIP `index.scip` payload from a serialized call graph.
+ * Returns the encoded protobuf bytes.
+ */
+export function exportScip(graph, options) {
+    const report = options.report ?? {
+        documentCount: 0,
+        occurrenceCount: 0,
+        symbolCount: 0,
+        definitionCount: 0,
+        unspecifiedLanguageFiles: [],
+        warnings: [],
+    };
+    if (options.report) {
+        // Reset the caller-provided report so repeated calls are clean.
+        report.documentCount = 0;
+        report.occurrenceCount = 0;
+        report.symbolCount = 0;
+        report.definitionCount = 0;
+        report.unspecifiedLanguageFiles = [];
+        report.warnings = [];
+    }
+    const includePatterns = (options.include ?? []).map(globToRegExp);
+    const excludePatterns = (options.exclude ?? []).map(globToRegExp);
+    // Real (non-synthetic) nodes that survive the include/exclude filter.
+    const exportable = new Map();
+    for (const node of graph.nodes) {
+        if (node.isExternal)
+            continue;
+        const relPath = toRelPath(node.filePath, options.projectRoot);
+        if (!relPath)
+            continue;
+        if (includePatterns.length > 0 && !matchesAny(relPath, includePatterns))
+            continue;
+        if (excludePatterns.length > 0 && matchesAny(relPath, excludePatterns))
+            continue;
+        exportable.set(node.id, { node, relPath });
+    }
+    // Stable moniker per node id, computed once.
+    const monikers = new Map();
+    for (const [id, { node, relPath }] of exportable) {
+        monikers.set(id, symbolMoniker(node, relPath, options.package));
+    }
+    let warnedMissingColumns = false;
+    const warnMissingColumns = () => {
+        if (warnedMissingColumns)
+            return;
+        warnedMissingColumns = true;
+        report.warnings.push('Column-level ranges are unavailable in the analyzer; emitted zero-width ranges at column 0. ' +
+            'TODO(spec-04-followup): column ranges in analyzer.');
+    };
+    // documents keyed by relative path.
+    const docs = new Map();
+    const seenLanguages = new Map(); // relPath -> openlore language
+    const docFor = (relPath, openloreLang) => {
+        let doc = docs.get(relPath);
+        if (!doc) {
+            const language = scipLanguageName(openloreLang);
+            if (!language)
+                report.unspecifiedLanguageFiles.push(relPath);
+            doc = { language, relative_path: relPath, occurrences: [], symbols: [] };
+            docs.set(relPath, doc);
+            seenLanguages.set(relPath, openloreLang);
+        }
+        return doc;
+    };
+    // 1. Definition occurrence + SymbolInformation for every exported node.
+    for (const [, { node, relPath }] of exportable) {
+        if (node.startLine === undefined) {
+            throw new Error(`SCIP export aborted: node "${node.id}" has no defining line. ` +
+                'The graph is missing a range that an SCIP consumer requires. ' +
+                'Re-run `openlore analyze` to rebuild the graph; if the problem persists the analyzer ' +
+                'did not record positions for this language.');
+        }
+        const doc = docFor(relPath, node.language);
+        const symbol = monikers.get(node.id);
+        const line = node.startLine - 1; // SCIP ranges are 0-based.
+        warnMissingColumns();
+        doc.occurrences.push({ range: [line, 0, 0], symbol, symbol_roles: SymbolRole.Definition });
+        doc.symbols.push({
+            symbol,
+            kind: SymbolKind_Function,
+            ...(node.docstring ? { documentation: [node.docstring] } : {}),
+        });
+    }
+    // 2. Reference occurrence at each call site whose callee we export.
+    for (const edge of graph.edges) {
+        const caller = exportable.get(edge.callerId);
+        const calleeSymbol = monikers.get(edge.calleeId);
+        if (!caller || !calleeSymbol)
+            continue; // skip edges to external/filtered nodes.
+        const doc = docFor(caller.relPath, caller.node.language);
+        if (edge.line === undefined)
+            warnMissingColumns();
+        const line = (edge.line ?? caller.node.startLine ?? 1) - 1;
+        doc.occurrences.push({ range: [line, 0, 0], symbol: calleeSymbol, symbol_roles: SymbolRole.ReadAccess });
+    }
+    // 3. Deterministic ordering: documents by path; occurrences by (line, col,
+    //    roles, symbol); symbols deduplicated and sorted by symbol string.
+    const sortedDocs = [...docs.values()].sort((a, b) => a.relative_path.localeCompare(b.relative_path));
+    for (const doc of sortedDocs) {
+        doc.occurrences.sort((a, b) => a.range[0] - b.range[0] ||
+            a.range[1] - b.range[1] ||
+            a.symbol_roles - b.symbol_roles ||
+            a.symbol.localeCompare(b.symbol));
+        const bySymbol = new Map();
+        for (const s of doc.symbols)
+            if (!bySymbol.has(s.symbol))
+                bySymbol.set(s.symbol, s);
+        doc.symbols = [...bySymbol.values()].sort((a, b) => a.symbol.localeCompare(b.symbol));
+        report.occurrenceCount += doc.occurrences.length;
+        report.symbolCount += doc.symbols.length;
+        report.definitionCount += doc.occurrences.filter(o => o.symbol_roles === SymbolRole.Definition).length;
+    }
+    report.documentCount = sortedDocs.length;
+    const payload = {
+        metadata: {
+            version: 0, // UnspecifiedProtocolVersion — the only defined value.
+            tool_info: { name: 'openlore', version: options.toolVersion },
+            project_root: pathToFileUri(options.projectRoot),
+            text_document_encoding: TextEncoding_UTF8,
+        },
+        documents: sortedDocs,
+    };
+    const Index = scipIndexType();
+    const err = Index.verify(payload);
+    if (err)
+        throw new Error(`SCIP export produced an invalid index: ${err}`);
+    const message = Index.create(payload);
+    return Buffer.from(Index.encode(message).finish());
+}
+/** Encode an absolute filesystem path as a `file://` URI for project_root. */
+function pathToFileUri(absPath) {
+    const normalized = absPath.replace(/\\/g, '/');
+    const withSlash = normalized.startsWith('/') ? normalized : '/' + normalized;
+    return 'file://' + withSlash.split('/').map(encodeURIComponent).join('/');
+}
+//# sourceMappingURL=index.js.map

package/dist/core/scip/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/scip/index.ts"],"names":[],"mappings":"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"}

package/dist/core/scip/moniker.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Derivation of SCIP symbol monikers and language tags from OpenLore graph
+ * nodes.
+ *
+ * SCIP symbols are formatted strings, not structured objects, per the grammar
+ * documented at https://github.com/sourcegraph/scip/blob/main/docs/scip.md.
+ * We emit global symbols of the form:
+ *
+ *   <scheme> ' ' <manager> ' ' <package-name> ' ' <version> <descriptors>
+ *
+ * where descriptors are `<repo-rel-path>/` (namespace) followed by
+ * `<qualified-name>(<arity>).` (method). Example:
+ *
+ *   openlore npm openlore 2.0.2 `src/core/scip/index.ts`/exportScip(1).
+ *
+ * Identifiers containing characters outside the SCIP "simple identifier" set
+ * are backtick-escaped (with embedded backticks doubled).
+ */
+import type { FunctionNode } from '../analyzer/call-graph.js';
+/** Package coordinates that fill the SCIP `<package>` slot of every symbol. */
+export interface PackageInfo {
+    manager: string;
+    name: string;
+    version: string;
+}
+/**
+ * Map an OpenLore language tag (see signature-extractor.ts) to the SCIP
+ * `Language` enum name used as `Document.language`. Returns `''` for languages
+ * SCIP has no value for (the caller records these for the export summary).
+ */
+export declare function scipLanguageName(openloreLanguage: string): string;
+/** Fully-qualified name within a file: `Class.method` or bare `function`. */
+export declare function qualifiedName(node: FunctionNode): string;
+/**
+ * Best-effort parameter count from a node's declaration `signature`. Counts
+ * top-level comma-separated parameters inside the first parenthesized group.
+ * Returns `undefined` when no signature is available (the analyzer does not
+ * persist arity directly — TODO(spec-04-followup): arity in analyzer).
+ */
+export declare function arityOf(node: FunctionNode): number | undefined;
+/**
+ * Build the SCIP symbol moniker string for a function node.
+ *
+ * `repoRelPath` must be the document's relative path (POSIX separators), the
+ * same value used for the node's `Document.relative_path`.
+ */
+export declare function symbolMoniker(node: FunctionNode, repoRelPath: string, pkg: PackageInfo): string;
+//# sourceMappingURL=moniker.d.ts.map

package/dist/core/scip/moniker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moniker.d.ts","sourceRoot":"","sources":["../../../src/core/scip/moniker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAcD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAsBjE;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAoB9D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAM/F"}

package/dist/core/scip/moniker.js

@@ -0,0 +1,109 @@
+/**
+ * Derivation of SCIP symbol monikers and language tags from OpenLore graph
+ * nodes.
+ *
+ * SCIP symbols are formatted strings, not structured objects, per the grammar
+ * documented at https://github.com/sourcegraph/scip/blob/main/docs/scip.md.
+ * We emit global symbols of the form:
+ *
+ *   <scheme> ' ' <manager> ' ' <package-name> ' ' <version> <descriptors>
+ *
+ * where descriptors are `<repo-rel-path>/` (namespace) followed by
+ * `<qualified-name>(<arity>).` (method). Example:
+ *
+ *   openlore npm openlore 2.0.2 `src/core/scip/index.ts`/exportScip(1).
+ *
+ * Identifiers containing characters outside the SCIP "simple identifier" set
+ * are backtick-escaped (with embedded backticks doubled).
+ */
+const SCHEME = 'openlore';
+/** A simple identifier needs no escaping iff it matches this set entirely. */
+const SIMPLE_IDENTIFIER = /^[A-Za-z0-9\-+$_]+$/;
+/** Escape a name for use as a SCIP descriptor identifier. */
+function escapeName(name) {
+    if (SIMPLE_IDENTIFIER.test(name))
+        return name;
+    // Escaped identifier: wrap in backticks, double any embedded backticks.
+    return '`' + name.replace(/`/g, '``') + '`';
+}
+/**
+ * Map an OpenLore language tag (see signature-extractor.ts) to the SCIP
+ * `Language` enum name used as `Document.language`. Returns `''` for languages
+ * SCIP has no value for (the caller records these for the export summary).
+ */
+export function scipLanguageName(openloreLanguage) {
+    switch (openloreLanguage) {
+        case 'Python':
+        case 'TypeScript':
+        case 'JavaScript':
+        case 'Go':
+        case 'Rust':
+        case 'Ruby':
+        case 'Java':
+        case 'Kotlin':
+        case 'PHP':
+        case 'Swift':
+        case 'C':
+            return openloreLanguage;
+        case 'C++':
+            return 'CPP';
+        case 'C#':
+            return 'CSharp';
+        default:
+            // 'unknown' and anything SCIP lacks an enum value for.
+            return '';
+    }
+}
+/** Fully-qualified name within a file: `Class.method` or bare `function`. */
+export function qualifiedName(node) {
+    return node.className ? `${node.className}.${node.name}` : node.name;
+}
+/**
+ * Best-effort parameter count from a node's declaration `signature`. Counts
+ * top-level comma-separated parameters inside the first parenthesized group.
+ * Returns `undefined` when no signature is available (the analyzer does not
+ * persist arity directly — TODO(spec-04-followup): arity in analyzer).
+ */
+export function arityOf(node) {
+    const sig = node.signature;
+    if (!sig)
+        return undefined;
+    const open = sig.indexOf('(');
+    if (open === -1)
+        return undefined;
+    // Walk to the matching close paren, counting top-level commas.
+    let depth = 0;
+    let commas = 0;
+    let sawContent = false;
+    for (let i = open; i < sig.length; i++) {
+        const ch = sig[i];
+        if (ch === '(' || ch === '[' || ch === '{' || ch === '<')
+            depth++;
+        else if (ch === ')' || ch === ']' || ch === '}' || ch === '>') {
+            depth--;
+            if (depth === 0)
+                break;
+        }
+        else if (ch === ',' && depth === 1)
+            commas++;
+        else if (depth === 1 && !/\s/.test(ch))
+            sawContent = true;
+    }
+    if (!sawContent)
+        return 0;
+    return commas + 1;
+}
+/**
+ * Build the SCIP symbol moniker string for a function node.
+ *
+ * `repoRelPath` must be the document's relative path (POSIX separators), the
+ * same value used for the node's `Document.relative_path`.
+ */
+export function symbolMoniker(node, repoRelPath, pkg) {
+    const namespace = `${escapeName(repoRelPath)}/`;
+    const arity = arityOf(node);
+    const disambiguator = arity === undefined ? '' : String(arity);
+    const method = `${escapeName(qualifiedName(node))}(${disambiguator}).`;
+    return `${SCHEME} ${pkg.manager} ${pkg.name} ${pkg.version} ${namespace}${method}`;
+}
+//# sourceMappingURL=moniker.js.map

package/dist/core/scip/moniker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moniker.js","sourceRoot":"","sources":["../../../src/core/scip/moniker.ts"],"names":[],"mappings":"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"}