@blkc-code/cli 0.0.0-stage → 0.1.0

package/dist/commands/block.d.ts

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

package/dist/commands/block.js

@@ -0,0 +1,284 @@
+import { writeFile } from "node:fs/promises";
+import path from "node:path";
+import chalk from "chalk";
+import { BlockRegistrySchema, BlockSchema, CapabilityBlockSchema, IdentifierSchema, nowISO, } from "@blkc-code/core";
+import { ensureDirectory, exists, readJsonFile, workspacePath, writeJsonFile, } from "../utils/filesystem";
+const BLOCKS_DIR = "blocks";
+const BLOCK_REGISTRY_PATH = "registry/blocks.json";
+const MANIFEST_FILENAME = "manifest.json";
+const README_FILENAME = "README.md";
+const ENTRYPOINT_PATH = "./src/index.ts";
+const collectValues = (value, previous) => [...previous, value];
+const defaultBlockName = (id) => id
+    .split("-")
+    .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))
+    .join(" ");
+const readRegistry = async () => {
+    try {
+        const registry = await readJsonFile(BLOCK_REGISTRY_PATH);
+        return BlockRegistrySchema.parse(registry);
+    }
+    catch (error) {
+        console.warn(chalk.yellow("⚠ Block registry not found, creating a new one."));
+        return { updatedAt: nowISO(), blocks: [] };
+    }
+};
+const saveRegistry = async (registry) => {
+    await writeJsonFile(BLOCK_REGISTRY_PATH, {
+        ...registry,
+        updatedAt: nowISO(),
+    });
+};
+const manifestPath = (blockId) => path.join(BLOCKS_DIR, blockId, MANIFEST_FILENAME);
+const ensureBlockScaffold = async (blockId) => {
+    await ensureDirectory(path.join(BLOCKS_DIR, blockId, "src"));
+};
+const writeManifest = async (blockId, manifest) => {
+    await writeJsonFile(manifestPath(blockId), manifest);
+};
+const readManifest = async (blockId) => {
+    const manifest = await readJsonFile(manifestPath(blockId));
+    return BlockSchema.parse(manifest);
+};
+const renderReadme = (manifest) => `# ${manifest.name}
+
+
+
+${manifest.description}
+
+
+
+## Summary
+
+
+
+- ID: ${manifest.id}
+
+- Version: ${manifest.version}
+
+- Runtime: ${manifest.runtime}
+
+- Entry point: ${manifest.entryPoint}
+
+
+
+## Getting Started
+
+
+
+Update ${manifest.entryPoint} with your implementation and document usage notes here.
+
+`;
+const renderStub = (manifest) => {
+    const identifier = manifest.name.replace(/[^a-zA-Z0-9]/g, '') || defaultBlockName(manifest.id).replace(/[^a-zA-Z0-9]/g, '');
+    const normalized = identifier.charAt(0).toUpperCase() + identifier.slice(1);
+    return `export type ${normalized}Input = {
+
+  text: string;
+
+};
+
+
+
+export type ${normalized}Output = {
+
+  ok: boolean;
+
+};
+
+
+
+export const run = async (_input: ${normalized}Input): Promise<${normalized}Output> => {
+
+  return { ok: true };
+
+};
+
+`;
+};
+const buildAuthors = (options) => {
+    if (!options.authorName) {
+        return [];
+    }
+    return [
+        {
+            name: options.authorName,
+            email: options.authorEmail,
+            role: options.authorRole,
+            github: options.authorGithub,
+        },
+    ];
+};
+const validateBlock = async (blockId) => {
+    const manifest = await readManifest(blockId);
+    if (manifest.id !== blockId) {
+        throw new Error(`Manifest id "${manifest.id}" does not match directory "${blockId}"`);
+    }
+    if (manifest.kind === "capability") {
+        const entry = path.join(BLOCKS_DIR, blockId, manifest.entryPoint);
+        if (!(await exists(entry))) {
+            throw new Error(`Entry point ${manifest.entryPoint} not found for ${blockId}`);
+        }
+    }
+    return manifest;
+};
+const describeBlock = (manifest) => manifest.kind === "ui"
+    ? `ui, ${manifest.controls.length} controls, renderers: ${Object.keys(manifest.renderers).join(", ")}`
+    : `capability, ${manifest.runtime}`;
+const publishBlock = async (blockId, options = {}) => {
+    const manifest = await validateBlock(blockId);
+    if (options.dryRun) {
+        console.log(chalk.green(`✔ Valid block ${manifest.id}@${manifest.version} (${describeBlock(manifest)})`));
+        return;
+    }
+    const registry = await readRegistry();
+    const remainder = registry.blocks.filter((block) => block.id !== blockId);
+    const updated = {
+        updatedAt: nowISO(),
+        blocks: [...remainder, manifest].sort((a, b) => a.id.localeCompare(b.id)),
+    };
+    await saveRegistry(updated);
+    console.log(chalk.green(`✔ Published block ${manifest.id}@${manifest.version}`));
+};
+export const registerBlockCommands = (program) => {
+    const block = program
+        .command("block")
+        .description("Scaffold and manage BLKC blocks");
+    block
+        .command("list")
+        .description("List registered blocks")
+        .option("--json", "Emit JSON output", false)
+        .action(async (options) => {
+        const registry = await readRegistry();
+        if (registry.blocks.length === 0) {
+            console.log(chalk.yellow("No blocks registered yet."));
+            return;
+        }
+        if (options.json) {
+            console.log(JSON.stringify(registry.blocks, null, 2));
+            return;
+        }
+        registry.blocks
+            .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}`);
+            if (item.tags?.length) {
+                console.log(`  tags: ${item.tags.join(", ")}`);
+            }
+            console.log("");
+        });
+    });
+    block
+        .command("create")
+        .description("Scaffold a new block directory with a manifest")
+        .argument("<block-id>", "Block identifier (lowercase slug)")
+        .option("--name <name>", "Display name for the block")
+        .option("--summary <summary>", "Short summary for marketplace listings")
+        .option("--description <description>", "Long-form description")
+        .option("--version <semver>", "Initial semantic version", "0.1.0")
+        .option("--runtime <runtime>", "Runtime (bun|node|python|docker)", "bun")
+        .option("--tag <tag>", "Add a tag", collectValues, [])
+        .option("--size <mb>", "Approximate size in MB")
+        .option("--author-name <name>", "Author name")
+        .option("--author-email <email>", "Author email")
+        .option("--author-role <role>", "Author role")
+        .option("--author-github <handle>", "Author GitHub handle")
+        .option("--publish", "Publish to registry after creation", false)
+        .option("--force", "Overwrite existing manifest", false)
+        .action(async (rawId, options) => {
+        const blockId = IdentifierSchema.parse(rawId);
+        const manifestFile = manifestPath(blockId);
+        const existsAlready = await exists(manifestFile);
+        if (existsAlready && !options.force) {
+            console.error(chalk.red(`✖ Block ${blockId} already exists. Use --force to overwrite.`));
+            process.exitCode = 1;
+            return;
+        }
+        await ensureBlockScaffold(blockId);
+        const manifestDraft = CapabilityBlockSchema.parse({
+            kind: "capability",
+            id: blockId,
+            name: options.name ?? defaultBlockName(blockId),
+            summary: options.summary ?? `Summary for ${blockId}.`,
+            description: options.description ?? `Detailed description for block ${blockId}. Update before publishing.`,
+            version: options.version,
+            entryPoint: ENTRYPOINT_PATH,
+            runtime: options.runtime,
+            tags: options.tag ?? [],
+            sizeMB: options.size ? Number(options.size) : undefined,
+            authors: buildAuthors(options),
+        });
+        await writeManifest(blockId, manifestDraft);
+        const readmePath = workspacePath(BLOCKS_DIR, blockId, README_FILENAME);
+        const entryPath = workspacePath(BLOCKS_DIR, blockId, "src", "index.ts");
+        await writeFile(readmePath, renderReadme(manifestDraft), { encoding: "utf8" });
+        await writeFile(entryPath, renderStub(manifestDraft), { encoding: "utf8" });
+        console.log(chalk.green(`✔ Created block scaffold at ${path.join(BLOCKS_DIR, blockId)}`));
+        if (options.publish) {
+            await publishBlock(blockId);
+        }
+        else {
+            console.log(chalk.gray(`Run 'blkc block publish ${blockId}' after editing the manifest.`));
+        }
+    });
+    block
+        .command("publish")
+        .description("Validate and add a block manifest to the registry")
+        .argument("<block-id>", "Block identifier to publish")
+        .option("--github-org <org>", "Create a GitHub repo under this org")
+        .option("--github-private", "Create as a private repo", false)
+        .option("--dry-run", "Validate the manifest without writing the registry", false)
+        .action(async (rawId, options) => {
+        try {
+            const blockId = IdentifierSchema.parse(rawId);
+            await publishBlock(blockId, { dryRun: options.dryRun });
+            if (options.dryRun) {
+                return;
+            }
+            const token = process.env.GITHUB_TOKEN;
+            if (options.githubOrg || token) {
+                // lazy require to avoid load-time dependency
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const github = require("../utils/github");
+                const manifest = await readManifest(blockId);
+                const repoName = manifest.id;
+                const result = await github.ensureGithubRepo({
+                    org: options.githubOrg,
+                    name: repoName,
+                    description: manifest.summary ?? manifest.description,
+                    private: !!options.githubPrivate,
+                    token,
+                });
+                if (result.created) {
+                    console.log(chalk.green(`✔ GitHub repo created: ${result.repo}`));
+                }
+                else {
+                    console.log(chalk.yellow(`⚠ GitHub repo not created: ${result.message}`));
+                    if (result.details) {
+                        console.log(JSON.stringify(result.details, null, 2));
+                    }
+                }
+                console.log("\nNext steps to push your block to GitHub:");
+                console.log(`  cd ${BLOCKS_DIR}/${blockId}`);
+                console.log("  git init");
+                console.log("  git add .");
+                console.log("  git commit -m \"chore: initial block scaffold\"");
+                if (result.repo) {
+                    console.log(`  git remote add origin ${result.repo.replace(/\.git$/, '')}.git`);
+                    console.log("  git branch -M main");
+                    console.log("  git push -u origin main");
+                }
+                else {
+                    console.log("  # Create a repository on GitHub and add it as 'origin' then push");
+                }
+            }
+        }
+        catch (error) {
+            console.error(chalk.red(`✖ Failed to publish block: ${error.message}`));
+            process.exitCode = 1;
+        }
+    });
+};
+//# sourceMappingURL=block.js.map

package/dist/commands/block.js.map

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

package/dist/commands/circuit.d.ts

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

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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAGL,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,MAAM,GACP,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,eAAe,EACf,MAAM,EACN,YAAY,EACZ,aAAa,EACb,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,MAAM,YAAY,GAAG,UAAU,CAAC;AAChC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC;AACvD,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAC1C,MAAM,eAAe,GAAG,WAAW,CAAC;AAEpC,MAAM,aAAa,GAAG,CAAC,KAAa,EAAE,QAAkB,EAAE,EAAE,CAAC,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC;AAElF,MAAM,iBAAiB,GAAG,CAAC,KAAa,EAAE,EAAE;IAC1C,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,KAAK,IAA8B,EAAE;IACxD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAkB,qBAAqB,CAAC,CAAC;QAC5E,OAAO,qBAAqB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,mDAAmD,CAAC,CAAC,CAAC;QAChF,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC/C,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,KAAK,EAAE,QAAyB,EAAE,EAAE;IACvD,MAAM,aAAa,CAAC,qBAAqB,EAAE;QACzC,GAAG,QAAQ;QACX,SAAS,EAAE,MAAM,EAAE;KACpB,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,SAAiB,EAAE,EAAE,CACzC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;AAExD,MAAM,aAAa,GAAG,KAAK,EAAE,SAAiB,EAAE,QAAyB,EAAE,EAAE;IAC3E,MAAM,aAAa,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,KAAK,EAAE,SAAiB,EAAE,EAAE;IAC/C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAkB,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9E,OAAO,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,QAAyB,EAAE,EAAE;IACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpF,OAAO,KAAK,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,WAAW,kBAAkB,IAAI,uBAAuB,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC;AAClJ,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,KAAK,EAAE,SAAiB,EAAE,EAAE;IACjD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;IAClF,MAAM,OAAO,GAAoB;QAC/B,SAAS,EAAE,MAAM,EAAE;QACnB,QAAQ,EAAE,CAAC,GAAG,SAAS,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;KAC5E,CAAC;IAEF,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,uBAAuB,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACrF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,OAAgB,EAAE,EAAE;IAC1D,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAEvC,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,0BAA0B,CAAC;SACvC,MAAM,CAAC,QAAQ,EAAE,kBAAkB,EAAE,KAAK,CAAC;SAC3C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;QACtC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,6BAA6B,CAAC,CAAC,CAAC;YACzD,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACxD,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,QAAQ;aACd,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;aACxC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,6BAA6B,CAAC;SAC1C,QAAQ,CAAC,cAAc,EAAE,qCAAqC,CAAC;SAC/D,MAAM,CAAC,eAAe,EAAE,cAAc,CAAC;SACvC,MAAM,CAAC,qBAAqB,EAAE,eAAe,CAAC;SAC9C,MAAM,CAAC,6BAA6B,EAAE,uBAAuB,CAAC;SAC9D,MAAM,CAAC,oBAAoB,EAAE,SAAS,EAAE,OAAO,CAAC;SAChD,MAAM,CAAC,uBAAuB,EAAE,iBAAiB,EAAE,aAAa,EAAE,EAAE,CAAC;SACrE,MAAM,CAAC,qBAAqB,EAAE,iBAAiB,EAAE,aAAa,EAAE,EAAE,CAAC;SACnE,MAAM,CAAC,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,EAAE,CAAC;SACrD,MAAM,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,OAAO,CAAC;SACtD,MAAM,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;SACpD,MAAM,CAAC,0BAA0B,EAAE,iBAAiB,CAAC;SACrD,MAAM,CAAC,4BAA4B,EAAE,kBAAkB,CAAC;SACxD,MAAM,CAAC,0BAA0B,EAAE,iBAAiB,CAAC;SACrD,MAAM,CAAC,WAAW,EAAE,wBAAwB,EAAE,KAAK,CAAC;SACpD,MAAM,CAAC,SAAS,EAAE,iCAAiC,EAAE,KAAK,CAAC;SAC3D,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,OAAO,EAAE,EAAE;QACvC,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,YAAY,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QAC7C,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAEjD,IAAI,aAAa,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACpC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,SAAS,4CAA4C,CAAC,CAAC,CAAC;YAC7F,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC;QAE1D,MAAM,IAAI,GAAI,OAAO,CAAC,GAAgB,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC9D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,wDAAwD,CAAC,CAAC,CAAC;QACvF,CAAC;QAED,MAAM,aAAa,GAAoB,aAAa,CAAC,KAAK,CAAC;YACzD,EAAE,EAAE,SAAS;YACb,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,SAAS;iBAC5B,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;iBAC5E,IAAI,CAAC,GAAG,CAAC;YACZ,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,eAAe,SAAS,GAAG;YACvD,WAAW,EACT,OAAO,CAAC,WAAW,IAAI,oCAAoC,SAAS,6BAA6B;YACnG,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;YACjC,IAAI,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE;YACvB,IAAI;YACJ,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,WAAW,EAAE,OAAO,CAAC,cAAc;gBACjC,CAAC,CAAC;oBACE;wBACE,IAAI,EAAE,OAAO,CAAC,cAAwB;wBACtC,KAAK,EAAE,OAAO,CAAC,eAAqC;wBACpD,IAAI,EAAE,OAAO,CAAC,cAAoC;qBACnD;iBACF;gBACH,CAAC,CAAC,EAAE;SACP,CAAC,CAAC;QAEH,MAAM,aAAa,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAE9C,MAAM,UAAU,GAAG,aAAa,CAAC,YAAY,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;QAC3E,MAAM,SAAS,CAAC,UAAU,EAAE,YAAY,CAAC,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAE/E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,iCAAiC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QAEhG,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,6BAA6B,SAAS,kCAAkC,CAAC,CAAC,CAAC;QACpG,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,4CAA4C,CAAC;SACzD,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;SAC9C,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,EAAE;QAC9B,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAChD,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,gCAAiC,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACrF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC,CAAC"}

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,44 @@
+#!/usr/bin/env bun
+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;
+    }
+    const modulePath = path.normalize(fileURLToPath(import.meta.url));
+    const entryPath = path.normalize(entryPoint);
+    return modulePath === entryPath;
+};
+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,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,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC7C,OAAO,UAAU,KAAK,SAAS,CAAC;AAClC,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"}

package/dist/utils/github.d.ts

@@ -0,0 +1,23 @@
+export type CreateRepoOptions = {
+    org?: string;
+    name: string;
+    description?: string;
+    private?: boolean;
+    token?: string;
+};
+export declare const ensureGithubRepo: (opts: CreateRepoOptions) => Promise<{
+    created: boolean;
+    message: string;
+    repo?: undefined;
+    details?: undefined;
+} | {
+    created: boolean;
+    message: string;
+    repo: any;
+    details?: undefined;
+} | {
+    created: boolean;
+    message: any;
+    details: any;
+    repo?: undefined;
+}>;

package/dist/utils/github.js

@@ -0,0 +1,66 @@
+import https from "node:https";
+import { URL } from "node:url";
+const requestJson = (url, token, body) => new Promise((resolve, reject) => {
+    try {
+        const u = new URL(url);
+        const data = JSON.stringify(body);
+        const headers = {
+            Authorization: token ? `token ${token}` : "",
+            "Content-Type": "application/json",
+            Accept: "application/vnd.github+json",
+            "User-Agent": "blkc-cli",
+            "Content-Length": Buffer.byteLength(data).toString(),
+        };
+        const opts = {
+            method: "POST",
+            hostname: u.hostname,
+            path: u.pathname + (u.search ?? ""),
+            headers,
+        };
+        const req = https.request(opts, (res) => {
+            let raw = "";
+            res.setEncoding("utf8");
+            res.on("data", (chunk) => (raw += chunk));
+            res.on("end", () => {
+                try {
+                    const parsed = raw ? JSON.parse(raw) : {};
+                    resolve({ statusCode: res.statusCode, body: parsed });
+                }
+                catch (err) {
+                    reject(err);
+                }
+            });
+        });
+        req.on("error", (err) => reject(err));
+        req.write(data);
+        req.end();
+    }
+    catch (error) {
+        reject(error);
+    }
+});
+export const ensureGithubRepo = async (opts) => {
+    if (!opts.token) {
+        return { created: false, message: "No GITHUB_TOKEN provided; skipping GitHub repo creation." };
+    }
+    const url = opts.org
+        ? `https://api.github.com/orgs/${opts.org}/repos`
+        : `https://api.github.com/user/repos`;
+    const body = {
+        name: opts.name,
+        description: opts.description ?? "",
+        private: !!opts.private,
+        auto_init: true,
+    };
+    try {
+        const res = await requestJson(url, opts.token, body);
+        if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+            return { created: true, message: "Repository created", repo: res.body.html_url };
+        }
+        return { created: false, message: res.body?.message || "Failed to create repo", details: res.body };
+    }
+    catch (error) {
+        return { created: false, message: error.message };
+    }
+};
+//# sourceMappingURL=github.js.map

package/dist/utils/github.js.map

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

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "@blkc-code/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "blkc": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rimraf dist",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "lint": "eslint \"src/**/*.{ts,tsx}\"",
+    "test": "vitest"
+  },
+  "dependencies": {
+    "@blkc-code/core": "0.1.0",
+    "@blkc-code/logbook": "0.1.0",
+    "@commander-js/extra-typings": "^12.1.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^12.3.0",
+    "ora": "^8.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.9",
+    "@typescript-eslint/eslint-plugin": "^8.44.0",
+    "@typescript-eslint/parser": "^8.44.0",
+    "eslint": "^9.16.0",
+    "eslint-config-prettier": "^10.1.1",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.4"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.