@zmice/zc 0.1.0 → 0.2.0

package/dist/utils/workspace.js

@@ -0,0 +1,103 @@
+import { existsSync } from "node:fs";
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+export class ArtifactConflictError extends Error {
+    conflicts;
+    constructor(conflicts) {
+        super(`Artifact conflicts detected for ${conflicts.length} file(s).`);
+        this.name = "ArtifactConflictError";
+        this.conflicts = conflicts;
+    }
+}
+function resolveFromModule(moduleUrl, relativePath) {
+    return resolve(dirname(fileURLToPath(moduleUrl)), relativePath);
+}
+function resolveCliPackageRoot(moduleUrl = import.meta.url) {
+    return resolveFromModule(moduleUrl, "../..");
+}
+function isWorkspaceLikeRoot(root) {
+    return (existsSync(join(root, "packages", "toolkit")) &&
+        existsSync(join(root, "packages", "platform-qwen")) &&
+        existsSync(join(root, "references", "upstreams.yaml")));
+}
+export function resolveWorkspaceRoot(moduleUrl = import.meta.url) {
+    const packageRoot = resolveCliPackageRoot(moduleUrl);
+    const repoRoot = resolve(packageRoot, "..", "..");
+    const vendorRoot = join(packageRoot, "vendor");
+    if (isWorkspaceLikeRoot(repoRoot)) {
+        return repoRoot;
+    }
+    if (isWorkspaceLikeRoot(vendorRoot)) {
+        return vendorRoot;
+    }
+    throw new Error(`Unable to resolve workspace root from ${packageRoot}. Expected either a monorepo root or a vendored runtime root.`);
+}
+export function resolveWorkspacePath(relativePath, moduleUrl = import.meta.url) {
+    return resolve(resolveWorkspaceRoot(moduleUrl), relativePath);
+}
+export async function importWorkspaceDistModule(relativePath, moduleUrl = import.meta.url) {
+    const absolutePath = resolveWorkspacePath(relativePath, moduleUrl);
+    const workspaceRoot = resolveWorkspaceRoot(moduleUrl);
+    const isVendoredRuntime = workspaceRoot.endsWith(`${join("vendor")}`);
+    try {
+        await access(absolutePath);
+    }
+    catch {
+        const packagePath = relativePath.replace(/\/dist\/.*/, "");
+        throw new Error(isVendoredRuntime
+            ? `Vendored runtime module "${relativePath}" is missing. Rebuild @zmice/zc so vendor artifacts are regenerated.`
+            : `Workspace module "${relativePath}" is not built yet. Build it first, e.g. "pnpm --dir ${dirname(resolveWorkspacePath(packagePath, moduleUrl))} build".`);
+    }
+    return import(pathToFileURL(absolutePath).href);
+}
+export async function writeArtifacts(artifacts, options = {}) {
+    const overwrite = options.overwrite ?? "error";
+    const dryRun = options.dryRun ?? false;
+    const conflicts = [];
+    const pendingWrites = [];
+    const result = {
+        created: 0,
+        overwritten: 0,
+        unchanged: 0,
+        skipped: 0,
+        dryRun
+    };
+    for (const artifact of artifacts) {
+        let existingContent;
+        try {
+            existingContent = await readFile(artifact.path, "utf8");
+        }
+        catch {
+            existingContent = undefined;
+        }
+        if (existingContent === artifact.content) {
+            result.unchanged += 1;
+            continue;
+        }
+        if (existingContent !== undefined && overwrite === "error") {
+            conflicts.push({ path: artifact.path });
+            continue;
+        }
+        pendingWrites.push(artifact);
+        if (existingContent === undefined) {
+            result.created += 1;
+        }
+        else {
+            result.overwritten += 1;
+        }
+    }
+    if (conflicts.length > 0) {
+        throw new ArtifactConflictError(conflicts);
+    }
+    if (dryRun) {
+        result.skipped = pendingWrites.length;
+        return result;
+    }
+    for (const artifact of pendingWrites) {
+        await mkdir(dirname(artifact.path), { recursive: true });
+        await writeFile(artifact.path, artifact.content, "utf8");
+    }
+    return result;
+}
+//# sourceMappingURL=workspace.js.map

package/dist/utils/workspace.js.map

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

package/dist/utils/workspace.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workspace.test.d.ts.map

package/dist/utils/workspace.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.test.d.ts","sourceRoot":"","sources":["../../src/utils/workspace.test.ts"],"names":[],"mappings":""}

package/dist/utils/workspace.test.js

@@ -0,0 +1,50 @@
+import assert from "node:assert/strict";
+import { mkdir, mkdtemp, readFile, stat, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { pathToFileURL } from "node:url";
+import { afterEach, describe, it } from "vitest";
+import { ArtifactConflictError, resolveWorkspaceRoot, writeArtifacts } from "./workspace.js";
+const tempDirs = [];
+async function createTempDir() {
+    const dir = await mkdtemp(join(tmpdir(), "ai-coding-workspace-"));
+    tempDirs.push(dir);
+    return dir;
+}
+afterEach(async () => {
+    await Promise.all(tempDirs.splice(0, tempDirs.length).map(async (dir) => {
+        const fs = await import("node:fs/promises");
+        await fs.rm(dir, { recursive: true, force: true });
+    }));
+});
+describe("writeArtifacts", () => {
+    it("fails before writing any files when overwrite mode is error and conflicts exist", async () => {
+        const root = await createTempDir();
+        const conflictPath = join(root, "AGENTS.md");
+        const newPath = join(root, "QWEN.md");
+        await writeFile(conflictPath, "old-content", "utf8");
+        await assert.rejects(writeArtifacts([
+            { path: conflictPath, content: "new-content" },
+            { path: newPath, content: "generated-content" },
+        ], { overwrite: "error" }), (error) => error instanceof ArtifactConflictError && error.conflicts.length === 1);
+        assert.equal(await readFile(conflictPath, "utf8"), "old-content");
+        await assert.rejects(stat(newPath));
+    });
+});
+describe("resolveWorkspaceRoot", () => {
+    it("falls back to vendored runtime root when monorepo markers are absent", async () => {
+        const root = await createTempDir();
+        const packageRoot = join(root, "pkg");
+        const modulePath = join(packageRoot, "dist", "utils", "workspace.js");
+        const vendorRoot = join(packageRoot, "vendor");
+        await mkdir(join(vendorRoot, "packages", "toolkit"), { recursive: true });
+        await mkdir(join(vendorRoot, "packages", "platform-qwen"), { recursive: true });
+        await mkdir(join(vendorRoot, "references"), { recursive: true });
+        await writeFile(join(vendorRoot, "references", "upstreams.yaml"), "upstreams:\n", "utf8");
+        await mkdir(join(packageRoot, "dist", "utils"), { recursive: true });
+        await writeFile(modulePath, "", "utf8");
+        const resolved = resolveWorkspaceRoot(pathToFileURL(modulePath).href);
+        assert.equal(resolved, vendorRoot);
+    });
+});
+//# sourceMappingURL=workspace.test.js.map

package/dist/utils/workspace.test.js.map

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

package/package.json

@@ -1,36 +1,48 @@
-{
-  "name": "@zmice/zc",
-  "version": "0.1.0",
-  "description": "Multi-CLI team orchestration runtime for AI development workflows",
-  "keywords": ["cli", "orchestration", "tmux", "team", "ai", "codex", "multi-agent"],
-  "license": "MIT",
-  "type": "module",
-  "bin": {
-    "zc": "./dist/cli/index.js"
-  },
-  "files": [
-    "dist",
-    "!dist/**/__tests__",
-    "!dist/**/*.test.*",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest",
-    "lint": "tsc --noEmit",
-    "prepublishOnly": "npm run lint && npm run test -- --run && npm run build"
-  },
-  "dependencies": {
-    "commander": "^13.0.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.7.0",
-    "@types/node": "^22.0.0",
-    "vitest": "^3.0.0"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  }
-}
+{
+  "name": "@zmice/zc",
+  "version": "0.2.0",
+  "description": "Operator/runtime CLI for the AI Coding Toolkit workspace",
+  "keywords": [
+    "cli",
+    "orchestration",
+    "tmux",
+    "team",
+    "ai",
+    "codex",
+    "multi-agent"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "zc": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "vendor",
+    "README.md"
+  ],
+  "dependencies": {
+    "commander": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "@zmice/platform-codex": "0.1.0",
+    "@zmice/platform-qoder": "0.1.0",
+    "@zmice/platform-core": "0.1.0",
+    "@zmice/platform-qwen": "0.1.0",
+    "@zmice/toolkit": "0.1.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "node ./scripts/ensure-internal-builds.mjs && tsc && node ./scripts/vendor-internal-packages.mjs",
+    "dev": "tsc --watch",
+    "test": "node ./scripts/ensure-internal-builds.mjs && vitest run",
+    "lint": "tsc --noEmit",
+    "generate": "pnpm build",
+    "verify": "pnpm test && pnpm build"
+  }
+}

package/vendor/node_modules/@zmice/platform-core/dist/index.d.ts

@@ -0,0 +1,72 @@
+export type PlatformName = "qwen" | "codex" | "qoder";
+export type ToolkitAssetKind = "skill" | "command" | "agent";
+export type OverwriteMode = "error" | "force";
+export interface ToolkitAssetLike {
+    readonly id: string;
+    readonly kind: ToolkitAssetKind;
+    readonly platforms: readonly string[];
+    readonly title?: string;
+    readonly summary?: string;
+    readonly body?: string;
+}
+export interface ToolkitManifestLike {
+    readonly source?: string;
+    readonly assets: readonly ToolkitAssetLike[];
+}
+export interface PlatformArtifact {
+    readonly path: string;
+    readonly content: string;
+    readonly metadata?: PlatformArtifactMetadata;
+}
+export interface PlatformFingerprint {
+    readonly algorithm: "sha256";
+    readonly value: string;
+}
+export interface PlatformArtifactMetadata {
+    readonly bytes: number;
+    readonly fingerprint: PlatformFingerprint;
+}
+export interface PlatformPlanMetadata {
+    readonly artifactCount: number;
+    readonly fingerprint: PlatformFingerprint;
+}
+export interface GenerationPlan {
+    readonly platform: PlatformName;
+    readonly packageName: string;
+    readonly manifestSource: string;
+    readonly matchedAssets: readonly ToolkitAssetLike[];
+    readonly artifacts: readonly PlatformArtifact[];
+    readonly metadata?: PlatformPlanMetadata;
+}
+export interface InstallPlan extends GenerationPlan {
+    readonly destinationRoot: string;
+    readonly overwrite: OverwriteMode;
+}
+export interface InstallPlanOptions {
+    readonly destinationRoot: string;
+    readonly overwrite?: OverwriteMode;
+}
+export interface GeneratedHeaderOptions {
+    readonly linePrefix: string;
+    readonly lines: readonly string[];
+}
+export declare function describeAsset(asset: ToolkitAssetLike): string;
+export declare function createStableFingerprint(value: unknown): PlatformFingerprint;
+export declare function createArtifactMetadata(artifact: {
+    readonly content: string;
+}): PlatformArtifactMetadata;
+export declare function attachArtifactMetadata(artifact: PlatformArtifact): PlatformArtifact & {
+    readonly metadata: PlatformArtifactMetadata;
+};
+export declare function createPlanMetadata(plan: GenerationPlan): PlatformPlanMetadata;
+export declare function attachPlanMetadata<T extends GenerationPlan>(plan: T): T & {
+    readonly artifacts: readonly (PlatformArtifact & {
+        readonly metadata: PlatformArtifactMetadata;
+    })[];
+    readonly metadata: PlatformPlanMetadata;
+};
+export declare function prependGeneratedHeader(content: string, options: GeneratedHeaderOptions): string;
+export declare function selectMatchedAssets(manifest: ToolkitManifestLike, platform: PlatformName): readonly ToolkitAssetLike[];
+export declare function prefixArtifacts(destinationRoot: string, artifacts: readonly PlatformArtifact[]): readonly PlatformArtifact[];
+export declare function createInstallPlan(generationPlan: GenerationPlan, options: InstallPlanOptions): InstallPlan;
+//# sourceMappingURL=index.d.ts.map

package/vendor/node_modules/@zmice/platform-core/dist/index.d.ts.map

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

package/vendor/node_modules/@zmice/platform-core/dist/index.js

@@ -0,0 +1,105 @@
+import { createHash } from "node:crypto";
+import { join } from "node:path";
+export function describeAsset(asset) {
+    return asset.title ?? asset.summary ?? asset.id;
+}
+function normalizeFingerprintValue(value) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => normalizeFingerprintValue(entry));
+    }
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value)
+            .filter(([, entry]) => entry !== undefined)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, entry]) => [key, normalizeFingerprintValue(entry)]));
+    }
+    return value;
+}
+function isInstallPlan(plan) {
+    return "destinationRoot" in plan && "overwrite" in plan;
+}
+function buildPlanFingerprintInput(plan, artifacts) {
+    return {
+        platform: plan.platform,
+        packageName: plan.packageName,
+        manifestSource: plan.manifestSource,
+        matchedAssets: plan.matchedAssets.map((asset) => ({
+            id: asset.id,
+            kind: asset.kind,
+            platforms: [...asset.platforms].sort(),
+            summary: asset.summary,
+            title: asset.title,
+        })),
+        artifacts: artifacts.map((artifact) => ({
+            path: artifact.path,
+            metadata: artifact.metadata ?? createArtifactMetadata(artifact),
+        })),
+        ...(isInstallPlan(plan)
+            ? {
+                destinationRoot: plan.destinationRoot,
+                overwrite: plan.overwrite,
+            }
+            : {}),
+    };
+}
+export function createStableFingerprint(value) {
+    const normalized = JSON.stringify(normalizeFingerprintValue(value));
+    const hash = createHash("sha256");
+    hash.update(normalized);
+    return {
+        algorithm: "sha256",
+        value: hash.digest("hex"),
+    };
+}
+export function createArtifactMetadata(artifact) {
+    return {
+        bytes: Buffer.byteLength(artifact.content),
+        fingerprint: createStableFingerprint(artifact.content),
+    };
+}
+export function attachArtifactMetadata(artifact) {
+    return {
+        ...artifact,
+        metadata: createArtifactMetadata(artifact),
+    };
+}
+export function createPlanMetadata(plan) {
+    const artifacts = plan.artifacts.map((artifact) => attachArtifactMetadata(artifact));
+    return {
+        artifactCount: artifacts.length,
+        fingerprint: createStableFingerprint(buildPlanFingerprintInput(plan, artifacts)),
+    };
+}
+export function attachPlanMetadata(plan) {
+    const artifacts = plan.artifacts.map((artifact) => attachArtifactMetadata(artifact));
+    return {
+        ...plan,
+        artifacts,
+        metadata: createPlanMetadata({
+            ...plan,
+            artifacts,
+        }),
+    };
+}
+export function prependGeneratedHeader(content, options) {
+    const header = options.lines.map((line) => `${options.linePrefix} ${line}`).join("\n");
+    return `${header}\n\n${content}`;
+}
+export function selectMatchedAssets(manifest, platform) {
+    return manifest.assets.filter((asset) => asset.platforms.includes(platform));
+}
+export function prefixArtifacts(destinationRoot, artifacts) {
+    return artifacts.map((artifact) => ({
+        ...attachArtifactMetadata(artifact),
+        path: join(destinationRoot, artifact.path),
+    }));
+}
+export function createInstallPlan(generationPlan, options) {
+    return attachPlanMetadata({
+        ...generationPlan,
+        destinationRoot: options.destinationRoot,
+        overwrite: options.overwrite ?? "error",
+        artifacts: prefixArtifacts(options.destinationRoot, generationPlan.artifacts),
+    });
+}
+//# sourceMappingURL=index.js.map

package/vendor/node_modules/@zmice/platform-core/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAiEjC,MAAM,UAAU,aAAa,CAAC,KAAuB;IACnD,OAAO,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAc;IAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;aAClB,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;aAC1C,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;aACpD,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC,CAClE,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,IAAoB;IACzC,OAAO,iBAAiB,IAAI,IAAI,IAAI,WAAW,IAAI,IAAI,CAAC;AAC1D,CAAC;AAED,SAAS,yBAAyB,CAChC,IAAoB,EACpB,SAAsC;IAEtC,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAChD,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE;YACtC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;QACH,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACtC,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,sBAAsB,CAAC,QAAQ,CAAC;SAChE,CAAC,CAAC;QACH,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC;YACrB,CAAC,CAAC;gBACE,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAElC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAExB,OAAO;QACL,SAAS,EAAE,QAAQ;QACnB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAAsC;IAEtC,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC1C,WAAW,EAAE,uBAAuB,CAAC,QAAQ,CAAC,OAAO,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAA0B;IAE1B,OAAO;QACL,GAAG,QAAQ;QACX,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAoB;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAErF,OAAO;QACL,aAAa,EAAE,SAAS,CAAC,MAAM;QAC/B,WAAW,EAAE,uBAAuB,CAAC,yBAAyB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;KACjF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAAO;IAKP,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAErF,OAAO;QACL,GAAG,IAAI;QACP,SAAS;QACT,QAAQ,EAAE,kBAAkB,CAAC;YAC3B,GAAG,IAAI;YACP,SAAS;SACV,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,OAA+B;IACrF,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEvF,OAAO,GAAG,MAAM,OAAO,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAA6B,EAC7B,QAAsB;IAEtB,OAAO,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,eAAuB,EACvB,SAAsC;IAEtC,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClC,GAAG,sBAAsB,CAAC,QAAQ,CAAC;QACnC,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,IAAI,CAAC;KAC3C,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,cAA8B,EAC9B,OAA2B;IAE3B,OAAO,kBAAkB,CAAC;QACxB,GAAG,cAAc;QACjB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,OAAO;QACvC,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,eAAe,EAAE,cAAc,CAAC,SAAS,CAAC;KAC9E,CAAC,CAAC;AACL,CAAC"}

package/vendor/node_modules/@zmice/platform-core/dist/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/vendor/node_modules/@zmice/platform-core/dist/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/vendor/node_modules/@zmice/platform-core/dist/index.test.js

@@ -0,0 +1,104 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { attachPlanMetadata, createArtifactMetadata, createStableFingerprint, createInstallPlan, prependGeneratedHeader, selectMatchedAssets, } from "./index.js";
+const manifest = {
+    source: "toolkit-manifest",
+    assets: [
+        {
+            id: "skill-alpha",
+            kind: "skill",
+            platforms: ["qwen", "codex"],
+            title: "Alpha skill",
+        },
+        {
+            id: "command-beta",
+            kind: "command",
+            platforms: ["qoder"],
+            title: "Beta command",
+        },
+    ],
+};
+const artifacts = [
+    {
+        path: "QWEN.md",
+        content: "# qwen",
+    },
+];
+describe("@zmice/platform-core", () => {
+    it("creates stable sha256 fingerprints independent of object key order", () => {
+        const first = createStableFingerprint({
+            b: 2,
+            a: 1,
+            nested: {
+                z: true,
+                y: [{ b: "second", a: "first" }],
+            },
+        });
+        const second = createStableFingerprint({
+            nested: {
+                y: [{ a: "first", b: "second" }],
+                z: true,
+            },
+            a: 1,
+            b: 2,
+        });
+        assert.deepEqual(first, second);
+        assert.equal(first.algorithm, "sha256");
+        assert.match(first.value, /^[a-f0-9]{64}$/);
+    });
+    it("derives artifact metadata from content without coupling it to the artifact path", () => {
+        const originalArtifact = {
+            path: "QWEN.md",
+            content: "# qwen\n",
+        };
+        const renamedArtifact = {
+            path: "/tmp/qwen/QWEN.md",
+            content: "# qwen\n",
+        };
+        const original = createArtifactMetadata(originalArtifact);
+        const renamed = createArtifactMetadata(renamedArtifact);
+        assert.equal(original.bytes, Buffer.byteLength("# qwen\n"));
+        assert.deepEqual(original, renamed);
+    });
+    it("selects assets by platform", () => {
+        const matched = selectMatchedAssets(manifest, "qwen");
+        assert.deepEqual(matched.map((asset) => asset.id), ["skill-alpha"]);
+    });
+    it("attaches generation metadata and normalizes artifact metadata", () => {
+        const plan = attachPlanMetadata({
+            platform: "qwen",
+            packageName: "@zmice/platform-qwen",
+            manifestSource: "toolkit-manifest",
+            matchedAssets: selectMatchedAssets(manifest, "qwen"),
+            artifacts,
+        });
+        assert.equal(plan.metadata?.artifactCount, 1);
+        assert.equal(plan.artifacts[0]?.metadata?.bytes, Buffer.byteLength("# qwen"));
+        assert.match(plan.metadata?.fingerprint.value ?? "", /^[a-f0-9]{64}$/);
+    });
+    it("creates install plans rooted at the destination with safe overwrite defaults", () => {
+        const generationPlan = attachPlanMetadata({
+            platform: "qwen",
+            packageName: "@zmice/platform-qwen",
+            manifestSource: "toolkit-manifest",
+            matchedAssets: selectMatchedAssets(manifest, "qwen"),
+            artifacts,
+        });
+        const plan = createInstallPlan(generationPlan, {
+            destinationRoot: "/tmp/qwen",
+        });
+        assert.equal(plan.destinationRoot, "/tmp/qwen");
+        assert.equal(plan.overwrite, "error");
+        assert.deepEqual(plan.artifacts.map((artifact) => artifact.path), ["/tmp/qwen/QWEN.md"]);
+        assert.deepEqual(plan.artifacts[0]?.metadata, generationPlan.artifacts[0]?.metadata);
+        assert.notEqual(plan.metadata?.fingerprint.value, generationPlan.metadata?.fingerprint.value);
+    });
+    it("prepends caller-defined generated headers without baking in a comment syntax", () => {
+        const content = prependGeneratedHeader("{\n  \"name\": \"demo\"\n}\n", {
+            linePrefix: "//",
+            lines: ["Generated file", "Do not edit manually"],
+        });
+        assert.equal(content, "// Generated file\n// Do not edit manually\n\n{\n  \"name\": \"demo\"\n}\n");
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/vendor/node_modules/@zmice/platform-core/dist/index.test.js.map

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

package/vendor/node_modules/@zmice/platform-core/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@zmice/platform-core",
+  "private": true,
+  "version": "0.1.0",
+  "description": "Shared contracts and helpers for AI Coding Toolkit platform packages",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "generate": "pnpm run build",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "test": "pnpm run build && node --test dist/index.test.js",
+    "verify": "pnpm run lint && pnpm run test && pnpm run build && pnpm run generate"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

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

@@ -0,0 +1,2 @@
+export { createCodexGenerationPlan, 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-codex/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,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-codex/dist/generate.js

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

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

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

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

@@ -0,0 +1,15 @@
+import { type GenerationPlan, type InstallPlan, type InstallPlanOptions, type PlatformArtifact, type ToolkitAssetLike, type ToolkitManifestLike } from "@zmice/platform-core";
+export interface GenerationOptions {
+    readonly packageName?: string;
+    readonly manifestSource?: string;
+}
+export type InstallOptions = GenerationOptions & InstallPlanOptions;
+export declare const platformName: "codex";
+export declare const packageName: "@zmice/platform-codex";
+export type { GenerationPlan, InstallPlan, PlatformArtifact, ToolkitAssetLike, ToolkitManifestLike, };
+export declare const templateFiles: {
+    readonly agents: "AGENTS.md";
+};
+export declare function createCodexGenerationPlan(manifest: ToolkitManifestLike, options?: GenerationOptions): GenerationPlan;
+export declare function createCodexInstallPlan(manifest: ToolkitManifestLike, options: InstallOptions): InstallPlan;
+//# sourceMappingURL=index.d.ts.map