onto-mcp 0.4.7 → 0.4.9
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.
- package/.onto/processes/review/prompt-execution-runner-contract.md +1 -1
- package/AGENTS.md +57 -67
- package/CLAUDE.md +4 -13
- package/README.md +128 -424
- package/dist/core-api/review-api.js +1 -1
- package/dist/core-runtime/{review → cli}/review-invocation-runner.js +336 -6
- package/dist/core-runtime/cli/review-invoke.js +5 -339
- package/package.json +5 -1
|
@@ -143,7 +143,7 @@ runtime은 아래만 한다.
|
|
|
143
143
|
|
|
144
144
|
현재 TS core bounded step은 host-facing command가 아니라 Core API가 호출하는
|
|
145
145
|
내부 runtime step이다. Canonical product entrypoint는 `onto_review`이며,
|
|
146
|
-
prompt execution dispatch는 `src/core-runtime/
|
|
146
|
+
prompt execution dispatch는 `src/core-runtime/cli/review-invocation-runner.ts`
|
|
147
147
|
에서 `src/core-runtime/cli/run-review-prompt-execution.ts`로 전달된다.
|
|
148
148
|
|
|
149
149
|
옵션:
|
package/AGENTS.md
CHANGED
|
@@ -38,7 +38,7 @@
|
|
|
38
38
|
|
|
39
39
|
8. **최적화가 재설계로 커지면**, 원래 성공기준("품질 손상 없음")을 새 스코프에서 다시 측정한다.
|
|
40
40
|
|
|
41
|
-
> 위 규칙들의 구조적 강제(가드)는 [docs/architecture/structural-guardrails-enforcement.md](docs/architecture/structural-guardrails-enforcement.md)를 따른다.
|
|
41
|
+
> 위 규칙들의 구조적 강제(가드)는 [docs/architecture/structural-guardrails-enforcement.md](docs/architecture/structural-guardrails-enforcement.md)를 따른다. G1~G6 구현 완료 — 실행 명령·불변식 매핑은 [INVARIANTS.md](INVARIANTS.md) §강제 수단 구현 현황. 빠른 일괄 확인: `npm run check:invariant-drift`.
|
|
42
42
|
|
|
43
43
|
---
|
|
44
44
|
|
|
@@ -60,14 +60,14 @@
|
|
|
60
60
|
|
|
61
61
|
| 순위 | 파일 | 폴더 |
|
|
62
62
|
|---|---|---|
|
|
63
|
-
| 1 | [core-lexicon.yaml](
|
|
64
|
-
| 2 | [ontology-as-code-guideline.md](
|
|
65
|
-
| 2 | [llm-native-development-guideline.md](
|
|
66
|
-
| 2 | [non-specialist-communication-guideline.md](
|
|
67
|
-
| 2 | [product-locality-principle.md](
|
|
68
|
-
| 3 | [productization-charter.md](
|
|
69
|
-
| 4 | [llm-runtime-interface-principles.md](
|
|
70
|
-
| 4 | [ontology-as-code-naming-charter.md](
|
|
63
|
+
| 1 | [core-lexicon.yaml](.onto/authority/core-lexicon.yaml) | .onto/authority/ |
|
|
64
|
+
| 2 | [ontology-as-code-guideline.md](.onto/principles/ontology-as-code-guideline.md) | .onto/principles/ |
|
|
65
|
+
| 2 | [llm-native-development-guideline.md](.onto/principles/llm-native-development-guideline.md) | .onto/principles/ |
|
|
66
|
+
| 2 | [non-specialist-communication-guideline.md](.onto/principles/non-specialist-communication-guideline.md) | .onto/principles/ |
|
|
67
|
+
| 2 | [product-locality-principle.md](.onto/principles/product-locality-principle.md) | .onto/principles/ |
|
|
68
|
+
| 3 | [productization-charter.md](.onto/principles/productization-charter.md) | .onto/principles/ |
|
|
69
|
+
| 4 | [llm-runtime-interface-principles.md](.onto/principles/llm-runtime-interface-principles.md) | .onto/principles/ |
|
|
70
|
+
| 4 | [ontology-as-code-naming-charter.md](.onto/principles/ontology-as-code-naming-charter.md) | .onto/principles/ |
|
|
71
71
|
| 5 | 기능별 계약 | .onto/processes/{feature}/*.md |
|
|
72
72
|
| 6 | 타입·구현 | src/core-runtime/ |
|
|
73
73
|
| 7 | 기능 프로세스·역할 정의 | .onto/processes/review/*.md, .onto/roles/*.md |
|
|
@@ -75,59 +75,47 @@
|
|
|
75
75
|
|
|
76
76
|
### 폴더 구조
|
|
77
77
|
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
| `.onto/domains/` | 선택 가능한 domain 문서와 domain-specific profile |
|
|
83
|
-
| `.onto/processes/` | shared/review/reconstruct/future process contracts |
|
|
84
|
-
| `.onto/roles/` | review lens와 synthesize role definition |
|
|
85
|
-
| `src/core-runtime/` | executable review/reconstruct runtime |
|
|
86
|
-
| `src/core-api/` | MCP와 harness가 호출하는 Core API facade |
|
|
87
|
-
| `src/mcp/` | MCP tool schema와 server entrypoint |
|
|
88
|
-
| `docs/architecture/` | 현재 architecture, continuation, operational notes |
|
|
89
|
-
| `docs/decisions/` | accepted direction과 architecture decision |
|
|
90
|
-
| `development-records/` | 개발 이력, 감사, 설계, handoff 기록 |
|
|
91
|
-
|
|
92
|
-
`.onto/review/*`는 실행 세션 산출물이다. 세션 artifact 자체를 조사하는 작업이 아니라면
|
|
93
|
-
runtime naming, code audit, docs audit, migration 대상 검색에서 항상 제외한다.
|
|
78
|
+
폴더 구조·배치 원칙의 SSOT는
|
|
79
|
+
[docs/architecture/repo-layout.md](docs/architecture/repo-layout.md)다.
|
|
80
|
+
top-level 역할 표, `src/core-runtime/` 내부 구조, `.onto/review/*` 세션 산출물
|
|
81
|
+
제외 규칙을 그 문서가 소유한다. 여기 재서술하지 않는다.
|
|
94
82
|
|
|
95
83
|
target material 관련 작업 시 추가로 읽을 문서:
|
|
96
84
|
|
|
97
|
-
1. [target-material-kind-contract.md](
|
|
85
|
+
1. [target-material-kind-contract.md](.onto/processes/shared/target-material-kind-contract.md)
|
|
98
86
|
|
|
99
87
|
`review` 작업 시 추가로 읽을 문서:
|
|
100
88
|
|
|
101
|
-
1. [productized-live-path.md](
|
|
102
|
-
2. [review-execution-ux-contract.md](
|
|
103
|
-
3. [lens-registry.md](
|
|
104
|
-
4. [interpretation-contract.md](
|
|
105
|
-
5. [binding-contract.md](
|
|
106
|
-
6. [lens-prompt-contract.md](
|
|
107
|
-
7. [synthesize-prompt-contract.md](
|
|
108
|
-
8. [issue-stance-deliberation-contract.md](
|
|
109
|
-
9. [shared-phenomenon-contract.md](
|
|
110
|
-
10. [material-issue-contract.md](
|
|
89
|
+
1. [productized-live-path.md](.onto/processes/review/productized-live-path.md)
|
|
90
|
+
2. [review-execution-ux-contract.md](.onto/processes/review/review-execution-ux-contract.md)
|
|
91
|
+
3. [lens-registry.md](.onto/processes/review/lens-registry.md)
|
|
92
|
+
4. [interpretation-contract.md](.onto/processes/review/interpretation-contract.md)
|
|
93
|
+
5. [binding-contract.md](.onto/processes/review/binding-contract.md)
|
|
94
|
+
6. [lens-prompt-contract.md](.onto/processes/review/lens-prompt-contract.md)
|
|
95
|
+
7. [synthesize-prompt-contract.md](.onto/processes/review/synthesize-prompt-contract.md)
|
|
96
|
+
8. [issue-stance-deliberation-contract.md](.onto/processes/review/issue-stance-deliberation-contract.md)
|
|
97
|
+
9. [shared-phenomenon-contract.md](.onto/processes/review/shared-phenomenon-contract.md)
|
|
98
|
+
10. [material-issue-contract.md](.onto/processes/review/material-issue-contract.md)
|
|
111
99
|
11. selected domain `problem_framing_profile.md` if `session_domain` is not `none`
|
|
112
|
-
12. [execution-preparation-artifacts.md](
|
|
113
|
-
13. [review-target-profile-contract.md](
|
|
114
|
-
14. [review-context-manifest-contract.md](
|
|
115
|
-
15. [prompt-execution-runner-contract.md](
|
|
116
|
-
16. [pre-dispatch-contracts.md](
|
|
117
|
-
17. [pipeline-execution-ledger-contract.md](
|
|
118
|
-
18. [record-contract.md](
|
|
119
|
-
19. [record-field-mapping.md](
|
|
120
|
-
20. [review-continuation-surface.md](
|
|
121
|
-
21. [mcp-native-tool-surface.md](
|
|
100
|
+
12. [execution-preparation-artifacts.md](.onto/processes/review/execution-preparation-artifacts.md)
|
|
101
|
+
13. [review-target-profile-contract.md](.onto/processes/review/review-target-profile-contract.md)
|
|
102
|
+
14. [review-context-manifest-contract.md](.onto/processes/review/review-context-manifest-contract.md)
|
|
103
|
+
15. [prompt-execution-runner-contract.md](.onto/processes/review/prompt-execution-runner-contract.md)
|
|
104
|
+
16. [pre-dispatch-contracts.md](.onto/processes/review/pre-dispatch-contracts.md)
|
|
105
|
+
17. [pipeline-execution-ledger-contract.md](.onto/processes/shared/pipeline-execution-ledger-contract.md)
|
|
106
|
+
18. [record-contract.md](.onto/processes/review/record-contract.md)
|
|
107
|
+
19. [record-field-mapping.md](.onto/processes/review/record-field-mapping.md)
|
|
108
|
+
20. [review-continuation-surface.md](docs/architecture/review-continuation-surface.md)
|
|
109
|
+
21. [mcp-native-tool-surface.md](docs/architecture/mcp-native-tool-surface.md)
|
|
122
110
|
|
|
123
111
|
`reconstruct` 작업 시 추가로 읽을 문서:
|
|
124
112
|
|
|
125
|
-
1. [reconstruct-boundary-contract.md](
|
|
126
|
-
2. [ontology-seeding-and-maturation-design.md](
|
|
127
|
-
3. [operational-ontology-seed-contract.md](
|
|
128
|
-
4. [reconstruct-contract-registry.yaml](
|
|
129
|
-
5. [reconstruct-execution-ux-contract.md](
|
|
130
|
-
6. [source-profile-contract.md](
|
|
113
|
+
1. [reconstruct-boundary-contract.md](.onto/processes/reconstruct/reconstruct-boundary-contract.md)
|
|
114
|
+
2. [ontology-seeding-and-maturation-design.md](.onto/processes/reconstruct/ontology-seeding-and-maturation-design.md)
|
|
115
|
+
3. [operational-ontology-seed-contract.md](.onto/processes/reconstruct/operational-ontology-seed-contract.md)
|
|
116
|
+
4. [reconstruct-contract-registry.yaml](.onto/processes/reconstruct/reconstruct-contract-registry.yaml)
|
|
117
|
+
5. [reconstruct-execution-ux-contract.md](.onto/processes/reconstruct/reconstruct-execution-ux-contract.md)
|
|
118
|
+
6. [source-profile-contract.md](.onto/processes/reconstruct/source-profile-contract.md)
|
|
131
119
|
7. selected source profile under `.onto/processes/reconstruct/source-profiles/`
|
|
132
120
|
|
|
133
121
|
---
|
|
@@ -136,7 +124,7 @@ target material 관련 작업 시 추가로 읽을 문서:
|
|
|
136
124
|
|
|
137
125
|
원칙은 아래 문서에 정의되어 있다. 재서술하지 않는다.
|
|
138
126
|
|
|
139
|
-
- **LLM/runtime capability boundary**: READ
|
|
127
|
+
- **LLM/runtime capability boundary**: READ `~/.codex/guides/llm-capability-boundary.md`
|
|
140
128
|
- **onto-mcp LLM/runtime 적용 규칙**: READ `.onto/principles/llm-native-development-guideline.md`
|
|
141
129
|
- **인터페이스 seat와 boundary state**: READ `.onto/principles/llm-runtime-interface-principles.md`
|
|
142
130
|
- **Ontology as Code 규칙**: READ `.onto/principles/ontology-as-code-guideline.md`
|
|
@@ -149,8 +137,8 @@ target material 관련 작업 시 추가로 읽을 문서:
|
|
|
149
137
|
|
|
150
138
|
## 4. Canonical Terms
|
|
151
139
|
|
|
152
|
-
개념 SSOT: [core-lexicon.yaml](
|
|
153
|
-
이름 규칙: [ontology-as-code-naming-charter.md](
|
|
140
|
+
개념 SSOT: [core-lexicon.yaml](.onto/authority/core-lexicon.yaml)
|
|
141
|
+
이름 규칙: [ontology-as-code-naming-charter.md](.onto/principles/ontology-as-code-naming-charter.md)
|
|
154
142
|
|
|
155
143
|
자주 쓰는 개념:
|
|
156
144
|
|
|
@@ -218,11 +206,11 @@ bounded dispatch 계약을 강제하지 못하므로 pre-dispatch에서 fail-lou
|
|
|
218
206
|
|
|
219
207
|
기준 문서:
|
|
220
208
|
|
|
221
|
-
- [lens-registry.md](
|
|
222
|
-
- [lens-prompt-contract.md](
|
|
223
|
-
- [synthesize-prompt-contract.md](
|
|
224
|
-
- [issue-stance-deliberation-contract.md](
|
|
225
|
-
- [productized-live-path.md](
|
|
209
|
+
- [lens-registry.md](.onto/processes/review/lens-registry.md)
|
|
210
|
+
- [lens-prompt-contract.md](.onto/processes/review/lens-prompt-contract.md)
|
|
211
|
+
- [synthesize-prompt-contract.md](.onto/processes/review/synthesize-prompt-contract.md)
|
|
212
|
+
- [issue-stance-deliberation-contract.md](.onto/processes/review/issue-stance-deliberation-contract.md)
|
|
213
|
+
- [productized-live-path.md](.onto/processes/review/productized-live-path.md)
|
|
226
214
|
|
|
227
215
|
---
|
|
228
216
|
|
|
@@ -272,9 +260,9 @@ bounded dispatch 계약을 강제하지 못하므로 pre-dispatch에서 fail-lou
|
|
|
272
260
|
|
|
273
261
|
관련 문서:
|
|
274
262
|
|
|
275
|
-
- [execution-preparation-artifacts.md](
|
|
276
|
-
- [record-contract.md](
|
|
277
|
-
- [record-field-mapping.md](
|
|
263
|
+
- [execution-preparation-artifacts.md](.onto/processes/review/execution-preparation-artifacts.md)
|
|
264
|
+
- [record-contract.md](.onto/processes/review/record-contract.md)
|
|
265
|
+
- [record-field-mapping.md](.onto/processes/review/record-field-mapping.md)
|
|
278
266
|
|
|
279
267
|
---
|
|
280
268
|
|
|
@@ -289,6 +277,8 @@ review tools:
|
|
|
289
277
|
- `onto_review` — review 실행
|
|
290
278
|
- `onto_prepare_review` — 실행 전 session과 prompt packet 준비
|
|
291
279
|
- `onto_review_continue` — 기존 session artifact에서 eligible frontier를 계속 실행
|
|
280
|
+
- `onto_review_round` — host orchestration(B): 지금 실행 가능한 unit과 packet 반환 (onto는 실행하지 않음)
|
|
281
|
+
- `onto_review_advance` — host orchestration(B): host가 실행한 unit 보고 → seat 검증·기록 후 다음 round 또는 record 조립
|
|
292
282
|
- `onto_review_cancel` — 실행 중 review의 cooperative cancellation 요청
|
|
293
283
|
- `onto_review_status` — 진행/상태 조회
|
|
294
284
|
- `onto_review_result` — 완료 결과 조회
|
|
@@ -307,7 +297,7 @@ reconstruct tools:
|
|
|
307
297
|
`onto mcp`는 stdio MCP 서버 시작 명령이며 단발성 review 실행 명령이 아니다.
|
|
308
298
|
`src/core-runtime/cli/review-invoke.ts`는 내부 argv adapter와 live E2E 검증 entry로만 취급한다.
|
|
309
299
|
|
|
310
|
-
관련 설정: [package.json](
|
|
300
|
+
관련 설정: [package.json](package.json), [tsconfig.json](tsconfig.json)
|
|
311
301
|
|
|
312
302
|
---
|
|
313
303
|
|
|
@@ -351,9 +341,9 @@ onto의 테스트는 evidence class를 분리한다.
|
|
|
351
341
|
|
|
352
342
|
기준 문서:
|
|
353
343
|
|
|
354
|
-
- [DD-010](
|
|
355
|
-
- [repo-layout.md](
|
|
356
|
-
- [mcp-native-tool-surface.md](
|
|
344
|
+
- [DD-010](docs/decisions/DD-010-onto-mcp-native-tool-surface.md)
|
|
345
|
+
- [repo-layout.md](docs/architecture/repo-layout.md)
|
|
346
|
+
- [mcp-native-tool-surface.md](docs/architecture/mcp-native-tool-surface.md)
|
|
357
347
|
|
|
358
348
|
---
|
|
359
349
|
|
package/CLAUDE.md
CHANGED
|
@@ -21,19 +21,10 @@
|
|
|
21
21
|
.onto/principles/ 구성: rank 2~4 개발 규범 문서 7개 (배포 제외)
|
|
22
22
|
위계 밖: development-records/ (이력/참조)
|
|
23
23
|
|
|
24
|
-
##
|
|
24
|
+
## repo / runtime 구조
|
|
25
25
|
|
|
26
|
-
|
|
27
|
-
src/core-runtime
|
|
28
|
-
|
|
29
|
-
├── discovery/ ← settings, onto home, lens registry
|
|
30
|
-
├── llm/ ← provider switcher + LLM call wrappers
|
|
31
|
-
├── review/ ← review artifact types, materializers, deliberation, route policy
|
|
32
|
-
├── logger.ts ← 공용 로거
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
- **review**: 현재 제품화 대상. context-isolated lenses, controlled deliberation, synthesize, ReviewRecord를 소유한다.
|
|
36
|
-
- **llm**: API key / OAuth / local provider selection을 단순화한 runtime boundary다.
|
|
37
|
-
- **development-records/archive/**: retired CLI/process/learning/govern/evolve material을 격리 보관한다.
|
|
26
|
+
구조 SSOT: [docs/architecture/repo-layout.md](docs/architecture/repo-layout.md)
|
|
27
|
+
— top-level 폴더 역할, `src/core-runtime/` 내부 구조, 배치 원칙, 세션 산출물
|
|
28
|
+
제외 규칙을 그 문서가 소유한다. 여기 재서술하지 않는다.
|
|
38
29
|
|
|
39
30
|
동일 순위 충돌 해소: 같은 순위 파일은 규범 내용이 중복되지 않는다. 중복 발견 시, 원칙의 성격에 부합하는 파일이 canonical이며, 나머지는 참조만 한다. 예외: 동일 개념이 서로 다른 소비 목적(구조 규칙 vs 설계 가이드)으로 필요한 경우, 각 파일의 고유 범위를 확정하고 상호 참조를 명기하여 이중 존재를 허용한다.
|