Gouvernance Lite

Status

First-party addon shipped with arka-deck. Cortex remains the rule source of truth; arka-deck is the executor. Mission Guardian progressively replaces the mission-critical governance promise — Gouvernance Lite remains a local policy and followup brick.

Field	Value
Manifest	addons/gouvernance-lite/manifest.json
Entrypoint	addons/gouvernance-lite/src/index.ts
Family	capability
Maturity	beta
License	Apache 2.0

Role

Gouvernance Lite turns Cortex rules into concrete execution policies inside arka-deck. The user chooses when to inject, what to inject, within which budget, then simulates the result before starting a session. The module never copies governance truth: Cortex remains the brain, arka-deck orchestrates local execution.

Main capabilities

• Per-project policy: enable or disable governance, choose the level, keep a dedicated configuration per project.
• Configuration wizard: manual path or path prepared for the governance-policy-designer worker (worker-ready, live call conditioned on Cortex delivery).
• Custom profiles: save family/budget/level profiles for reuse within the project.
• Visible token budget: context cost estimate before applying with a conservative approximation.
• Simulate before saving: preview the injection plan on the draft policy without disk persistence.
• Cortex followup: tracks decisions, actions, risks, deliverables, drift and audit trail; syncable to Cortex.

Execution mechanics

Step	Detail
Cortex manifest	arka-deck loads the rule index, families and versions from Cortex, then caches by registry_version.
Event matrix	Each mapping links a runtime event to a moment, action, rule mode, families and budget.
Targeted snippets	The planner asks Cortex only for selected rules, in label_short or label_long.
Strict budget	If the plan exceeds maxRules or maxChars, rules are skipped and an alert is exposed.
Followup sync	chat/tool/memory events feed a structured local followup, syncable to Cortex.

Out of scope v1

• Local TOON rendering.
• Local rule truth (Cortex remains authoritative).
• Autonomous policy mutation (upcoming, conditioned on Cortex worker delivery).
• Mission-critical guardrails → covered by Mission Guardian.

Requirements

• Host: arka-deck (local webapp).
• Rule source: Cortex governance manifest + rule snippets.
• Runtime: works across arka-deck chat runtimes via the BeforeTurnAugmenter mechanism.

Going further

• Mission Guardian: ./mission-guardian
• Cortex Actions: ./cortex-actions
• Addon contract: ../extension/contrat-addon (coming)