@moreih29/nexus-core 0.16.2 → 0.18.2

package/README.md

@@ -1,106 +1,140 @@
-# nexus-core
+# @moreih29/nexus-core
 
-3 하네스(Claude Code, OpenCode, Codex)의 Nexus 플러그인을 위한 공통 라이브러리.  
-에이전트 조율 계층, 공통 빌드 도구, MCP 서버, 스킬·훅 자산을 단일 패키지로 제공합니다.
+Claude Code · Codex · OpenCode 하네스 위에서 멀티 에이전트 오케스트레이션을 돌리기 위한 canonical 스펙과 도구.
 
-## 제공하는 것
+## 무엇인가
 
-1. **에이전트 조율 계층** — HOW / DO / CHECK 분류 + Lead 주재 (10 에이전트)
-2. **공통 빌드 도구** — `nexus-core sync` / `init` / `validate` CLI
-3. **MCP 서버** — 14개 도구를 stdio 서버로 제공 (`nexus-mcp`)
-4. **하네스별 자산** — 스킬·훅·에이전트 정의, capability-matrix SSOT
+`nexus-core`는 "Lead가 역할별 서브에이전트를 조합해 plan → run 사이클을 돌리는" 에이전트 오케스트레이션 모델을 세 하네스(Claude Code, Codex, OpenCode)에서 동일하게 구현하도록 뒷받침한다. 핵심은 세 축이다.
 
-## 제공하지 않는 것
+1. **Canonical 스펙** — 10개 에이전트와 3개 스킬의 하네스 중립 정의
+2. **Sync 파이프라인** (`nexus-sync`) — 스펙을 각 하네스 네이티브 포맷으로 렌더링
+3. **MCP 서버** (`nexus-mcp`) — 플래닝·태스크·이력·아티팩트 상태 관리 도구 노출
 
-실제 플러그인 빌드 및 배포는 개별 하네스 플러그인 repo의 책임입니다.
+제공하지 않는 것 — 훅 런타임, 메인 세션 와이어링, 플러그인 설치 스크립트, 하네스 부트스트랩. 이들은 컨슈머(각 하네스용 플러그인·저장소)가 `nexus-core` 산출물을 받아 자체 구현한다.
 
----
-
-## Installation
-
-**요구사항: Node.js 22 이상** (`import ... with { type: "json" }` 구문이 Node 22에서 stable입니다.)
+## 설치
 
 ```bash
-node --version   # v22.0.0 이상 확인
-bun add -D @moreih29/nexus-core
+npm install @moreih29/nexus-core
+# 또는
+bun add @moreih29/nexus-core
 ```
 
-전역 설치 시 `nexus-core` CLI와 `nexus-mcp` MCP 서버가 PATH에 추가됩니다.
+패키지는 다음을 번들한다.
 
-```bash
-bun add -g @moreih29/nexus-core
-nexus-core --help
+```
+node_modules/@moreih29/nexus-core/
+├── spec/            # canonical 에이전트·스킬 정의
+├── vocabulary/      # 도구 호출식 스키마
+├── harness/         # 하네스별 invocations + layout
+└── dist/            # 빌드 산출물 (MCP 서버, sync CLI)
 ```
 
----
+바이너리: `nexus-sync`, `nexus-mcp`. 프로그램적 API: `@moreih29/nexus-core/generate`, `@moreih29/nexus-core/mcp`.
 
-## Quick Start
+## 하네스 컨슈머가 해야 할 세 가지
 
-새 플러그인 repo를 시작하는 기본 흐름입니다.
+### 1. 에이전트·스킬 아티팩트 생성
 
 ```bash
-# 1. 플러그인 스캐폴드 생성
-bunx @moreih29/nexus-core init --harness=claude --target=./my-claude-plugin
+nexus-sync --harness=claude --target=./out/claude
+nexus-sync --harness=codex --target=./out/codex
+nexus-sync --harness=opencode --target=./out/opencode
+```
 
-# 2. 의존성 설치 후 자산 동기화
-cd my-claude-plugin && bun install
-bunx @moreih29/nexus-core sync --harness=claude --target=./
+`--target` 아래 하네스 레이아웃대로 파일이 생성된다.
 
-# 3. 변경 사항 확인 후 커밋
-bunx @moreih29/nexus-core sync --harness=claude --target=./ --dry-run
-git add . && git commit -m "Initial plugin scaffold"
-```
+| 하네스 | 에이전트 출력 | 스킬 출력 |
+|---|---|---|
+| `claude` | `agents/{id}.md` | `skills/{id}/SKILL.md` |
+| `codex` | `.codex/agents/{id}.toml` | `.codex/skills/{id}/SKILL.md` |
+| `opencode` | `src/agents/{id}.ts` | `skills/{id}/SKILL.md` |
 
-전체 흐름과 하네스별 install 구현 가이드는 [`docs/plugin-guide.md`](./docs/plugin-guide.md)를 참조하세요.
+생성된 lead를 메인 세션에 어떻게 연결할지는 하네스마다 다르며 컨슈머의 몫이다. 상세는 [docs/agent-skill-sync.md](docs/agent-skill-sync.md).
 
----
+### 2. MCP 서버 등록
 
-## Documentation
+하네스의 MCP 설정에 `nexus-mcp` 명령을 등록한다. 전송 방식은 stdio, 서버 이름은 `nexus-core`.
 
-| 문서 | 내용 |
+| 도구 그룹 | 용도 |
 |---|---|
-| [`docs/plugin-guide.md`](./docs/plugin-guide.md) | 플러그인 저자용 end-to-end 통합 가이드 (sync · init · 하네스별 install · Lead 주입) |
-| [`docs/consuming/`](./docs/consuming/) | 컨슈머 구현 가이드 (Claude · OpenCode · Codex 설치 절차) |
-| [`docs/consuming/codex-lead-merge.md`](./docs/consuming/codex-lead-merge.md) | Codex AGENTS.md 수동 머지 절차 |
-| [`.nexus/context/architecture.md`](./.nexus/context/architecture.md) | 패키지 구조 · 빌드 파이프라인 · Lead vs Hook 책임 경계 |
+| `nx_plan_*` | 플래닝 세션 수명주기 |
+| `nx_task_*` | 태스크 수명주기 |
+| `nx_history_search` | 과거 사이클 조회 |
+| `nx_artifact_write` | 아티팩트 쓰기 |
 
----
+MCP 서버는 컨슈머 프로젝트 루트 기준 `.nexus/state/`와 `.nexus/history.json`만 읽고 쓴다. 상세는 [docs/mcp-server-tools.md](docs/mcp-server-tools.md).
 
-## Consumer 통합 가이드
+### 3. 훅 와이어링
 
-### 서브패스 경유 정책
+Nexus 런타임이 기대하는 세 가지 역할을 각 하네스에서 와이어링한다.
 
-`@moreih29/nexus-core`의 bare import(`import "@moreih29/nexus-core"`)는 의도적으로 비활성화되어 있습니다 (`"."` export = `null`). 모든 기능은 서브패스를 통해 접근해야 합니다.
+1. 세션 진입 시 `.nexus/` 폴더 구조와 `.gitignore` 화이트리스트 보장
+2. 사용자 프롬프트에서 Nexus 태그(`[plan]`·`[auto-plan]`·`[run]`·`[m]`·`[m:gc]`) 감지해 스킬/지시 활성화
+3. (선택) Nexus 규칙 위반 Bash 명령 차단
 
-| 서브패스 | 노출 내용 |
-|---|---|
-| `@moreih29/nexus-core/hooks/opencode-mount` | `mountHooks` 함수 |
-| `@moreih29/nexus-core/hooks/runtime` | 런타임 유틸리티 |
-| `@moreih29/nexus-core/hooks/opencode-manifest` | OpenCode hook JSON manifest |
+하네스별 권장 훅과 이벤트 매핑은 [docs/harness-hooks.md](docs/harness-hooks.md).
 
-### OpenCode 플러그인 thin-wrapper 예제
+## 에이전트 모델
 
-OpenCode 플러그인을 구축하는 가장 간단한 패턴은 다음과 같습니다.
+세 카테고리로 역할이 분리된다.
 
-```typescript
-import type { Plugin } from "@opencode-ai/plugin";
-import { mountHooks } from "@moreih29/nexus-core/hooks/opencode-mount";
-import manifest from "@moreih29/nexus-core/hooks/opencode-manifest" with { type: "json" };
+| 카테고리 | 역할 | 에이전트 |
+|---|---|---|
+| HOW | 기술 설계·분석·전략 자문 | architect, designer, postdoc, strategist |
+| DO | 실행 | engineer, writer, researcher |
+| CHECK | 검증 | reviewer, tester |
 
-export const OpencodeNexus: Plugin = async (ctx) => mountHooks(ctx, manifest);
-```
+`lead`는 메인 세션에서 사용자와 대화하고, 서브에이전트를 조합하며, plan/task 수명주기를 주도한다. 재개가 필요한 시점에 스폰 때 받은 `agent_id`를 `nx_plan_analysis_add` / `nx_task_update`에 기록해두고, 나중에 `nx_plan_resume` / `nx_task_resume`로 되찾아 `{{subagent_resume}}`로 재개한다.
 
-- `manifest`는 `./hooks/opencode-manifest` 서브패스를 통해 JSON으로 임포트합니다. Node 22의 `import ... with { type: "json" }` 구문이 필요합니다.
-- `mountHooks(ctx, manifest)`는 manifest에 정의된 훅을 OpenCode context에 등록합니다.
+## 스킬과 태그
 
-전체 하네스별 통합 절차는 [`docs/plugin-guide.md`](./docs/plugin-guide.md)를 참조하세요.
+| 태그 | 스킬/동작 | 목적 |
+|---|---|---|
+| `[plan]` | nx-plan | 사용자 결정 중심의 구조적 분석 |
+| `[auto-plan]` | nx-auto-plan | Lead 자율 결정 |
+| `[run]` | nx-run | 태스크 실행 오케스트레이션 |
+| `[d]` | 결정 기록 | 활성 plan 세션의 현재 안건에 `nx_plan_decide` |
+| `[m]` | memory 저장 | `.nexus/memory/`에 누적 |
+| `[m:gc]` | memory 정리 | `.nexus/memory/` 병합·제거 |
 
----
+## 도구 호출식
 
-## Consumer 하네스
+스펙 본문에서 이중 중괄호 표기로 호출하는 도구. sync 시점에 각 하네스 네이티브 문법으로 확장된다.
 
-| 하네스 | 플러그인 repo |
+| 호출식 | 용도 |
 |---|---|
-| Claude Code | claude-nexus |
-| OpenCode | opencode-nexus |
-| Codex | codex-nexus |
+| `{{subagent_spawn}}` | 서브에이전트 스폰 |
+| `{{subagent_resume}}` | 기존 서브에이전트 재개 |
+| `{{skill_activation}}` | 스킬 활성화 |
+| `{{task_register}}` | 태스크 진행 추적 등록 |
+| `{{user_question}}` | 사용자에게 선택지 질문 |
+
+스키마는 `vocabulary/invocations.yml`, 하네스별 확장 템플릿은 `harness/<name>/invocations.yml`에 있다.
+
+## 파일 레이아웃 (컨슈머 프로젝트 기준)
+
+```
+.nexus/
+├── .gitignore       # 화이트리스트 — context, memory, history만 추적
+├── context/         # 설계 원칙·아키텍처
+├── memory/          # empirical-·external-·pattern- prefix 교훈
+├── state/
+│   ├── plan.json    # 현재 plan 세션
+│   ├── tasks.json   # 현재 태스크 목록
+│   └── artifacts/   # 사이클 산출물
+└── history.json     # 종료된 사이클 아카이브
+```
+
+- `state/*`·`history.json` — MCP 도구만 편집
+- `context/`·`memory/` — Lead가 사용자 태그로 관리
+
+## 관련 문서
+
+- [에이전트·스킬 명세 동기화](docs/agent-skill-sync.md)
+- [MCP 서버 도구](docs/mcp-server-tools.md)
+- [하네스 훅 권장](docs/harness-hooks.md)
+
+## 라이선스
+
+MIT

package/dist/cli/sync.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export declare function main(argv?: string[]): void;
+//# sourceMappingURL=sync.d.ts.map

package/dist/cli/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/cli/sync.ts"],"names":[],"mappings":";AAgDA,wBAAgB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,IAAI,CAiBjE"}

package/dist/cli/sync.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env bun
+import { resolve } from "node:path";
+import { syncSpecsToTarget } from "../generate/sync.js";
+function parseArgs(argv) {
+    let harness = null;
+    let target = null;
+    let dryRun = false;
+    for (const arg of argv) {
+        if (arg === "--dry-run") {
+            dryRun = true;
+            continue;
+        }
+        if (arg.startsWith("--harness=")) {
+            const value = arg.slice("--harness=".length);
+            if (value === "claude" || value === "codex" || value === "opencode") {
+                harness = value;
+                continue;
+            }
+            throw new Error(`Unsupported harness "${value}"`);
+        }
+        if (arg.startsWith("--target=")) {
+            target = arg.slice("--target=".length);
+        }
+    }
+    if (!harness) {
+        throw new Error(`Missing required flag --harness=<claude|codex|opencode>`);
+    }
+    if (!target) {
+        throw new Error(`Missing required flag --target=<directory>`);
+    }
+    return {
+        harness,
+        target: resolve(target),
+        dryRun,
+    };
+}
+export function main(argv = process.argv.slice(2)) {
+    const parsed = parseArgs(argv);
+    const result = syncSpecsToTarget(parsed);
+    if (parsed.dryRun) {
+        console.log(`[nexus-sync] dry-run: ${result.files.length} files would be generated`);
+        for (const file of result.files) {
+            console.log(file.targetPath);
+        }
+        return;
+    }
+    console.log(`[nexus-sync] harness=${result.harness} wrote ${result.writtenFiles.length}/${result.files.length} files to ${result.targetRoot}`);
+}
+const isDirectRun = import.meta.url === `file://${process.argv[1]}`;
+if (isDirectRun) {
+    try {
+        main();
+    }
+    catch (error) {
+        console.error("[nexus-sync] fatal:", error);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/cli/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/cli/sync.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AASxD,SAAS,SAAS,CAAC,IAAc;IAC/B,IAAI,OAAO,GAAmB,IAAI,CAAC;IACnC,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,MAAM,GAAG,IAAI,CAAC;YACd,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC7C,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;gBACpE,OAAO,GAAG,KAAK,CAAC;gBAChB,SAAS;YACX,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,GAAG,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,OAAO;QACL,OAAO;QACP,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC;QACvB,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAiB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAEzC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CACT,yBAAyB,MAAM,CAAC,KAAK,CAAC,MAAM,2BAA2B,CACxE,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CACT,wBAAwB,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,YAAY,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,aAAa,MAAM,CAAC,UAAU,EAAE,CAClI,CAAC;AACJ,CAAC;AAED,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACpE,IAAI,WAAW,EAAE,CAAC;IAChB,IAAI,CAAC;QACH,IAAI,EAAE,CAAC;IACT,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/generate/index.d.ts

@@ -0,0 +1,3 @@
+export { buildGeneratedFiles, syncSpecsToTarget } from "./sync.js";
+export type { AssetKind, GeneratedFile, Harness, SpecDocument, SyncOptions, SyncResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/generate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnE,YAAY,EACV,SAAS,EACT,aAAa,EACb,OAAO,EACP,YAAY,EACZ,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/generate/index.js

@@ -0,0 +1,2 @@
+export { buildGeneratedFiles, syncSpecsToTarget } from "./sync.js";
+//# sourceMappingURL=index.js.map

package/dist/generate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC"}

package/dist/generate/load-data.d.ts

@@ -0,0 +1,8 @@
+import type { ClaudeAgentRules, CodexAgentRules, Harness, HarnessInvocationMap, HarnessLayout, InvocationSchema, OpencodeAgentRules } from "./types.js";
+export declare function loadInvocationCatalog(): Map<string, InvocationSchema>;
+export declare function loadHarnessInvocationMap(harness: Harness): HarnessInvocationMap["invocation_map"];
+export declare function loadHarnessLayout(harness: Harness): HarnessLayout;
+export declare function loadClaudeAgentRules(): ClaudeAgentRules;
+export declare function loadCodexAgentRules(): CodexAgentRules;
+export declare function loadOpencodeAgentRules(): OpencodeAgentRules;
+//# sourceMappingURL=load-data.d.ts.map

package/dist/generate/load-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-data.d.ts","sourceRoot":"","sources":["../../src/generate/load-data.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAEf,OAAO,EACP,oBAAoB,EACpB,aAAa,EAEb,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AASpB,wBAAgB,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAyBrE;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,GACf,oBAAoB,CAAC,gBAAgB,CAAC,CAKxC;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAEjE;AAED,wBAAgB,oBAAoB,IAAI,gBAAgB,CAEvD;AAED,wBAAgB,mBAAmB,IAAI,eAAe,CAErD;AAED,wBAAgB,sBAAsB,IAAI,kBAAkB,CAE3D"}

package/dist/generate/load-data.js

@@ -0,0 +1,45 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+const PACKAGE_ROOT = new URL("../../", import.meta.url);
+function readYamlFile(relativePath) {
+    const absolutePath = new URL(relativePath, PACKAGE_ROOT);
+    return parseYaml(readFileSync(absolutePath, "utf8"));
+}
+export function loadInvocationCatalog() {
+    const catalog = readYamlFile("vocabulary/invocations.yml");
+    const result = new Map();
+    for (const invocation of catalog.invocations) {
+        const params = {};
+        for (const [name, schema] of Object.entries(invocation.params)) {
+            const resolved = { ...schema };
+            if (schema.type === "enum" && schema.values_ref) {
+                const enumValues = readYamlFile(join("vocabulary", schema.values_ref));
+                resolved.values = enumValues.values;
+            }
+            params[name] = resolved;
+        }
+        result.set(invocation.id, {
+            id: invocation.id,
+            params,
+        });
+    }
+    return result;
+}
+export function loadHarnessInvocationMap(harness) {
+    const data = readYamlFile(`harness/${harness}/invocations.yml`);
+    return data.invocation_map;
+}
+export function loadHarnessLayout(harness) {
+    return readYamlFile(`harness/${harness}/layout.yml`);
+}
+export function loadClaudeAgentRules() {
+    return readYamlFile("harness/claude/agent-rules.yml");
+}
+export function loadCodexAgentRules() {
+    return readYamlFile("harness/codex/agent-rules.yml");
+}
+export function loadOpencodeAgentRules() {
+    return readYamlFile("harness/opencode/agent-rules.yml");
+}
+//# sourceMappingURL=load-data.js.map

package/dist/generate/load-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-data.js","sourceRoot":"","sources":["../../src/generate/load-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAa1C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAExD,SAAS,YAAY,CAAI,YAAoB;IAC3C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACzD,OAAO,SAAS,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAM,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,MAAM,OAAO,GAAG,YAAY,CAAoB,4BAA4B,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEnD,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,MAAM,GAA+B,EAAE,CAAC;QAE9C,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/D,MAAM,QAAQ,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;YAC/B,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBAChD,MAAM,UAAU,GAAG,YAAY,CAC7B,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,CACtC,CAAC;gBACF,QAAQ,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;YACtC,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC;QAC1B,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE;YACxB,EAAE,EAAE,UAAU,CAAC,EAAE;YACjB,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAAgB;IAEhB,MAAM,IAAI,GAAG,YAAY,CACvB,WAAW,OAAO,kBAAkB,CACrC,CAAC;IACF,OAAO,IAAI,CAAC,cAAc,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAgB;IAChD,OAAO,YAAY,CAAgB,WAAW,OAAO,aAAa,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,YAAY,CAAmB,gCAAgC,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,YAAY,CAAkB,+BAA+B,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,YAAY,CAAqB,kCAAkC,CAAC,CAAC;AAC9E,CAAC"}

package/dist/generate/load-spec.d.ts

@@ -0,0 +1,3 @@
+import type { SpecDocument } from "./types.js";
+export declare function loadSpecDocuments(): SpecDocument[];
+//# sourceMappingURL=load-spec.d.ts.map

package/dist/generate/load-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-spec.d.ts","sourceRoot":"","sources":["../../src/generate/load-spec.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,YAAY,CAAC;AAuD1D,wBAAgB,iBAAiB,IAAI,YAAY,EAAE,CAElD"}

package/dist/generate/load-spec.js

@@ -0,0 +1,48 @@
+import { readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+const SPEC_ROOT = new URL("../../spec/", import.meta.url);
+function parseFrontmatter(raw, sourcePath) {
+    if (!raw.startsWith("---\n")) {
+        throw new Error(`Missing frontmatter in ${sourcePath}`);
+    }
+    const end = raw.indexOf("\n---\n", 4);
+    if (end === -1) {
+        throw new Error(`Unterminated frontmatter in ${sourcePath}`);
+    }
+    const frontmatterRaw = raw.slice(4, end);
+    const body = raw.slice(end + 5).replace(/^\n/, "");
+    return {
+        frontmatter: parseYaml(frontmatterRaw),
+        body,
+    };
+}
+function loadKind(kind) {
+    const dir = new URL(`${kind}s/`, SPEC_ROOT);
+    const absoluteDir = dir.pathname;
+    const results = [];
+    for (const entry of readdirSync(absoluteDir, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const sourcePath = join(absoluteDir, entry.name, "body.md");
+        const raw = readFileSync(sourcePath, "utf8");
+        const { frontmatter, body } = parseFrontmatter(raw, sourcePath);
+        const id = String(frontmatter.id ?? entry.name);
+        const name = String(frontmatter.name ?? id);
+        const description = String(frontmatter.description ?? "");
+        results.push({
+            kind,
+            id,
+            name,
+            description,
+            frontmatter,
+            body,
+            sourcePath,
+        });
+    }
+    return results.sort((a, b) => a.id.localeCompare(b.id));
+}
+export function loadSpecDocuments() {
+    return [...loadKind("agent"), ...loadKind("skill")];
+}
+//# sourceMappingURL=load-spec.js.map

package/dist/generate/load-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-spec.js","sourceRoot":"","sources":["../../src/generate/load-spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAG1C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE1D,SAAS,gBAAgB,CACvB,GAAW,EACX,UAAkB;IAElB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACtC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,+BAA+B,UAAU,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,cAAc,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnD,OAAO;QACL,WAAW,EAAE,SAAS,CAAC,cAAc,CAA4B;QACjE,IAAI;KACL,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,IAAe;IAC/B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,IAAI,EAAE,SAAS,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC;IACjC,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACtE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QAEnC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAEhE,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QAE1D,OAAO,CAAC,IAAI,CAAC;YACX,IAAI;YACJ,EAAE;YACF,IAAI;YACJ,WAAW;YACX,WAAW;YACX,IAAI;YACJ,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/generate/macros/expand.d.ts

@@ -0,0 +1,3 @@
+import type { Harness, InvocationSchema } from "../types.js";
+export declare function expandMacrosForHarness(body: string, _harness: Harness, catalog: Map<string, InvocationSchema>, invocationMap: Record<string, Record<string, unknown>>): string;
+//# sourceMappingURL=expand.d.ts.map

package/dist/generate/macros/expand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand.d.ts","sourceRoot":"","sources":["../../../src/generate/macros/expand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAe,MAAM,aAAa,CAAC;AAwD1E,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACtC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACrD,MAAM,CAWR"}

package/dist/generate/macros/expand.js

@@ -0,0 +1,48 @@
+import { expandMacroExpressions } from "./parse.js";
+import { validateMacro } from "./validate.js";
+function stringifyParam(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    return `>>${value.heredoc}`;
+}
+function normalizeMacroParams(macro, config) {
+    const params = {};
+    for (const [key, value] of Object.entries(macro.params)) {
+        params[key] = stringifyParam(value);
+    }
+    const aliases = typeof config.role_aliases === "object" && config.role_aliases !== null
+        ? config.role_aliases
+        : {};
+    if (params.target_role) {
+        params.target_role = aliases[params.target_role] ?? params.target_role;
+    }
+    if (!params.name &&
+        config.name_fallback === "target_role" &&
+        params.target_role) {
+        params.name = params.target_role;
+    }
+    return params;
+}
+function applyTemplate(template, params) {
+    let result = template;
+    for (const [key, value] of Object.entries(params)) {
+        result = result.replace(new RegExp(`\\{${key}\\}`, "g"), value);
+    }
+    result = result.replace(/,?\s*\w+:\s*"\{[^}]+\}"/g, "");
+    result = result.replace(/,?\s*\w+:\s*\{[^}]+\}/g, "");
+    return result;
+}
+export function expandMacrosForHarness(body, _harness, catalog, invocationMap) {
+    return expandMacroExpressions(body, (macro) => {
+        validateMacro(macro, catalog);
+        const config = invocationMap[macro.id] ?? {};
+        const template = config.template;
+        if (typeof template !== "string" || template.length === 0) {
+            throw new Error(`Missing template for macro "${macro.id}"`);
+        }
+        const params = normalizeMacroParams(macro, config);
+        return applyTemplate(template, params);
+    });
+}
+//# sourceMappingURL=expand.js.map

package/dist/generate/macros/expand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand.js","sourceRoot":"","sources":["../../../src/generate/macros/expand.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,SAAS,cAAc,CAAC,KAAmC;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAAkB,EAClB,MAA+B;IAE/B,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,MAAM,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,OAAO,GACX,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,IAAI,MAAM,CAAC,YAAY,KAAK,IAAI;QACrE,CAAC,CAAE,MAAM,CAAC,YAAuC;QACjD,CAAC,CAAC,EAAE,CAAC;IAET,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,MAAM,CAAC,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC;IACzE,CAAC;IAED,IACE,CAAC,MAAM,CAAC,IAAI;QACZ,MAAM,CAAC,aAAa,KAAK,aAAa;QACtC,MAAM,CAAC,WAAW,EAClB,CAAC;QACD,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC;IACnC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CACpB,QAAgB,EAChB,MAA8B;IAE9B,IAAI,MAAM,GAAG,QAAQ,CAAC;IAEtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;IACxD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;IACtD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,QAAiB,EACjB,OAAsC,EACtC,aAAsD;IAEtD,OAAO,sBAAsB,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;QAC5C,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QACjC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACnD,OAAO,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/generate/macros/parse.d.ts

@@ -0,0 +1,4 @@
+import type { ParsedMacro } from "../types.js";
+export declare function parseMacroExpression(expression: string): ParsedMacro;
+export declare function expandMacroExpressions(input: string, replacer: (macro: ParsedMacro) => string): string;
+//# sourceMappingURL=parse.d.ts.map

package/dist/generate/macros/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/generate/macros/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAgG/C,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAepE;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,MAAM,GACvC,MAAM,CA8CR"}