/cheat-status, 状态看板

读 state file + 扫描用户项目 → 汇总当前进度 → 输出"今天该做什么"清单。

Overview

[用户：状态]
  ↓
[Phase 1: 读 .cheat-state.json + 扫文件系统]
  ↓
[Phase 2: 计算派生指标]
  ↓
[Phase 3: 检测建议触发器（升级 / bump / 清算）]
  ↓
[Phase 4: 输出看板]

Constants

• SQLITE_UPGRADE_THRESHOLD = 30, calibration_samples 达到 N 时建议升 SQLite
• CLEANUP_LINE_THRESHOLD = 600, rubric_notes.md 行数超 N 时建议清算
• STALE_PREDICTION_DAYS = 30, in_progress prediction 超 N 天未发布提示清理

Inputs

来源	用途
.cheat-state.json	主要状态
predictions/*.md	校准样本数 / pending retros
candidates.md	候选池规模
rubric_notes.md	行数 / 当前版本
.cheat-cache/usage.jsonl（如有）	meta-logging 数据，用于"距上次 bump 多少次预测"

Workflow

Phase 1: 读状态

state = read_json('.cheat-state.json')
if not state:
    return "你还没初始化。请先跑 /cheat-init。"

predictions = glob('predictions/*.md')
candidates_count = parse_candidates_md_entries()
rubric_lines = wc -l rubric_notes.md

Phase 2: 派生指标

指标	算法
Buffer 数	len(state.shoots)
Buffer 颜色	按 cadence-protocol.md 派生：buffer_days = buffer_count × target_publish_cadence_days，<1 红 / 1-2 橙 / 3-5 绿 / >5 蓝。如 target_publish_cadence_days=null → 颜色禁用
Confidence 等级	按 state-management.md confidence 表 派生：从 calibration_samples 整数派生 emoji + 标签
最早一拍至今天数	now - state.shoots[0].shot_at，用于警告"拍了 N 天没发"
校准样本数	predictions 中含完整复盘段（实绩数据非空）的文件数
待复盘	state.pending_retros 中已过 RETRO_WINDOW_DAYS 的
池大小	candidates.md 中 tier!=skip 的 entry 数
上次 bump 至今几次预测	predictions 中 published_at > state.last_bump_at 的数量
同向偏差队列	state.consecutive_directional_errors
in_progress 陈旧度	now - state.in_progress_session.started_at（如有）

Phase 3: 检测建议触发器

按优先级（高→低）逐项检查：