@moreih29/nexus-core 0.7.0 → 0.7.1
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/README.md
CHANGED
|
@@ -9,26 +9,25 @@
|
|
|
9
9
|
Nexus 생태계는 세 층위로 나뉩니다. `nexus-core`는 가장 아래, **Authoring layer**에 위치합니다.
|
|
10
10
|
|
|
11
11
|
```
|
|
12
|
-
Supervision
|
|
12
|
+
Supervision (reserved)
|
|
13
13
|
│ read-only
|
|
14
14
|
Execution claude-nexus ↔ opencode-nexus
|
|
15
15
|
│ read-only
|
|
16
16
|
Authoring nexus-core ← 이 저장소
|
|
17
17
|
```
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
현재 active 소비자는 두 Execution layer 하네스(`claude-nexus`, `opencode-nexus`)이며, 모두 `nexus-core`를 **read-only**로 참조합니다. Supervision layer는 외부 감독자 consumer를 위해 예약된 자리입니다(과거 nexus-code 프로젝트가 이 layer를 구현했으나 2026-04-14 archived).
|
|
20
20
|
|
|
21
21
|
| Consumer | Layer | 하는 일 |
|
|
22
22
|
|---|---|---|
|
|
23
23
|
| [`claude-nexus`](https://github.com/moreih29/claude-nexus) | Execution | Claude Code 하네스 위에서 에이전트 조립·디스패치 |
|
|
24
24
|
| [`opencode-nexus`](https://github.com/moreih29/opencode-nexus) | Execution | OpenCode 하네스 위에서 에이전트 조립·디스패치 |
|
|
25
|
-
| `nexus-code` | Supervision | Execution 세션 감독·Policy Enforcement·시각화 |
|
|
26
25
|
|
|
27
26
|
## For Consumer Repositories
|
|
28
27
|
|
|
29
28
|
> 이 저장소는 **외부 사용자가 직접 설치하는 플러그인이 아닙니다**. Nexus 하네스(`claude-nexus`, `opencode-nexus`)를 사용하려면 해당 저장소의 안내를 따르세요.
|
|
30
29
|
|
|
31
|
-
Consumer 저장소(`claude-nexus`, `opencode-nexus
|
|
30
|
+
Consumer 저장소(`claude-nexus`, `opencode-nexus`)의 LLM 에이전트가 `@moreih29/nexus-core` 버전 업그레이드를 처리해야 하는 경우, **[CONSUMING.md](./CONSUMING.md)**의 Upgrade Protocol을 참조하세요.
|
|
32
31
|
|
|
33
32
|
CONSUMING.md는 LLM 에이전트 전용 문서입니다. 사람 독자는 이 README가 더 유용합니다.
|
|
34
33
|
|
|
@@ -56,7 +55,7 @@ CONSUMING.md는 LLM 에이전트 전용 문서입니다. 사람 독자는 이 RE
|
|
|
56
55
|
- MCP server 구현 — 각 하네스 내부
|
|
57
56
|
- TypeScript 런타임 타입 — 각 하네스 내부
|
|
58
57
|
- 런타임 I/O 로직 — 각 하네스 내부
|
|
59
|
-
- Supervision 집행 로직 (`ApprovalBridge` 등) —
|
|
58
|
+
- Supervision 집행 로직 (`ApprovalBridge` 등) — 외부 Supervision consumer 내부 (현재 active consumer 없음)
|
|
60
59
|
- UI hint 필드 (`icon`, `color` 등) — 특정 소비자 결합 금지
|
|
61
60
|
|
|
62
61
|
## 원칙
|
|
@@ -70,7 +69,7 @@ CONSUMING.md는 LLM 에이전트 전용 문서입니다. 사람 독자는 이 RE
|
|
|
70
69
|
|
|
71
70
|
## Status
|
|
72
71
|
|
|
73
|
-
v0.
|
|
72
|
+
v0.7.1 (2026-04-14). 최신 release: agent-tracker namespace isolation (v0.7.0, GH #16) + nexus-code archived cleanup (v0.7.1). 상세 변경 이력은 [CHANGELOG.md](./CHANGELOG.md) 참조.
|
|
74
73
|
|
|
75
74
|
## References
|
|
76
75
|
|
|
@@ -382,7 +382,7 @@ For each agent in `manifest.json`:
|
|
|
382
382
|
|
|
383
383
|
### Neutral body + harness context synthesis
|
|
384
384
|
|
|
385
|
-
`body.md` is deliberately harness-neutral. It says things like "report to Lead" without specifying the concrete mechanism. This is intentional: the same body works across claude-nexus
|
|
385
|
+
`body.md` is deliberately harness-neutral. It says things like "report to Lead" without specifying the concrete mechanism. This is intentional: the same body works across claude-nexus and opencode-nexus because each harness injects the mechanism alongside the body.
|
|
386
386
|
|
|
387
387
|
Your harness must inject harness-specific tool awareness when activating an agent. Concretely:
|
|
388
388
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Nexus 산출물 제어 계약
|
|
2
2
|
|
|
3
|
-
이 문서는 nexus-core를 소비하는 하네스(claude-nexus, opencode-nexus
|
|
3
|
+
이 문서는 nexus-core를 소비하는 하네스(claude-nexus, opencode-nexus)가 준수해야 할 **산출물 제어 normative 계약**이다. 산출물이란 Nexus 세션 또는 프로젝트 사이클에서 생성·수정·삭제되는 모든 파일을 의미하며, 그 책임 주체·생성 조건·삭제 조건·상호운용 의무를 선언적으로 기술한다.
|
|
4
4
|
|
|
5
5
|
이 문서는 `docs/nexus-state-overview.md`와 역할을 명확히 분담한다.
|
|
6
6
|
|
|
@@ -174,7 +174,6 @@ Nexus 산출물은 생성 책임 주체에 따라 세 카테고리로 분류된
|
|
|
174
174
|
- **MUST**: `{harness-id}`는 하네스 npm package name의 마지막 segment를 사용한다.
|
|
175
175
|
- `@moreih29/claude-nexus` → `claude-nexus`
|
|
176
176
|
- `@moreih29/opencode-nexus` → `opencode-nexus`
|
|
177
|
-
- `@moreih29/nexus-code` → `nexus-code`
|
|
178
177
|
- **MUST NOT**: nexus-core는 하네스 id 레지스트리를 소유하지 않는다. 규약은 각 하네스 `CONSUMING.md` / `README.md`에서 자기 id를 선언한다.
|
|
179
178
|
|
|
180
179
|
### Extension 파일 의무
|
|
@@ -251,7 +250,7 @@ consumer는 이 파일을 starting point로 삼아 자신의 실제 extension
|
|
|
251
250
|
|
|
252
251
|
**shared-purpose file**이란 두 개 이상의 하네스가 **같은 목적**(예: agent lifecycle tracking)을 위해 **같은 파일명**으로 **각자의 harness-local namespace**에 두는 파일이다. 공통 state(`plan.json`, `tasks.json`)와 달리 단일 공유 경로가 아니라 하네스별 namespace 하위에 각각 존재한다.
|
|
253
252
|
|
|
254
|
-
nexus-core는 shared-purpose file에 대해 **최소 공통 schema contract**를 선언한다. 이 contract는 cross-harness aggregator
|
|
253
|
+
nexus-core는 shared-purpose file에 대해 **최소 공통 schema contract**를 선언한다. 이 contract는 cross-harness aggregator가 여러 하네스의 파일을 일관되게 읽을 수 있도록 보장한다.
|
|
255
254
|
|
|
256
255
|
### 최소 공통 필드 contract
|
|
257
256
|
|
|
@@ -275,9 +274,9 @@ nexus-core는 shared-purpose file에 대해 **최소 공통 schema contract**를
|
|
|
275
274
|
|
|
276
275
|
향후 신규 shared-purpose file을 추가할 때는 반드시 이 섹션에 등록해야 한다. 등록 없이 여러 하네스가 동일 파일명을 독립적으로 사용하는 것은 MUST NOT 허용되어서는 안 된다.
|
|
277
276
|
|
|
278
|
-
### Supervision
|
|
277
|
+
### Supervision aggregation 전제 (reserved)
|
|
279
278
|
|
|
280
|
-
|
|
279
|
+
향후 Supervision consumer가 cross-harness aggregation을 구현할 경우, `.nexus/state/*/agent-tracker.json` glob 모델로 각 하네스의 파일을 개별적으로 읽는다. 단일 공통 경로 파일 모델이 아니다. 이 glob 모델이 동작하려면 각 하네스가 정확히 `{harness-id}/agent-tracker.json` 경로에 파일을 기록해야 한다. (과거 nexus-code가 이 역할을 할 예정이었으나 2026-04-14 archived.)
|
|
281
280
|
|
|
282
281
|
---
|
|
283
282
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Nexus MCP Tool Contracts
|
|
2
2
|
|
|
3
|
-
This document is the normative specification for the eleven Nexus MCP tools. Implementations in all consumer harnesses (claude-nexus, opencode-nexus
|
|
3
|
+
This document is the normative specification for the eleven Nexus MCP tools. Implementations in all consumer harnesses (claude-nexus, opencode-nexus) must conform to the parameter names, types, return shapes, side effects, and error conditions defined here. Harness-specific registration names (prefixes such as `nx_` or `mcp__plugin_*`) are implementation details and are not part of this specification.
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
package/manifest.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"nexus_core_version": "0.7.
|
|
3
|
-
"nexus_core_commit": "
|
|
2
|
+
"nexus_core_version": "0.7.1",
|
|
3
|
+
"nexus_core_commit": "d2da7dede9540a14bc5925904c2382795f383b1e",
|
|
4
4
|
"schema_contract_version": "2.0",
|
|
5
5
|
"agents": [
|
|
6
6
|
{
|
|
@@ -34,34 +34,20 @@
|
|
|
34
34
|
"body_hash": "sha256:3d58b1b490c2f93cace2eedd0f04ec000f84514388eb086768cf53f8fa33db01"
|
|
35
35
|
},
|
|
36
36
|
{
|
|
37
|
-
"name": "
|
|
38
|
-
"description": "
|
|
39
|
-
"task": "
|
|
40
|
-
"alias_ko": "
|
|
41
|
-
"category": "
|
|
42
|
-
"resume_tier": "ephemeral",
|
|
43
|
-
"model_tier": "standard",
|
|
44
|
-
"capabilities": [
|
|
45
|
-
"no_file_edit",
|
|
46
|
-
"no_task_create"
|
|
47
|
-
],
|
|
48
|
-
"id": "reviewer",
|
|
49
|
-
"body_hash": "sha256:f04d15249601b14046e7e40a4475defb289436c4474afbd89986964f8c3e7c2f"
|
|
50
|
-
},
|
|
51
|
-
{
|
|
52
|
-
"name": "researcher",
|
|
53
|
-
"description": "Independent investigation — conducts web searches, gathers evidence, and reports findings with citations",
|
|
54
|
-
"task": "Web search, independent investigation",
|
|
55
|
-
"alias_ko": "리서처",
|
|
56
|
-
"category": "do",
|
|
37
|
+
"name": "designer",
|
|
38
|
+
"description": "UX/UI design — evaluates user experience, interaction patterns, and how users will experience the product",
|
|
39
|
+
"task": "UI/UX design, interaction patterns, user experience",
|
|
40
|
+
"alias_ko": "디자이너",
|
|
41
|
+
"category": "how",
|
|
57
42
|
"resume_tier": "persistent",
|
|
58
|
-
"model_tier": "
|
|
43
|
+
"model_tier": "high",
|
|
59
44
|
"capabilities": [
|
|
60
45
|
"no_file_edit",
|
|
61
|
-
"no_task_create"
|
|
46
|
+
"no_task_create",
|
|
47
|
+
"no_task_update"
|
|
62
48
|
],
|
|
63
|
-
"id": "
|
|
64
|
-
"body_hash": "sha256:
|
|
49
|
+
"id": "designer",
|
|
50
|
+
"body_hash": "sha256:88ac56147d0e5bdf23fa591ce570a9c2d0eb1338df4ec2219f6238ddfcb65df4"
|
|
65
51
|
},
|
|
66
52
|
{
|
|
67
53
|
"name": "strategist",
|
|
@@ -80,20 +66,19 @@
|
|
|
80
66
|
"body_hash": "sha256:0254b4144a22c66209bd68119553d9057a4fb7f9b1ff7ebb9878687d99583465"
|
|
81
67
|
},
|
|
82
68
|
{
|
|
83
|
-
"name": "
|
|
84
|
-
"description": "
|
|
85
|
-
"task": "
|
|
86
|
-
"alias_ko": "
|
|
87
|
-
"category": "
|
|
69
|
+
"name": "researcher",
|
|
70
|
+
"description": "Independent investigation — conducts web searches, gathers evidence, and reports findings with citations",
|
|
71
|
+
"task": "Web search, independent investigation",
|
|
72
|
+
"alias_ko": "리서처",
|
|
73
|
+
"category": "do",
|
|
88
74
|
"resume_tier": "persistent",
|
|
89
|
-
"model_tier": "
|
|
75
|
+
"model_tier": "standard",
|
|
90
76
|
"capabilities": [
|
|
91
77
|
"no_file_edit",
|
|
92
|
-
"no_task_create"
|
|
93
|
-
"no_task_update"
|
|
78
|
+
"no_task_create"
|
|
94
79
|
],
|
|
95
|
-
"id": "
|
|
96
|
-
"body_hash": "sha256:
|
|
80
|
+
"id": "researcher",
|
|
81
|
+
"body_hash": "sha256:fc79bafec05503327bd51a0b84b6e642d304bd79c45b78db6448b112793c143e"
|
|
97
82
|
},
|
|
98
83
|
{
|
|
99
84
|
"name": "postdoc",
|
|
@@ -111,6 +96,21 @@
|
|
|
111
96
|
"id": "postdoc",
|
|
112
97
|
"body_hash": "sha256:da9b8c2568b8b5812abed6d6324139f814379d48dc63cdc5d0b5b263f5407814"
|
|
113
98
|
},
|
|
99
|
+
{
|
|
100
|
+
"name": "reviewer",
|
|
101
|
+
"description": "Content verification — validates accuracy, checks facts, confirms grammar and format of non-code deliverables",
|
|
102
|
+
"task": "Content verification, fact-checking, grammar review",
|
|
103
|
+
"alias_ko": "리뷰어",
|
|
104
|
+
"category": "check",
|
|
105
|
+
"resume_tier": "ephemeral",
|
|
106
|
+
"model_tier": "standard",
|
|
107
|
+
"capabilities": [
|
|
108
|
+
"no_file_edit",
|
|
109
|
+
"no_task_create"
|
|
110
|
+
],
|
|
111
|
+
"id": "reviewer",
|
|
112
|
+
"body_hash": "sha256:f04d15249601b14046e7e40a4475defb289436c4474afbd89986964f8c3e7c2f"
|
|
113
|
+
},
|
|
114
114
|
{
|
|
115
115
|
"name": "tester",
|
|
116
116
|
"description": "Testing and verification — tests, verifies, validates stability and security of implementations",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Harness-neutral capability definitions.
|
|
2
2
|
# Each entry describes WHAT is denied in semantic terms.
|
|
3
|
-
# Consumers (claude-nexus, opencode-nexus
|
|
3
|
+
# Consumers (claude-nexus, opencode-nexus) maintain their own
|
|
4
4
|
# local map from these ids/classes to concrete tool names in their own repo.
|
|
5
5
|
# nexus-core does not and must not know those tool names.
|
|
6
6
|
|