HELM / DOCUMENTATION

helm — Docs Atlas

36 FILES UNDER docs/ · AS-BUILT RE-BASELINE 2026-07-07 · GIT @dc54047
3/3
PLANS COMPLETE
A · B · dashboard-refresh
6/6
SPECS IN SYNC
verified against code 07-07
2/6
ROADMAP PHASES DONE
P2·P3 partial, P4 next

PHASE PROGRESS — roadmap vs as-built

P0Founding
DONE 07-03
P1Spine & governance
DONE 07-03
P2State plane & loop
PARTIAL
P3Keystone visibility
PARTIAL
P4Earned autonomy
NOT STARTED
P5Compounding
NOT STARTED
P2 は設計(SQLite state DB + PWA)と違う形で実現 — file-IO + JSON + serve.mjs API + ネイティブ SwiftUI アプリ。未着手: horizon→DB / family access / review cadences / household finance。P4 の入口は 週次 supervised lint batch(rung 1 エビデンス)。

SYSTEM MAP — what actually runs

KERNEL Transactiongit commits + trailers Event SpineLIVE 07-07 · sqlite Autonomy Ladderall classes L0 Horizoninterim MD registry Hygienelint 17 rules
STORES memory/ (git)canonical knowledge JSON stateauto · annotations · editorial ~/.helm/spine.sqliteevents, outside repo
JOBS·MINI collect→render15 min serve.mjs APIdaemon :8437 email-draft-batch30 min · drafts only capture→triageevent-driven drain-remindersPAUSED 07-07
EDGE helm-app (iOS)capture · tasks · triage · APNs helm-sendper-draft L0 send

TIMELINE — five days from founding

07-02Founding. 設計4文書(requirements / architecture / roadmap / autonomy ladder)+ 環境監査 F1–F32
07-03Phase 0+1 完走(夜間自律)。vault 移行・憲法・secrets ゲート閉鎖・lint 17ルール・spine schema。capture pipeline 実装
07-04dashboard 稼働(collect→render→serve)。helm-send・GCP OAuth。helm-ds v3 制定
07-05dashboard-refresh / tasks-native 設計承認。state-plane spec 登記
07-06email-draft-batch 稼働開始。dashboard-refresh 実装完了(editorial on-demand refresh)
07-07Docs re-baseline. spec/design/plans を実装に同期。Spine 稼働開始・annotations v2 + ^t-ID・Reminders 経路一時停止

DOCUMENT INDEX — 36 files, filter & expand

COREConstitution v1docs/constitution.md

全セッションに注入される不変則 ≤100行。2つの正典(~/helm + 状態DB)、ゾーン契約、Transaction 契約、wiki スキーマ §4、Vault-First、実行環境規律、非 Claude AI は読み取り専用。矛盾時は本文書が最優先。

FOUNDINGArchitecture — two planes, one kerneldocs/design/2026-07-02-helm-architecture.md

5 primitives: Transaction · Event Spine · Autonomy Ladder · Hygiene Model · Horizon。個人プレーン(git+MD)と事業プレーン(PII はこちらのみ)を1つのガバナンス核が貫く。

§7 As-built deltas (07-07): state plane は SQLite でなく JSON+git で実現 / Spine は serve.mjs 経由で稼働 / PWA はネイティブアプリに前倒し / capture は app API が主経路。

FOUNDINGRequirements — FR/NFR catalogdocs/design/2026-07-02-helm-requirements.md

FR-H (Horizon) / FR-M (hygiene) / FR-A (autonomy) / FR-O (observability) / FR-B (business) / FR-L (daily loop) / FR-C (context economy) / FR-F (family) + NFR 1–7。ロードマップ位相への traceability 付き。

FOUNDINGRoadmap — dependency-ordered critical pathdocs/design/2026-07-02-helm-roadmap.md

Phase 0 Founding → 1 Spine → 2 State plane → 3 Visibility → 4 Autonomy → 5 Compounding + 並行の business static reduction。

As-built 節 (07-07): P0/P1 ✅、P2/P3 partial、予定外の出荷物(email-draft-batch, triage, tasks API 等)を登記。バックログ: Reminders 全リスト同期。

FOUNDINGAutonomy Ladder — how autonomy is earneddocs/design/2026-07-02-helm-autonomy-ladder.md

L0 suggest → L1 auto-reversible → L2 auto+post-review → L3 scheduled。永久 L0: 外部送信・金銭・削除・verified 上書き・risk:high・ガバナンス自己変更。昇格は digest のエビデンスから提案、実績はクラス間で移転しない。現在 grandfathered 以外は全クラス L0。

DOCTRINEAdoption Doctrine — importing external agent featuresdocs/design/2026-07-03-adoption-doctrine.md

外部フレームワーク機能を取り込む前の5問チェック(来歴 / ゲート位置 / 蒸留経路 / 所有 vs ビュー / 単一ライター)。初適用: Hermes(bounded memory → hot.md, session_search → raw/ 層 など)。

IMPLEMENTEDDashboard Refresh — deterministic Google data + on-demand editorialdocs/design/2026-07-05-dashboard-refresh.md

編集部データ (editorial.json) が期限切れでも briefing が生き残る fallback + アプリの pull-to-refresh で mini の headless claude が editorial を再生成(lock + cooldown)。07-06 実装完了・稼働中。

PARTIALTasks v1 — Reminders-parity native viewdocs/design/2026-07-05-tasks-native.md

ネイティブ TasksView + md 正典のまま lazy block-ref ID で同一性を持たせる設計。

✅ TasksView / task API / annotations v2 + ^t-ID (07-07)。❌ edit·delete·reorder / task-alarms / per-domain tasks.md / アプリ側 v2 呼び出し。

DONE 07-03Plan A — Foundation (Phase 0 + hook detox)docs/plans/2026-07-02-plan-a-foundation.md

repo 骨格 / GitHub private mirror / 憲法 v1 + SessionStart 注入 / secrets & backup runbook / vault 移行(~780 files, copy-only)/ session-commit hook。夜間自律実行で完走。

DONE 07-03Plan B — Headless lint + Spine + governance docsdocs/plans/2026-07-03-plan-b-spine-and-lint.md

lint エンジンの vendor 化 + 憲法 §4 スキーマの a/b/c 系 17 ルール + tier 出力。baseline 4,636 件計測(適用なし)。Spine schema + logger(当時は配線ゲート、07-07 稼働開始)。spec 3本執筆。

DONE 07-06Dashboard Refresh implementation plandocs/plans/2026-07-05-dashboard-refresh.md

T1 buildBriefing fallback → T2 git-lib 抽出 → T3 editorial prompt+validator → T4 editorial-refresh.mjs → T5 POST /api/editorial/refresh → T6 docs 同期。TDD、全出荷。

SYNCED 07-07Transaction — canonical write contractdocs/spec/transaction.md

propose → gate → reversible apply → provenance → post-signal。trailer 3種(Helm-Actor / Helm-Txn / Helm-Source)と prefix 表。

07-07 更新: `system:<txn>-api` actor クラス、実使用 Helm-Txn 語彙 12種、plan 完了時の DoD(Status 行 + checkbox bump 必須)を追加。

ACCURATELint — tiers & rule catalogdocs/spec/lint.md

trivial / standard / review の3層と 17 ルール(a 系スキーマ, b 系リンク, c 系構造)。実装と完全一致を 07-07 検証。--fix は trivial のみ、review > 0 で exit 1。

SYNCED 07-07State Plane — Phase 2 state DB skeletondocs/spec/state-plane.md

「個人スケールは md+git+単一ライターで十分」の判断と、DB 化の着手トリガー3条件・移行順・md↔DB 同期規約。

07-07 更新: events は最初から SQLite(jsonl 記述を訂正)、Spine 配線稼働を反映。

ACCURATEWiki Conventions — frontmatter & lifecycledocs/spec/wiki-conventions.md

憲法 §4 の詳細版。必須7キー(type / tags / categories / status / updated / summary / sources)は linter の強制と一致。

ACCURATEDesign System — helm-ds v3docs/spec/design-system.md

pure-black + neutral grayscale、violet / neon-orange / mint のみ。UI chrome 英語。canonical style block をコピーして配布(本ページの様式の出典)。全 12 surface が v3 マーカー準拠。

ACCURATEReorganization — folder moves & sub-wikisdocs/spec/reorganization.md

sub-wiki 化の基準(wiki 4 files ≥ で c1 発火)と標準3オプション。固定の folder manifest ではなく判断基準を定義。

LIVEDashboard pipelinedocs/runbooks/dashboard-pipeline.md

collect (15分) → render → serve (:8437, tailscale)。fail-loud renderer・atomic write・lock 規律。

LIVECapture pipelinedocs/runbooks/capture-pipeline.md

主経路 = helm-app「+」→ POST /api/capture → brain-dump append + commit。オフラインは app 内キュー。下流はイベント駆動 triage-propose → 承認 → 決定論 apply。Reminders 副経路は 07-07 一時停止(plist Disabled、再開手順記載)。

LIVEEmail draft batchdocs/runbooks/email-draft-batch.md

30分毎(07–20時)未返信スレッド → 文体正典下書き → Gmail drafts + APNs 通知。送信は行わない — helm-send の毎通 L0 承認のみ。

DONEGmail send setupdocs/runbooks/gmail-send-setup.md

GCP helm-501412 / OAuth desktop / トークン用途分離(compose と readonly)。①〜⑤ 完了・同意2回済み・collect-google 実データ配信中。

GATE CLOSEDSecretsdocs/runbooks/secrets.md

NFR-1。Keychain / 1Password 方針 + 棚卸し表。完了ゲート全項目クローズ (07-03) — 自律ジョブの残ゲートは autonomy ladder rung 1 エビデンスのみ。

REFOperating manualdocs/runbooks/operating-manual.md

mini のジョブ一覧と日常運用の手引き。

REFhelm cheatsheetdocs/runbooks/helm-cheatsheet.md

オペレーター向けコマンド早見表。

REFProject playbookdocs/runbooks/project-playbook.md

project-init(誕生登記)→ 作業 → project-close(蒸留ゲート)の運用手順。

REFBackupdocs/runbooks/backup.md

GitHub mirror + Time Machine + restic の3系統と復元手順。

HISTTo Mac mini (07-03)docs/handoff/2026-07-03-to-mac-mini.md

mini 提供時の引き継ぎ。歴史的記録。

HISThelm-app review (07-04)docs/handoff/2026-07-04-helm-app-review-for-claude-code.md

iOS アプリのレビュー引き継ぎ。歴史的記録。

HISTSystem review (07-04)docs/handoff/2026-07-04-to-claude-fable-5-system-review.md

全体システムレビュー依頼の引き継ぎ。歴史的記録。

CLOSEDemail-draft-batch missing (07-06)docs/handoff/2026-07-06-email-draft-batch-missing.md

根本原因 + 復旧 runbook。同日クローズ(launchd 稼働開始)。

HISTMorning handoff 07-03docs/handoff/morning-handoff-2026-07-03.md

夜間自律実行の朝ゲート引き継ぎ(移行コミット / Stop hook 配線)。07-07 に runbooks/ から移動。

HISTMorning handoff 07-04docs/handoff/morning-handoff-2026-07-04.md

夜間自律セッションの成果と保留事項。07-07 に runbooks/ から移動。

AUDITEnvironment audit (07-02)docs/audits/2026-07-02-environment-audit.md

環境監査と改善バックログ F1–F32。

METAREADME — founding documents indexREADME.md

helm の目的宣言と創設文書の読み順。07-07 に layout を as-built へ更新。

ACTIVEPROJECT.md — birth registration & logPROJECT.md

helm プロジェクトの登記・決定・日次ログ(as-built の一次記録)。Goal: Phase 0–4 完走。

SPINESpine README — enablement recordsystem/spine/README.md

schema.sql + log-event.sh の契約(fail-open / 再帰ガード / repo 外 DB)。07-07: serve.mjs + editorial-refresh から配線稼働。

OPEN THREADS — what the docs say is next

P4 entry週次 supervised lint batch(trivial 4,537件中)— rung 1 昇格エビデンスの収集開始
miniserve.mjs 更新の反映: pull 後に launchctl kickstart -k …dashboard-serve
apphelm-app を annotations v2 の id-flow へ(flag / priority UI)+ task-alarms 実装
designReminders 全リスト同期(07-07 登記・要設計: 対象リスト / 方向 / マッピング)
P2 resthorizon→DB 反転 / family access / review cadences / household finance
P3Health Digest 5パネル / derived freshness & staleness