okstra 0.233.0 → 0.234.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 (30) hide show
  1. package/dist/cli-registry.mjs +6 -0
  2. package/dist/cli-registry.mjs.map +1 -1
  3. package/docs/architecture/storage-model.md +19 -0
  4. package/docs/cli.md +41 -1
  5. package/docs/project-structure-overview.md +3 -2
  6. package/package.json +1 -1
  7. package/runtime/BUILD.json +2 -2
  8. package/runtime/python/okstra_ctl/business_flow/cli.py +60 -6
  9. package/runtime/python/okstra_ctl/business_flow/contracts.py +12 -1
  10. package/runtime/python/okstra_ctl/business_flow/engine.py +17 -5
  11. package/runtime/python/okstra_ctl/business_flow/history.py +60 -0
  12. package/runtime/python/okstra_ctl/business_flow/source.py +35 -2
  13. package/runtime/python/okstra_ctl/business_flow/store.py +51 -14
  14. package/runtime/python/okstra_ctl/business_flow/sweep.py +124 -0
  15. package/runtime/python/okstra_ctl/doyouknow/cli.py +9 -9
  16. package/runtime/python/okstra_ctl/doyouknow/config.py +2 -2
  17. package/runtime/python/okstra_ctl/doyouknow/group_view.py +152 -0
  18. package/runtime/python/okstra_ctl/doyouknow/source_contracts.py +4 -3
  19. package/runtime/python/okstra_ctl/doyouknow/source_store.py +2 -2
  20. package/runtime/python/okstra_ctl/doyouknow/sources/business.py +116 -0
  21. package/runtime/python/okstra_ctl/doyouknow/sync.py +34 -9
  22. package/runtime/python/okstra_ctl/fixed_text.py +10 -0
  23. package/runtime/python/okstra_ctl/project_group.py +175 -0
  24. package/runtime/python/okstra_ctl/project_group_cli.py +62 -0
  25. package/runtime/schemas/business-flow-v1.schema.json +3 -0
  26. package/runtime/schemas/doyouknow-config-v1.schema.json +1 -1
  27. package/runtime/skills/okstra-explain-flow/SKILL.md +27 -2
  28. package/runtime/templates/doyouknow/group-view.css +103 -0
  29. package/runtime/templates/doyouknow/group-view.js +317 -0
  30. package/runtime/templates/doyouknow/group-view.template.html +72 -0
@@ -340,6 +340,12 @@ export const COMMAND_REGISTRY = [
340
340
  category: "introspection",
341
341
  summary: ["Manage cross-project okstra tasks"],
342
342
  },
343
+ {
344
+ name: "project-group",
345
+ python: { target: { module: "okstra_ctl.project_group_cli" } },
346
+ category: "introspection",
347
+ summary: ["Register which project roots belong to a named project group"],
348
+ },
343
349
  {
344
350
  name: "worktree-lookup",
345
351
  python: { target: { module: "okstra_ctl.worktree_lookup_cli" } },
@@ -1 +1 @@
1
- {"version":3,"file":"cli-registry.mjs","sourceRoot":"","sources":["../src/cli-registry.mts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"cli-registry.mjs","sourceRoot":"","sources":["../src/cli-registry.mts"],"names":[],"mappings":"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"}
@@ -671,6 +671,22 @@ Storage authority:
671
671
 
672
672
  Path segments are normalized into slugs. If a slug would be empty, as can happen with non-ASCII values, a `u-<sha1-prefix>` fallback segment is used. However, `manifest.json` and the child `taskKey` preserve the original input values (`project-id:task-group:task-id`).
673
673
 
674
+ ### 5. 프로젝트 그룹 등록부
675
+
676
+ `okstra project-group`은 제품이나 조직 단위로 프로젝트 루트를 묶는다. 매니저 상태와 별개이며 작업·일지를 갖지 않는다.
677
+
678
+ ```text
679
+ ~/.okstra/project-groups/<safe-project-group>.json
680
+ ```
681
+
682
+ - 파일 하나가 그룹 하나다. `projectGroup`에 원래 이름을, `projects`에 `projectId`·`projectRoot`·`linkedAt` 행을 `projectId` 순으로 둔다.
683
+ - 한 프로젝트는 여러 그룹 파일에 등록될 수 있다. 프로젝트의 `.okstra/project.json`에는 그룹을 기록하지 않으므로 이 파일이 소속의 유일한 기록이다.
684
+ - 파일명은 매니저 경로와 같은 슬러그 규칙을 따른다. 슬러그가 같은 다른 이름은 처음 저장된 이름의 파일을 공유하지 못하고 거부된다.
685
+ - `add`는 존재하는 디렉터리만 받는다. 그룹 파일을 먼저 검증하고, 등록 행이 새로 생기거나 루트가 바뀔 때만 `upsert_project_json`을 호출한다. 이때 `.okstra/project.json`이 없으면 만들고, 있으면 `projectId`가 일치해야 한다. 거부된 등록과 변경 없는 재등록은 프로젝트 디렉터리에 쓰지 않는다.
686
+ - `remove`는 등록 행만 지운다. 그룹 파일과 프로젝트의 `.okstra/`는 남는다.
687
+
688
+ 적용 여부는 `tests/doyouknow/test_project_group.py`가 확인한다.
689
+
674
690
  ## Task manifest contract
675
691
 
676
692
  `okstra set-work-status` can register an existing brief without creating a run. Such a task
@@ -877,6 +893,8 @@ Business artifacts use the original project root even when source inspection tar
877
893
  - Adjacent `<final-report.data.json>.business-flow.json`: human-report link projection, without changing the final-report schema or task routing.
878
894
  - `.okstra/agent-invocations/explain-flow/`: frozen investigator prompt, role/duty snapshots, assignment metadata, process log/status, result envelope and verified completion.
879
895
 
896
+ 후보 프로젝트는 기본으로 okstra 홈의 `projects/*/meta.json`에 기록된 모든 프로젝트와 현재 프로젝트다. 요청에 `project_group`이 있으면 조사 대상은 그 프로젝트 그룹 등록부의 프로젝트와 현재 프로젝트로 바뀐다. 지식 저장소를 읽는 범위는 좁아지지 않고 실행 이력의 프로젝트에 그룹 구성원을 더한 집합이며, 충돌 표시와 충돌 해소 검증은 이 넓은 집합에서 한다. 조회 결과는 그룹 구성원이 소유한 claim만 돌려주되 상태는 넓은 집합의 판정을 유지한다. 충돌 재조사(`reconcile`)는 그룹 밖 claim이 상대일 수 있으므로 넓은 집합을 조사한다. 그룹이 읽기 범위를 좁히면 범위 밖 claim을 포함한 해소 기록이 적용되지 않아 같은 저장소에 모순된 해소가 쌓일 수 있어서 이렇게 둔다. 등록되지 않은 그룹 이름은 실행을 실패로 끝낸다. `okstra explain-flow sweep`은 새 저장물을 만들지 않는다. 계획은 구성원 프로젝트의 실행 기록과 현재 소스 버전만 읽고, `--run`은 대상마다 일반 실행 기록을 하나씩 만든다. 적용 여부는 `tests/run/test_business_flow_invocation.py`가 확인한다.
897
+
880
898
  The JSON boundary validates artifact schemas and atomically replaces files. Directory locks merge concurrent knowledge contributions and task links. Claims found in another project's knowledge store retain that owner; lookup does not copy them into another canonical store. A retry creates another execution id, and the original baseline and reports remain available.
881
899
 
882
900
  ## Linked work records
@@ -891,6 +909,7 @@ read-only. `schemas/doyouknow-v1.schema.json` defines normalized write inputs.
891
909
  Existing `memory-book/` notes, manager state, task artifacts, and shared business
892
910
  knowledge retain their current owners. Explicit `sync` collects memory, manager
893
911
  and manager-registered project task references; `list` reads current projections.
912
+ `sync`는 프로젝트 그룹 등록부의 프로젝트에서 업무 흐름 실행 기록(`.okstra/business/executions/<id>/execution.json`)도 `business` 수집원으로 읽는다. 실행 기록이 원본이고 그래프에는 질문별 최신 설명의 투영만 둔다. `okstra doyouknow view`가 쓰는 `doyouknow/view/<safe-project-group>/index.html`은 실행할 때마다 다시 쓰는 파생 뷰다.
894
913
  Native memory and manager writes request registration after their original save;
895
914
  failures preserve identity-only pending UUIDs separately from SQLite. The
896
915
  `pending/`, `registrations/` and `refusals/` directories under `doyouknow/` hold
package/docs/cli.md CHANGED
@@ -324,6 +324,25 @@ New reviews publish version-2 completion markers bound to their integrity audit;
324
324
  historical version-1 completion markers remain verifiable. This detects observed
325
325
  mutations; it is not an operating-system write sandbox or proof of review quality.
326
326
 
327
+ # 프로젝트 그룹 명령
328
+
329
+ `okstra project-group`은 이름 붙은 그룹에 속한 프로젝트 루트를 사용자 홈에 등록한다. 실행을 시작하지 않으며, 한 프로젝트를 여러 그룹에 등록할 수 있다.
330
+
331
+ ```bash
332
+ okstra project-group add --project-group <name> --project-id <project-id> --project-root <abs-path>
333
+ okstra project-group remove --project-group <name> --project-id <project-id>
334
+ okstra project-group show --project-group <name>
335
+ okstra project-group list
336
+ ```
337
+
338
+ 기본 출력은 JSON이고 `--text`는 고정 텍스트 필드를 출력한다. 실패하면 `{"ok": false, "reason": ...}`를 출력하고 종료 코드 1을 돌려준다.
339
+
340
+ - `add`는 `added`(새 등록 여부)와 `changed`(파일 변경 여부)를 돌려준다. 같은 프로젝트를 같은 루트로 다시 등록하면 파일을 쓰지 않는다. 다른 루트로 등록하면 `projectRoot`를 갱신한다.
341
+ - `show`는 등록 행마다 `rootExists`로 루트 디렉터리의 현재 존재 여부를 표시한다.
342
+ - `list`는 그룹별 `projectCount`를 돌려주고, 읽지 못한 그룹 파일은 `errors`에 담아 종료 코드 1을 돌려준다.
343
+
344
+ 저장 위치와 소속 규칙은 [저장소 계약](architecture/storage-model.md)의 프로젝트 그룹 등록부 절을 따른다.
345
+
327
346
  # Linked work record commands
328
347
 
329
348
  `okstra doyouknow` stores linked work records in the user home without requiring
@@ -441,7 +460,7 @@ Settings replacement uses `schemas/doyouknow-config-v1.schema.json`:
441
460
  "schemaVersion": 1,
442
461
  "autoRegister": true,
443
462
  "scope": null,
444
- "sources": ["memory", "manager", "task"],
463
+ "sources": ["memory", "manager", "task", "business"],
445
464
  "includeProjects": [],
446
465
  "excludeProjects": [],
447
466
  "includeGroups": [],
@@ -449,6 +468,27 @@ Settings replacement uses `schemas/doyouknow-config-v1.schema.json`:
449
468
  }
450
469
  ```
451
470
 
471
+ `business` 수집원은 프로젝트 그룹 등록부(`okstra project-group`)의 모든 프로젝트에서 `okstra explain-flow` 실행 기록을 읽는다. 질문 하나가 흐름 하나이고, 상태가 `complete`·`partial`이며 모드가 `current`·`post`인 실행 중 가장 최근 것을 쓴다. 흐름마다 `flow` 노드, 용어의 `concept` 노드, 관련 프로젝트의 `project` 노드를 만들고, 프로젝트 간 관계를 `call`·`event`·`queue`·`shared-data`·`file`·`batch` 관계로 넣는다. 관계의 근거는 연결된 사실의 `프로젝트:경로:줄`이고, 연결된 사실이 모두 `static`·`execution-verified`이면 `observed`, 아니면 `candidate`다. 단계·용어·사실·미확인 구간·소스 버전은 수집원의 `metadata`에 담기며, 사실의 소스 발췌문은 담지 않는다.
472
+
473
+ 실행 기록은 explain-flow가 쓰는 스키마(`schemas/business-flow-v1.schema.json`)로 읽는다. 읽지 못하거나 스키마에 맞지 않는 기록이 있으면 그 프로젝트의 결과는 `partial`과 `business-source-unavailable`이다. 뜻이나 이름이 빈 용어는 `concept` 노드를 만들지 않고 `metadata`에만 남는다. 한 프로젝트가 그룹마다 다른 루트로 등록됐으면 `conflicting-project-roots`로 `unavailable`이다. 읽지 못한 그룹 파일이 있으면 등록부 전체를 알 수 없으므로 어떤 프로젝트도 수집하지 않고 프로젝트마다 `project-group-registry-incomplete`로 `unavailable`을 돌려준다. 완료된 수집은 보지 못한 수집원을 `missing`으로 표시하므로, 루트가 하나뿐인지 확인할 수 없는 상태에서는 수집하지 않는다. `includeGroups`·`excludeGroups`는 메모리 북 항목에만 적용되고 이 수집원은 `includeProjects`·`excludeProjects`만 따른다. 설정 파일이 없을 때의 기본 `sources`에는 `business`가 포함된다. 이미 저장한 설정 파일에는 `business`를 직접 추가해야 한다. 적용 여부는 `tests/doyouknow/test_business_sources.py`가 확인한다.
474
+
475
+ ## 프로젝트 그룹 화면
476
+
477
+ ```bash
478
+ okstra doyouknow view --project-group <name>
479
+ ```
480
+
481
+ 프로젝트 그룹 하나의 프로젝트 관계, 업무 흐름, 조사 범위, 연결 기록을 HTML 파일 하나로 만든다. 출력은 `<okstra-home>/doyouknow/view/<safe-project-group>/index.html`이고 `viewPath`·`viewUrl`과 프로젝트·흐름·관계·기록 수를 돌려준다. 외부 자원을 읽지 않는 단일 파일이다.
482
+
483
+ - 화면은 저장된 수집 결과를 읽는 파생 뷰다. 수집은 하지 않으므로 먼저 `okstra doyouknow sync`를 실행한다.
484
+ - 흐름은 그룹 구성원이 저장한 `business` 수집원이다. 관계 그래프에는 구성원이 아닌 프로젝트도 관계의 상대로 나타난다.
485
+ - 흐름마다 기록된 소스 버전을 구성원 프로젝트의 현재 상태와 비교해 `current`·`historical`·`unverified`를 표시한다. 판정은 `okstra explain-flow knowledge`의 최신성과 같은 함수(`source_freshness`)를 쓴다. 비교 대상 루트는 지식 조회와 같은 집합(실행 이력의 프로젝트에 그룹 구성원을 더한 것)에서 찾는다. 그 집합에 없는 프로젝트, 루트를 읽을 수 없는 프로젝트, 기록 당시 버전이 비어 있는 프로젝트가 섞인 흐름은 `unverified`다. 흐름의 프로젝트 목록은 수집 때 저장한 `project` 노드를 그대로 쓴다. 크기가 커서 목록에 실리지 않는 수집원은 소속 그룹을 알 수 없으므로 화면 위쪽의 수집 문제에 id만 표시한다.
486
+ - 조사 범위는 그룹의 흐름이 조사한 프로젝트(`inspectedProjects`)를 기준으로 한다. 조사되지 않은 프로젝트는 관계가 없다고 확인된 것이 아니다.
487
+ - 연결 기록은 그룹 구성원을 `project` 노드로 가진 메모리·매니저·작업 수집원이다.
488
+ - 검색은 흐름의 제목·질문·요약·용어·단계·사실·근거 위치를 대상으로 하고, 공백으로 나눈 모든 단어가 들어 있는 흐름만 남긴다.
489
+
490
+ 화면의 틀·스타일·동작은 `templates/doyouknow/group-view.template.html`, `group-view.css`, `group-view.js`에 있고 `scripts/okstra_ctl/doyouknow/group_view.py`가 데이터와 함께 합친다. 적용 여부는 `tests/doyouknow/test_group_view.py`와 `tests-js/group-view.test.mjs`가 확인한다.
491
+
452
492
  An empty include list includes all; exclusions take precedence. Group filters
453
493
  apply to Memory Book groups. A mixed-project memory is skipped before reading its
454
494
  body if any related project is excluded or outside the include list. Unassigned
@@ -189,7 +189,7 @@ The Module column below is where the command's behaviour lives — a `src/` modu
189
189
  | `task-list`, `task-show` | `scripts/okstra_ctl/task_list_cli.py`, `scripts/okstra_ctl/task_show_cli.py` | Task/run introspection for skills; `task-show` consumes the Python task read-side snapshot |
190
190
  | `resolve-task-key` | `scripts/okstra_ctl/resolve_task_key.py` | Resolve a bare task-id to candidate task-keys from the project catalog |
191
191
  | `set-work-status` | `scripts/okstra_ctl/set_work_status.py`, `scripts/okstra_ctl/direct_work.py` | Set user-managed `workStatus`, register an existing brief without a run, and share direct completion records through group memory and task queries |
192
- | `doyouknow` | `scripts/okstra_ctl/doyouknow/cli.py`, `source_store.py`, `sources/` | Store manual records; configure, collect and list memory, manager and project-task source projections |
192
+ | `doyouknow` | `scripts/okstra_ctl/doyouknow/cli.py`, `source_store.py`, `sources/` | Store manual records; configure, collect and list memory, manager and project-task source projections. `sources/business.py`는 프로젝트 그룹에 등록된 프로젝트의 업무 흐름 실행 기록을 흐름·용어·프로젝트 관계로 수집한다. `group_view.py`는 `okstra doyouknow view`로 그룹 하나의 관계·흐름·조사 범위·연결 기록을 `templates/doyouknow/`의 틀·스타일·스크립트와 합쳐 HTML 한 파일로 쓴다 |
193
193
  | `time-report`, `log-report`, `error-report`, `error-zip` | `scripts/okstra_ctl/time_report.py`, `scripts/okstra_ctl/log_report.py`, `scripts/okstra_ctl/error_report.py`, `scripts/okstra_ctl/error_zip.py` | Read-side task runtime, wrapper log, and error aggregation helpers |
194
194
  | `run-audit` | `scripts/okstra_ctl/run_audit.py` | Anomaly detection — checks run artifacts against progress invariants and reports invariant violations, read-only (Python: `okstra_ctl.run_audit`) |
195
195
  | `worker-liveness` | `scripts/okstra_ctl/worker_liveness.py` | Report whether pending workers are still alive, so the lead's poll ends a stalled wait early instead of paying the deadline (Python: `okstra_ctl.worker_liveness`) |
@@ -223,6 +223,7 @@ The Module column below is where the command's behaviour lives — a `src/` modu
223
223
  | `container` | `scripts/okstra_ctl/container.py` | Container lifecycle shim; `--text` is the command-specific model projection and machine mode remains JSON |
224
224
  | `code-review` | `scripts/okstra_ctl/code_review_target.py` | `okstra code-review target` thin shim into `scripts/okstra_ctl/code_review_target.py` — resolves what one implementation stage's or one branch's review reads (worktree, branch, base/head commits) and where its result file goes, for the okstra-code-review skill. Read-only; creates no directory or file |
225
225
  | `manager` | `scripts/okstra_ctl/manager_cli.py` | Cross-project manager; fixed text is the default and `--json` selects machine output |
226
+ | `project-group` | `scripts/okstra_ctl/project_group_cli.py`, `project_group.py` | 이름 붙은 프로젝트 그룹에 속한 프로젝트 루트를 등록·해제·조회한다. 기본 출력은 JSON이고 `--text`가 고정 텍스트를 고른다 |
226
227
  | `mcp` | `scripts/okstra_ctl/mcp_cli.py` | `okstra mcp <add\|list\|remove\|check>` — validates and writes project MCP server declarations in `.okstra/project.json` `mcpServers` (name, description, tools, aliases), and reports per provider whether each declared server is `reachable`, `disabled`, `missing`, or `unknown`; `check` and prepare list each provider CLI's servers through `ProviderSpec.mcp_inventory` with no inference call |
227
228
 
228
229
  `src/lib/python-helper.mts` centralizes Node → Python execution so nothing duplicates subprocess wiring.
@@ -789,6 +790,6 @@ Clarifications now live in the unified `## 1. Clarification Items` table. Deprec
789
790
 
790
791
  ## Business flow runtime
791
792
 
792
- `scripts/okstra_ctl/business_flow/` implements standalone explanations and optional task integration. `contracts.py` owns requests and artifact-schema access; `source.py` captures candidate source versions and verifies excerpts; `store.py` owns knowledge merging, selection, freshness and conflicts; `invocation.py` prepares and executes the investigator; `engine.py` accepts audited results and coordinates comparison/reconciliation; `report.py` renders the shared accepted result; `hooks.py` connects common preparation and validated completion; `cli.py` exposes `okstra explain-flow`.
793
+ `scripts/okstra_ctl/business_flow/` implements standalone explanations and optional task integration. `contracts.py` owns requests and artifact-schema access; `source.py` captures candidate source versions and verifies excerpts; `store.py` owns knowledge merging, selection, freshness and conflicts; `invocation.py` prepares and executes the investigator; `engine.py` accepts audited results and coordinates comparison/reconciliation; `report.py` renders the shared accepted result; `history.py`는 질문별로 가장 최근에 수락된 설명을 고르고(doyouknow의 `business` 수집원과 전수 조사가 함께 쓴다) `sweep.py`는 프로젝트 그룹의 질문 목록을 계획·실행하는 `okstra explain-flow sweep`을 구현한다; `hooks.py` connects common preparation and validated completion; `cli.py` exposes `okstra explain-flow`.
793
794
 
794
795
  `scripts/okstra_ctl/agent/standalone.py` is shared by standalone prompt materialization and business investigation. It composes existing assignment resolution, duty snapshots and invocation preparation without importing the command-line parser. The public skill is `skills/okstra-explain-flow/SKILL.md`, its behaviour spec is `docs/skills/okstra-explain-flow.md`, and both report templates and `schemas/business-flow-v1.schema.json` ship through the existing runtime build.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "okstra",
3
- "version": "0.233.0",
3
+ "version": "0.234.0",
4
4
  "description": "Host-aware multi-provider cross-verification orchestrator runtime and agent skills.",
5
5
  "license": "MIT",
6
6
  "author": "devonshin",
@@ -1,5 +1,5 @@
1
1
  {
2
- "package": "0.233.0",
3
- "builtAt": "2026-11-15T10:23:38.395Z",
2
+ "package": "0.234.0",
3
+ "builtAt": "2026-11-15T13:56:18.119Z",
4
4
  "repoRoot": "/home/runner/work/okstra/okstra"
5
5
  }
@@ -5,11 +5,11 @@ import json
5
5
  import sys
6
6
  from pathlib import Path
7
7
 
8
- from ..json_boundary import JsonBoundaryError
9
- from ..report_language import resolve_report_language
10
- from .contracts import BusinessFlowError, FlowRequest
8
+ from ..json_boundary import JsonBoundaryError, external_user_json_source, load_external_json
9
+ from .contracts import BusinessFlowError, FlowRequest, flow_report_language
11
10
  from .engine import explain_flow, load_execution, rerun_explanation
12
11
  from .store import query_knowledge
12
+ from .sweep import plan_sweep, run_sweep
13
13
 
14
14
 
15
15
  def build_parser() -> argparse.ArgumentParser:
@@ -29,6 +29,11 @@ def build_parser() -> argparse.ArgumentParser:
29
29
  help="existing read-only verification record",
30
30
  )
31
31
  explain.add_argument("--host-runtime", default="claude-code")
32
+ explain.add_argument(
33
+ "--project-group",
34
+ default="",
35
+ help="limit candidate projects to this registered project group",
36
+ )
32
37
  explain.add_argument("--project-root", type=Path, default=Path.cwd())
33
38
  explain.add_argument("--json", action="store_true")
34
39
  parser = argparse.ArgumentParser(prog="okstra explain-flow", parents=[explain])
@@ -42,11 +47,22 @@ def build_parser() -> argparse.ArgumentParser:
42
47
  "knowledge", help="query relevant shared business knowledge"
43
48
  )
44
49
  knowledge.add_argument("--query", required=True)
50
+ knowledge.add_argument("--project-group", default="")
45
51
  rerun = commands.add_parser(
46
52
  "rerun", help="retry only an explanation and retain its history"
47
53
  )
48
54
  rerun.add_argument("--execution", required=True)
49
55
  rerun.add_argument("--source-root", type=Path)
56
+ sweep = commands.add_parser(
57
+ "sweep", help="plan or run explanations for a list of questions across a project group"
58
+ )
59
+ sweep.add_argument("--project-group", required=True)
60
+ sweep.add_argument("--questions", type=Path, help='JSON array of {"projectId", "question"}')
61
+ sweep.add_argument("--stale", action="store_true", help="also explain stored flows whose source changed")
62
+ sweep.add_argument("--run", action="store_true", help="call the investigator for every planned target")
63
+ sweep.add_argument("--report-language", default="")
64
+ sweep.add_argument("--host-runtime", default="claude-code")
65
+ sweep.add_argument("--json", action="store_true")
50
66
  status = commands.add_parser("status", help="inspect an explanation execution")
51
67
  status.add_argument("--execution", required=True)
52
68
  for child in (knowledge, rerun, status):
@@ -66,6 +82,7 @@ def main(argv: list[str] | None = None) -> int:
66
82
  "knowledge",
67
83
  "rerun",
68
84
  "status",
85
+ "sweep",
69
86
  "-h",
70
87
  "--help",
71
88
  }
@@ -83,14 +100,18 @@ def main(argv: list[str] | None = None) -> int:
83
100
  args.task_key,
84
101
  args.baseline,
85
102
  args.source_root,
86
- args.report_language
87
- or resolve_report_language(args.project_root, {}, {}),
103
+ flow_report_language(args.project_root, args.report_language),
88
104
  tuple(args.source_artifact),
89
105
  args.host_runtime,
106
+ args.project_group,
90
107
  )
91
108
  )
92
109
  elif args.command == "knowledge":
93
- result = query_knowledge(args.project_root, args.query)
110
+ result = query_knowledge(
111
+ args.project_root, args.query, project_group=args.project_group
112
+ )
113
+ elif args.command == "sweep":
114
+ result = _sweep(args)
94
115
  elif args.command == "rerun":
95
116
  result = rerun_explanation(
96
117
  args.project_root, args.execution, source_root=args.source_root
@@ -108,7 +129,40 @@ def main(argv: list[str] | None = None) -> int:
108
129
  return 1
109
130
 
110
131
 
132
+ def _sweep(args: argparse.Namespace) -> dict:
133
+ if args.questions is None and not args.stale:
134
+ raise BusinessFlowError("sweep needs --questions, --stale, or both")
135
+ questions = (
136
+ load_external_json(
137
+ external_user_json_source(args.questions), artifact="sweep questions", max_bytes=2_000_000
138
+ )
139
+ if args.questions
140
+ else []
141
+ )
142
+ plan = plan_sweep(args.project_group, questions, stale=args.stale)
143
+ if not args.run:
144
+ return {**plan, "status": "planned"}
145
+ return run_sweep(plan, report_language=args.report_language, host_runtime=args.host_runtime)
146
+
147
+
111
148
  def render_result(result: dict) -> str:
149
+ if "targets" in result:
150
+ lines = [
151
+ "Business Flow Sweep",
152
+ f"Project group: {result['projectGroup']}",
153
+ f"Status: {result['status']}",
154
+ f"Targets: {len(result['targets'])}; skipped as current: {len(result['skipped'])}",
155
+ ]
156
+ rows = result.get("results", result["targets"])
157
+ for row in rows:
158
+ outcome = f" -> {row['status']} {row['executionId'] or '(no record)'}" if "status" in row else ""
159
+ lines.append(f"- {row['projectId']} ({row['reason']}): {row['question']}{outcome}")
160
+ if row.get("error"):
161
+ lines.append(f" - Error: {row['error']}")
162
+ lines.extend(f"- Problem: {problem}" for problem in result["problems"])
163
+ if result["status"] == "planned":
164
+ lines.append("Nothing was explained. Add --run to call the investigator for each target.")
165
+ return "\n".join(lines)
112
166
  if "claims" in result:
113
167
  lines = ["Shared Business Knowledge", ""]
114
168
  for row in result["claims"]:
@@ -7,6 +7,7 @@ from datetime import datetime, timezone
7
7
  from pathlib import Path
8
8
  from typing import Any, Literal, TypedDict
9
9
 
10
+ from ..report_language import resolve_report_language
10
11
  from ..json_boundary import load_owned_object, write_owned_object_atomic
11
12
  from ..paths import find_asset_root
12
13
  from ..report_language import is_language_tag
@@ -112,7 +113,7 @@ class SourceSnapshot(_SourceSnapshotRequired, total=False):
112
113
  statusDigest: str
113
114
 
114
115
 
115
- class FlowRequestPayload(TypedDict):
116
+ class _FlowRequestPayloadRequired(TypedDict):
116
117
  project_root: str
117
118
  question: str
118
119
  mode: str
@@ -124,6 +125,10 @@ class FlowRequestPayload(TypedDict):
124
125
  host_runtime: str
125
126
 
126
127
 
128
+ class FlowRequestPayload(_FlowRequestPayloadRequired, total=False):
129
+ project_group: str
130
+
131
+
127
132
  class _FlowExecutionRequired(TypedDict):
128
133
  schemaVersion: int
129
134
  id: str
@@ -204,6 +209,7 @@ class FlowRequest:
204
209
  report_language: str = "en"
205
210
  source_artifacts: tuple[str, ...] = ()
206
211
  host_runtime: str = "claude-code"
212
+ project_group: str = ""
207
213
 
208
214
  def validate(self) -> None:
209
215
  if not self.project_root.is_dir() or not self.question.strip():
@@ -220,6 +226,11 @@ class FlowRequest:
220
226
  )
221
227
 
222
228
 
229
+ def flow_report_language(project_root: Path, requested: str) -> str:
230
+ """The requested report language, or the project's configured one when none was given."""
231
+ return requested or resolve_report_language(project_root, {}, {})
232
+
233
+
223
234
  def now_iso() -> str:
224
235
  return datetime.now(timezone.utc).isoformat(timespec="seconds")
225
236
 
@@ -140,7 +140,9 @@ def _investigate(
140
140
  request.project_root, result["facts"], execution["projects"], producer
141
141
  )
142
142
  if result["resolutions"]:
143
- resolve_conflicts(request.project_root, result["resolutions"], producer)
143
+ resolve_conflicts(
144
+ request.project_root, result["resolutions"], producer, request.project_group
145
+ )
144
146
  write_artifact(path, execution, "execution")
145
147
  _reinvestigate_conflicts(request, execution, path, executor)
146
148
  if request.mode != "contribute":
@@ -349,7 +351,7 @@ def _validate_reconciliation(
349
351
  raise BusinessFlowError(
350
352
  "conflict resolutions require a dedicated reinvestigation"
351
353
  )
352
- knowledge = read_shared_knowledge(request.project_root)
354
+ knowledge = read_shared_knowledge(request.project_root, request.project_group)
353
355
  validate_resolutions(knowledge, result["resolutions"])
354
356
  claims = {row["id"]: row for row in knowledge["claims"]}
355
357
  states = {row["projectId"]: row["digest"] for row in projects}
@@ -440,7 +442,11 @@ def _investigation_context(
440
442
  if baseline
441
443
  else "",
442
444
  "knowledge": query_knowledge(
443
- request.project_root, request.question, request.source_root
445
+ request.project_root,
446
+ request.question,
447
+ request.source_root,
448
+ request.project_group,
449
+ members_only=request.mode != "reconcile",
444
450
  ),
445
451
  }
446
452
 
@@ -453,7 +459,10 @@ def _reinvestigate_conflicts(
453
459
  conflict_keys = {
454
460
  row["key"]
455
461
  for row in query_knowledge(
456
- request.project_root, request.question, request.source_root
462
+ request.project_root,
463
+ request.question,
464
+ request.source_root,
465
+ request.project_group,
457
466
  )["claims"]
458
467
  if row["status"] == "conflict"
459
468
  }
@@ -477,7 +486,10 @@ def _reinvestigate_conflicts(
477
486
  unresolved = [
478
487
  row["key"]
479
488
  for row in query_knowledge(
480
- request.project_root, request.question, request.source_root
489
+ request.project_root,
490
+ request.question,
491
+ request.source_root,
492
+ request.project_group,
481
493
  )["claims"]
482
494
  if row["status"] == "conflict"
483
495
  ]
@@ -0,0 +1,60 @@
1
+ """Which stored explanation currently answers each question of a project."""
2
+ from __future__ import annotations
3
+
4
+ import hashlib
5
+ from collections.abc import Callable
6
+ from pathlib import Path
7
+ from typing import cast
8
+
9
+ from ..json_boundary import JsonBoundaryError
10
+ from .contracts import BusinessFlowError, FlowExecution, business_root, read_artifact
11
+
12
+ # `pre` describes the state before a change, and `contribute` / `reconcile` are not explanations.
13
+ DESCRIBING_MODES = ("current", "post")
14
+ ACCEPTED_STATUSES = ("complete", "partial")
15
+
16
+
17
+ def flow_id(question: str) -> str:
18
+ """One question is one flow; a later explanation of it replaces the earlier one."""
19
+ normalized = " ".join(question.casefold().split())
20
+ return "flow-" + hashlib.sha256(normalized.encode("utf-8")).hexdigest()[:16]
21
+
22
+
23
+ def _read(path: Path) -> FlowExecution:
24
+ return cast(FlowExecution, read_artifact(path, "execution"))
25
+
26
+
27
+ def latest_explanations(
28
+ project_root: Path,
29
+ *,
30
+ read: Callable[[Path], FlowExecution] = _read,
31
+ unreadable: tuple[type[Exception], ...] = (),
32
+ ) -> tuple[dict[str, tuple[Path, FlowExecution]], int]:
33
+ """The newest accepted explanation per `flow_id`, and how many records could not be read.
34
+
35
+ `read` must validate a record against the execution schema; `unreadable` names the
36
+ extra errors that reader raises for a record it refuses.
37
+ """
38
+ executions = business_root(project_root) / "executions"
39
+ latest: dict[str, tuple[Path, FlowExecution]] = {}
40
+ refused = 0
41
+ for directory in sorted(executions.iterdir()) if executions.is_dir() else []:
42
+ if not directory.is_dir():
43
+ continue
44
+ path = directory / "execution.json"
45
+ try:
46
+ execution = read(path)
47
+ if execution["status"] not in ACCEPTED_STATUSES or execution["request"]["mode"] not in DESCRIBING_MODES:
48
+ continue
49
+ if "result" not in execution:
50
+ raise BusinessFlowError("accepted explanation has no result")
51
+ key = flow_id(execution["request"]["question"])
52
+ if key not in latest or execution["createdAt"] > latest[key][1]["createdAt"]:
53
+ latest[key] = (path, execution)
54
+ except (BusinessFlowError, JsonBoundaryError, OSError, RecursionError, *unreadable):
55
+ refused += 1
56
+ return latest, refused
57
+
58
+
59
+ def recorded_source_states(execution: FlowExecution) -> dict[str, dict[str, str]]:
60
+ return {row["projectId"]: {"head": row["head"], "digest": row["digest"]} for row in execution["projects"]}
@@ -10,6 +10,7 @@ from typing import Any
10
10
  from ..json_boundary import load_owned_object
11
11
  from ..manager_store import discover_projects
12
12
  from ..paths import okstra_home
13
+ from ..project_group import ProjectGroupError, read_group
13
14
  from .contracts import (
14
15
  BusinessEvidence,
15
16
  BusinessFlowError,
@@ -21,6 +22,22 @@ from .contracts import (
21
22
 
22
23
 
23
24
  def candidate_projects(request: FlowRequest) -> list[ProjectCandidate]:
25
+ """Projects an investigation inspects: the group's members when a group is set."""
26
+ # A reconciliation settles a conflict whose other side may sit outside the group.
27
+ grouped = bool(request.project_group) and request.mode != "reconcile"
28
+ return _projects(request, with_run_history=not grouped)
29
+
30
+
31
+ def knowledge_projects(request: FlowRequest) -> list[ProjectCandidate]:
32
+ """Projects whose knowledge stores are read: run history plus the group's members.
33
+
34
+ A group only adds stores here. Conflicts and their resolutions are judged over this
35
+ set, so a group never hides one side of a stored resolution.
36
+ """
37
+ return _projects(request, with_run_history=True)
38
+
39
+
40
+ def _projects(request: FlowRequest, *, with_run_history: bool) -> list[ProjectCandidate]:
24
41
  root = request.project_root.resolve()
25
42
  config = root / ".okstra" / "project.json"
26
43
  project_id = root.name
@@ -30,8 +47,10 @@ def candidate_projects(request: FlowRequest) -> list[ProjectCandidate]:
30
47
  or project_id
31
48
  )
32
49
  candidates = {
33
- row["projectId"]: {"projectId": row["projectId"], "root": row["projectRoot"]}
34
- for row in discover_projects(okstra_home())
50
+ name: {"projectId": name, "root": registered_root}
51
+ for name, registered_root in registered_roots(
52
+ request.project_group, with_run_history=with_run_history
53
+ ).items()
35
54
  }
36
55
  candidates[project_id] = {
37
56
  "projectId": project_id,
@@ -40,6 +59,20 @@ def candidate_projects(request: FlowRequest) -> list[ProjectCandidate]:
40
59
  return sorted(candidates.values(), key=lambda row: row["projectId"])
41
60
 
42
61
 
62
+ def registered_roots(
63
+ project_group: str, *, with_run_history: bool, home: Path | None = None
64
+ ) -> dict[str, str]:
65
+ """The root of each projectId from run history and the group's registration; the group's row wins."""
66
+ home = home or okstra_home()
67
+ registered = discover_projects(home) if with_run_history else []
68
+ if project_group:
69
+ try:
70
+ registered += read_group(home, project_group)["projects"]
71
+ except ProjectGroupError as exc:
72
+ raise BusinessFlowError(str(exc)) from exc
73
+ return {row["projectId"]: row["projectRoot"] for row in registered}
74
+
75
+
43
76
  def git_output(root: Path, *args: str) -> bytes:
44
77
  result = subprocess.run(
45
78
  ["git", "-C", str(root), *args], capture_output=True, check=False