@blkc-code/cli 0.0.0-stage → 0.1.1

package/dist/commands/circuit.js

@@ -0,0 +1,166 @@
+import { writeFile } from "node:fs/promises";
+import path from "node:path";
+import chalk from "chalk";
+import { CircuitRegistrySchema, CircuitSchema, IdentifierSchema, nowISO, } from "@blkc-code/core";
+import { ensureDirectory, exists, readJsonFile, workspacePath, writeJsonFile, } from "../utils/filesystem";
+const CIRCUITS_DIR = "circuits";
+const CIRCUIT_REGISTRY_PATH = "registry/circuits.json";
+const MANIFEST_FILENAME = "manifest.json";
+const README_FILENAME = "README.md";
+const collectValues = (value, previous) => [...previous, value];
+const parseKitReference = (input) => {
+    const [kitIdRaw, version = "0.1.0"] = input.split("@");
+    const kitId = IdentifierSchema.parse(kitIdRaw);
+    return { kitId, version };
+};
+const readRegistry = async () => {
+    try {
+        const registry = await readJsonFile(CIRCUIT_REGISTRY_PATH);
+        return CircuitRegistrySchema.parse(registry);
+    }
+    catch (error) {
+        console.warn(chalk.yellow("⚠ Circuit registry not found, creating a new one."));
+        return { updatedAt: nowISO(), circuits: [] };
+    }
+};
+const saveRegistry = async (registry) => {
+    await writeJsonFile(CIRCUIT_REGISTRY_PATH, {
+        ...registry,
+        updatedAt: nowISO(),
+    });
+};
+const manifestPath = (circuitId) => path.join(CIRCUITS_DIR, circuitId, MANIFEST_FILENAME);
+const writeManifest = async (circuitId, manifest) => {
+    await writeJsonFile(manifestPath(circuitId), manifest);
+};
+const readManifest = async (circuitId) => {
+    const manifest = await readJsonFile(manifestPath(circuitId));
+    return CircuitSchema.parse(manifest);
+};
+const renderReadme = (manifest) => {
+    const kits = manifest.kits.map((kit) => `- ${kit.kitId}@${kit.version}`).join("\n");
+    return `# ${manifest.name}\n\n${manifest.description}\n\n## Kits\n\n${kits}\n\n## Verticals\n\n${manifest.verticals.join(", ") || "general"}\n`;
+};
+const publishCircuit = async (circuitId) => {
+    const manifest = await readManifest(circuitId);
+    const registry = await readRegistry();
+    const remainder = registry.circuits.filter((circuit) => circuit.id !== circuitId);
+    const updated = {
+        updatedAt: nowISO(),
+        circuits: [...remainder, manifest].sort((a, b) => a.id.localeCompare(b.id)),
+    };
+    await saveRegistry(updated);
+    console.log(chalk.green(`✔ Published circuit ${manifest.id}@${manifest.version}`));
+};
+export const registerCircuitCommands = (program) => {
+    const circuit = program
+        .command("circuit")
+        .description("Manage BLKC circuits");
+    circuit
+        .command("list")
+        .description("List registered circuits")
+        .option("--json", "Emit JSON output", false)
+        .action(async (options) => {
+        const registry = await readRegistry();
+        if (registry.circuits.length === 0) {
+            console.log(chalk.yellow("No circuits registered yet."));
+            return;
+        }
+        if (options.json) {
+            console.log(JSON.stringify(registry.circuits, null, 2));
+            return;
+        }
+        registry.circuits
+            .sort((a, b) => a.id.localeCompare(b.id))
+            .forEach((item) => {
+            console.log(chalk.cyan(`${item.id}@${item.version}`));
+            console.log(`  name: ${item.name}`);
+            console.log(`  summary: ${item.summary}`);
+            console.log(`  kits: ${item.kits.map((kit) => kit.kitId).join(", ")}`);
+            console.log(`  status: ${item.status}`);
+            console.log("");
+        });
+    });
+    circuit
+        .command("create")
+        .description("Scaffold a circuit manifest")
+        .argument("<circuit-id>", "Circuit identifier (lowercase slug)")
+        .option("--name <name>", "Display name")
+        .option("--summary <summary>", "Short summary")
+        .option("--description <description>", "Long-form description")
+        .option("--version <semver>", "Version", "0.1.0")
+        .option("--vertical <vertical>", "Target vertical", collectValues, [])
+        .option("--kit <kit@version>", "Reference a kit", collectValues, [])
+        .option("--tag <tag>", "Add a tag", collectValues, [])
+        .option("--status <status>", "Circuit status", "draft")
+        .option("--launch-date <iso>", "Planned launch date")
+        .option("--maintainer-name <name>", "Maintainer name")
+        .option("--maintainer-email <email>", "Maintainer email")
+        .option("--maintainer-role <role>", "Maintainer role")
+        .option("--publish", "Publish after creation", false)
+        .option("--force", "Overwrite manifest if it exists", false)
+        .action(async (rawId, options) => {
+        const circuitId = IdentifierSchema.parse(rawId);
+        const manifestFile = manifestPath(circuitId);
+        const existsAlready = await exists(manifestFile);
+        if (existsAlready && !options.force) {
+            console.error(chalk.red(`✖ Circuit ${circuitId} already exists. Use --force to overwrite.`));
+            process.exitCode = 1;
+            return;
+        }
+        await ensureDirectory(path.join(CIRCUITS_DIR, circuitId));
+        const kits = options.kit.map(parseKitReference);
+        if (kits.length === 0) {
+            console.warn(chalk.yellow("⚠ No kits specified. Add them later before publishing."));
+        }
+        const manifestDraft = CircuitSchema.parse({
+            id: circuitId,
+            name: options.name ?? circuitId
+                .split("-")
+                .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))
+                .join(" "),
+            summary: options.summary ?? `Summary for ${circuitId}.`,
+            description: options.description ?? `Detailed description for circuit ${circuitId}. Update before publishing.`,
+            version: options.version,
+            verticals: options.vertical ?? [],
+            tags: options.tag ?? [],
+            kits,
+            status: options.status,
+            launchDate: options.launchDate,
+            maintainers: options.maintainerName
+                ? [
+                    {
+                        name: options.maintainerName,
+                        email: options.maintainerEmail,
+                        role: options.maintainerRole,
+                    },
+                ]
+                : [],
+        });
+        await writeManifest(circuitId, manifestDraft);
+        const readmePath = workspacePath(CIRCUITS_DIR, circuitId, README_FILENAME);
+        await writeFile(readmePath, renderReadme(manifestDraft), { encoding: "utf8" });
+        console.log(chalk.green(`✔ Created circuit scaffold at ${path.join(CIRCUITS_DIR, circuitId)}`));
+        if (options.publish) {
+            await publishCircuit(circuitId);
+        }
+        else {
+            console.log(chalk.gray(`Run 'blkc circuit publish ${circuitId}' after finalising the manifest.`));
+        }
+    });
+    circuit
+        .command("publish")
+        .description("Validate and add a circuit to the registry")
+        .argument("<circuit-id>", "Circuit identifier")
+        .action(async (rawId) => {
+        try {
+            const circuitId = IdentifierSchema.parse(rawId);
+            await publishCircuit(circuitId);
+        }
+        catch (error) {
+            console.error(chalk.red(`✖ Failed to publish circuit: ${error.message}`));
+            process.exitCode = 1;
+        }
+    });
+};
+//# sourceMappingURL=circuit.js.map

package/dist/commands/circuit.js.map

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

package/dist/commands/kit.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const registerKitCommands: (program: Command) => void;

package/dist/commands/kit.js

@@ -0,0 +1,175 @@
+import { writeFile } from "node:fs/promises";
+import path from "node:path";
+import chalk from "chalk";
+import { IdentifierSchema, KitRegistrySchema, KitSchema, nowISO, } from "@blkc-code/core";
+import { ensureDirectory, exists, readJsonFile, workspacePath, writeJsonFile, } from "../utils/filesystem";
+const KITS_DIR = "kits";
+const KIT_REGISTRY_PATH = "registry/kits.json";
+const MANIFEST_FILENAME = "manifest.json";
+const README_FILENAME = "README.md";
+const collectValues = (value, previous) => [...previous, value];
+const parseBlockReference = (input) => {
+    const [blockIdRaw, version = "0.1.0"] = input.split("@");
+    const blockId = IdentifierSchema.parse(blockIdRaw);
+    return { blockId, version };
+};
+const readRegistry = async () => {
+    try {
+        const registry = await readJsonFile(KIT_REGISTRY_PATH);
+        return KitRegistrySchema.parse(registry);
+    }
+    catch (error) {
+        console.warn(chalk.yellow("⚠ Kit registry not found, creating a new one."));
+        return { updatedAt: nowISO(), kits: [] };
+    }
+};
+const saveRegistry = async (registry) => {
+    await writeJsonFile(KIT_REGISTRY_PATH, {
+        ...registry,
+        updatedAt: nowISO(),
+    });
+};
+const manifestPath = (kitId) => path.join(KITS_DIR, kitId, MANIFEST_FILENAME);
+const writeManifest = async (kitId, manifest) => {
+    await writeJsonFile(manifestPath(kitId), manifest);
+};
+const readManifest = async (kitId) => {
+    const manifest = await readJsonFile(manifestPath(kitId));
+    return KitSchema.parse(manifest);
+};
+const renderReadme = (manifest) => {
+    const blockTable = manifest.blocks
+        .map((block) => `- ${block.blockId}@${block.version}`)
+        .join("\n");
+    return `# ${manifest.name}\n\n${manifest.description}\n\n## Blocks\n\n${blockTable}\n\n## Category\n\n- ${manifest.category}\n`;
+};
+const publishKit = async (kitId) => {
+    const manifest = await readManifest(kitId);
+    const registry = await readRegistry();
+    const remainder = registry.kits.filter((kit) => kit.id !== kitId);
+    const updated = {
+        updatedAt: nowISO(),
+        kits: [...remainder, manifest].sort((a, b) => a.id.localeCompare(b.id)),
+    };
+    await saveRegistry(updated);
+    console.log(chalk.green(`✔ Published kit ${manifest.id}@${manifest.version}`));
+};
+export const registerKitCommands = (program) => {
+    const kit = program
+        .command("kit")
+        .description("Scaffold and manage BLKC kits");
+    kit
+        .command("list")
+        .description("List registered kits")
+        .option("--json", "Emit JSON output", false)
+        .action(async (options) => {
+        const registry = await readRegistry();
+        if (registry.kits.length === 0) {
+            console.log(chalk.yellow("No kits registered yet."));
+            return;
+        }
+        if (options.json) {
+            console.log(JSON.stringify(registry.kits, null, 2));
+            return;
+        }
+        registry.kits
+            .sort((a, b) => a.id.localeCompare(b.id))
+            .forEach((item) => {
+            console.log(chalk.cyan(`${item.id}@${item.version}`));
+            console.log(`  name: ${item.name}`);
+            console.log(`  summary: ${item.summary}`);
+            console.log(`  blocks: ${item.blocks.map((block) => block.blockId).join(", ")}`);
+            console.log("");
+        });
+    });
+    kit
+        .command("create")
+        .description("Scaffold a new kit manifest")
+        .argument("<kit-id>", "Kit identifier (lowercase slug)")
+        .option("--name <name>", "Display name")
+        .option("--summary <summary>", "Short summary")
+        .option("--description <description>", "Long-form description")
+        .option("--category <category>", "Business category", "general")
+        .option("--block <block@version>", "Reference a block", collectValues, [])
+        .option("--version <semver>", "Version", "0.1.0")
+        .option("--tag <tag>", "Add a tag", collectValues, [])
+        .option("--maintainer-name <name>", "Maintainer name")
+        .option("--maintainer-email <email>", "Maintainer email")
+        .option("--maintainer-role <role>", "Maintainer role")
+        .option("--documentation <url>", "Documentation URL")
+        .option("--pricing-model <model>", "Pricing model (free|one-time|subscription|usage)")
+        .option("--pricing-amount <amount>", "Pricing amount", parseFloat)
+        .option("--pricing-currency <currency>", "Pricing currency", "USD")
+        .option("--publish", "Publish after creation", false)
+        .option("--force", "Overwrite manifest if it exists", false)
+        .action(async (rawId, options) => {
+        const kitId = IdentifierSchema.parse(rawId);
+        const manifestFile = manifestPath(kitId);
+        const existsAlready = await exists(manifestFile);
+        if (existsAlready && !options.force) {
+            console.error(chalk.red(`✖ Kit ${kitId} already exists. Use --force to overwrite.`));
+            process.exitCode = 1;
+            return;
+        }
+        await ensureDirectory(path.join(KITS_DIR, kitId));
+        const blocks = options.block.map(parseBlockReference);
+        if (blocks.length === 0) {
+            console.warn(chalk.yellow("⚠ No blocks specified. Add them later before publishing."));
+        }
+        const manifestDraft = KitSchema.parse({
+            id: kitId,
+            name: options.name ?? kitId
+                .split("-")
+                .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))
+                .join(" "),
+            summary: options.summary ?? `Summary for ${kitId}.`,
+            description: options.description ?? `Detailed description for kit ${kitId}. Update before publishing.`,
+            category: options.category,
+            version: options.version,
+            tags: options.tag ?? [],
+            blocks,
+            maintainers: options.maintainerName
+                ? [
+                    {
+                        name: options.maintainerName,
+                        email: options.maintainerEmail,
+                        role: options.maintainerRole,
+                    },
+                ]
+                : [],
+            documentation: options.documentation,
+            pricing: options.pricingModel
+                ? {
+                    model: options.pricingModel,
+                    amount: options.pricingAmount,
+                    currency: options.pricingCurrency,
+                }
+                : undefined,
+        });
+        await writeManifest(kitId, manifestDraft);
+        const readmePath = workspacePath(KITS_DIR, kitId, README_FILENAME);
+        await writeFile(readmePath, renderReadme(manifestDraft), { encoding: "utf8" });
+        console.log(chalk.green(`✔ Created kit scaffold at ${path.join(KITS_DIR, kitId)}`));
+        if (options.publish) {
+            await publishKit(kitId);
+        }
+        else {
+            console.log(chalk.gray(`Run 'blkc kit publish ${kitId}' after finalising the manifest.`));
+        }
+    });
+    kit
+        .command("publish")
+        .description("Validate and add a kit to the registry")
+        .argument("<kit-id>", "Kit identifier")
+        .action(async (rawId) => {
+        try {
+            const kitId = IdentifierSchema.parse(rawId);
+            await publishKit(kitId);
+        }
+        catch (error) {
+            console.error(chalk.red(`✖ Failed to publish kit: ${error.message}`));
+            process.exitCode = 1;
+        }
+    });
+};
+//# sourceMappingURL=kit.js.map

package/dist/commands/kit.js.map

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

package/dist/commands/logbook.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const registerLogbookCommands: (program: Command) => void;

package/dist/commands/logbook.js

@@ -0,0 +1,156 @@
+import { readFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import chalk from "chalk";
+import { DEFAULT_ALGORITHM } from "@blkc-code/core";
+import { DEFAULT_LOGBOOK_PATH, Logbook, } from "@blkc-code/logbook";
+const parseJson = (value, source) => {
+    try {
+        return JSON.parse(value);
+    }
+    catch (error) {
+        throw new Error(`Failed to parse JSON from ${source}: ${error.message}`);
+    }
+};
+const parseJsonFile = async (filePath) => {
+    const buffer = await readFile(filePath, { encoding: "utf8" });
+    return parseJson(buffer, filePath);
+};
+const mergeRecords = (records) => records.reduce((acc, record) => ({ ...acc, ...record }), {});
+const cleanRecord = (record) => Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined && value !== null));
+const buildDataPayload = async (options) => {
+    const dataAggregates = [];
+    if (options.data && typeof options.data === "string") {
+        dataAggregates.push(parseJson(options.data, "--data"));
+    }
+    if (options.dataFile && typeof options.dataFile === "string") {
+        const resolved = path.resolve(options.dataFile);
+        dataAggregates.push(await parseJsonFile(resolved));
+    }
+    if (options.message && typeof options.message === "string") {
+        dataAggregates.push({ message: options.message });
+    }
+    if (dataAggregates.length === 0) {
+        return {};
+    }
+    return mergeRecords(dataAggregates);
+};
+const defaultActorName = () => process.env.BLKC_ACTOR_NAME ?? os.userInfo().username;
+const resolveLogbook = (options) => new Logbook({
+    filePath: path.resolve(options.file ?? DEFAULT_LOGBOOK_PATH),
+    algorithm: options.algorithm ?? DEFAULT_ALGORITHM,
+});
+const printVerification = (result) => {
+    if (result.valid) {
+        console.log(chalk.green(`✔ Logbook verified (${result.entries.length} entries)`));
+        if (result.lastHash) {
+            console.log(chalk.dim(`Last hash: ${result.lastHash}`));
+        }
+        return;
+    }
+    console.error(chalk.red("✖ Logbook verification failed"));
+    result.issues.forEach((issue) => {
+        const context = issue.entry ? chalk.dim(` ${JSON.stringify(issue.entry)}`) : "";
+        console.error(chalk.red(`  • [${issue.index + 1}] ${issue.message}${context}`));
+    });
+};
+export const registerLogbookCommands = (program) => {
+    const logbook = program
+        .command("logbook")
+        .description("Inspect and update the BLKC logbook")
+        .option("-f, --file <path>", "Path to logbook JSONL file", DEFAULT_LOGBOOK_PATH)
+        .option("-a, --algorithm <hash>", "Hash algorithm", DEFAULT_ALGORITHM);
+    logbook
+        .command("append")
+        .description("Append a new entry to the logbook")
+        .requiredOption("-e, --event <event>", "Event identifier")
+        .option("-m, --message <message>", "Optional message stored under data.message")
+        .option("-d, --data <json>", "JSON payload merged into entry data")
+        .option("--data-file <path>", "Path to JSON file merged into entry data")
+        .option("--actor-name <name>", "Actor display name")
+        .option("--actor-email <email>", "Actor email")
+        .option("--actor-role <role>", "Actor role")
+        .option("--timestamp <iso>", "Override timestamp (ISO-8601)")
+        .action(async (options, command) => {
+        const parentOpts = (command.parent?.opts() ?? {});
+        const logbookInstance = resolveLogbook(parentOpts);
+        const data = await buildDataPayload(options);
+        const actor = cleanRecord({
+            name: options.actorName ?? defaultActorName(),
+            email: options.actorEmail,
+            role: options.actorRole,
+        });
+        const entry = {
+            event: options.event,
+            actor: actor,
+            data,
+            timestamp: options.timestamp,
+        };
+        try {
+            const appended = await logbookInstance.append(entry);
+            console.log(chalk.green(`✔ Appended ${appended.event}`));
+            console.log(chalk.dim(`Hash: ${appended.hash}`));
+        }
+        catch (error) {
+            console.error(chalk.red(`✖ Failed to append entry: ${error.message}`));
+            process.exitCode = 1;
+        }
+    });
+    logbook
+        .command("verify")
+        .description("Verify integrity of the logbook hash chain")
+        .action(async (_options, command) => {
+        const parentOpts = (command.parent?.opts() ?? {});
+        const logbookInstance = resolveLogbook(parentOpts);
+        try {
+            const result = await logbookInstance.verify();
+            printVerification(result);
+            if (!result.valid) {
+                process.exitCode = 1;
+            }
+        }
+        catch (error) {
+            console.error(chalk.red(`✖ Verification failed: ${error.message}`));
+            process.exitCode = 1;
+        }
+    });
+    logbook
+        .command("show")
+        .description("Display logbook entries")
+        .option("-l, --limit <count>", "Limit number of entries returned", (value) => parseInt(value, 10))
+        .option("--json", "Output as JSON", false)
+        .action(async (options, command) => {
+        const parentOpts = (command.parent?.opts() ?? {});
+        const logbookInstance = resolveLogbook(parentOpts);
+        try {
+            const entries = await logbookInstance.entries();
+            const limit = typeof options.limit === "number" && !Number.isNaN(options.limit)
+                ? options.limit
+                : entries.length;
+            const subset = entries.slice(Math.max(0, entries.length - limit));
+            if (options.json) {
+                console.log(JSON.stringify(subset, null, 2));
+                return;
+            }
+            subset.forEach((entry, index) => {
+                const idx = entries.length - subset.length + index + 1;
+                console.log(chalk.cyan(`#${idx} ${entry.event}`));
+                console.log(`  actor: ${entry.actor.name}${entry.actor.role ? ` (${entry.actor.role})` : ""}`);
+                console.log(`  timestamp: ${entry.timestamp}`);
+                console.log(`  hash: ${entry.hash}`);
+                if (entry.prevHash) {
+                    console.log(`  prevHash: ${entry.prevHash}`);
+                }
+                if (entry.data && Object.keys(entry.data).length > 0) {
+                    console.log(`  data: ${JSON.stringify(entry.data)}`);
+                }
+                console.log("");
+            });
+        }
+        catch (error) {
+            console.error(chalk.red(`✖ Failed to read logbook: ${error.message}`));
+            process.exitCode = 1;
+        }
+    });
+};
+//# sourceMappingURL=logbook.js.map

package/dist/commands/logbook.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env bun
+import { Command } from "commander";
+export declare const program: Command;
+export declare const run: () => Promise<void>;

package/dist/index.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env bun
+import { realpathSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { Command } from "commander";
+import { registerBlockCommands } from "./commands/block";
+import { registerCircuitCommands } from "./commands/circuit";
+import { registerKitCommands } from "./commands/kit";
+import { registerLogbookCommands } from "./commands/logbook";
+export const program = new Command();
+program
+    .name("blkc")
+    .description("BLKC developer CLI")
+    .version("0.1.0");
+program.showHelpAfterError();
+program.configureOutput({
+    outputError: (str) => {
+        // eslint-disable-next-line no-console
+        console.error(str.trim());
+    },
+});
+registerBlockCommands(program);
+registerCircuitCommands(program);
+registerKitCommands(program);
+registerLogbookCommands(program);
+const isDirectExecution = () => {
+    const entryPoint = process.argv[1];
+    if (!entryPoint) {
+        return false;
+    }
+    // npm/bun install the bin as a symlink, so compare real paths.
+    const resolve = (file) => {
+        try {
+            return realpathSync(file);
+        }
+        catch {
+            return path.resolve(file);
+        }
+    };
+    return resolve(fileURLToPath(import.meta.url)) === resolve(entryPoint);
+};
+export const run = async () => {
+    await program.parseAsync(process.argv);
+};
+if (isDirectExecution()) {
+    run().catch((error) => {
+        // eslint-disable-next-line no-console
+        console.error(error instanceof Error ? error.message : error);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAErC,OAAO;KACJ,IAAI,CAAC,MAAM,CAAC;KACZ,WAAW,CAAC,oBAAoB,CAAC;KACjC,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO,CAAC,kBAAkB,EAAE,CAAC;AAC7B,OAAO,CAAC,eAAe,CAAC;IACtB,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE;QACnB,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5B,CAAC;CACF,CAAC,CAAC;AAEH,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAEjC,MAAM,iBAAiB,GAAG,GAAG,EAAE;IAC7B,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+DAA+D;IAC/D,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE;QAC/B,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC;IACF,OAAO,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AACzE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,IAAI,EAAE;IAC5B,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC,CAAC;AAEF,IAAI,iBAAiB,EAAE,EAAE,CAAC;IACxB,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACpB,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/filesystem.d.ts

@@ -0,0 +1,5 @@
+export declare const workspacePath: (...segments: string[]) => string;
+export declare const ensureDirectory: (relativePath: string) => Promise<void>;
+export declare const readJsonFile: <T>(relativePath: string) => Promise<T>;
+export declare const writeJsonFile: (relativePath: string, payload: unknown) => Promise<void>;
+export declare const exists: (relativePath: string) => Promise<boolean>;

package/dist/utils/filesystem.js

@@ -0,0 +1,21 @@
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { ensureDir, pathExists } from "fs-extra";
+export const workspacePath = (...segments) => path.resolve(process.cwd(), ...segments);
+export const ensureDirectory = async (relativePath) => {
+    await ensureDir(workspacePath(relativePath));
+};
+export const readJsonFile = async (relativePath) => {
+    const filePath = workspacePath(relativePath);
+    const contents = await readFile(filePath, { encoding: "utf8" });
+    // Some manifests were written by PowerShell with a UTF-8 BOM, which JSON.parse rejects.
+    return JSON.parse(contents.replace(/^\uFEFF/, ""));
+};
+export const writeJsonFile = async (relativePath, payload) => {
+    const filePath = workspacePath(relativePath);
+    await ensureDir(path.dirname(filePath));
+    const formatted = `${JSON.stringify(payload, null, 2)}\n`;
+    await writeFile(filePath, formatted, { encoding: "utf8" });
+};
+export const exists = async (relativePath) => pathExists(workspacePath(relativePath));
+//# sourceMappingURL=filesystem.js.map

package/dist/utils/filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../../src/utils/filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAG,QAAkB,EAAE,EAAE,CACrD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,YAAoB,EAAE,EAAE;IAC5D,MAAM,SAAS,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAK,YAAoB,EAAc,EAAE;IACxE,MAAM,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAChE,wFAAwF;IACxF,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAM,CAAC;AAC1D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,YAAoB,EAAE,OAAgB,EAAE,EAAE;IAC5E,MAAM,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IAC1D,MAAM,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;AAC7D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,EAAE,YAAoB,EAAE,EAAE,CACnD,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC"}