scip-query 0.24.0 → 0.26.0

package/dist/chunk-ZO4YXUT6.js

@@ -0,0 +1,4 @@
+import{b as T}from"./chunk-NDUNO5JQ.js";import{i as F}from"./chunk-62BDNPMI.js";import{createRequire as Te}from"module";import{dirname as N,isAbsolute as be,relative as E,resolve as m,sep as R}from"path";import{PositionEncoding as re}from"@c4312/scip";var M=new WeakSet,L=re.UTF16CodeUnitOffsetFromLineStart;function z(t){if(M.has(t))return;let e=t.serialize;if(typeof e!="function")throw new Error("scip-typescript document serializer is unavailable");t.serialize=function(r){let i=e.call(this,r);if(r){r.writeEnum(6,L);return}if(!i)throw new Error("scip-typescript document serializer returned no bytes");let n=new Uint8Array(i.length+2);return n.set(i),n.set([48,L],i.length),n},M.add(t)}import{createHash as ie}from"crypto";var j=new WeakSet;function U(t,e,r){if(j.has(t))return;let i=t.scipSymbol,n=t.descriptor;if(typeof i!="function"||typeof n!="function"||typeof t.cached!="function")throw new Error("scip-typescript symbol runtime has an unsupported module shape");t.scipSymbol=function(o){if(v(o,e))return this.globalSymbolTable.get(o)??this.cached(o,r.global(this.scipSymbol(o.getSourceFile()),r.methodDescriptor("default")));if(!e.isPropertyAssignment(o)&&!e.isShorthandPropertyAssignment(o)&&!e.isObjectLiteralExpression(o))return i.call(this,o);let c=this.globalSymbolTable.get(o);if(c)return c;let s=this.scipSymbol(o.getSourceFile()),a=e.isObjectLiteralExpression(o)?"objectLiteral":o.name.getText(),l=r.metaDescriptor(`${a}$${o.getStart()}`);return this.cached(o,r.global(s,l))},t.descriptor=function(o){return e.isTypeLiteralNode(o)?r.metaDescriptor(`typeLiteral$${o.getStart()}`):n.call(this,o)},j.add(t)}function v(t,e){if(e.isFunctionDeclaration(t))return ne(t,e)?t:null;if(e.isExportAssignment(t)){if(t.isExportEquals||!e.isSourceFile(t.parent))return null;let i=b(t.expression,e);return e.isArrowFunction(i)||e.isFunctionExpression(i)?i:null}if(!e.isArrowFunction(t)&&!e.isFunctionExpression(t))return null;let r=t;for(;r.parent&&b(r.parent,e)===t;)r=r.parent;return r.parent&&e.isExportAssignment(r.parent)?v(r.parent,e):null}function ne(t,e){return!t.name&&e.isSourceFile(t.parent)&&!!e.getModifiers(t)?.some(r=>r.kind===e.SyntaxKind.DefaultKeyword)}function b(t,e){for(;e.isParenthesizedExpression(t)||e.isAsExpression(t)||e.isSatisfiesExpression(t)||e.isNonNullExpression(t)||e.isTypeAssertionExpression(t);)t=t.expression;return t}function $(t,e,r,i,n=new Set){if(t.version!=="5.9.3"||!se(t,e,r))return null;let o=t.BuilderState?.computeDtsSignature;if(!o)return null;try{let c=[];if(o(oe(t,e,n),r,void 0,{createHash:V},a=>c.push(a)),c.length!==1)return null;let s=new k(t,e.getTypeChecker(),i,r).capture(n);return V(JSON.stringify([c[0],s]))}catch{return null}}function oe(t,e,r){if(!r.size)return e;let i=()=>n=>{if(!t.isSourceFile(n))throw new Error("Unsupported bundled declaration boundary");return t.factory.updateSourceFile(n,n.statements.filter(o=>!t.isFunctionDeclaration(o)||!o.name||!r.has(o.name.text)))};return{...e,emit:(...n)=>{let o=[...n];return o[4]={afterDeclarations:[i]},e.emit(...o)}}}function se(t,e,r){return!r.isDeclarationFile&&/\.[cm]?tsx?$/.test(r.fileName)&&t.isExternalModule(r)&&!e.getCompilerOptions().outFile&&e.getSyntacticDiagnostics(r).length===0&&!x(t,r)}function x(t,e){return t.isModuleDeclaration(e)||t.isExportAssignment(e)&&e.isExportEquals?!0:t.forEachChild(e,r=>x(t,r)||void 0)===!0}var k=class{constructor(e,r,i,n){this.ts=e;this.checker=r;this.indexer=i;this.source=n}ts;checker;indexer;source;visited=new Map;nodes=[];capture(e){let r=this.checker.getSymbolAtLocation(this.source);if(!r)throw new Error("Module symbol unavailable");return{roots:this.checker.getExportsOfModule(r).filter(n=>!e.has(n.name)).map(n=>{let o=n.flags&this.ts.SymbolFlags.Alias?this.checker.getAliasedSymbol(n):n;return[n.name,this.origins(o),o.flags&this.ts.SymbolFlags.Value?this.walk(this.checker.getTypeOfSymbol(o)):null,o.flags&this.ts.SymbolFlags.Type?this.walk(this.checker.getDeclaredTypeOfSymbol(o)):null]}),types:this.nodes}}origins(e){if(!e)return null;let i=(e.getDeclarations()??[]).map(n=>{let o=this.indexer.scipSymbol(n).value;if(o&&!o.startsWith("local "))return o;let c=n.getSourceFile();if(!c||n.pos<0)throw new Error("Declaration identity unavailable");return[c.fileName,n.kind,n.getStart(c),n.getText(c)]});return[e.name,i,e.getDocumentationComment(this.checker),e.getJsDocTags(this.checker)]}walk(e){let r=this.visited.get(e);if(r!==void 0)return r;if(this.nodes.length>=2e3)throw new Error("Exported type traversal exceeds its budget");let i=this.nodes.length;this.visited.set(e,i);let n={flags:e.flags};if(this.nodes.push(n),n.symbol=this.origins(e.symbol),n.alias=this.origins(e.aliasSymbol),n.aliasArguments=e.aliasTypeArguments?.map(o=>this.walk(o)),ce(this.ts,e))return i;if(e.isUnionOrIntersection())return n.parts=e.types.map(o=>this.walk(o)),i;if(!(e.flags&this.ts.TypeFlags.Object))throw new Error("Unsupported exported type");return this.object(e,n),i}object(e,r){if(e.objectFlags&this.ts.ObjectFlags.Reference){let i=e;if(r.arguments=this.checker.getTypeArguments(i).map(n=>this.walk(n)),B(i.target.symbol)){r.externalTarget=this.origins(i.target.symbol);return}if(this.checker.isTupleType(e)){r.tuple=!0;return}}if(e.objectFlags&this.ts.ObjectFlags.ClassOrInterface){if(B(e.symbol)){r.externalTarget=this.origins(e.symbol);return}throw new Error("Unsupported exported class or interface")}r.properties=this.checker.getPropertiesOfType(e).map(i=>[i.name,this.origins(i),this.walk(this.checker.getTypeOfSymbol(i))]),r.calls=this.checker.getSignaturesOfType(e,this.ts.SignatureKind.Call).map(i=>this.signature(i)),r.constructors=this.checker.getSignaturesOfType(e,this.ts.SignatureKind.Construct).map(i=>this.signature(i)),r.indexes=this.checker.getIndexInfosOfType(e).map(i=>[this.walk(i.keyType),this.walk(i.type)])}signature(e){if(e.typeParameters?.length||this.checker.getTypePredicateOfSignature(e))throw new Error("Unsupported generic or predicate signature");return{parameters:e.parameters.map(r=>[r.name,this.origins(r),this.walk(this.checker.getTypeOfSymbol(r))]),thisParameter:e.thisParameter?this.walk(this.checker.getTypeOfSymbol(e.thisParameter)):null,returns:this.walk(this.checker.getReturnTypeOfSignature(e))}}};function B(t){let e=t?.getDeclarations();return!!e?.length&&e.every(r=>r.getSourceFile().isDeclarationFile)}function ce(t,e){let r=t.TypeFlags.Unknown|t.TypeFlags.String|t.TypeFlags.Number|t.TypeFlags.Boolean|t.TypeFlags.BooleanLiteral|t.TypeFlags.StringLiteral|t.TypeFlags.NumberLiteral|t.TypeFlags.BigInt|t.TypeFlags.BigIntLiteral|t.TypeFlags.ESSymbol|t.TypeFlags.Void|t.TypeFlags.Undefined|t.TypeFlags.Null|t.TypeFlags.Never;return(e.flags&~r)===0}function V(t){return ie("sha256").update(t).digest("hex")}var w=new WeakMap;function K(t,e,r){w.has(e)||w.set(e,le(t,e));let i=w.get(e);if(!i)return null;let n=ae(i,r);for(let o of n){if(x(t,o))return null;for(let c of i.get(o.fileName)??[])n.add(c.source)}return n}function ae(t,e){let r=new Set;for(let[i,n]of e)for(let o of t.get(i)??[])(o.names===null||o.names.some(c=>n.has(c)))&&r.add(o.source);return r}function D(t,e,r){let i=_(t,e),n=_(t,r),o=new Set([...i.keys(),...n.keys()].filter(l=>i.has(l)!==n.has(l)));if(!o.size)return null;for(let l of o){let p=i.get(l)??n.get(l);if(p?.length!==1||!p[0]?.body)return null}let c=new Set([...o].flatMap(l=>[...i.get(l)??[],...n.get(l)??[]])),s=l=>t.isIdentifier(l)&&o.has(l.text)||t.forEachChild(l,p=>s(p)||void 0)===!0,a=l=>l.statements.filter(p=>!c.has(p));return a(e).some(s)||a(r).some(s)?null:o}function _(t,e){let r=new Map;for(let i of e.statements){if(!t.isFunctionDeclaration(i)||!i.name)continue;let n=t.getModifiers(i);if(!n?.some(c=>c.kind===t.SyntaxKind.ExportKeyword)||n.some(c=>c.kind===t.SyntaxKind.DefaultKeyword||c.kind===t.SyntaxKind.DeclareKeyword))continue;let o=r.get(i.name.text)??[];o.push(i),r.set(i.name.text,o)}return r}function le(t,e){let r=e;if(t.version!=="5.9.3"||!r.getResolvedModuleFromModuleSpecifier)return null;let i=new Map,n=!0,o=(c,s)=>{if(!n)return;let a=ue(t,c);if(a)try{let l=r.getResolvedModuleFromModuleSpecifier(a,s)?.resolvedModule,p=l&&e.getSourceFile(l.resolvedFileName);if(p){let d=i.get(p.fileName)??[];d.push({source:s,names:pe(t,c)}),i.set(p.fileName,d)}}catch{n=!1}t.forEachChild(c,l=>o(l,s))};for(let c of e.getSourceFiles())o(c,c);return n?i:null}function pe(t,e){if(t.isImportDeclaration(e)){let r=e.importClause;return r?r.namedBindings&&!t.isNamedImports(r.namedBindings)?null:[...r.name?["default"]:[],...r.namedBindings?.elements.map(i=>(i.propertyName??i.name).text)??[]]:[]}return t.isExportDeclaration(e)&&e.exportClause&&t.isNamedExports(e.exportClause)?e.exportClause.elements.map(r=>(r.propertyName??r.name).text):null}function ue(t,e){let r;return t.isImportDeclaration(e)||t.isExportDeclaration(e)?r=e.moduleSpecifier:t.isExternalModuleReference(e)?r=e.expression:t.isImportTypeNode(e)&&t.isLiteralTypeNode(e.argument)?r=e.argument.literal:t.isCallExpression(e)&&me(t,e.expression)&&(r=e.arguments[0]),r&&t.isStringLiteralLike(r)?r:null}function me(t,e){return e.kind===t.SyntaxKind.ImportKeyword||t.isIdentifier(e)&&e.text==="require"}var H=new WeakSet;function W(t,e,r){if(H.has(t))return;let i=t.visit;if(typeof i!="function"||typeof t.pushOccurrence!="function")throw new Error("scip-typescript call visitor has an unsupported module shape");t.visit=function(n){if(e.isCallExpression(n)&&n.expression.kind===e.SyntaxKind.SuperKeyword){let o=ye(this.checker,n,e),c=o?this.scipSymbol(o).value:"";if(c){let s=n.getSourceFile(),a=s.getLineAndCharacterOfPosition(n.expression.getStart(s)),l=s.getLineAndCharacterOfPosition(n.expression.getEnd());this.pushOccurrence(new r({range:[a.line,a.character,l.character],symbol:c,symbol_roles:0}))}}i.call(this,n)},H.add(t)}function ye(t,e,r){let i=e.parent;for(;i&&!r.isClassDeclaration(i)&&!r.isClassExpression(i);)i=i.parent;if(!i)return null;let n=J(t,i,r);if(!n)return null;let o=t.getResolvedSignature(e)?.declaration;return o&&r.isConstructorDeclaration(o)?de(t,n,o.parent,r)?o:null:n.members.some(c=>r.isConstructorDeclaration(c))?null:n}function de(t,e,r,i){let n=e,o=new Set;for(;n&&!o.has(n);){if(n===r)return!0;o.add(n),n=J(t,n,i)}return!1}function J(t,e,r){let n=e.heritageClauses?.find(o=>o.token===r.SyntaxKind.ExtendsKeyword)?.types[0]?.expression;return n?q(t,n,r,new Set):null}function q(t,e,r,i){for(;r.isParenthesizedExpression(e);)e=e.expression;if(i.has(e))return null;if(i.add(e),r.isClassExpression(e))return e;if(!r.isIdentifier(e)&&!r.isPropertyAccessExpression(e))return null;let n=ge(t,e,r);return n?r.isClassDeclaration(n)||r.isClassExpression(n)?n:r.isVariableDeclaration(n)&&n.initializer&&n.parent.flags&r.NodeFlags.Const?q(t,n.initializer,r,i):null:null}function ge(t,e,r){let i=t.getSymbolAtLocation(e);i&&(i.flags&r.SymbolFlags.Alias)!==0&&(i=t.getAliasedSymbol(i));let n=i?.declarations??[];return n.length===1?n[0]:null}var G=new WeakSet;function Y(t,e,r){if(G.has(t))return;let i=t.getDeclarationsForPropertyAssignment;if(typeof i!="function")throw new Error("scip-typescript contextual property runtime is unavailable");t.getDeclarationsForPropertyAssignment=function(o){return i.call(this,o)?.filter(c=>c.parent?.kind!==e.SyntaxKind.ObjectLiteralExpression)};let n=t.index;t.index=function(){if(n.call(this),!this.document.occurrences.length)return;let o=new Map;for(let s of this.document.occurrences){if((s.symbol_roles&1)===0)continue;let a=o.get(s.symbol)??[];a.push(s),o.set(s.symbol,a)}let c=s=>{Se(this,s,o,e);let a=v(s,e);a&&(e.isExportAssignment(s)||e.isFunctionDeclaration(s))&&fe(this,s,a,r,e),(e.isCallExpression(s)||e.isNewExpression(s))&&he(this,s,r,e),e.forEachChild(s,c)};c(this.sourceFile)},G.add(t)}function fe(t,e,r,i,n){let o=t.scipSymbol(e).value;if(!o||t.document.occurrences.some(s=>s.symbol===o&&(s.symbol_roles&1)!==0))return;let c=e.getChildren().find(s=>s.kind===n.SyntaxKind.DefaultKeyword)??r.getFirstToken()??r;t.pushOccurrence(new i.Occurrence({symbol:o,symbol_roles:1,range:h(c),enclosing_range:h(r)})),t.document.symbols.some(s=>s.symbol===o)||t.document.symbols.push(new i.SymbolInformation({symbol:o,documentation:[`\`\`\`ts
+${r.getText()}
+\`\`\``]}))}function he(t,e,r,i){let n=e.expression;if(!i.isElementAccessExpression(n))return;let o=b(n.argumentExpression,i);if(o===n.argumentExpression||!(i.isStringLiteralLike(o)||i.isNumericLiteral(o)))return;let s=t.checker.getTypeAtLocation(n.expression).getProperty(o.text)?.declarations??[];if(s.length!==1)return;let a=t.scipSymbol(s[0]).value,l=h(o);a&&!t.document.occurrences.some(p=>p.symbol===a&&Q(p.range,l))&&t.pushOccurrence(new r.Occurrence({symbol:a,symbol_roles:0,range:l}))}function h(t){let e=t.getSourceFile(),r=e.getLineAndCharacterOfPosition(t.getStart(e)),i=e.getLineAndCharacterOfPosition(t.end);return r.line===i.line?[r.line,r.character,i.character]:[r.line,r.character,i.line,i.character]}function Q(t,e){return t.length===e.length&&t.every((r,i)=>r===e[i])}function Se(t,e,r,i){if(i.isPropertyDeclaration(e)||i.isGetAccessorDeclaration(e)||i.isSetAccessorDeclaration(e)||i.isPropertySignature(e)){let n=t.scipSymbol(e).value,o=h(e.name);for(let c of r.get(n)??[])!c.enclosing_range?.length&&Q(c.range,o)&&(c.enclosing_range=h(e))}}var y=Te(import.meta.url),ve=7,X="0.4.0";function Fe(){try{let t=Z();if(!t.available)return t;let{packageRoot:e}=t,r=y.resolve("typescript",{paths:[e]}),i=y(r),{FileIndexer:n}=y(m(e,"dist/src/FileIndexer.js")),{Input:o}=y(m(e,"dist/src/Input.js")),{Packages:c}=y(m(e,"dist/src/Packages.js")),s=y(m(e,"dist/src/scip.js"));if(!n||!o||!c||!s.scip?.Document||!s.scip.Index||!s.scip.Occurrence||!s.scip.SymbolInformation)return{available:!1,reason:"scip-typescript document runtime has an unsupported module shape"};let{ScipSymbol:a}=y(m(e,"dist/src/ScipSymbol.js")),{metaDescriptor:l,methodDescriptor:p}=y(m(e,"dist/src/Descriptor.js"));U(n.prototype,i,{global:a.global,metaDescriptor:l,methodDescriptor:p}),z(s.scip.Document.prototype),W(n.prototype,i,s.scip.Occurrence),Y(n.prototype,i,{Occurrence:s.scip.Occurrence,SymbolInformation:s.scip.SymbolInformation});let d={packageVersion:t.packageVersion,typescript:i,Document:s.scip.Document,Index:s.scip.Index,FileIndexer:n,Input:o,Packages:c};return{available:!0,runtime:d,producerIdentity:A(d)}}catch(t){return{available:!1,reason:`scip-typescript document runtime unavailable: ${t instanceof Error?t.message:String(t)}`}}}function Ke(){let t=Z();return t.available?{available:!0,packageVersion:t.packageVersion,typescriptVersion:t.typescriptVersion,producerIdentity:t.producerIdentity}:t}function Z(){try{let t=y.resolve("@sourcegraph/scip-typescript/package.json"),e=JSON.parse(F(t,"scip-typescript package manifest"));if(e.version!==X)return{available:!1,reason:`unsupported scip-typescript version ${String(e.version??"unknown")}; expected ${X}`};let r=N(t),i=y.resolve("typescript/package.json",{paths:[r]}),n=JSON.parse(F(i,"TypeScript package manifest"));return typeof n.version!="string"||!n.version?{available:!1,reason:"scip-typescript TypeScript compiler version is unavailable"}:{available:!0,packageRoot:r,packageVersion:e.version,typescriptVersion:n.version,producerIdentity:te(e.version,n.version)}}catch(t){return{available:!1,reason:`scip-typescript document producer unavailable: ${t instanceof Error?t.message:String(t)}`}}}function He(t){let e=t.runtime===void 0?Fe():t.runtime===null?{available:!1,reason:"scip-typescript document runtime unavailable"}:{available:!0,runtime:t.runtime,producerIdentity:A(t.runtime)};return e.available?{available:!0,emitter:new I(t,e.runtime)}:e}var I=class{producerIdentity;workspaceRoot;tsconfigPath;projectRoot;maxFileByteSize;runtime;host;config=null;includedFiles=new Set;program=null;checker=null;symbolTable=new Map;constructorTable=new Map;packages;fragments=new Map;documentCache=new T;stats={initializations:0,programUpdates:0,documentsEmitted:0,documentsReused:0,documentsRemoved:0,sourceNodesReused:0,sourceNodesReplaced:0,symbolEntriesPruned:0};constructor(e,r){this.workspaceRoot=m(e.workspaceRoot),this.tsconfigPath=m(this.workspaceRoot,e.tsconfigPath),this.projectRoot=e.projectRoot??De(this.workspaceRoot,N(this.tsconfigPath)),this.maxFileByteSize=e.maxFileByteSize??1024*1024,this.runtime=r,this.producerIdentity=A(r);let i=C(r.typescript,this.tsconfigPath);this.config=i,this.host=new P(r.typescript,i.options,this.workspaceRoot),this.packages=new r.Packages(this.projectRoot)}initialize(){let e=performance.now();this.initializeProgram();let r=[];for(let i of this.program.getSourceFiles())this.includedFiles.has(g(i.fileName))&&r.push(this.emitSourceFile(i));return this.result(r,e)}advance(e){if(!this.program||!this.checker||!this.config)return this.initializeAndAdvance(e);let r=performance.now(),{modifiedFiles:i,removedFiles:n,affectedFiles:o}=Ce(e);if(this.fragments.clear(),i.length===0&&n.length===0)return this.validateAffectedPaths(o),this.result(this.emitAffectedFiles(o),r);let c=this.detachConsumerDocuments(i,n),s=C(this.runtime.typescript,this.tsconfigPath);this.config=s,this.includedFiles=new Set(s.fileNames.map(g));let a=this.program,l=this.invalidateSourceNodes([...i,...n]);return this.program=this.runtime.typescript.createProgram(s.fileNames,s.options,this.host.compilerHost,a),this.checker=this.program.getTypeChecker(),this.stats.programUpdates+=1,this.validateIncrementalPaths(i,n,o),this.stats.documentsRemoved+=n.length,this.recordSourceNodeUpdates(l),this.restoreConsumerDocuments(c,i),this.result(this.emitAffectedFiles(o),r)}restoreCheckpoint(e){if(this.program)throw new Error("TypeScript compiler checkpoint requires a cold emitter");this.host.setSourceOverrides(e.sources,this.workspaceRoot);try{this.initializeProgram(),this.documentCache=e.documents}finally{this.host.setSourceOverrides(new Map,this.workspaceRoot)}}fragment(e){return this.fragments.get(S(e))?.bytes??null}snapshotStats(){return{...this.stats}}initializeAndAdvance(e){let r=performance.now();this.initializeProgram();let i=f(e.modifiedFiles),n=f(e.removedFiles??[]),o=f(e.affectedFiles);return this.fragments.clear(),this.validateIncrementalPaths(i,n,o,!0),this.stats.documentsRemoved+=n.length,this.result(this.emitAffectedFiles(o),r)}initializeProgram(){this.documentCache=new T,this.symbolTable=new Map,this.constructorTable.clear();let e=this.config??C(this.runtime.typescript,this.tsconfigPath);this.includedFiles=new Set(e.fileNames.map(g)),this.program=this.runtime.typescript.createProgram(e.fileNames,e.options,this.host.compilerHost),this.checker=this.program.getTypeChecker(),this.stats.initializations+=1}validateIncrementalPaths(e,r,i,n=!1){if(!n&&e.length===0&&r.length===0)throw new Error("incremental TypeScript document update requires a modified or removed file");if(i.length===0&&r.length===0)throw new Error("incremental TypeScript document update requires an affected or removed file");for(let o of e){let c=u(this.workspaceRoot,o);if(!this.program?.getSourceFile(c))throw new Error(`modified TypeScript dependency is unavailable to the configured project: ${o}`)}for(let o of r){let c=u(this.workspaceRoot,o);if(this.program?.getSourceFile(c))throw new Error(`removed TypeScript source is still present in the configured project: ${o}`)}this.validateAffectedPaths(i)}validateAffectedPaths(e){for(let r of e){let i=u(this.workspaceRoot,r);if(!this.includedFiles.has(g(i)))throw new Error(`affected TypeScript file is outside the configured project: ${r}`)}}emitAffectedFiles(e){return this.stats.symbolEntriesPruned+=this.symbolTable.size+this.constructorTable.size,this.symbolTable=new Map,this.constructorTable.clear(),e.map(r=>{let i=this.program.getSourceFile(u(this.workspaceRoot,r));if(!i)throw new Error(`affected TypeScript source is unavailable: ${r}`);return this.emitSourceFile(i)})}emitSourceFile(e){if(!this.checker)throw new Error("TypeScript document emitter is not initialized");let r=S(E(this.workspaceRoot,e.fileName)),i=this.documentCache.lookup(r);if(i!==void 0){this.stats.documentsReused+=1;let a=we(r,i,this.runtime);return this.fragments.set(r,a),a}let n=new this.runtime.Document({relative_path:r,occurrences:[]});if(this.fileIndexer(e,n).index(),this.stats.documentsEmitted+=1,n.occurrences.length===0)return this.fragments.delete(r),this.stats.documentsRemoved+=1,{relativePath:r,bytes:null,occurrences:0,symbols:n.symbols.length,referenceFragments:[]};let c=n.serializeBinary();this.documentCache.set(r,c);let s={relativePath:r,blobHash:this.documentCache.lookup(r)?.blobHash,byteLength:c.byteLength,bytes:c,occurrences:n.occurrences.length,symbols:n.symbols.length,referenceFragments:ee(r,n)};return this.fragments.set(r,s),s}fileIndexer(e,r){return new this.runtime.FileIndexer(this.checker,{cwd:this.workspaceRoot,projectRoot:this.projectRoot,projectDisplayName:this.projectRoot,maxFileByteSizeNumber:this.maxFileByteSize},new this.runtime.Input(e.fileName,e.getText()),r,this.symbolTable,this.constructorTable,this.packages,e)}captureBoundaries(e,r){let i=new Map;this.symbolTable=new Map,this.constructorTable.clear();for(let n of e){let o=this.program?.getSourceFile(u(this.workspaceRoot,n));if(!o||!this.program)return null;let c=this.fileIndexer(o,new this.runtime.Document({relative_path:n,occurrences:[]})),s=$(this.runtime.typescript,this.program,o,c,r?.get(n));if(s===null)return null;i.set(n,s)}return i}detachConsumerDocuments(e,r){let i=this.documentCache;this.documentCache=new T;let n=this.isolatedChangesFromDisk(e),o=r.length?null:this.captureBoundaries(e,n);return o?{documents:i,boundaries:o,isolatedChanges:n,program:this.program,options:JSON.stringify(this.config.options)}:null}restoreConsumerDocuments(e,r){if(!e||e.options!==JSON.stringify(this.config.options)||!ke(e.program,this.program,r,this.workspaceRoot)||!xe(e.boundaries,this.captureBoundaries(r,e.isolatedChanges)))return;let i=[...r];if(e.isolatedChanges.size){let n=this.verifiedIsolatedChanges(e);if(!n)return;let o=K(this.runtime.typescript,this.program,n);if(!o||[...o].some(c=>!this.includedFiles.has(g(c.fileName))))return;i.push(...[...o].map(c=>S(E(this.workspaceRoot,c.fileName))))}for(let n of i)e.documents.delete(n);e.documents.protectForGeneration(),this.documentCache=e.documents}isolatedChangesFromDisk(e){let r=new Map,i=this.runtime.typescript;for(let n of e){let o=u(this.workspaceRoot,n),c=this.program.getSourceFile(o),s=this.host.compilerHost.readFile(o);if(!c||s===void 0)continue;let a=i.createSourceFile(o,s,i.ScriptTarget.Latest),l=D(i,c,a);l&&r.set(n,l)}return r}verifiedIsolatedChanges(e){let r=new Map;for(let[i,n]of e.isolatedChanges){let o=u(this.workspaceRoot,i),c=e.program.getSourceFile(o),s=this.program.getSourceFile(o),a=D(this.runtime.typescript,c,s);if(!a||a.size!==n.size||[...a].some(l=>!n.has(l)))return null;r.set(s.fileName,a)}return r}invalidateSourceNodes(e){let r=new Map;for(let i of e){let n=u(this.workspaceRoot,i),o=this.program.getSourceFile(n);o&&r.set(i,o),this.host.invalidate(n)}return r}recordSourceNodeUpdates(e){for(let[r,i]of e)this.program.getSourceFile(u(this.workspaceRoot,r))===i?this.stats.sourceNodesReused+=1:this.stats.sourceNodesReplaced+=1}result(e,r){return{producerIdentity:this.producerIdentity,fragments:e,durationMs:performance.now()-r,stats:this.snapshotStats()}}};function we(t,e,r){let i,n,o,c=()=>{if(n!==void 0)return n;let s=e.read();return i=s,n=s===null?null:r.Document.deserializeBinary(s)};return{relativePath:t,blobHash:e.blobHash,byteLength:e.byteLength,get bytes(){return c(),i},get occurrences(){return c()?.occurrences.length??0},get symbols(){return c()?.symbols.length??0},get referenceFragments(){let s=c();return o??=s?ee(t,s):[]}}}function ee(t,e){let r=new Map;for(let i of e.occurrences){if(!i.symbol||(i.symbol_roles&1)!==0||i.range.length<3)continue;let n=i.range[0],o=i.range[1];if(!Number.isInteger(n)||!Number.isInteger(o))continue;let c={targetSymbol:i.symbol,location:{file:t,line:n,column:o}};r.set(`${i.symbol}\0${n}\0${o}`,c)}return[...r.values()].sort((i,n)=>i.targetSymbol.localeCompare(n.targetSymbol)||i.location.line-n.location.line||i.location.column-n.location.column)}var P=class{compilerHost;sourceFiles=new Map;sourceOverrides=new Map;constructor(e,r,i){let n=e.createCompilerHost(r),o=n.readFile.bind(n);n.readFile=s=>this.sourceOverrides.get(g(s))??o(s);let c=n.getSourceFile.bind(n);this.compilerHost={...n,getCurrentDirectory:()=>i,getSourceFile:(s,a,l,p)=>{let d=g(s);if(this.sourceFiles.has(d))return this.sourceFiles.get(d);let O=c(s,a,l,p);return this.sourceFiles.set(d,O),O}}}setSourceOverrides(e,r){this.sourceOverrides.clear();for(let[i,n]of e)this.sourceOverrides.set(g(u(r,i)),n.charCodeAt(0)===65279?n.slice(1):n)}invalidate(e){this.sourceFiles.delete(g(e))}};function ke(t,e,r,i){if(t.getSourceFiles().length!==e.getSourceFiles().length||JSON.stringify(t.getRootFileNames())!==JSON.stringify(e.getRootFileNames()))return!1;let n=new Set(r.map(o=>u(i,o)));return t.getSourceFiles().every((o,c)=>{let s=e.getSourceFiles()[c];return s?.fileName===o.fileName&&(n.has(m(o.fileName))||o===s)})}function xe(t,e){return e!==null&&t.size===e.size&&[...t].every(([r,i])=>e.get(r)===i)}function C(t,e){let r=t.readConfigFile(e,t.sys.readFile);if(r.error)throw new Error(t.formatDiagnostics([r.error],t.createCompilerHost({})));let i=t.parseJsonConfigFileContent(r.config,t.sys,N(e)),n=i.errors.filter(o=>o.code!==18003);if(n.length>0)throw new Error(t.formatDiagnostics(n,t.createCompilerHost({})));return i}function A(t){return te(t.packageVersion,t.typescript.version)}function te(t,e){return`scip-typescript:${t}:typescript:${e}:document-adapter:${ve}`}function De(t,e){return S(E(t,e))||"."}function u(t,e){if(be(e))throw new Error(`expected a project-relative path: ${e}`);let r=m(t,e),i=t.endsWith(R)?t:`${t}${R}`;if(r!==t&&!r.startsWith(i))throw new Error(`path escapes the project root: ${e}`);return r}function f(t){return[...new Set(t.map(S))].sort()}function S(t){return t.split(R).join("/").replace(/^\.\//,"")}function g(t){return m(t)}function Ce(t){let e=f(t.modifiedFiles),r=f(t.removedFiles??[]),i=f(t.affectedFiles);return{modifiedFiles:e,removedFiles:r,affectedFiles:i}}export{Fe as a,Ke as b,He as c};
+//# sourceMappingURL=chunk-ZO4YXUT6.js.map

package/dist/{chunk-MZPXPSUJ.js → chunk-ZR4HBC2H.js}

@@ -1,2 +1,2 @@
-import{a as i}from"./chunk-RVZC6TJE.js";import{a as t}from"./chunk-L7KTFEAV.js";function a(e,o){let r=i(e,o);return r?t(e,"forward",[r]).filter(s=>!e.isIgnored(s)).map(s=>({relativePath:s,edgeBasis:"symbol-references",evidence:"cross-file SCIP references plus resolved source imports"})):[]}function p(e,o){let r=i(e,o);return r?t(e,"reverse",[r]).filter(s=>!e.isIgnored(s)).map(s=>({relativePath:s,edgeBasis:"symbol-references",evidence:"cross-file SCIP references plus resolved source imports"})):[]}export{a,p as b};
-//# sourceMappingURL=chunk-MZPXPSUJ.js.map
+import{a as i}from"./chunk-AOSIYPTA.js";import{a as t}from"./chunk-GCKCF5FL.js";function a(e,o){let r=i(e,o);return r?t(e,"forward",[r]).filter(s=>!e.isIgnored(s)).map(s=>({relativePath:s,edgeBasis:"symbol-references",evidence:"cross-file SCIP references plus resolved source imports"})):[]}function p(e,o){let r=i(e,o);return r?t(e,"reverse",[r]).filter(s=>!e.isIgnored(s)).map(s=>({relativePath:s,edgeBasis:"symbol-references",evidence:"cross-file SCIP references plus resolved source imports"})):[]}export{a,p as b};
+//# sourceMappingURL=chunk-ZR4HBC2H.js.map

package/dist/cli-main.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import{i as pe,j as le,k as v,m as fe,q as he,w as l,y as j}from"./chunk-U2FPY5XA.js";import{a as re,b as oe,d as ie}from"./chunk-3D4BOXW6.js";import{c as ae,d as se,e as ce,f as me,g as de,h as ue}from"./chunk-DUULLZHZ.js";import{Ab as y,Cb as Q,Eb as X,Fb as K,Gb as Z,Hb as ee,Rb as P,Sb as te,Ub as ne,ec as $e,ob as C,pb as Y,zb as S}from"./chunk-NWLVNU66.js";import{A as b,D as M,F as G,I as F,Wa as q,_ as m,_d as J,fa as R,kb as U,lb as L,mb as V,nb as H,ob as z,qe as B,t as _,u as $,z as W}from"./chunk-2XWIUW5Z.js";import{Help as bt,program as d}from"commander";import{existsSync as Rt,realpathSync as Te}from"fs";import{fileURLToPath as St}from"url";var We=new Set(["code","outline","refs"]),Me=["--symbol","--at","--search","--view","--edge","--direction","--subtype","--connecting","--inventory-only","--fold","--depth","--max-edges"];function ge(e){if(e[2]!=="evidence")return;let n=e[3];if(!n||n.startsWith("-"))return;if(e.slice(4).some(o=>Me.some(r=>o===r||o.startsWith(`${r}=`)))){e.splice(3,1,"--symbol",n);return}e[2]="evidence-source"}function Ge(e){return e!==void 0&&We.has(e)}async function Ce(e){if(e==="continue"){let{outputContinuationCommandDescriptor:t}=await import("./output-continuation-command-4UMDOOLO.js");return[t]}if(Ge(e)){let{directNavigationQueryCommandDescriptors:t}=await import("./direct-navigation-4UBC6HNW.js"),i=t.find(o=>o.id===e);if(!i)throw new Error(`Direct navigation command descriptor is unavailable: ${e}`);return[i]}let{commandDescriptors:n}=await import("./command-descriptors-7BKH53Y3.js");return n}import{Option as Ue}from"commander";function D(e){return e.evidence?e.evidence:Fe.has(e.id)?"mixed":e.heuristic?"heuristic":"graph-fact"}var Fe=new Set(["health","context","co-change"]);function ye(e){if(e.claims){if(e.claims.origin==="mixed"&&!e.claims.families?.length)throw new Error(`Mixed command ${e.id} must declare at least one claim family.`);return e.claims}let n=D(e);if(n==="mixed")throw new Error(`Mixed command ${e.id} must declare claim families.`);let t=e.agent?se(e.agent.operation):[];return t.length>0&&t.every(o=>o==="repository-observation"||o==="repository-preview")?{origin:n==="heuristic"?"heuristic":"compiler-graph",observedSources:["index-generation"],producerValidation:{status:"not-evaluated"}}:{origin:"unknown",observedSources:["process"],producerValidation:{status:"not-evaluated"}}}import{basename as qe}from"path";function ve(e=process.argv,n=process.execPath){let t=e[1];return!t||qe(t)==="scip-query"?["scip-query"]:[n,t]}function Ee(e,n){return me(new Map(n.map(t=>[t.id,D(t)]))),ue(new Map(n.map(t=>[t.id,ye(t)]))),de(new Map(n.flatMap(t=>t.agent?[[t.id,{...t.agent,resultUnits:Ve(t)}]]:[]))),n.map(t=>{let i=t.hidden?e.command(t.command,{hidden:!0}):e.command(t.command);i.description(t.description),t.helpAfter&&i.addHelpText("after",`
-${t.helpAfter.trim()}
-`);for(let o of t.arguments??[])i.argument(o.name);for(let o of t.options??[])if(o.hidden){let r=new Ue(o.flags,o.description).hideHelp();o.parser&&r.argParser(o.parser),Object.hasOwn(o,"defaultValue")&&r.default(o.defaultValue),i.addOption(r)}else o.parser&&Object.hasOwn(o,"defaultValue")?i.option(o.flags,o.description,o.parser,o.defaultValue):o.parser?i.option(o.flags,o.description,o.parser):Object.hasOwn(o,"defaultValue")?i.option(o.flags,o.description,o.defaultValue):i.option(o.flags,o.description);return i.action(async(...o)=>{try{let r=i.optsWithGlobals();Le(r);let a=()=>t.id===re?t.handler(...o):oe({command:t.id,producerVersion:m,invocationPrefix:ve(),argv:process.argv.slice(2),cwd:process.cwd(),json:r.json===!0,agentOutput:r.agentOutput===!0,...typeof r.jsonOutput=="string"?{jsonOutputPath:r.jsonOutput}:{},sourceSession:r.session!==!1,reemitSource:r.reemit===!0,...typeof r.outputPageSize=="number"?{pageSize:r.outputPageSize}:{},...typeof r.outputCursor=="string"?{cursor:r.outputCursor}:{}},()=>t.handler(...o)),c=t.agent?ae(t.agent.operation,{args:o.slice(0,-1),options:r}):void 0;await(c?ce(c,a):a())}catch(r){He(r)}}),{descriptor:t,command:i}})}function Le(e){if(e.resultOnly===!0&&e.json!==!0)throw new Error("--result-only requires --json.");if(e.compact===!0&&e.json!==!0)throw new Error("--compact requires --json.");if(e.agentOutput===!0&&e.json!==!0)throw new Error("--agent-output requires --json.");if(typeof e.jsonOutput=="string"&&e.json!==!0)throw new Error("--json-output requires --json.");if(e.rawJson===!0&&e.json!==!0)throw new Error("--raw-json requires --json.");if(e.agentOutput===!0&&e.rawJson===!0)throw new Error("--agent-output cannot be combined with --raw-json.");if(typeof e.jsonOutput=="string"){if(e.agentOutput===!0||e.rawJson===!0)throw new Error("--json-output cannot be combined with --agent-output or --raw-json.");if(e.outputPageSize!==void 0||e.outputCursor!==void 0)throw new Error("--json-output cannot be combined with output pagination.")}if(e.rawJson===!0&&(e.outputPageSize!==void 0||e.outputCursor!==void 0))throw new Error("--raw-json cannot be combined with output pagination.")}function Ve(e){let n=e.agent?.resultUnits;if(n?.kind==="field"&&n.field.trim()==="")throw new Error(`Command ${e.id} declares an empty result-unit field.`);return n||(e.renderShape==="list"||e.renderShape==="table"||e.renderShape==="grouped-by-file"?{kind:"rows"}:{kind:"report"})}function He(e){let n=e instanceof Error?e.message:String(e);console.error(`error: ${te(n)}`),process.exitCode=1}var ze=new Set(j),xe=new Map(j.map((e,n)=>[e,n])),Je=new Set(["Navigation","Graph","Impact","Exploration"]),Be=new Set(["Cleanup","Health"]),Ye=new Set(["Indexing","Core","Maintenance"]);function Qe(e){if(e.hidden||e.agent?.semantic?.compatibility==="deprecated")return"compatibility";if(ze.has(e.id))return"primary-exploration";let n=e.docs?.category;if(n&&Je.has(n))return"specialized-analysis";if(n&&Be.has(n))return"quality-cleanup";if(n&&Ye.has(n))return"maintenance";if(n==="Formal Models")return"formal-modeling";throw new Error(`Visible command ${e.id} has no cockpit panel (docs category: ${n??"missing"}).`)}function Xe(e,n={}){let i=[{id:"primary-exploration",title:"Primary exploration",purpose:"Locate exact referents, project chosen relationships, and read only named implementation gaps."},{id:"specialized-analysis",title:"Specialized analysis",purpose:"Run a named graph, impact, or structural analysis when that exact analysis answers the task."},{id:"quality-cleanup",title:"Quality and cleanup",purpose:"Evaluate repository quality, cleanup candidates, and configured architecture findings."},{id:"maintenance",title:"Maintenance",purpose:"Build, inspect, configure, and maintain the project index and local integrations."},{id:"formal-modeling",title:"Formal modeling",purpose:"Create, verify, and check explicit state-machine models and traces."},{id:"compatibility",title:"Compatibility and deprecated controls",purpose:"Preserved invocation surfaces for existing consumers; do not choose these for new workflows."}].map(r=>({...r,commands:e.filter(a=>Qe(a)===r.id).sort((a,c)=>r.id==="primary-exploration"?(xe.get(a.id)??Number.MAX_SAFE_INTEGER)-(xe.get(c.id)??Number.MAX_SAFE_INTEGER):0)})),o=new Set(["primary-exploration","maintenance"]);return i.filter(r=>r.commands.length>0&&(n.includeCompatibility||o.has(r.id)))}function O(e,n,t={}){let i=[`Usage: ${e.name()} [options] [command]`,"",e.description(),"","Options:"],o=e.options.map(a=>a.flags),r=Math.max(...o.map(a=>a.length),0);for(let a of e.options)i.push(`  ${a.flags.padEnd(r)}  ${a.description}`);i.push(`  ${"-h, --help".padEnd(r)}  Display this grouped command help`);for(let a of Xe(n,t)){i.push("",`${a.title}:`,`  ${a.purpose}`);let c=Math.max(...a.commands.map(s=>s.command.length),0);for(let s of a.commands)i.push(`  ${s.command.padEnd(c)}  ${s.description}`)}return t.includeCompatibility||i.push("","Run `scip-query --help-all` to include advanced, compatibility, and deprecated controls."),i.push("Run `scip-query <command> --help` for one control's options and examples.",""),i.join(`
-`)}import{createHash as Ke}from"crypto";import{lstatSync as Ze}from"fs";import{isAbsolute as et,join as Pe}from"path";var je="git-worktree-context.json",we=16*1024,be=/^[0-9a-f]{40,64}$/,Re=/^[0-9a-f]{24}$/,Se=/^[0-9a-f]{64}$/;function De(e,n,t=b){let i=t!==b||F(),o=i?tt(e,n):void 0;if(o){let a=G(e,o,t);if(a)return a}let r=M(e,t);if(r&&i)try{nt(e,n,r.context,o)}catch{}return r}function tt(e,n){try{let t=R(e,n),i=Pe(t.physicalCacheDir,je),o=Ze(i);if(!o.isFile()||o.isSymbolicLink()||o.size>we)return;let r=JSON.parse(_(i,{inputKind:"Git worktree context receipt",maxBytes:we}));return!rt(r)||r.requestedProjectRoot!==t.record.canonicalProjectRoot||r.cacheOwnerSha256!==t.ownerSha256||r.checksum!==Oe(r)?void 0:r}catch{return}}function nt(e,n,t,i){if(!t.headCommit||!t.treeOid)return;let o=R(e,n),r={version:1,requestedProjectRoot:o.record.canonicalProjectRoot,cacheOwnerSha256:o.ownerSha256,projectRoot:t.projectRoot,gitDir:t.gitDir,commonDir:t.commonDir,repositoryId:t.repositoryId,worktreeId:t.worktreeId,headCommit:t.headCommit,treeOid:t.treeOid},a={...r,checksum:Oe(r)};i?.checksum!==a.checksum&&J(Pe(o.physicalCacheDir,je),a,{spacing:2,trailingNewline:!0})}function rt(e){return ot(e)?e.version===1&&E(e.requestedProjectRoot)&&p(Se,e.cacheOwnerSha256)&&E(e.projectRoot)&&E(e.gitDir)&&E(e.commonDir)&&p(Re,e.repositoryId)&&p(Re,e.worktreeId)&&p(be,e.headCommit)&&p(be,e.treeOid)&&p(Se,e.checksum):!1}function ot(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function E(e){return typeof e=="string"&&et(e)}function Oe(e){return Ke("sha256").update(JSON.stringify({version:e.version,requestedProjectRoot:e.requestedProjectRoot,cacheOwnerSha256:e.cacheOwnerSha256,projectRoot:e.projectRoot,gitDir:e.gitDir,commonDir:e.commonDir,repositoryId:e.repositoryId,worktreeId:e.worktreeId,headCommit:e.headCommit,treeOid:e.treeOid})).digest("hex")}function p(e,n){return typeof n=="string"&&e.test(n)}import{existsSync as it,mkdirSync as at,writeFileSync as st}from"fs";import{homedir as ct}from"os";import{join as x}from"path";var mt=1440*60*1e3,Ae="update-check.json",dt="https://registry.npmjs.org/scip-query/latest";async function I(e={}){let n=e.env??process.env;if(n.SCIP_QUERY_UPDATE_CHECK==="0"||n.NO_UPDATE_NOTIFIER)return;let t=e.cacheDir??lt(n),i=e.now??Date.now(),o=e.currentVersion??m,r=ft(t),a=r&&i-r.checkedAt<mt?r.latestVersion:await ht(t,e.fetchLatestVersion??Ct,i);if(!a||!pt(a,o))return;(e.writeNotice??(s=>console.error(s)))(ut(o,a))}function ut(e,n){return[`scip-query update available: ${e} -> ${n}.`,"Agent: tell your human to update with: npm install -g scip-query@latest",""].join(`
-`)}function pt(e,n){let t=Ie(e),i=Ie(n);if(!t||!i)return e!==n;for(let o=0;o<t.length;o++){let r=t[o]-i[o];if(r>0)return!0;if(r<0)return!1}return!1}function lt(e){let n=e.XDG_CACHE_HOME||x(ct(),".cache");return x(n,"scip-query")}function ft(e){let n=x(e,Ae);if(!it(n))return null;try{let t=JSON.parse($(n,"update notice cache"));return typeof t.checkedAt=="number"&&(typeof t.latestVersion=="string"||t.latestVersion===null)?{checkedAt:t.checkedAt,latestVersion:t.latestVersion}:null}catch{return null}}async function ht(e,n,t){let i;try{i=await n()}catch{i=null}return gt(e,{checkedAt:t,latestVersion:i}),i}function gt(e,n){try{at(e,{recursive:!0}),st(x(e,Ae),`${JSON.stringify(n,null,2)}
-`)}catch{}}async function Ct(){let e=await fetch(dt,{signal:AbortSignal.timeout(1e3)});if(!e.ok)return null;let n=await e.json();return typeof n.version=="string"?n.version:null}function Ie(e){let n=/^v?(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(e);return n?[Number(n[1]),Number(n[2]),Number(n[3])]:null}var yt=5e3,vt=100,Et={prepare:X,freshness:Y,ensureService:v,inspectService:fe,requestRefresh:he,async reindex(e,n,t,i){let{reindexConfiguredProject:o}=await import("./project-reindex-XEQTRCV5.js");return o(e,n,t,i)},wait(e){return new Promise(n=>setTimeout(n,e))},now:Date.now};async function Ne(e,n=Et,t={}){if(e.dbPathSource==="env")return{source:"explicit-index",service:{kind:"skipped",reason:"environment"}};let i=xt(e,n),o=n.prepare(e.projectRoot,e.config,e.paths,{gitContext:e.gitContext,gitObservation:e.gitObservation,...i?{watcherGeneration:i}:{}}),r=o.kind==="local-fresh"&&o.freshness?o.freshness:n.freshness(e.projectRoot,e.config,e.paths,{gitContext:e.gitContext}),a=n.ensureService({commandName:e.commandName,projectRoot:e.projectRoot,cacheDir:e.paths.cacheDir,cliVersion:m,config:e.config,gitContext:e.gitContext});if(r.state==="fresh")return{source:o.kind==="local-fresh"?"existing":"shared-generation",service:a};let c=a.kind==="started"||a.kind==="reused";if(c&&n.requestRefresh(B(e.paths.cacheDir).activityPath,`evidence command ${e.commandName} requires a fresh generation`),C(r))return{source:"stale",service:a};if(c){let s=a.state.watcher.state;if(s==="budget-paused"||s==="indexing")throw new Error(`Could not prepare fresh evidence for scip-query ${e.commandName}: index remained ${r.state} (${r.reason}) while the watcher is ${s}`);if(r=await wt(e,r,n,t,a),r.state==="fresh")return{source:"watcher",service:a};if(C(r))return{source:"stale",service:a}}try{await n.reindex(e.projectRoot,e.config,e.paths,{allowPartial:!1,skipAutoInstall:!0,trigger:{kind:"watch-demand",detail:`scip-query ${e.commandName}`},onStatus:()=>{}})}catch(s){throw new Error(`Could not prepare fresh evidence for scip-query ${e.commandName}: ${s instanceof Error?s.message:String(s)}`,{cause:s})}if(r=n.freshness(e.projectRoot,e.config,e.paths,{gitContext:e.gitContext}),r.state!=="fresh"&&!C(r))throw new Error(`Could not prepare fresh evidence for scip-query ${e.commandName}: index remained ${r.state} (${r.reason})`);return{source:"synchronous-reindex",service:a}}function xt(e,n){if(e.config.watch?.enabled===!0)try{return pe(n.inspectService({projectRoot:e.projectRoot,cacheDir:e.paths.cacheDir,cliVersion:m,gitContext:e.gitContext}))}catch{return}}async function wt(e,n,t,i,o){if(o.state.watcher.state==="budget-paused")return n;let r=Math.max(0,i.waitMs??yt),a=Math.max(1,i.pollMs??vt),c=t.now()+r,s=n;for(;t.now()<c;)if(await t.wait(Math.min(a,Math.max(1,c-t.now()))),s=t.freshness(e.projectRoot,e.config,e.paths,{gitContext:e.gitContext}),s.state==="fresh")return s;return s}async function ke(e,n={}){try{await e()}catch(t){let i=t instanceof Error?t.message:String(t);console.error(`error: ${i}`),(n.debug??process.env.SCIP_QUERY_DEBUG!==void 0)&&t instanceof Error&&t.stack&&console.error(t.stack),process.exitCode=1}}var w=Dt();w&&(ne(),d.configureOutput({writeOut:e=>process.stdout.write(P(e)),writeErr:e=>process.stderr.write(P(e))}));d.name("scip-query").description("Language-agnostic code intelligence CLI powered by SCIP indexes").version(m).option("--output-page-size <characters>","Return bounded output pages with an exact continuation command",ie).option("--output-cursor <cursor>","Continue a bounded output page").option("--agent-output","Emit a bounded JSON projection for model-facing clients (requires --json)").option("--json-output <path>","Atomically write the complete JSON result and print a small receipt").option("--raw-json","Explicitly retain the legacy unpaged JSON stream (requires --json)").option("--no-session","Disable the explicit exploration evidence ledger").option("--reemit","Recovery only: render source and graph evidence again instead of citing session receipts").option("--help-all","Display every command, including compatibility and deprecated controls");w&&ge(process.argv);var N=await Ce(w?process.argv[2]:void 0);Ee(d,N);var f,Pt=new bt;d.configureHelp({formatHelp:(e,n)=>e===d?O(d,N):Pt.formatHelp(e,n)});d.hook("preAction",async(e,n)=>{let t=n.name();if(t==="continue"){A();return}let i=K(t),o=le(t);if(i&&(f=W()),!i&&!o){A(),await I({commandName:t});return}let r=S(),a=Q(r);y(a),A(),await I({commandName:t});let c=De(r,a.paths.cacheDir),s=c?.context;a={...a,gitContext:s},y(a);let{config:k,paths:T}=a;if(i){let u;try{u=await Ne({commandName:t,projectRoot:r,config:k,paths:T,dbPathSource:a.dbPathSource,gitContext:s,gitObservation:c})}catch(g){if(!Z(t)||!Rt(a.dbPath))throw g;let _e=g instanceof Error?g.message:String(g);console.error(`warning: index refresh failed; ${t} is using the existing index. Current file text remains exact, but index-derived symbols and relationships may be stale. ${_e}`),l(r,m,{repositoryId:s?.repositoryId??null});return}process.env.SCIP_QUERY_DEBUG&&console.error(`evidence-freshness: ${u.source}`),u.service.kind==="failed"&&console.error(`warning: scip-query watch service did not start: ${u.service.message}`),(u.service.kind==="failed"||u.service.kind==="skipped")&&l(r,m,{repositoryId:s?.repositoryId??null});return}if(!o){l(r,m,{repositoryId:s?.repositoryId??null});return}let h=v({commandName:t,projectRoot:r,cacheDir:T.cacheDir,cliVersion:m,config:k,gitContext:s});h.kind==="failed"&&console.error(`warning: scip-query watch service did not start: ${h.message}`),(h.kind==="failed"||h.kind==="skipped")&&l(r,m,{repositoryId:s?.repositoryId??null})});d.hook("postAction",()=>{y(void 0),f?.(),f=void 0});function A(){if(V(),!U()||H())return;let e=null,n=null;try{n=ee(S()),e=q(n)}catch{}finally{n?.close()}z({command:L()??`scip-query ${process.argv.slice(2).join(" ")}`,toolVersion:m,projectFingerprint:e})}async function jt(){try{process.argv.includes("--help-all")?process.stdout.write(O(d,N,{includeCompatibility:!0})):await d.parseAsync()}finally{f?.(),f=void 0}}w&&await ke(jt);function Dt(){if(!process.argv[1])return!1;let e=St(import.meta.url);try{return Te(e)===Te(process.argv[1])}catch{return e===process.argv[1]}}export{d as program,$e as renderHeuristicNotice,jt as runCli};
+import{i as ce,j as de,k as C,m as me,q as ue,w as y}from"./chunk-L7GFM3NP.js";import{a as Z,b as ee,d as te}from"./chunk-B56T42J3.js";import{c as ne,d as re,e as oe,f as ie,g as ae,h as se}from"./chunk-EYK3ZAO2.js";import{Db as R,Eb as X,Gb as K,Sb as ke,ib as h,jb as H,lb as b,mb as g,ob as z,qb as J,rb as B,sb as Y,tb as Q}from"./chunk-JYWEX7RR.js";import{C as T,E as W,H as _,Re as V,Wa as $,_ as d,fa as w,kb as M,lb as F,mb as G,nb as U,ob as q,s as A,t as N,y as k,ye as L,z as x}from"./chunk-OZCJXZK6.js";import{Help as Dt,program as m}from"commander";import{existsSync as jt,realpathSync as Ie}from"fs";import{fileURLToPath as It}from"url";var Te=new Set(["code","outline","refs"]);function We(e){return e!==void 0&&Te.has(e)}async function pe(e){if(e==="continue"){let{outputContinuationCommandDescriptor:n}=await import("./output-continuation-command-BJSY67SN.js");return[n]}if(We(e)){let{directNavigationQueryCommandDescriptors:n}=await import("./direct-navigation-Y5B6OSIQ.js"),r=n.find(o=>o.id===e);if(!r)throw new Error(`Direct navigation command descriptor is unavailable: ${e}`);return[r]}let{commandDescriptors:t}=await import("./command-descriptors-HEEMDHTU.js");return t}import{Option as Me}from"commander";function S(e){return e.evidence?e.evidence:_e.has(e.id)?"mixed":e.heuristic?"heuristic":"graph-fact"}var _e=new Set(["health","context","co-change"]);function le(e){if(e.claims){if(e.claims.origin==="mixed"&&!e.claims.families?.length)throw new Error(`Mixed command ${e.id} must declare at least one claim family.`);return e.claims}let t=S(e);if(t==="mixed")throw new Error(`Mixed command ${e.id} must declare claim families.`);let n=e.agent?re(e.agent.operation):[];return n.length>0&&n.every(o=>o==="repository-observation"||o==="repository-preview")?{origin:t==="heuristic"?"heuristic":"compiler-graph",observedSources:["index-generation"],producerValidation:{status:"not-evaluated"}}:{origin:"unknown",observedSources:["process"],producerValidation:{status:"not-evaluated"}}}import{basename as $e}from"path";function fe(e=process.argv,t=process.execPath){let n=e[1];return!n||$e(n)==="scip-query"?["scip-query"]:[t,n]}function he(e,t){return ie(new Map(t.map(n=>[n.id,S(n)]))),se(new Map(t.map(n=>[n.id,le(n)]))),ae(new Map(t.flatMap(n=>n.agent?[[n.id,{...n.agent,resultUnits:qe(n)}]]:[]))),t.map(n=>{let r=n.hidden?e.command(n.command,{hidden:!0}):e.command(n.command);r.description(n.description),n.helpAfter&&r.addHelpText("after",`
+${n.helpAfter.trim()}
+`);for(let o of n.arguments??[])r.argument(o.name);for(let o of n.options??[])Ve(r,o);return r.action(async(...o)=>{try{let i=r.optsWithGlobals();Fe(i);let a=()=>n.id===Z?n.handler(...o):ee({command:n.id,producerVersion:d,invocationPrefix:fe(),argv:process.argv.slice(2),cwd:process.cwd(),json:i.json===!0,agentOutput:i.agentOutput===!0,...typeof i.jsonOutput=="string"?{jsonOutputPath:i.jsonOutput}:{},sourceSession:i.session!==!1,reemitSource:i.reemit===!0,...typeof i.outputPageSize=="number"?{pageSize:i.outputPageSize}:{},...typeof i.outputCursor=="string"?{cursor:i.outputCursor}:{}},()=>n.handler(...o)),s=n.agent?ne(n.agent.operation,{args:o.slice(0,-1),options:i}):void 0;await(s?oe(s,a):a())}catch(i){Le(i)}}),{descriptor:n,command:r}})}function Fe(e){if(Ue(e),e.agentOutput===!0&&e.rawJson===!0)throw new Error("--agent-output cannot be combined with --raw-json.");if(Ge(e),e.rawJson===!0&&(e.outputPageSize!==void 0||e.outputCursor!==void 0))throw new Error("--raw-json cannot be combined with output pagination.")}function Ge(e){if(typeof e.jsonOutput=="string"){if(e.agentOutput===!0||e.rawJson===!0)throw new Error("--json-output cannot be combined with --agent-output or --raw-json.");if(e.outputPageSize!==void 0||e.outputCursor!==void 0)throw new Error("--json-output cannot be combined with output pagination.")}}function Ue(e){let t=(n,r)=>{if(r&&e.json!==!0)throw new Error(`${n} requires --json.`)};t("--result-only",e.resultOnly===!0),t("--compact",e.compact===!0),t("--agent-output",e.agentOutput===!0),t("--json-output",typeof e.jsonOutput=="string"),t("--raw-json",e.rawJson===!0)}function qe(e){let t=e.agent?.resultUnits;if(t?.kind==="field"&&t.field.trim()==="")throw new Error(`Command ${e.id} declares an empty result-unit field.`);return t||(e.renderShape==="list"||e.renderShape==="table"||e.renderShape==="grouped-by-file"?{kind:"rows"}:{kind:"report"})}function Le(e){let t=e instanceof Error?e.message:String(e);console.error(`error: ${X(t)}`),process.exitCode=1}function Ve(e,t){if(t.hidden){let n=new Me(t.flags,t.description).hideHelp();t.parser&&n.argParser(t.parser),Object.hasOwn(t,"defaultValue")&&n.default(t.defaultValue),e.addOption(n)}else t.parser&&Object.hasOwn(t,"defaultValue")?e.option(t.flags,t.description,t.parser,t.defaultValue):t.parser?e.option(t.flags,t.description,t.parser):Object.hasOwn(t,"defaultValue")?e.option(t.flags,t.description,t.defaultValue):e.option(t.flags,t.description)}var Ce=["system","context","evidence","health","review","diff-impact","architecture"],He=new Set(Ce),ge=new Map(Ce.map((e,t)=>[e,t])),ze=new Set(["Navigation","Graph","Impact","Exploration"]),Je=new Set(["Cleanup","Health"]),Be=new Set(["Indexing","Core","Maintenance"]);function Ye(e){if(e.hidden||e.agent?.semantic?.compatibility==="deprecated")return"compatibility";if(He.has(e.id))return"primary-exploration";let t=e.docs?.category,n=Xe(t);if(n)return n;throw new Error(`Visible command ${e.id} has no cockpit panel (docs category: ${t??"missing"}).`)}function Qe(e,t={}){let r=[{id:"primary-exploration",title:"Relationships and quality",purpose:"Inspect structure, reuse existing code, find problems and review changes."},{id:"specialized-analysis",title:"Specialized analysis",purpose:"Run a named graph, impact, or structural analysis when that exact analysis answers the task."},{id:"quality-cleanup",title:"Quality and cleanup",purpose:"Evaluate repository quality, cleanup candidates, and configured architecture findings."},{id:"maintenance",title:"Maintenance",purpose:"Manage the index and local integrations."},{id:"compatibility",title:"Compatibility and deprecated controls",purpose:"Preserved invocation surfaces for existing consumers; do not choose these for new workflows."}].map(i=>({...i,commands:e.filter(a=>Ye(a)===i.id).sort((a,s)=>i.id==="primary-exploration"?(ge.get(a.id)??Number.MAX_SAFE_INTEGER)-(ge.get(s.id)??Number.MAX_SAFE_INTEGER):0)})),o=new Set(["primary-exploration","maintenance"]);return r.filter(i=>i.commands.length>0&&(t.includeCompatibility||o.has(i.id)))}function P(e,t,n={}){let r=[`Usage: ${e.name()} [options] [command]`,"",e.description(),"","Options:"],o=e.options.map(a=>a.flags),i=Math.max(...o.map(a=>a.length),0);for(let a of e.options)r.push(`  ${a.flags.padEnd(i)}  ${a.description}`);r.push(`  ${"-h, --help".padEnd(i)}  Display this grouped command help`);for(let a of Qe(t,n)){r.push("",`${a.title}:`,`  ${a.purpose}`);let s=Math.max(...a.commands.map(c=>c.command.length),0);for(let c of a.commands)r.push(`  ${c.command.padEnd(s)}  ${c.description}`)}return n.includeCompatibility||r.push("","Run `scip-query --help-all` to include advanced, compatibility, and deprecated controls."),r.push("Run `scip-query <command> --help` for one control's options and examples.",""),r.join(`
+`)}function Xe(e){if(e&&ze.has(e))return"specialized-analysis";if(e&&Je.has(e))return"quality-cleanup";if(e&&Be.has(e))return"maintenance"}import{createHash as Ke}from"crypto";import{lstatSync as Ze}from"fs";import{isAbsolute as et,join as xe}from"path";var we="git-worktree-context.json",ye=16*1024,ve=/^[0-9a-f]{40,64}$/,Ee=/^[0-9a-f]{24}$/,be=/^[0-9a-f]{64}$/;function Re(e,t,n=x){let r=n!==x||_(),o=r?tt(e,t):void 0;if(o){let a=W(e,o,n);if(a)return a}let i=T(e,n);if(i&&r)try{nt(e,t,i.context,o)}catch{}return i}function tt(e,t){try{let n=w(e,t),r=xe(n.physicalCacheDir,we),o=Ze(r);if(!o.isFile()||o.isSymbolicLink()||o.size>ye)return;let i=JSON.parse(A(r,{inputKind:"Git worktree context receipt",maxBytes:ye}));return!rt(i)||i.requestedProjectRoot!==n.record.canonicalProjectRoot||i.cacheOwnerSha256!==n.ownerSha256||i.checksum!==Se(i)?void 0:i}catch{return}}function nt(e,t,n,r){if(!n.headCommit||!n.treeOid)return;let o=w(e,t),i={version:1,requestedProjectRoot:o.record.canonicalProjectRoot,cacheOwnerSha256:o.ownerSha256,projectRoot:n.projectRoot,gitDir:n.gitDir,commonDir:n.commonDir,repositoryId:n.repositoryId,worktreeId:n.worktreeId,headCommit:n.headCommit,treeOid:n.treeOid},a={...i,checksum:Se(i)};r?.checksum!==a.checksum&&L(xe(o.physicalCacheDir,we),a,{spacing:2,trailingNewline:!0})}function rt(e){return ot(e)?e.version===1&&v(e.requestedProjectRoot)&&p(be,e.cacheOwnerSha256)&&v(e.projectRoot)&&v(e.gitDir)&&v(e.commonDir)&&p(Ee,e.repositoryId)&&p(Ee,e.worktreeId)&&it(e):!1}function ot(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function v(e){return typeof e=="string"&&et(e)}function Se(e){return Ke("sha256").update(JSON.stringify({version:e.version,requestedProjectRoot:e.requestedProjectRoot,cacheOwnerSha256:e.cacheOwnerSha256,projectRoot:e.projectRoot,gitDir:e.gitDir,commonDir:e.commonDir,repositoryId:e.repositoryId,worktreeId:e.worktreeId,headCommit:e.headCommit,treeOid:e.treeOid})).digest("hex")}function p(e,t){return typeof t=="string"&&e.test(t)}function it(e){return p(ve,e.headCommit)&&p(ve,e.treeOid)&&p(be,e.checksum)}import{existsSync as at,mkdirSync as st,writeFileSync as ct}from"fs";import{homedir as dt}from"os";import{join as E}from"path";var mt=1440*60*1e3,Oe="update-check.json",ut="https://registry.npmjs.org/scip-query/latest";async function O(e={}){let t=e.env??process.env;if(t.SCIP_QUERY_UPDATE_CHECK==="0"||t.NO_UPDATE_NOTIFIER)return;let n=e.cacheDir??ft(t),r=e.now??Date.now(),o=e.currentVersion??d,i=ht(n),a=i&&r-i.checkedAt<mt?i.latestVersion:await gt(n,e.fetchLatestVersion??yt,r);vt(a,o,e)}function pt(e,t){return[`scip-query update available: ${e} -> ${t}.`,"Agent: tell your human to update with: npm install -g scip-query@latest",""].join(`
+`)}function lt(e,t){let n=Pe(e),r=Pe(t);if(!n||!r)return e!==t;for(let o=0;o<n.length;o++){let i=n[o]-r[o];if(i>0)return!0;if(i<0)return!1}return!1}function ft(e){let t=e.XDG_CACHE_HOME||E(dt(),".cache");return E(t,"scip-query")}function ht(e){let t=E(e,Oe);if(!at(t))return null;try{let n=JSON.parse(N(t,"update notice cache"));return typeof n.checkedAt=="number"&&(typeof n.latestVersion=="string"||n.latestVersion===null)?{checkedAt:n.checkedAt,latestVersion:n.latestVersion}:null}catch{return null}}async function gt(e,t,n){let r;try{r=await t()}catch{r=null}return Ct(e,{checkedAt:n,latestVersion:r}),r}function Ct(e,t){try{st(e,{recursive:!0}),ct(E(e,Oe),`${JSON.stringify(t,null,2)}
+`)}catch{}}async function yt(){let e=await fetch(ut,{signal:AbortSignal.timeout(1e3)});if(!e.ok)return null;let t=await e.json();return typeof t.version=="string"?t.version:null}function Pe(e){let t=/^v?(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(e);return t?[Number(t[1]),Number(t[2]),Number(t[3])]:null}function vt(e,t,n){if(!e||!lt(e,t))return;(n.writeNotice??(o=>console.error(o)))(pt(t,e))}var Et=5e3,xt=100,wt={prepare:J,freshness:H,ensureService:C,inspectService:me,requestRefresh:ue,async reindex(e,t,n,r){let{reindexConfiguredProject:o}=await import("./project-reindex-EP24WT4X.js");return o(e,t,n,r)},wait(e){return new Promise(t=>setTimeout(t,e))},now:Date.now};function bt(e,t){let n=Pt(e,t),r=t.prepare(e.projectRoot,e.config,e.paths,{gitContext:e.gitContext,gitObservation:e.gitObservation,...n?{watcherGeneration:n}:{}}),o=r.kind==="local-fresh"&&r.freshness?r.freshness:t.freshness(e.projectRoot,e.config,e.paths,{gitContext:e.gitContext});return{prepared:r,freshness:o}}async function Rt(e,t,n,r,o){let i=o.state.watcher.state;if(i==="budget-paused"||i==="indexing")throw new Error(`Could not prepare fresh evidence for scip-query ${e.commandName}: index remained ${t.state} (${t.reason}) while the watcher is ${i}`);let a=await Ot(e,t,n,r,o);return a.state==="fresh"?{source:"watcher",service:o}:h(a)?{source:"stale",service:o}:null}async function St(e,t,n){try{await t.reindex(e.projectRoot,e.config,e.paths,{allowPartial:!1,skipAutoInstall:!0,trigger:{kind:"watch-demand",detail:`scip-query ${e.commandName}`},onStatus:()=>{}})}catch(o){throw new Error(`Could not prepare fresh evidence for scip-query ${e.commandName}: ${o instanceof Error?o.message:String(o)}`,{cause:o})}let r=t.freshness(e.projectRoot,e.config,e.paths,{gitContext:e.gitContext});if(r.state!=="fresh"&&!h(r))throw new Error(`Could not prepare fresh evidence for scip-query ${e.commandName}: index remained ${r.state} (${r.reason})`);return{source:"synchronous-reindex",service:n}}async function De(e,t=wt,n={}){if(e.dbPathSource==="env")return{source:"explicit-index",service:{kind:"skipped",reason:"environment"}};let{prepared:r,freshness:o}=bt(e,t),i=t.ensureService({commandName:e.commandName,projectRoot:e.projectRoot,cacheDir:e.paths.cacheDir,cliVersion:d,config:e.config,gitContext:e.gitContext});if(o.state==="fresh")return{source:r.kind==="local-fresh"?"existing":"shared-generation",service:i};let a=i.kind==="started"||i.kind==="reused";if(a&&t.requestRefresh(V(e.paths.cacheDir).activityPath,`evidence command ${e.commandName} requires a fresh generation`),h(o))return{source:"stale",service:i};if(a){let s=await Rt(e,o,t,n,i);if(s)return s}return St(e,t,i)}function Pt(e,t){if(e.config.watch?.enabled===!0)try{return ce(t.inspectService({projectRoot:e.projectRoot,cacheDir:e.paths.cacheDir,cliVersion:d,gitContext:e.gitContext}))}catch{return}}async function Ot(e,t,n,r,o){if(o.state.watcher.state==="budget-paused")return t;let i=Math.max(0,r.waitMs??Et),a=Math.max(1,r.pollMs??xt),s=n.now()+i,c=t;for(;n.now()<s;)if(await n.wait(Math.min(a,Math.max(1,s-n.now()))),c=n.freshness(e.projectRoot,e.config,e.paths,{gitContext:e.gitContext}),c.state==="fresh")return c;return c}async function je(e,t={}){try{await e()}catch(n){let r=n instanceof Error?n.message:String(n);console.error(`error: ${r}`),(t.debug??process.env.SCIP_QUERY_DEBUG!==void 0)&&n instanceof Error&&n.stack&&console.error(n.stack),process.exitCode=1}}var j=_t();function At(e,t){return e==="system"&&t.source===!0?{prepareSharedCache:!1,startWatchService:!1}:{prepareSharedCache:B(e),startWatchService:de(e)}}j&&(K(),m.configureOutput({writeOut:e=>process.stdout.write(R(e)),writeErr:e=>process.stderr.write(R(e))}));m.name("scip-query").description("Language-agnostic code intelligence CLI powered by SCIP indexes").version(d).option("--output-page-size <characters>","Return bounded output pages with an exact continuation command",te).option("--output-cursor <cursor>","Continue a bounded output page").option("--agent-output","Emit a bounded JSON projection for model-facing clients (requires --json)").option("--json-output <path>","Atomically write the complete JSON result and print a small receipt").option("--raw-json","Explicitly retain the legacy unpaged JSON stream (requires --json)").option("--no-session","Disable the explicit exploration evidence ledger").option("--reemit","Recovery only: render source and graph evidence again instead of citing session receipts").option("--help-all","Display every command, including compatibility and deprecated controls");var I=await pe(j?process.argv[2]:void 0);he(m,I);var f,Nt=new Dt;m.configureHelp({formatHelp:(e,t)=>e===m?P(m,I):Nt.formatHelp(e,t)});async function kt(e){let t=b(),n=z(t);g(n),D(),await O({commandName:e});let r=Re(t,n.paths.cacheDir),o=r?.context;return n={...n,gitContext:o},g(n),{projectRoot:t,projectContext:n,gitObservation:r}}async function Tt(e,t){let{projectRoot:n,projectContext:r,gitObservation:o}=t,{config:i,paths:a,gitContext:s}=r,c;try{c=await De({commandName:e,projectRoot:n,config:i,paths:a,dbPathSource:r.dbPathSource,gitContext:s,gitObservation:o})}catch(u){if(!Y(e)||!jt(r.dbPath))throw u;let l=u instanceof Error?u.message:String(u);console.error(`warning: index refresh failed; ${e} is using the existing index. Current file text remains exact, but index-derived symbols and relationships may be stale. ${l}`),y(n,d,{repositoryId:s?.repositoryId??null});return}process.env.SCIP_QUERY_DEBUG&&console.error(`evidence-freshness: ${c.source}`),Ae(c.service,n,s)}function Ae(e,t,n){e.kind==="failed"&&console.error(`warning: scip-query watch service did not start: ${e.message}`),(e.kind==="failed"||e.kind==="skipped")&&y(t,d,{repositoryId:n?.repositoryId??null})}m.hook("preAction",async(e,t)=>{let n=t.name();if(n==="continue"){D();return}let{prepareSharedCache:r,startWatchService:o}=At(n,t.opts());if(r&&(f=k()),!r&&!o){D(),await O({commandName:n});return}let i=await kt(n),{projectRoot:a,projectContext:s}=i,{config:c,paths:u,gitContext:l}=s;if(r){await Tt(n,i);return}if(!o){y(a,d,{repositoryId:l?.repositoryId??null});return}let Ne=C({commandName:n,projectRoot:a,cacheDir:u.cacheDir,cliVersion:d,config:c,gitContext:l});Ae(Ne,a,l)});m.hook("postAction",()=>{g(void 0),f?.(),f=void 0});function D(){if(G(),!M()||U())return;let e=null,t=null;try{t=Q(b()),e=$(t)}catch{}finally{t?.close()}q({command:F()??`scip-query ${process.argv.slice(2).join(" ")}`,toolVersion:d,projectFingerprint:e})}async function Wt(){try{process.argv.includes("--help-all")?process.stdout.write(P(m,I,{includeCompatibility:!0})):await m.parseAsync()}finally{f?.(),f=void 0}}j&&await je(Wt);function _t(){if(!process.argv[1])return!1;let e=It(import.meta.url);try{return Ie(e)===Ie(process.argv[1])}catch{return e===process.argv[1]}}export{m as program,ke as renderHeuristicNotice,Wt as runCli};
 //# sourceMappingURL=cli-main.js.map

package/dist/cli.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import{realpathSync as s}from"fs";import{fileURLToPath as n}from"url";async function t(e,r={}){try{await e()}catch(o){let i=o instanceof Error?o.message:String(o);console.error(`error: ${i}`),(r.debug??process.env.SCIP_QUERY_DEBUG!==void 0)&&o instanceof Error&&o.stack&&console.error(o.stack),process.exitCode=1}}c()&&await t(async()=>{let e=process.argv.slice(2),r=!1;if(l(e)){let{tryRunQueryServiceFastPath:o}=await import("./query-service-fastpath.js");r=await o(e)}if(!r){let{runCli:o}=await import("./cli-main.js");await o()}});function c(){if(!process.argv[1])return!1;let e=n(import.meta.url);try{return s(e)===s(process.argv[1])}catch{return e===process.argv[1]}}function l(e){return(e[0]==="search"||e[0]==="outline"||e[0]==="code"||e[0]==="entrypoints"||e[0]==="files"||e[0]==="stats"||e[0]==="members"||e[0]==="methods"||e[0]==="deps"||e[0]==="rdeps"||e[0]==="imported-by"||e[0]==="hierarchy"||e[0]==="by-kind"||e[0]==="kind-counts"||e[0]==="refs"||e[0]==="trace"||e[0]==="value-flow"||e[0]==="dependence-slice"||e[0]==="call-graph"||e[0]==="reference-neighborhood"||e[0]==="reference-reachability"||e[0]==="slice"||e[0]==="dataflow"||e[0]==="imports"||e[0]==="unused-imports"||e[0]==="system"||e[0]==="surface")&&e.includes("--json")&&e.includes("--result-only")&&e.includes("--compact")&&process.env.SCIP_QUERY_PROFILE!=="1"&&process.env.SCIP_QUERY_PROFILE!=="true"}
+import{realpathSync as n}from"fs";import{fileURLToPath as s}from"url";async function t(r,e={}){try{await r()}catch(o){let i=o instanceof Error?o.message:String(o);console.error(`error: ${i}`),(e.debug??process.env.SCIP_QUERY_DEBUG!==void 0)&&o instanceof Error&&o.stack&&console.error(o.stack),process.exitCode=1}}a()&&await t(async()=>{let r=process.argv.slice(2),e=!1;if(c(r)){let{tryRunQueryServiceFastPath:o}=await import("./query-service-fastpath.js");e=await o(r)}if(!e){let{runCli:o}=await import("./cli-main.js");await o()}});function a(){if(!process.argv[1])return!1;let r=s(import.meta.url);try{return n(r)===n(process.argv[1])}catch{return r===process.argv[1]}}function c(r){return r.includes("--json")&&r.includes("--result-only")&&r.includes("--compact")&&process.env.SCIP_QUERY_PROFILE!=="1"&&process.env.SCIP_QUERY_PROFILE!=="true"}
 //# sourceMappingURL=cli.js.map

package/dist/{code-B17qEMbt.d.ts → code-BNyrCF3_.d.ts}

@@ -84,7 +84,7 @@ interface CodeBatchEntry {
     suggestions: string[];
     fileCoverage?: CodeFileCoverage;
     rangeCoverage?: CodeRangeCoverage;
-    reason?: 'definition-source-unreadable' | 'definition-not-found';
+    reason?: 'definition-source-unreadable' | 'definition-not-found' | 'definition-index-stale';
 }
 /**
  * A complete accounting of several exact source or file-surface selectors.
@@ -116,6 +116,7 @@ declare function code(db: ScipDatabase, symbolPattern: string, opts?: {
 declare function codeBatch(db: ScipDatabase, selectors: readonly string[], opts?: {
     context?: number;
     members?: CodeFileMemberMode;
+    localCalls?: boolean;
 }): CodeBatchResult;
 
-export { type BindingClosure as B, type CodeResult as C, type BindingDefinitionEvidence as a, type CodeBatchEntry as b, type CodeBatchResult as c, type CodeFileCoverage as d, type CodeFileDefinitionLedgerEntry as e, type CodeFileMemberMode as f, type CodeRangeCoverage as g, type CodeResolutionCandidate as h, type CodeSelectorKind as i, type CodeSelectorStatus as j, type CoveredSourceRange as k, code as l, codeBatch as m };
+export { type BindingClosure as B, type CodeBatchEntry as C, type BindingDefinitionEvidence as a, type CodeBatchResult as b, type CodeFileCoverage as c, type CodeFileDefinitionLedgerEntry as d, type CodeFileMemberMode as e, type CodeRangeCoverage as f, type CodeResolutionCandidate as g, type CodeResult as h, type CodeSelectorKind as i, type CodeSelectorStatus as j, type CoveredSourceRange as k, code as l, codeBatch as m };

package/dist/code-IL5WH3NZ.js

@@ -0,0 +1,2 @@
+import{c as a,d as b}from"./chunk-H4EQHO6J.js";import"./chunk-PAVGPRHJ.js";import"./chunk-OGFV2BUX.js";import"./chunk-H73WY2RM.js";import"./chunk-ZHMRSZFD.js";import"./chunk-ZGTYGDMF.js";import"./chunk-WRQXLNYE.js";import"./chunk-DVFP6PZI.js";import"./chunk-QIWXRW72.js";import"./chunk-LOVIZBJ4.js";import"./chunk-QXEUDXBT.js";import"./chunk-O2C4UILI.js";import"./chunk-WXU3DGPU.js";import"./chunk-YUKYB54I.js";import"./chunk-J5FJMODQ.js";import"./chunk-WOFQ5DTB.js";import"./chunk-PH52RA7D.js";import"./chunk-7Y5T6XDP.js";import"./chunk-X6RMKHJQ.js";import"./chunk-JEVRKFRL.js";import"./chunk-QOIXNWQR.js";import"./chunk-GZKFETP5.js";import"./chunk-HRRFKWPZ.js";import"./chunk-YULZRALL.js";import"./chunk-HGFDYOVB.js";import"./chunk-TKD34PHN.js";import"./chunk-2HLAFUCY.js";import"./chunk-U5RIG3JP.js";import"./chunk-62BDNPMI.js";export{a as code,b as codeBatch};
+//# sourceMappingURL=code-IL5WH3NZ.js.map

package/dist/code-result-json-ANTBEDFP.js

@@ -0,0 +1,4 @@
+import{b as m,d}from"./chunk-QXEUDXBT.js";import"./chunk-J5FJMODQ.js";import"./chunk-WOFQ5DTB.js";import"./chunk-PH52RA7D.js";import"./chunk-7Y5T6XDP.js";import"./chunk-X6RMKHJQ.js";import"./chunk-JEVRKFRL.js";import"./chunk-QOIXNWQR.js";import"./chunk-GZKFETP5.js";import"./chunk-HRRFKWPZ.js";import{c as l}from"./chunk-YULZRALL.js";import"./chunk-HGFDYOVB.js";import"./chunk-TKD34PHN.js";import"./chunk-2HLAFUCY.js";import"./chunk-U5RIG3JP.js";import"./chunk-62BDNPMI.js";function i(n,e){let t=m(n,e);return t.match?{matched:!0,resolved:{symbol:t.match.symbol,shortName:l(t.match.symbol),relativePath:t.match.relativePath},otherMatches:t.candidates.map(s=>({shortName:s.shortName,relativePath:s.relativePath,startLine:s.startLine})),totalMatches:t.total}:{matched:!1,suggestions:d(n,e,5)}}function v(n,e,t,s){return{...i(n,e),[s]:t}}function h(n){let e=n.entries[0];return n.requested===1&&e?.status==="matched"&&e.kind==="source"&&(!e.rangeCoverage||e.rangeCoverage.referencedDefinitions===0)&&e.results.length===1?e.results[0]:null}function u(n,e,t){if(!t)return i(n,e);let s={file:t.relativePath,symbol:t.shortName,language:t.language??"unknown",range:{startLine:o(t.startLine),endLine:o(t.endLine)},...t.freshness?{freshness:t.freshness}:{},lines:t.source.split(`
+`).map((c,g)=>({line:o(t.startLine+g),text:c}))},a=i(n,e),r=a.totalMatches??0;return!a.matched||!a.resolved||r<=1?s:{...s,resolution:{selected:a.resolved,alternatives:a.otherMatches??[],totalMatches:r}}}function f(n){return{requested:n.requested,matched:n.matched,ambiguous:n.ambiguous,missing:n.missing,entries:n.entries.map(e=>({selector:e.selector,status:e.status,kind:e.kind,totalCandidates:e.totalCandidates,sources:e.results.map(t=>({file:t.relativePath,symbol:t.shortName,language:t.language??"unknown",range:{startLine:o(t.startLine),endLine:o(t.endLine)},...t.freshness?{freshness:t.freshness}:{},lines:t.source.split(`
+`).map((s,a)=>({line:o(t.startLine+a),text:s}))})),definitions:e.definitions,...e.fileCoverage?{fileCoverage:e.fileCoverage}:{},...e.rangeCoverage?{rangeCoverage:e.rangeCoverage}:{},candidates:e.candidates,omittedCandidates:e.omittedCandidates,suggestions:e.suggestions,...e.reason?{reason:e.reason}:{}})),literalValues:n.bindingClosure.inline}}function C(n,e,t){let s=h(t);return s?u(n,e[0],s):f(t)}function o(n){return n+1}export{f as codeBatchResultOnlyJson,C as codeBatchResultOnlyJsonForSelectors,u as codeResultOnlyJson,h as singleExactCodeResult,i as symbolResolutionJson,v as withSymbolResolutionJson};
+//# sourceMappingURL=code-result-json-ANTBEDFP.js.map