@moreih29/nexus-core 0.4.0 → 0.6.0

package/docs/nexus-outputs-contract.md

@@ -18,7 +18,7 @@ Nexus 산출물은 생성 책임 주체에 따라 세 카테고리로 분류된
 | 카테고리 | 책임 주체 | 예시 파일 |
 |---|---|---|
 | Tool-produced | MCP tool 계약 (nexus-tools-contract.md 정의) | `plan.json`, `tasks.json`, `history.json` |
-| Harness-produced | Session hook (하네스 구현 책임) | `runtime.json`, `agent-tracker.json` |
+| Harness-produced | Session hook (하네스 구현 책임) | `agent-tracker.json` |
 | Agent-produced (ephemeral) | `artifact_write` 도구 (에이전트가 호출) | `artifacts/*.md` (등 임의 파일명) |
 
 카테고리 간 경계는 "누가 파일을 만드는가"로 정의된다. MCP tool이 직접 write하면 Tool-produced, 하네스 hook이 세션 초기화·종료 시 관리하면 Harness-produced, 에이전트가 `artifact_write`를 통해 기록하면 Agent-produced다.
@@ -88,25 +88,6 @@ Nexus 산출물은 생성 책임 주체에 따라 세 카테고리로 분류된
 
 ## Harness-produced 산출물
 
-### `runtime.json` — 세션 런타임 메타데이터
-
-**책임 주체**: Session hook (하네스 구현 책임). 어떤 MCP tool도 이 파일을 write해서는 안 된다.
-
-**생성 trigger**: 하네스는 세션 초기화 시 MUST `runtime.json`을 생성해야 한다. 이 파일은 MCP tool 호출이 시작되기 전에 존재해야 한다.
-
-**삭제 trigger**: 하네스는 세션 종료 시 MUST `runtime.json`을 삭제해야 한다.
-
-**Schema reference**: `conformance/state-schemas/runtime.schema.json`
-
-**Interop requirement**:
-- 하네스는 `runtime.json`을 기록할 때 MUST `conformance/state-schemas/runtime.schema.json`에 유효한 JSON을 기록해야 한다.
-- 다른 하네스의 session hook이 이 파일을 read할 경우 schema에 정의된 필드에만 의존해야 한다. MUST NOT schema 외부의 하네스 전용 필드에 의존해서는 안 된다.
-- `runtime.json`은 MUST NOT git-tracked 상태로 commit되어서는 안 된다.
-
-**Conformance fixture reference**: 해당 없음. `runtime.json`은 MCP tool behavioral fixture 범위 외에 있으며 하네스 session hook이 전적으로 책임진다.
-
----
-
 ### `agent-tracker.json` — 에이전트 인스턴스 추적
 
 **책임 주체**: Session hook (하네스 구현 책임). 어떤 MCP tool도 이 파일에 직접 write해서는 안 된다.
@@ -161,7 +142,7 @@ Nexus 산출물은 생성 책임 주체에 따라 세 카테고리로 분류된
 
 4. **append-only ledger 보전**: `history.json`은 모든 하네스 간에 MUST append-only로 처리되어야 한다. 기존 cycle 레코드를 수정하거나 삭제하는 하네스는 cross-harness 호환성 보장 대상에서 제외된다.
 
-5. **session-scoped 파일 격리**: `plan.json`, `tasks.json`, `runtime.json`, `agent-tracker.json`, `artifacts/` 디렉토리는 MUST git-tracked 상태로 commit되어서는 안 된다. 이 파일들은 세션 범위에 속하며 프로젝트 영구 기록이 아니다. 하네스는 MUST `.gitignore`에 이 경로들을 포함해야 한다.
+5. **session-scoped 파일 격리**: `plan.json`, `tasks.json`, `agent-tracker.json`, `artifacts/` 디렉토리는 MUST git-tracked 상태로 commit되어서는 안 된다. 이 파일들은 세션 범위에 속하며 프로젝트 영구 기록이 아니다. 하네스는 MUST `.gitignore`에 이 경로들을 포함해야 한다.
 
 6. **Tool 이름 참조 금지**: 산출물 파일 내용 안에 harness-specific tool 이름(하네스별 MCP prefix, 하네스별 도구 식별자 등)을 MUST NOT 기록해서는 안 된다. 산출물은 harness-neutral해야 한다.
 
@@ -204,7 +185,7 @@ Nexus 산출물은 생성 책임 주체에 따라 세 카테고리로 분류된
 - **MUST**: 하네스 고유 파일(독립 파일 + extension)은 모두 `.nexus/state/{harness-id}/` 하위에만 배치한다.
 - **MUST NOT**: `.nexus/state/` 루트에 신규 하네스 파일을 추가한다.
 - **MUST NOT**: 다른 하네스의 namespace 디렉토리에 쓰거나 읽는다.
-- **MUST NOT**: `{harness-id}/` 하위에서 공통 schema 파일명(plan.json, tasks.json, history.json, runtime.json, agent-tracker.json)을 재사용한다. 예: `.nexus/state/claude-nexus/plan.json` 금지.
+- **MUST NOT**: `{harness-id}/` 하위에서 공통 schema 파일명(plan.json, tasks.json, history.json, agent-tracker.json)을 재사용한다. 예: `.nexus/state/claude-nexus/plan.json` 금지.
 - **예외**: v0.3.x 이하에 루트 경로로 등록된 legacy 2종(`edit-tracker.json`, `reopen-tracker.json`)은 `task_close` tool 계약에 묶여 있어 backward-compat으로 루트 유지 허용한다. 신규 파일에는 예외 편승 금지.
 
 ### Archive 정책
@@ -224,7 +205,6 @@ Nexus 산출물은 생성 책임 주체에 따라 세 카테고리로 분류된
 .nexus/state/
 ├── plan.json                          ← 공통, strict
 ├── tasks.json
-├── runtime.json
 ├── agent-tracker.json
 ├── artifacts/
 └── claude-nexus/                      ← namespace 디렉토리
@@ -238,6 +218,16 @@ Nexus 산출물은 생성 책임 주체에 따라 세 카테고리로 분류된
 
 (루트 레벨 `edit-tracker.json`/`reopen-tracker.json`은 legacy carve-out으로 v0.3.x 이하 호환 유지)
 
+### Reference example
+
+`conformance/examples/plan.extension.schema.example.json`에 non-normative 참조 예시가 있다. 이 파일은 다음 요소를 보여준다:
+
+- `extends` 필드 (const: 부모 schema 경로)로 extension이 참조하는 common schema를 명시
+- `additionalProperties: false` — 확장 schema에서도 엄격 적용
+- `harness_id` 필드와 harness-specific field placeholder
+
+consumer는 이 파일을 starting point로 삼아 자신의 실제 extension 필드로 교체한다.
+
 ---
 
 ## Conformance 의무와의 연결
@@ -250,7 +240,7 @@ fixture 통과 = schema field 100% coverage ≠ 산출물 제어 의무 이행.
 
 fixture는 도구 호출의 반환값과 state file postcondition을 검증하지만, 아래 항목은 fixture만으로 검증되지 않는다.
 
-- Harness-produced 산출물(`runtime.json`, `agent-tracker.json`)의 생성·삭제 타이밍
+- Harness-produced 산출물(`agent-tracker.json`)의 생성·삭제 타이밍
 - Cross-harness interop 의무(다른 하네스가 생성한 파일을 읽을 수 있는가)
 - Forward-compatible schema 유지 의무
 - git-tracking 격리 의무
@@ -261,7 +251,7 @@ fixture는 도구 호출의 반환값과 state file postcondition을 검증하
 
 `conformance/README.md`가 정의하는 schema field coverage 의무: 모든 state-schema field는 최소 하나의 fixture의 `covers` 항목에 등장해야 한다. 이 의무는 fixture suite가 schema 전체를 검증함을 보장한다.
 
-본 문서는 이 의무가 **Tool-produced 산출물에 대해서만** 적용됨을 명시한다. Harness-produced 산출물(`runtime.json`, `agent-tracker.json`)의 field coverage는 하네스 자체 테스트 suite의 책임이다.
+본 문서는 이 의무가 **Tool-produced 산출물에 대해서만** 적용됨을 명시한다. Harness-produced 산출물(`agent-tracker.json`)의 field coverage는 하네스 자체 테스트 suite의 책임이다.
 
 schema field가 신규 추가되었을 때, nexus-core 관리자는 MUST 해당 field를 cover하는 fixture를 추가하거나 기존 fixture를 갱신해야 한다. field를 schema에 추가하면서 fixture를 갱신하지 않는 것은 coverage 의무 위반이다.
 

package/docs/nexus-state-overview.md

@@ -91,25 +91,6 @@ The Nexus state layout is divided into two categories:
 
 ---
 
-### `.nexus/state/runtime.json`
-
-| Attribute | Value |
-|-----------|-------|
-| Scope | Session |
-| Git-tracked | No |
-| Created by | Session start (harness hook) |
-| Deleted by | Session end (harness hook) |
-
-**Purpose.** Holds session-level runtime metadata established when the harness initializes (e.g., session identifiers, harness version, environment properties). This file is managed entirely by the harness layer; no Nexus MCP tool writes to it.
-
-**Creation trigger.** Written by the harness during session initialization before any tool is called.
-
-**Deletion trigger.** Removed by the harness upon session teardown.
-
-**Tool access.** Read-only by the harness infrastructure. No Nexus MCP tool listed in this specification reads or writes this file directly.
-
----
-
 ### `.nexus/state/agent-tracker.json`
 
 | Attribute | Value |

package/docs/nexus-tools-contract.md

@@ -102,7 +102,17 @@ Mutates the issue list of the active planning session. Supports four discrete ac
 
 ### Return Value
 
-All responses include an `issue` field containing the affected `PlanIssue` object. The discriminating field varies by action:
+All responses include an `issue` field containing the affected `PlanIssue` object.
+
+The `issue` object contains:
+
+| Field | Type | Presence |
+|-------|------|----------|
+| `id` | `number` | always |
+| `title` | `string` | on `add`, `edit`, `reopen` |
+| `status` | `"pending" \| "decided"` | on `add`, `reopen` |
+
+The discriminating field varies by action:
 
 | Action | Discriminating Field | Value |
 |--------|----------------------|-------|
@@ -140,7 +150,7 @@ Records a decision for a specific issue and marks it as `"decided"`. Triggered b
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
 | `issue_id` | `number` | yes | Identifier of the issue being decided |
-| `summary` | `string` | yes | Decision summary to record against the issue |
+| `decision` | `string` | yes | Decision text to record against the issue |
 | `how_agents` | `string[]` | no | Names of HOW agents that contributed analysis |
 | `how_summary` | `Record<string, string>` | no | Per-agent key position summaries |
 | `how_agent_ids` | `Record<string, string>` | no | Agent name to agent-instance ID mapping for future resume |

package/manifest.json

@@ -1,6 +1,6 @@
 {
-  "nexus_core_version": "0.4.0",
-  "nexus_core_commit": "2cc2402301c1f9b95ef0e9896c30e561357a7c35",
+  "nexus_core_version": "0.6.0",
+  "nexus_core_commit": "bcde383b56308b86006babe73f87fed9222c0761",
   "schema_contract_version": "2.0",
   "agents": [
     {
@@ -50,20 +50,6 @@
       "id": "designer",
       "body_hash": "sha256:88ac56147d0e5bdf23fa591ce570a9c2d0eb1338df4ec2219f6238ddfcb65df4"
     },
-    {
-      "name": "engineer",
-      "description": "Implementation — writes code, debugs issues, follows specifications from Lead and architect",
-      "task": "Code implementation, edits, debugging",
-      "alias_ko": "엔지니어",
-      "category": "do",
-      "resume_tier": "bounded",
-      "model_tier": "standard",
-      "capabilities": [
-        "no_task_create"
-      ],
-      "id": "engineer",
-      "body_hash": "sha256:3d58b1b490c2f93cace2eedd0f04ec000f84514388eb086768cf53f8fa33db01"
-    },
     {
       "name": "strategist",
       "description": "Business strategy — evaluates market positioning, competitive landscape, and business viability of decisions",
@@ -80,6 +66,20 @@
       "id": "strategist",
       "body_hash": "sha256:0254b4144a22c66209bd68119553d9057a4fb7f9b1ff7ebb9878687d99583465"
     },
+    {
+      "name": "engineer",
+      "description": "Implementation — writes code, debugs issues, follows specifications from Lead and architect",
+      "task": "Code implementation, edits, debugging",
+      "alias_ko": "엔지니어",
+      "category": "do",
+      "resume_tier": "bounded",
+      "model_tier": "standard",
+      "capabilities": [
+        "no_task_create"
+      ],
+      "id": "engineer",
+      "body_hash": "sha256:3d58b1b490c2f93cace2eedd0f04ec000f84514388eb086768cf53f8fa33db01"
+    },
     {
       "name": "researcher",
       "description": "Independent investigation — conducts web searches, gathers evidence, and reports findings with citations",
@@ -155,6 +155,16 @@
       "id": "nx-run",
       "body_hash": "sha256:6c8d1a36626d4034209ff83780dec6238297ec4710612441b2ef09daac714ca8"
     },
+    {
+      "name": "nx-sync",
+      "description": "Context knowledge synchronization — scans project state and updates .nexus/context/ design documents",
+      "summary": "Context knowledge synchronization",
+      "triggers": [
+        "sync"
+      ],
+      "id": "nx-sync",
+      "body_hash": "sha256:a7b0ae8f13ebcd10e52361d0ada1570ff0c47933f731deec07e95539c63e6946"
+    },
     {
       "name": "nx-init",
       "description": "Project onboarding — scan, mission, essentials, context generation",
@@ -166,16 +176,6 @@
       "id": "nx-init",
       "body_hash": "sha256:3c8230ecc0f87c541ec0ff80492a28f28bf173d0b9781901adadfae69a54b8ed"
     },
-    {
-      "name": "nx-sync",
-      "description": "Context knowledge synchronization — scans project state and updates .nexus/context/ design documents",
-      "summary": "Context knowledge synchronization",
-      "triggers": [
-        "sync"
-      ],
-      "id": "nx-sync",
-      "body_hash": "sha256:a7b0ae8f13ebcd10e52361d0ada1570ff0c47933f731deec07e95539c63e6946"
-    },
     {
       "name": "nx-plan",
       "description": "Structured multi-perspective analysis to decompose issues, align on decisions, and produce an enriched plan before execution. Plan only — does not execute.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moreih29/nexus-core",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Nexus ecosystem Authoring layer — canonical prompts, neutral metadata, and vocabulary shared by Nexus harnesses",
   "license": "MIT",
   "repository": {
@@ -28,8 +28,12 @@
     "schema",
     "conformance",
     "docs",
+    "scripts",
     "manifest.json"
   ],
+  "bin": {
+    "nexus-validate-conformance": "./scripts/conformance-coverage.ts"
+  },
   "engines": {
     "node": ">=20"
   },