@wrongstack/plugins 0.284.1 → 0.286.0

package/README.md

@@ -1,9 +1,10 @@
 # @wrongstack/plugins
 
 First-party plugin collection for [WrongStack](https://github.com/WrongStack/WrongStack).
-Sixty-three focused, single-purpose plugins ship in this package. Core safety
-plugins load automatically for every `wstack` session; provider-wire plugins
-are opt-in because they can change model-call semantics.
+Sixty-three focused, single-purpose plugins ship in this package. Passive,
+broadly applicable diagnostics and bounded safety checks load automatically;
+plugins with automatic mutation, policy enforcement, network egress, background
+work, or provider-call semantic changes are opt-in.
 
 ## What this is
 
@@ -15,8 +16,10 @@ exports a default `Plugin` object. The host's plugin loader
 `secret-scanner` registers `PreToolUse` + `PostToolUse` hooks).
 
 Plugins are loaded lazily by `packages/cli/src/wiring/plugins.ts`
-under the `BUILTIN_PLUGIN_FACTORIES` array. To opt out, add
-`{ name: '<plugin>', enabled: false }` to `config.plugins`.
+under the `BUILTIN_PLUGIN_FACTORIES` array. The canonical default is
+`PLUGIN_AUDIT_ENTRIES.defaultState`: list an inactive plugin with
+`{ name: '<plugin>', enabled: true }` to opt in, or list an active plugin with
+`enabled: false` to opt out.
 
 ## Plugin catalog
 
@@ -34,9 +37,9 @@ under the `BUILTIN_PLUGIN_FACTORIES` array. To opt out, add
 | 10 | [`todo-tracker`](./src/todo-tracker) | `todo_tracker_*` | — | Persistent project-scoped backlog that survives sessions |
 | 11 | [`token-budget`](./src/token-budget) | `token_budget_status` | `Stop` + `PostToolUse` | Tracks token use and can warn/stop at configured limits |
 | 12 | [`lint-gate`](./src/lint-gate) | `lint_gate_status` | `PreToolUse` | Lints would-be write/edit content before mutation |
-| 13 | [`branch-guard`](./src/branch-guard) | `branch_guard_status` | `PreToolUse` | Blocks or warns on commits, pushes, and merges on protected branches |
+| 13 | [`branch-guard`](./src/branch-guard) | `branch_guard_status` | `PreToolUse` | Opt-in protected-branch policy for commits, pushes, and merges |
 | 14 | [`diff-summary`](./src/diff-summary) | `diff_summary_status` | `PostToolUse` | Injects compact git diff context after write/edit |
-| 15 | [`commit-validator`](./src/commit-validator) | `commit_validator_status` | `PreToolUse` | Validates conventional-commit messages |
+| 15 | [`commit-validator`](./src/commit-validator) | `commit_validator_status` | `PreToolUse` | Opt-in conventional-commit policy |
 | 16 | [`format-on-save`](./src/format-on-save) | `format_on_save_status` | `PostToolUse` | Runs formatter after write/edit |
 | 17 | [`test-runner-gate`](./src/test-runner-gate) | `test_gate_status` | `PostToolUse` | Runs relevant tests after source edits |
 | 18 | [`import-organizer`](./src/import-organizer) | `import_organizer_status` | `PostToolUse` | Organizes imports and applies safe fixes after write/edit |
@@ -44,9 +47,9 @@ under the `BUILTIN_PLUGIN_FACTORIES` array. To opt out, add
 | 20 | [`session-recap`](./src/session-recap) | `session_recap_status` | `Stop` | Posts a compact session recap to the project mailbox |
 | 21 | [`spec-linker`](./src/spec-linker) | `spec_linker_status` | `PreToolUse` + `PostToolUse` | Detects unlinked plugin references in markdown docs |
 | 22 | [`loop-breaker`](./src/loop-breaker) | `loop_breaker_status` | `PreToolUse` | Detects repeated tool-call loops and oscillations |
-| 23 | [`path-guard`](./src/path-guard) | `path_guard_status` | `PreToolUse` | Guards protected paths from writes and destructive shell commands |
+| 23 | [`path-guard`](./src/path-guard) | `path_guard_status` | `PreToolUse` | Opt-in protected-path policy for writes and destructive commands |
 | 24 | [`context-pins`](./src/context-pins) | `pin_add`, `pin_remove`, `pin_list` | System prompt contributor | Persists short pinned facts across compaction/session boundaries |
-| 25 | [`checkpoint`](./src/checkpoint) | `checkpoint_create`, `checkpoint_list`, `checkpoint_restore` | `PreToolUse` | Captures file snapshots before risky edits and restores them on demand |
+| 25 | [`checkpoint`](./src/checkpoint) | `checkpoint_create`, `checkpoint_list`, `checkpoint_restore` | `PreToolUse` | Opt-in in-memory snapshots of pre-edit file contents |
 | 26 | [`error-lens`](./src/error-lens) | `error_lens_history` | `PostToolUse` | Summarizes failed tool output and repeated failure patterns |
 | 27 | [`dep-guard`](./src/dep-guard) | `dep_guard_status` | `PreToolUse` | Supervises dependency installs for deny-list and supply-chain warnings |
 | 28 | [`config-validator`](./src/config-validator) | `config_validator_status` | `PostToolUse` | Validates edited JSON/JSONC/YAML/TOML config files |
@@ -61,10 +64,10 @@ under the `BUILTIN_PLUGIN_FACTORIES` array. To opt out, add
 | 37 | [`type-gate`](./src/type-gate) | `type_gate_status` | `PostToolUse` | Runs `tsc --noEmit` after `write`/`edit` to catch type regressions |
 | 38 | [`test-coverage-gate`](./src/test-coverage-gate) | `coverage_gate_status` | `PostToolUse` | Detects test-coverage regressions after source-file edits |
 | 39 | [`pr-drafter`](./src/pr-drafter) | `pr_draft` | `Stop` + event subscriptions | Drafts a pull-request description from session commits/files/diff |
-| 40 | [`agent-handoff`](./src/agent-handoff) | `handoff_note`, `handoff_status` | `subagent.done` event listener | Posts structured handoff notes when subagents finish |
+| 40 | [`agent-handoff`](./src/agent-handoff) | `handoff_note`, `handoff_status` | `subagent.done` event listener | Opt-in mailbox publication of subagent results |
 | 41 | [`knowledge-graph`](./src/knowledge-graph) | `kg_add_fact`, `kg_query`, `kg_remove_fact`, `kg_status` | System prompt contributor | Persistent structured (subject, relation, object) project facts |
 | 42 | [`dead-code-detector`](./src/dead-code-detector) | `dead_code_scan` | `PostToolUse` | Regex-based scan for exported identifiers that appear unused |
-| 43 | [`dependency-vulnerability-gate`](./src/dependency-vulnerability-gate) | `dependency_audit_status` | `PostToolUse` | Runs `npm/pnpm audit` after installs and blocks on severe vulnerabilities |
+| 43 | [`dependency-vulnerability-gate`](./src/dependency-vulnerability-gate) | `dependency_audit_status` | `PostToolUse` | Opt-in blocking `npm/pnpm audit` after installs |
 | 44 | [`migration-planner`](./src/migration-planner) | `migration_plan`, `migration_status` | `PostToolUse` | Reads changelogs and produces version-migration checklists |
 | 45 | [`semantic-search-indexer`](./src/semantic-search-indexer) | `semantic_search`, `semantic_index_status` | — | Lightweight keyword index over project source files |
 | 46 | [`auto-i18n-extractor`](./src/auto-i18n-extractor) | `i18n_extract`, `i18n_status` | `PostToolUse` | Detects hardcoded user-facing strings and suggests i18n keys |
@@ -722,7 +725,7 @@ the PostToolUse context tells the LLM what to fix.
 
 **Detection rules** (both hooks):
 - Source matches `config.fileGlobs` (default: `**/*.md`, `**/*.mdx`)
-- The reference matches one of the 62 known plugin names
+- The reference matches one of the 63 known plugin names
   (case-insensitive)
 - It is NOT already wrapped in a markdown link `[name](...)` or
   inline code `` `name` ``
@@ -1138,8 +1141,9 @@ const plugin: Plugin = {
 export default plugin;
 ```
 
-Register the entry in `tsup.config.ts`, the subpath export in
-`package.json#exports`, and the named re-export in `src/index.ts`.
+Register the subpath export in `package.json#exports` and the named re-export
+in `src/index.ts`. The centralized package builder discovers plugin entry
+points from the exports map, so no per-plugin build configuration is needed.
 Wire it into the CLI's `BUILTIN_PLUGIN_FACTORIES` if it should
 auto-load.
 

package/dist/accessibility-auditor/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * accessibility-auditor plugin — audits UI files for common accessibility
+ * issues using fast regex-based heuristics.
+ *
+ * Tools registered:
+ * - a11y_audit : Scan a file or directory for a11y issues.
+ * - a11y_status : Show config + per-session counters.
+ *
+ * Hooks registered:
+ * - PostToolUse with matcher `write|edit` to UI files, injecting a short
+ *   additionalContext summary of any new accessibility issues.
+ *
+ * Config (`config.extensions['accessibility-auditor']`):
+ *
+ * ```jsonc
+ * {
+ *   "enabled": true,
+ *   "includeExtensions": [".tsx", ".jsx", ".html", ".vue"],
+ *   "maxFindings": 50,
+ *   "severity": "warn",         // "warn" | "block"
+ *   "onWriteEdit": true
+ * }
+ * ```
+ *
+ * @public
+ */
+import type { Plugin } from '@wrongstack/core';
+export type A11yRule = 'missing-alt' | 'missing-input-label' | 'low-contrast-placeholder' | 'missing-button-text' | 'duplicate-id';
+export interface A11yFinding {
+    file: string;
+    line: number;
+    rule: A11yRule;
+    severity: 'error' | 'warning';
+    message: string;
+}
+declare const plugin: Plugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/accessibility-auditor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/accessibility-auditor/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAQ/C,MAAM,MAAM,QAAQ,GAChB,aAAa,GACb,qBAAqB,GACrB,0BAA0B,GAC1B,qBAAqB,GACrB,cAAc,CAAC;AAEnB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAwSD,QAAA,MAAM,MAAM,EAAE,MA0Nb,CAAC;eAEa,MAAM"}

package/dist/accessibility-auditor.d.ts

@@ -1,40 +1,2 @@
-import { Plugin } from '@wrongstack/core';
-
-/**
- * accessibility-auditor plugin — audits UI files for common accessibility
- * issues using fast regex-based heuristics.
- *
- * Tools registered:
- * - a11y_audit : Scan a file or directory for a11y issues.
- * - a11y_status : Show config + per-session counters.
- *
- * Hooks registered:
- * - PostToolUse with matcher `write|edit` to UI files, injecting a short
- *   additionalContext summary of any new accessibility issues.
- *
- * Config (`config.extensions['accessibility-auditor']`):
- *
- * ```jsonc
- * {
- *   "enabled": true,
- *   "includeExtensions": [".tsx", ".jsx", ".html", ".vue"],
- *   "maxFindings": 50,
- *   "severity": "warn",         // "warn" | "block"
- *   "onWriteEdit": true
- * }
- * ```
- *
- * @public
- */
-
-type A11yRule = 'missing-alt' | 'missing-input-label' | 'low-contrast-placeholder' | 'missing-button-text' | 'duplicate-id';
-interface A11yFinding {
-    file: string;
-    line: number;
-    rule: A11yRule;
-    severity: 'error' | 'warning';
-    message: string;
-}
-declare const plugin: Plugin;
-
-export { type A11yFinding, type A11yRule, plugin as default };
+export * from './accessibility-auditor/index.js';
+export { default } from './accessibility-auditor/index.js';

package/dist/accessibility-auditor.js

@@ -1,7 +1,6 @@
-import { existsSync, statSync, readFileSync, readdirSync } from 'fs';
-import { isAbsolute, resolve, relative } from 'path';
-
 // src/accessibility-auditor/index.ts
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { isAbsolute, relative, resolve } from "node:path";
 var API_VERSION = "^0.1.10";
 var state = {
   auditCount: 0,
@@ -120,24 +119,21 @@ function auditFile(filePath, projectRoot) {
   for (let i = 0; i < lines.length; i++) {
     const line = lines[i];
     const lineNo = i + 1;
-    let idMatch;
-    while ((idMatch = ATTR_ID.exec(line)) !== null) {
+    for (const idMatch of line.matchAll(ATTR_ID)) {
       const id = idMatch[1];
       const list = idsByValue.get(id) ?? [];
       list.push(lineNo);
       idsByValue.set(id, list);
     }
     ATTR_ID.lastIndex = 0;
-    let imgMatch;
-    while ((imgMatch = TAG_IMG.exec(line)) !== null) {
+    for (const imgMatch of line.matchAll(TAG_IMG)) {
       const tag = imgMatch[0];
       if (!hasMeaningfulAlt(tag)) {
         add(lineNo, "missing-alt", "error", "<img> is missing meaningful alt text");
       }
     }
     TAG_IMG.lastIndex = 0;
-    let inputMatch;
-    while ((inputMatch = TAG_INPUT.exec(line)) !== null) {
+    for (const inputMatch of line.matchAll(TAG_INPUT)) {
       const tag = inputMatch[0];
       const typeMatch = tag.match(/\btype\s*=\s*["']?([^"'\s>]*)["']?/i);
       const type = typeMatch ? typeMatch[1].toLowerCase() : "text";
@@ -162,8 +158,7 @@ function auditFile(filePath, projectRoot) {
       }
     }
     TAG_INPUT.lastIndex = 0;
-    let buttonMatch;
-    while ((buttonMatch = TAG_BUTTON.exec(line)) !== null) {
+    for (const buttonMatch of line.matchAll(TAG_BUTTON)) {
       const tag = buttonMatch[0];
       const inner = buttonMatch[1] ?? "";
       const hasText = inner.replace(/\s+/g, "").length > 0;
@@ -174,8 +169,7 @@ function auditFile(filePath, projectRoot) {
       }
     }
     TAG_BUTTON.lastIndex = 0;
-    let inputButtonMatch;
-    while ((inputButtonMatch = INPUT_BUTTON.exec(line)) !== null) {
+    for (const inputButtonMatch of line.matchAll(INPUT_BUTTON)) {
       const tag = inputButtonMatch[0];
       if (!ATTR_VALUE.test(tag) && !ATTR_ARIA_LABEL.test(tag) && !ATTR_TITLE.test(tag)) {
         add(lineNo, "missing-button-text", "error", `<input type="${inputButtonMatch[1]}"> is missing value/aria-label/title`);
@@ -407,5 +401,6 @@ var plugin = {
   }
 };
 var accessibility_auditor_default = plugin;
-
-export { accessibility_auditor_default as default };
+export {
+  accessibility_auditor_default as default
+};

package/dist/agent-handoff/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * agent-handoff plugin — turns subagent completions into structured
+ * handoff notes for the next agent.
+ *
+ * When a subagent finishes (`subagent.done` event), this plugin extracts
+ * its identity, task, result, and any todo context, then posts a compact
+ * mailbox message addressed to the parent/leader agent so the next
+ * worker or the leader can pick up where it left off.
+ *
+ * Tools registered:
+ * - handoff_note : Manually compose and send a handoff note.
+ * - handoff_status : Counters + last handoff id.
+ *
+ * Events subscribed:
+ * - `subagent.done`
+ *
+ * Config (`config.extensions['agent-handoff']`):
+ *
+ * ```jsonc
+ * {
+ *   "enabled": true,
+ *   "subjectPrefix": "handoff: ",
+ *   "includeResult": true,
+ *   "includeTodos": true,
+ *   "maxBodyChars": 4000,
+ *   "to": "leader"   // default recipient alias
+ * }
+ * ```
+ *
+ * @public
+ */
+import type { Plugin } from '@wrongstack/core';
+declare const plugin: Plugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/agent-handoff/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-handoff/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,MAAM,EAA6B,MAAM,kBAAkB,CAAC;AAwK1E,QAAA,MAAM,MAAM,EAAE,MAsNb,CAAC;eAEa,MAAM"}

package/dist/agent-handoff.d.ts

@@ -1,37 +1,2 @@
-import { Plugin } from '@wrongstack/core';
-
-/**
- * agent-handoff plugin — turns subagent completions into structured
- * handoff notes for the next agent.
- *
- * When a subagent finishes (`subagent.done` event), this plugin extracts
- * its identity, task, result, and any todo context, then posts a compact
- * mailbox message addressed to the parent/leader agent so the next
- * worker or the leader can pick up where it left off.
- *
- * Tools registered:
- * - handoff_note : Manually compose and send a handoff note.
- * - handoff_status : Counters + last handoff id.
- *
- * Events subscribed:
- * - `subagent.done`
- *
- * Config (`config.extensions['agent-handoff']`):
- *
- * ```jsonc
- * {
- *   "enabled": true,
- *   "subjectPrefix": "handoff: ",
- *   "includeResult": true,
- *   "includeTodos": true,
- *   "maxBodyChars": 4000,
- *   "to": "leader"   // default recipient alias
- * }
- * ```
- *
- * @public
- */
-
-declare const plugin: Plugin;
-
-export { plugin as default };
+export * from './agent-handoff/index.js';
+export { default } from './agent-handoff/index.js';

package/dist/agent-handoff.js

@@ -294,5 +294,6 @@ var plugin = {
   }
 };
 var agent_handoff_default = plugin;
-
-export { agent_handoff_default as default };
+export {
+  agent_handoff_default as default
+};

package/dist/api-compatibility-gate/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * api-compatibility-gate plugin — guards public API surface changes.
+ *
+ * Registers a PostToolUse hook on `write|edit` to entry-point files
+ * (`index.ts`, `src/index.ts`, or package `main`/`module`/`exports`
+ * targets). For each such edit it reads the previous version from git
+ * (`git show HEAD:<path>`), parses exported identifiers with simple
+ * regex heuristics, and reports any removed exports as breaking changes.
+ *
+ * Tools registered:
+ * - api_compat_status : Show config + per-session counters.
+ *
+ * Hooks registered:
+ * - PostToolUse with matcher `write|edit`.
+ *
+ * Config (`config.extensions['api-compatibility-gate']`):
+ *
+ * ```jsonc
+ * {
+ *   "enabled": true,
+ *   "severity": "warn",          // "warn" | "block"
+ *   "entryPointPatterns": [      // glob-style patterns
+ *     "**&#47;index.ts",
+ *     "**&#47;index.js",
+ *     "**&#47;src/index.ts"
+ *   ],
+ *   "trackGitHistory": true      // read pre-edit source from git
+ * }
+ * ```
+ *
+ * @public
+ */
+import type { Plugin } from '@wrongstack/core';
+declare const plugin: Plugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/api-compatibility-gate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api-compatibility-gate/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAkR/C,QAAA,MAAM,MAAM,EAAE,MA6Mb,CAAC;eAEa,MAAM"}

package/dist/api-compatibility-gate.d.ts

@@ -1,38 +1,2 @@
-import { Plugin } from '@wrongstack/core';
-
-/**
- * api-compatibility-gate plugin — guards public API surface changes.
- *
- * Registers a PostToolUse hook on `write|edit` to entry-point files
- * (`index.ts`, `src/index.ts`, or package `main`/`module`/`exports`
- * targets). For each such edit it reads the previous version from git
- * (`git show HEAD:<path>`), parses exported identifiers with simple
- * regex heuristics, and reports any removed exports as breaking changes.
- *
- * Tools registered:
- * - api_compat_status : Show config + per-session counters.
- *
- * Hooks registered:
- * - PostToolUse with matcher `write|edit`.
- *
- * Config (`config.extensions['api-compatibility-gate']`):
- *
- * ```jsonc
- * {
- *   "enabled": true,
- *   "severity": "warn",          // "warn" | "block"
- *   "entryPointPatterns": [      // glob-style patterns
- *     "**&#47;index.ts",
- *     "**&#47;index.js",
- *     "**&#47;src/index.ts"
- *   ],
- *   "trackGitHistory": true      // read pre-edit source from git
- * }
- * ```
- *
- * @public
- */
-
-declare const plugin: Plugin;
-
-export { plugin as default };
+export * from './api-compatibility-gate/index.js';
+export { default } from './api-compatibility-gate/index.js';

package/dist/api-compatibility-gate.js

@@ -1,8 +1,7 @@
-import { execFileSync } from 'child_process';
-import { readFileSync, existsSync } from 'fs';
-import { relative, isAbsolute, dirname, resolve, basename, extname } from 'path';
-
 // src/api-compatibility-gate/index.ts
+import { execFileSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { basename, dirname, extname, isAbsolute, relative, resolve } from "node:path";
 var API_VERSION = "^0.1.10";
 var state = {
   invocationCount: 0,
@@ -353,5 +352,6 @@ var plugin = {
   }
 };
 var api_compatibility_gate_default = plugin;
-
-export { api_compatibility_gate_default as default };
+export {
+  api_compatibility_gate_default as default
+};

package/dist/auto-doc/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * auto-doc plugin — Auto-generates JSDoc/TSDoc comments for source files.
+ *
+ * Tools registered:
+ * - auto_doc: Generate and inject doc comments into JS/TS files.
+ *   Pass `dry_run: true` to preview without writing (replaces the former
+ *   `auto_doc (dry_run)` tool).
+ *
+ * LLM mode (opt-in): with `config.extensions['auto-doc'].useLlm = true`
+ * (or per-call `use_llm: true`) and a host that wires `api.llm`, each
+ * doc comment's prose is written by the LLM from the entity's signature
+ * and body instead of the `TODO: describe …` placeholder. Provider/model
+ * follow the plugin's `config.extensions['auto-doc'].llm` override, then
+ * the session default. Best-effort: any LLM failure (or a bad response)
+ * falls back to the template for that entity — a doc comment always lands.
+ */
+import type { Plugin } from '@wrongstack/core';
+declare const plugin: Plugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/auto-doc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auto-doc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,MAAM,EAAa,MAAM,kBAAkB,CAAC;AA4W1D,QAAA,MAAM,MAAM,EAAE,MAqIb,CAAC;eAEa,MAAM"}

package/dist/auto-doc.d.ts

@@ -1,22 +1,2 @@
-import { Plugin } from '@wrongstack/core';
-
-/**
- * auto-doc plugin — Auto-generates JSDoc/TSDoc comments for source files.
- *
- * Tools registered:
- * - auto_doc: Generate and inject doc comments into JS/TS files.
- *   Pass `dry_run: true` to preview without writing (replaces the former
- *   `auto_doc (dry_run)` tool).
- *
- * LLM mode (opt-in): with `config.extensions['auto-doc'].useLlm = true`
- * (or per-call `use_llm: true`) and a host that wires `api.llm`, each
- * doc comment's prose is written by the LLM from the entity's signature
- * and body instead of the `TODO: describe …` placeholder. Provider/model
- * follow the plugin's `config.extensions['auto-doc'].llm` override, then
- * the session default. Best-effort: any LLM failure (or a bad response)
- * falls back to the template for that entity — a doc comment always lands.
- */
-
-declare const plugin: Plugin;
-
-export { plugin as default };
+export * from './auto-doc/index.js';
+export { default } from './auto-doc/index.js';

package/dist/auto-doc.js

@@ -1,6 +1,5 @@
-import { resolve, isAbsolute, relative } from 'path';
-
 // src/auto-doc/index.ts
+import { isAbsolute, relative, resolve } from "node:path";
 var AUTO_DOC_API_VERSION = "^0.1.10";
 function resolveProjectPath(rawPath, cwd = process.cwd()) {
   if (typeof rawPath !== "string" || rawPath.length === 0) return null;
@@ -187,7 +186,7 @@ async function runAutoDoc(input, api) {
       continue;
     }
     try {
-      const { readFileSync, writeFileSync } = await import('fs');
+      const { readFileSync, writeFileSync } = await import("node:fs");
       let content;
       try {
         content = readFileSync(safeFile, "utf-8");
@@ -347,5 +346,6 @@ var plugin = {
   }
 };
 var auto_doc_default = plugin;
-
-export { auto_doc_default as default };
+export {
+  auto_doc_default as default
+};

package/dist/auto-escalate/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * auto-escalate plugin — turns transient provider errors into a graceful
+ * model-escalation ladder instead of a hard failure.
+ *
+ * Registers an `AgentExtension.onError` hook (wired at agent-loop.ts:636).
+ * When a provider call fails with a retryable error (overload, rate
+ * limit, timeout, 5xx), the plugin asks the agent loop to retry the turn
+ * with the NEXT model in a configured escalation ladder — e.g. a busy
+ * fast model escalates to a more capable one that may have spare
+ * capacity. On a non-retryable error, or once the ladder is exhausted,
+ * it steps aside (returns nothing) so the host's built-in error recovery
+ * runs unchanged.
+ *
+ * Loop constraint: the agent loop caps recovery retries at 2 per turn
+ * (agent-loop.ts), so at most the first ~2 rungs of the ladder are used
+ * before the loop fails. Order the ladder cheapest→most-capable.
+ *
+ * Safety posture: opt-in — loads inert until
+ * `config.extensions['auto-escalate'].enabled = true`. It never forces a
+ * `fail`; it only requests retries with a better model, and otherwise
+ * defers to the default handler.
+ *
+ * Config (`config.extensions['auto-escalate']`):
+ *
+ * ```jsonc
+ * {
+ *   "enabled": false,
+ *   "escalation": ["provider/model-standard", "provider/model-premium"],
+ *   "retryablePatterns": ["overload", "rate.?limit", "429", "50[023]", "timeout", "ETIMEDOUT", "ECONNRESET"]
+ * }
+ * ```
+ *
+ * Tools:
+ *  - `auto_escalate_status` — ladder, patterns, and escalation counters
+ *
+ * @public
+ */
+import type { Plugin } from '@wrongstack/core';
+export declare function errorText(err: unknown): string;
+export declare function isRetryable(text: string, patterns: RegExp[]): boolean;
+declare const plugin: Plugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/auto-escalate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auto-escalate/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,KAAK,EAAE,MAAM,EAAa,MAAM,kBAAkB,CAAC;AAgF1D,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQ9C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAErE;AAMD,QAAA,MAAM,MAAM,EAAE,MAkJb,CAAC;eAEa,MAAM"}

package/dist/auto-escalate.d.ts

@@ -1,45 +1,2 @@
-import { Plugin } from '@wrongstack/core';
-
-/**
- * auto-escalate plugin — turns transient provider errors into a graceful
- * model-escalation ladder instead of a hard failure.
- *
- * Registers an `AgentExtension.onError` hook (wired at agent-loop.ts:636).
- * When a provider call fails with a retryable error (overload, rate
- * limit, timeout, 5xx), the plugin asks the agent loop to retry the turn
- * with the NEXT model in a configured escalation ladder — e.g. a busy
- * fast model escalates to a more capable one that may have spare
- * capacity. On a non-retryable error, or once the ladder is exhausted,
- * it steps aside (returns nothing) so the host's built-in error recovery
- * runs unchanged.
- *
- * Loop constraint: the agent loop caps recovery retries at 2 per turn
- * (agent-loop.ts), so at most the first ~2 rungs of the ladder are used
- * before the loop fails. Order the ladder cheapest→most-capable.
- *
- * Safety posture: opt-in — loads inert until
- * `config.extensions['auto-escalate'].enabled = true`. It never forces a
- * `fail`; it only requests retries with a better model, and otherwise
- * defers to the default handler.
- *
- * Config (`config.extensions['auto-escalate']`):
- *
- * ```jsonc
- * {
- *   "enabled": false,
- *   "escalation": ["provider/model-standard", "provider/model-premium"],
- *   "retryablePatterns": ["overload", "rate.?limit", "429", "50[023]", "timeout", "ETIMEDOUT", "ECONNRESET"]
- * }
- * ```
- *
- * Tools:
- *  - `auto_escalate_status` — ladder, patterns, and escalation counters
- *
- * @public
- */
-
-declare function errorText(err: unknown): string;
-declare function isRetryable(text: string, patterns: RegExp[]): boolean;
-declare const plugin: Plugin;
-
-export { plugin as default, errorText, isRetryable };
+export * from './auto-escalate/index.js';
+export { default } from './auto-escalate/index.js';

package/dist/auto-escalate.js

@@ -186,5 +186,8 @@ var plugin = {
   }
 };
 var auto_escalate_default = plugin;
-
-export { auto_escalate_default as default, errorText, isRetryable };
+export {
+  auto_escalate_default as default,
+  errorText,
+  isRetryable
+};

package/dist/auto-i18n-extractor/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * auto-i18n-extractor plugin — detects hardcoded user-facing strings in UI
+ * source files and suggests translation keys.
+ *
+ * Tools registered:
+ * - i18n_extract : Scan a file/directory path for extractable strings.
+ * - i18n_status  : Show config + per-session counters.
+ *
+ * Hooks registered:
+ * - PostToolUse with matcher `write|edit` for `.tsx`, `.jsx`, `.vue` files.
+ *   Scans the written file and injects a short additionalContext with
+ *   suggested i18n keys when user-facing string literals are found.
+ *
+ * Config (`config.extensions['auto-i18n-extractor']`):
+ *
+ * ```jsonc
+ * {
+ *   "enabled": true,
+ *   "fileExtensions": [".tsx", ".jsx", ".vue"],
+ *   "minLength": 2,
+ *   "maxContextStrings": 10,
+ *   "excludeAttributes": [
+ *     "className", "class", "testId", "data-testid",
+ *     "aria-label", "aria-labelledby", "key", "id", "name", "htmlFor"
+ *   ]
+ * }
+ * ```
+ *
+ * @public
+ */
+import type { Plugin } from '@wrongstack/core';
+declare const plugin: Plugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/auto-i18n-extractor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auto-i18n-extractor/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAgL/C,QAAA,MAAM,MAAM,EAAE,MAsQb,CAAC;eAEa,MAAM"}