@zmice/zc 0.2.0 → 0.2.2

package/vendor/packages/platform-codex/dist/index.js

@@ -1,9 +1,24 @@
-import { createInstallPlan, describeAsset, selectMatchedAssets, } from "@zmice/platform-core";
+import { attachPlanMetadata, createInstallPlan, describeAsset, selectMatchedAssets, } from "@zmice/platform-core";
 export const platformName = "codex";
 export const packageName = "@zmice/platform-codex";
 export const templateFiles = {
     agents: "AGENTS.md",
 };
+export const capability = {
+    platform: platformName,
+    namespace: "zc",
+    surfaces: ["entry-file", "skills-dir"],
+    entryFile: {
+        fileName: templateFiles.agents,
+    },
+    skills: {
+        relativeDir: "skills",
+        fileName: "SKILL.md",
+    },
+};
+function selectMatchedAssetsByKind(manifest, kind) {
+    return selectMatchedAssets(manifest, platformName).filter((asset) => asset.kind === kind);
+}
 function renderAssetList(assets) {
     if (assets.length === 0) {
         return "- 尚未匹配到任何工具包资产。";
@@ -13,34 +28,244 @@ function renderAssetList(assets) {
         .join("\n");
 }
 function renderAgentsFile(manifestSource, assets) {
-    return `# Codex 平台说明
+    const commandCount = assets.filter((asset) => asset.kind === "command").length;
+    const skillCount = assets.filter((asset) => asset.kind === "skill").length;
+    return `# Codex 工作流入口
+
+这是安装到 Codex 的薄入口文件。
+
+它负责三件事：
+
+1. 给出统一任务开始方式
+2. 说明固定 workflow 的选路规则
+3. 把 \`zc:*\` 命令语义映射成 Codex 实际可调用的 \`$zc-*\` skill
+
+详细方法不写在这里，完整内容都在 \`skills/zc-*/SKILL.md\`。
+其中：
+
+- \`$zc-start\`、\`$zc-spec\`、\`$zc-build\` 这类是 command-alias skill
+- \`$zc-sdd-tdd-workflow\`、\`$zc-debugging-and-error-recovery\` 这类是专题/流程 skill
+
+## 核心规则
+
+- 默认先判断任务属于哪条 workflow，再决定入口
+- Codex 侧没有 \`zc:start\` 这类原生命令，请把它们理解为统一语义入口
+- 在 Codex 中，统一命令语义通过 \`$zc-*\` skill 来承接
+- 中文优先，技术契约保持原样
+- 证据先于断言，完成前必须验证
+- 不做超出任务边界的顺手修改
+
+## 统一命令语义到 Codex skill 的映射
+
+- \`zc:start\` -> \`$zc-start\`
+- \`zc:product-analysis\` -> \`$zc-product-analysis\`
+- \`zc:sdd-tdd\` -> \`$zc-sdd-tdd\`
+- \`zc:spec\` -> \`$zc-spec\`
+- \`zc:task-plan\` -> \`$zc-task-plan\`
+- \`zc:build\` -> \`$zc-build\`
+- \`zc:quality-review\` -> \`$zc-quality-review\`
+- \`zc:verify\` -> \`$zc-verify\`
+- \`zc:debug\` -> \`$zc-debug\`
+- \`zc:doc\` -> \`$zc-doc\`
+- \`zc:ship\` -> \`$zc-ship\`
+- \`zc:onboard\` -> \`$zc-onboard\`
+- \`zc:ctx-health\` -> \`$zc-ctx-health\`
+
+## 固定 workflow
+
+### 1. product-analysis
+
+适用：
+- 需求还模糊
+- 需要先把目标、范围和验收标准收敛清楚
+
+默认 skill：
+- \`$zc-product-analysis\`
+- 需要更深的设计或规格时，再接 \`$zc-brainstorming-and-design\` / \`$zc-spec-driven-development\`
+
+### 2. full-delivery
+
+适用：
+- 新功能、较大改动、完整交付
+
+默认 skill：
+- \`$zc-sdd-tdd\`
+- 需要完整主流程时，再接 \`$zc-sdd-tdd-workflow\`
+
+### 3. bugfix
+
+适用：
+- Bug、失败测试、异常行为
+
+默认 skill：
+- \`$zc-debug\`
+- 需要深入根因分析时，再接 \`$zc-debugging-and-error-recovery\`
+
+### 4. review-closure
+
+适用：
+- 已有改动，当前重点是审查、反馈处理、收尾
+
+默认 skill：
+- \`$zc-quality-review\`
+- 必要时接 \`$zc-code-review-and-quality\` / \`$zc-review-response-and-resolution\`
+
+### 5. docs-release
+
+适用：
+- 文档、ADR、发布说明、发布后同步
+
+默认 skill：
+- \`$zc-doc\`
+- 发布收尾时可接 \`$zc-ship\`
+- 必要时接 \`$zc-documentation-and-adrs\` / \`$zc-release-documentation-sync\`
+
+### 6. investigation
 
-此工件由工具包资产生成。
+适用：
+- 陌生代码库
+- 上下文失焦
+- 需要先摸清项目或限制
+
+默认 skill：
+- \`$zc-onboard\` / \`$zc-ctx-health\`
+- 必要时接 \`$zc-codebase-onboarding\` / \`$zc-context-engineering\`
+
+## 推荐开始方式
+
+- 不确定从哪开始：直接用 \`$zc-start\`
+- 需求还模糊：先用 \`$zc-product-analysis\`
+- 已确认是完整交付：直接用 \`$zc-sdd-tdd\`
+- 明确是 bug：直接用 \`$zc-debug\`
+- 明确是审查：直接用 \`$zc-quality-review\`
+
+## 最常用入口速查
+
+- 做新需求但范围还没收敛：\`$zc-product-analysis\`
+- 进入完整交付主流程：\`$zc-sdd-tdd\`
+- 修 bug：\`$zc-debug\`
+- 做代码审查和反馈收敛：\`$zc-quality-review\`
+- 补文档或发布说明：\`$zc-doc\`
+- 陌生项目先摸底：\`$zc-onboard\` 或 \`$zc-ctx-health\`
+
+## 详细内容在哪里
+
+- command-alias skills：查看 \`skills/zc-<command>/SKILL.md\`
+- workflow / 专项 skills：查看 \`skills/zc-<skill>/SKILL.md\`
+- 如果入口页不足以判断，就先打开对应 skill 再继续
+
+## 已安装能力
+
+此安装当前包含：
 
 - 清单来源：\`${manifestSource}\`
 - 匹配到的资产：${assets.length}
+- command-alias skills：${commandCount} 个
+- skills：${skillCount} 个
 
 ${renderAssetList(assets)}
 `;
 }
+function toCodexSkillSlug(asset) {
+    return asset.id.replace(/^(skill|command):/, "");
+}
+function toCodexSkillDirectory(asset) {
+    return `skills/zc-${toCodexSkillSlug(asset)}`;
+}
+function renderYamlFrontmatter(fields) {
+    const lines = ["---"];
+    for (const [key, value] of Object.entries(fields)) {
+        if (!value) {
+            continue;
+        }
+        lines.push(`${key}: ${JSON.stringify(value)}`);
+    }
+    lines.push("---");
+    return `${lines.join("\n")}\n`;
+}
+function renderSkillFile(options) {
+    return `${renderYamlFrontmatter({
+        name: options.name,
+        description: options.description,
+    })}\n${options.body.trim()}\n`;
+}
+function renderCodexCommandAliasBody(asset) {
+    const commandName = toCodexSkillSlug(asset);
+    return `# zc:${commandName}
+
+这是 Codex 的 command-alias skill。
+
+使用方式：
+
+- 在 Codex 中直接调用 \`$zc-${commandName}\`
+- 它对应统一命令语义 \`zc:${commandName}\`
+- 如果需要更深的方法细节，再继续调用相关专题 skill
+
+${(asset.body ?? `# ${describeAsset(asset)}\n`).trim()}
+`;
+}
+function renderCodexSkillArtifacts(assets) {
+    return assets.map((asset) => ({
+        path: `${toCodexSkillDirectory(asset)}/SKILL.md`,
+        content: renderSkillFile({
+            name: `zc-${asset.name ?? toCodexSkillSlug(asset)}`,
+            description: asset.summary ?? describeAsset(asset),
+            body: asset.body ?? `# ${describeAsset(asset)}\n`,
+        }),
+    }));
+}
+function renderCodexCommandAliasArtifacts(assets) {
+    return assets.map((asset) => ({
+        path: `${toCodexSkillDirectory(asset)}/SKILL.md`,
+        content: renderSkillFile({
+            name: `zc-${asset.name ?? toCodexSkillSlug(asset)}`,
+            description: asset.summary ?? describeAsset(asset),
+            body: renderCodexCommandAliasBody(asset),
+        }),
+    }));
+}
 export function createCodexGenerationPlan(manifest, options = {}) {
     const matchedAssets = selectMatchedAssets(manifest, platformName);
+    const commandAssets = selectMatchedAssetsByKind(manifest, "command");
+    const skillAssets = selectMatchedAssetsByKind(manifest, "skill");
     const manifestSource = options.manifestSource ?? manifest.source ?? "toolkit-manifest";
     const resolvedPackageName = options.packageName ?? packageName;
-    return {
+    return attachPlanMetadata({
         platform: platformName,
         packageName: resolvedPackageName,
         manifestSource,
         matchedAssets,
+        capability,
         artifacts: [
             {
                 path: templateFiles.agents,
                 content: renderAgentsFile(manifestSource, matchedAssets),
             },
+            ...renderCodexCommandAliasArtifacts(commandAssets),
+            ...renderCodexSkillArtifacts(skillAssets),
         ],
-    };
+    });
 }
 export function createCodexInstallPlan(manifest, options) {
-    return createInstallPlan(createCodexGenerationPlan(manifest, options), options);
+    const generationPlan = createCodexGenerationPlan(manifest, options);
+    if (options.scope === "project") {
+        const installPlan = createInstallPlan({
+            ...generationPlan,
+            artifacts: generationPlan.artifacts.filter((artifact) => artifact.path === templateFiles.agents),
+        }, options);
+        return {
+            ...installPlan,
+            matchedAssets: generationPlan.matchedAssets,
+            capability,
+            scope: options.scope ?? "project",
+        };
+    }
+    const installPlan = createInstallPlan(generationPlan, options);
+    return {
+        ...installPlan,
+        matchedAssets: generationPlan.matchedAssets,
+        capability,
+        scope: options.scope ?? "project",
+    };
 }
 //# sourceMappingURL=index.js.map

package/vendor/packages/platform-codex/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,mBAAmB,GAOpB,MAAM,sBAAsB,CAAC;AAS9B,MAAM,CAAC,MAAM,YAAY,GAAG,OAAgB,CAAC;AAC7C,MAAM,CAAC,MAAM,WAAW,GAAG,uBAAgC,CAAC;AAU5D,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,WAAW;CACX,CAAC;AAEX,SAAS,eAAe,CAAC,MAAmC;IAC1D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,EAAE,OAAO,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;SAC9E,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,cAAsB,EAAE,MAAmC;IACnF,OAAO;;;;WAIE,cAAc;WACd,MAAM,CAAC,MAAM;;EAEtB,eAAe,CAAC,MAAM,CAAC;CACxB,CAAC;AACF,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,QAA6B,EAC7B,UAA6B,EAAE;IAE/B,MAAM,aAAa,GAAG,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAClE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,QAAQ,CAAC,MAAM,IAAI,kBAAkB,CAAC;IACvF,MAAM,mBAAmB,GAAG,OAAO,CAAC,WAAW,IAAI,WAAW,CAAC;IAE/D,OAAO;QACL,QAAQ,EAAE,YAAY;QACtB,WAAW,EAAE,mBAAmB;QAChC,cAAc;QACd,aAAa;QACb,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,aAAa,CAAC,MAAM;gBAC1B,OAAO,EAAE,gBAAgB,CAAC,cAAc,EAAE,aAAa,CAAC;aACzD;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAA6B,EAC7B,OAAuB;IAEvB,OAAO,iBAAiB,CAAC,yBAAyB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AAClF,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/vendor/packages/platform-codex/dist/index.test.js

@@ -1,6 +1,6 @@
 import { describe, it } from "node:test";
 import assert from "node:assert/strict";
-import { createCodexGenerationPlan, createCodexInstallPlan, packageName, platformName, templateFiles, } from "./index.js";
+import { capability, createCodexGenerationPlan, createCodexInstallPlan, packageName, platformName, templateFiles, } from "./index.js";
 const manifest = {
     source: "toolkit-manifest",
     assets: [
@@ -11,10 +11,13 @@ const manifest = {
             title: "Alpha skill",
         },
         {
-            id: "command-beta",
+            id: "command:start",
             kind: "command",
-            platforms: ["qoder"],
-            title: "Beta command",
+            platforms: ["codex"],
+            title: "Start command",
+            name: "start",
+            summary: "统一任务开始入口",
+            body: "# 开始\n\n先判断工作流类型，再选择入口。\n",
         },
     ],
 };
@@ -24,15 +27,42 @@ describe("@zmice/platform-codex scaffold", () => {
         assert.equal(plan.platform, platformName);
         assert.equal(plan.packageName, packageName);
         assert.equal(plan.manifestSource, "toolkit-manifest");
-        assert.deepEqual(plan.matchedAssets.map((asset) => asset.id), ["skill-alpha"]);
-        assert.deepEqual(plan.artifacts.map((artifact) => artifact.path), [templateFiles.agents]);
-        assert.ok(plan.artifacts[0]?.content.includes("skill-alpha"));
+        assert.deepEqual(plan.matchedAssets.map((asset) => asset.id), ["skill-alpha", "command:start"]);
+        assert.deepEqual(plan.capability, capability);
+        assert.deepEqual(plan.artifacts.map((artifact) => artifact.path), [
+            templateFiles.agents,
+            "skills/zc-start/SKILL.md",
+            "skills/zc-skill-alpha/SKILL.md",
+        ]);
+        assert.ok(plan.artifacts[0]?.content.includes("Codex 工作流入口"));
+        assert.ok(plan.artifacts[0]?.content.includes("$zc-sdd-tdd"));
+        assert.ok(plan.artifacts[0]?.content.includes("统一命令语义到 Codex skill 的映射"));
+        assert.ok(plan.artifacts[0]?.content.includes("固定 workflow"));
+        assert.ok(plan.artifacts[1]?.content.includes("command-alias skill"));
+        assert.ok(plan.artifacts[1]?.content.includes("$zc-start"));
+        assert.ok(plan.artifacts[2]?.content.includes("Alpha skill"));
     });
-    it("creates an install plan with safe overwrite defaults", () => {
-        const plan = createCodexInstallPlan(manifest, { destinationRoot: "/tmp/codex" });
+    it("creates a global install plan with AGENTS and skills", () => {
+        const plan = createCodexInstallPlan(manifest, {
+            destinationRoot: "/tmp/codex",
+            scope: "global",
+        });
         assert.equal(plan.destinationRoot, "/tmp/codex");
+        assert.equal(plan.scope, "global");
         assert.equal(plan.overwrite, "error");
-        assert.deepEqual(plan.artifacts.map((artifact) => artifact.path), ["/tmp/codex/AGENTS.md"]);
+        assert.deepEqual(plan.artifacts.map((artifact) => artifact.path), [
+            "/tmp/codex/AGENTS.md",
+            "/tmp/codex/skills/zc-start/SKILL.md",
+            "/tmp/codex/skills/zc-skill-alpha/SKILL.md",
+        ]);
+    });
+    it("keeps project installs conservative and only writes AGENTS.md", () => {
+        const plan = createCodexInstallPlan(manifest, {
+            destinationRoot: "/tmp/project",
+            scope: "project",
+        });
+        assert.equal(plan.scope, "project");
+        assert.deepEqual(plan.artifacts.map((artifact) => artifact.path), ["/tmp/project/AGENTS.md"]);
     });
 });
 //# sourceMappingURL=index.test.js.map

package/vendor/packages/platform-codex/dist/index.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,WAAW,EACX,YAAY,EACZ,aAAa,GAEd,MAAM,YAAY,CAAC;AAEpB,MAAM,QAAQ,GAAwB;IACpC,MAAM,EAAE,kBAAkB;IAC1B,MAAM,EAAE;QACN;YACE,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;YAC5B,KAAK,EAAE,aAAa;SACrB;QACD;YACE,EAAE,EAAE,cAAc;YAClB,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,CAAC,OAAO,CAAC;YACpB,KAAK,EAAE,cAAc;SACtB;KACF;CACF,CAAC;AAEF,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,IAAI,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;QAEjD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QACtD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;QAC/E,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1F,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,IAAI,GAAG,sBAAsB,CAAC,QAAQ,EAAE,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC,CAAC;QAEjF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"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"}

package/vendor/packages/platform-opencode/dist/generate.d.ts

@@ -0,0 +1,2 @@
+export { createOpenCodeGenerationPlan, packageName, platformName, templateFiles, type GenerationOptions, type GenerationPlan, type PlatformArtifact, type ToolkitAssetLike, type ToolkitManifestLike, } from "./index.js";
+//# sourceMappingURL=generate.d.ts.map

package/vendor/packages/platform-opencode/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,WAAW,EACX,YAAY,EACZ,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC"}

package/vendor/packages/platform-opencode/dist/generate.js

@@ -0,0 +1,2 @@
+export { createOpenCodeGenerationPlan, packageName, platformName, templateFiles, } from "./index.js";
+//# sourceMappingURL=generate.js.map

package/vendor/packages/platform-opencode/dist/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,WAAW,EACX,YAAY,EACZ,aAAa,GAMd,MAAM,YAAY,CAAC"}

package/vendor/packages/platform-opencode/dist/index.d.ts

@@ -0,0 +1,46 @@
+import { type GenerationPlan as BaseGenerationPlan, type InstallPlan as BaseInstallPlan, type InstallPlanOptions, type PlatformArtifact, type ToolkitAssetLike, type ToolkitManifestLike } from "@zmice/platform-core";
+export type InstallScope = "project" | "global" | "dir";
+export type PlatformCapabilitySurface = "entry-file" | "commands-dir" | "skills-dir" | "agents-dir";
+export interface PlatformCapability {
+    readonly platform: typeof platformName;
+    readonly namespace: string;
+    readonly surfaces: readonly PlatformCapabilitySurface[];
+    readonly entryFile: {
+        readonly fileName: string;
+    };
+    readonly commands: {
+        readonly relativeDir: string;
+        readonly fileExtension: ".md";
+    };
+    readonly skills: {
+        readonly relativeDir: string;
+        readonly fileName: "SKILL.md";
+    };
+    readonly agents: {
+        readonly relativeDir: string;
+        readonly fileExtension: ".md";
+    };
+}
+export interface GenerationOptions {
+    readonly packageName?: string;
+    readonly manifestSource?: string;
+    readonly scope?: InstallScope;
+}
+export type InstallOptions = GenerationOptions & InstallPlanOptions;
+export interface GenerationPlan extends BaseGenerationPlan {
+    readonly capability: PlatformCapability;
+}
+export interface InstallPlan extends BaseInstallPlan {
+    readonly capability: PlatformCapability;
+    readonly scope: InstallScope;
+}
+export declare const platformName: "opencode";
+export declare const packageName: "@zmice/platform-opencode";
+export type { PlatformArtifact, ToolkitAssetLike, ToolkitManifestLike, };
+export declare const templateFiles: {
+    readonly agents: "AGENTS.md";
+};
+export declare const capability: PlatformCapability;
+export declare function createOpenCodeGenerationPlan(manifest: ToolkitManifestLike, options?: GenerationOptions): GenerationPlan;
+export declare function createOpenCodeInstallPlan(manifest: ToolkitManifestLike, options: InstallOptions): InstallPlan;
+//# sourceMappingURL=index.d.ts.map

package/vendor/packages/platform-opencode/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,cAAc,IAAI,kBAAkB,EACzC,KAAK,WAAW,IAAI,eAAe,EACnC,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC;AAExD,MAAM,MAAM,yBAAyB,GACjC,YAAY,GACZ,cAAc,GACd,YAAY,GACZ,YAAY,CAAC;AAEjB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,OAAO,YAAY,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE;QAClB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC;KAC/B,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;KAC/B,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC;KAC/B,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;CAC/B;AAED,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAEpE,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;CACzC;AAED,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED,eAAO,MAAM,YAAY,EAAG,UAAmB,CAAC;AAChD,eAAO,MAAM,WAAW,EAAG,0BAAmC,CAAC;AAE/D,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,GACpB,CAAC;AAEF,eAAO,MAAM,aAAa;;CAEhB,CAAC;AAEX,eAAO,MAAM,UAAU,EAAE,kBAmBxB,CAAC;AA2TF,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,GAAE,iBAAsB,GAC9B,cAAc,CA6BhB;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE,cAAc,GACtB,WAAW,CAcb"}