Repository navigation
Releases
Releases · agmonetti/disambiguator
v1.2.0 — P4 Selective Enforcement & Token Optimization
in v1.2.0
Selective Enforcement (Hybrid Gate)
- Zero Overhead on Clear Tasks: Eliminates the mandatory
disambiguator_assessroundtrip for clear, deterministic requests. Insoftmode, bounded single-file operations execute directly without extra API latency or token expenditure. - Selective Runtime Tool Gate:
- Read-only tools (
read,grep,find) pass freely without toll. - Mutating tools (
edit,write) are held if pending questions exist. - In
strictmode or upon policy assumptions, prompts for explicit confirmation viactx.ui.confirmbefore modifying files. - Shell commands and unbounded operations remain protected under explicit verification.
- Read-only tools (
- Interactive TUI Modals: Reuses Pi's native selection dialogs (
ctx.ui.select,ctx.ui.input), phase triage (architecture/scope before styling), and compaction/abort life-cycle handling.
Token Optimization & Cache Efficiency
- Streamlined Skills:
disambiguator-strict: Reduced from 19.7 KB to ~740 B (~180 tokens, -96.2%).disambiguator-soft: Reduced from 19.7 KB to ~1.08 KB (~260 tokens, -94.5%).
- Prompt Deduplication (
stripV1Prompt): Automatically strips duplicate V1 Markdown instructions whenAGENTS.mdor environment rules are already injected, saving ~5,000 tokens per call. - Result Compaction (
compactContent): Emits compact 38-byte JSON tool results for resolved assessments, saving 70–80% of context tokens.
v1.1.0 — Hardened Runtime Modes, Prompt Discovery, and Fail-Closed Benchmark
Summary of Changes
1. Canonical Contract & Prompt
- Read-Only Discovery: Explicitly permit inspecting workspace context to resolve ambiguity without executing modifying tools.
- Soft Mode Expansion: Include low-risk Type B scope adjustments alongside Type C defaults.
- Bare Command Semantics: Standardize
/disambiguatorwith no arguments to act asstatus. - Deterministic Action: Require direct tool execution for deterministic requests and defer mixed prompt execution until ambiguities resolve.
- Wording Tightening: Replace conflicting "industry-standard" assumption wording with Option
a(most conservative and reversible).
2. Runtime Integrations
- OpenCode Plugin: Rewrite preinjected headers (
# MODE: strict|soft|off) to track active mode, neutralize preinjected prompts onoff, and accurately log persistence errors. - Pi Extension: Display session-level notifications when global persistence fails while keeping session state active.
- Antigravity Hook: Inject ephemeral notice on global persistence failure and remove unused workspace helpers.
- CLI Mode Switcher: Restrict to at most one argument (exit code 1 on extras) and detect checkout via directory identity.
3. Synchronized Adapters & Parity
- Generate both
hooks.jsonand.agents/hooks.jsonfrom a single manifest constant. - Automatically derive version frontmatter across skill files from
package.json. - All 22 harness adapters synchronized and validated against
system-prompt.md.
4. Benchmark Integrity & Test Battery
- Enforce fail-closed validation on all 7 benchmark assertion keys.
- Add operational mode indicators (
Mode: strict|soft|off) per test case. - Separate semantic failures from transport errors (
status: ERROR). - Embed SHA-256 provenance hashes in benchmark runner output.
5. Documentation
- Document host integration state matrix, storage locations, and token costs.
- Enumerate all 5 skill variants.
v1.0.0
Disambiguator
Disambiguator is a zero-dependency, pure instruction cognitive gatekeeper for AI coding agents. It halts the model before any tool execution or destructive code modification, categorizes ambiguity, and surfaces realistic multiple-choice suggestions (a/b/c/d) so you can steer your agent with a single letter instead of writing essays.
Eliminate wasted tokens, hallucinated architectures, and silent drift from vague instructions like "make the UI look nice" or "refactor the backend".
Capabilities
- Runtime Mode Control: Toggle on the fly between
strict(default: halt on all ambiguities),soft(assume safest paths for conventions), andoffwithout editing repository files. - Universal Multi-Harness Parity: Synchronized across 20 adapters with guaranteed zero drift:
- Tier 1 (Native Hooks): Antigravity CLI (
agy) & IDE, Pi Agent Harness, OpenCode Plugin. - Tier 2 (Universal Rules): OpenChamber, Cursor, Windsurf, Cline / Roo-Code, VS Code, GitHub Copilot Chat, Kiro.
- Tier 3 (Assisted Memory & Skills): Claude Code (
CLAUDE.md+ plugin), Aider (--read AGENTS.md), and universal agent skills (npx skills add agmonetti/disambiguator).
- Tier 1 (Native Hooks): Antigravity CLI (