@moreih29/nexus-core 0.16.2 → 0.18.2

package/docs/plugin-template/codex/README.md

@@ -1,147 +0,0 @@
-# Codex Plugin Scaffold — nexus-core
-
-이 디렉터리는 `nexus-core init --harness=codex` 명령으로 복사되는 Codex CLI 플러그인 스타터입니다.
-
-## 개요
-
-nexus-core가 공통 스킬·에이전트 자산을 이 플러그인 repo에 동기화(sync)합니다.
-Codex 플러그인은 `.codex-plugin/plugin.json`을 진입점으로 하는 폴더 단위로 배포됩니다.
-
-Codex의 멀티 에이전트 인프라는 **플러그인 시스템과 별개**입니다. 에이전트를 실제로 활성화하려면
-install 시점에 `~/.codex/config.toml`의 `[agents.*]` 테이블과 TOML 파일을 user scope에 배치해야 합니다.
-
-## 디렉터리 구조
-
-```
-my-codex-plugin/
-├── plugin/                  # Plugin spec — 마켓플레이스 설치 단위
-│   ├── .codex-plugin/
-│   │   └── plugin.json      # Managed — nexus-core sync가 덮어씀
-│   └── skills/              # Managed — nexus-core sync가 덮어씀
-│       └── <skill-name>/
-│           └── SKILL.md
-├── agents/                  # Managed — native agent 설치 재료 (plugin spec 일부가 아님)
-│   └── <agent-name>.toml    # install 명령이 ~/.codex/agents/로 복사
-├── prompts/                 # Managed — 에이전트 프롬프트 Markdown
-│   └── <agent-name>.md
-├── install/
-│   ├── config.fragment.toml # Managed — ~/.codex/config.toml에 병합할 스니펫
-│   └── AGENTS.fragment.md   # Managed — AGENTS.md에 병합할 primary agent 프롬프트
-├── package.json
-└── .github/
-    └── workflows/
-        └── build.yml
-```
-
-**Managed** 경로는 `nexus-core sync`가 항상 최신 상태로 유지합니다.
-
-> **Plugin spec vs. native agent 구분**
->
-> Codex의 플러그인 시스템(`.codex-plugin/plugin.json` + `skills/`)과 native agent 시스템(`config.toml`의 `[agents.*]`)은 **별개**입니다.
->
-> - `plugin/` 디렉터리: 마켓플레이스에 등록되는 plugin spec. `skills/<name>/SKILL.md`가 자산 컨테이너입니다.
->   플러그인 spec 상에 `agents/<name>.toml` 폴더는 존재하지 않습니다.
-> - `agents/` 디렉터리: native agent 활성화용 TOML 파일. install 명령이 `~/.codex/agents/`로 복사하는 **설치 재료**입니다.
->   이 폴더의 파일은 plugin spec의 일부가 아닙니다.
->
-> 에이전트를 실제로 활성화하려면 install 단계에서 `agents/*.toml`을 `~/.codex/agents/`에 배치하고,
-> `config.fragment.toml`을 `~/.codex/config.toml`에 병합해야 합니다.
-
-## 빠른 시작
-
-### 1. 이 템플릿으로 새 플러그인 생성
-
-```bash
-bunx @moreih29/nexus-core init --harness=codex --target=./my-codex-plugin
-cd my-codex-plugin
-bun install
-```
-
-### 2. 자산 동기화
-
-```bash
-bunx @moreih29/nexus-core sync --harness=codex --target=./
-```
-
-동기화 후 생성되는 파일:
-
-- `plugin/.codex-plugin/plugin.json` — 플러그인 매니페스트
-- `plugin/skills/<name>/SKILL.md` × N
-- `agents/<name>.toml` × N — `[agents.<id>]` 테이블 형식
-- `prompts/<name>.md` × N — YAML frontmatter + 프롬프트 본문
-- `install/config.fragment.toml` — `~/.codex/config.toml`에 병합할 스니펫
-- `install/AGENTS.fragment.md` — `AGENTS.md`에 병합할 primary agent 프롬프트 (mode: primary agent 존재 시)
-
-### 3. 변경 내용 커밋
-
-```bash
-git add plugin/ agents/ prompts/ install/
-git commit -m "Sync nexus-core assets"
-```
-
-## 컨슈머 install 흐름
-
-Codex 에이전트는 user scope(`~/.codex/`)에 직접 배치해야 활성화됩니다.
-플러그인 repo의 install 명령(또는 스크립트)이 이 작업을 수행합니다.
-
-```bash
-# 예: install.sh
-cat install/config.fragment.toml >> ~/.codex/config.toml
-cp -r agents/ ~/.codex/agents/
-```
-
-`install/config.fragment.toml`에는 MCP 서버 등록이 포함됩니다.
-
-```toml
-[mcp_servers.nx]
-command = "nexus-mcp"
-```
-
-**block-marker 패턴** 사용 권장: 기존 `~/.codex/config.toml`을 덮어쓰지 않고
-`# BEGIN my-plugin` / `# END my-plugin` 마커 사이만 교체합니다.
-oh-my-codex의 `omx setup` 패턴을 참고하세요.
-
-## 플러그인 마켓플레이스 등록
-
-`~/.agents/plugins/marketplace.json`에 GitHub 소스 또는 로컬 경로로 등록합니다.
-
-```json
-{
-  "plugins": [
-    {
-      "source": {
-        "type": "github",
-        "repo": "your-org/my-codex-plugin",
-        "ref": "v1.0.0",
-        "path": "plugin"
-      }
-    }
-  ]
-}
-```
-
-## CLI 참조
-
-```bash
-bunx @moreih29/nexus-core sync --harness=codex --target=<dir>   # 자산 동기화
-bunx @moreih29/nexus-core sync --harness=codex --dry-run        # 변경될 파일 목록만 출력 (쓰기 없음)
-bunx @moreih29/nexus-core sync --harness=codex --force          # Template 경로 강제 덮어쓰기 확인
-bunx @moreih29/nexus-core sync --harness=codex --strict         # Managed 파일의 미커밋 변경 시 오류
-bunx @moreih29/nexus-core list                                   # 사용 가능한 에이전트·스킬 목록
-```
-
-전역 설치(`bun add -g @moreih29/nexus-core`) 환경에서는 `nexus-core <cmd>` 형태로도 사용할 수 있습니다.
-
-## Lead Agent AGENTS.md 머지
-
-sync 결과물 중 `install/AGENTS.fragment.md`는 Codex의 AGENTS.md 자동 로드 경로에 주입할 lead agent body를 포함합니다.
-
-Codex는 main agent의 system prompt를 주입하는 공식 경로를 제공하지 않으므로, nexus-core는 이 fragment를 사용자의 `AGENTS.md`에 자동으로 병합하지 않습니다. consumer가 직접 fragment 내용을 `~/.codex/AGENTS.md`(글로벌) 또는 레포 루트 `AGENTS.md`(프로젝트)에 복사해야 합니다. 마커(`<!-- nexus-core:lead:start -->` / `<!-- nexus-core:lead:end -->`)를 포함해 복사해야 이후 업데이트 시 구역을 정확히 교체할 수 있습니다.
-
-자세한 절차는 [`docs/consuming/codex-lead-merge.md`](../../consuming/codex-lead-merge.md)를 참조하세요.
-
-## 주의사항
-
-- `plugin/`, `agents/`, `prompts/`, `install/` 내 파일을 직접 편집하지 마세요. 다음 sync 시 덮어씁니다.
-- Codex native agent의 외부 TOML 파일 필드 구조는 공식 문서에 일부 미기재 영역이 있습니다. 실제 동작은 Codex 공식 사례를 병행 확인하세요.
-- npm 기반 Codex 플러그인 설치는 공식 지원 여부가 확인되지 않았습니다. 로컬 경로 또는 GitHub 소스 방식을 사용하세요.

package/docs/plugin-template/codex/install/install.sh

@@ -1,60 +0,0 @@
-#!/usr/bin/env bash
-# Codex plugin installer — block-marker merge pattern.
-# nexus-core Model 2: wrapper owns integration seams.
-# Merges config.fragment.toml into ~/.codex/config.toml,
-# copies native agent TOMLs to ~/.codex/agents/,
-# and merges AGENTS.fragment.md into ~/.codex/AGENTS.md.
-set -euo pipefail
-
-PLUGIN_NAME="${PLUGIN_NAME:-codex-nexus}"
-CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-
-mkdir -p "$CODEX_HOME" "$CODEX_HOME/agents" "$CODEX_HOME/plugins"
-
-# 1. config.toml — block-marker merge
-MARKER_BEGIN="# BEGIN ${PLUGIN_NAME}"
-MARKER_END="# END ${PLUGIN_NAME}"
-CONFIG="$CODEX_HOME/config.toml"
-CONFIG_FRAGMENT="$SCRIPT_DIR/config.fragment.toml"
-
-touch "$CONFIG"
-if grep -q "${MARKER_BEGIN}" "$CONFIG" 2>/dev/null; then
-  sed -i.bak "/${MARKER_BEGIN}/,/${MARKER_END}/d" "$CONFIG"
-fi
-{
-  echo ""
-  echo "${MARKER_BEGIN}"
-  cat "$CONFIG_FRAGMENT"
-  echo "${MARKER_END}"
-} >> "$CONFIG"
-
-# 2. native agent TOMLs
-cp "$REPO_ROOT"/agents/*.toml "$CODEX_HOME/agents/" 2>/dev/null || true
-
-# 3. plugin body → ~/.codex/plugins/<name>/
-PLUGIN_DEST="$CODEX_HOME/plugins/${PLUGIN_NAME}"
-rm -rf "$PLUGIN_DEST"
-mkdir -p "$PLUGIN_DEST"
-cp -R "$REPO_ROOT"/plugin/. "$PLUGIN_DEST/"
-
-# 4. AGENTS.md — block-marker merge
-AGENTS_TARGET="$CODEX_HOME/AGENTS.md"
-AGENTS_FRAGMENT="$SCRIPT_DIR/AGENTS.fragment.md"
-FRAG_BEGIN="<!-- nexus-core:lead:start -->"
-FRAG_END="<!-- nexus-core:lead:end -->"
-
-if [ -f "$AGENTS_FRAGMENT" ]; then
-  touch "$AGENTS_TARGET"
-  if grep -q "${FRAG_BEGIN}" "$AGENTS_TARGET" 2>/dev/null; then
-    awk -v begin="${FRAG_BEGIN}" -v end="${FRAG_END}" '
-      $0 ~ begin { skip=1; next }
-      $0 ~ end { skip=0; next }
-      !skip { print }
-    ' "$AGENTS_TARGET" > "$AGENTS_TARGET.tmp" && mv "$AGENTS_TARGET.tmp" "$AGENTS_TARGET"
-  fi
-  cat "$AGENTS_FRAGMENT" >> "$AGENTS_TARGET"
-fi
-
-echo "Installed ${PLUGIN_NAME} → $CODEX_HOME"

package/docs/plugin-template/codex/package.json

@@ -1,17 +0,0 @@
-{
-  "name": "<my-codex-plugin>",
-  "version": "1.0.0",
-  "description": "Codex plugin powered by nexus-core",
-  "private": true,
-  "scripts": {
-    "sync": "bunx @moreih29/nexus-core sync --harness=codex --target=./",
-    "sync:dry": "bunx @moreih29/nexus-core sync --harness=codex --target=./ --dry-run",
-    "build": "bun run sync",
-    "validate": "bunx @moreih29/nexus-core validate",
-    "list": "bunx @moreih29/nexus-core list",
-    "install-plugin": "bash install/install.sh"
-  },
-  "devDependencies": {
-    "@moreih29/nexus-core": "^0.13.0"
-  }
-}

package/docs/plugin-template/opencode/.github/workflows/build.yml

@@ -1,61 +0,0 @@
-name: Build
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  sync-verify:
-    name: Verify nexus-core sync
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - name: Install dependencies
-        run: bun install
-
-      - name: Run sync
-        run: bunx @moreih29/nexus-core sync --harness=opencode --target=./
-
-      - name: Check for uncommitted changes
-        run: |
-          git diff --exit-code || (
-            echo "Sync produced uncommitted changes. Run 'bun run sync' and commit the result."
-            exit 1
-          )
-
-      - name: Type check
-        run: bun x tsc --noEmit
-
-      - name: Validate assets
-        run: bunx @moreih29/nexus-core validate
-
-  publish:
-    name: Publish to npm
-    runs-on: ubuntu-latest
-    needs: sync-verify
-    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - name: Install dependencies
-        run: bun install
-
-      - name: Run sync
-        run: bunx @moreih29/nexus-core sync --harness=opencode --target=./
-
-      # npm publish는 프로젝트 요구에 맞게 조정하세요 (예: changesets, semantic-release 등).
-      # - name: Publish
-      #   run: npm publish --access public
-      #   env:
-      #     NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/docs/plugin-template/opencode/README.md

@@ -1,121 +0,0 @@
-# OpenCode Plugin Scaffold — nexus-core
-
-이 디렉터리는 `nexus-core init --harness=opencode` 명령으로 복사되는 OpenCode 플러그인 스타터입니다.
-
-## 개요
-
-nexus-core가 공통 에이전트·스킬 자산을 이 플러그인 repo에 동기화(sync)합니다.
-OpenCode 플러그인은 npm 패키지로 배포되며, 컨슈머의 `opencode.json`에 패키지명을 등록하면
-OpenCode가 시작 시 자동으로 설치·로드합니다.
-
-## 디렉터리 구조
-
-```
-my-opencode-plugin/
-├── src/
-│   ├── index.ts             # Managed — nexus-core sync가 덮어씀 (에이전트 re-export)
-│   └── agents/              # Managed — nexus-core sync가 덮어씀
-│       └── <agent-name>.ts
-├── .opencode/
-│   └── skills/              # Managed — nexus-core sync가 덮어씀
-│       └── <skill-name>/
-│           └── SKILL.md
-├── opencode.json.fragment   # Managed — opencode.json 병합용 에이전트 목록 스니펫
-├── package.json             # Template — 처음 한 번만 생성
-├── tsconfig.json            # 직접 관리
-└── .github/
-    └── workflows/
-        └── build.yml
-```
-
-**Managed** 경로(`src/`, `.opencode/skills/`, `opencode.json.fragment`)는 `nexus-core sync`가 항상 최신 상태로 유지합니다.
-**Template** 경로(`package.json`)는 처음 한 번만 생성됩니다.
-
-## 빠른 시작
-
-### 1. 이 템플릿으로 새 플러그인 생성
-
-```bash
-bunx @moreih29/nexus-core init --harness=opencode --target=./my-opencode-plugin
-cd my-opencode-plugin
-bun install
-```
-
-### 2. 자산 동기화
-
-```bash
-bunx @moreih29/nexus-core sync --harness=opencode --target=./
-```
-
-동기화 후 생성되는 파일:
-
-- `src/index.ts` — 에이전트 전체 re-export
-- `src/agents/<name>.ts` × N — 각 에이전트 `AgentConfig` 객체
-- `.opencode/skills/<name>/SKILL.md` × N
-- `opencode.json.fragment` — 컨슈머 `opencode.json`에 병합할 `agents` 배열 스니펫
-
-### 3. 변경 내용 커밋
-
-```bash
-git add src/ .opencode/ opencode.json.fragment
-git commit -m "Sync nexus-core assets"
-```
-
-## 컨슈머 설치 안내
-
-플러그인을 사용하는 프로젝트의 `.opencode/opencode.json`에 패키지명을 추가합니다.
-
-```json
-{
-  "plugin": ["@your-org/my-opencode-plugin"]
-}
-```
-
-OpenCode가 시작 시 Bun으로 자동 설치합니다. 캐시 위치: `~/.cache/opencode/node_modules/`.
-
-에이전트를 활성화하려면 `opencode.json.fragment`의 내용을 컨슈머의 `opencode.json`에 병합하거나,
-`postinstall` 스크립트로 자동화하세요.
-
-```json
-{
-  "agents": [
-    {
-      "id": "architect",
-      "module": "./node_modules/@your-org/my-opencode-plugin/src/agents/architect.js"
-    }
-  ]
-}
-```
-
-## package.json 커스터마이즈
-
-`package.json`의 `name`과 `version`을 실제 npm 패키지명으로 변경하세요.
-
-```json
-{
-  "name": "@your-org/my-opencode-plugin",
-  "version": "1.0.0",
-  "type": "module",
-  "main": "./src/index.ts"
-}
-```
-
-`"type": "module"`과 `"main": "./src/index.ts"`는 OpenCode가 TypeScript를 직접 로드하므로 변경하지 마세요.
-
-## CLI 참조
-
-```bash
-bunx @moreih29/nexus-core sync --harness=opencode --target=<dir>   # 자산 동기화
-bunx @moreih29/nexus-core sync --harness=opencode --dry-run        # 변경될 파일 목록만 출력 (쓰기 없음)
-bunx @moreih29/nexus-core sync --harness=opencode --force          # Template 파일도 강제 덮어쓰기
-bunx @moreih29/nexus-core sync --harness=opencode --strict         # Managed 파일의 미커밋 변경 시 오류
-bunx @moreih29/nexus-core list                                      # 사용 가능한 에이전트·스킬 목록
-```
-
-전역 설치(`bun add -g @moreih29/nexus-core`) 환경에서는 `nexus-core <cmd>` 형태로도 사용할 수 있습니다.
-
-## 주의사항
-
-- `src/agents/`, `src/index.ts`, `.opencode/skills/`는 직접 편집하지 마세요. 다음 sync 시 덮어씁니다.
-- OpenCode는 `plugin` 배열의 항목을 npm 패키지로 인식합니다. git URL 기반 설치의 공식 지원 여부는 확인되지 않았습니다.
-- 플러그인 코드 훅(`session.created` 등)이 필요하면 `src/plugin.ts`를 직접 추가하고 `package.json`의 `main`을 해당 파일로 변경하세요.

package/docs/plugin-template/opencode/package.json

@@ -1,25 +0,0 @@
-{
-  "name": "@your-org/my-opencode-plugin",
-  "version": "1.0.0",
-  "description": "OpenCode plugin powered by nexus-core",
-  "type": "module",
-  "main": "./src/index.ts",
-  "exports": {
-    ".": "./src/index.ts"
-  },
-  "scripts": {
-    "sync": "bunx @moreih29/nexus-core sync --harness=opencode --target=./",
-    "sync:dry": "bunx @moreih29/nexus-core sync --harness=opencode --target=./ --dry-run",
-    "build": "bun run sync && tsc --noEmit",
-    "validate": "bunx @moreih29/nexus-core validate",
-    "list": "bunx @moreih29/nexus-core list"
-  },
-  "peerDependencies": {
-    "opencode": "*"
-  },
-  "devDependencies": {
-    "@moreih29/nexus-core": "^0.13.0",
-    "@opencode-ai/plugin": "*",
-    "typescript": "^5"
-  }
-}

package/docs/plugin-template/opencode/src/plugin.ts

@@ -1,6 +0,0 @@
-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" };
-
-export const OpencodeNexus: Plugin = async (ctx) => mountHooks(ctx, manifest);
-export default OpencodeNexus;