codebaseiq 0.1.0

package/dist/cli-context-3SNLDYBM.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import{C as a,D as b,E as c,F as d,G as e,H as f,I as g,J as h,K as i,L as j,M as k,N as l,O as m,P as n,Q as o}from"./chunk-G6XFR4ZL.js";import"./chunk-2X7V4HS4.js";import"./chunk-SNNWPCN7.js";export{b as activateCliProjectContext,m as collect,c as currentCliDatabase,n as formatBytes,o as formatStatus,h as openDb,i as openProjectDb,f as prepareWorktreeIndex,e as resolveActiveDbPath,d as resolveCliProjectContext,a as resolveProjectRoot,j as rootIndexFallbackWarning,k as setResidentDatabaseProvider,g as sharedCachePreparationEligible,l as withDb};
+//# sourceMappingURL=cli-context-3SNLDYBM.js.map

package/dist/cli-context-T3B7W6GG.js

@@ -0,0 +1,2 @@
+import{E as a,F as b,G as c,H as d,I as e,J as f,K as g,L as h,M as i,N as j,O as k,P as l,Q as m,R as n,S as o}from"./chunk-Z54RD7VL.js";import"./chunk-QW7EP6WI.js";import"./chunk-FM5BPL4V.js";import"./chunk-RDBI2RXU.js";import"./chunk-R2NOK63J.js";import"./chunk-EF2R3WNQ.js";import"./chunk-WE5RZHZ7.js";export{b as activateCliProjectContext,m as collect,c as currentCliDatabase,n as formatBytes,o as formatStatus,h as openDb,i as openProjectDb,f as prepareWorktreeIndex,e as resolveActiveDbPath,d as resolveCliProjectContext,a as resolveProjectRoot,j as rootIndexFallbackWarning,k as setResidentDatabaseProvider,g as sharedCachePreparationEligible,l as withDb};
+//# sourceMappingURL=cli-context-T3B7W6GG.js.map

package/dist/cli-program-YNOXO72B.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import{b as Y,c as Z,d as h,e as ee,h as te,j as g}from"./chunk-DR2LURYU.js";import{c as G,d as B,e as J,f as K,g as Q,h as X}from"./chunk-UXM43C7T.js";import{n as L,p as q,r as H}from"./chunk-ECQBG7PW.js";import{a as y,b as k}from"./chunk-XZEE23VG.js";import{C as M,D as u,F,H as U,I as V,N as W,o as I,p as $,q as T,r as _}from"./chunk-G6XFR4ZL.js";import{e as z}from"./chunk-3JSXXYTZ.js";import{d as D}from"./chunk-DO6WQD2T.js";import{$ as j,Z as R,_ as N,aa as A,ba as O,l as c}from"./chunk-2X7V4HS4.js";import{c as P,q as S}from"./chunk-SNNWPCN7.js";import{c as ne}from"./chunk-C74PPYLA.js";import{c as re}from"./chunk-B3UYV66Z.js";import"./chunk-362QOSFD.js";import"./chunk-B2OB55RR.js";import{Command as _e,Help as Me}from"commander";import{Option as pe}from"commander";function x(e){return e.evidence?e.evidence:ue.has(e.id)?"mixed":e.heuristic?"heuristic":"graph-fact"}var ue=new Set(["health","context","co-change"]);function oe(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=x(e);if(t==="mixed")throw new Error(`Mixed command ${e.id} must declare claim families.`);let n=e.agent?B(e.agent.operation):[];return n.length>0&&n.every(r=>r==="repository-observation"||r==="repository-preview")?{origin:t==="heuristic"?"heuristic":"compiler-graph",observedSources:["index-generation"],producerValidation:{status:"not-evaluated"}}:{origin:"unknown",observedSources:["process"],producerValidation:{status:"not-evaluated"}}}var ie;function ae(){return ie||{argv:process.argv.slice(2),execPath:process.execPath,...process.argv[1]!==void 0?{scriptPath:process.argv[1]}:{},cwd:process.cwd()}}function se(e,t){return K(new Map(t.map(n=>[n.id,x(n)]))),X(new Map(t.map(n=>[n.id,oe(n)]))),Q(new Map(t.flatMap(n=>n.agent?[[n.id,{...n.agent,resultUnits:he(n)}]]:[]))),t.map(n=>{let i=n.hidden?e.command(n.command,{hidden:!0}):e.command(n.command);i.description(n.description),n.helpAfter&&i.addHelpText("after",`
+${n.helpAfter.trim()}
+`);for(let r of n.arguments??[])i.argument(r.name);for(let r of n.options??[])if(r.hidden){let o=new pe(r.flags,r.description).hideHelp();r.parser&&o.argParser(r.parser),Object.hasOwn(r,"defaultValue")&&o.default(r.defaultValue),i.addOption(o)}else r.parser&&Object.hasOwn(r,"defaultValue")?i.option(r.flags,r.description,r.parser,r.defaultValue):r.parser?i.option(r.flags,r.description,r.parser):Object.hasOwn(r,"defaultValue")?i.option(r.flags,r.description,r.defaultValue):i.option(r.flags,r.description);return i.action(async(...r)=>{try{let o=i.optsWithGlobals();fe(o);let a=ae(),s=()=>n.id===L?n.handler(...r):q({command:n.id,producerVersion:c,invocationPrefix:a.scriptPath?[a.execPath,a.scriptPath]:["codebaseiq"],argv:[...a.argv],cwd:a.cwd,json:o.json===!0,sourceSession:o.session!==!1,reemitSource:o.reemit===!0,...typeof o.outputPageSize=="number"?{pageSize:o.outputPageSize}:{},...typeof o.outputCursor=="string"?{cursor:o.outputCursor}:{}},()=>n.handler(...r)),m=n.agent?G(n.agent.operation,{args:r.slice(0,-1),options:o}):void 0;await(m?J(m,s):s())}catch(o){ge(o)}finally{u(void 0),T()}}),{descriptor:n,command:i}})}function fe(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.")}function he(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 ge(e){let t=e instanceof Error?e.message:String(e);console.error(`error: ${k(t)}`),process.exitCode=1}import{existsSync as Ce,mkdirSync as ve,writeFileSync as ye}from"fs";import{homedir as xe}from"os";import{join as C}from"path";var Ee=1440*60*1e3,me="update-check.json",be="https://registry.npmjs.org/codebaseiq/latest";async function E(e={}){let t=e.env??process.env;if(t.CODEBASEIQ_UPDATE_CHECK==="0"||t.NO_UPDATE_NOTIFIER)return;let n=e.cacheDir??Se(t),i=e.now??Date.now(),r=e.currentVersion??c,o=De(n),a=o&&i-o.checkedAt<Ee?o.latestVersion:await Re(n,e.fetchLatestVersion??je,i);if(!a||!Pe(a,r))return;(e.writeNotice??(m=>console.error(m)))(we(r,a))}function we(e,t){return[`codebaseiq update available: ${e} -> ${t}.`,"Agent: tell your human to update with: npm install -g codebaseiq@latest",""].join(`
+`)}function Pe(e,t){let n=ce(e),i=ce(t);if(!n||!i)return e!==t;for(let r=0;r<n.length;r++){let o=n[r]-i[r];if(o>0)return!0;if(o<0)return!1}return!1}function Se(e){let t=e.XDG_CACHE_HOME||C(xe(),".cache");return C(t,"codebaseiq")}function De(e){let t=C(e,me);if(!Ce(t))return null;try{let n=JSON.parse(S(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 Re(e,t,n){let i;try{i=await t()}catch{i=null}return Ne(e,{checkedAt:n,latestVersion:i}),i}function Ne(e,t){try{ve(e,{recursive:!0}),ye(C(e,me),`${JSON.stringify(t,null,2)}
+`)}catch{}}async function je(){let e=await fetch(be,{signal:AbortSignal.timeout(1e3)});if(!e.ok)return null;let t=await e.json();return typeof t.version=="string"?t.version:null}function ce(e){let t=/^v?(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(e);return t?[Number(t[1]),Number(t[2]),Number(t[3])]:null}var Ae=5e3,Oe=100,Ie={prepare:U,freshness:I,ensureService:h,inspectService:ee,requestRefresh:te,async reindex(e,t,n,i){let{reindexConfiguredProject:r}=await import("./project-reindex-UQBIKO4M.js");return r(e,t,n,i)},wait(e){return new Promise(t=>setTimeout(t,e))},now:Date.now};async function de(e,t=Ie,n={}){if(e.dbPathSource==="env")return{source:"explicit-index",service:{kind:"skipped",reason:"environment"}};let i=$e(e,t),r=t.prepare(e.projectRoot,e.config,e.paths,{gitContext:e.gitContext,...i?{watcherGeneration:i}:{}}),o=t.freshness(e.projectRoot,e.config,e.paths),a=t.ensureService({commandName:e.commandName,projectRoot:e.projectRoot,cacheDir:e.paths.cacheDir,cliVersion:c,config:e.config,gitContext:e.gitContext});if(o.state==="fresh")return{source:r.kind==="local-fresh"?"existing":"shared-generation",service:a};if((a.kind==="started"||a.kind==="reused")&&(t.requestRefresh(D(e.paths.cacheDir).activityPath,`evidence command ${e.commandName} requires a fresh generation`),o=await Te(e,o,t,n,a),o.state==="fresh"))return{source:"watcher",service:a};try{await t.reindex(e.projectRoot,e.config,e.paths,{allowPartial:!1,skipAutoInstall:!0,trigger:{kind:"watch-demand",detail:`codebaseiq ${e.commandName}`},onStatus:()=>{}})}catch(s){throw new Error(`Could not prepare fresh evidence for codebaseiq ${e.commandName}: ${s instanceof Error?s.message:String(s)}`,{cause:s})}if(o=t.freshness(e.projectRoot,e.config,e.paths),o.state!=="fresh")throw new Error(`Could not prepare fresh evidence for codebaseiq ${e.commandName}: index remained ${o.state} (${o.reason})`);return{source:"synchronous-reindex",service:a}}function $e(e,t){if(e.config.watch?.enabled===!0)try{return Y(t.inspectService({projectRoot:e.projectRoot,cacheDir:e.paths.cacheDir,cliVersion:c,gitContext:e.gitContext}))}catch{return}}async function Te(e,t,n,i,r){if(r.state.watcher.state==="budget-paused")return t;let o=Math.max(0,i.waitMs??Ae),a=Math.max(1,i.pollMs??Oe),s=n.now()+o,m=t;for(;n.now()<s;)if(await n.wait(Math.min(a,Math.max(1,s-n.now()))),_(),m=n.freshness(e.projectRoot,e.config,e.paths),m.state==="fresh")return m;return m}async function Pt(e={}){let t=new _e;e.resident&&t.exitOverride(),e.terminalOutput&&t.configureOutput({writeOut:r=>process.stdout.write(y(r)),writeErr:r=>process.stderr.write(y(r))}),t.name("codebaseiq").description("Language-agnostic code intelligence CLI powered by SCIP indexes").version(c).option("--output-page-size <characters>","Return bounded output pages with an exact continuation command",H).option("--output-cursor <cursor>","Continue a bounded output page").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");let n=await ne(e.invocationCommand);se(t,n);let i=new Me;return t.configureHelp({formatHelp:(r,o)=>r===t?re(t,n):i.formatHelp(r,o)}),t.hook("preAction",async(r,o)=>{let a=o.name();if(e.resident){await e.resident.preAction(a);return}let s=V(a),m=Z(a);if(!s&&!m){le(),await E({commandName:a});return}let d=M(),p=P(d);$(p);let v=F(d,p);u(v),le(),await E({commandName:a});let{config:b,paths:w}=v;if(s){let l=await de({commandName:a,projectRoot:d,config:b,paths:w,dbPathSource:v.dbPathSource,gitContext:p});process.env.CODEBASEIQ_DEBUG&&console.error(`evidence-freshness: ${l.source}`),l.service.kind==="failed"&&console.error(`warning: codebaseiq watch service did not start: ${l.service.message}`),(l.service.kind==="failed"||l.service.kind==="skipped")&&g(d,c);return}if(!m){g(d,c);return}let f=h({commandName:a,projectRoot:d,cacheDir:w.cacheDir,cliVersion:c,config:b,gitContext:p});f.kind==="failed"&&console.error(`warning: codebaseiq watch service did not start: ${f.message}`),(f.kind==="failed"||f.kind==="skipped")&&g(d,c)}),t.hook("postAction",()=>u(void 0)),{program:t,descriptors:n}}function le(){if(j(),!R()||A())return;let e=null;try{e=W(t=>z(t))}catch{}O({command:N()??`codebaseiq ${process.argv.slice(2).join(" ")}`,toolVersion:c,projectFingerprint:e})}export{Pt as createCliProgram};
+//# sourceMappingURL=cli-program-YNOXO72B.js.map

package/dist/cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import{b as n}from"./chunk-QCN62RTF.js";import{d as s}from"./chunk-XZEE23VG.js";import"./chunk-DO6WQD2T.js";import"./chunk-SNNWPCN7.js";import{realpathSync as p}from"fs";import{fileURLToPath as y}from"url";import{constants as a,setPriority as u}from"os";var m="CODEBASEIQ_PROCESS_PRIORITY";function P(r=process.env){let o=r[m]?.trim().toLowerCase();return o==="low"||o==="idle"?o:null}function c(r=process.env,o=u){let e=P(r);if(e===null)return null;let t=e==="idle"?a.priority.PRIORITY_LOW:a.priority.PRIORITY_BELOW_NORMAL;try{o(t)}catch{}return e}f()&&(c(),s(),await d());async function d(){let r=process.argv.includes("--help-all");if(!r){let i=await n(process.argv.slice(2));if(i.served)return;process.env.CODEBASEIQ_DEBUG&&console.error(`query-lane: ${i.reason}`)}let{normalizeLegacyEvidenceInvocation:o}=await import("./invocation-command-descriptors-QT2JMY5J.js");o(process.argv);let{createCliProgram:e}=await import("./cli-program-YNOXO72B.js"),{program:t,descriptors:l}=await e({...process.argv[2]!==void 0?{invocationCommand:process.argv[2]}:{},terminalOutput:!0});if(r){let{renderRootCommandHelp:i}=await import("./command-panels-SZONPMLJ.js");process.stdout.write(i(t,l,{includeCompatibility:!0}));return}await t.parseAsync()}function f(){if(!process.argv[1])return!1;let r=y(import.meta.url);try{return p(r)===p(process.argv[1])}catch{return r===process.argv[1]}}
+//# sourceMappingURL=cli.js.map

package/dist/code-DlqpBDd0.d.ts

@@ -0,0 +1,121 @@
+import { S as SourceObservationFreshness } from './repository-text-C0Q8VYdN.js';
+import { S as ScipDatabase } from './db-D7sauVFH.js';
+import { OutlineNode } from './queries/outline.js';
+
+interface BindingDefinitionEvidence {
+    name: string;
+    relativePath: string;
+    startLine: number;
+    endLine: number;
+    source: string;
+}
+/**
+ * Literal project values needed to interpret a returned source range.
+ *
+ * This is a bounded evidence enhancement, not a lexical-completeness claim:
+ * callable, dynamic, external-package, and non-foldable bindings stay silent
+ * instead of becoming exploration obligations.
+ */
+interface BindingClosure {
+    coverage: 'indexed-project-literal-values';
+    inline: BindingDefinitionEvidence[];
+}
+interface CoveredSourceRange {
+    relativePath: string;
+    startLine: number;
+    endLine: number;
+}
+
+interface CodeResult {
+    symbol: string;
+    shortName: string;
+    relativePath: string;
+    startLine: number;
+    endLine: number;
+    language: string | null;
+    source: string;
+    freshness?: SourceObservationFreshness;
+    bindingClosure?: BindingClosure;
+}
+
+type CodeSelectorStatus = 'matched' | 'ambiguous' | 'missing';
+type CodeSelectorKind = 'source' | 'file-source';
+type CodeFileMemberMode = 'exported' | 'all';
+interface CodeResolutionCandidate {
+    symbol: string;
+    shortName: string;
+    relativePath: string;
+    startLine: number;
+    endLine: number;
+}
+interface CodeFileDefinitionLedgerEntry extends CodeResolutionCandidate {
+    signature: string | null;
+    depth: number;
+    nestedDefinitions: number;
+}
+interface CodeFileCoverage {
+    members: CodeFileMemberMode;
+    basis: 'explicit-exports-and-same-file-reference-closure' | 'top-level-and-same-file-reference-closure' | 'complete-file-source';
+    totalDefinitions: number;
+    returnedDefinitions: number;
+    returnedBodies: number;
+    omittedDefinitions: number;
+    omittedLedger: CodeFileDefinitionLedgerEntry[];
+}
+/** Semantic coverage added to an exact line-range selector. */
+interface CodeRangeCoverage {
+    basis: 'requested-range-and-same-file-call-closure';
+    referencedDefinitions: number;
+    returnedDefinitions: number;
+    returnedBodies: number;
+    omittedDefinitions: number;
+    omittedLedger: CodeResolutionCandidate[];
+}
+/** One selector's exact outcome inside a complete multi-selector code packet. */
+interface CodeBatchEntry {
+    selector: string;
+    status: CodeSelectorStatus;
+    kind: CodeSelectorKind;
+    totalCandidates: number;
+    results: CodeResult[];
+    definitions: OutlineNode[];
+    candidates: CodeResolutionCandidate[];
+    omittedCandidates: number;
+    suggestions: string[];
+    fileCoverage?: CodeFileCoverage;
+    rangeCoverage?: CodeRangeCoverage;
+    reason?: 'definition-source-unreadable' | 'definition-not-found';
+}
+/**
+ * A complete accounting of several exact source or file-surface selectors.
+ *
+ * The packet never ranks selectors against each other or drops one for a byte
+ * budget. Ambiguity is an explicit result, never a silent first-match choice.
+ */
+interface CodeBatchResult {
+    requested: number;
+    matched: number;
+    ambiguous: number;
+    missing: number;
+    entries: CodeBatchEntry[];
+    bindingClosure: BindingClosure;
+}
+/**
+ * Read the source code for a symbol, bounded to its definition range.
+ * Language-agnostic: just reads the file and extracts the relevant lines.
+ *
+ * Accepts:
+ *   - Symbol name pattern: "processVegaMention"
+ *   - Full short name: "src:modules:chat:processVegaMention"
+ *   - File:line-line syntax: "src/chat/service.ts:100-200"
+ */
+declare function code(db: ScipDatabase, symbolPattern: string, opts?: {
+    context?: number;
+}): CodeResult | null;
+/** Read up to 24 selectors with complete, per-selector resolution accounting. */
+declare function codeBatch(db: ScipDatabase, selectors: readonly string[], opts?: {
+    context?: number;
+    members?: CodeFileMemberMode;
+}): 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 };