agent-plugkit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agent-plugkit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,295 @@
+# agent-plugkit
+
+`agent-plugkit` is a CLI-first toolkit for building and maintaining AI agent plugin marketplaces.
+
+It lets you keep plugin metadata in one declarative `plugin.yaml`, then generate an [Agent Plugins 1.0](https://agent-plugins.org/specification) portable package, Claude Code and Codex native artifacts, and client marketplace indexes from that source.
+
+## Why
+
+AI coding agent ecosystems now have rules sync tools, Agent Skills, content marketplaces, MCP registries, and platform-native plugin formats. `agent-plugkit` focuses on one narrower job: helping teams operate a structured plugin marketplace repository without hand-editing every platform manifest.
+
+It is not a rules synchronizer like Ruler or LNAI, and it is not a content catalog like wshobson/agents. It is the maintenance toolchain for your own marketplace.
+
+## Install
+
+```bash
+npx agent-plugkit --help
+```
+
+For a repository that wants a pinned version:
+
+```bash
+npm install --save-dev agent-plugkit
+```
+
+## Commands
+
+```bash
+npx agent-plugkit init-repo [name] --organization "Team Name" [--no-plugkit]
+npx agent-plugkit init <plugin-name> --type <skill|mcp|lsp|hook>
+npx agent-plugkit add <skill|mcp|lsp|hook> <plugin-name> <component-name>
+npx agent-plugkit import-skill <source-dir> [plugin-name] [--description "..."] [--author "..."]
+npx agent-plugkit build [plugin-name] --all
+npx agent-plugkit index
+npx agent-plugkit validate [plugin-name] --all
+npx agent-plugkit release-local
+npx agent-plugkit install-repo <git-repo|local-path> [--agent <agent>...] [--all]
+```
+
+Use `--root <dir>` when running from outside a marketplace repository:
+
+```bash
+npx agent-plugkit --root /path/to/marketplace validate --all
+```
+
+## Marketplace Shape
+
+```text
+.
+├── marketplace.yaml
+├── plugins/
+│   ├── plugkit/
+│   │   ├── plugin.yaml
+│   │   └── skills/
+│   │       ├── setup/
+│   │       │   └── SKILL.md
+│   │       └── maintain/
+│   │           └── SKILL.md
+│   └── my-plugin/
+│       ├── plugin.yaml
+│       ├── plugin.json
+│       ├── mcp.json              # only when MCP servers are declared
+│       └── skills/
+├── .github/plugin/marketplace.json
+├── .cursor-plugin/marketplace.json
+├── .claude-plugin/marketplace.json
+├── .agents/plugins/marketplace.json
+└── marketplace.json
+```
+
+Each plugin owns a `plugin.yaml`:
+
+```yaml
+name: my-plugin
+version: "0.1.0"
+description: "Describe the plugin"
+author:
+  name: "Team Name"
+category: tooling
+tags: []
+
+components:
+  skills:
+    - name: my-plugin
+      path: skills/my-plugin
+      description: "Skill description"
+
+platform:
+  codex:
+    interface:
+      displayName: "My Plugin"
+      capabilities: ["Interactive", "Write"]
+      defaultPrompt:
+        - "Help me use My Plugin."
+```
+
+The canonical `name` is also the portable package identifier: use 2–64 lowercase letters,
+digits, or single hyphens, with an alphanumeric first and last character; consecutive `--` is
+rejected before any Agent Plugins manifest is generated.
+
+`platform.codex.interface` is optional. `capabilities` is an array of non-empty strings;
+`defaultPrompt` accepts one to three non-empty strings of at most 128 characters each. When these
+fields are omitted, the Codex adapter emits `capabilities: []` and a safe
+`defaultPrompt: ["Help me use <Display Name>."]` fallback. Optional `author.email` and `author.url`
+are omitted from the Codex manifest when they are not declared instead of being written as empty
+strings.
+
+Supported components:
+
+- `skills`: Agent Skills instruction directories discovered strictly as `skills/<name>/SKILL.md`; `validate` checks the required frontmatter, directory/name match, and declared/discovered set.
+- `mcp`: MCP server metadata. Legacy or explicit `stdio` supports `command`, `args`, `env`, and `cwd`; `streamable-http` and `sse` support `url` and `headers`.
+- `hooks`: Claude Code hook configuration. The current Codex ingestion manifest does not accept a `hooks` field, so the Codex adapter deliberately omits it.
+- `lsp`: Claude Code LSP configuration. Pair it with a skill when Codex strategy guidance is needed.
+
+Optional portable metadata can be declared as `homepage`, `repository`, and `license` alongside the existing author and tag fields. Transport path, URL, and header safety is validated before delivery; invalid servers are never silently dropped or converted to another transport. MCP `env` and `headers` are visible package data, not portable secret or OAuth mechanisms—do not place credentials in them.
+
+## Agent Plugins and Client Marketplaces
+
+`agent-plugkit build` emits the fixed Agent Plugins 1.0.0 portable contract at each plugin root:
+
+- `plugin.json` with the canonical 1.0.0 schema identifier.
+- `skills/<name>/SKILL.md` as the protocol-discovered Skill set.
+- `mcp.json` when MCP servers are declared.
+
+Agent Plugins 1.0 standardizes portable Skills and MCP servers. Hooks, LSP configuration, installation sources, registries, and marketplace/update policy remain client-specific. That boundary follows the [Agent Plugins client implementer guidance](https://agent-plugins.org/client-implementers); the client indexes below are distribution adapters, not fields in the portable manifest.
+
+After a repository is available to its intended users, `install-repo` registers its generated
+indexes with selected clients:
+
+```bash
+npx agent-plugkit install-repo OWNER/REPO
+npx agent-plugkit install-repo OWNER/REPO --agent claude --agent codex
+npx agent-plugkit install-repo /absolute/path/to/marketplace --all
+```
+
+Without `--agent` or `--all`, an interactive terminal shows a numbered multi-select and defaults to
+the targets that can currently be handled automatically. Non-interactive callers must pass an
+explicit selection. Target IDs are `claude`, `codex`, `copilot`, `vscode`, and `cursor`; repeated
+`--agent` values are deduplicated and `--all` includes Cursor.
+
+Client behavior is deliberately adapter-specific:
+
+- Claude Code runs `claude plugin marketplace add <source>` after probing that exact command.
+- Codex runs `codex plugin marketplace add <source>` after probing that exact command.
+- GitHub Copilot runs `copilot plugin marketplace add <source>` after probing that exact command.
+- VS Code atomically updates the current user's JSONC `settings.json`, enables
+  `chat.plugins.enabled`, and deduplicates `chat.plugins.marketplaces`. Local directories are stored
+  as `file://` URIs. Comments, trailing commas, indentation, unrelated settings, and the existing
+  file mode are preserved. Only a safe absolute user configuration root and lossless UTF-8 input
+  are accepted. If deduplication cannot retain existing comments, or the file is malformed or
+  a revision/guard check detects a concurrent change, registration fails without overwriting it.
+  This is a pure Node best-effort transaction rather than filesystem compare-and-swap: an
+  uncooperative writer that atomically replaces the path with a new inode after the last observable
+  check but before either candidate commit or guard-content recovery rename can still be overwritten.
+  Failure output therefore directs users to inspect the current file instead of claiming every
+  failure left the original untouched. A local Marketplace cannot contain, equal, or resolve through
+  a symlink to the selected VS Code user settings path.
+- Cursor remains selectable but returns a manual task: Team/Enterprise administrators use
+  Dashboard → Plugins → Add Marketplace → Import from Repo. No private cache, database, or
+  undocumented Cursor command is touched.
+
+Accepted sources are an existing local directory, `owner/repo`, an HTTPS Git URL, or an SSH Git
+URL. Missing path-like inputs, ambiguous bare values, option-like values, non-HTTPS Web URLs, and
+sources containing C0/C1/DEL control characters (including percent-decoded URL controls), dot-only
+Git shorthand segments, or embedded URL credentials are rejected before any client action. A local directory must already contain the selected client's generated index;
+`install-repo` never builds or repairs it.
+
+Each target is processed in a fixed order and a failure does not stop later targets unless a user or
+child-process interrupt occurs. The final text summary uses explicit labels such as `[完成]`,
+`[缺少 CLI]`, `[需手动]`, and `[失败]`:
+
+| Exit code | Meaning |
+| --- | --- |
+| `0` | Every selected target completed registration or VS Code configuration injection |
+| `2` | At least one target completed and at least one target is missing, manual, or failed |
+| `1` | No target completed, or source/argument preflight failed |
+| `130` | The user or a client process interrupted the run |
+
+The generated indexes still support direct client flows when needed:
+
+- GitHub Copilot CLI checks root `marketplace.json` before `.github/plugin/marketplace.json`; `agent-plugkit` emits the same client-compatible bytes at both paths so the legacy root mirror cannot shadow the canonical GitHub index. The Claude path remains a client fallback:
+
+  ```bash
+  copilot plugin marketplace add OWNER/REPO
+  copilot plugin install PLUGIN_NAME@MARKETPLACE_NAME
+  ```
+
+- VS Code can register the same Git marketplace in `settings.json`, then install from the Agent Plugins view or Agent Customizations editor:
+
+  ```json
+  {
+    "chat.plugins.marketplaces": ["OWNER/REPO"]
+  }
+  ```
+
+- Cursor Team/Enterprise can use Dashboard → Plugins → Add Marketplace → Import from Repo. Cursor detects the root Agent Plugins `plugin.json` for entries referenced by `.cursor-plugin/marketplace.json`.
+
+`install-repo` performs only current-user Marketplace registration or VS Code configuration. It
+does not push or publish a Git repository, build or modify the source, install a missing client CLI,
+import into Cursor automatically, or install any plugin from the Marketplace. `release-local` only
+creates a checked local directory and tar archive.
+
+## Importing an Existing Skill
+
+`agent-plugkit import-skill <source-dir> [plugin-name]` turns a skill that already exists on disk into a new, single-skill plugin — no template placeholders to fill in by hand.
+
+```bash
+npx agent-plugkit import-skill ~/.claude/skills/dataviz
+npx agent-plugkit import-skill ~/.claude/skills/dataviz custom-name --description "..." --author "..."
+```
+
+- **One skill in, one plugin out.** It always creates a brand-new plugin (`plugins/<name>/`); it does not add a skill to an existing plugin and does not import multiple skills in one call.
+- **Two local source shapes are accepted**: a directory containing `SKILL.md` directly, or an existing plugin-shaped directory with a `skills/` subfolder — when that subfolder holds exactly one skill, it is selected automatically. Pointing at a single `SKILL.md` file or a remote git/npm source is not supported.
+- **`SKILL.md` is copied byte-for-byte and never rewritten.** `plugin.yaml` metadata (`name`, `description`, `argument-hint`) is derived from the source `SKILL.md` frontmatter, with `[plugin-name]`, `--description`, and `--author` as explicit overrides. Any mismatch between the frontmatter and the derived plugin name is reported as a warning, not silently fixed by editing the source file.
+- Like `init` and `add`, it only prints next-step guidance (`build` / `validate`) — it does not run them automatically.
+
+## Generated Artifacts
+
+`agent-plugkit build` writes plugin-level artifacts:
+
+- `plugins/**/plugin.json`
+- `plugins/**/mcp.json` (when MCP servers are declared)
+- `plugins/**/.claude-plugin/plugin.json`
+- `plugins/**/.codex-plugin/plugin.json`
+- `plugins/**/.mcp.json`
+- `plugins/**/.lsp.json`
+- `plugins/**/hooks/hooks.json`
+
+`agent-plugkit index` writes marketplace-level artifacts:
+
+- `.github/plugin/marketplace.json`
+- `.cursor-plugin/marketplace.json`
+- `.claude-plugin/marketplace.json`
+- `.agents/plugins/marketplace.json`
+- `marketplace.json`
+- `plugins/CATALOG.md`
+
+Generated files should be regenerated, not edited by hand.
+
+## Recommended Scripts
+
+`agent-plugkit init-repo` writes scripts like these:
+
+```json
+{
+  "scripts": {
+    "mp": "npx agent-plugkit",
+    "validate:plugins": "npx agent-plugkit validate --all",
+    "build:plugins": "npx agent-plugkit build --all",
+    "build:index": "npx agent-plugkit index",
+    "build:all": "npm run build:plugins && npm run build:index",
+    "ci:local": "npm run build:all && npm run validate:plugins",
+    "release:local": "npm run ci:local && npx agent-plugkit release-local"
+  }
+}
+```
+
+## This Monorepo Includes a Marketplace
+
+`agent-plugkit` dogfoods itself through the monorepo's `marketplace/` workspace, currently hosting the official `plugkit` maintenance plugin and the bundled `mermaid-render` visualization plugin. All canonical YAML, plugins, generated indexes, and local release artifacts live under that workspace.
+
+The repository root deliberately does not mirror marketplace discovery files. Clients may use a checkout's `marketplace/` directory as a local marketplace; registering this whole Git repository as a remote marketplace is not supported. Remote distribution requires publishing that workspace as its own repository or equivalent marketplace root.
+
+### Mermaid Render
+
+`mermaid-render@0.2.0` turns Mermaid into a designed visual through two independent paths: editable `html`, or direct `imagent` image creation that may actively illustrate individual nodes. Imagent does not render, screenshot, or imitate an HTML intermediate.
+
+The built-in art directions are Swiss Style, Neo-Brutalism, and JAPANESE MA. They are concise design definitions with a few Good/Bad cases—not fixed templates, reference-image hashes, layout algorithms, or theme presets—so the Agent retains room to make diagram-specific visual decisions.
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+npm run mp:check   # build --all + index + validate --all against marketplace/
+npm run pack:cli
+```
+
+### Desktop status
+
+The previous private desktop workspace was removed on 2026-08-15. The current product and
+distribution surface is CLI-only. Historical desktop specifications and design evidence remain
+for traceability, but they are superseded by
+[ADR-0006](https://github.com/agent-plugkit/agent-plugkit/blob/main/docs/adr/0006-remove-desktop-implementation.md); any future desktop rebuild starts from
+a new confirmed product, design, and engineering contract.
+
+The public contract is the CLI, `marketplace.yaml`, `plugin.yaml`, and generated marketplace artifacts. Internal TypeScript functions are intentionally not documented as a Node library API yet (see [ADR-0001](https://github.com/agent-plugkit/agent-plugkit/blob/main/docs/adr/0001-cli-only-public-contract.md)).
+
+## Project Docs
+
+- [`AGENTS.md`](https://github.com/agent-plugkit/agent-plugkit/blob/main/AGENTS.md) — repository rules, architecture boundaries, and definition of done.
+- [`docs/architecture/overview.md`](https://github.com/agent-plugkit/agent-plugkit/blob/main/docs/architecture/overview.md) — layering, invariants, and known debt.
+- [`docs/product/`](https://github.com/agent-plugkit/agent-plugkit/tree/main/docs/product) — positioning, roadmap, market research, risks.
+- [`docs/release/`](https://github.com/agent-plugkit/agent-plugkit/tree/main/docs/release) — release plan and gates.
+- [`specs/`](https://github.com/agent-plugkit/agent-plugkit/tree/main/specs) — per-iteration scope, specs, and task lists.

package/dist/adapters/agent-plugins.d.ts

@@ -0,0 +1,35 @@
+import type { PluginYaml } from '../schema/plugin-yaml.js';
+export declare const AGENT_PLUGINS_VERSION = "1.0.0";
+export declare const AGENT_PLUGIN_SCHEMA_ID: "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
+export declare const AGENT_PLUGIN_MCP_SCHEMA_ID: "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json";
+export interface AgentPluginManifest {
+    $schema: typeof AGENT_PLUGIN_SCHEMA_ID;
+    name: string;
+    version?: string;
+    description?: string;
+    author?: {
+        name: string;
+        email?: string;
+        url?: string;
+    };
+    homepage?: string;
+    repository?: string;
+    license?: string;
+    keywords?: string[];
+}
+export interface AgentPluginMcpConfig {
+    $schema: typeof AGENT_PLUGIN_MCP_SCHEMA_ID;
+    mcpServers: Record<string, {
+        type: 'stdio';
+        command: string;
+        args?: string[];
+        env?: Record<string, string>;
+        cwd?: string;
+    } | {
+        type: 'streamable-http' | 'sse';
+        url: string;
+        headers?: Record<string, string>;
+    }>;
+}
+export declare function buildAgentPluginManifest(config: PluginYaml): AgentPluginManifest;
+export declare function buildAgentPluginMcpConfig(config: PluginYaml): AgentPluginMcpConfig | null;

package/dist/adapters/agent-plugins.js

@@ -0,0 +1,57 @@
+import { isStdioMcp } from './mcp.js';
+export const AGENT_PLUGINS_VERSION = '1.0.0';
+export const AGENT_PLUGIN_SCHEMA_ID = `https://agent-plugins.org/schemas/${AGENT_PLUGINS_VERSION}/plugin.schema.json`;
+export const AGENT_PLUGIN_MCP_SCHEMA_ID = `https://agent-plugins.org/schemas/${AGENT_PLUGINS_VERSION}/mcp.schema.json`;
+export function buildAgentPluginManifest(config) {
+    return {
+        $schema: AGENT_PLUGIN_SCHEMA_ID,
+        name: config.name,
+        version: config.version,
+        description: config.description,
+        author: {
+            name: config.author.name,
+            ...(typeof config.author.email === 'string'
+                ? { email: config.author.email }
+                : {}),
+            ...(typeof config.author.url === 'string'
+                ? { url: config.author.url }
+                : {}),
+        },
+        ...(typeof config.homepage === 'string'
+            ? { homepage: config.homepage }
+            : {}),
+        ...(typeof config.repository === 'string'
+            ? { repository: config.repository }
+            : {}),
+        ...(typeof config.license === 'string' ? { license: config.license } : {}),
+        ...(config.tags ? { keywords: config.tags } : {}),
+    };
+}
+export function buildAgentPluginMcpConfig(config) {
+    const mcps = config.components.mcp;
+    if (!mcps || mcps.length === 0)
+        return null;
+    const servers = {};
+    for (const mcp of mcps) {
+        if (isStdioMcp(mcp)) {
+            servers[mcp.name] = {
+                type: 'stdio',
+                command: mcp.command,
+                ...(mcp.args ? { args: mcp.args } : {}),
+                ...(mcp.env ? { env: mcp.env } : {}),
+                ...(mcp.cwd ? { cwd: mcp.cwd } : {}),
+            };
+            continue;
+        }
+        servers[mcp.name] = {
+            type: mcp.type,
+            url: mcp.url,
+            ...(mcp.headers ? { headers: mcp.headers } : {}),
+        };
+    }
+    return {
+        $schema: AGENT_PLUGIN_MCP_SCHEMA_ID,
+        mcpServers: servers,
+    };
+}
+//# sourceMappingURL=agent-plugins.js.map

package/dist/adapters/agent-plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-plugins.js","sourceRoot":"","sources":["../../src/adapters/agent-plugins.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAC7C,MAAM,CAAC,MAAM,sBAAsB,GACjC,qCAAqC,qBAAqB,qBAA8B,CAAC;AAC3F,MAAM,CAAC,MAAM,0BAA0B,GACrC,qCAAqC,qBAAqB,kBAA2B,CAAC;AAqCxF,MAAM,UAAU,wBAAwB,CAAC,MAAkB;IACzD,OAAO;QACL,OAAO,EAAE,sBAAsB;QAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE;YACN,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI;YACxB,GAAG,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,QAAQ;gBACzC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;gBAChC,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,QAAQ;gBACvC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE;gBAC5B,CAAC,CAAC,EAAE,CAAC;SACR;QACD,GAAG,CAAC,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;YACrC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;YAC/B,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;YACvC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE;YACnC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,MAAkB;IAElB,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC;IACnC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5C,MAAM,OAAO,GAAuC,EAAE,CAAC;IACvD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG;gBAClB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrC,CAAC;YACF,SAAS;QACX,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG;YAClB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,0BAA0B;QACnC,UAAU,EAAE,OAAO;KACpB,CAAC;AACJ,CAAC"}

package/dist/adapters/claude.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Claude Code 适配器
+ *
+ * 从 plugin.yaml 生成 .claude-plugin/plugin.json 和相关配置文件。
+ *
+ * Claude Code 插件结构约定：
+ * - .claude-plugin/plugin.json — manifest
+ * - skills/<name>/SKILL.md — skill 文件（已在源码中维护，无需生成）
+ * - hooks/hooks.json — hook 配置（如果有 hooks 组件）
+ * - .mcp.json — MCP server 配置（如果有 mcp 组件）
+ * - .lsp.json — LSP server 配置（如果有 lsp 组件）
+ */
+import type { PluginLspTransport, PluginYaml } from '../schema/plugin-yaml.js';
+import { type NativeMcpConfig } from './mcp.js';
+export interface ClaudeManifest {
+    name: string;
+    version: string;
+    description: string;
+    author: {
+        name: string;
+    };
+}
+export interface ClaudeHooksConfig {
+    hooks: Record<string, Array<{
+        matcher: string;
+        hooks: Array<{
+            type: 'command';
+            command: string;
+            timeout?: number;
+        }>;
+    }>>;
+}
+export type ClaudeMcpConfig = NativeMcpConfig;
+export type ClaudeLspConfig = Record<string, {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    transport?: PluginLspTransport;
+    extensionToLanguage: Record<string, string>;
+    workspaceFolder?: string;
+    startupTimeout?: number;
+    maxRestarts?: number;
+    diagnostics?: boolean;
+}>;
+/**
+ * 生成 Claude Code 的 .claude-plugin/plugin.json
+ */
+export declare function buildClaudeManifest(config: PluginYaml): ClaudeManifest;
+/**
+ * 生成 Claude Code 的 hooks/hooks.json（如果有 hooks 组件）
+ */
+export declare function buildClaudeHooksConfig(config: PluginYaml): ClaudeHooksConfig | null;
+/**
+ * 生成 Claude Code 的 .mcp.json（如果有 mcp 组件）
+ */
+export declare function buildClaudeMcpConfig(config: PluginYaml): ClaudeMcpConfig | null;
+/**
+ * 生成 Claude Code 的 .lsp.json（如果有 lsp 组件）
+ */
+export declare function buildLspConfig(config: PluginYaml): ClaudeLspConfig | null;
+/**
+ * 将 Claude Code 兼容的文件写入插件目录
+ */
+export declare function generateClaude(config: PluginYaml, pluginDir: string): void;

package/dist/adapters/claude.js

@@ -0,0 +1,123 @@
+/**
+ * Claude Code 适配器
+ *
+ * 从 plugin.yaml 生成 .claude-plugin/plugin.json 和相关配置文件。
+ *
+ * Claude Code 插件结构约定：
+ * - .claude-plugin/plugin.json — manifest
+ * - skills/<name>/SKILL.md — skill 文件（已在源码中维护，无需生成）
+ * - hooks/hooks.json — hook 配置（如果有 hooks 组件）
+ * - .mcp.json — MCP server 配置（如果有 mcp 组件）
+ * - .lsp.json — LSP server 配置（如果有 lsp 组件）
+ */
+import { mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { buildNativeMcpConfig, } from './mcp.js';
+function isPresent(value) {
+    return value != null;
+}
+/**
+ * 生成 Claude Code 的 .claude-plugin/plugin.json
+ */
+export function buildClaudeManifest(config) {
+    return {
+        name: config.name,
+        version: config.version,
+        description: config.description,
+        author: { name: config.author.name },
+    };
+}
+/**
+ * 生成 Claude Code 的 hooks/hooks.json（如果有 hooks 组件）
+ */
+export function buildClaudeHooksConfig(config) {
+    const hooks = config.components.hooks;
+    if (!hooks || hooks.length === 0)
+        return null;
+    const hooksMap = {};
+    for (const hook of hooks) {
+        const entry = {
+            matcher: hook.pattern || '*',
+            hooks: [
+                {
+                    type: 'command',
+                    command: hook.command,
+                    ...(hook.timeout ? { timeout: hook.timeout } : {}),
+                },
+            ],
+        };
+        if (!hooksMap[hook.event]) {
+            hooksMap[hook.event] = [];
+        }
+        hooksMap[hook.event].push(entry);
+    }
+    return { hooks: hooksMap };
+}
+/**
+ * 生成 Claude Code 的 .mcp.json（如果有 mcp 组件）
+ */
+export function buildClaudeMcpConfig(config) {
+    return buildNativeMcpConfig(config);
+}
+/**
+ * 生成 Claude Code 的 .lsp.json（如果有 lsp 组件）
+ */
+export function buildLspConfig(config) {
+    const lsps = config.components.lsp;
+    if (!lsps || lsps.length === 0)
+        return null;
+    const servers = {};
+    for (const lsp of lsps) {
+        servers[lsp.name] = {
+            command: lsp.command,
+            ...(isPresent(lsp.args) ? { args: lsp.args } : {}),
+            ...(isPresent(lsp.env) ? { env: lsp.env } : {}),
+            ...(isPresent(lsp.transport) ? { transport: lsp.transport } : {}),
+            extensionToLanguage: lsp.extensionToLanguage,
+            ...(isPresent(lsp.workspaceFolder) ? { workspaceFolder: lsp.workspaceFolder } : {}),
+            ...(isPresent(lsp.startupTimeout) ? { startupTimeout: lsp.startupTimeout } : {}),
+            ...(isPresent(lsp.maxRestarts) ? { maxRestarts: lsp.maxRestarts } : {}),
+            ...(isPresent(lsp.diagnostics) ? { diagnostics: lsp.diagnostics } : {}),
+        };
+    }
+    return servers;
+}
+/**
+ * 将 Claude Code 兼容的文件写入插件目录
+ */
+export function generateClaude(config, pluginDir) {
+    // 1. .claude-plugin/plugin.json
+    const claudeDir = join(pluginDir, '.claude-plugin');
+    mkdirSync(claudeDir, { recursive: true });
+    writeFileSync(join(claudeDir, 'plugin.json'), JSON.stringify(buildClaudeManifest(config), null, 2) + '\n');
+    // 2. hooks/hooks.json
+    const hooksConfig = buildClaudeHooksConfig(config);
+    const hooksPath = join(pluginDir, 'hooks', 'hooks.json');
+    if (hooksConfig) {
+        const hooksDir = join(pluginDir, 'hooks');
+        mkdirSync(hooksDir, { recursive: true });
+        writeFileSync(hooksPath, JSON.stringify(hooksConfig, null, 2) + '\n');
+    }
+    else {
+        rmSync(hooksPath, { force: true });
+    }
+    // 3. .mcp.json
+    const mcpConfig = buildClaudeMcpConfig(config);
+    const mcpPath = join(pluginDir, '.mcp.json');
+    if (mcpConfig) {
+        writeFileSync(mcpPath, JSON.stringify(mcpConfig, null, 2) + '\n');
+    }
+    else {
+        rmSync(mcpPath, { force: true });
+    }
+    // 4. .lsp.json
+    const lspConfig = buildLspConfig(config);
+    const lspPath = join(pluginDir, '.lsp.json');
+    if (lspConfig) {
+        writeFileSync(lspPath, JSON.stringify(lspConfig, null, 2) + '\n');
+    }
+    else {
+        rmSync(lspPath, { force: true });
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/adapters/claude.js.map

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

package/dist/adapters/cli-validation.d.ts

@@ -0,0 +1,12 @@
+import type { WorkspaceHealthSnapshot, WorkspaceValidationDiagnostic } from '../application/workspace-health-contract.js';
+export interface CliPluginValidationResult {
+    readonly name: string;
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+}
+/**
+ * Converts the shared structured health result back into the legacy validate
+ * command's ordered, line-oriented model. It deliberately has no chalk,
+ * console, commander, or process dependency.
+ */
+export declare function adaptHealthToCliValidation(snapshot: WorkspaceHealthSnapshot, validationDiagnostics: readonly WorkspaceValidationDiagnostic[], orderedNames: readonly string[]): readonly CliPluginValidationResult[];

package/dist/adapters/cli-validation.js

@@ -0,0 +1,31 @@
+/**
+ * Converts the shared structured health result back into the legacy validate
+ * command's ordered, line-oriented model. It deliberately has no chalk,
+ * console, commander, or process dependency.
+ */
+export function adaptHealthToCliValidation(snapshot, validationDiagnostics, orderedNames) {
+    const plugins = new Map(snapshot.plugins.map((plugin) => [plugin.directoryName, plugin]));
+    const diagnostics = new Map();
+    for (const diagnostic of validationDiagnostics) {
+        const messages = diagnostics.get(diagnostic.pluginDirectoryName) ?? [];
+        messages.push(diagnostic.message);
+        diagnostics.set(diagnostic.pluginDirectoryName, messages);
+    }
+    return orderedNames.map((name) => {
+        const plugin = plugins.get(name);
+        if (plugin === undefined) {
+            return {
+                name,
+                valid: false,
+                errors: [`插件目录不存在: plugins/${name}`],
+            };
+        }
+        const errors = diagnostics.get(name) ?? [];
+        return {
+            name,
+            valid: errors.length === 0,
+            errors,
+        };
+    });
+}
+//# sourceMappingURL=cli-validation.js.map

package/dist/adapters/cli-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-validation.js","sourceRoot":"","sources":["../../src/adapters/cli-validation.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,QAAiC,EACjC,qBAA+D,EAC/D,YAA+B;IAE/B,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CACjE,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;IAChD,KAAK,MAAM,UAAU,IAAI,qBAAqB,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC;QACvE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAClC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO;gBACL,IAAI;gBACJ,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,CAAC,oBAAoB,IAAI,EAAE,CAAC;aACrC,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3C,OAAO;YACL,IAAI;YACJ,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;SACP,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}