feat: agent-learner v2 Phase 1 — core implementation

.agent-learner/events/codex/stop-019db855-b2cc-7141-9cb6-5d9b6e93583b.json

@@ -0,0 +1,19 @@
+{
+  "adapter": "codex",
+  "event_name": "stop",
+  "cwd": "/Users/reddit/Project/agent-learner",
+  "captured_at": "2026-04-23T05:42:39Z",
+  "session_id": "019db855-b2cc-7141-9cb6-5d9b6e93583b",
+  "transcript_path": null,
+  "payload": {
+    "session_id": "019db855-b2cc-7141-9cb6-5d9b6e93583b",
+    "turn_id": "019db8da-9e9a-7e43-aa4f-4673fe13635d",
+    "transcript_path": "/Users/reddit/.codex/sessions/2026/04/23/rollout-2026-04-23T12-15-17-019db855-b2cc-7141-9cb6-5d9b6e93583b.jsonl",
+    "cwd": "/Users/reddit/Project/agent-learner",
+    "hook_event_name": "Stop",
+    "model": "gpt-5.4",
+    "permission_mode": "bypassPermissions",
+    "stop_hook_active": false,
+    "last_assistant_message": "남은 것까지 끝냈습니다.\n\n`0.3.19`로 배포 완료됐고, 이번 릴리스 핵심은:\n- 자동 승격 기본 전략 유지\n- `review_required=True`면 실제로 자동 적용되지 않도록 수정\n- 운영/디버깅성 note는 **첫 번째는 candidate queue**, **반복되면 자동 승격**으로 보정\n- 이후 승격된 rule은 기존대로 `sweep`/`deprecated` 흐름 유지\n\n배포 상태:\n- `release` 성공\n- `pypi-publish` 성공\n- `npm-publish` 성공\n\n관련 커밋:\n- `306764d` `Keep exception notes from auto-promoting on first sight`\n\n검증:\n- `python3 -m pytest tests/test_pipeline.py tests/test_installers.py tests/test_cli_bootstrap.py -q`\n- `node --test test/wrapper.test.cjs`\n- `python3 scripts/release/release_check.py --version 0.3.19`\n\n이제 로컬에서 최신으로 쓰려면:\n```bash\nnpm install -g @cafitac/agent-learner@0.3.19\nagent-learner install-codex\n```\n\n한 가지 참고:\n- 이 세션 중간에 `~/.codex`는 현재 소스 기준으로 한 번 정상화해둔 상태입니다.\n- 그래서 지금은 로컬도 이미 동작하지만, 글로벌 패키지도 `0.3.19`로 맞춰두면 이후 재설치/재현이 깔끔해집니다.\n\n"
+  }
+}

.agent-learner/index/index.md

@@ -0,0 +1,9 @@
+# Rule Index
+
+- Learning root: `/Users/reddit/Project/agent-learner/.agent-learner/learning`
+- Generated at: `2026-04-23T03:05:16Z`
+- Total rules: `1`
+
+## approved
+
+- `change-with-tests` — 동작 변경이 있으면 관련 테스트도 함께 갱신하거나 추가한다.

.agent-learner/index/rules.json

@@ -0,0 +1,40 @@
+{
+  "learning_root": "/Users/reddit/Project/agent-learner/.agent-learner/learning",
+  "generated_at": "2026-04-23T03:05:16Z",
+  "total_rules": 1,
+  "entries": [
+    {
+      "name": "change-with-tests",
+      "relative_path": "approved/change-with-tests.md",
+      "status": "approved",
+      "summary": "동작 변경이 있으면 관련 테스트도 함께 갱신하거나 추가한다.",
+      "rule": "동작 변경이 있으면 관련 테스트도 함께 갱신하거나 추가한다.",
+      "why": "세션 종료 후 가장 재사용 가치가 높은 규칙은 변경과 검증을 함께 묶는 것이다.",
+      "scope": "서비스 수정, 버그 수정, 리팩토링",
+      "good_pattern": "프로덕션 변경과 테스트 변경이 같은 세션 diff에 함께 존재한다.",
+      "avoid_pattern": "코드만 바꾸고 테스트는 다음에 하겠다고 미루는 흐름",
+      "tags": [],
+      "triggers": [],
+      "task_types": [],
+      "file_patterns": [],
+      "projects": [
+        "*"
+      ],
+      "languages": [],
+      "frameworks": [],
+      "validated_on_models": [],
+      "excluded_models": [],
+      "model_dependency": "low",
+      "priority": "medium",
+      "confidence": "medium",
+      "token_estimate": 0,
+      "use_count": 0,
+      "refresh_count": 0,
+      "promote_count": 21,
+      "updated_at": null,
+      "last_used": null,
+      "learning_scope": "project",
+      "source_project": null
+    }
+  ]
+}

.agent-learner/learning/approved/change-with-tests.md

@@ -0,0 +1,28 @@
+---
+name: change-with-tests
+description: 동작 변경이 있으면 관련 테스트도 함께 갱신하거나 추가한다.
+type: learned-feedback
+status: "approved"
+first_seen_at: "2026-04-22 21:59:21"
+last_seen_at: "2026-04-22 22:53:26"
+learned_from: "2026-04-22 22:53:26 + stop-hook auto-promotion"
+source_session: "019db53a-ff7e-7113-a548-e6813f08305f"
+source_branch: "main"
+auto_promoted: true
+promote_count: 21
+---
+
+## Rule
+동작 변경이 있으면 관련 테스트도 함께 갱신하거나 추가한다.
+
+## Why
+세션 종료 후 가장 재사용 가치가 높은 규칙은 변경과 검증을 함께 묶는 것이다.
+
+## Scope
+서비스 수정, 버그 수정, 리팩토링
+
+## Good pattern
+프로덕션 변경과 테스트 변경이 같은 세션 diff에 함께 존재한다.
+
+## Avoid
+코드만 바꾸고 테스트는 다음에 하겠다고 미루는 흐름

.agent-learner/learning/dashboard.md

@@ -0,0 +1,6 @@
+# Learning Assets Dashboard
+
+- approved: 1
+- needs_review: 0
+- deprecated: 0
+- inbox: 2

.agent-learner/learning/inbox/session-learning-019db53a-ff7e-7113-a548-e6813f08305f.md

@@ -0,0 +1,84 @@
+# Session Learning Candidate
+
+- captured_at: 2026-04-22 22:53:26
+- session_id: 019db53a-ff7e-7113-a548-e6813f08305f
+- branch: main
+
+## Changed Files
+- HANGELOG.md
+- README.md
+- docs/architecture.md
+- docs/install.md
+- docs/storage-independence-and-provenance.md
+- frontend/src/App.tsx
+- frontend/src/components.tsx
+- frontend/src/types.ts
+- plugins/codex/README.md
+- src/agent_learner/cli/main.py
+- src/agent_learner/core/brain.py
+- src/agent_learner/core/dashboard.py
+- src/agent_learner/core/fastapi_app.py
+- src/agent_learner/core/indexing.py
+- src/agent_learner/core/lifecycle.py
+- src/agent_learner/core/models.py
+- src/agent_learner/core/retrieval.py
+- src/agent_learner/core/storage.py
+- src/agent_learner/core/webapp.py
+- src/agent_learner/frontend_dist/assets/index-k_SVvm1K.js
+- src/agent_learner/frontend_dist/index.html
+- tests/test_cli_bootstrap.py
+- tests/test_installers.py
+- tests/test_retrieval.py
+- .codex/
+- docs/scope-learning-system.md
+- src/agent_learner/core/global_learning.py
+- src/agent_learner/frontend_dist/assets/index-UNy-H_-D.js
+
+## Diff Summary
+
+```
+CHANGELOG.md                                       |  13 +
+ README.md                                          |  15 +-
+ docs/architecture.md                               |   2 +
+ docs/install.md                                    |   6 +-
+ docs/storage-independence-and-provenance.md        |  46 +--
+ frontend/src/App.tsx                               |  98 ++++--
+ frontend/src/components.tsx                        | 343 ++++++++++++++-------
+ frontend/src/types.ts                              |  48 ++-
+ plugins/codex/README.md                            |   2 +-
+ src/agent_learner/cli/main.py                      |   2 +-
+ src/agent_learner/core/brain.py                    |  84 -----
+ src/agent_learner/core/dashboard.py                |  57 +++-
+ src/agent_learner/core/fastapi_app.py              |  11 +-
+ src/agent_learner/core/indexing.py                 |   6 +-
+ src/agent_learner/core/lifecycle.py                |   9 +-
+ src/agent_learner/core/models.py                   |   4 +-
+ src/agent_learner/core/retrieval.py                |   2 +-
+ src/agent_learner/core/storage.py                  |   8 +-
+ src/agent_learner/core/webapp.py                   |   8 +-
+ .../frontend_dist/assets/index-k_SVvm1K.js         |  40 ---
+ src/agent_learner/frontend_dist/index.html         |   2 +-
+ tests/test_cli_bootstrap.py                        |  59 +++-
+ tests/test_installers.py                           |   2 +
+ tests/test_retrieval.py                            |  51 ++-
+ 24 files changed, 589 insertions(+), 329 deletions(-)
+```
+
+## Recent Commits
+
+```
+6b69aa7 Make the wrapper behave like the obvious command surface
+06e56ae Fix the published dashboard blank-screen regression
+6d03b3b Optimize learned-rule injection before the next prompt
+35d8b14 Make one-line install and doctor UX match reality
+30f2b2a Cut the first dashboard-native stable release
+```
+
+## Review Prompts
+- 어떤 결정이 다음 세션에도 반복해서 필요할까?
+- 어떤 규칙이 AGENTS.md / rules / learning references 로 승격될 가치가 있을까?
+- 어떤 내용은 단순 로그이고, 어떤 내용은 durable rule 인가?
+
+## Suggested Next Step
+- Run `$session-wrap` if the session needs a durable handoff.
+- Run `$feedback-learning` if a repeatable rule emerged.

.agent-learner/learning/inbox/session-learning-019db855-b2cc-7141-9cb6-5d9b6e93583b.md

@@ -0,0 +1,4 @@
+# Session Learning Candidate
+
+- captured_at: 2026-04-23 14:42:38
+- session_id: 019db855-b2cc-7141-9cb6-5d9b6e93583b

.agent-learner/state/processed-events/extract/codex/stop-019db855-b2cc-7141-9cb6-5d9b6e93583b.done

@@ -0,0 +1 @@
+stop-019db855-b2cc-7141-9cb6-5d9b6e93583b.json

.agent-learner/state/storage-migration.json

@@ -0,0 +1,9 @@
+{
+  "migrated_from": "/Users/reddit/Project/agent-learner/.codex/references/learning",
+  "canonical_root": "/Users/reddit/Project/agent-learner/.agent-learner/learning",
+  "copied_files": [
+    "/Users/reddit/Project/agent-learner/.agent-learner/learning/inbox/session-learning-019db53a-ff7e-7113-a548-e6813f08305f.md",
+    "/Users/reddit/Project/agent-learner/.agent-learner/learning/drafts/learned-rule-draft-019db53a-ff7e-7113-a548-e6813f08305f.md",
+    "/Users/reddit/Project/agent-learner/.agent-learner/learning/approved/change-with-tests.md"
+  ]
+}

.codex/references/learning/approved/change-with-tests.md

@@ -0,0 +1,28 @@
+---
+name: change-with-tests
+description: 동작 변경이 있으면 관련 테스트도 함께 갱신하거나 추가한다.
+type: learned-feedback
+status: "approved"
+first_seen_at: "2026-04-22 21:59:21"
+last_seen_at: "2026-04-23 12:38:04"
+learned_from: "2026-04-23 12:38:04 + stop-hook auto-promotion"
+source_session: "019db855-b2cc-7141-9cb6-5d9b6e93583b"
+source_branch: "main"
+auto_promoted: true
+promote_count: 43
+---
+
+## Rule
+동작 변경이 있으면 관련 테스트도 함께 갱신하거나 추가한다.
+
+## Why
+세션 종료 후 가장 재사용 가치가 높은 규칙은 변경과 검증을 함께 묶는 것이다.
+
+## Scope
+서비스 수정, 버그 수정, 리팩토링
+
+## Good pattern
+프로덕션 변경과 테스트 변경이 같은 세션 diff에 함께 존재한다.
+
+## Avoid
+코드만 바꾸고 테스트는 다음에 하겠다고 미루는 흐름

.codex/references/learning/dashboard.md

@@ -0,0 +1,10 @@
+# Learning Assets Dashboard
+
+- approved: 1
+- needs_review: 0
+- deprecated: 0
+- drafts: 3
+- inbox: 3
+
+## Approved Rules
+- change-with-tests

.codex/references/learning/drafts/learned-rule-draft-019db53a-ff7e-7113-a548-e6813f08305f.md

@@ -0,0 +1,7 @@
+# Learned Rule Drafts
+
+- captured_at: 2026-04-23 01:13:37
+- session_id: 019db53a-ff7e-7113-a548-e6813f08305f
+- branch: main
+
+No durable rule draft inferred automatically.

.codex/references/learning/drafts/learned-rule-draft-019db7ff-91d7-7c52-8c04-252b3560deb2.md

@@ -0,0 +1,23 @@
+# Learned Rule Drafts
+
+- captured_at: 2026-04-23 12:09:02
+- session_id: 019db7ff-91d7-7c52-8c04-252b3560deb2
+- branch: main
+
+## change-with-tests
+
+### Rule
+동작 변경이 있으면 관련 테스트도 함께 갱신하거나 추가한다.
+
+### Why
+세션 종료 후 가장 재사용 가치가 높은 규칙은 변경과 검증을 함께 묶는 것이다.
+
+### Scope
+서비스 수정, 버그 수정, 리팩토링
+
+### Good pattern
+프로덕션 변경과 테스트 변경이 같은 세션 diff에 함께 존재한다.
+
+### Avoid
+코드만 바꾸고 테스트는 다음에 하겠다고 미루는 흐름
+

.codex/references/learning/drafts/learned-rule-draft-019db855-b2cc-7141-9cb6-5d9b6e93583b.md

@@ -0,0 +1,23 @@
+# Learned Rule Drafts
+
+- captured_at: 2026-04-23 12:38:04
+- session_id: 019db855-b2cc-7141-9cb6-5d9b6e93583b
+- branch: main
+
+## change-with-tests
+
+### Rule
+동작 변경이 있으면 관련 테스트도 함께 갱신하거나 추가한다.
+
+### Why
+세션 종료 후 가장 재사용 가치가 높은 규칙은 변경과 검증을 함께 묶는 것이다.
+
+### Scope
+서비스 수정, 버그 수정, 리팩토링
+
+### Good pattern
+프로덕션 변경과 테스트 변경이 같은 세션 diff에 함께 존재한다.
+
+### Avoid
+코드만 바꾸고 테스트는 다음에 하겠다고 미루는 흐름
+

.codex/references/learning/inbox/session-learning-019db53a-ff7e-7113-a548-e6813f08305f.md

@@ -0,0 +1,42 @@
+# Session Learning Candidate
+
+- captured_at: 2026-04-23 01:13:37
+- session_id: 019db53a-ff7e-7113-a548-e6813f08305f
+- branch: main
+
+## Changed Files
+- HANGELOG.md
+- package.json
+- pyproject.toml
+- src/agent_learner/__init__.py
+- .agent-learner/
+- .codex/
+
+## Diff Summary
+
+```
+CHANGELOG.md                  | 2 ++
+ package.json                  | 2 +-
+ pyproject.toml                | 2 +-
+ src/agent_learner/__init__.py | 2 +-
+ 4 files changed, 5 insertions(+), 3 deletions(-)
+```
+
+## Recent Commits
+
+```
+a38b636 Tighten curated rule quality in the 0.3.10 release
+47a11d1 Correct the package metadata for a real 0.3.9 release
+c84fc94 Reduce dashboard density again in the 0.3.8 release
+e7a791b Make the dashboard read faster in the 0.3.7 polish release
+25f5ad0 Refine dashboard interactions for the 0.3.6 polish release
+```
+
+## Review Prompts
+- 어떤 결정이 다음 세션에도 반복해서 필요할까?
+- 어떤 규칙이 AGENTS.md / rules / learning references 로 승격될 가치가 있을까?
+- 어떤 내용은 단순 로그이고, 어떤 내용은 durable rule 인가?
+
+## Suggested Next Step
+- Run `$session-wrap` if the session needs a durable handoff.
+- Run `$feedback-learning` if a repeatable rule emerged.

.codex/references/learning/inbox/session-learning-019db7ff-91d7-7c52-8c04-252b3560deb2.md

@@ -0,0 +1,38 @@
+# Session Learning Candidate
+
+- captured_at: 2026-04-23 12:09:02
+- session_id: 019db7ff-91d7-7c52-8c04-252b3560deb2
+- branch: main
+
+## Changed Files
+- rc/agent_learner/core/storage.py
+- tests/test_installers.py
+- .agent-learner/
+- .codex/
+
+## Diff Summary
+
+```
+src/agent_learner/core/storage.py | 14 ++++++++++++++
+ tests/test_installers.py          | 16 +++++++++++++++-
+ 2 files changed, 29 insertions(+), 1 deletion(-)
+```
+
+## Recent Commits
+
+```
+6ef0ea1 Make learner release verification deterministic
+16c03c0 Reduce manual exception handling in the published learner
+1e3790c Make the published dashboard easier to review and trust
+08736b6 Fix curated learning promotion semantics in the 0.3.11 release
+a38b636 Tighten curated rule quality in the 0.3.10 release
+```
+
+## Review Prompts
+- 어떤 결정이 다음 세션에도 반복해서 필요할까?
+- 어떤 규칙이 AGENTS.md / rules / learning references 로 승격될 가치가 있을까?
+- 어떤 내용은 단순 로그이고, 어떤 내용은 durable rule 인가?
+
+## Suggested Next Step
+- Run `$session-wrap` if the session needs a durable handoff.
+- Run `$feedback-learning` if a repeatable rule emerged.