create-codemodekit 0.1.0 → 0.3.0

package/README.md

@@ -11,6 +11,46 @@ cd my-code-mode
 npm start
 ```
 
-The command is parsed directly into an executable and argument array. Shell operators, shell expansion, and leading environment assignments are rejected; no shell is invoked. Dependency installation is automatic unless `--no-install` is supplied.
+The command is parsed directly into an executable and argument array. Shell operators, shell expansion, and leading environment assignments are rejected; no shell is invoked. Dependency installation is automatic unless `--no-install` is supplied. A project-level CodeModeKit authoring skill is installed at `.agents/skills/build-codemodekit-plugin` by default; use `--no-authoring-skill` to omit it.
 
 Generated servers use `--policy allow-all` by default so the project runs immediately. Use `--policy deny-all` when you want the generated server to start closed while you define a narrower tool policy.
+
+## Generate an Agent Plugin
+
+Add `--agent-plugin` to create a portable Agent Plugins 1.0 package around the Code Mode server:
+
+```sh
+npm create codemodekit@latest my-code-mode -- \
+  --mcp-name upstream \
+  --mcp-command 'uvx my-mcp-server' \
+  --agent-plugin
+```
+
+This adds root `plugin.json` and `mcp.json` files plus `skills/use-upstream-codemode/`. The companion skill teaches a runtime agent to compose calls through `run_typescript`; its `references/tools.d.ts` is generated from CodeModeKit's live normalized catalog. After installation, the generator also builds a self-contained `dist/plugin` artifact containing the server bundle, QuickJS WASM, manifests, and runtime skill.
+
+The generator attempts catalog sync after dependency installation. If the upstream MCP still needs credentials or connectivity, the project remains valid with pending references. Configure the source and run:
+
+```sh
+npm run plugin:sync
+npm run plugin:build
+```
+
+Use `--no-sync` to skip the initial attempt intentionally. The artifact deliberately excludes `node_modules`, `.env`, source files, and the development-time authoring skill.
+
+## Cursor lifecycle
+
+Cursor currently requires concrete executable and server paths for local plugins. The generated commands handle that adapter without changing the portable artifact:
+
+```sh
+npm run plugin:install:cursor
+npm run plugin:status:cursor
+npm run plugin:uninstall:cursor
+```
+
+Installation rebuilds first, copies the artifact beneath `~/.cursor/plugins/local`, resolves the active Node executable, and reports that Cursor should be reloaded. Reinstall after source, policy, metadata, or catalog changes.
+
+## Plugin metadata
+
+Use `--plugin-name`, `--skill-name`, `--plugin-description`, and `--plugin-license` with `--agent-plugin` to override the portable defaults.
+
+Programmatic consumers can call `scaffoldCodeModeMcp`, `scaffoldAgentPlugin`, `syncAgentPluginSkill`, `buildAgentPlugin`, `installProjectAuthoringSkill`, and the Cursor lifecycle functions directly.

package/dist/agent-plugin.d.ts

@@ -0,0 +1,70 @@
+export interface AgentPluginCatalogSource {
+    start(signal?: AbortSignal): Promise<AgentPluginStartupReport>;
+    getTypeScriptCatalog(signal?: AbortSignal): Promise<AgentPluginTypeScriptCatalog>;
+}
+export interface AgentPluginStartupReport {
+    readonly status: "ready" | "degraded";
+    readonly catalogRevision: string;
+    readonly sources: readonly AgentPluginSourceReport[];
+}
+export interface AgentPluginSourceReport {
+    readonly source: string;
+    readonly status: "healthy" | "unavailable";
+    readonly toolCount: number;
+    readonly message?: string;
+    readonly rejectedToolCount?: number;
+}
+export interface AgentPluginTypeScriptCatalog {
+    readonly catalogRevision: string;
+    readonly declarations: string;
+}
+export interface ScaffoldAgentPluginOptions {
+    readonly root: string;
+    readonly pluginName: string;
+    readonly serverName: string;
+    readonly skillName: string;
+    readonly description?: string;
+    readonly version?: string;
+    readonly license?: string;
+    readonly entrypoint?: string;
+}
+export interface ScaffoldAgentPluginResult {
+    readonly root: string;
+    readonly manifest: string;
+    readonly mcpConfig: string;
+    readonly skillDirectory: string;
+    readonly skillName: string;
+}
+export interface SyncAgentPluginSkillOptions {
+    readonly root: string;
+    readonly skillName: string;
+    readonly serverName: string;
+    readonly codeMode: AgentPluginCatalogSource;
+    readonly signal?: AbortSignal;
+}
+export interface SyncAgentPluginSkillResult {
+    readonly skillDirectory: string;
+    readonly catalogRevision: string;
+    readonly declarations: string;
+    readonly metadata: string;
+    readonly sources: readonly AgentPluginSourceReport[];
+}
+/**
+ * Writes the portable Agent Plugins 1.0 wrapper and a compact companion skill.
+ * Tool-specific declarations are populated later by syncAgentPluginSkill.
+ */
+export declare function scaffoldAgentPlugin(options: ScaffoldAgentPluginOptions): Promise<ScaffoldAgentPluginResult>;
+/**
+ * Snapshots CodeModeKit's active catalog into an already-scaffolded companion
+ * skill. A degraded catalog is rejected so a partial tool surface is never
+ * presented as complete documentation.
+ */
+export declare function syncAgentPluginSkill(options: SyncAgentPluginSkillOptions): Promise<SyncAgentPluginSkillResult>;
+export declare function normalizePortableName(value: string, label?: string): string;
+interface RenderCompanionSkillOptions {
+    readonly skillName: string;
+    readonly serverName: string;
+}
+export declare function renderCompanionSkill(options: RenderCompanionSkillOptions): string;
+export {};
+//# sourceMappingURL=agent-plugin.d.ts.map

package/dist/agent-plugin.d.ts.map

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

package/dist/agent-plugin.js

@@ -0,0 +1,285 @@
+import { mkdir, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+const PLUGIN_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
+const MCP_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json";
+const PORTABLE_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
+/**
+ * Writes the portable Agent Plugins 1.0 wrapper and a compact companion skill.
+ * Tool-specific declarations are populated later by syncAgentPluginSkill.
+ */
+export async function scaffoldAgentPlugin(options) {
+    const root = path.resolve(options.root);
+    const pluginName = validatePortableName(options.pluginName, "Plugin name");
+    const skillName = validatePortableName(options.skillName, "Skill name");
+    const serverName = required(options.serverName, "Server name");
+    const version = required(options.version ?? "0.1.0", "Plugin version");
+    const entrypoint = options.entrypoint ?? "src/server.mjs";
+    validatePluginRelativePath(entrypoint, "Plugin entrypoint");
+    const manifestPath = path.join(root, "plugin.json");
+    const mcpConfigPath = path.join(root, "mcp.json");
+    const skillDirectory = path.join(root, "skills", skillName);
+    const referencesDirectory = path.join(skillDirectory, "references");
+    await mkdir(referencesDirectory, { recursive: true });
+    const description = options.description ??
+        `Use ${serverName} through a sandboxed TypeScript Code Mode interface.`;
+    const manifest = {
+        $schema: PLUGIN_SCHEMA,
+        name: pluginName,
+        version,
+        description,
+        ...(options.license === undefined
+            ? {}
+            : { license: required(options.license, "Plugin license") }),
+        keywords: ["code-mode", "mcp", "agent-skill"],
+    };
+    const mcpConfig = {
+        $schema: MCP_SCHEMA,
+        mcpServers: {
+            [serverName]: {
+                type: "stdio",
+                command: "node",
+                args: ["${PLUGIN_ROOT}/dist/plugin/server.mjs"],
+            },
+        },
+    };
+    await Promise.all([
+        writeJson(manifestPath, manifest),
+        writeJson(mcpConfigPath, mcpConfig),
+        writeFile(path.join(skillDirectory, "SKILL.md"), renderCompanionSkill({ skillName, serverName }), "utf8"),
+        writeFile(path.join(referencesDirectory, "runtime.md"), renderRuntimeReference(serverName), "utf8"),
+        writeFile(path.join(referencesDirectory, "result-contract.md"), renderResultContractReference(), "utf8"),
+        writeFile(path.join(referencesDirectory, "examples.md"), renderExamplesReference(), "utf8"),
+        writeFile(path.join(referencesDirectory, "tools.d.ts"), renderPendingDeclarations(), "utf8"),
+        writeJson(path.join(referencesDirectory, "catalog-metadata.json"), {
+            schemaVersion: 1,
+            status: "pending",
+            serverName,
+            message: "Run npm run plugin:sync after the upstream tool source is available.",
+        }),
+    ]);
+    return {
+        root,
+        manifest: manifestPath,
+        mcpConfig: mcpConfigPath,
+        skillDirectory,
+        skillName,
+    };
+}
+/**
+ * Snapshots CodeModeKit's active catalog into an already-scaffolded companion
+ * skill. A degraded catalog is rejected so a partial tool surface is never
+ * presented as complete documentation.
+ */
+export async function syncAgentPluginSkill(options) {
+    const root = path.resolve(options.root);
+    const skillName = validatePortableName(options.skillName, "Skill name");
+    const serverName = required(options.serverName, "Server name");
+    const snapshot = await stableCatalogSnapshot(options.codeMode, options.signal);
+    if (snapshot.startup.status !== "ready") {
+        const unavailable = snapshot.startup.sources
+            .filter((source) => source.status === "unavailable")
+            .map((source) => source.source)
+            .join(", ");
+        throw new Error(unavailable === ""
+            ? "Cannot sync an Agent Plugin skill from a degraded catalog"
+            : `Cannot sync an Agent Plugin skill while sources are unavailable: ${unavailable}`);
+    }
+    const skillDirectory = path.join(root, "skills", skillName);
+    const referencesDirectory = path.join(skillDirectory, "references");
+    await mkdir(referencesDirectory, { recursive: true });
+    const declarationsPath = path.join(referencesDirectory, "tools.d.ts");
+    const metadataPath = path.join(referencesDirectory, "catalog-metadata.json");
+    const declarations = renderCatalogDeclarations(snapshot.catalog.catalogRevision, snapshot.catalog.declarations);
+    const metadata = {
+        schemaVersion: 1,
+        status: "ready",
+        serverName,
+        catalogRevision: snapshot.catalog.catalogRevision,
+        sources: snapshot.startup.sources.map((source) => ({
+            source: source.source,
+            status: source.status,
+            toolCount: source.toolCount,
+            ...(source.rejectedToolCount === undefined
+                ? {}
+                : { rejectedToolCount: source.rejectedToolCount }),
+        })),
+    };
+    await Promise.all([
+        atomicWrite(declarationsPath, declarations),
+        atomicWrite(metadataPath, `${JSON.stringify(metadata, null, 2)}\n`),
+    ]);
+    return {
+        skillDirectory,
+        catalogRevision: snapshot.catalog.catalogRevision,
+        declarations: declarationsPath,
+        metadata: metadataPath,
+        sources: snapshot.startup.sources,
+    };
+}
+export function normalizePortableName(value, label = "Name") {
+    const normalized = value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/gu, "-")
+        .replace(/-+/gu, "-")
+        .replace(/^-|-$/gu, "")
+        .slice(0, 64)
+        .replace(/-$/u, "");
+    return validatePortableName(normalized, label);
+}
+export function renderCompanionSkill(options) {
+    const skillName = validatePortableName(options.skillName, "Skill name");
+    const serverName = required(options.serverName, "Server name");
+    const description = `Use the ${serverName} Code Mode MCP server for requests that require its upstream tools. ` +
+        "Apply the generated TypeScript catalog, compose calls in run_typescript, and return only the requested result.";
+    return `---
+name: ${skillName}
+description: ${JSON.stringify(description)}
+---
+
+# Use ${serverName} Code Mode
+
+Use \`run_typescript\` as the primary interface to the tools wrapped by this server.
+
+1. Locate the relevant declarations in [references/tools.d.ts](references/tools.d.ts) before authoring calls. Search large files by capability, source, or tool name and read only focused matches.
+2. Put related calls, result extraction, filtering, and reshaping into one \`run_typescript\` execution.
+3. Return only the bounded value needed to answer the user.
+4. Use \`search_tools\` when the generated catalog is pending or stale, does not contain the needed capability, or the client cannot search a large declaration reference efficiently.
+5. Treat tool errors as data you can catch and handle; do not bypass tool policy or sandbox limits.
+
+Read [references/runtime.md](references/runtime.md) for execution rules, [references/result-contract.md](references/result-contract.md) for MCP result extraction, and [references/examples.md](references/examples.md) for composition patterns.
+`;
+}
+function renderRuntimeReference(serverName) {
+    return `# ${serverName} runtime
+
+The server exposes a small Code Mode surface:
+
+- \`run_typescript\` compiles and executes an async TypeScript function body in a sandbox. Top-level \`await\` and \`return\` are supported.
+- \`search_tools\` searches the current runtime catalog and can return focused TypeScript declarations.
+
+The sandbox exposes \`tools\` and a limited set of safe JavaScript globals. It does not expose Node.js modules, filesystem APIs, process APIs, network APIs, dynamic imports, or arbitrary package imports.
+
+Prefer one execution that calls, combines, and reduces upstream results. Use \`Promise.all\` only for independent operations. Keep the final return value small; do not return raw payloads when a projection or summary is sufficient.
+
+The generated declaration snapshot is authoritative for its recorded catalog revision. If a call is missing or fails with \`TOOL_NOT_FOUND\`, use \`search_tools\` to inspect the live catalog and then refresh the snapshot with \`npm run plugin:sync\` when maintaining the plugin.
+`;
+}
+function renderResultContractReference() {
+    return `# Tool result contract
+
+Every \`tools.*\` call resolves to an MCP result wrapper rather than directly to the upstream payload:
+
+\`\`\`ts
+interface ToolContentBlock {
+  readonly type: string;
+  readonly [key: string]: unknown;
+}
+
+interface ToolResult<TStructured = unknown> {
+  readonly content: readonly ToolContentBlock[];
+  readonly structuredContent?: TStructured;
+}
+\`\`\`
+
+Prefer \`structuredContent\` when present. Some servers nest the useful value under \`structuredContent.result\`. When structured content is absent, inspect text blocks in \`content\` and call \`JSON.parse\` only after confirming the selected block has a string \`text\` field.
+
+Tool failures throw a catchable \`ToolCallError\` with \`code\`, \`phase\`, and optional \`source\` and \`tool\` fields. Catch an error only when the workflow can recover or return a more useful bounded result.
+`;
+}
+function renderExamplesReference() {
+    return `# Composition examples
+
+Replace the source, tool, and input names with declarations from \`tools.d.ts\`.
+
+## Extract structured data
+
+\`\`\`ts
+const result = await tools["source-name"]["tool-name"]({});
+const structured = result.structuredContent;
+return structured !== null &&
+  typeof structured === "object" &&
+  !Array.isArray(structured) &&
+  "result" in structured
+    ? structured.result
+    : structured;
+\`\`\`
+
+## Run independent calls concurrently
+
+\`\`\`ts
+const [first, second] = await Promise.all([
+  tools["source-name"]["first-tool"]({}),
+  tools["source-name"]["second-tool"]({}),
+]);
+return {
+  first: first.structuredContent,
+  second: second.structuredContent,
+};
+\`\`\`
+
+## Recover from an optional call
+
+\`\`\`ts
+try {
+  const result = await tools["source-name"]["optional-tool"]({});
+  return { available: true, value: result.structuredContent };
+} catch (error) {
+  return {
+    available: false,
+    code: error instanceof ToolCallError ? error.code : "UNKNOWN",
+  };
+}
+\`\`\`
+`;
+}
+function renderPendingDeclarations() {
+    return `// CodeModeKit catalog snapshot pending.
+// Run: npm run plugin:sync
+`;
+}
+function renderCatalogDeclarations(revision, declarations) {
+    return `// Generated by CodeModeKit from catalog revision ${revision}.
+// Refresh with: npm run plugin:sync
+
+${declarations.trim()}\n`;
+}
+async function stableCatalogSnapshot(codeMode, signal) {
+    for (let attempt = 0; attempt < 3; attempt += 1) {
+        const startup = await codeMode.start(signal);
+        const catalog = await codeMode.getTypeScriptCatalog(signal);
+        if (startup.catalogRevision === catalog.catalogRevision) {
+            return { startup, catalog };
+        }
+    }
+    throw new Error("The Code Mode catalog changed repeatedly while creating the snapshot");
+}
+async function writeJson(file, value) {
+    await writeFile(file, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+async function atomicWrite(file, contents) {
+    const temporary = `${file}.${String(process.pid)}.tmp`;
+    await writeFile(temporary, contents, "utf8");
+    await rename(temporary, file);
+}
+function validatePortableName(value, label) {
+    const name = required(value, label);
+    if (name.length > 64 || !PORTABLE_NAME.test(name)) {
+        throw new TypeError(`${label} must contain at most 64 lowercase letters, digits, and single hyphens`);
+    }
+    return name;
+}
+function validatePluginRelativePath(value, label) {
+    if (value === "" ||
+        path.isAbsolute(value) ||
+        value.split(/[\\/]/u).some((segment) => segment === "..")) {
+        throw new TypeError(`${label} must stay within the plugin root`);
+    }
+}
+function required(value, label) {
+    if (value.trim() === "") {
+        throw new TypeError(`${label} must not be empty`);
+    }
+    return value;
+}
+//# sourceMappingURL=agent-plugin.js.map

package/dist/agent-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-plugin.js","sourceRoot":"","sources":["../src/agent-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,aAAa,GACjB,4DAA4D,CAAC;AAC/D,MAAM,UAAU,GACd,yDAAyD,CAAC;AAC5D,MAAM,aAAa,GAAG,6BAA6B,CAAC;AA6DpD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAmC;IAEnC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAC3E,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,gBAAgB,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,gBAAgB,CAAC;IAC1D,0BAA0B,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;IAE5D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAClD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC5D,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IACpE,MAAM,KAAK,CAAC,mBAAmB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtD,MAAM,WAAW,GACf,OAAO,CAAC,WAAW;QACnB,OAAO,UAAU,sDAAsD,CAAC;IAC1E,MAAM,QAAQ,GAAG;QACf,OAAO,EAAE,aAAa;QACtB,IAAI,EAAE,UAAU;QAChB,OAAO;QACP,WAAW;QACX,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS;YAC/B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,gBAAgB,CAAC,EAAE,CAAC;QAC7D,QAAQ,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,aAAa,CAAC;KAC9C,CAAC;IACF,MAAM,SAAS,GAAG;QAChB,OAAO,EAAE,UAAU;QACnB,UAAU,EAAE;YACV,CAAC,UAAU,CAAC,EAAE;gBACZ,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,MAAM;gBACf,IAAI,EAAE,CAAC,uCAAuC,CAAC;aAChD;SACF;KACF,CAAC;IAEF,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,SAAS,CAAC,YAAY,EAAE,QAAQ,CAAC;QACjC,SAAS,CAAC,aAAa,EAAE,SAAS,CAAC;QACnC,SAAS,CACP,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,EACrC,oBAAoB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,EAC/C,MAAM,CACP;QACD,SAAS,CACP,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,YAAY,CAAC,EAC5C,sBAAsB,CAAC,UAAU,CAAC,EAClC,MAAM,CACP;QACD,SAAS,CACP,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,oBAAoB,CAAC,EACpD,6BAA6B,EAAE,EAC/B,MAAM,CACP;QACD,SAAS,CACP,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,aAAa,CAAC,EAC7C,uBAAuB,EAAE,EACzB,MAAM,CACP;QACD,SAAS,CACP,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,YAAY,CAAC,EAC5C,yBAAyB,EAAE,EAC3B,MAAM,CACP;QACD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,uBAAuB,CAAC,EAAE;YACjE,aAAa,EAAE,CAAC;YAChB,MAAM,EAAE,SAAS;YACjB,UAAU;YACV,OAAO,EAAE,sEAAsE;SAChF,CAAC;KACH,CAAC,CAAC;IAEH,OAAO;QACL,IAAI;QACJ,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,aAAa;QACxB,cAAc;QACd,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAoC;IAEpC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/E,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QACxC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO;aACzC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,aAAa,CAAC;aACnD,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;aAC9B,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CACb,WAAW,KAAK,EAAE;YAChB,CAAC,CAAC,2DAA2D;YAC7D,CAAC,CAAC,oEAAoE,WAAW,EAAE,CACtF,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC5D,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IACpE,MAAM,KAAK,CAAC,mBAAmB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,YAAY,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,uBAAuB,CAAC,CAAC;IAC7E,MAAM,YAAY,GAAG,yBAAyB,CAC5C,QAAQ,CAAC,OAAO,CAAC,eAAe,EAChC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAC9B,CAAC;IACF,MAAM,QAAQ,GAAG;QACf,aAAa,EAAE,CAAC;QAChB,MAAM,EAAE,OAAO;QACf,UAAU;QACV,eAAe,EAAE,QAAQ,CAAC,OAAO,CAAC,eAAe;QACjD,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACjD,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,GAAG,CAAC,MAAM,CAAC,iBAAiB,KAAK,SAAS;gBACxC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,CAAC;SACrD,CAAC,CAAC;KACJ,CAAC;IAEF,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,WAAW,CAAC,gBAAgB,EAAE,YAAY,CAAC;QAC3C,WAAW,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;KACpE,CAAC,CAAC;IAEH,OAAO;QACL,cAAc;QACd,eAAe,EAAE,QAAQ,CAAC,OAAO,CAAC,eAAe;QACjD,YAAY,EAAE,gBAAgB;QAC9B,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAa,EAAE,KAAK,GAAG,MAAM;IACjE,MAAM,UAAU,GAAG,KAAK;SACrB,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACtB,OAAO,oBAAoB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC;AAOD,MAAM,UAAU,oBAAoB,CAClC,OAAoC;IAEpC,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAC/D,MAAM,WAAW,GACf,WAAW,UAAU,sEAAsE;QAC3F,gHAAgH,CAAC;IACnH,OAAO;QACD,SAAS;eACF,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;;;QAGlC,UAAU;;;;;;;;;;;CAWjB,CAAC;AACF,CAAC;AAED,SAAS,sBAAsB,CAAC,UAAkB;IAChD,OAAO,KAAK,UAAU;;;;;;;;;;;;CAYvB,CAAC;AACF,CAAC;AAED,SAAS,6BAA6B;IACpC,OAAO;;;;;;;;;;;;;;;;;;;CAmBR,CAAC;AACF,CAAC;AAED,SAAS,uBAAuB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CR,CAAC;AACF,CAAC;AAED,SAAS,yBAAyB;IAChC,OAAO;;CAER,CAAC;AACF,CAAC;AAED,SAAS,yBAAyB,CAAC,QAAgB,EAAE,YAAoB;IACvE,OAAO,qDAAqD,QAAQ;;;EAGpE,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC;AAC1B,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,QAAkC,EAClC,MAA+B;IAK/B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,OAAO,CAAC,eAAe,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC;YACxD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;AAC1F,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,KAAc;IACnD,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACvE,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,QAAgB;IACvD,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;IACvD,MAAM,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa,EAAE,KAAa;IACxD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACpC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,SAAS,CACjB,GAAG,KAAK,wEAAwE,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAa,EAAE,KAAa;IAC9D,IACE,KAAK,KAAK,EAAE;QACZ,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QACtB,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,EACzD,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,mCAAmC,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa,EAAE,KAAa;IAC5C,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/authoring-skill.d.ts

@@ -0,0 +1,7 @@
+export interface InstallProjectAuthoringSkillOptions {
+    readonly root: string;
+    readonly overwrite?: boolean;
+}
+/** Installs CodeModeKit's development-time skill into the universal project path. */
+export declare function installProjectAuthoringSkill(options: InstallProjectAuthoringSkillOptions): Promise<string>;
+//# sourceMappingURL=authoring-skill.d.ts.map

package/dist/authoring-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring-skill.d.ts","sourceRoot":"","sources":["../src/authoring-skill.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,qFAAqF;AACrF,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,mCAAmC,GAC3C,OAAO,CAAC,MAAM,CAAC,CAuBjB"}

package/dist/authoring-skill.js

@@ -0,0 +1,42 @@
+import { cp, lstat, mkdir, rename, rm } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const AUTHORING_SKILL_NAME = "build-codemodekit-plugin";
+const BUNDLED_SKILL_DIRECTORY = fileURLToPath(new URL(`../skills/${AUTHORING_SKILL_NAME}`, import.meta.url));
+/** Installs CodeModeKit's development-time skill into the universal project path. */
+export async function installProjectAuthoringSkill(options) {
+    const root = path.resolve(options.root);
+    const skillsRoot = path.join(root, ".agents", "skills");
+    const destination = path.join(skillsRoot, AUTHORING_SKILL_NAME);
+    const staging = path.join(skillsRoot, `.${AUTHORING_SKILL_NAME}.${String(process.pid)}.${String(Date.now())}.tmp`);
+    if ((await pathExists(destination)) && options.overwrite !== true) {
+        throw new Error(`Authoring skill already exists: ${destination}`);
+    }
+    await mkdir(skillsRoot, { recursive: true });
+    await rm(staging, { recursive: true, force: true });
+    await cp(BUNDLED_SKILL_DIRECTORY, staging, { recursive: true });
+    try {
+        await rm(destination, { recursive: true, force: true });
+        await rename(staging, destination);
+    }
+    catch (error) {
+        await rm(staging, { recursive: true, force: true });
+        throw error;
+    }
+    return destination;
+}
+async function pathExists(file) {
+    try {
+        await lstat(file);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=authoring-skill.js.map

package/dist/authoring-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring-skill.js","sourceRoot":"","sources":["../src/authoring-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,oBAAoB,GAAG,0BAA0B,CAAC;AACxD,MAAM,uBAAuB,GAAG,aAAa,CAC3C,IAAI,GAAG,CAAC,aAAa,oBAAoB,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAC9D,CAAC;AAOF,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,OAA4C;IAE5C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CACvB,UAAU,EACV,IAAI,oBAAoB,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAC5E,CAAC;IACF,IAAI,CAAC,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,mCAAmC,WAAW,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,EAAE,CAAC,uBAAuB,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,MAAM,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,KAAK,YAAY,KAAK;YACtB,MAAM,IAAI,KAAK;YACd,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAClD,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAaA,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBnE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAsBA,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4DnE"}

package/dist/cli.js

@@ -15,10 +15,46 @@ export async function runCli(args) {
             ? {}
             : { serverName: options.serverName }),
         policy: options.policy,
+        authoringSkill: options.authoringSkill,
         install: options.install,
+        ...(options.codemodekitVersion === undefined
+            ? {}
+            : { codemodekitVersion: options.codemodekitVersion }),
+        ...(options.createCodemodekitVersion === undefined
+            ? {}
+            : { createCodemodekitVersion: options.createCodemodekitVersion }),
+        ...(options.agentPlugin
+            ? {
+                agentPlugin: {
+                    sync: options.sync && options.install,
+                    ...(options.pluginName === undefined
+                        ? {}
+                        : { pluginName: options.pluginName }),
+                    ...(options.skillName === undefined
+                        ? {}
+                        : { skillName: options.skillName }),
+                    ...(options.pluginDescription === undefined
+                        ? {}
+                        : { description: options.pluginDescription }),
+                    ...(options.pluginLicense === undefined
+                        ? {}
+                        : { license: options.pluginLicense }),
+                },
+            }
+            : {}),
     });
+    const pluginSummary = result.agentPlugin === undefined
+        ? ""
+        : `Agent Plugin: ${result.agentPlugin.built ? "built" : "scaffolded"} (${result.agentPlugin.skillName})\n` +
+            `${result.agentPlugin.synced ? "Catalog: synchronized\n" : "Catalog: pending\n"}` +
+            `${result.agentPlugin.syncError === undefined ? "" : `Catalog sync pending: ${result.agentPlugin.syncError}\n`}` +
+            `${result.agentPlugin.synced ? "" : "  npm run plugin:sync\n"}` +
+            `${result.agentPlugin.built ? "" : "  npm run plugin:build\n"}` +
+            "  npm run plugin:install:cursor\n";
     process.stdout.write(`\nCreated ${options.serverName ?? `${options.mcpName}-code-mode`} in ${result.directory}\n\n` +
         `${result.installed ? "" : "  npm install\n"}  npm start\n\n` +
+        `${result.authoringSkillDirectory === undefined ? "" : "Authoring skill: .agents/skills/build-codemodekit-plugin\n"}` +
+        pluginSummary +
         `Tool policy: ${options.policy}\n`);
 }
 function parseOptions(args) {
@@ -26,8 +62,17 @@ function parseOptions(args) {
     let mcpName;
     let mcpCommand;
     let serverName;
+    let pluginName;
+    let skillName;
+    let pluginDescription;
+    let pluginLicense;
     let policy = "allow-all";
+    let agentPlugin = false;
+    let authoringSkill = true;
+    let sync = true;
     let install = true;
+    let codemodekitVersion;
+    let createCodemodekitVersion;
     for (let index = 0; index < args.length; index += 1) {
         const argument = args[index];
         if (argument === undefined)
@@ -43,6 +88,18 @@ function parseOptions(args) {
             install = false;
             continue;
         }
+        if (argument === "--agent-plugin") {
+            agentPlugin = true;
+            continue;
+        }
+        if (argument === "--no-authoring-skill") {
+            authoringSkill = false;
+            continue;
+        }
+        if (argument === "--no-sync") {
+            sync = false;
+            continue;
+        }
         const value = args[index + 1];
         if (value === undefined || value.startsWith("--")) {
             throw new TypeError(`Missing value for ${argument}`);
@@ -58,12 +115,30 @@ function parseOptions(args) {
             case "--server-name":
                 serverName = value;
                 break;
+            case "--plugin-name":
+                pluginName = value;
+                break;
+            case "--skill-name":
+                skillName = value;
+                break;
+            case "--plugin-description":
+                pluginDescription = value;
+                break;
+            case "--plugin-license":
+                pluginLicense = value;
+                break;
             case "--policy":
                 if (value !== "allow-all" && value !== "deny-all") {
                     throw new TypeError("--policy must be allow-all or deny-all");
                 }
                 policy = value;
                 break;
+            case "--codemodekit-version":
+                codemodekitVersion = value;
+                break;
+            case "--create-codemodekit-version":
+                createCodemodekitVersion = value;
+                break;
             default:
                 throw new TypeError(`Unknown option: ${argument}`);
         }
@@ -77,13 +152,28 @@ function parseOptions(args) {
     if (mcpCommand === undefined) {
         throw new TypeError("--mcp-command is required");
     }
+    if (!agentPlugin &&
+        [pluginName, skillName, pluginDescription, pluginLicense].some((value) => value !== undefined)) {
+        throw new TypeError("Plugin metadata options require --agent-plugin");
+    }
     return {
         targetDirectory,
         mcpName,
         mcpCommand,
         ...(serverName === undefined ? {} : { serverName }),
+        ...(pluginName === undefined ? {} : { pluginName }),
+        ...(skillName === undefined ? {} : { skillName }),
+        ...(pluginDescription === undefined ? {} : { pluginDescription }),
+        ...(pluginLicense === undefined ? {} : { pluginLicense }),
         policy,
+        agentPlugin,
+        authoringSkill,
+        sync,
         install,
+        ...(codemodekitVersion === undefined ? {} : { codemodekitVersion }),
+        ...(createCodemodekitVersion === undefined
+            ? {}
+            : { createCodemodekitVersion }),
     };
 }
 function usage() {
@@ -98,7 +188,17 @@ Options:
   --server-name <name>       Downstream MCP server name
   --policy allow-all         Allow every discovered upstream tool (default)
   --policy deny-all          Deny every upstream tool until policy is edited
+  --agent-plugin             Add plugin.json, mcp.json, and a companion Agent Skill
+  --plugin-name <name>       Override the portable plugin name
+  --skill-name <name>        Override the runtime companion skill name
+  --plugin-description <s>   Override the plugin manifest description
+  --plugin-license <SPDX>    Add a license identifier to plugin.json
+  --no-authoring-skill       Omit the project-local CodeModeKit authoring skill
+  --no-sync                  Do not snapshot tool types during Agent Plugin creation
   --no-install               Generate files without running npm install
+  --codemodekit-version <v>  Override the generated runtime dependency
+  --create-codemodekit-version <v>
+                             Override the generated sync dependency
   -h, --help                 Show this help
 `;
 }