agent-bios 0.14.0 → 0.16.0

package/launch/i18n/ko.toml

@@ -2,11 +2,20 @@
 
 "mode.title" = "모드"
 "mode.swe.label" = "Software Engineer"
-"mode.swe.description" = "프로젝트 자체의 AGENTS.md/CLAUDE.md를 따르는 레포 범위 작업: 순정 Vanilla 세션 또는 Custom으로 직접 구성합니다."
+"mode.swe.description" = "기존 프로젝트에서 CLI의 기본 지침 로딩 방식으로 작업합니다. Vanilla는 런처의 추가 설정 없이 시작하고, Custom에서는 모델과 리뷰 방식을 직접 고릅니다."
 "mode.builder.label" = "Builder"
-"mode.builder.description" = "고정 프리셋들에서 tier·리뷰 라우트·권한을 조정합니다. Custom 포함."
+"mode.builder.description" = "설치된 코퍼스를 활용하는 일반 개발 모드입니다. Balanced·Deep review·Fast batch·Solo 또는 Custom에서 메인 모델, 위임, 리뷰, 실행 권한을 고릅니다."
 "mode.distill.label" = "Session distill"
-"mode.distill.description" = "전용 session-distill 허브로 이동: 상태, 패키지, 버전, 세션 시작."
+"mode.distill.description" = "지난 AI 작업 대화를 살펴보고 공통 지침에 반영할 교훈을 제안합니다. 상태 확인과 실행 메뉴를 엽니다. 현재 이 작업에는 agent-bios 소스 저장소가 필요합니다."
+
+"preset.balanced.description" = "일반적인 기능 개발과 버그 수정에 권하는 시작점입니다. 메인 에이전트가 작업을 나눠 맡기고 독립 리뷰를 요청할 수 있습니다. 특별한 요구가 없을 때 고르세요. 에이전트와 리뷰가 늘면 시간과 사용량도 늘 수 있습니다."
+"preset.deep-review.description" = "결함을 놓쳤을 때 손실이 큰 변경에 적합합니다. 다른 AI 제공자의 모델로 더 깊은 추가 리뷰를 요청합니다. 대기 시간과 사용량이 늘어날 수 있으며, 이 컴퓨터에서 가능한 리뷰 경로는 위 설정에 표시됩니다."
+"preset.fast-batch.description" = "여러 파일에 같은 변경을 적용하는 등 기준이 분명한 반복 작업에 적합합니다. 실행 담당 티어인 WORKHORSE를 메인으로 시작합니다. 판단이 어려운 부분은 별도로 맡기거나 Balanced를 선택하세요. 실제 사용량은 모델과 작업량에 따라 달라집니다."
+"preset.solo.description" = "메인 에이전트 하나와 진행하고 싶은 작업에 적합합니다. 작업 위임을 끄고, 이 프리셋에서는 리뷰를 자동 요청하지 않습니다. 추가 에이전트 호출이 없으며, 별도 리뷰가 필요할 때 직접 요청합니다."
+"preset.vanilla.description" = "평소 CLI의 기본 설정으로 시작합니다. 런처가 모델 배정·권한 변경·리뷰 계약을 추가하지 않습니다. 설치된 전역 지침과 프로젝트 자체 지침은 CLI의 기본 로딩 규칙에 따라 적용됩니다."
+"preset.custom.description" = "메인 모델, 리뷰 방식, 실행 권한, 위임할 작업의 담당 모델을 직접 고릅니다. 마지막 ‘이 설정으로 시작’ 전까지 설정을 살펴보고 바꿀 수 있습니다. 이 선택들이 낯설면 Balanced에서 시작하세요."
+"preset.title" = "작업 방식 선택"
+"preset.custom.label" = "직접 설정 (Custom)"
 
 "language.label" = "언어"
 "language.description" = "TUI 언어를 선택합니다 (English / 한국어 / 日本語). AI가 소비하는 코퍼스는 영어 그대로이며, 런처 화면만 바뀝니다."
@@ -16,18 +25,73 @@
 "language.ja.description" = "ランチャーの画面を日本語で表示します。"
 
 "corpus.label" = "코퍼스 패키지"
-"corpus.description" = "설치할 코퍼스 도메인 패키지를 선택합니다. 적용하면 설치기의 onboard 루프(설치 + 활성화 카나리)가 실행됩니다."
+"corpus.private.title" = "Corpus Studio"
+"corpus.private.description" = "개인 corpus 항목을 조회·생성·편집·삭제·복원합니다. 변경은 다음 활성 세션에 반영되고, 실행 중인 세션은 고정한 내용을 유지합니다."
+"corpus.private.relationship" = "Corpus는 별도 저장소에 보관됩니다. Builder는 선택한 사본을 활성화하고, 기본 CLI와 Vanilla에는 자동 추가하지 않습니다. 기존 전역 설치는 별도 이전이 필요합니다."
+"corpus.private.vanilla" = "기본 CLI와 사용자가 설정한 개인·프로젝트 지시문을 사용합니다. Private agent-bios corpus, 스킬 설명, 실행 설정은 추가하지 않습니다."
+"corpus.description" = "AI가 참고할 작업 지침을 고릅니다. 개발·여러 에이전트의 협업·스프레드시트 같은 작업별 묶음입니다. 패키지를 고른 뒤 ‘선택 적용’으로 설치합니다. 이 컴퓨터의 이후 CLI 실행에 쓰는 공통 지침을 바꾸므로 다른 프로젝트에도 영향을 줍니다."
 "corpus.title" = "코퍼스 패키지"
-"corpus.core.line" = "core + infra는 항상 설치됩니다. 이 체크리스트는 선택 도메인 패키지만 다룹니다."
-"corpus.toggle.description" = "이 도메인 패키지를 토글합니다. Apply 전까지 아무것도 바뀌지 않습니다."
+"corpus.core.line" = "목표 설정·의사결정·교훈 기록의 기본 규칙(core + infra)은 항상 포함됩니다. 아래에서 작업별 패키지를 고르세요."
+"corpus.toggle.description" = "이 패키지를 선택하거나 해제합니다. ‘선택 적용’은 체크된 패키지 전체를 함께 설치하고 해제한 패키지는 설치 목록에서 뺍니다. 적용 전에 뒤로 돌아가거나 취소하면 설치 상태는 그대로입니다."
+"corpus.size.legend" = "각 패키지 옆의 크기는 모든 세션이 읽는 전역에 더해지는 양입니다. 가이드도 함께 배포되지만 규칙이 가리킬 때만 읽힙니다."
+"corpus.size.detail" = "모든 세션에 규칙 {rules}개({size})를 더하고, 규칙이 가리킬 때만 읽히는 가이드 {guides}개({guide_size})를 배포합니다."
+"corpus.size.detail.noguides" = "모든 세션에 규칙 {rules}개({size})를 더하고, 배포하는 가이드는 없습니다."
 "corpus.apply.label" = "선택 적용{pending}"
-"corpus.apply.description" = "체크된 집합 그대로 agent-bios onboard를 실행합니다. 배포·카나리·결과 기록은 설치기가 수행합니다."
+"corpus.apply.description" = "체크한 패키지를 설치하고 해제한 패키지를 이 컴퓨터의 공통 지침에서 뺍니다. 설치 후 AI가 지침을 읽을 수 있는지 확인하고 결과를 보여 줍니다. 다른 프로젝트에서도 사용하는 지침이며, 프로젝트 코드를 바꾸는 작업은 아닙니다."
 "corpus.apply.unchanged" = "체크된 집합이 적용된 집합과 같습니다 — 적용할 것이 없습니다"
 "corpus.unavailable.line1" = "corpus status projection이 없거나 도메인 보고 이전 버전입니다."
 "corpus.none.line" = "이 투영에는 선택 가능한 도메인 패키지가 없습니다 — core와 infra는 항상 설치되므로 여기서 고를 것이 없습니다."
 "corpus.unavailable.line2" = "실행: agent-bios install   (이 화면이 읽는 projection을 다시 씁니다)"
 "corpus.back.hint" = "모드 메뉴로 돌아갑니다."
 
+"corpus.launch.relationship" = "모드와 프리셋은 세션의 실행 방식을 정합니다. 설치된 코퍼스 선택은 그대로 유지되며, 변경은 ‘코퍼스 패키지’에서 합니다. Vanilla에서도 호스트의 기본 지침 로딩을 통해 설치된 전역 규칙을 읽습니다."
+"corpus.launch.applied" = "현재 적용된 코퍼스:"
+"corpus.launch.base" = "core + infra: 목표·제약 확인, 선택지 비교, 검증 결과 보고, 다음 세션에 재사용할 교훈 기록을 다룹니다."
+"corpus.launch.unknown" = "이 설치본에서 패키지 내용을 확인할 수 없습니다."
+"corpus.domain.builder-base.label" = "개발 기본 원칙"
+"corpus.domain.llm-pipeline-dev.label" = "LLM 파이프라인 개발"
+"corpus.domain.multi-agent-orchestration.label" = "여러 에이전트의 협업"
+"corpus.domain.visualization-docs.label" = "도표와 구현 지도"
+"corpus.domain.office-work.label" = "스프레드시트 작업"
+"corpus.domain.builder-base" = """
+소프트웨어 구현·검증·유지보수에 공통으로 쓰는 개발 원칙입니다.
+• Coding(개발 절차): 완료 기준을 정하고 작업을 계획한 뒤, 필요한 부분을 수정하고 결과를 리뷰합니다.
+• Verification menus(검증 선택): 코드·설정·문서 등 작업 대상에 맞는 검사를 고르고 실제 변경 경로를 검증합니다.
+• Concept economy(개념 관리): 기존 개념을 재사용하고 이름과 값의 관리 주체를 하나로 유지해 중복을 줄입니다.
+• Documentation hygiene(문서 관리): 현재 문서를 실제 동작과 맞추고 결정·이력·인수인계 기록을 알맞은 곳에 둡니다.
+• Tooling safety(도구 사용): 도구·환경을 명확히 지정하고 셸·Git 함정, 비밀값 취급, 생성한 프로세스 정리를 다룹니다.
+• Mock boundaries(테스트 대역): 모의 객체를 의도적으로 사용하고 최종 기능이 실제 의존성을 통해 동작하는지 확인합니다.
+• Review requests & defect criteria(리뷰 기준): 근거와 구체적인 실패 기준을 리뷰어에게 주고 중요한 지적을 해결합니다.
+• Repository instructions(저장소 지침): repo-charter 스킬로 저장소 코드에 근거한 AGENTS.md 작업 규칙을 만듭니다.
+"""
+"corpus.domain.llm-pipeline-dev" = """
+모델의 판단과 코드로 보장할 계약을 구분해 LLM 파이프라인을 만듭니다.
+• Capability boundary(역할 경계): 의미 해석과 선택은 모델이 맡고, 정확한 계산과 변환은 도구가 수행합니다.
+• Structured output(구조화 출력): 제출 형식을 제한하고 코드가 검증·직렬화·최종 산출물 생성을 맡습니다.
+• Runtime authority(실행 권한): 실제 도구와 소비 경로에서 권한·실행 경로를 보장합니다. 프롬프트나 읽히지 않는 플래그만으로는 동작이 바뀌지 않습니다.
+• Failure handling(실패 처리): 계약을 어긴 출력은 거부하고 불확실한 품질 판단은 사용자에게 알립니다. 모델 출력을 몰래 보정하지 않습니다.
+"""
+"corpus.domain.multi-agent-orchestration" = """
+여러 모델과 CLI 에이전트의 역할·인수인계·독립 리뷰를 조율합니다.
+• Delegation(위임): 독립 작업이나 반복 작업에 에이전트가 유용한지 판단하고 범위와 완료 기준을 정해 맡깁니다.
+• Model allocation(모델 배분): 난도와 영향에 따라 티어를 배정하고 저렴한 모델의 구현에는 검증을 보강합니다.
+• Prompting guides(프롬프트 지침): 대상 모델 계열에 맞게 지시 방식과 추론 강도를 조정합니다.
+• Independent review(독립 리뷰): 제공자와 관점을 비교하고 요청한 모델·설정에서 리뷰가 실제로 실행됐는지 확인합니다.
+• Continuation & batches(재개·일괄 작업): 재개 가능한 산출물을 보존하고 세션 상태를 재확인하며 사용량 제한의 반복 재시도를 멈춥니다.
+"""
+"corpus.domain.visualization-docs" = """
+시스템과 의사결정을 도표로 설명하고 현재 구현 상태를 지도로 관리합니다.
+• Visual explanations(시각 설명): 비교·흐름·상태 변화를 가장 잘 전달하는 텍스트·표·HTML 표현을 고릅니다.
+• SVG diagrams(SVG 도표): 역할·경계·의존성·방향을 읽기 쉬운 배치와 일관된 표기로 나타냅니다.
+• Implementation map(구현 지도): 구조·목표·위험·결정·검증 상태를 현재 시점의 대시보드로 유지합니다.
+"""
+"corpus.domain.office-work" = """
+스프레드시트 작업을 설치된 spreadsheet-processing 스킬로 안내합니다.
+• Spreadsheet processing(시트 작업): 스킬이 있으면 통합문서 편집·생성·대사·검증에 사용합니다.
+• Formula verification(수식 검증): 수식에 의존하는 Excel 결과를 실제 Microsoft Excel 엔진으로 확인합니다.
+• Availability(사용 조건): 이 패키지는 작업 안내 규칙을 추가합니다. 스프레드시트 스킬과 Excel은 별도로 사용할 수 있어야 합니다.
+"""
+
 "wizard.title" = "다른 리뷰어 등록"
 "wizard.id.label" = "Method id (kebab-case)"
 "wizard.label.label" = "라벨 (method 목록에 표시)"
@@ -74,6 +138,8 @@
 "custom.review.description" = "리뷰 게이트가 작동할 때 요청할 리뷰 경로를 선택합니다."
 "custom.policy.label" = "실행 정책: {policy}"
 "custom.policy.description" = "호스트별 권한 또는 샌드박스 동작을 선택합니다."
+"custom.global-instructions.label" = "내 전역 지침 파일: {choice}"
+"custom.global-instructions.description" = "이 agent-bios 활성 세션에서 개인 전역 지침 파일을 불러올지 선택합니다."
 "custom.tier.description" = "{tier} 티어의 모델과 추론 강도를 편집하고 여기로 돌아옵니다."
 "custom.save.label" = "이 설정을 전역으로 저장하고 시작"
 "custom.save.description" = "이 구성을 사용자 설정에 이름 있는 프리셋으로 저장해 다른 곳에서도 재사용한 뒤 실행합니다."
@@ -162,9 +228,16 @@
 "panel.version.label" = "적용 버전"
 "panel.mechanisms.label" = "메커니즘"
 "panel.ledger.label" = "원장"
+"panel.rules.label" = "규칙"
+"panel.rules.value" = "모든 세션이 읽는 전역에 {rules}개 · {size}"
+"panel.guides.label" = "가이드"
+"panel.guides.value" = "{guides}개 배포됨 · {size}, 규칙이 가리킬 때 읽힘"
+"panel.ledger.author-only" = "작성자 측 전용 — 패키지 설치에는 학습 원장이 없습니다"
+"panel.domains.unknown" = "⚠ 적용되어 있으나 이 패키지에 없음: {names}"
 "panel.domains.label" = "도메인"
 "panel.rolled-back" = "(롤백됨. 최신은 {latest})"
 "panel.layers.none" = "없음"
+"panel.unavailable" = "패키지 설치에서는 확인 불가"
 "panel.ledger.value" = "배치 {placed} · 인큐베이팅 {incubating} · 버전 {versions}"
 "panel.domains.unset" = "(아직 선택 안 함)"
 "panel.last-apply" = "⚠ 마지막 적용 {outcome} @ {at} — 요청: {requested}"
@@ -174,6 +247,39 @@
 # while every line of content around them was translated, so the Korean and Japanese
 # screens answered in one language and asked in another.
 "prompt.select" = "선택 [{default}] ({actions}): "
+"tui.setup.title" = "현재 설정"
+"setup.none" = "선택된 설정 없음"
+"setup.host" = "호스트 {host} | 프리셋 {preset}"
+"setup.bare" = "평소 CLI 설정으로 실행합니다. 런처가 실행 계약이나 권한 옵션을 추가하지 않습니다.\n전역 지침과 프로젝트 지침은 CLI의 기본 로딩 규칙에 따라 적용됩니다."
+"setup.main" = "메인 {tier} | 리뷰 {review}"
+"setup.delegation" = "위임 {delegation} | 실행 {execution}"
+"setup.global-instructions.label" = "전역 파일"
+"global-instructions.title" = "내 전역 지침 파일"
+"global-instructions.summary" = "사용자 전역 지침 문서·규칙: {choice}"
+"global-instructions.include.label" = "포함"
+"global-instructions.include.description" = "CLI의 기본 방식대로 사용자 전역 지침 문서와 규칙을 읽습니다. 어느 쪽이든 프로젝트 지침·메모리, 설정, 로그인, 도구와 실행 권한은 유지합니다."
+"global-instructions.exclude.label" = "제외"
+"global-instructions.exclude.description" = "사용자 전역 지침 문서를 읽지 않습니다. Claude에서는 전역 CLAUDE.md, 그 import, 사용자 rules/를 제외합니다. 프로젝트 지침·메모리, 설정, 로그인, 도구와 실행 권한은 유지합니다."
+"global-instructions.exclude.codex-unavailable" = "현재 Codex에서는 전역 지침 파일만 안전하게 제외하는 경로를 지원하지 않습니다."
+"global-instructions.exclude.private-unavailable" = "agent-bios 활성 세션이 필요합니다. Vanilla와 일반 CLI 실행은 네이티브 지침 로딩을 유지합니다."
+"setup.inactive.label" = "비활성"
+"setup.inactive.value" = "{tiers} — 비활성, 투영되지 않음 ({reason})"
+"tui.corpus.title" = "코퍼스 상태"
+"tui.detail.title" = "선택 중인 항목 설명"
+"tui.detail.scroll" = "j/k: 설명 아래/위 · Shift+PgUp/PgDn"
+"tui.options.header" = "항목 (1-{count} / {count})"
+"tui.key.move" = "Up/Down 이동"
+"tui.key.select" = "Enter 선택"
+"tui.key.apply" = "Enter 적용"
+"tui.key.toggle" = "Space 토글"
+"tui.key.scroll" = "PgUp/PgDn 스크롤"
+"tui.key.back" = "Left 뒤로"
+"tui.key.cancel" = "Esc 취소"
+"tui.input.current" = "현재 값: {value}"
+"tui.input.new" = "새 값 (비워 두면 현재 값 유지):"
+"tui.input.placeholder" = "비워 두면 현재 값을 유지합니다"
+"tui.input.footer" = "Enter 확정 | Esc/Ctrl-C 취소 | q + Enter 취소"
+"prompt.text" = "{label} [{default}] ({cancel}): "
 "prompt.back" = "b 뒤로"
 "prompt.cancel" = "q 취소"
 "prompt.unavailable" = "사용 불가"

package/learn/collect-learning.py

@@ -9,15 +9,13 @@ optional criteria / classification / proposed_domain / context) plus its session
   * mints learning_id (a lowercase UUID) + created (ISO-8601) + schema_version;
   * validates the full record against learn/learning.schema.json — the single
     validation source, reused from learn/check-learning.py (no second schema);
-  * logs the JSON record to <home>/personal/learnings.jsonl — the durable,
-    append-only upload source that the Phase 2 watermark drain re-sends from;
-  * writes the lesson prose where THIS host loads it next session, and wires it:
-      - claude: appends to <home>/personal/learnings.md and ensures the
-        `@personal/learnings.md` import once in the entry CLAUDE.md;
-      - codex: appends into a preserved `agent-bios:personal-learnings` region
-        of <home>/AGENTS.md (Codex has no @import; AGENTS.md is always loaded).
-        The region lives OUTSIDE the central markers so compose/assemble.py —
-        which only rewrites the central region — preserves it across re-assembly.
+  * appends the exact record to the private corpus's host-qualified events.jsonl;
+  * supplies it to future activated snapshots through CorpusStore, without changing
+    native global instructions or the running session;
+  * drains explicitly configured ingestion from that immutable private event source.
+
+The global prose/import writers below are reached only under the explicit
+AGENT_BIOS_LEGACY_INSTALL=1 compatibility path and its migration tests.
 
 It REFUSES any script-owned field in the payload (deterministic values are never
 hand-authored) and, on a schema/membership violation, REJECTS and exits 1 — it
@@ -27,7 +25,7 @@ Input:  the semantic payload as one JSON object on stdin.
 Host:   --host claude|codex (default: the tool prefix of supporting_sessions[0]).
 Home:   --config-dir, else $CLAUDE_CONFIG_DIR / $CODEX_HOME by host, else ~/.claude / ~/.codex.
 After the local writes it best-effort uploads not-yet-delivered records to
-{base}/api/ingest/learnings via a watermark over learnings.jsonl. The base and
+{base}/api/ingest/learnings via a host-private watermark over events.jsonl. The base and
 token resolve from the agent-bios-owned slot ~/.config/agent-bios/{ingest-url,
 token} — the one transport contract, written by whoever adopts this install;
 skipped when it is unset, or with --no-upload.
@@ -39,6 +37,7 @@ import json
 import os
 import pathlib
 import shutil
+import stat
 import sys
 import http.client
 import time
@@ -418,7 +417,11 @@ def transport_config(slot_root=None):
             if not present(f):
                 return None, (f"transport slot {slot} is missing {what} "
                               "(a claimed slot never falls back)")
-            if not f.is_file():
+            try:
+                is_regular_file = stat.S_ISREG(f.stat().st_mode)
+            except OSError:
+                is_regular_file = False
+            if not is_regular_file:
                 return None, (f"transport slot {slot} has {what} but it is not a "
                               "readable file (a claimed slot never falls back)")
         # One read per try, so the reason can name the file that actually
@@ -474,8 +477,8 @@ def read_jsonl_records(jsonl):
     return out
 
 
-def load_state(home):
-    path = home / "personal" / STATE_NAME
+def load_state(home, state_path=None):
+    path = pathlib.Path(state_path) if state_path is not None else home / "personal" / STATE_NAME
     if not path.is_file():
         return {"uploaded": set(), "dead": set()}
     try:
@@ -486,10 +489,10 @@ def load_state(home):
         return {"uploaded": set(), "dead": set()}
 
 
-def save_state(home, state, present_ids):
+def save_state(home, state, present_ids, state_path=None):
     # Prune settled ids no longer in the durable log (e.g. migrated out) so the
     # state stays bounded to the log size. Atomic replace.
-    path = home / "personal" / STATE_NAME
+    path = pathlib.Path(state_path) if state_path is not None else home / "personal" / STATE_NAME
     path.parent.mkdir(parents=True, exist_ok=True)
     data = {"uploaded": sorted(state["uploaded"] & present_ids),
             "dead": sorted(state["dead"] & present_ids)}
@@ -565,7 +568,8 @@ def http_post(base, token, record, timeout=UPLOAD_TIMEOUT_S):
 
 
 def drain_uploads(home, post_fn=http_post, now=time.monotonic,
-                  limit=UPLOAD_LIMIT, budget_s=UPLOAD_BUDGET_S, slot_root=None):
+                  limit=UPLOAD_LIMIT, budget_s=UPLOAD_BUDGET_S, slot_root=None,
+                  jsonl_path=None, state_path=None):
     """Best-effort upload of not-yet-settled learnings. post_fn/now/slot_root are
     injectable for tests (no sockets, no $HOME mutation). Returns a summary dict.
 
@@ -580,9 +584,10 @@ def drain_uploads(home, post_fn=http_post, now=time.monotonic,
                 "reason": reason, "uploaded": 0, "dead": 0, "pending": None}
     token, base = config
 
-    records = read_jsonl_records(home / "personal" / "learnings.jsonl")
+    records = read_jsonl_records(pathlib.Path(jsonl_path) if jsonl_path is not None
+                                else home / "personal" / "learnings.jsonl")
     present_ids = {lid for lid, _ in records}
-    state = load_state(home)
+    state = load_state(home, state_path)
     settled = state["uploaded"] | state["dead"]
     candidates = [(lid, rec) for lid, rec in records if lid not in settled]
 
@@ -608,7 +613,7 @@ def drain_uploads(home, post_fn=http_post, now=time.monotonic,
             stopped = "transient"
             break
 
-    save_state(home, state, present_ids)
+    save_state(home, state, present_ids, state_path)
     pending = sum(1 for lid, _ in records
                   if lid not in (state["uploaded"] | state["dead"]))
     return {"status": "ok", "reason": stopped, "uploaded": uploaded,
@@ -1168,6 +1173,28 @@ def main():
         sys.exit(1)
 
     dry = args.dry_run
+    if os.environ.get("AGENT_BIOS_LEGACY_INSTALL") != "1":
+        # Capture is an immutable private source. Model-visible projections are
+        # composed when an activated session is started, never written globally.
+        sys.path.insert(0, str(REPO / "compose"))
+        from corpus_store import CorpusStore
+        store = CorpusStore(REPO)
+        destination = store.user_root / "learnings" / host
+        if dry:
+            print(f"collect-learning: [dry] private capture host={host} -> {destination / 'events.jsonl'}")
+            return
+        result = store.capture_learning(host, record)
+        print(f"collect-learning: OK host={host} learning_id={result['learning_id']} · private source; future activated sessions")
+        if not args.no_upload:
+            import fcntl
+            lock = destination / 'upload.lock'
+            fd = os.open(lock, os.O_CREAT | os.O_RDWR | os.O_NOFOLLOW, 0o600)
+            with os.fdopen(fd, 'a') as handle:
+                fcntl.flock(handle, fcntl.LOCK_EX)
+                print_upload_summary(drain_uploads(
+                    home, jsonl_path=destination / 'events.jsonl',
+                    state_path=destination / 'upload-state.json'))
+        return
     bullet = prose_bullet(record)
     jsonl = append_record(home, record, dry)
     prose_path, wiring = APPLY[host](home, bullet, dry)

package/learn/migrate-learnings.py

@@ -1,5 +1,10 @@
 #!/usr/bin/env python3
-"""Promote -> migrate: clear the personal copy of promoted learnings (Phase 4).
+"""Private captures are retained; promotion suppression is a snapshot projection.
+
+The default entrypoint performs no source deletion. CorpusStore requires exact
+source and replacement evidence before omitting a duplicate from one snapshot.
+The functions below implement only the explicit AGENT_BIOS_LEGACY_INSTALL=1
+compatibility path, whose removal contract is described here.
 
 After a push lands, a learning that was promoted into the shared corpus is now
 loaded from the corpus — its personal copy (written by `learn!`,
@@ -402,6 +407,10 @@ def main():
         _self_test()
         return
 
+    if os.environ.get("AGENT_BIOS_LEGACY_INSTALL") != "1":
+        print("migrate-learnings: private capture sources retained; promotion suppression is resolved per session snapshot")
+        return
+
     if not args.host:
         die("--host claude|codex is required")
     if args.selection_file is None and args.domains is None:

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "agent-bios",
-  "version": "0.14.0",
-  "releaseDate": "2026-08-31",
-  "description": "A thin, low-level instruction layer for LLM CLI agents: one set of principles and behavior whichever model you run. Deploys into $HOME by copy via an explicit `agent-bios install`.",
+  "version": "0.16.0",
+  "releaseDate": "2026-09-10",
+  "description": "A thin, low-level instruction layer for LLM CLI agents: one set of principles and behavior whichever model you run. Stores a private, editable corpus for explicitly activated sessions.",
   "bin": {
     "agent-bios": "install.sh"
   },
@@ -29,7 +29,17 @@
     "compose/assemble.py",
     "compose/prune-backups.py",
     "compose/check-domains.py",
+    "compose/corpus-state.py",
+    "compose/write-update-cache.py",
     "compose/canary.sh",
+    "compose/corpus.py",
+    "compose/corpus_ui.py",
+    "compose/corpus_store.py",
+    "compose/corpus_catalog.py",
+    "compose/corpus_session.py",
+    "compose/corpus_install.py",
+    "compose/corpus_transaction.py",
+    "compose/bootstrap/",
     "launch/check-prompting-targets.sh",
     "learn/check-learning.py",
     "learn/collect-learning.py",

package/provenance.json

@@ -1 +1 @@
-{"commit":"db5e745b6f832a02b43556889c14ce1396688177","committedAt":"2026-08-31T13:13:32+09:00","dirty":false}
+{"commit":"79b4adb99a51410411cdb416a56b40fe243be4c8","committedAt":"2026-09-10T08:03:58+09:00","dirty":false}

package/session-cost.py

@@ -18,12 +18,14 @@ the bill: measured over two real sessions here, cache read + cache write were
 92-94% of cost and output 6-8%, so context size is the cost, and the only lever
 on it is how long a session is allowed to grow before it is reset.
 """
-import json, sys, glob, os, itertools, tempfile
+import json, sys, glob, os, itertools, tempfile, subprocess
 from datetime import datetime, timezone
 
 # $/MTok: input, output, cache_read, cache_write_5m, cache_write_1h
 PRICES = {
     "claude-fable-5":  (10.0, 50.0, 1.00, 12.50, 20.0),
+    # Fable 5.1 model overview, verified 2026-09-08.
+    "claude-fable-5-1": (10.0, 50.0, 0.25, 12.50, 20.0),
     "claude-mythos-5": (10.0, 50.0, 1.00, 12.50, 20.0),
     "claude-opus-5":   (5.0, 25.0, 0.50, 6.25, 10.0),
     "claude-opus-4-8": (5.0, 25.0, 0.50, 6.25, 10.0),
@@ -35,7 +37,8 @@ PRICES = {
 }
 
 def price_for(model):
-    for k, v in PRICES.items():
+    # Version-specific rates take precedence over their family prefix.
+    for k, v in sorted(PRICES.items(), key=lambda item: len(item[0]), reverse=True):
         if model.startswith(k):
             return v
     return None
@@ -393,6 +396,23 @@ def _self_test():
         return p
 
     with tempfile.TemporaryDirectory() as td:
+        # A version-specific cache rate must reach the public report without
+        # changing the older model's rate. Run the real CLI/scan/cost path.
+        for model, expected in (("claude-fable-5-1", "$0.25"),
+                                ("claude-fable-5", "$1.00")):
+            transcript = write(td, model + ".jsonl", [
+                {"type": "assistant", "message": {
+                    "id": "cache-price", "model": model,
+                    "usage": {"cache_read_input_tokens": 1_000_000}}},
+            ])
+            result = subprocess.run(
+                [sys.executable, os.path.abspath(__file__), transcript],
+                capture_output=True, text=True)
+            check(model + " cache price reaches the report",
+                  (result.returncode,
+                   "modeled total cost: " + expected in result.stdout),
+                  (0, True))
+
         # Claude: two requests. The first is written twice as it streams, the
         # second is a sidechain that must not be counted.
         claude = write(td, "claude.jsonl", [

package/wrappers/codex-helm.sh

@@ -233,9 +233,9 @@ EOF
   if [ "$fanout" -eq 1 ]; then
     cat <<EOF
 - Fan-out is authorized when delegation gates fire; do de-minimis work directly. Native multi-agent is off unless the main is explicit Ultra.
-- Internal roles via codex-run --profile inherit and bounded stdin packet: WORKHORSE=gpt-5.6-terra/high/read-only-or-workspace-write; SWEEP=gpt-5.6-luna/low/read-only; REVIEWER=gpt-5.6-terra/high/read-only.
-- Native spawn cannot pin role/effort. Do not use native spawn_agent for FRONTIER. Use codex-run with gpt-5.6-sol/read-only and task-fit effort: max default, Ultra for divisible work, lower when cost/latency dominates.
-- Internal FRONTIER command base: $codex_run --profile inherit --model gpt-5.6-sol --effort <effort> --multi-agent auto --sandbox read-only --cd "\$PWD" -c agents.max_threads=$max_threads -c agents.max_depth=$max_depth. The adapter enables native multi-agent only for ultra. Send a self-contained packet on stdin; never full-history resume.
+- Internal roles via codex-run --profile inherit and bounded stdin packet: WORKHORSE=gpt-5.6-terra/xhigh/read-only-or-workspace-write; SWEEP=gpt-5.6-luna/max/read-only; REVIEWER=gpt-5.6-terra/xhigh/read-only.
+- Native spawn cannot pin role/effort. Do not use native spawn_agent for FRONTIER. Use codex-run with gpt-6-astra/read-only and task-fit effort: max default, Ultra for divisible work, lower when cost/latency dominates.
+- Internal FRONTIER command base: $codex_run --profile inherit --model gpt-6-astra --effort <effort> --multi-agent auto --sandbox read-only --cd "\$PWD" -c agents.max_threads=$max_threads -c agents.max_depth=$max_depth. The adapter enables native multi-agent only for ultra. Send a self-contained packet on stdin; never full-history resume.
 - Run independent units in parallel; respect depth/thread limits; wait and synthesize bounded reports.
 EOF
   else