@wrongstack/plugins 0.284.1 → 0.286.0

package/dist/index.d.ts

@@ -1,64 +1,186 @@
-export { default as agentHandoffPlugin } from './agent-handoff.js';
-export { default as autoDocPlugin } from './auto-doc.js';
-export { default as autoEscalatePlugin } from './auto-escalate.js';
-export { default as branchGuardPlugin } from './branch-guard.js';
-export { default as changelogWriterPlugin } from './changelog-writer.js';
-export { default as checkpointPlugin } from './checkpoint.js';
-export { default as commitValidatorPlugin } from './commit-validator.js';
-export { default as configValidatorPlugin } from './config-validator.js';
-export { default as contextPinsPlugin } from './context-pins.js';
-export { default as costTrackerPlugin } from './cost-tracker.js';
-export { default as cronPlugin } from './cron.js';
-export { default as depGuardPlugin } from './dep-guard.js';
-export { default as diffSummaryPlugin } from './diff-summary.js';
-export { default as errorLensPlugin } from './error-lens.js';
-export { default as fileWatcherPlugin } from './file-watcher.js';
-export { default as formatOnSavePlugin } from './format-on-save.js';
-export { default as gitAutocommitPlugin } from './git-autocommit.js';
-export { default as importOrganizerPlugin } from './import-organizer.js';
-export { default as injectionShieldPlugin } from './injection-shield.js';
-export { default as knowledgeGraphPlugin } from './knowledge-graph.js';
-export { default as lintGatePlugin } from './lint-gate.js';
-export { default as llmCachePlugin } from './llm-cache.js';
-export { default as loopBreakerPlugin } from './loop-breaker.js';
-export { default as modelRouterPlugin } from './model-router.js';
-export { default as notifyHubPlugin } from './notify-hub.js';
-export { default as pathGuardPlugin } from './path-guard.js';
-export { default as pluginStackObserverPlugin } from './plugin-stack-observer.js';
-export { default as prDrafterPlugin } from './pr-drafter.js';
-export { default as promptFirewallPlugin } from './prompt-firewall.js';
-export { default as secretScannerPlugin } from './secret-scanner.js';
-export { default as semverBumpPlugin } from './semver-bump.js';
-export { default as sessionRecapPlugin } from './session-recap.js';
-export { default as shellCheckPlugin } from './shell-check.js';
-export { default as specLinkerPlugin } from './spec-linker.js';
-export { default as templateEnginePlugin } from './template-engine.js';
-export { default as testCoverageGatePlugin } from './test-coverage-gate.js';
-export { default as testRunnerGatePlugin } from './test-runner-gate.js';
-export { default as typeGatePlugin } from './type-gate.js';
-export { default as accessibilityAuditorPlugin } from './accessibility-auditor.js';
-export { default as apiCompatibilityGatePlugin } from './api-compatibility-gate.js';
-export { default as autoI18nExtractorPlugin } from './auto-i18n-extractor.js';
-export { default as codeMetricsPlugin } from './code-metrics.js';
-export { default as deadCodeDetectorPlugin } from './dead-code-detector.js';
-export { default as dependencyVulnerabilityGatePlugin } from './dependency-vulnerability-gate.js';
-export { default as docSyncGuardPlugin } from './doc-sync-guard.js';
-export { default as duplicateCodeDetectorPlugin } from './duplicate-code-detector.js';
-export { default as featureFlagTrackerPlugin } from './feature-flag-tracker.js';
-export { default as interfaceContractGuardPlugin } from './interface-contract-guard.js';
-export { default as licenseAuditGatePlugin } from './license-audit-gate.js';
-export { default as migrationPlannerPlugin } from './migration-planner.js';
-export { default as performanceRegressionGatePlugin } from './performance-regression-gate.js';
-export { default as refactorSuggesterPlugin } from './refactor-suggester.js';
-export { default as releaseNotesGeneratorPlugin } from './release-notes-generator.js';
-export { default as schemaEvolutionGuardPlugin } from './schema-evolution-guard.js';
-export { default as securityHotspotScannerPlugin } from './security-hotspot-scanner.js';
-export { default as semanticSearchIndexerPlugin } from './semantic-search-indexer.js';
-export { default as smartRenamePlugin } from './smart-rename.js';
-export { default as testFlakeDetectorPlugin } from './test-flake-detector.js';
-export { default as testGeneratorPlugin } from './test-generator.js';
-export { default as todoListenerPlugin } from './todo-listener.js';
-export { default as todoTrackerPlugin } from './todo-tracker.js';
-export { default as tokenBudgetPlugin } from './token-budget.js';
-export { default as tokenThrottlePlugin } from './token-throttle.js';
-import '@wrongstack/core';
+/**
+ * @wrongstack/plugins — Official WrongStack Plugin Suite
+ *
+ * Exported plugins (63 total; most use tools or lifecycle hooks, while
+ * provider-wire plugins register a full AgentExtension
+ * — wrapProviderRunner / onError — wrapping the provider call itself):
+ *  1. auto-doc         — Auto-generates JSDoc/TSDoc (dryRun for preview)
+ *  2. git-autocommit  — AI-powered commit messages (git_autocommit/status_summary removed)
+ *  3. shell-check     — Runs shellcheck on files or directories (merged)
+ *  4. cost-tracker    — Tracks LLM token usage and estimated cost per session
+ *  5. file-watcher    — Watches project files and emits events on changes
+ *  6. cron            — Schedules recurring tasks via extension hooks
+ *  7. template-engine — Expands file templates with variable substitution
+ *  8. semver-bump     — Conventional-commit-driven semver version bumps
+ *  9. secret-scanner  — Pre+post-tool hooks that block, redact, or warn
+ *                        about plaintext credentials flowing into/out of tools
+ * 10. todo-tracker    — Persistent, project-scoped todo backlog that
+ *                        survives across sessions
+ * 11. token-budget    — Enforces a per-session token budget — warns at a
+ *                        threshold and stops the agent loop when the limit is hit
+ * 12. lint-gate       — Pre-tool hook that runs biome/eslint on would-be
+ *                        file content before write or edit commits it
+ * 13. branch-guard    — Pre-tool hook that blocks commits, pushes, and
+ *                        merges to protected branches (default: main, master)
+ * 14. diff-summary    — Post-tool hook that injects a compact git diff
+ *                        into the LLM context after every write or edit
+ * 15. commit-validator — Pre-tool hook that validates conventional-commit
+ *                        format before git_autocommit or bash git commit runs
+ * 16. format-on-save   — Post-tool hook that runs biome format --write
+ *                        on the file after every write or edit
+ * 17. test-runner-gate — Post-tool hook that runs the relevant test
+ *                        file after every write or edit to a source file
+ * 18. import-organizer — Post-tool hook that runs biome check --write --unsafe
+ *                        on the file after write or edit, re-sorting imports
+ *                        and applying safe fixes (falls back to eslint --fix)
+ * 19. todo-listener   — Post-tool hook on `todo` that broadcasts the new list
+ *                        to the project mailbox (api.mailbox.send) so other
+ *                        agents can see what this one is working on
+ * 20. session-recap   — Stop hook that posts a one-page session summary
+ *                        (tokens, tool calls, commits, transcript tail) to
+ *                        the project mailbox when the agent loop ends
+ * 21. spec-linker     — Post-tool hook on write/edit that scans markdown
+ *                        files for unlinked plugin references and surfaces
+ *                        them to the LLM via additionalContext
+ * 22. loop-breaker    — Pre-tool hook that detects runaway tool-call loops
+ *                        (identical repeats + A-B-A-B oscillation), warns
+ *                        the model, then blocks
+ * 23. path-guard      — Pre-tool hook that blocks writes/edits/destructive
+ *                        shell commands touching protected paths (lockfiles,
+ *                        .env, .git, migrations)
+ * 24. context-pins    — pin_add/pin_remove/pin_list tools + system prompt
+ *                        contributor: pinned facts survive compaction and
+ *                        persist across sessions
+ * 25. checkpoint      — In-session file snapshots: auto-captures content
+ *                        before write/edit; checkpoint_restore rolls any
+ *                        file back to a pre-edit state
+ * 26. error-lens      — Post-tool hook that distills failed command output
+ *                        into a compact digest (error line + project stack
+ *                        frames) and flags repeated failures
+ * 27. dep-guard       — Pre-tool hook that supervises dependency installs:
+ *                        deny list, typosquat lookalike warnings, unpinned
+ *                        version warnings
+ * 28. config-validator — Post-tool hook that validates JSON/JSONC/YAML/TOML
+ *                        files right after write/edit and reports syntax
+ *                        problems in the same turn
+ * 29. notify-hub      — POSTs session events (stop, tool errors, budget
+ *                        thresholds) and ad-hoc notify_send messages to a
+ *                        configurable webhook
+ * 30. changelog-writer — Collects session work (commits, edits, manual
+ *                        notes) and writes Keep-a-Changelog entries under
+ *                        [Unreleased] on demand
+ * 31. injection-shield — Post-tool hook that scans tool output for
+ *                        prompt-injection patterns and warns the model that
+ *                        content is data, not instructions
+ * 32. llm-cache       — wrapProviderRunner: caches identical deterministic
+ *                        provider requests and short-circuits the call on a hit
+ * 33. model-router    — wrapProviderRunner: routes each call to a different
+ *                        model by declarative size/tool rules (within the provider)
+ * 34. prompt-firewall — wrapProviderRunner: detects/redacts/blocks credential
+ *                        leaks on the provider wire (warn/redact/block)
+ * 35. auto-escalate   — onError: retries with the next model in an escalation
+ *                        ladder on transient provider errors
+ * 36. token-throttle  — wrapProviderRunner: rolling-window tokens/min budget
+ *                        that delays provider calls to stay under a rate limit
+ *
+ * New plugins (2026-07 follow-up batch):
+ * 37. duplicate-code-detector — Detects duplicate/similar code blocks across
+ *                               source files using normalized-line fingerprints
+ * 38. code-metrics           — Computes lines-of-code, comment ratio, function
+ *                               count, and approximate cyclomatic complexity
+ * 39. refactor-suggester     — Flags long functions, deep nesting, many
+ *                               parameters, magic numbers, and console.log usage
+ * 40. test-generator         — Generates a unit-test skeleton from exported
+ *                               functions/classes in a source file
+ * 41. release-notes-generator — Groups conventional commits into a release
+ *                               notes markdown draft
+ * 42. smart-rename           — Whole-word symbol rename with preview and
+ *                               optional apply
+ * 43. feature-flag-tracker   — Scans source files for feature-flag usage and
+ *                               reports flag inventory
+ * 44. interface-contract-guard — Warns when TypeScript interfaces change or
+ *                               lack implementers
+ *
+ * Plugins 32–36 are OPT-IN (enabled:false by default) because they change
+ * provider-call semantics.
+ *
+ * Removed (use the equivalent built-in tools instead — see
+ * `DEPRECATED_PLUGIN_NAMES` in `packages/cli/src/wiring/plugins.ts`
+ * for the loader-level migration warning):
+ *  - web-search      → built-in `search` + `fetch`
+ *  - json-path       → built-in `json` tool (action: query|validate|transform|merge)
+ *
+ * Usage in WrongStack config:
+ * ```json
+ * {
+ *   "plugins": {
+ *     "auto-doc": { "enabled": true },
+ *     "git-autocommit": { "conventionalCommits": true }
+ *   }
+ * }
+ * ```
+ */
+export { default as agentHandoffPlugin } from './agent-handoff/index.js';
+export { default as autoDocPlugin } from './auto-doc/index.js';
+export { default as autoEscalatePlugin } from './auto-escalate/index.js';
+export { default as branchGuardPlugin } from './branch-guard/index.js';
+export { default as changelogWriterPlugin } from './changelog-writer/index.js';
+export { default as checkpointPlugin } from './checkpoint/index.js';
+export { default as commitValidatorPlugin } from './commit-validator/index.js';
+export { default as configValidatorPlugin } from './config-validator/index.js';
+export { default as contextPinsPlugin } from './context-pins/index.js';
+export { default as costTrackerPlugin } from './cost-tracker/index.js';
+export { default as cronPlugin } from './cron/index.js';
+export { default as depGuardPlugin } from './dep-guard/index.js';
+export { default as diffSummaryPlugin } from './diff-summary/index.js';
+export { default as errorLensPlugin } from './error-lens/index.js';
+export { default as fileWatcherPlugin } from './file-watcher/index.js';
+export { default as formatOnSavePlugin } from './format-on-save/index.js';
+export { default as gitAutocommitPlugin } from './git-autocommit/index.js';
+export { default as importOrganizerPlugin } from './import-organizer/index.js';
+export { default as injectionShieldPlugin } from './injection-shield/index.js';
+export { default as knowledgeGraphPlugin } from './knowledge-graph/index.js';
+export { default as lintGatePlugin } from './lint-gate/index.js';
+export { default as llmCachePlugin } from './llm-cache/index.js';
+export { default as loopBreakerPlugin } from './loop-breaker/index.js';
+export { default as modelRouterPlugin } from './model-router/index.js';
+export { default as notifyHubPlugin } from './notify-hub/index.js';
+export { default as pathGuardPlugin } from './path-guard/index.js';
+export { default as pluginStackObserverPlugin } from './plugin-stack-observer/index.js';
+export { default as prDrafterPlugin } from './pr-drafter/index.js';
+export { default as promptFirewallPlugin } from './prompt-firewall/index.js';
+export { default as secretScannerPlugin } from './secret-scanner/index.js';
+export { default as semverBumpPlugin } from './semver-bump/index.js';
+export { default as sessionRecapPlugin } from './session-recap/index.js';
+export { default as shellCheckPlugin } from './shell-check/index.js';
+export { default as specLinkerPlugin } from './spec-linker/index.js';
+export { default as templateEnginePlugin } from './template-engine/index.js';
+export { default as testCoverageGatePlugin } from './test-coverage-gate/index.js';
+export { default as testRunnerGatePlugin } from './test-runner-gate/index.js';
+export { default as typeGatePlugin } from './type-gate/index.js';
+export { default as accessibilityAuditorPlugin } from './accessibility-auditor/index.js';
+export { default as apiCompatibilityGatePlugin } from './api-compatibility-gate/index.js';
+export { default as autoI18nExtractorPlugin } from './auto-i18n-extractor/index.js';
+export { default as codeMetricsPlugin } from './code-metrics/index.js';
+export { default as deadCodeDetectorPlugin } from './dead-code-detector/index.js';
+export { default as dependencyVulnerabilityGatePlugin } from './dependency-vulnerability-gate/index.js';
+export { default as docSyncGuardPlugin } from './doc-sync-guard/index.js';
+export { default as duplicateCodeDetectorPlugin } from './duplicate-code-detector/index.js';
+export { default as featureFlagTrackerPlugin } from './feature-flag-tracker/index.js';
+export { default as interfaceContractGuardPlugin } from './interface-contract-guard/index.js';
+export { default as licenseAuditGatePlugin } from './license-audit-gate/index.js';
+export { default as migrationPlannerPlugin } from './migration-planner/index.js';
+export { default as performanceRegressionGatePlugin } from './performance-regression-gate/index.js';
+export { default as refactorSuggesterPlugin } from './refactor-suggester/index.js';
+export { default as releaseNotesGeneratorPlugin } from './release-notes-generator/index.js';
+export { default as schemaEvolutionGuardPlugin } from './schema-evolution-guard/index.js';
+export { default as securityHotspotScannerPlugin } from './security-hotspot-scanner/index.js';
+export { default as semanticSearchIndexerPlugin } from './semantic-search-indexer/index.js';
+export { default as smartRenamePlugin } from './smart-rename/index.js';
+export { default as testFlakeDetectorPlugin } from './test-flake-detector/index.js';
+export { default as testGeneratorPlugin } from './test-generator/index.js';
+export { default as todoListenerPlugin } from './todo-listener/index.js';
+export { default as todoTrackerPlugin } from './todo-tracker/index.js';
+export { default as tokenBudgetPlugin } from './token-budget/index.js';
+export { default as tokenThrottlePlugin } from './token-throttle/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}