control

Control Skill

User-invocable skill for managing bkit automation level and system status.

Arguments

Argument	Description	Example
(none)	Show current status (same as status)	/control
status	Show automation level, trust score, guardrails	/control status
level <0-4>	Set automation level manually	/control level 2
pause	Pause all automation (equivalent to L0)	/control pause
resume	Resume to previous automation level	/control resume
trust	Show trust score details and history	/control trust

Automation Levels

Level	Name	Description	Approval Gates
L0	Manual	All actions require explicit user approval	Every phase transition
L1	Guided	Suggestions provided, user confirms each step	Every phase transition
L2	Semi-Auto	Routine transitions auto, key decisions gated	do->check, check->report, report->archive
L3	Auto	Most transitions auto, only destructive ops gated	report->archive
L4	Full-Auto	Fully automated PDCA cycle, minimal intervention	Initial feature approval only

Action Details

status (Default)

Display the current automation control state.

1. Read runtime control state from .bkit/runtime/control-state.json
2. Read trust score from .bkit/state/trust-score.json
3. Read active guardrails from lib/control/ configuration
4. Display formatted status panel

Output Format:

--- bkit Control Panel ----------------------------
Automation Level : L2 (Semi-Auto)
Trust Score      : 72/100
Active Guardrails: 8/8
Paused           : No
Features Active  : 2/3
---------------------------------------------------
Guardrails:
  [ON] Destructive operation detection
  [ON] Blast radius limiter (max 10 files)
  [ON] Loop breaker (max 5 iterations)
  [ON] Checkpoint auto-creation
  [ON] Permission escalation gate
  [ON] Stale feature timeout (7d)
  [ON] Context overflow protection
  [ON] Concurrent write lock
---------------------------------------------------

level <0-4>

Set the automation level manually.

1. Validate input is a number 0-4
2. Read current level from .bkit/runtime/control-state.json
3. If escalating (going higher), warn user about reduced oversight
4. If de-escalating, apply immediately without confirmation
5. Update .bkit/runtime/control-state.json with new level
6. Write audit log entry via lib/audit/audit-logger.js
7. Display confirmation with new level details

Escalation Rule: Level increases require explicit confirmation via AskUserQuestion. Level decreases are immediate (safe direction).

Level Mapping to Automation:

Level	automationLevel	Description
L0	manual	All manual
L1	guide	Guided suggestions
L2	semi-auto	Semi-automatic (default)
L3	auto	Mostly automatic
L4	full-auto	Fully automatic

pause

Pause all automation immediately.

1. Save current level to .bkit/runtime/control-state.json as previousLevel
2. Set level to L0 (Manual)
3. Set paused: true flag
4. Write audit log: automation_paused
5. Display confirmation: "Automation paused. All operations require manual approval."

resume

Resume automation to the previous level before pause.

1. Read previousLevel from .bkit/runtime/control-state.json
2. If not paused, display: "Automation is not paused."
3. Restore level to previousLevel
4. Clear paused flag
5. Write audit log: automation_resumed
6. Display confirmation with restored level

trust

Show trust score details and contributing factors.

1. Read trust score from .bkit/state/trust-score.json
2. Calculate score breakdown:
   • PDCA completion rate (0-25 points)
   • Match rate average (0-25 points)
   • Error recovery rate (0-20 points)
   • Session stability (0-15 points)
   • User override frequency (0-15 points, inverse)
3. Display detailed breakdown

Output Format:

--- Trust Score Details ---------------------------
Overall Score: 72/100

Breakdown:
  PDCA Completion Rate  : 18/25  (72% cycles completed)
  Match Rate Average    : 22/25  (88% average)
  Error Recovery Rate   : 14/20  (70% recovered)
  Session Stability     : 12/15  (80% stable)
  User Override Freq    :  6/15  (40% override rate)
---------------------------------------------------
Level Recommendation: L2 (Semi-Auto)
  Score 0-30  -> L0 (Manual)
  Score 31-50 -> L1 (Guided)
  Score 51-70 -> L2 (Semi-Auto)
  Score 71-85 -> L3 (Auto)
  Score 86+   -> L4 (Full-Auto)
---------------------------------------------------

State Files

File	Purpose
.bkit/runtime/control-state.json	Runtime control state (level, paused, previousLevel)
.bkit/state/trust-score.json	Trust score and contributing metrics

Module Dependencies

Module	Function	Usage
lib/control/automation-controller.js	getLevel(), setLevel()	Read/write automation level
lib/control/automation-controller.js	pause(), resume()	Pause/resume automation
lib/audit/audit-logger.js	writeAuditLog()	Record control changes

Usage Examples

# Check current status
/control

# Set to Semi-Auto
/control level 2

# Pause all automation
/control pause

# Resume previous level
/control resume

# View trust score
/control trust