@wrongstack/tools 1.0.1 → 1.0.2

package/dist/codebase-index/writer-schema.d.ts

@@ -16,6 +16,57 @@ export declare const LANG_FAMILY_TABLE_SQL = "\n  CREATE TABLE IF NOT EXISTS lan
 /** Family value that matches every symbol family, used by language-less refs. */
 export declare const LANG_FAMILY_WILDCARD = "*";
 export declare const SYMBOLS_FTS_SQL = "CREATE VIRTUAL TABLE IF NOT EXISTS symbols_fts USING fts5(text, tokenize = 'trigram')";
+/**
+ * Graph centrality, computed at index time by `graph-rank.ts` once every ref
+ * has its final `to_id` / `to_file`. Two tables rather than columns on
+ * `symbols` / `files` so the whole layer is additive: an index written by an
+ * older build simply has empty rank tables, and `SCHEMA_VERSION` stays put
+ * (a bump drops and rebuilds the entire index — see `initIndexSchema`).
+ *
+ * `rank` is max-normalised to 1.0 across the run, so scores are comparable
+ * within one index but never across two.
+ */
+export declare const RANK_TABLES_SQL = "\n  CREATE TABLE IF NOT EXISTS symbol_rank (\n    symbol_id INTEGER PRIMARY KEY,\n    rank REAL NOT NULL,\n    in_deg INTEGER NOT NULL DEFAULT 0,\n    out_deg INTEGER NOT NULL DEFAULT 0\n  );\n  CREATE TABLE IF NOT EXISTS file_rank (\n    file TEXT PRIMARY KEY,\n    rank REAL NOT NULL,\n    in_deg INTEGER NOT NULL DEFAULT 0,\n    out_deg INTEGER NOT NULL DEFAULT 0\n  );\n";
+export declare const RANK_INDEX_SQL: readonly ['CREATE INDEX IF NOT EXISTS idx_sr_rank ON symbol_rank(rank DESC)', 'CREATE INDEX IF NOT EXISTS idx_fr_rank ON file_rank(rank DESC)'];
+/**
+ * Concept layer — plain-English descriptions of what code is *for*, which the
+ * structural index cannot express. Symbol names and signatures answer "what is
+ * declared"; they cannot answer "where do we back off after a 429".
+ *
+ * Populated by an optional, explicitly enabled LLM pass. Additive like the rank
+ * tables: an index without the pass simply has empty concept tables, and every
+ * consumer treats a missing summary as "not described yet" rather than an error.
+ *
+ * `content_hash` mirrors `files.content_hash`, and is the cache key that keeps
+ * the pass affordable — a file whose bytes have not changed is never re-sent to
+ * a model. `state` distinguishes a summary that matches the current bytes
+ * (`ready`) from one describing an older version (`stale`, still useful as a
+ * hint) and one not yet produced (`pending`).
+ *
+ * `crux_start`/`crux_end` point at the few lines that actually carry the file's
+ * meaning. A summary can drift from the truth; a pointer into the source cannot.
+ */
+export declare const CONCEPT_TABLES_SQL = "\n  CREATE TABLE IF NOT EXISTS file_concepts (\n    file TEXT PRIMARY KEY,\n    content_hash TEXT NOT NULL DEFAULT '',\n    summary TEXT NOT NULL DEFAULT '',\n    crux_start INTEGER,\n    crux_end INTEGER,\n    state TEXT NOT NULL DEFAULT 'pending',\n    model TEXT NOT NULL DEFAULT '',\n    updated_at INTEGER NOT NULL DEFAULT 0\n  );\n  CREATE TABLE IF NOT EXISTS subsystems (\n    id TEXT PRIMARY KEY,\n    name TEXT NOT NULL,\n    summary TEXT NOT NULL DEFAULT '',\n    member_files TEXT NOT NULL DEFAULT '[]',\n    model TEXT NOT NULL DEFAULT '',\n    updated_at INTEGER NOT NULL DEFAULT 0\n  );\n  CREATE TABLE IF NOT EXISTS concept_edges (\n    from_id TEXT NOT NULL,\n    to_id TEXT NOT NULL,\n    relation TEXT NOT NULL,\n    PRIMARY KEY (from_id, to_id, relation)\n  );\n";
+/**
+ * Semantic embeddings, one per file.
+ *
+ * **Per file, not per symbol.** Embedding a bare signature — `function
+ * resolve(id: string): Widget` — captures almost nothing a lexical index does
+ * not already have. What carries meaning is the concept layer's description of
+ * what the file is *for*, so that is what gets embedded. It is also eight
+ * times cheaper on this repository: 8k files against 66k symbols.
+ *
+ * `source_hash` is a hash of the exact text that was embedded, so a changed
+ * summary re-embeds and an unchanged one never does. `provider` records which
+ * model produced the vector; vectors from a different model are not comparable,
+ * so a provider change invalidates the whole table rather than silently mixing
+ * two vector spaces.
+ *
+ * Separate from `symbol_vectors`, which stores the older synchronous
+ * char-trigram vectors and stays behind its own gate.
+ */
+export declare const FILE_VECTORS_TABLE_SQL = "\n  CREATE TABLE IF NOT EXISTS file_vectors (\n    file TEXT PRIMARY KEY,\n    vector BLOB NOT NULL,\n    source_hash TEXT NOT NULL DEFAULT '',\n    provider TEXT NOT NULL DEFAULT ''\n  );\n";
+export declare const CONCEPT_INDEX_SQL: readonly ['CREATE INDEX IF NOT EXISTS idx_fc_state ON file_concepts(state)', 'CREATE INDEX IF NOT EXISTS idx_ce_from ON concept_edges(from_id)'];
 /**
  * Phase 3: stores 384-dimensional float32 embedding vectors for each symbol.
  * Vectors are computed from the symbol's indexable text (name + signature +

package/dist/codebase-index/writer-vectors.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Persistence for file-level semantic embeddings (`file_vectors`).
+ *
+ * Vectors from two different models are not comparable — the spaces have
+ * nothing to do with each other — so the provider id is stored alongside every
+ * row and a provider change wipes the table rather than silently mixing them.
+ */
+import type { DatabaseSync } from 'node:sqlite';
+type Statement = ReturnType<DatabaseSync['prepare']>;
+type PrepareStatement = (sql: string) => Statement;
+/** Metadata key recording which provider produced the stored vectors. */
+export declare const FILE_VECTOR_PROVIDER_KEY = "file_vector_provider";
+export interface FileVectorRow {
+    file: string;
+    vector: Float32Array;
+    /** Hash of the exact text that was embedded. */
+    sourceHash: string;
+    provider: string;
+}
+/** What is already embedded, so a pass can skip unchanged text. */
+export interface FileVectorState {
+    file: string;
+    sourceHash: string;
+}
+export declare function getFileVectorStatesWithStatement(stmt: PrepareStatement, provider: string): Map<string, string>;
+export declare function upsertFileVectorsWithStatement(stmt: PrepareStatement, maxSqlVars: number, rows: readonly FileVectorRow[]): void;
+/**
+ * Drop every stored vector when the provider changes.
+ *
+ * Returns true when a wipe happened, so the caller can report that the next
+ * pass is a full re-embed rather than an incremental one.
+ */
+export declare function reconcileVectorProviderWithStatement(stmt: PrepareStatement, getMetadata: (key: string) => string | undefined, setMetadata: (key: string, value: string) => void, provider: string): boolean;
+/** Vectors dropped for files no longer indexed. */
+export declare function pruneOrphanFileVectorsWithStatement(stmt: PrepareStatement): number;
+export declare function countFileVectorsWithStatement(stmt: PrepareStatement): number;
+export interface VectorHit {
+    file: string;
+    /** Cosine similarity in [-1, 1]. */
+    score: number;
+}
+/**
+ * Rank every stored vector against `query` and return the closest files.
+ *
+ * A brute-force scan, deliberately: at file granularity this repository has
+ * roughly eight thousand vectors of 384 floats, which is about twelve
+ * megabytes and a few milliseconds to sweep. An approximate-nearest-neighbour
+ * index would add a dependency and an accuracy cliff to save time nobody is
+ * waiting on.
+ */
+export declare function searchFileVectorsWithStatement(stmt: PrepareStatement, query: Float32Array, limit: number, minScore: number): VectorHit[];
+export {};
+//# sourceMappingURL=writer-vectors.d.ts.map

package/dist/codebase-index/writer.d.ts

@@ -1,7 +1,11 @@
+import type { FileRankRow, SymbolRankRow } from './graph-rank.js';
 import type { CallSite, CodeMapGraph, FileMeta, IndexStats, Symbol as IndexSymbol, Ref, SearchResult, SymbolKind, SymbolLang } from './schema.js';
 import { type IndexSummary } from './writer-admin.js';
+import type { ConceptCoverage, ConceptEdge, FileConcept, Subsystem } from './writer-concepts.js';
+import type { RankedFileRow } from './writer-rank.js';
 import type { WriterSearchFilter } from './writer-search-helpers.js';
 import { StorePool } from './writer-store-pool.js';
+import type { FileVectorRow, VectorHit } from './writer-vectors.js';
 export { codebaseIndexDirOverride, resolveIndexDir } from './writer-helpers.js';
 export { StorePool } from './writer-store-pool.js';
 export declare class IndexStore {
@@ -171,11 +175,66 @@ export declare class IndexStore {
         kind: SymbolKind;
         line: number;
     }>;
+    /** Declarations in one file, in source order. */
+    getFileSymbols(file: string, limit: number): Array<{
+        id: number;
+        name: string;
+        kind: string;
+        line: number;
+        signature: string;
+    }>;
+    /** Declarations behind an arbitrary id list, for the retrieval walk. */
+    getSymbolsByIds(ids: readonly number[]): Array<{
+        id: number;
+        name: string;
+        kind: string;
+        lang: string;
+        file: string;
+        line: number;
+        signature: string;
+        scope: string;
+    }>;
     getAllResolvedRefs(): Array<{
         fromId: number;
         toId: number;
         callType: string;
     }>;
+    /**
+     * Replace both rank tables in one write. Called once per index run, after
+     * ref resolution has settled — a rank computed against half-resolved refs
+     * would describe a graph that never existed.
+     */
+    replaceRanks(symbols: readonly SymbolRankRow[], files: readonly FileRankRow[]): void;
+    /** Wipe stored vectors when the embedding model changed. */
+    reconcileVectorProvider(provider: string): boolean;
+    getFileVectorStates(provider: string): Map<string, string>;
+    upsertFileVectors(rows: readonly FileVectorRow[]): void;
+    pruneOrphanFileVectors(): number;
+    countFileVectors(): number;
+    searchFileVectors(query: Float32Array, limit: number, minScore: number): VectorHit[];
+    upsertFileConcept(concept: FileConcept): void;
+    getFileConcept(file: string): FileConcept | undefined;
+    getAllFileConcepts(): FileConcept[];
+    getReadyConceptSummaries(): Map<string, string>;
+    getConceptCoverage(): ConceptCoverage;
+    /** Flag summaries whose file has changed since they were written. */
+    markStaleConcepts(): number;
+    /** Drop summaries for files that are no longer indexed. */
+    pruneOrphanConcepts(): number;
+    replaceSubsystems(subsystems: readonly Subsystem[], edges: readonly ConceptEdge[]): void;
+    getSubsystems(): Subsystem[];
+    getConceptEdges(): ConceptEdge[];
+    getPackageFileCounts(): Map<string, number>;
+    getRankedFiles(limit: number): RankedFileRow[];
+    getTopFileRanks(limit: number): FileRankRow[];
+    getTopSymbolRanks(limit: number): SymbolRankRow[];
+    getFileRankMap(): Map<string, number>;
+    getRankCounts(): {
+        symbols: number;
+        files: number;
+    };
+    getSymbolNameCandidates(): Map<number, number>;
+    getImportVisibility(): Map<string, Set<string>>;
     getAllImportRefs(): Array<{
         sourceFile: string | null;
         toName: string;

package/dist/edit.js

@@ -1,14 +1,14 @@
 import {
   editTool
-} from "./chunk-DK4J2WMH.js";
+} from "./chunk-7XUEPBNT.js";
 import "./chunk-MSOAX3GC.js";
-import "./chunk-ZTCJCYLN.js";
-import "./chunk-GDDXX27P.js";
-import "./chunk-N3K2SFEI.js";
-import "./chunk-NU2IZ72J.js";
-import "./chunk-VVZPQPTY.js";
+import "./chunk-TI5COGLY.js";
+import "./chunk-MBR5VAB5.js";
+import "./chunk-52UXXQMP.js";
+import "./chunk-DL2ARI4S.js";
+import "./chunk-3AU6CZWL.js";
 import "./chunk-6IEBD27U.js";
-import "./chunk-UCYQTZ7F.js";
+import "./chunk-ZKC5UNGD.js";
 import "./chunk-YOHO4DVT.js";
 import "./chunk-2CTZW6JQ.js";
 import "./chunk-KE7A76VC.js";

package/dist/{go-parser-D7ELWQ7F.js → go-parser-QIEXU3P2.js}

@@ -1,7 +1,8 @@
 import {
   parseParserOutput,
+  recordParserSubprocess,
   withSpawnGate
-} from "./chunk-UCYQTZ7F.js";
+} from "./chunk-ZKC5UNGD.js";
 import {
   detectLang
 } from "./chunk-YOHO4DVT.js";
@@ -408,6 +409,7 @@ async function syncGoParse(filePath, content, lang) {
     const goResult = await new Promise(
       (resolve, reject) => {
         let settled = false;
+        recordParserSubprocess();
         const proc = spawn(goBinary, ["run", scriptPath], {
           stdio: ["pipe", "pipe", "pipe"],
           windowsHide: true
@@ -466,4 +468,4 @@ export {
   detectLang,
   parseSymbols
 };
-//# sourceMappingURL=go-parser-D7ELWQ7F.js.map
+//# sourceMappingURL=go-parser-QIEXU3P2.js.map

package/dist/index.d.ts

@@ -1,71 +1,71 @@
+export { mapWithConcurrency } from './_concurrency.js';
 export { type DangerAssessment, type DangerLevel, type DangerRule, detectDanger, } from './_danger-detect.js';
+export { type CompileFail, type CompileResult, capSubject, compileUserRegex, MAX_SUBJECT_LEN, } from './_regex.js';
 export { type EnsureSessionShellOptions, ensureSessionShell, normalizeShell, type ResolveSessionShellDeps, resolveSessionShell, } from './_session-shell.js';
 export type { BashShell } from './_shell-pick.js';
-export { auditTool, type AuditContext, type AuditInput, type AuditOutput, type AuditVulnerability, } from './audit.js';
+export { checkSyntax, type SyntaxCheckResult, } from './_syntax-check.js';
+export { type AuditContext, type AuditInput, type AuditOutput, type AuditVulnerability, auditTool, } from './audit.js';
 export { type AutoProceedLoopGuard, createAutoProceedLoopGuard, GROUNDED_NO_PROGRESS_STEER, type GroundedRepetitionAction, type GroundedRepetitionSignal, type LoopGuardOptions, normalizeForRepetition, type RepetitionSignal, } from './auto-proceed-loop-guard.js';
-export { bashTool, type BashInput, type BashOutput, } from './bash.js';
+export { type BashInput, type BashOutput, bashTool, } from './bash.js';
 export { checkAndBlockKillCommand, type KillCheckResult, type KillCommand, } from './bash-kill-guard.js';
-export { batchToolUseTool, type BatchToolUseInput, type BatchToolUseOutput, } from './batch-tool-use.js';
+export { type BatchToolUseInput, type BatchToolUseOutput, batchToolUseTool, } from './batch-tool-use.js';
 export * from './browser/index.js';
 export { builtinTools, OFF_ONLY_TOOLS, OPTIONAL_TOOLS, TIER1_TOOLS, TIER2_TOOLS, TIER3_TOOLS, } from './builtin.js';
 export { type BreakerState, CircuitBreaker, type CircuitBreakerConfig, type CircuitBreakerSnapshot, } from './circuit-breaker.js';
-export type { CircuitSnapshot, CircuitState, CodeMapGraph, CodebaseAstReplaceInput, CodebaseAstReplaceOutput, CodebaseImpactAnalysisInput, CodebaseImpactAnalysisOutput, CodebaseIncomingCallsInput, CodebaseIncomingCallsOutput, CodebaseIndexInput, CodebaseIndexOutput, CodebaseInvariantCheckInput, CodebaseInvariantCheckOutput, CodebaseOutgoingCallsInput, CodebaseOutgoingCallsOutput, CodebaseRepoMapInput, CodebaseRepoMapOutput, CodebaseSearchInput, CodebaseSearchOutput, CodebaseSkeletonInput, CodebaseSkeletonOutput, CodebaseStatsInput, CodebaseStatsOutput, CodebaseTargetedTestInput, CodebaseTargetedTestOutput, DeadCodeScanInput, DeadCodeScanOutput, DeadFile, DeadPackage, DeadSymbol, GraphEdge, GraphNode, ImpactAnalysisInput, ImpactAnalysisOutput, ImpactCallSite, IncomingCallsInput, IncomingCallsOutput, OutgoingCallsInput, OutgoingCallsOutput, ProjectIndexDaemonAvailability, ProjectIndexServerActivity, ProjectIndexServerClientHealth, ProjectIndexServerConnectionState, ProjectIndexServerConnectionStatus, ProjectIndexServerHealth, TargetedTestInput, TargetedTestOutput, } from './codebase-index/index.js';
-export { clarifyTool, type ClarifyInput, type ClarifyQuestionInput, type ClarifyOutput, } from './clarify.js';
-export { CircuitOpenError, cancelPendingReindexes, checkCodebaseIndexServerHealth, codebaseAstReplaceTool, codebaseImpactAnalysisTool, codebaseIncomingCallsTool, codebaseIndexStats, codebaseIndexTool, codebaseInvariantCheckTool, codebaseOutgoingCallsTool, codebaseRepoMapTool, codebaseSearchTool, codebaseSkeletonTool, codebaseStatsTool, codebaseTargetedTestTool, deadCodeScanTool, enqueueReindex, ensureCodebaseIndexServer, extractDirectorySkeleton, extractFileSkeleton, generateRepoMap, replaceSymbolInFile, type FileSkeletonResult, type MutateSymbolOptions, type MutateSymbolResult, type RepoMapOptions, type RepoMapResult, type SkeletonOptions, type SkeletonSymbolRange, fileGraphService, getIndexState, IndexCircuitBreaker, IndexTimeoutError, indexCircuitBreaker, isIndexableFile, isIndexing, isIndexReady, onIndexStateChange, packageGraphService, resetIndexCircuitBreaker, resolveProjectIndexDaemonAvailability, runDeadCodeScan, runStartupIndex, searchCodebaseIndex, shutdownCodebaseIndexHost, shutdownCodebaseIndexServer, symbolGraphService, } from './codebase-index/index.js';
-export { designTool, type DesignInput, type DesignOutput, } from './design.js';
-export { diffTool, type DiffInput, type DiffMode, type DiffOutput, } from './diff.js';
-export { documentTool, type DocumentInput, type DocumentOutput, type DocumentedItem, } from './document.js';
+export { type ClarifyInput, type ClarifyOutput, type ClarifyQuestionInput, clarifyTool, } from './clarify.js';
+export type { CircuitSnapshot, CircuitState, CodebaseAstReplaceInput, CodebaseAstReplaceOutput, CodebaseImpactAnalysisInput, CodebaseImpactAnalysisOutput, CodebaseIncomingCallsInput, CodebaseIncomingCallsOutput, CodebaseIndexInput, CodebaseIndexOutput, CodebaseInvariantCheckInput, CodebaseInvariantCheckOutput, CodebaseOutgoingCallsInput, CodebaseOutgoingCallsOutput, CodebaseRepoMapInput, CodebaseRepoMapOutput, CodebaseSearchInput, CodebaseSearchOutput, CodebaseSkeletonInput, CodebaseSkeletonOutput, CodebaseStatsInput, CodebaseStatsOutput, CodebaseTargetedTestInput, CodebaseTargetedTestOutput, CodeMapGraph, DeadCodeScanInput, DeadCodeScanOutput, DeadFile, DeadPackage, DeadSymbol, GraphEdge, GraphNode, ImpactAnalysisInput, ImpactAnalysisOutput, ImpactCallSite, IncomingCallsInput, IncomingCallsOutput, OutgoingCallsInput, OutgoingCallsOutput, ProjectIndexDaemonAvailability, ProjectIndexServerActivity, ProjectIndexServerClientHealth, ProjectIndexServerConnectionState, ProjectIndexServerConnectionStatus, ProjectIndexServerHealth, TargetedTestInput, TargetedTestOutput, } from './codebase-index/index.js';
+export { ATLAS_DIR, type AtlasBrief, type AtlasBriefIndexMissing, type AtlasFreshness, type AtlasIndexMissing, buildProjectAtlasBrief, CircuitOpenError, CONCEPT_RELATIONS, type ConceptIndexMissing, type ContextResult, cancelPendingReindexes, checkCodebaseIndexServerHealth, checkProjectAtlasFreshness, codebaseAstReplaceTool, codebaseContextTool, codebaseImpactAnalysisTool, codebaseIncomingCallsTool, codebaseIndexStats, codebaseIndexTool, codebaseInvariantCheckTool, codebaseOutgoingCallsTool, codebaseRepoMapTool, codebaseSearchTool, codebaseSkeletonTool, codebaseStatsTool, codebaseTargetedTestTool, deadCodeScanTool, type EmbeddingPort, type EmbedIndexMissing, type EmbedResult, type EnrichResult, embedProjectFiles, enqueueReindex, enrichProjectConcepts, ensureCodebaseIndexServer, exportProjectAtlasHtml, extractDirectorySkeleton, extractFileSkeleton, type FileSkeletonResult, fileGraphService, generateRepoMap, getIndexState, IndexCircuitBreaker, IndexTimeoutError, indexCircuitBreaker, isIndexableFile, isIndexing, isIndexReady, MAX_CRUX_LINES, MAX_REPORTED_DRIFT, type MutateSymbolOptions, type MutateSymbolResult, onIndexStateChange, packageGraphService, type RepoMapOptions, type RepoMapResult, replaceSymbolInFile, resetIndexCircuitBreaker, resolveProjectIndexDaemonAvailability, runDeadCodeScan, runStartupIndex, type SkeletonOptions, type SkeletonSymbolRange, type SummarizeFileInput, type SummarizeFileResult, type SummarizerPort, type SummarizeSubsystemInput, type SummarizeSubsystemResult, searchCodebaseIndex, setContextQueryEmbedder, shutdownCodebaseIndexHost, shutdownCodebaseIndexServer, symbolGraphService, writeProjectAtlas, } from './codebase-index/index.js';
+export { type DesignInput, type DesignOutput, designTool, } from './design.js';
+export { type DiffInput, type DiffMode, type DiffOutput, diffTool, } from './diff.js';
+export { type DocumentedItem, type DocumentInput, type DocumentOutput, documentTool, } from './document.js';
 export { discoverE2EProjects, type E2EExecutionPlan, type E2EFramework, type E2EPackageManager, type E2EPlanInput, type E2EPlanOutput, type E2EProjectPlan, type E2EServerHint, e2ePlanTool, } from './e2e.js';
-export { editTool, type EditInput, type EditOutput, type MatchTier, } from './edit.js';
-export { configureDangerBypass, configureExecPolicy, execTool, type ExecInput, type ExecOutput, getDangerBypass, getExecAllowlist, isExecCommandAllowed, resetDangerBypass, resetExecPolicy, } from './exec.js';
+export { type EditInput, type EditOutput, editTool, type MatchTier, } from './edit.js';
+export { configureDangerBypass, configureExecPolicy, type ExecInput, type ExecOutput, execTool, getDangerBypass, getExecAllowlist, isExecCommandAllowed, resetDangerBypass, resetExecPolicy, } from './exec.js';
 export { checkExecKillCommand, type ExecKillCheckResult, } from './exec-kill-guard.js';
-export { fetchTool, type FetchFormat, type FetchInput, type FetchOutput, } from './fetch.js';
-export { formatTool, type FormatContext, type FormatFixer, type FormatInput, type FormatOutput, } from './format.js';
-export { gitTool, type GitInput, type GitOutput, type GitSubcommand, } from './git.js';
-export { globTool, type GlobInput, type GlobOutput, } from './glob.js';
-export { grepTool, type GrepBackend, type GrepEngine, type GrepInput, type GrepOutput, type GrepOutputMode, } from './grep.js';
-export { installTool, type InstallContext, type InstallInput, type InstallOutput, type InstallSaveType, } from './install.js';
-export { jsonTool, type JsonAction, type JsonInput, type JsonOutput, } from './json.js';
-export { kanbanTool, type KanbanAction, type KanbanContext, type KanbanToolInput, type KanbanToolOutput, } from './kanban.js';
+export { type FetchFormat, type FetchInput, type FetchOutput, fetchTool, } from './fetch.js';
+export { type FormatContext, type FormatFixer, type FormatInput, type FormatOutput, formatTool, } from './format.js';
+export { type GitInput, type GitOutput, type GitSubcommand, gitTool, } from './git.js';
+export { type GlobInput, type GlobOutput, globTool, } from './glob.js';
+export { type GrepBackend, type GrepEngine, type GrepInput, type GrepOutput, type GrepOutputMode, grepTool, } from './grep.js';
+export { type InstallContext, type InstallInput, type InstallOutput, type InstallSaveType, installTool, } from './install.js';
+export { type JsonAction, type JsonInput, type JsonOutput, jsonTool, } from './json.js';
+export { type KanbanAction, type KanbanContext, type KanbanToolInput, type KanbanToolOutput, kanbanTool, } from './kanban.js';
 export { kanbanEvidenceKey, kanbanEvidencePointer, recordKanbanVerificationEvidence, } from './kanban-evidence-bridge.js';
 export * from './languages/index.js';
-export { lintTool, type LintContext, type LinterName, type LintInput, type LintOutput, } from './lint.js';
-export { logsTool, type LogEntry, type LogsInput, type LogsOutput, } from './logs.js';
-export { forgetTool, type ForgetInput, type ForgetOutput, relatedMemoryTool, type RelatedMemoryInput, rememberTool, type RememberInput, type RememberOutput, searchMemoryTool, type SearchMemoryInput, type SearchMemoryOutput, } from './memory.js';
+export { type LintContext, type LinterName, type LintInput, type LintOutput, lintTool, } from './lint.js';
+export { type LogEntry, type LogsInput, type LogsOutput, logsTool, } from './logs.js';
+export { type ForgetInput, type ForgetOutput, forgetTool, type RelatedMemoryInput, type RememberInput, type RememberOutput, relatedMemoryTool, rememberTool, type SearchMemoryInput, type SearchMemoryOutput, searchMemoryTool, } from './memory.js';
 export { createModeTool, type ModeFamily, type ModeInput, type ModeOutput, } from './mode.js';
-export { nextStepsTool, type NextStepsInput, type NextStepsOutput, } from './next-steps-tool.js';
-export { type ParseNextStepsOptions, type ParseNextStepsResult, type ParsedNextStep, parseNextSteps, stripNextSteps, } from './next-steps.js';
-export { outdatedTool, type OutdatedContext, type OutdatedInput, type OutdatedOutput, type OutdatedPackage, } from './outdated.js';
+export { type ParsedNextStep, type ParseNextStepsOptions, type ParseNextStepsResult, parseNextSteps, stripNextSteps, } from './next-steps.js';
+export { type NextStepsInput, type NextStepsOutput, nextStepsTool, } from './next-steps-tool.js';
+export { type OutdatedContext, type OutdatedInput, type OutdatedOutput, type OutdatedPackage, outdatedTool, } from './outdated.js';
 export { builtinToolsPack } from './pack.js';
-export { patchTool, type PatchInput, type PatchOutput, } from './patch.js';
-export { planTool, type PlanAction, type PlanInput, type PlanOutput, } from './plan.js';
+export { type PatchInput, type PatchOutput, patchTool, } from './patch.js';
+export { type PlanAction, type PlanInput, type PlanOutput, planTool, } from './plan.js';
 export { getProcessGuardian, type ProcessGuardianConfig, startProcessGuardian, stopProcessGuardian, } from './process-guardian.js';
 export { _resetProcessRegistry, type BreakerCountdown, getProcessRegistry, type KillOpts, type ProcessRegistryImpl, type RegistryStats, type TrackedProcess, } from './process-registry.js';
 export { getPersistentProcessRegistry, type PersistentProcessEntry, type PersistentRegistryData, resetPersistentProcessRegistry, } from './process-registry-persistent.js';
 export { createGlobalPsSlashCommand, formatGlobalStatus, formatInstanceList, formatInstanceSummary, type GlobalProcessStatus, getInstanceCount, type InstanceInfo, type InstanceListOptions, listInstances, } from './ps-slash.js';
-export { pwshTool, PWSH_TOOL_DESCRIPTION, PWSH_TOOL_USAGE_HINT, type PwshInput, type PwshOutput, } from './pwsh.js';
-export { readTool, type ReadInput, type ReadMode, type ReadOutput, type SymbolEntry, } from './read.js';
-export { replaceTool, type ReplaceInput, type ReplaceOutput, } from './replace.js';
-export { BUILT_IN_TEMPLATES, scaffoldTool, type ScaffoldInput, type ScaffoldOutput, type ScaffoldTemplate, } from './scaffold.js';
-export { searchTool, type CacheEntry as SearchCacheEntry, type SearchInput, type SearchOutput, type SearchResult, } from './search.js';
-export { analyzeSecurityAndPerformance, securityAstScanTool, type SecurityFinding, type SecurityScanInput, type SecurityScanOutput, } from './security-ast-scan-tool.js';
+export { PWSH_TOOL_DESCRIPTION, PWSH_TOOL_USAGE_HINT, type PwshInput, type PwshOutput, pwshTool, } from './pwsh.js';
+export { type ReadInput, type ReadMode, type ReadOutput, readTool, type SymbolEntry, } from './read.js';
+export { type ReplaceInput, type ReplaceOutput, replaceTool, } from './replace.js';
+export { BUILT_IN_TEMPLATES, type ScaffoldInput, type ScaffoldOutput, type ScaffoldTemplate, scaffoldTool, } from './scaffold.js';
+export { type CacheEntry as SearchCacheEntry, type SearchInput, type SearchOutput, type SearchResult, searchTool, } from './search.js';
+export { analyzeSecurityAndPerformance, type SecurityFinding, type SecurityScanInput, type SecurityScanOutput, securityAstScanTool, } from './security-ast-scan-tool.js';
 export { applySessionKanbanBoardToTodos, applySessionKanbanTaskToSource, attachSessionKanbanMirror, ensureSessionKanbanBoard, hydrateSessionKanban, mirrorSessionPlanToKanban, mirrorSessionTasksToKanban, mirrorSessionTodosToKanban, projectSessionPlanToKanban, projectSessionTasksToKanban, projectSessionTodosToKanban, rebindSessionKanbanTask, SESSION_KANBAN_COLUMNS, } from './session-kanban.js';
-export { makeSkillTool, type LoadedResource, type SkillResource, type SkillToolInput, type SkillToolOutput, } from './skill.js';
-export { setWorkingDirTool, type SetWorkingDirInput, type SetWorkingDirOutput, } from './set-working-dir.js';
-export { taskTool, type TaskAction, type TaskAdditionItem, type TaskInput, type TaskOutput, type TaskReplacementItem, } from './task.js';
-export { testTool, type TestContext, type TestInput, type TestOutput, type TestRunnerName, } from './test.js';
-export { todoTool, type TodoInput, type TodoKanbanBinding, type TodoOutput, } from './todo.js';
-export { toolHelpTool, type ToolHelpInput, type ToolHelpOutput, } from './tool-help.js';
+export { type SetWorkingDirInput, type SetWorkingDirOutput, setWorkingDirTool, } from './set-working-dir.js';
+export { type LoadedResource, makeSkillTool, type SkillResource, type SkillToolInput, type SkillToolOutput, } from './skill.js';
+export { type TaskAction, type TaskAdditionItem, type TaskInput, type TaskOutput, type TaskReplacementItem, taskTool, } from './task.js';
+export { type TestContext, type TestInput, type TestOutput, type TestRunnerName, testTool, } from './test.js';
+export { type TodoInput, type TodoKanbanBinding, type TodoOutput, todoTool, } from './todo.js';
+export { computeLineDiff, DIFF_MAX_LINES, type DiffRow, type DiffRowKind, diffFromToolInput, type ToolDiff, } from './tool-diff.js';
+export { type ToolHelpInput, type ToolHelpOutput, toolHelpTool, } from './tool-help.js';
 export { FALLBACK_ICON, getToolIcon, TOOL_ICON_CONFIG, TOOL_ICON_MAP, type ToolIconConfig, type ToolIconId, } from './tool-icon-map.js';
-export { computeLineDiff, DIFF_MAX_LINES, diffFromToolInput, type DiffRow, type DiffRowKind, type ToolDiff, } from './tool-diff.js';
+export { type ToolSearchInput, type ToolSearchOutput, toolSearchTool, } from './tool-search.js';
 export { FALLBACK_HEAD_FIELDS, SUMMARIZE_TOOL_INPUT_BROWSER_SRC, summarizeToolInput, } from './tool-summary.js';
-export { toolSearchTool, type ToolSearchInput, type ToolSearchOutput, } from './tool-search.js';
 export { type RegisterBuiltinToolTierOptions, registerBuiltinToolTier, selectBuiltinToolsForTier, } from './tool-tier.js';
-export { toolUseTool, type ToolUseInput, type ToolUseOutput, } from './tool-use.js';
-export { DEFAULT_MAX_TREE_ENTRIES, MAX_TREE_OUTPUT_BYTES, treeTool, type TreeContext, type TreeInput, type TreeOutput, } from './tree.js';
-export { typecheckTool, type TypecheckContext, type TypecheckInput, type TypecheckOutput, } from './typecheck.js';
-export { writeTool, type WriteInput, type WriteOutput, } from './write.js';
-export { checkSyntax, type SyntaxCheckResult, } from './_syntax-check.js';
-export { mapWithConcurrency, } from './_concurrency.js';
-export { capSubject, compileUserRegex, MAX_SUBJECT_LEN, type CompileFail, type CompileResult, } from './_regex.js';
+export { type ToolUseInput, type ToolUseOutput, toolUseTool, } from './tool-use.js';
+export { DEFAULT_MAX_TREE_ENTRIES, MAX_TREE_OUTPUT_BYTES, type TreeContext, type TreeInput, type TreeOutput, treeTool, } from './tree.js';
+export { type TypecheckContext, type TypecheckInput, type TypecheckOutput, typecheckTool, } from './typecheck.js';
+export { type WriteInput, type WriteOutput, writeTool, } from './write.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -41,10 +41,10 @@ import "./chunk-Z6DAKQ3U.js";
 import {
   registerBuiltinToolTier,
   selectBuiltinToolsForTier
-} from "./chunk-7LQCT3LT.js";
+} from "./chunk-NFX2IUQA.js";
 import {
   builtinToolsPack
-} from "./chunk-E7JE3UEX.js";
+} from "./chunk-EL2NJXSK.js";
 import {
   OFF_ONLY_TOOLS,
   OPTIONAL_TOOLS,
@@ -59,13 +59,19 @@ import {
   pwshTool,
   securityAstScanTool,
   setWorkingDirTool
-} from "./chunk-IAYMTTR2.js";
+} from "./chunk-UCXFTCAI.js";
 import {
   discoverE2EProjects,
   e2ePlanTool
 } from "./chunk-RV7BVTDG.js";
 import {
+  ATLAS_DIR,
+  MAX_CRUX_LINES,
+  MAX_REPORTED_DRIFT,
+  buildProjectAtlasBrief,
+  checkProjectAtlasFreshness,
   codebaseAstReplaceTool,
+  codebaseContextTool,
   codebaseImpactAnalysisTool,
   codebaseIncomingCallsTool,
   codebaseIndexTool,
@@ -77,12 +83,17 @@ import {
   codebaseStatsTool,
   codebaseTargetedTestTool,
   deadCodeScanTool,
+  embedProjectFiles,
+  enrichProjectConcepts,
+  exportProjectAtlasHtml,
   extractDirectorySkeleton,
   extractFileSkeleton,
   generateRepoMap,
   replaceSymbolInFile,
-  runDeadCodeScan
-} from "./chunk-YEISRT4S.js";
+  runDeadCodeScan,
+  setContextQueryEmbedder,
+  writeProjectAtlas
+} from "./chunk-HWXIRVKH.js";
 import "./chunk-XRNN44QY.js";
 import {
   planTool
@@ -132,7 +143,7 @@ import {
 } from "./chunk-AQ5YBURX.js";
 import {
   patchTool
-} from "./chunk-CGXTR34H.js";
+} from "./chunk-TU5MTW2S.js";
 import {
   jsonTool
 } from "./chunk-VZGPASGD.js";
@@ -175,7 +186,7 @@ import {
 import "./chunk-DRRY6SCM.js";
 import {
   replaceTool
-} from "./chunk-IYH4OHBP.js";
+} from "./chunk-DKHMPKDG.js";
 import {
   globTool
 } from "./chunk-ASEXQRA7.js";
@@ -281,13 +292,13 @@ import {
 } from "./chunk-SOR7OCYP.js";
 import {
   readTool
-} from "./chunk-MK2JK35J.js";
+} from "./chunk-UOYRAS4J.js";
 import {
   writeTool
-} from "./chunk-GKSG5CPH.js";
+} from "./chunk-KVTEIUND.js";
 import {
   editTool
-} from "./chunk-DK4J2WMH.js";
+} from "./chunk-7XUEPBNT.js";
 import {
   checkSyntax
 } from "./chunk-MSOAX3GC.js";
@@ -310,19 +321,20 @@ import {
   shutdownCodebaseIndexHost,
   shutdownCodebaseIndexServer,
   symbolGraphService
-} from "./chunk-ZTCJCYLN.js";
-import "./chunk-GDDXX27P.js";
+} from "./chunk-TI5COGLY.js";
+import "./chunk-MBR5VAB5.js";
 import {
+  CONCEPT_RELATIONS,
   CircuitOpenError,
   IndexCircuitBreaker,
   IndexTimeoutError,
   indexCircuitBreaker,
   resetIndexCircuitBreaker
-} from "./chunk-N3K2SFEI.js";
-import "./chunk-NU2IZ72J.js";
-import "./chunk-VVZPQPTY.js";
+} from "./chunk-52UXXQMP.js";
+import "./chunk-DL2ARI4S.js";
+import "./chunk-3AU6CZWL.js";
 import "./chunk-6IEBD27U.js";
-import "./chunk-UCYQTZ7F.js";
+import "./chunk-ZKC5UNGD.js";
 import "./chunk-YOHO4DVT.js";
 import "./chunk-2CTZW6JQ.js";
 import {
@@ -912,10 +924,12 @@ var TOOL_ICON_CONFIG = {
 var FALLBACK_ICON = "fallback";
 export {
   ADDITIONAL_LANGUAGE_PROFILES,
+  ATLAS_DIR,
   BUILT_IN_TEMPLATES,
   BrowserArtifactStore,
   BrowserNetworkGuardProxy,
   BrowserSessionManager,
+  CONCEPT_RELATIONS,
   CircuitBreaker,
   CircuitOpenError,
   DEFAULT_MAX_TREE_ENTRIES,
@@ -926,6 +940,8 @@ export {
   IndexCircuitBreaker,
   IndexTimeoutError,
   LanguageProfileRegistry,
+  MAX_CRUX_LINES,
+  MAX_REPORTED_DRIFT,
   MAX_SUBJECT_LEN,
   MAX_TREE_OUTPUT_BYTES,
   OFF_ONLY_TOOLS,
@@ -967,6 +983,7 @@ export {
   browserTypeTool,
   browserUploadTool,
   browserWaitTool,
+  buildProjectAtlasBrief,
   builtinTools,
   builtinToolsPack,
   cancelPendingReindexes,
@@ -974,9 +991,11 @@ export {
   checkAndBlockKillCommand,
   checkCodebaseIndexServerHealth,
   checkExecKillCommand,
+  checkProjectAtlasFreshness,
   checkSyntax,
   clarifyTool,
   codebaseAstReplaceTool,
+  codebaseContextTool,
   codebaseImpactAnalysisTool,
   codebaseIncomingCallsTool,
   codebaseIndexStats,
@@ -1006,13 +1025,16 @@ export {
   documentTool,
   e2ePlanTool,
   editTool,
+  embedProjectFiles,
   enqueueReindex,
+  enrichProjectConcepts,
   ensureCodebaseIndexServer,
   ensureSessionKanbanBoard,
   ensureSessionShell,
   execTool,
   executeLanguagePlan,
   executePackagePlan,
+  exportProjectAtlasHtml,
   extractDirectorySkeleton,
   extractFileSkeleton,
   fetchTool,
@@ -1099,6 +1121,7 @@ export {
   searchTool,
   securityAstScanTool,
   selectBuiltinToolsForTier,
+  setContextQueryEmbedder,
   setWorkingDirTool,
   shutdownBrowserTools,
   shutdownCodebaseIndexHost,
@@ -1118,6 +1141,7 @@ export {
   typecheckTool,
   validateCommandPlan,
   validateLanguageProfile,
+  writeProjectAtlas,
   writeTool
 };
 //# sourceMappingURL=index.js.map

package/dist/pack.js

@@ -1,9 +1,9 @@
 import {
   builtinToolsPack
-} from "./chunk-E7JE3UEX.js";
-import "./chunk-IAYMTTR2.js";
+} from "./chunk-EL2NJXSK.js";
+import "./chunk-UCXFTCAI.js";
 import "./chunk-RV7BVTDG.js";
-import "./chunk-YEISRT4S.js";
+import "./chunk-HWXIRVKH.js";
 import "./chunk-XRNN44QY.js";
 import "./chunk-5KS24LTS.js";
 import "./chunk-LQSOU63Z.js";
@@ -20,7 +20,7 @@ import "./chunk-VU3QBYL4.js";
 import "./chunk-CHEK3ASV.js";
 import "./chunk-KLJZ4WV4.js";
 import "./chunk-AQ5YBURX.js";
-import "./chunk-CGXTR34H.js";
+import "./chunk-TU5MTW2S.js";
 import "./chunk-VZGPASGD.js";
 import "./chunk-7HL23T3T.js";
 import "./chunk-JDOO4P6Z.js";
@@ -30,7 +30,7 @@ import "./chunk-4WPBS45A.js";
 import "./chunk-T3SMFF5Q.js";
 import "./chunk-7N5U2RAU.js";
 import "./chunk-DRRY6SCM.js";
-import "./chunk-IYH4OHBP.js";
+import "./chunk-DKHMPKDG.js";
 import "./chunk-ASEXQRA7.js";
 import "./chunk-4ERMPDHV.js";
 import "./chunk-YJTXRH5Y.js";
@@ -49,17 +49,17 @@ import "./chunk-FBUP524S.js";
 import "./chunk-SMARDKAC.js";
 import "./chunk-X6KXNHUO.js";
 import "./chunk-SOR7OCYP.js";
-import "./chunk-MK2JK35J.js";
-import "./chunk-GKSG5CPH.js";
-import "./chunk-DK4J2WMH.js";
+import "./chunk-UOYRAS4J.js";
+import "./chunk-KVTEIUND.js";
+import "./chunk-7XUEPBNT.js";
 import "./chunk-MSOAX3GC.js";
-import "./chunk-ZTCJCYLN.js";
-import "./chunk-GDDXX27P.js";
-import "./chunk-N3K2SFEI.js";
-import "./chunk-NU2IZ72J.js";
-import "./chunk-VVZPQPTY.js";
+import "./chunk-TI5COGLY.js";
+import "./chunk-MBR5VAB5.js";
+import "./chunk-52UXXQMP.js";
+import "./chunk-DL2ARI4S.js";
+import "./chunk-3AU6CZWL.js";
 import "./chunk-6IEBD27U.js";
-import "./chunk-UCYQTZ7F.js";
+import "./chunk-ZKC5UNGD.js";
 import "./chunk-YOHO4DVT.js";
 import "./chunk-2CTZW6JQ.js";
 import "./chunk-KE7A76VC.js";

package/dist/{parser-dispatch-BDVCJXTV.js → parser-dispatch-37FT3EXQ.js}

@@ -1,14 +1,14 @@
 import {
   parseFileContent,
   parseFilesContent
-} from "./chunk-NU2IZ72J.js";
-import "./chunk-VVZPQPTY.js";
+} from "./chunk-DL2ARI4S.js";
+import "./chunk-3AU6CZWL.js";
 import "./chunk-6IEBD27U.js";
-import "./chunk-UCYQTZ7F.js";
+import "./chunk-ZKC5UNGD.js";
 import "./chunk-YOHO4DVT.js";
 import "./chunk-KE7A76VC.js";
 export {
   parseFileContent,
   parseFilesContent
 };
-//# sourceMappingURL=parser-dispatch-BDVCJXTV.js.map
+//# sourceMappingURL=parser-dispatch-37FT3EXQ.js.map