dreamer-oracle-gate 0.1.0

Simple controller gate for AI assistants: TALK/PLAN/BUILD with approval-token enforcement.

dreamer-oracle-gate

Minimal control-plane gate for AI assistants.

Purpose: keep assistants in TALK / PLAN / BUILD modes so questions get answered without surprise coding, and edits only happen with explicit approval.

Why

This package is built for operator-first workflows (like Champion Council), where one assistant plans/audits and another executes. It prevents the common failure mode:

• user asks a question
• assistant starts coding anyway

Core model

Three modes:

• TALK: answer only, no execution
• PLAN: propose steps, ask for operator opinion
• BUILD: execute work

By default, BUILD requires approval token:

APPROVE BUILD: ...

Optional code_only_mode can relax this if policy allows.

Install

pip install dreamer-oracle-gate

Quick start (Python)

from dreamer_oracle_gate import OracleGate

gate = OracleGate()

decision = gate.evaluate("can you explain why this failed?")
print(decision.mode)               # TALK
print(decision.should_execute)     # False

decision = gate.evaluate("fix clipboard relay windows decode")
print(decision.mode)               # PLAN

decision = gate.evaluate(
    "fix clipboard relay windows decode",
    approval_token="APPROVE BUILD: clipboard relay decode"
)
print(decision.mode)               # BUILD
print(decision.should_execute)     # True

CLI

dreamer-oracle policy show
dreamer-oracle decide --message "can you explain this?"
dreamer-oracle decide --message "implement patch" --approval "APPROVE BUILD: patch"

Continuity receipts

Each decision is logged as JSONL to:

• %USERPROFILE%\.dreamer-oracle\continuity.jsonl (Windows)
• ~/.dreamer-oracle/continuity.jsonl (Unix)

You can override with DREAMER_ORACLE_HOME or --continuity-path. If the home path is blocked, the CLI falls back to ./.dreamer-oracle/continuity.jsonl.

License

Apache-2.0

Gift note:

Gift to the community (and to Google DeepMind): thanks for Dreamer.