indexer-cli 0.3.5 → 0.3.7

package/dist/core/types.d.ts

@@ -192,3 +192,69 @@ export interface GitOperations {
         sinceDays?: number;
     }): Promise<Record<string, number>>;
 }
+export type ContextPackIntent = "bugfix" | "feature" | "refactor" | "investigation" | "unknown";
+export type ContextPackProfile = "routing" | "balanced" | "deep";
+export interface SelectedScope {
+    pathPrefixes: string[];
+    confidence: number;
+    why: string[];
+}
+export interface ModuleGoal {
+    module: string;
+    goal: string;
+    confidence: number;
+    evidenceSources: string[];
+}
+export interface ContextPackDependencyEdge {
+    from: string;
+    to: string;
+}
+export interface ArchitectureSlice {
+    entrypoints: string[];
+    relatedModules: string[];
+    dependencies: ContextPackDependencyEdge[];
+}
+export interface StructureSliceFile {
+    path: string;
+    module: string;
+    language?: string;
+}
+export interface StructureSliceSymbol {
+    file: string;
+    name: string;
+    kind: string;
+    signature?: string;
+}
+export interface StructureSlice {
+    files: StructureSliceFile[];
+    keySymbols: StructureSliceSymbol[];
+}
+export interface SemanticHit {
+    filePath: string;
+    score: number;
+    primarySymbol?: string;
+    reason: string;
+    snippet?: string;
+}
+export interface NextRead {
+    file: string;
+    reason: string;
+}
+export interface PackMeta {
+    estimatedTokens: number;
+    budget: number;
+    profile: ContextPackProfile;
+    confidenceBand: "low" | "medium" | "high";
+    omitted: string[];
+}
+export interface ContextPackResult {
+    task: string;
+    intent: ContextPackIntent;
+    selected_scope: SelectedScope;
+    module_goals: ModuleGoal[];
+    architecture_slice: ArchitectureSlice;
+    structure_slice: StructureSlice;
+    semantic_hits: SemanticHit[];
+    next_reads: NextRead[];
+    _meta: PackMeta;
+}

package/dist/engine/context-pack.d.ts

@@ -0,0 +1,70 @@
+import type { ContextPackIntent, ContextPackProfile, ContextPackResult, GitOperations, MetadataStore, PackMeta, ProjectId, SnapshotId } from "../core/types.js";
+import type { SearchEngine } from "./searcher.js";
+type ContextPackScope = {
+    kind: "all";
+} | {
+    kind: "changed";
+} | {
+    kind: "relevant-to";
+    value: string;
+} | {
+    kind: "path-prefix";
+    value: string;
+};
+type ContextPackSearch = Pick<SearchEngine, "search">;
+export type ContextPackBuildOptions = {
+    budget?: number;
+    profile?: ContextPackProfile;
+    scope?: string;
+    maxModules?: number;
+    maxFiles?: number;
+    maxSnippets?: number;
+    minScore?: number;
+    explainSymbols?: boolean;
+    excludePathPatterns?: string[];
+    includeFixtures?: boolean;
+};
+type ResolvedContextPackOptions = {
+    budget: number;
+    profile: ContextPackProfile;
+    scope: ContextPackScope;
+    maxModules: number;
+    maxFiles: number;
+    maxSnippets: number;
+    minScore?: number;
+    explainSymbols: boolean;
+    excludePathPatterns: string[];
+    includeFixtures: boolean;
+    evidenceThreshold: number;
+    searchTopK: number;
+};
+type ModuleMetric = {
+    module: string;
+    maxSemanticScore: number;
+    hitCount: number;
+    symbolOverlap: number;
+    dependencyProximity: number;
+    pathPrior: number;
+    changedBoost: number;
+    fileCount: number;
+    reasons: string[];
+};
+export type ScoredModule = {
+    module: string;
+    score: number;
+    reasons: string[];
+    metrics: Omit<ModuleMetric, "module" | "reasons">;
+};
+export declare function normalizeContextPackIntent(task: string): ContextPackIntent;
+export declare function buildContextPackProfile(options?: ContextPackBuildOptions): ResolvedContextPackOptions;
+export declare function inferContextPackConfidenceBand(confidence: number): PackMeta["confidenceBand"];
+export declare function scoreContextPackModules(metrics: ModuleMetric[]): ScoredModule[];
+export declare class ContextPackBuilder {
+    private readonly metadata;
+    private readonly search;
+    private readonly git;
+    private readonly repoRoot;
+    constructor(metadata: MetadataStore, search: ContextPackSearch, git: GitOperations, repoRoot: string);
+    build(projectId: ProjectId, snapshotId: SnapshotId, task: string, options?: ContextPackBuildOptions): Promise<ContextPackResult>;
+}
+export {};