Understand any codebase instantly. System intelligence for codebases, built for humans and AI.
TypeScript aiai-memoryclaude-codeclicode-analysiscode-mappingcode-memorycodebase-understandingcodexdeveloper-toolsllmopenclawpersistent-memoryprogram-analysissoftware-architecturesystem-intelligencesystem-mapping
fix(context): put only the leading members ahead of the files around a target
KageBinary988403270d53
diff --git a/ix-cli/src/cli/__tests__/context-evidence-locations.test.ts b/ix-cli/src/cli/__tests__/context-evidence-locations.test.tsindex e030bd2d..cc6846fb 100644--- a/ix-cli/src/cli/__tests__/context-evidence-locations.test.ts+++ b/ix-cli/src/cli/__tests__/context-evidence-locations.test.ts@@ -140,6 +140,22 @@ describe("ix context evidence says where things are", () => {expect(paths.fromOld).toBe("src/old.ts");});+ it("does not let a large file's members crowd out the files around it", () => {+ // `ingest.ts` has over a hundred members. Putting all of them ahead of the+ // context nodes filled a 50-entity budget and cut `supported-extensions.ts`,+ // the file a cross-file question about it needed.+ const many = Array.from({ length: 60 }, (_, i) =>+ member(`m-${i}`, `fn${i}`, [i + 1, i + 2], [60 - i, 1]));+ const imported = node("n-ext", "supported-extensions.ts", "file", "src/cli/supported-extensions.ts");+ const b = bundle({ facts: facts({ memberRefs: many, members: many.map((m) => m.name) }), nodes: [imported] });++ const names = b.entities.map((e) => e.name);+ expect(names.slice(1, 11)).toEqual(many.slice(0, 10).map((m) => m.name));+ expect(names).toContain("supported-extensions.ts");+ expect(names.indexOf("supported-extensions.ts")).toBeLessThan(names.indexOf("fn10"));+ expect(b.entities).toHaveLength(50);+ });+it("reads provenance from the chain /v1/provenance actually returns", () => {const b = bundle({provenance: {diff --git a/ix-cli/src/cli/commands/context.ts b/ix-cli/src/cli/commands/context.tsindex 43335b9b..2a24ffce 100644--- a/ix-cli/src/cli/commands/context.ts+++ b/ix-cli/src/cli/commands/context.ts@@ -1406,27 +1406,36 @@ export function buildBundle(input: BuildInput): ContextBundle {stale,},];- // The entities the facts collector located, most relevant first: members in- // usage order, then the named callers and dependents. They go ahead of the- // backend's context nodes, which are ordered by kind and name, so the entity- // budget cuts what matters least. They also carry the paths and lines that- // the backend's node summaries do not.- const located = [- ...(facts.memberRefs ?? []),+ // The entities the facts collector located, most relevant first: the+ // top-ranked members, then the named callers and dependents. They go ahead of+ // the backend's context nodes, which are ordered by kind and name, so the+ // entity budget cuts what matters least. They also carry the paths and lines+ // that the backend's node summaries do not.+ //+ // Only the leading members jump the queue. A large file has more members than+ // the whole entity budget -- `ingest.ts` in the Ix repo has over a hundred --+ // and putting all of them first crowded out the files it imports and is+ // imported by, which are what cross-file questions need. The rest follow the+ // context nodes.+ const memberRefs = facts.memberRefs ?? [];+ const pushLocated = (refs: EntityLocation[]) => {+ for (const ref of refs) {+ if (seen.has(ref.id)) continue;+ seen.add(ref.id);+ entities.push({+ id: ref.id,+ name: ref.name,+ kind: ref.kind,+ ...locationFields(ref),+ stale: false, // replaced below, for the entities that survive the budget+ });+ }+ };+ pushLocated([+ ...memberRefs.slice(0, LEADING_MEMBERS),...(facts.topCallerRefs ?? []),...(facts.topDependentRefs ?? []),- ];- for (const ref of located) {- if (seen.has(ref.id)) continue;- seen.add(ref.id);- entities.push({- id: ref.id,- name: ref.name,- kind: ref.kind,- ...locationFields(ref),- stale: false, // replaced below, for the entities that survive the budget- });- }+ ]);// Compact and standard backend responses omit the full graph arrays and// carry the same graph as summaries. Falling back here keeps the default// context mode from collapsing to a target-only bundle.@@ -1454,6 +1463,7 @@ export function buildBundle(input: BuildInput): ContextBundle {stale: false, // replaced below, for the entities that survive the budget});}+ pushLocated(memberRefs.slice(LEADING_MEMBERS));// Relationships: graph edges, ordered deterministically.const contextEdges = context.edges.length > 0 ? context.edges : (context.edgeSummaries ?? []);@@ -1632,7 +1642,7 @@ function rankEvidence(input: {reason: "calls, imports or references the target", refs: ref ? [ref.id] : [], ...locationField(ref),});}- for (const { name, ref } of related(input.facts.members, input.facts.memberRefs, 10)) {+ for (const { name, ref } of related(input.facts.members, input.facts.memberRefs, LEADING_MEMBERS)) {structural.push({id: `member:${name}`, source: "facts.members", title: `member ${name}`,reason: ref ? memberReason(ref) : "defined in the target", refs: ref ? [ref.id] : [], ...locationField(ref),@@ -1787,6 +1797,9 @@ export function renderBundle(bundle: ContextBundle, format: string): void {console.log();}+/** Members placed ahead of the backend's context nodes; the evidence shows as many. */+const LEADING_MEMBERS = 10;+type Located = { path?: string; lineStart?: number; lineEnd?: number };/** `path`, `lineStart` and `lineEnd`, omitting the unknown ones rather than writing `undefined`. */