okstra 0.38.1 → 0.39.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. package/README.kr.md +1 -1
  2. package/README.md +1 -1
  3. package/docs/kr/architecture.md +8 -0
  4. package/docs/project-structure-overview.md +1 -2
  5. package/docs/superpowers/plans/2026-06-02-requirements-discovery-fanout.md +728 -0
  6. package/docs/superpowers/specs/2026-06-02-requirements-discovery-fanout-design.md +154 -0
  7. package/docs/task-process/requirements-discovery.md +1 -1
  8. package/package.json +1 -1
  9. package/runtime/BUILD.json +2 -2
  10. package/runtime/prompts/profiles/requirements-discovery.md +18 -1
  11. package/runtime/python/okstra_ctl/fanout.py +35 -0
  12. package/runtime/python/okstra_ctl/migrate.py +3 -36
  13. package/runtime/python/okstra_ctl/run.py +0 -29
  14. package/runtime/python/okstra_ctl/seeding.py +0 -192
  15. package/runtime/python/okstra_ctl/work_categories.py +21 -0
  16. package/runtime/python/okstra_ctl/worktree.py +0 -50
  17. package/runtime/python/okstra_project/__init__.py +0 -6
  18. package/runtime/python/okstra_project/dirs.py +0 -8
  19. package/runtime/skills/okstra-context-loader/SKILL.md +1 -1
  20. package/runtime/skills/okstra-inspect/SKILL.md +1 -1
  21. package/runtime/templates/prd/brief.template.md +1 -1
  22. package/runtime/templates/reports/fan-out-unit.template.md +25 -0
  23. package/runtime/validators/validate-run.py +26 -0
  24. package/runtime/validators/validate_fanout.py +99 -0
  25. package/src/install.mjs +6 -26
  26. package/src/okstra-dirs.mjs +0 -11
  27. package/src/setup.mjs +0 -130
  28. package/src/uninstall.mjs +6 -13
  29. package/runtime/templates/okstra.CLAUDE.md +0 -104
package/README.kr.md CHANGED
@@ -62,7 +62,7 @@ okstra/ npm 패키지 = repo 루트
62
62
  ├── version 패키지 버전 stamp
63
63
  ├── lib/python/ okstra_project/, okstra_ctl/, okstra_token_usage/, lib/
64
64
  ├── bin/ okstra.sh, codex-exec, gemini-exec, ...
65
- ├── templates/ report asset, settings template, okstra.CLAUDE.md
65
+ ├── templates/ report asset, settings template
66
66
  ├── installed-skills.json 설치된 스킬 매니페스트 (uninstall 이 사용)
67
67
  ├── installed-agents.json 설치된 워커 에이전트 매니페스트 (uninstall 이 사용)
68
68
  ├── recent.jsonl, active.jsonl run 인덱스
package/README.md CHANGED
@@ -61,7 +61,7 @@ okstra/ npm package = repo root
61
61
  ├── version package version stamp
62
62
  ├── lib/python/ okstra_project/, okstra_ctl/, okstra_token_usage/, lib/
63
63
  ├── bin/ okstra.sh, codex-exec, gemini-exec, ...
64
- ├── templates/ report assets, settings template, okstra.CLAUDE.md
64
+ ├── templates/ report assets, settings template
65
65
  ├── installed-skills.json manifest of installed skills (used by uninstall)
66
66
  ├── installed-agents.json manifest of installed worker agents (used by uninstall)
67
67
  ├── recent.jsonl, active.jsonl run index
package/docs/kr/architecture.md CHANGED
@@ -376,6 +376,14 @@ okstra phase 는 PRD / issue file 을 직접 쓰지 않습니다. 동등한 결
376
376
 
377
377
  `PHASE_SEQUENCE` 의 정식 멤버에 들어가지 않는 sidetrack entry-point. 단방향 라이프사이클을 깨지 않으면서 코드베이스 발견 시나리오를 흡수한다. lens 화이트리스트와 candidate-cap 은 `scripts/okstra_ctl/improvement_lenses.py` SSOT 1개에서 통일된다. final-report 의 `## 4.9 Improvement Candidates` 표 (10 column) 는 `validators/validate_improvement_report.py` 의 11항목 contract 가 강제한다. 양방향 grilling 두 지점 (`okstra-brief` Step 4 강화 budget 8 + lead 의 Phase 1.5 reflect-back budget 12) 으로 사용자와 AI 의 이해도를 일치시킨다.
378
378
 
379
+ ### requirements-discovery fan-out
380
+
381
+ 혼합/다항목 요청은 requirements-discovery 가 도메인(work-category 5-enum)별 packet 으로
382
+ 분해해 `runs/requirements-discovery/fan-out/unit-*.md` 에 발행한다. 각 packet 은
383
+ `okstra-run --task-brief <경로>` 로 새 task-key 가 된다. 순서는 `index.md` 의 depends-on
384
+ 위상정렬이 담고, task 화 이후의 통합 일정은 okstra-schedule 이 맡는다. okstra-brief 는
385
+ 이 경로에 개입하지 않는다. 검증: `validators/validate_fanout.py`(validate-run 훅).
386
+
379
387
 
380
388
  ---
381
389
 
package/docs/project-structure-overview.md CHANGED
@@ -224,7 +224,6 @@ Token/cost accounting:
224
224
  | `templates/reports/*.template.md` | Inputs, schedule, user-response, settings templates |
225
225
  | `templates/prd/brief.template.md` | Brief template |
226
226
  | `templates/project-docs/task-index.template.md` | Project task index template |
227
- | `templates/okstra.CLAUDE.md` | Per-project okstra guidance import target |
228
227
 
229
228
  ### 4.8 `schemas/`
230
229
 
@@ -366,7 +365,7 @@ The Markdown is derived, not the authoring source. The schema is the contract.
366
365
  └── (consumers.jsonl) # implementation-planning 전용: impl-run 역링크 누적 파일
367
366
  ```
368
367
 
369
- Project-local `<PROJECT_ROOT>/.claude/settings.local.json`, `<PROJECT_ROOT>/.okstra/CLAUDE.md`, and `<PROJECT_ROOT>/AGENTS.md` are provisioned as symlink/import helpers so spawned agents can load okstra permissions and guidance.
368
+ Project-local `<PROJECT_ROOT>/.claude/settings.local.json` is provisioned as a symlink so spawned agents can load okstra worker-wrapper permissions.
370
369
 
371
370
  ---
372
371