Skip to content

Releases

v1.2.0 — P4 Selective Enforcement & Token Optimization

Choose a tag to compare

@agmonetti agmonetti released this 09 Nov 22:26

in v1.2.0

Selective Enforcement (Hybrid Gate)

  • Zero Overhead on Clear Tasks: Eliminates the mandatory disambiguator_assess roundtrip for clear, deterministic requests. In soft mode, 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 strict mode or upon policy assumptions, prompts for explicit confirmation via ctx.ui.confirm before modifying files.
    • Shell commands and unbounded operations remain protected under explicit verification.
  • 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 when AGENTS.md or 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

Choose a tag to compare

@agmonetti agmonetti released this 08 Sep 21:41

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 /disambiguator with no arguments to act as status.
  • 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 on off, 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.json and .agents/hooks.json from 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

Choose a tag to compare

@agmonetti agmonetti released this 03 Sep 19:19

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), and off without 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).