@wrongstack/tools 0.320.1 → 1.0.0

package/dist/codebase-index/worker.js

@@ -7,13 +7,13 @@ import {
   searchService,
   statsService,
   symbolGraphService
-} from "../chunk-J43O3BOX.js";
+} from "../chunk-N3K2SFEI.js";
 import "../chunk-NU2IZ72J.js";
 import "../chunk-VVZPQPTY.js";
 import "../chunk-6IEBD27U.js";
 import "../chunk-UCYQTZ7F.js";
 import "../chunk-YOHO4DVT.js";
-import "../chunk-DTQ75VBC.js";
+import "../chunk-2CTZW6JQ.js";
 import "../chunk-KE7A76VC.js";
 
 // src/codebase-index/worker.ts

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

@@ -0,0 +1,13 @@
+import type { DatabaseSync } from 'node:sqlite';
+export declare const SYMBOLS_TEXT_DROPPED_KEY = "symbols_text_dropped";
+export declare const NEXT_SYMBOL_ID_KEY = "next_symbol_id";
+export declare function seedLangFamilies(stmt: (sql: string) => ReturnType<DatabaseSync['prepare']>): void;
+export declare function repairMissingColumns(db: DatabaseSync): void;
+export declare function dropDeprecatedSymbolsColumns(db: DatabaseSync, getMetadata: (key: string) => string | undefined, setMetadata: (key: string, value: string) => void): void;
+export declare function initIndexSchema(db: DatabaseSync, stmt: (sql: string) => ReturnType<DatabaseSync['prepare']>, getMetadata: (key: string) => string | undefined, setMetadata: (key: string, value: string) => void, maxSqlVars: number, invalidateBm25: () => void): {
+    ftsAvailable: boolean;
+    vectorsAvailable: boolean;
+};
+export declare function ensureNextSymbolIdSeeded(stmt: (sql: string) => ReturnType<DatabaseSync['prepare']>): void;
+export declare function allocateSymbolIds(stmt: (sql: string) => ReturnType<DatabaseSync['prepare']>, count: number, getMaxSymbolId: () => number): number;
+//# sourceMappingURL=writer-init.d.ts.map

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

@@ -0,0 +1,14 @@
+import type { DatabaseSync } from 'node:sqlite';
+export declare const FTS_CHURN_KEY = "fts_churn_since_maintain";
+export declare function optimizeStore(db: DatabaseSync): void;
+export declare function recordFtsChurn(ftsAvailable: boolean, getMetadata: (key: string) => string | undefined, setMetadata: (key: string, value: string) => void, rows: number): void;
+export declare function optimizeFtsIfNeeded(stmt: (sql: string) => ReturnType<DatabaseSync['prepare']>, ftsAvailable: boolean, getMetadata: (key: string) => string | undefined, setMetadata: (key: string, value: string) => void, runWithRetry: <T>(fn: () => T) => T, options?: {
+    minChurnRatio?: number;
+    minChurnRows?: number;
+}): boolean;
+export declare function checkpointWal(db: DatabaseSync): boolean;
+export declare function compactIfNeeded(db: DatabaseSync, stmt: (sql: string) => ReturnType<DatabaseSync['prepare']>, runWithRetry: <T>(fn: () => T) => T, options?: {
+    minBytes?: number;
+    minFreeRatio?: number;
+}): boolean;
+//# sourceMappingURL=writer-maintenance.d.ts.map

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

@@ -23,24 +23,9 @@ export declare class IndexStore {
     private beginWriteTransaction;
     private commitWriteTransaction;
     private rollbackWriteTransaction;
-    private seedLangFamilies;
-    private repairMissingColumns;
-    /**
-     * P4: `symbols.text` duplicated name + signature + doc_comment (~19 MB on
-     * the live index) and is derived on demand now. In-place DROP COLUMN — no
-     * SCHEMA_VERSION bump, so no wipe-and-reparse. Best-effort: a busy or
-     * SQLite-without-DROP-COLUMN open leaves the column in place, where new
-     * inserts simply default it to '' and the next open retries.
-     */
-    private dropDeprecatedSymbolsColumns;
     private initSchema;
     private static readonly NEXT_SYMBOL_ID_KEY;
     private static readonly MAX_SQL_VARS;
-    /** P2: persisted FTS-mutation churn counter — see {@link optimizeFtsIfNeeded}. */
-    private static readonly FTS_CHURN_KEY;
-    /** P4: one-shot marker that the deprecated symbols.text column is gone. */
-    private static readonly SYMBOLS_TEXT_DROPPED_KEY;
-    private ensureNextSymbolIdSeeded;
     private allocateSymbolIds;
     private invalidateIncomingRefsForFiles;
     private resolveRefsForNamesUnsafe;

package/dist/design.d.ts

@@ -1,7 +1,7 @@
 import { type SemanticTune } from '@wrongstack/core/design';
 import type { Tool } from '@wrongstack/core/types';
 type Overrides = Record<string, string>;
-interface DesignInput {
+export interface DesignInput {
     action?: 'list' | 'use' | 'foundations' | 'set' | 'tune' | 'materialize' | 'verify' | undefined;
     kit?: string | undefined;
     stack?: string | undefined;
@@ -16,7 +16,7 @@ interface DesignInput {
     /** action "verify": explicit files to scan (project-relative). Defaults to a UI-file walk. */
     files?: string | string[] | undefined;
 }
-interface DesignOutput {
+export interface DesignOutput {
     action: string;
     kit?: string | undefined;
     stack?: string | undefined;

package/dist/design.js

@@ -1,6 +1,6 @@
 import {
   designTool
-} from "./chunk-ELRRTWNP.js";
+} from "./chunk-IXIS7RSG.js";
 export {
   designTool
 };

package/dist/diff.d.ts

@@ -1,14 +1,15 @@
 import type { Tool } from '@wrongstack/core/types';
-interface DiffInput {
+export type DiffMode = 'unified' | 'side-by-side' | 'stat';
+export interface DiffInput {
     path?: string | undefined;
     files?: string | string[] | undefined;
     a?: string | undefined;
     b?: string | undefined;
     staged?: boolean | undefined;
-    mode?: 'unified' | 'side-by-side' | 'stat' | undefined;
+    mode?: DiffMode | undefined;
     context?: number | undefined;
 }
-interface DiffOutput {
+export interface DiffOutput {
     diff: string;
     files: string[];
     truncated: boolean;
@@ -20,5 +21,4 @@ interface DiffOutput {
     note?: string | undefined;
 }
 export declare const diffTool: Tool<DiffInput, DiffOutput>;
-export {};
 //# sourceMappingURL=diff.d.ts.map

package/dist/diff.js

@@ -1,6 +1,6 @@
 import {
   diffTool
-} from "./chunk-34VLZ35Z.js";
+} from "./chunk-7HL23T3T.js";
 import "./chunk-ZBMANLYH.js";
 import "./chunk-ZUFHAHTE.js";
 export {

package/dist/document.d.ts

@@ -1,5 +1,5 @@
 import type { Tool } from '@wrongstack/core/types';
-interface DocumentInput {
+export interface DocumentInput {
     target: 'file' | 'function' | 'class' | 'type' | 'all';
     path?: string | undefined;
     files?: string | string[] | undefined;
@@ -7,7 +7,7 @@ interface DocumentInput {
     overwrite?: boolean | undefined;
     cwd?: string | undefined;
 }
-interface DocumentedItem {
+export interface DocumentedItem {
     path: string;
     name: string;
     signature: string;
@@ -15,12 +15,11 @@ interface DocumentedItem {
     status: 'documented' | 'skipped' | 'error';
     error?: string | undefined;
 }
-interface DocumentOutput {
+export interface DocumentOutput {
     files_processed: number;
     items_documented: number;
     results: DocumentedItem[];
     style: string;
 }
 export declare const documentTool: Tool<DocumentInput, DocumentOutput>;
-export {};
 //# sourceMappingURL=document.d.ts.map

package/dist/document.js

@@ -1,6 +1,6 @@
 import {
   documentTool
-} from "./chunk-IU4DV2PA.js";
+} from "./chunk-CHEK3ASV.js";
 import "./chunk-ZUFHAHTE.js";
 export {
   documentTool

package/dist/e2e.d.ts

@@ -1,7 +1,7 @@
 import type { Tool } from '@wrongstack/core/types';
 export type E2EFramework = 'playwright' | 'cypress';
 export type E2EPackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun';
-interface E2EPlanInput {
+export interface E2EPlanInput {
     cwd?: string | undefined;
     framework?: E2EFramework | 'all' | undefined;
     maxDepth?: number | undefined;

package/dist/e2e.js

@@ -1,7 +1,7 @@
 import {
   discoverE2EProjects,
   e2ePlanTool
-} from "./chunk-VPALDFYM.js";
+} from "./chunk-RV7BVTDG.js";
 import "./chunk-ZUFHAHTE.js";
 export {
   discoverE2EProjects,

package/dist/edit.d.ts

@@ -1,6 +1,6 @@
 import type { Tool } from '@wrongstack/core/types';
 import { type MatchTier } from './_edit-match.js';
-interface EditInput {
+export interface EditInput {
     path: string;
     old_string: string;
     new_string: string;
@@ -12,7 +12,7 @@ interface EditInput {
      */
     replace_all?: boolean | undefined;
 }
-interface EditOutput {
+export interface EditOutput {
     path: string;
     replacements: number;
     diff: string;
@@ -30,6 +30,6 @@ interface EditOutput {
     syntax_errors?: string[] | undefined;
     note?: string | undefined;
 }
+export type { MatchTier };
 export declare const editTool: Tool<EditInput, EditOutput>;
-export {};
 //# sourceMappingURL=edit.d.ts.map

package/dist/edit.js

@@ -1,16 +1,16 @@
 import {
   editTool
-} from "./chunk-Z6IHMJMC.js";
-import "./chunk-JSNSMG5R.js";
-import "./chunk-Z5Q3TXRY.js";
-import "./chunk-PV6HIZQD.js";
-import "./chunk-J43O3BOX.js";
+} from "./chunk-DK4J2WMH.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-6IEBD27U.js";
 import "./chunk-UCYQTZ7F.js";
 import "./chunk-YOHO4DVT.js";
-import "./chunk-DTQ75VBC.js";
+import "./chunk-2CTZW6JQ.js";
 import "./chunk-KE7A76VC.js";
 import "./chunk-ZUFHAHTE.js";
 export {

package/dist/exec.d.ts

@@ -36,13 +36,13 @@ export declare function getDangerBypass(): ReadonlySet<string>;
 export declare function isExecCommandAllowed(cmd: string): boolean;
 /** Snapshot of the effective allowlist (sorted) — for tests / diagnostics. */
 export declare function getExecAllowlist(): string[];
-interface ExecInput {
+export interface ExecInput {
     command: string;
     args?: string[] | undefined;
     cwd?: string | undefined;
     timeout?: number | undefined;
 }
-interface ExecOutput {
+export interface ExecOutput {
     command: string;
     args: string[];
     stdout: string;
@@ -63,5 +63,4 @@ interface ExecOutput {
     danger: DangerAssessment;
 }
 export declare const execTool: Tool<ExecInput, ExecOutput>;
-export {};
 //# sourceMappingURL=exec.d.ts.map

package/dist/exec.js

@@ -7,12 +7,12 @@ import {
   isExecCommandAllowed,
   resetDangerBypass,
   resetExecPolicy
-} from "./chunk-OTPTQBYE.js";
+} from "./chunk-KDEXUQY7.js";
 import "./chunk-BTSFTGIL.js";
-import "./chunk-QGF2C7TF.js";
+import "./chunk-PVCB7RUZ.js";
 import "./chunk-SCMRM6NL.js";
-import "./chunk-ESLPBT5A.js";
-import "./chunk-HFXSNKCV.js";
+import "./chunk-HDYUBRMF.js";
+import "./chunk-7JJFC6CT.js";
 import "./chunk-KE7A76VC.js";
 import "./chunk-ZUFHAHTE.js";
 export {

package/dist/fetch.d.ts

@@ -1,9 +1,10 @@
 import type { Tool } from '@wrongstack/core/types';
-interface FetchInput {
+export type FetchFormat = 'markdown' | 'text' | 'raw';
+export interface FetchInput {
     url: string;
-    format?: 'markdown' | 'text' | 'raw' | undefined;
+    format?: FetchFormat | undefined;
 }
-interface FetchOutput {
+export interface FetchOutput {
     content: string;
     status: number;
     content_type: string;

package/dist/fetch.js

@@ -1,6 +1,6 @@
 import {
   fetchTool
-} from "./chunk-C2DQKVLO.js";
+} from "./chunk-MJSJWXBF.js";
 import {
   guardedFetch,
   guardedLookup

package/dist/format.d.ts

@@ -1,11 +1,12 @@
-import type { Tool, ToolStreamEvent } from '@wrongstack/core/types';
-interface FormatInput {
+import type { Tool } from '@wrongstack/core/types';
+export type FormatFixer = 'biome' | 'prettier' | 'auto';
+export interface FormatInput {
     files?: string | string[] | undefined;
-    fixer?: 'biome' | 'prettier' | 'auto' | undefined;
+    fixer?: FormatFixer | undefined;
     check?: boolean | undefined;
     cwd?: string | undefined;
 }
-interface FormatOutput {
+export interface FormatOutput {
     fixer: string;
     /** Parsed from formatter output when confidently available; undefined otherwise. */
     files_checked: number | undefined;
@@ -14,46 +15,17 @@ interface FormatOutput {
     output: string;
     truncated: boolean;
 }
-type FormatContext = Parameters<Tool<FormatInput, FormatOutput>['execute']>[1];
-export declare const formatTool: {
-    name: string;
-    category: string;
-    description: string;
-    usageHint: string;
-    permission: "confirm";
-    subjectKey: string;
-    mutating: true;
-    capabilities: string[];
-    icon: "code";
-    timeoutMs: number;
-    inputSchema: {
-        type: string;
-        properties: {
-            files: {
-                type: string;
-                description: string;
-            };
-            fixer: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            check: {
-                type: string;
-                description: string;
-            };
-            cwd: {
-                type: string;
-                description: string;
-            };
-        };
-    };
-    execute(input: FormatInput, ctx: FormatContext, opts?: {
-        signal: AbortSignal;
-    }): Promise<FormatOutput>;
-    executeStream(input: FormatInput, ctx: FormatContext, opts?: {
-        signal: AbortSignal;
-    }): AsyncGenerator<ToolStreamEvent<FormatOutput>>;
+export type FormatContext = Parameters<Tool<FormatInput, FormatOutput>['execute']>[1];
+export declare const formatTool: Tool<FormatInput, FormatOutput>;
+/**
+ * Extract file counts from real formatter output. Biome prints stable summary
+ * lines ("Checked 12 files in 30ms. Fixed 3 files."); anything else (including
+ * prettier's per-file listing, whose shape varies by version and flags) yields
+ * `undefined` rather than a guessed number.
+ */
+export declare function parseFormatterCounts(fixer: string, output: string, isCheck?: boolean): {
+    checked: number | undefined;
+    changed: number | undefined;
 };
-export {};
+export declare function detectFixer(cwd: string): Promise<string | null>;
 //# sourceMappingURL=format.d.ts.map

package/dist/format.js

@@ -1,15 +1,19 @@
 import {
-  formatTool
-} from "./chunk-J74TMK4M.js";
-import "./chunk-I7FBZOEP.js";
-import "./chunk-NDIT3SBZ.js";
-import "./chunk-OYP27E3I.js";
+  detectFixer,
+  formatTool,
+  parseFormatterCounts
+} from "./chunk-NJX2RXKJ.js";
+import "./chunk-T3SMFF5Q.js";
+import "./chunk-7N5U2RAU.js";
+import "./chunk-DRRY6SCM.js";
 import "./chunk-SCMRM6NL.js";
-import "./chunk-ESLPBT5A.js";
-import "./chunk-HFXSNKCV.js";
+import "./chunk-HDYUBRMF.js";
+import "./chunk-7JJFC6CT.js";
 import "./chunk-KE7A76VC.js";
 import "./chunk-ZUFHAHTE.js";
 export {
-  formatTool
+  detectFixer,
+  formatTool,
+  parseFormatterCounts
 };
 //# sourceMappingURL=format.js.map

package/dist/git.d.ts

@@ -1,6 +1,6 @@
 import type { Tool } from '@wrongstack/core/types';
-type GitSubcommand = 'status' | 'log' | 'diff' | 'commit' | 'branch' | 'checkout' | 'stash' | 'push' | 'pull' | 'fetch' | 'reset' | 'worktree';
-interface GitInput {
+export type GitSubcommand = 'status' | 'log' | 'diff' | 'commit' | 'branch' | 'checkout' | 'stash' | 'push' | 'pull' | 'fetch' | 'reset' | 'worktree';
+export interface GitInput {
     command: GitSubcommand;
     files?: string | string[] | undefined;
     dry_run?: boolean | undefined;
@@ -21,7 +21,7 @@ interface GitInput {
     /** force operation (e.g. worktree remove --force) */
     force?: boolean | undefined;
 }
-interface GitOutput {
+export interface GitOutput {
     command: GitSubcommand;
     stdout: string;
     stderr: string;

package/dist/git.js

@@ -1,6 +1,6 @@
 import {
   gitTool
-} from "./chunk-6AAOT4PW.js";
+} from "./chunk-AQ5YBURX.js";
 import "./chunk-ZUFHAHTE.js";
 export {
   gitTool

package/dist/glob.d.ts

@@ -1,13 +1,12 @@
 import type { Tool } from '@wrongstack/core/types';
-interface GlobInput {
+export interface GlobInput {
     pattern: string;
     path?: string | undefined;
     limit?: number | undefined;
 }
-interface GlobOutput {
+export interface GlobOutput {
     files: string[];
     truncated: boolean;
 }
 export declare const globTool: Tool<GlobInput, GlobOutput>;
-export {};
 //# sourceMappingURL=glob.d.ts.map

package/dist/glob.js

@@ -1,8 +1,8 @@
 import {
   globTool
-} from "./chunk-ZMW6WJFT.js";
+} from "./chunk-ASEXQRA7.js";
 import "./chunk-ZBMANLYH.js";
-import "./chunk-DTQ75VBC.js";
+import "./chunk-2CTZW6JQ.js";
 import "./chunk-ZUFHAHTE.js";
 export {
   globTool

package/dist/grep.d.ts

@@ -1,23 +1,25 @@
 import type { Tool } from '@wrongstack/core/types';
-interface GrepInput {
+export type GrepOutputMode = 'content' | 'files_with_matches' | 'count';
+export type GrepEngine = 'rg' | 'native';
+export type GrepBackend = GrepEngine;
+export interface GrepInput {
     pattern: string;
     path?: string | undefined;
     glob?: string | undefined;
-    output_mode?: 'content' | 'files_with_matches' | 'count' | undefined;
+    output_mode?: GrepOutputMode | undefined;
     context_lines?: number | undefined;
     case_insensitive?: boolean | undefined;
     limit?: number | undefined;
 }
-interface GrepOutput {
+export interface GrepOutput {
     matches: string[];
     count: number;
     truncated: boolean;
-    used: 'rg' | 'native';
+    used: GrepEngine;
 }
 export declare const grepTool: Tool<GrepInput, GrepOutput>;
 /** Test-only: forget the cached rg availability so mocks can vary per test. */
 export declare function __resetRgDetectionForTests(): void;
 /** Test-only: explicitly set rg availability to test both engines. */
 export declare function __setRgAvailableForTests(available: boolean | undefined): void;
-export {};
 //# sourceMappingURL=grep.d.ts.map

package/dist/grep.js

@@ -2,10 +2,10 @@ import {
   __resetRgDetectionForTests,
   __setRgAvailableForTests,
   grepTool
-} from "./chunk-XSSFBS5I.js";
-import "./chunk-Q5JPPCZC.js";
+} from "./chunk-4ERMPDHV.js";
+import "./chunk-YJTXRH5Y.js";
 import "./chunk-ZBMANLYH.js";
-import "./chunk-DTQ75VBC.js";
+import "./chunk-2CTZW6JQ.js";
 import "./chunk-ZUFHAHTE.js";
 export {
   __resetRgDetectionForTests,