agent-plugkit 0.1.0

package/dist/commands/install-repo.js

@@ -0,0 +1,200 @@
+import { createInterface } from 'node:readline/promises';
+import { executeMarketplaceRegistration, inspectMarketplaceRegistration, normalizeTargetIds, } from '../application/marketplace-registration.js';
+import { AGENT_TARGET_IDS, } from '../application/marketplace-registration-contract.js';
+import { CommandError } from '../core/errors.js';
+const INSPECTION_LABELS = {
+    ready: '可自动',
+    'missing-cli': '缺少 CLI',
+    'manual-required': '需手动',
+    failed: '不可用',
+    interrupted: '中断',
+};
+const RESULT_LABELS = {
+    completed: '完成',
+    'missing-cli': '缺少 CLI',
+    'manual-required': '需手动',
+    failed: '失败',
+    interrupted: '中断',
+};
+function defaultWrite(text) {
+    process.stdout.write(text);
+}
+async function defaultReadSelection(interruptController) {
+    if (interruptController.signal.aborted) {
+        return undefined;
+    }
+    const terminal = createInterface({ input: process.stdin, output: process.stdout });
+    const onSigint = () => {
+        interruptController.abort('SIGINT');
+    };
+    terminal.on('SIGINT', onSigint);
+    try {
+        if (interruptController.signal.aborted) {
+            return undefined;
+        }
+        return await terminal.question('> ', { signal: interruptController.signal });
+    }
+    catch (error) {
+        if (interruptController.signal.aborted ||
+            error?.name === 'AbortError') {
+            return undefined;
+        }
+        throw error;
+    }
+    finally {
+        terminal.removeListener('SIGINT', onSigint);
+        terminal.close();
+    }
+}
+export function parseTargetSelection(input, availableTargetIds, defaultTargetIds) {
+    const value = input.trim();
+    if (value.length === 0) {
+        if (defaultTargetIds.length === 0) {
+            throw new CommandError('当前没有默认可自动处理的 agent；请输入明确编号或 all。');
+        }
+        return normalizeTargetIds(defaultTargetIds);
+    }
+    if (value.toLowerCase() === 'all') {
+        return normalizeTargetIds(availableTargetIds);
+    }
+    const tokens = value.split(',').map((token) => token.trim());
+    if (tokens.some((token) => !/^\d+$/u.test(token))) {
+        throw new CommandError('请选择逗号分隔的 agent 编号，或输入 all。');
+    }
+    const selected = [];
+    for (const token of tokens) {
+        const index = Number(token) - 1;
+        const target = availableTargetIds[index];
+        if (!target) {
+            throw new CommandError(`agent 编号超出范围: ${token}`);
+        }
+        selected.push(target);
+    }
+    return normalizeTargetIds(selected);
+}
+function renderPrompt(inspection, write) {
+    write('请选择要注册 Marketplace 的 agent：\n');
+    inspection.targets.forEach((target, index) => {
+        write(`  ${index + 1}. ${target.label.padEnd(18)} [${INSPECTION_LABELS[target.status]}]\n`);
+    });
+    const defaults = inspection.targets
+        .filter((target) => target.status === 'ready')
+        .map((target) => target.id);
+    const defaultNumbers = defaults.map((id) => inspection.targets.findIndex((target) => target.id === id) + 1);
+    write(`\n默认：${defaultNumbers.length > 0 ? defaultNumbers.join(',') : '无'}\n`);
+    write('输入编号（逗号分隔），输入 all 选择全部，直接回车接受默认：\n');
+    return defaults;
+}
+function formatInvocation(target) {
+    if (!target.invocation) {
+        return target.message;
+    }
+    return [target.invocation.executable, ...target.invocation.args.map((arg) => JSON.stringify(arg))]
+        .join(' ');
+}
+function renderTargetStart(target, write) {
+    if (target.status === 'ready') {
+        write(`→ ${target.label}: ${formatInvocation(target)}\n`);
+    }
+}
+function renderResultLine(result, write) {
+    write(`  [${RESULT_LABELS[result.status]}] ${result.label}：${result.message}\n`);
+    if (result.status !== 'completed' && result.recovery) {
+        write(`    下一步：${result.recovery}\n`);
+    }
+}
+function renderReport(report, write) {
+    const completed = report.results.filter((result) => result.status === 'completed');
+    const incomplete = report.results.filter((result) => result.status !== 'completed');
+    write('\n注册结果：\n');
+    write('已完成：\n');
+    if (completed.length === 0) {
+        write('  无\n');
+    }
+    else {
+        completed.forEach((result) => renderResultLine(result, write));
+    }
+    write('未完成：\n');
+    if (incomplete.length === 0) {
+        write('  无\n');
+    }
+    else {
+        incomplete.forEach((result) => renderResultLine(result, write));
+    }
+    write(`退出码：${report.exitCode}\n`);
+}
+function selectedInspection(inspection, targetIds) {
+    const selected = new Set(targetIds);
+    return {
+        source: inspection.source,
+        targets: inspection.targets.filter((target) => selected.has(target.id)),
+    };
+}
+export async function runInstallRepo(source, options, dependencies = {}) {
+    const requested = [...(options.agent ?? [])];
+    if (options.all && requested.length > 0) {
+        throw new CommandError('不能同时使用 --agent 与 --all。');
+    }
+    const interactive = dependencies.interactive ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
+    const explicitTargetIds = options.all
+        ? [...AGENT_TARGET_IDS]
+        : requested.length > 0
+            ? normalizeTargetIds(requested)
+            : undefined;
+    if (!explicitTargetIds && !interactive) {
+        throw new CommandError('非交互终端必须显式传入至少一个 --agent，或使用 --all。');
+    }
+    const write = dependencies.write ?? defaultWrite;
+    const interruptController = new AbortController();
+    const onSigint = () => interruptController.abort('SIGINT');
+    const runtime = {
+        ...dependencies.runtime,
+        signal: interruptController.signal,
+    };
+    process.on('SIGINT', onSigint);
+    try {
+        let inspection = await inspectMarketplaceRegistration(source, {
+            baseDir: dependencies.baseDir,
+            homeDir: dependencies.homeDir,
+            targetIds: explicitTargetIds ?? AGENT_TARGET_IDS,
+            runtime,
+        });
+        if (!explicitTargetIds) {
+            const interrupted = inspection.targets.some((target) => target.status === 'interrupted');
+            if (interrupted) {
+                const report = await executeMarketplaceRegistration(inspection, {
+                    runtime,
+                    onTargetResult: (result) => renderResultLine(result, write),
+                });
+                renderReport(report, write);
+                return { exitCode: 130, report };
+            }
+            const defaultTargetIds = renderPrompt(inspection, write);
+            if (interruptController.signal.aborted) {
+                write('\n[中断] 用户取消了 Marketplace 注册。\n');
+                return { exitCode: 130 };
+            }
+            const answer = dependencies.readSelection
+                ? await dependencies.readSelection(interruptController.signal)
+                : await defaultReadSelection(interruptController);
+            if (answer === undefined || interruptController.signal.aborted) {
+                write('\n[中断] 用户取消了 Marketplace 注册。\n');
+                return { exitCode: 130 };
+            }
+            const selected = parseTargetSelection(answer, inspection.targets.map((target) => target.id), defaultTargetIds);
+            inspection = selectedInspection(inspection, selected);
+        }
+        write(`Marketplace 来源：${inspection.source.displayValue}\n`);
+        const report = await executeMarketplaceRegistration(inspection, {
+            runtime,
+            onTargetStart: (target) => renderTargetStart(target, write),
+            onTargetResult: (result) => renderResultLine(result, write),
+        });
+        renderReport(report, write);
+        return { exitCode: report.exitCode, report };
+    }
+    finally {
+        process.removeListener('SIGINT', onSigint);
+    }
+}
+//# sourceMappingURL=install-repo.js.map

package/dist/commands/install-repo.js.map

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

package/dist/commands/release-local.d.ts

@@ -0,0 +1,9 @@
+/**
+ * release-local 命令 — 组装本地发布产物
+ *
+ * CLI 只拥有终端呈现；目录、manifest、README、archive 身份与事务
+ * 由共享 application plan/commit 能力负责。
+ */
+export declare function runReleaseLocal(options?: {
+    root?: string;
+}): void;

package/dist/commands/release-local.js

@@ -0,0 +1,27 @@
+/**
+ * release-local 命令 — 组装本地发布产物
+ *
+ * CLI 只拥有终端呈现；目录、manifest、README、archive 身份与事务
+ * 由共享 application plan/commit 能力负责。
+ */
+import { join } from "node:path";
+import chalk from "chalk";
+import { commitLocalReleasePlan, planLocalRelease, } from "../application/local-release.js";
+import { resolveRepoContext } from "../utils/helpers.js";
+export function runReleaseLocal(options = {}) {
+    console.log(chalk.blue("⟳ 组装本地发布包...\n"));
+    const plan = planLocalRelease(resolveRepoContext(options.root).rootDir);
+    const result = commitLocalReleasePlan(plan);
+    if (result.status !== "success") {
+        throw new Error(result.status === "canceled"
+            ? result.message
+            : result.phase === "archive"
+                ? `发布包压缩失败: ${plan.archiveName}`
+                : result.message);
+    }
+    const archivePath = join(plan.workspaceDirectory, plan.archiveRelativePath);
+    console.log(chalk.green(`  ✓ dist/release (${plan.pluginCount} 个插件)`));
+    console.log(chalk.green(`  ✓ ${archivePath}`));
+    console.log(chalk.green("\n✓ 本地发布包生成完成"));
+}
+//# sourceMappingURL=release-local.js.map

package/dist/commands/release-local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-local.js","sourceRoot":"","sources":["../../src/commands/release-local.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EACL,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,UAAU,eAAe,CAAC,UAA6B,EAAE;IAC7D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAE1C,MAAM,IAAI,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,MAAM,CAAC,MAAM,KAAK,UAAU;YAC1B,CAAC,CAAC,MAAM,CAAC,OAAO;YAChB,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS;gBAC1B,CAAC,CAAC,YAAY,IAAI,CAAC,WAAW,EAAE;gBAChC,CAAC,CAAC,MAAM,CAAC,OAAO,CACrB,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,qBAAqB,IAAI,CAAC,WAAW,OAAO,CAAC,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,WAAW,EAAE,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/commands/validate.d.ts

@@ -0,0 +1,8 @@
+/**
+ * validate command — terminal presentation over the shared read-only health
+ * scan. The public stdout and exit behavior remains the CLI contract.
+ */
+export declare function runValidate(name: string | undefined, options: {
+    all: boolean;
+    root?: string;
+}): void;

package/dist/commands/validate.js

@@ -0,0 +1,45 @@
+/**
+ * validate command — terminal presentation over the shared read-only health
+ * scan. The public stdout and exit behavior remains the CLI contract.
+ */
+import chalk from 'chalk';
+import { adaptHealthToCliValidation } from '../adapters/cli-validation.js';
+import { scanWorkspaceHealth } from '../application/workspace-health.js';
+import { CommandError } from '../core/errors.js';
+import { listPluginNames, resolveRepoContext, } from '../utils/helpers.js';
+export function runValidate(name, options) {
+    const context = resolveRepoContext(options.root);
+    const names = options.all ? listPluginNames(context) : name ? [name] : [];
+    if (names.length === 0) {
+        throw new CommandError('请指定插件名或使用 --all');
+    }
+    const scan = scanWorkspaceHealth({
+        directory: context.rootDir,
+        pluginNames: names,
+    });
+    if (scan.status === 'unavailable') {
+        throw new CommandError(scan.error.technicalDetail ?? scan.error.message);
+    }
+    const results = adaptHealthToCliValidation(scan.snapshot, scan.validationDiagnostics, names);
+    console.log(chalk.blue(`⟳ 验证 ${names.length} 个插件...\n`));
+    let allValid = true;
+    for (const result of results) {
+        if (result.valid) {
+            console.log(chalk.green(`  ✓ ${result.name}`));
+            continue;
+        }
+        allValid = false;
+        console.log(chalk.red(`  ✗ ${result.name}`));
+        for (const error of result.errors) {
+            console.log(chalk.red(`    └─ ${error}`));
+        }
+    }
+    console.log();
+    if (allValid) {
+        console.log(chalk.green('✓ 所有插件验证通过'));
+    }
+    else {
+        throw new CommandError('存在验证错误');
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,eAAe,EACf,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,UAAU,WAAW,CACzB,IAAwB,EACxB,OAAwC;IAExC,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,YAAY,CAAC,iBAAiB,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,IAAI,GAAG,mBAAmB,CAAC;QAC/B,SAAS,EAAE,OAAO,CAAC,OAAO;QAC1B,WAAW,EAAE,KAAK;KACnB,CAAC,CAAC;IACH,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;QAClC,MAAM,IAAI,YAAY,CACpB,IAAI,CAAC,KAAK,CAAC,eAAe,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CACjD,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,0BAA0B,CACxC,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,qBAAqB,EAC1B,KAAK,CACN,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,MAAM,WAAW,CAAC,CAAC,CAAC;IAEzD,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC/C,SAAS;QACX,CAAC;QACD,QAAQ,GAAG,KAAK,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,5 @@
+export declare class CommandError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+export declare function isCommandError(error: unknown): error is CommandError;

package/dist/core/errors.js

@@ -0,0 +1,12 @@
+export class CommandError extends Error {
+    exitCode;
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.name = 'CommandError';
+        this.exitCode = exitCode;
+    }
+}
+export function isCommandError(error) {
+    return error instanceof CommandError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,QAAQ,CAAS;IAE1B,YAAY,OAAe,EAAE,QAAQ,GAAG,CAAC;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,YAAY,CAAC;AACvC,CAAC"}

package/dist/generated/skill-content.d.ts

@@ -0,0 +1,3 @@
+export declare const PLUGKIT_PLUGIN_YAML: string;
+export declare const PLUGKIT_SETUP_SKILL: string;
+export declare const PLUGKIT_MAINTAIN_SKILL: string;

package/dist/generated/skill-content.js

@@ -0,0 +1,9 @@
+// 此文件由 scripts/generate-skill.ts 自动生成，请勿手动编辑
+// 源头:
+// - marketplace/plugins/plugkit/plugin.yaml
+// - marketplace/plugins/plugkit/skills/setup/SKILL.md
+// - marketplace/plugins/plugkit/skills/maintain/SKILL.md
+export const PLUGKIT_PLUGIN_YAML = "name: plugkit\nversion: \"0.1.0\"\ndescription: \"Official agent-plugkit maintenance plugin\"\nauthor:\n  name: \"Agent Plugkit\"\ncategory: tooling\ntags:\n  - plugkit\n  - marketplace\n\ncomponents:\n  skills:\n    - name: setup\n      path: skills/setup\n      description: \"Guide agents to install, update, or uninstall the agent-plugkit CLI and bootstrap a marketplace repository.\"\n    - name: maintain\n      path: skills/maintain\n      description: \"Guide agents to create, validate, build, and release plugkit plugins.\"\n\nplatform:\n  codex:\n    interface:\n      displayName: \"Plugkit\"\n      shortDescription: \"Setup and maintain agent-plugkit marketplaces\"\n      longDescription: \"Official guidance for installing agent-plugkit and maintaining agent-plugkit marketplace repositories.\"\n      category: \"Tooling\"\n      developerName: \"Agent Plugkit\"\n";
+export const PLUGKIT_SETUP_SKILL = "---\nname: setup\ndescription: \"Guide agents to install, update, or uninstall the agent-plugkit CLI and bootstrap a marketplace repository.\"\nargument-hint: \"<install|update|uninstall>\"\n---\n\n# setup\n\nUse this skill for the lifecycle of the `agent-plugkit` CLI tool and its marketplace repository scaffold: getting it installed, keeping it current, or removing it. Once a repository is bootstrapped, switch to the `maintain` skill for day-to-day plugin work (adding components, build/index/validate/release).\n\n## Install\n\n1. Check whether `marketplace.yaml` already exists at the repo root. If it does, this repo is already bootstrapped — skip straight to `agent-plugkit validate --all` instead of re-initializing.\n2. Add the CLI as a pinned dev dependency: `npm install --save-dev agent-plugkit`. For a one-off run without a persistent install, `npx agent-plugkit --help` works too.\n3. If `marketplace.yaml` does not exist yet, scaffold the marketplace: `npx agent-plugkit init-repo [name] --organization \"<org>\"`. Leave `--no-plugkit` off unless the user explicitly does not want the official `plugkit` plugin in this repo.\n4. Confirm the scaffold: `marketplace.yaml`, `plugins/plugkit/` (with both `setup` and `maintain` skills), and the `mp`/`validate:plugins`/`build:plugins`/`build:index` scripts in `package.json`.\n5. Run `agent-plugkit build --all && agent-plugkit index && agent-plugkit validate --all` to confirm the fresh scaffold is healthy.\n\n## Update\n\n1. Check the current pinned version against latest: `npm view agent-plugkit version`.\n2. `npm install --save-dev agent-plugkit@latest` (or a specific version if the user wants to pin one).\n3. Re-run `agent-plugkit build --all && agent-plugkit index && agent-plugkit validate --all` to surface any schema or generated-artifact drift introduced by the new CLI version.\n4. Updating the CLI does not rewrite files already scaffolded under `plugins/plugkit/` in this repo — `init-repo` never overwrites existing files. If the official `plugkit` skill content changed upstream and the user wants it, diff it manually before deciding whether to overwrite.\n5. If the `plugkit` plugin is installed in an Agent Plugins-compatible or native Claude Code / Codex client, refresh it there too through that client's own update flow — the npm upgrade only updates the CLI binary, not an already-installed agent-side copy.\n\n## Uninstall\n\n1. `npm uninstall agent-plugkit` to remove the CLI dev dependency.\n2. **Never delete `marketplace.yaml`, `plugins/`, or any generated manifests as part of this.** That is the user's real marketplace content, independent of the CLI tool. Only remove it if the user explicitly asks to tear down the marketplace itself, as a separate decision.\n3. Optionally, if the user also wants the `plugkit` plugin removed from an agent client, do that through the client's own plugin-removal flow — uninstalling the npm package does not touch anything already installed there.\n\n## Contracts\n\n- This skill owns the CLI tool and repository bootstrap lifecycle only. Once a marketplace exists, route ongoing plugin work (adding skills/mcp/hooks/lsp, build, validate, release) to the `maintain` skill instead of duplicating it here.\n- Never run `init-repo` against a directory that already has `marketplace.yaml` — it fails loudly by design; treat that as \"already installed,\" not an error to route around.\n- Do not hand-edit generated root `plugin.json`/`mcp.json`, `.claude-plugin`, `.codex-plugin`, `.mcp.json`, `.lsp.json`, `hooks/hooks.json`, or marketplace indexes.\n";
+export const PLUGKIT_MAINTAIN_SKILL = "---\nname: maintain\ndescription: \"Guide agents to maintain agent-plugkit marketplace plugins.\"\nargument-hint: \"<plugin-name-or-task>\"\n---\n\n# maintain\n\nUse this skill when creating or maintaining an `agent-plugkit` marketplace repository.\n\n## Working Model\n\n- Treat `plugin.yaml` as the source of truth for the Agent Plugins 1.0 portable package, Claude Code and Codex native artifacts, and all client marketplace indexes.\n- Keep portable and client-specific layers distinct: Agent Plugins discovers only root `plugin.json`, immediate-child `skills/`, and optional root `mcp.json`; marketplace registration and installation belong to each client.\n- Treat a plugin as the namespace and container. Add related skills or platform components under the existing plugin when they belong together.\n- Prefer `agent-plugkit add <skill|mcp|hook|lsp> <plugin-name> <component-name>` when extending an existing plugin.\n- Prefer `agent-plugkit init <plugin-name> --type <skill|mcp|hook|lsp>` when creating a new plugin.\n- Prefer `agent-plugkit import-skill <source-dir> [plugin-name]` when the skill already exists on disk (for example `~/.claude/skills/<name>`) — it creates a new single-skill plugin and copies `SKILL.md` verbatim.\n\n## Flow\n\n1. Inspect the existing marketplace shape before editing.\n2. Choose the plugin ID and component type.\n3. Add or edit source files under `plugins/<plugin-name>/`.\n4. Run:\n\n   ```bash\n   agent-plugkit build --all\n   agent-plugkit index\n   agent-plugkit validate --all\n   ```\n\n5. Before handing off a release candidate, run `agent-plugkit release-local` or the repository's release script and inspect the local directory/archive. This does not publish, push, register, or install anything remotely.\n6. Once a ready Marketplace has an intended local or Git source, register it only when the user asks:\n\n   ```bash\n   agent-plugkit install-repo OWNER/REPO\n   agent-plugkit install-repo OWNER/REPO --agent claude --agent codex\n   agent-plugkit install-repo /path/to/marketplace --all\n   ```\n\n## Client Delivery\n\n`install-repo` accepts an existing local Marketplace directory, `owner/repo`, or an HTTPS/SSH Git\nURL. With no selection flags it provides a numbered TTY multi-select; automation must pass repeated\n`--agent` values or `--all`. Sources containing C0/C1/DEL control characters, including controls\nrevealed by URL percent-decoding, are rejected before terminal output or client execution. It\nprocesses these client adapters in a fixed order:\n\n- Claude Code: native `claude plugin marketplace add <source>`.\n- Codex: native `codex plugin marketplace add <source>`.\n- GitHub Copilot: native `copilot plugin marketplace add <source>`.\n- VS Code: atomically enable `chat.plugins.enabled` and deduplicate the source in the current user's\n  `chat.plugins.marketplaces`; local directories become `file://` URIs. If safe deduplication would\n  lose an existing JSONC comment, the configuration root is not an absolute user path, or the file\n  is not lossless UTF-8, the file remains unchanged for manual cleanup. Reload the VS Code window\n  after a completed update. Revision checks and an open-file guard reject or restore detectable\n  conflicts, but this pure Node transaction is not filesystem compare-and-swap: an uncooperative\n  new-inode replacement after the last observable check but before either candidate commit or\n  guard-content recovery rename can be overwritten. Failure output asks the user to inspect the\n  current file rather than claiming every failed transaction left the original untouched. Keep a\n  local Marketplace outside the VS Code user configuration tree; overlapping or symlink-resolved\n  paths fail before any settings write.\n- Cursor: never write private state or call an undocumented command. Tell a Team/Enterprise\n  administrator to use Dashboard → Plugins → Add Marketplace → Import from Repo.\n\nMissing native CLIs and old versions remain explicit incomplete results; do not install them\nautomatically. Exit `0` means every selected target completed, `2` means a mixed result, `1` means\nnone completed or preflight failed, and `130` means interruption. Do not claim registration happened\nmerely because `build`, `index`, `validate`, or `release-local` passed; use the per-target\n`install-repo` summary as the evidence.\n\nMarketplace registration is not plugin installation. Run a client's plugin-install command only\nunder a separate explicit request.\n\n## Contracts\n\n- Do not edit generated root `plugin.json`/`mcp.json`, `.claude-plugin`, `.codex-plugin`, `.mcp.json`, `.lsp.json`, `hooks/hooks.json`, `.github/plugin/marketplace.json`, `.cursor-plugin/marketplace.json`, root `marketplace.json`, or other generated indexes by hand.\n- Keep canonical plugin names to 2–64 lowercase letters, digits, or single hyphens; start and end with an alphanumeric character and never use consecutive `--`.\n- Keep component paths relative to the plugin directory.\n- Keep every portable Skill at `skills/<name>/SKILL.md`; its frontmatter `name` must match the immediate parent directory and its `description` must be present.\n- Use legacy/explicit `stdio` MCP only with command fields, and `streamable-http`/`sse` only with URL/header fields. Do not silently convert an invalid transport.\n- Treat MCP `env` and `headers` as visible package data; never put credentials or other secrets in generated plugin configuration.\n- For multi-skill plugins, add child skills under the plugin instead of creating unrelated top-level plugin IDs.\n- When adding MCP, hook, or LSP components, keep the component name stable because generated manifests use it as an identifier.\n- `import-skill` never rewrites the copied `SKILL.md`. Fix a mismatched frontmatter name or description at the source, or edit the plugin after import.\n- `install-repo` treats its source as read-only. It does not build, validate, repair, commit, push, publish, or install Marketplace contents.\n";
+//# sourceMappingURL=skill-content.js.map

package/dist/generated/skill-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-content.js","sourceRoot":"","sources":["../../src/generated/skill-content.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM;AACN,4CAA4C;AAC5C,sDAAsD;AACtD,yDAAyD;AAEzD,MAAM,CAAC,MAAM,mBAAmB,GAAW,m3BAAm3B,CAAC;AAC/5B,MAAM,CAAC,MAAM,mBAAmB,GAAW,ggHAAggH,CAAC;AAC5iH,MAAM,CAAC,MAAM,sBAAsB,GAAW,w2LAAw2L,CAAC"}

package/dist/infrastructure/authorized-path.d.ts

@@ -0,0 +1,20 @@
+export type AuthorizedPathErrorCode = 'EMPTY_PATH' | 'PATH_NOT_FOUND' | 'PATH_UNAVAILABLE' | 'NOT_A_DIRECTORY' | 'ABSOLUTE_PATH' | 'OUTSIDE_AUTHORIZED_ROOT' | 'UNSAFE_SYMLINK';
+export declare class AuthorizedPathError extends Error {
+    readonly code: AuthorizedPathErrorCode;
+    readonly path: string;
+    constructor(code: AuthorizedPathErrorCode, message: string, path: string);
+}
+export interface AuthorizedRoot {
+    readonly canonicalPath: string;
+}
+/**
+ * Turns an explicitly selected, existing directory into a canonical authorization root.
+ * A symlink selected as the root is rejected; aliases in ancestor paths are canonicalized.
+ */
+export declare function authorizeExistingDirectory(inputPath: string): AuthorizedRoot;
+/**
+ * Resolves a declaration-owned relative path without allowing absolute paths,
+ * traversal outside the authorization root, or symlink traversal.
+ * Missing leaf paths are returned so callers can report their domain-specific error.
+ */
+export declare function resolveAuthorizedPath(root: AuthorizedRoot | string, configuredPath: string): string;

package/dist/infrastructure/authorized-path.js

@@ -0,0 +1,85 @@
+import { existsSync, lstatSync, realpathSync } from 'node:fs';
+import { isAbsolute, relative, resolve, sep } from 'node:path';
+export class AuthorizedPathError extends Error {
+    code;
+    path;
+    constructor(code, message, path) {
+        super(message);
+        this.name = 'AuthorizedPathError';
+        this.code = code;
+        this.path = path;
+    }
+}
+function isInside(root, candidate) {
+    const rel = relative(root, candidate);
+    return rel === '' || (!rel.startsWith(`..${sep}`) && rel !== '..' && !isAbsolute(rel));
+}
+/**
+ * Turns an explicitly selected, existing directory into a canonical authorization root.
+ * A symlink selected as the root is rejected; aliases in ancestor paths are canonicalized.
+ */
+export function authorizeExistingDirectory(inputPath) {
+    if (inputPath.trim().length === 0) {
+        throw new AuthorizedPathError('EMPTY_PATH', '授权目录不能为空', inputPath);
+    }
+    const absolutePath = resolve(inputPath);
+    try {
+        if (!existsSync(absolutePath)) {
+            throw new AuthorizedPathError('PATH_NOT_FOUND', '授权目录不存在', inputPath);
+        }
+        const selectedStat = lstatSync(absolutePath);
+        if (selectedStat.isSymbolicLink()) {
+            throw new AuthorizedPathError('UNSAFE_SYMLINK', '授权目录不能是符号链接', inputPath);
+        }
+        if (!selectedStat.isDirectory()) {
+            throw new AuthorizedPathError('NOT_A_DIRECTORY', '授权路径不是目录', inputPath);
+        }
+        return Object.freeze({ canonicalPath: realpathSync.native(absolutePath) });
+    }
+    catch (error) {
+        if (error instanceof AuthorizedPathError)
+            throw error;
+        throw new AuthorizedPathError('PATH_UNAVAILABLE', '授权目录当前不可访问', inputPath);
+    }
+}
+/**
+ * Resolves a declaration-owned relative path without allowing absolute paths,
+ * traversal outside the authorization root, or symlink traversal.
+ * Missing leaf paths are returned so callers can report their domain-specific error.
+ */
+export function resolveAuthorizedPath(root, configuredPath) {
+    if (isAbsolute(configuredPath)) {
+        throw new AuthorizedPathError('ABSOLUTE_PATH', '授权范围内的路径必须是相对路径', configuredPath);
+    }
+    const authorization = typeof root === 'string' ? authorizeExistingDirectory(root) : root;
+    const candidate = resolve(authorization.canonicalPath, configuredPath);
+    if (!isInside(authorization.canonicalPath, candidate)) {
+        throw new AuthorizedPathError('OUTSIDE_AUTHORIZED_ROOT', '路径越过授权目录', configuredPath);
+    }
+    try {
+        const rel = relative(authorization.canonicalPath, candidate);
+        let cursor = authorization.canonicalPath;
+        for (const segment of rel === '' ? [] : rel.split(sep)) {
+            cursor = resolve(cursor, segment);
+            if (!existsSync(cursor)) {
+                break;
+            }
+            if (lstatSync(cursor).isSymbolicLink()) {
+                throw new AuthorizedPathError('UNSAFE_SYMLINK', '路径不能穿过符号链接', configuredPath);
+            }
+        }
+        if (existsSync(candidate)) {
+            const canonicalCandidate = realpathSync.native(candidate);
+            if (!isInside(authorization.canonicalPath, canonicalCandidate)) {
+                throw new AuthorizedPathError('OUTSIDE_AUTHORIZED_ROOT', '路径解析后越过授权目录', configuredPath);
+            }
+        }
+    }
+    catch (error) {
+        if (error instanceof AuthorizedPathError)
+            throw error;
+        throw new AuthorizedPathError('PATH_UNAVAILABLE', '授权范围内的路径当前不可访问', configuredPath);
+    }
+    return candidate;
+}
+//# sourceMappingURL=authorized-path.js.map

package/dist/infrastructure/authorized-path.js.map

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