pi-smart-compact 7.15.1 → 7.18.0

package/SECURITY.md

@@ -4,9 +4,15 @@
 
 Security fixes target the latest published version of `pi-smart-compact`.
 
+| Version | Supported |
+| --- | --- |
+| Latest `7.x` | ✅ |
+| Older | ❌ |
+
 ## Reporting a vulnerability
 
-Please do **not** open a public issue for vulnerabilities, leaked secrets, or private-session data exposure.
+Please do **not** open a public issue for vulnerabilities, leaked secrets, or
+private-session data exposure.
 
 Report privately through GitHub Security Advisories:
 
@@ -14,15 +20,18 @@ Report privately through GitHub Security Advisories:
 
 If advisories are unavailable, contact the maintainer listed in `package.json`.
 
-## Data handling notes
+## Data handling
 
-`pi-smart-compact` processes Pi session content to produce compaction summaries. Depending on your session, this may include repository paths, command output, tool results, and user-provided context.
+`pi-smart-compact` processes Pi session content to produce compaction summaries.
+Depending on the session, this may include repository paths, command output,
+tool results, and user-provided context.
 
 Operational guidance:
 
 - Do not paste secrets into sessions you plan to compact.
 - Redact private logs before attaching them to issues.
 - Treat generated compaction summaries as potentially sensitive project context.
-- Review provider/model configuration before enabling auto-triggered compaction.
+- Review provider / model configuration before enabling auto-triggered compaction.
 
-Runtime artifacts are written under `~/.pi/agent/`; see `README.md` for the current list.
+Runtime artifacts are written under `~/.pi/agent/`; see the
+[runtime artifacts table](./README.md#runtime-artifacts) in the README.

package/SUPPORT.md

@@ -1,17 +1,30 @@
 # Support
 
-For usage questions or bug reports specific to `pi-smart-compact`, open an issue in this repository:
+For usage questions or bug reports specific to `pi-smart-compact`, open an
+issue in this repository:
 
 <https://github.com/alpertarhan/pi-smart-compact/issues>
 
-For Pi Coding Agent core behavior that reproduces without this extension, use the upstream Pi repository:
+For Pi Coding Agent core behavior that reproduces **without** this extension,
+use the upstream Pi repository:
 
 <https://github.com/earendil-works/pi>
 
-When asking for help, include:
+## Before you file
 
-- `pi-smart-compact` version
+Helpful things to include:
+
+- `pi-smart-compact` version (from `package.json` or `/smart-compact` output)
 - Pi Coding Agent version
-- the command or integration surface used (`/smart-compact`, `smart_compact`, or auto-trigger)
+- the integration surface used (`/smart-compact`, `smart_compact`, or auto-trigger)
 - relevant non-secret `smartCompact` configuration
 - redacted error output or logs
+
+## Self-service diagnostics
+
+- `/smart-compact metrics` — profile / provider comparison from the metrics log
+- `/smart-compact dashboard` — interactive TUI dashboard (overview, latest run, current session, recent runs)
+- `/smart-compact dashboard` → *Write HTML dashboard* — a local `~/.pi/agent/.cache/smart-compact-report.html`
+
+For security issues, see [`SECURITY.md`](./SECURITY.md) — please do **not**
+open a public issue for vulnerabilities.

package/dist/app/run-smart-compact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-smart-compact.d.ts","sourceRoot":"","sources":["../../src/app/run-smart-compact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAItD,OAAO,KAAK,EACQ,UAAU,EAC7B,MAAM,kBAAkB,CAAC;AAc1B;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC;;;;;;;OAOG;IACH,GAAG,EAAE,gBAAgB,CAAC;IACtB,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACrB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sGAAsG;IACtG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;CACrD;AAwCD,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4K9E"}
+{"version":3,"file":"run-smart-compact.d.ts","sourceRoot":"","sources":["../../src/app/run-smart-compact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAItD,OAAO,KAAK,EACQ,UAAU,EAC7B,MAAM,kBAAkB,CAAC;AAc1B;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC;;;;;;;OAOG;IACH,GAAG,EAAE,gBAAgB,CAAC;IACtB,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACrB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sGAAsG;IACtG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;CACrD;AAwCD,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmL9E"}

package/dist/app/steps/extract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../src/app/steps/extract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAiB/D,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,WAAW,CA0J1D"}
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../src/app/steps/extract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAkB/D,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,WAAW,CA0J1D"}

package/dist/app/steps/persist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../../src/app/steps/persist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAc,MAAM,gBAAgB,CAAC;AASpE;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAGxD;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CA6BvD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,UAAU,GAAG,iBAAiB,CAcxE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAmBpD"}
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../../src/app/steps/persist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAc,MAAM,gBAAgB,CAAC;AAUpE;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAGxD;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAkCvD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,UAAU,GAAG,iBAAiB,CAcxE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAmBpD"}

package/dist/app/steps/recover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recover.d.ts","sourceRoot":"","sources":["../../../src/app/steps/recover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMjE,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,GAAG,WAAW,CAgB7D"}
+{"version":3,"file":"recover.d.ts","sourceRoot":"","sources":["../../../src/app/steps/recover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAOjE,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,GAAG,WAAW,CAgB7D"}

package/dist/app/steps/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/app/steps/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAU9D,wBAAgB,UAAU,CAAC,EAAE,EAAE,UAAU,GAAG,QAAQ,CAqEnD"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/app/steps/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAY9D,wBAAgB,UAAU,CAAC,EAAE,EAAE,UAAU,GAAG,QAAQ,CAqFnD"}

package/dist/app/steps/synthesize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"synthesize.d.ts","sourceRoot":"","sources":["../../../src/app/steps/synthesize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAUH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGpE,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CA6MnF"}
+{"version":3,"file":"synthesize.d.ts","sourceRoot":"","sources":["../../../src/app/steps/synthesize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAUH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGpE,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAoNnF"}

package/dist/constants.d.ts

@@ -8,7 +8,7 @@ import type { CompressionProfile, ProfileConfig } from "./types.ts";
  * `package.json#version`. Do not hand-edit this line for releases; bump
  * package.json and run `bun run sync-version`.
  */
-export declare const VERSION = "7.15.1";
+export declare const VERSION = "7.18.0";
 export declare const CHARS_PER_TOKEN = 3.8;
 export declare const COMPACT_SYSTEM_PREFIX: string;
 export declare const PROFILES: Record<CompressionProfile, ProfileConfig>;
@@ -22,6 +22,7 @@ export declare const DEFAULT_CONFIG: {
     backupEnabled: boolean;
     backupDir: string;
     minContextPercent: number;
+    pinPaths: string[];
 };
 export declare const NO_OP_RE: RegExp;
 export declare const SHIFT_RE: RegExp;
@@ -49,11 +50,66 @@ export declare const MIN_TOKEN_THRESHOLD = 5000;
 export declare const MAX_EXPLORATION_ROUNDS = 8;
 export declare const BACKUP_MAX_FILES = 20;
 export declare const BACKUP_MAX_AGE_MS: number;
-export declare const SUMMARY_SNIPPET_LEN = 100;
-export declare const SHORT_SUMMARY_LEN = 60;
-export declare const ERROR_FUZZY_MATCH_LEN = 30;
+export declare const FIVE_MINUTES_MS: number;
+export declare const ONE_HOUR_MS: number;
+export declare const SEVEN_DAYS_MS: number;
+export declare const THIRTY_DAYS_MS: number;
+export declare const EXTRACTION_CACHE_PREFIX = "compact-extraction-";
+export declare const ID_PREFIX: {
+    readonly PROJECT: "proj-";
+    readonly COMPACT_SESSION: "sc-";
+    readonly MULTI_TOOL_USE_SYNTHETIC: "mtu_";
+    readonly OPEN_LOOP: "loop-";
+    readonly DECISION: "decision-";
+    readonly ERROR: "error-";
+};
+export declare const TUNING: {
+    readonly EMA_PREV: 0.7;
+    readonly EMA_SAMPLE: 0.3;
+    readonly CALIBRATION_CLAMP_MIN: 0.3;
+    readonly CALIBRATION_CLAMP_MAX: 3;
+    readonly CONFIDENCE_HIGH: 0.85;
+    readonly CONFIDENCE_MEDIUM: 0.8;
+    readonly CONFIDENCE_LOW: 0.6;
+};
+export declare const TRUNC: {
+    readonly MESSAGE: 300;
+    readonly ERROR_DETAIL: 500;
+    readonly DECISION_SUMMARY: 200;
+    readonly USER_RESPONSE: 300;
+    readonly CONSTRAINT_TEXT: 300;
+    readonly OPEN_LOOP_SUMMARY: 120;
+    readonly TIMELINE_EVENT: 150;
+    readonly TIMELINE_ERROR: 100;
+    readonly SNIPPET: 80;
+    readonly PREVIEW: 150;
+    readonly PREVIEW_MID: 200;
+    readonly DETAIL: 300;
+    readonly PREVIEW_LONG: 400;
+    readonly PREVIEW_XL: 500;
+    readonly CHUNK_FALLBACK: 180;
+    readonly DECISION_DETAIL: 60;
+    readonly TOPIC_LABEL: 100;
+    readonly PROJ_ID_HASH: 12;
+    readonly CONV_HASH: 8;
+    readonly RESULT_GAPS: 5;
+    readonly SESSION_ID_DISPLAY: 20;
+    readonly ERROR_SNIPPET: 30;
+    readonly TIMELINE_DISPLAY: 10;
+    readonly EXPLORE_RESULTS: 15;
+    readonly BACKUP_PREVIEW_LINES: 5;
+    readonly FINGERPRINT_SEG: 2;
+};
 export declare const DAMAGE_RECENT_MSG_WINDOW = 15;
 export declare const MAX_TOOL_OUTPUT_CHARS = 800;
+/** Shell-output patterns signalling a likely error even in a non-`isError` result. */
+export declare const LIKELY_ERROR_RE: RegExp;
+/** catalogErrors only scans outputs shorter than this — pruning must not truncate below it. */
+export declare const ERROR_SCAN_MAX_LEN = 2000;
+/** How far forward to look for a retry of the same tool after an error. */
+export declare const ERROR_RETRY_WINDOW = 6;
+/** How far forward to look for that retry's resolving (non-error) result. */
+export declare const ERROR_RESOLVE_WINDOW = 10;
 export declare const METRICS_BUFFER_MAX = 200;
 export declare const DAMAGE_LOOKBACK_MSGS = 15;
 export declare const VERIFICATION_GAP_SNIPPET_LEN = 80;

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,OAAO,WAAW,CAAC;AAChC,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,eAAO,MAAM,qBAAqB,QAKqB,CAAC;AAExD,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,kBAAkB,EAAE,aAAa,CAyB9D,CAAC;AAEF,eAAO,MAAM,cAAc;aACF,kBAAkB;;kBAEnB,MAAM,GAAG,IAAI;uBACR,MAAM,GAAG,IAAI;;;;;;CAMzC,CAAC;AAEF,eAAO,MAAM,QAAQ,QAA+E,CAAC;AACrG,eAAO,MAAM,QAAQ,QAAuH,CAAC;AAC7I,eAAO,MAAM,SAAS,QAAmG,CAAC;AAI1H,eAAO,MAAM,kBAAkB,QAgB+C,CAAC;AAE/E,eAAO,MAAM,kBAAkB,yHACyF,CAAC;AAEzH,eAAO,MAAM,mBAAmB,QAWoB,CAAC;AAErD,eAAO,MAAM,mBAAmB,8DAA8D,CAAC;AAE/F,eAAO,MAAM,sBAAsB,QAoB2B,CAAC;AAE/D,eAAO,MAAM,sBAAsB,8OAC0M,CAAC;AAI9O,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAK5D,CAAC;AAGF,eAAO,MAAM,YAAY,YAAY,CAAC;AACtC,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAClE,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAC9C,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AACpD,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAC1D,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAClD,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAClD,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAC9D,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAClD,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAClD,eAAO,MAAM,eAAe,qCAAqC,CAAC;AAGlE,eAAO,MAAM,UAAU,oBAAoB,CAAC;AAG5C,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAQxC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,iBAAiB,QAA2B,CAAC;AAO1D,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAG3C,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAOzC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAGtC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAGvC,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAG/C,eAAO,MAAM,UAAU,iBAAiB,CAAC;AACzC,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAEhD,eAAO,MAAM,sBAAsB,QAU6T,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/domain/keywords.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Salient-keyword extraction for fuzzy "is this concept covered?" checks.
+ *
+ * Pure (no I/O) — lives in the domain layer so both the verify phase and the
+ * damage detector share one implementation instead of each re-deriving a
+ * "first N long words" heuristic (which picked positional noise and missed the
+ * real term further into the text).
+ *
+ * ponytail ceiling: this is still keyword/substring matching. A paraphrase
+ * ("TS" vs "TypeScript") can't be recognized — an inherent limit of the cheap
+ * proxy, not fixable without an LLM judge (which would defeat deterministic-first).
+ */
+/**
+ * Extract salient keyword tokens from a source string. Strips punctuation and
+ * prefers proper nouns / identifiers (capitalized or digit-bearing) over
+ * positional fillers. Returns at most `max` tokens, original case preserved
+ * (callers lower-case as needed for comparison).
+ */
+export declare function extractCheckKeywords(text: string, max: number): string[];
+//# sourceMappingURL=keywords.d.ts.map

package/dist/domain/keywords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keywords.d.ts","sourceRoot":"","sources":["../../src/domain/keywords.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAQxE"}

package/dist/domain/tool-semantics.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Name-agnostic tool classification by argument shape.
+ *
+ * Extraction used to classify tools by NAME — `hasToolHint(name, ["write",
+ * "edit", ...])` and `tc.name === "bash"`. That is a proxy: a tool is a write
+ * tool because its ARGUMENTS carry a content payload, not because its name
+ * happens to contain "write". Name matching is also churn-fragile —
+ * `read` → `hypa_read` → whatever-next silently drops off the list, and every
+ * new tool demands a code change.
+ *
+ * We classify by what the tool CARRIES, which is invariant under renaming:
+ *
+ *   mutates   — a path-like arg AND a content payload (write/edit/append/...)
+ *   executes  — a command/shell arg (bash/hypa_shell/...)
+ *   accesses  — a path-like arg with no payload (read/grep/find/ls)
+ *   other     — none of the above (ask_user, process, ...)
+ *
+ * The argument-name conventions (path/content/command) are far more stable
+ * across tools and providers than tool names, so this auto-adapts to tools
+ * this code has never seen (hypa_*, MCP tools, custom extensions) without a
+ * single name in a list.
+ *
+ * Ceiling (documented, not hidden): a DELETE cannot be told from a READ by
+ * arguments alone — both carry only a path. Callers that need deletion must
+ * resolve it from the result text. Bash-style tools that take a free-text
+ * `command` are opaque to file-path tracking by construction.
+ *
+ * Pure: no I/O, no async, no globals — lives in the domain layer alongside
+ * `summary-schema.ts`.
+ */
+/**
+ * Extract a non-empty file-path argument from a tool call, covering common key
+ * names. Returns undefined when no usable path is present.
+ */
+export declare function extractToolPath(args: unknown): string | undefined;
+export type ToolClass = "mutates" | "accesses" | "executes" | "other";
+/**
+ * Classify a tool by its argument shape, independent of its name.
+ *
+ * Order matters: a path + payload wins as `mutates` even if a command key is
+ * also present (a write tool that logs a command is still a write). A bare
+ * command with no path is `executes`. A bare path is `accesses`.
+ */
+export declare function classifyTool(args: unknown): ToolClass;
+//# sourceMappingURL=tool-semantics.d.ts.map

package/dist/domain/tool-semantics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-semantics.d.ts","sourceRoot":"","sources":["../../src/domain/tool-semantics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AA4BH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQjE;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAEtE;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAUrD"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,iCAAiC,CAAC;AA4EtF,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,EAAE,EAAE,YAAY,QAiO7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,iCAAiC,CAAC;AA0EtF,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,EAAE,EAAE,YAAY,QAsQ7D"}