@moreih29/nexus-core 0.15.1 → 0.16.0

package/dist/scripts/smoke/smoke-codex.js

@@ -0,0 +1,50 @@
+// Issue #42 — agents/*.toml standalone schema 회귀 감지
+// Verifies each dist/codex/agents/*.toml satisfies standalone role file schema.
+import { readFileSync, readdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { findPackageRoot } from "../../src/shared/package-root.js";
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+const ROOT = findPackageRoot(__dirname);
+const AGENTS_DIR = join(ROOT, "dist/codex/agents");
+function fail(msg) {
+    process.stderr.write(`[smoke-codex] FAIL: ${msg}\n`);
+    process.exit(1);
+}
+if (!existsSync(AGENTS_DIR)) {
+    fail(`dist/codex/agents/ not found — run \`bun run build-agents\` (or nexus-core sync --harness=codex) first`);
+}
+const files = readdirSync(AGENTS_DIR).filter((f) => f.endsWith(".toml"));
+if (files.length === 0) {
+    fail(`no .toml files found in ${AGENTS_DIR}`);
+}
+const failures = [];
+for (const file of files) {
+    const filePath = join(AGENTS_DIR, file);
+    const content = readFileSync(filePath, "utf-8");
+    const fileErrors = [];
+    // Assert standalone schema — root-level fields (no indentation)
+    if (!/^name = "/m.test(content)) {
+        fileErrors.push("missing root-level `name = \"...\"` line");
+    }
+    if (!/^description = "/m.test(content)) {
+        fileErrors.push("missing root-level `description = \"...\"` line");
+    }
+    if (!/^developer_instructions = ("""|")/m.test(content)) {
+        fileErrors.push("missing root-level `developer_instructions = ...` line");
+    }
+    // Detect nested [agents.<name>] header which signals old bundle schema
+    if (/^\[agents\./m.test(content)) {
+        fileErrors.push("contains `[agents.*]` section header — old bundle schema, should be standalone");
+    }
+    if (fileErrors.length > 0) {
+        failures.push(`  ${file}:\n${fileErrors.map((e) => `    - ${e}`).join("\n")}`);
+    }
+}
+if (failures.length > 0) {
+    process.stderr.write(`[smoke-codex] FAIL: ${failures.length}/${files.length} file(s) failed schema check:\n`);
+    process.stderr.write(failures.join("\n") + "\n");
+    process.exit(1);
+}
+console.log(`[smoke-codex] PASS — ${files.length} file(s) passed standalone schema check`);
+//# sourceMappingURL=smoke-codex.js.map

package/dist/scripts/smoke/smoke-codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke-codex.js","sourceRoot":"","sources":["../../../scripts/smoke/smoke-codex.ts"],"names":[],"mappings":"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"}

package/dist/scripts/smoke/smoke-opencode.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=smoke-opencode.d.ts.map

package/dist/scripts/smoke/smoke-opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke-opencode.d.ts","sourceRoot":"","sources":["../../../scripts/smoke/smoke-opencode.ts"],"names":[],"mappings":""}

package/dist/scripts/smoke/smoke-opencode.js

@@ -0,0 +1,99 @@
+// Issue #39 OpenCode 경로 — spawnHandler stdout null 회귀 감지
+// Verifies opencode-manifest.json has session-init entry and spawning its handler produces side-effects.
+import { spawn } from "node:child_process";
+import { readFileSync, mkdtempSync, rmSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { randomUUID } from "node:crypto";
+import { fileURLToPath } from "node:url";
+import { findPackageRoot } from "../../src/shared/package-root.js";
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+const ROOT = findPackageRoot(__dirname);
+const MANIFEST_PATH = join(ROOT, "dist/manifests/opencode-manifest.json");
+function fail(msg) {
+    process.stderr.write(`[smoke-opencode] FAIL: ${msg}\n`);
+    process.exit(1);
+}
+// --- 1. Load manifest and find session-init entry ---
+if (!existsSync(MANIFEST_PATH)) {
+    fail(`manifest not found: ${MANIFEST_PATH} — run \`bun run build\` first`);
+}
+const manifest = JSON.parse(readFileSync(MANIFEST_PATH, "utf-8"));
+if (!Array.isArray(manifest.hooks)) {
+    fail(`manifest.hooks is not an array`);
+}
+const entry = manifest.hooks.find((h) => h.events.includes("SessionStart"));
+if (!entry) {
+    fail(`no SessionStart hook found in manifest`);
+}
+// --- 2. Resolve handler path ---
+// Resolve handlerPath the same way opencode-mount.ts does:
+// relative to the manifest file location.
+const manifestUrl = new URL(`file://${MANIFEST_PATH}`);
+const resolvedPath = fileURLToPath(new URL(entry.handlerPath, manifestUrl));
+// Fall back to the compiled dist bundle if the manifest-relative path doesn't exist.
+// This allows smoke to detect path mismatches (Issue #43) while still validating
+// spawn + side-effect behavior against the known-good compiled bundle.
+const handlerPath = existsSync(resolvedPath)
+    ? resolvedPath
+    : join(ROOT, "dist/hooks", `${entry.name}.js`);
+if (!existsSync(handlerPath)) {
+    fail(`handler not found at either:\n  manifest-resolved: ${resolvedPath}\n  dist bundle:       ${join(ROOT, "dist/hooks", `${entry.name}.js`)}`);
+}
+// Warn when manifest path doesn't resolve — this is the Issue #43 symptom
+if (!existsSync(resolvedPath)) {
+    process.stderr.write(`[smoke-opencode] WARN: manifest handlerPath "${entry.handlerPath}" resolved to non-existent ` +
+        `"${resolvedPath}"; falling back to dist bundle. Fix manifest to resolve Issue #43.\n`);
+}
+// --- 3. Spawn handler with SessionStart payload ---
+const tmpDir = mkdtempSync(join(tmpdir(), "nexus-smoke-opencode-"));
+const sid = randomUUID();
+const payload = JSON.stringify({
+    hook_event_name: "SessionStart",
+    session_id: sid,
+    cwd: tmpDir,
+    source: "startup",
+});
+try {
+    const child = spawn("node", [handlerPath], {
+        env: { ...process.env, NEXUS_HARNESS: "opencode" },
+        stdio: ["pipe", "pipe", "pipe"],
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.on("data", (d) => { stdout += d.toString(); });
+    child.stderr.on("data", (d) => { stderr += d.toString(); });
+    child.stdin.write(payload);
+    child.stdin.end();
+    const code = await new Promise((resolve) => {
+        child.on("exit", (c) => resolve(c ?? 1));
+        child.on("error", () => resolve(1));
+    });
+    // --- 4. Assert exit 0 ---
+    if (code !== 0) {
+        fail(`handler exited with code ${code}. stderr:\n${stderr}`);
+    }
+    // Assert stdout is empty or valid JSON (not corrupted)
+    if (stdout.trim() && stdout.trim() !== "null") {
+        try {
+            JSON.parse(stdout);
+        }
+        catch {
+            fail(`stdout is non-empty and not valid JSON: ${stdout.slice(0, 200)}`);
+        }
+    }
+    // --- 5. Assert side-effects ---
+    const stateDir = join(tmpDir, ".nexus/state", sid);
+    if (!existsSync(stateDir)) {
+        fail(`state directory not created: ${stateDir} — handler ran but produced no side-effects (Issue #39 regression)\n` +
+            `  handlerPath: ${handlerPath}\n` +
+            `  code: ${code}\n` +
+            `  stdout: ${JSON.stringify(stdout)}\n` +
+            `  stderr: ${JSON.stringify(stderr)}`);
+    }
+    console.log("[smoke-opencode] PASS — manifest valid, handler spawned, side-effects confirmed");
+}
+finally {
+    rmSync(tmpDir, { recursive: true, force: true });
+}
+//# sourceMappingURL=smoke-opencode.js.map

package/dist/scripts/smoke/smoke-opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke-opencode.js","sourceRoot":"","sources":["../../../scripts/smoke/smoke-opencode.ts"],"names":[],"mappings":"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"}

package/docs/contract/harness-io.md

@@ -126,18 +126,50 @@ multi-harness 빌드가 필요한 경우 소비자가 `--harness`와 `--target`
 |---|---|---|
 | `package.json` | Template | npm 패키지 메타 — 저자 name·version 편집 |
 | `src/plugin.ts` | **Template (신규)** | mountHooks 진입점 보일러플레이트 |
-| `opencode.json.fragment` | Managed | consumer에 merge될 agents 배열 fragment |
-| `src/index.ts` | Managed | 에이전트 export 인덱스 |
+| `src/index.ts` | Managed | 에이전트 export 인덱스 (`export const agents = [...]` 포함) |
 | `src/agents/<name>.ts` | Managed | 에이전트 TS 모듈 |
 | `.opencode/skills/<name>/SKILL.md` | Managed | 스킬 마크다운 |
 
-**fragment 경로**: `opencode.json.fragment`는 core가 생성하는 agents 배열 fragment다. 이 파일의 consumer `opencode.json` merge는 wrapper(opencode-nexus)의 postinstall 스크립트가 수행한다.
+#### Consumer 설정 가이드 (canonical 경로)
+
+**1단계 — 의존성 설치**
+
+```bash
+bun add -d @moreih29/nexus-core @opencode-ai/plugin typescript
+```
+
+**2단계 — sync 실행**
+
+`bun run sync`를 실행하면 `src/index.ts`에 `export const agents = [...]`가 생성되고, `src/plugin.ts`에 `mountHooks` 기반 Plugin export 보일러플레이트가 생성된다. 이 두 파일이 OpenCode plugin auto-register의 canonical 진입점이다.
+
+**3단계 — consumer 워크스페이스 `.opencode/opencode.json` 구성**
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["<your-plugin-name>"],
+  "default_agent": "<primary-agent-id>",
+  "mcp": { "nx": { "type": "local", "command": ["nexus-mcp"] } }
+}
+```
+
+`agent` 객체는 optional이다. 특정 agent의 model 또는 permission을 개별 override해야 할 때만 추가한다.
+
+> **주의**: `{ "agents": [...] }` 형태로 config에 agents를 직접 나열하면 OpenCode가 `Unrecognized key: "agents"` 오류로 기동에 실패한다. agents 등록은 반드시 `plugin: ["<name>"]` 경로(plugin auto-register)를 통해야 한다.
+
+**4단계 — postinstall 허용 (Bun 1.3+)**
+
+```bash
+bun pm trust <your-plugin-name>
+```
+
+Bun 1.3+에서 plugin의 postinstall 스크립트를 허용하기 위해 필요하다.
 
 **hooks 경로**: OpenCode는 Claude/Codex와 달리 `hooks/hooks.json` 파일을 target에 기록하지 않는다. 대신 `src/plugin.ts`의 `mountHooks(ctx, manifest)`가 런타임에 `@moreih29/nexus-core/hooks/opencode-manifest` JSON과 `@moreih29/nexus-core/hooks/opencode-mount` 함수를 import해 consume하며, handler 경로는 node_modules 내부 패키지 기준으로 해석된다. consumer target에는 물리 복사가 발생하지 않는다.
 
 **Skill discovery 경계 (결정 #7)**: core는 consumer 프로젝트의 `.opencode/skills/<name>/SKILL.md` 파일 존재를 보장한다. `node_modules/<plugin>/.opencode/skills/` 자동 감지 여부는 OpenCode 런타임 영역으로 본 계약 외부다. wrapper(opencode-nexus)는 postinstall 스크립트로 패키지 내부 `.opencode/skills/`를 consumer 경로로 복사할 책임을 진다.
 
-**Consumer(opencode-nexus wrapper) 책임**: `src/plugin.ts` 실 진입점 유지 · `opencode.json.fragment` consumer merge · postinstall skill copy · npm publish.
+**Consumer(opencode-nexus wrapper) 책임**: `src/plugin.ts` 실 진입점 유지 · plugin auto-register 경로(`src/index.ts` export) 유지 · postinstall skill copy · npm publish.
 
 ---
 
@@ -166,6 +198,19 @@ multi-harness 빌드가 필요한 경우 소비자가 `--harness`와 `--target`
 - `install/config.fragment.toml` — MCP 서버 등록 TOML fragment
 - `install/AGENTS.fragment.md` — primary agent body를 `<!-- nexus-core:<agent-id>:start -->` / `<!-- nexus-core:<agent-id>:end -->` 마커로 감싼 fragment. `<agent-id>`는 primary agent의 frontmatter `id`이며 기본값은 `lead`이다
 
+**`agents/*.toml` — standalone role file 스키마**: `agents/<name>.toml`은 Codex의 `~/.codex/agents/`에 **standalone role file**로 직접 설치된다. 파일 스키마는 root-level 필드를 사용한다.
+
+```toml
+name = "<agent-id>"
+description = "..."
+developer_instructions = """<body>"""
+model = "..."
+sandbox_mode = "..."
+disabled_tools = [...]
+```
+
+> **주의**: `[agents.<id>]` nested 구조는 `~/.codex/config.toml`(global config)의 agent 정의용이며, standalone role file과 혼용하면 안 된다. standalone 파일에는 반드시 root-level `name`·`developer_instructions` 형식을 사용한다.
+
 **도메인 서브디렉터리 구조**: Codex 내부 `plugin/`·`agents/`·`install/` 서브디렉터리는 Codex 생태계가 `~/.codex/plugins/`·`~/.codex/agents/`·`~/.codex/config.toml` 3곳에 분리 설치되는 구조를 반영한다. 이 도메인 prefix는 flat 출력 규칙(§4 공통 규칙)과 직교하며 유지된다.
 
 **Consumer(codex-nexus wrapper) 책임**: `install.sh` 편집·실행 · block-marker merge(`config.toml`·`AGENTS.md`) · npm 혹은 GitHub source 배포 선택.
@@ -182,13 +227,13 @@ multi-harness 빌드가 필요한 경우 소비자가 `--harness`와 `--target`
 2. 하네스 네이티브 자산 빌드 — agents (`.md`/`.ts`/`.toml`), skills (`SKILL.md`), plugin manifest
 3. Integration fragment 제공:
    - Claude: `settings.json`
-   - OpenCode: `opencode.json.fragment`
+   - OpenCode: `src/index.ts`의 `export const agents` (plugin auto-register — fragment 없음)
    - Codex: `install/config.fragment.toml`·`install/AGENTS.fragment.md`
 4. Runtime exports (`mountHooks`, manifest JSON, mcp 서버)
 
 ### 5-2. wrapper 책임
 
-1. Fragment의 consumer 환경 실제 머지 로직 — block-marker·conditional merge·OS 경로 해석
+1. Fragment의 consumer 환경 실제 머지 로직 — block-marker·conditional merge·OS 경로 해석 (Claude `settings.json`, Codex `config.fragment.toml`·`AGENTS.fragment.md`)
 2. 배포 — marketplace 등록·npm publish·`install.sh` 실행
 3. Plugin 진입점 코드 — OpenCode `src/plugin.ts`·Codex `install/install.sh`
 4. Version·changelog 관리

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moreih29/nexus-core",
-  "version": "0.15.1",
+  "version": "0.16.0",
   "description": "Nexus ecosystem authoring layer — canonical agents/skills/hooks and 3-harness build pipeline (Claude Code, OpenCode, Codex)",
   "license": "MIT",
   "type": "module",
@@ -53,11 +53,15 @@
   },
   "packageManager": "bun@1.3.12",
   "scripts": {
-    "build": "tsc -p tsconfig.build.json && bun run scripts/build-hooks.ts",
+    "build": "tsc -p tsconfig.build.json && bun run scripts/build-hooks.ts && node dist/scripts/cli.js sync --harness=claude --target=dist/claude && node dist/scripts/cli.js sync --harness=codex --target=dist/codex && node dist/scripts/cli.js sync --harness=opencode --target=dist/opencode",
     "clean": "rm -rf dist",
     "test": "bun test src/ scripts/",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "bun run test"
+    "prepublishOnly": "bun run test",
+    "smoke:claude": "bun run scripts/smoke/smoke-claude.ts",
+    "smoke:codex": "bun run scripts/smoke/smoke-codex.ts",
+    "smoke:opencode": "bun run scripts/smoke/smoke-opencode.ts",
+    "smoke": "bun run smoke:claude && bun run smoke:codex && bun run smoke:opencode"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",