@blkc-code/cli 0.1.3 → 0.3.0

package/src/commands/kit.ts

@@ -1,173 +0,0 @@
-/**
- * BLKC CLI - Kit Commands
- * 
- * Commands for working with BLKC Kits.
- * 
- * @package @blkc-code/cli
- * @license Apache-2.0
- * @author Black Code Enterprises LLC
- */
-
-import { Command } from "commander";
-import chalk from "chalk";
-import ora from "ora";
-import { readFile } from "node:fs/promises";
-import path from "node:path";
-import { KitSchema } from "@blkc-code/core";
-
-// ============================================================================
-// Command: kit validate
-// ============================================================================
-
-function setupValidateCommand(program: Command): void {
-  program
-    .command("validate <manifest-path>")
-    .description("Validate a Kit manifest")
-    .action(async (manifestPath: string) => {
-      const spinner = ora("Validating Kit manifest...").start();
-      
-      try {
-        const absolutePath = path.resolve(process.cwd(), manifestPath);
-        const content = await readFile(absolutePath, { encoding: "utf8" });
-        const manifest = JSON.parse(content);
-        
-        const result = KitSchema.safeParse(manifest);
-        
-        if (!result.success) {
-          spinner.fail("Validation failed");
-          console.error(chalk.red("\nValidation errors:"));
-          for (const issue of result.error.issues) {
-            console.error(`  - ${chalk.red(issue.path.join("."))}: ${issue.message}`);
-          }
-          process.exit(1);
-        }
-        
-        spinner.succeed("Kit manifest is valid");
-        const kit = result.data;
-        console.log(chalk.gray(`\nKit ID: ${kit.id}`));
-        console.log(chalk.gray(`Name: ${kit.name}`));
-        console.log(chalk.gray(`Blocks: ${kit.blocks.length}`));
-      } catch (error) {
-        spinner.fail(`Failed to validate: ${error}`);
-        process.exit(1);
-      }
-    });
-}
-
-// ============================================================================
-// Command: kit info
-// ============================================================================
-
-function setupInfoCommand(program: Command): void {
-  program
-    .command("info <manifest-path>")
-    .description("Show detailed information about a Kit")
-    .action(async (manifestPath: string) => {
-      const spinner = ora("Loading Kit info...").start();
-      
-      try {
-        const absolutePath = path.resolve(process.cwd(), manifestPath);
-        const content = await readFile(absolutePath, { encoding: "utf8" });
-        const manifest = JSON.parse(content);
-        
-        const result = KitSchema.safeParse(manifest);
-        if (!result.success) {
-          spinner.fail("Invalid Kit manifest");
-          process.exit(1);
-        }
-        
-        const kit = result.data;
-        spinner.succeed(`Kit: ${kit.id}`);
-        
-        console.log(chalk.bold("\nKit Information"));
-        console.log(chalk.gray("─".repeat(40)));
-        console.log(chalk.gray(`ID:        ${kit.id}`));
-        console.log(chalk.gray(`Name:      ${kit.name}`));
-        console.log(chalk.gray(`Summary:   ${kit.summary}`));
-        console.log(chalk.gray(`Version:   ${kit.version}`));
-        console.log(chalk.gray(`Category:  ${kit.category}`));
-        console.log(chalk.gray(`License:   ${kit.license}`));
-        console.log(chalk.gray(`Visibility: ${kit.visibility}`));
-        
-        if (kit.tags.length > 0) {
-          console.log(chalk.gray(`Tags:      ${kit.tags.join(", ")}`));
-        }
-        
-        console.log(chalk.bold("\nBlocks"));
-        console.log(chalk.gray("─".repeat(40)));
-        for (const blockRef of kit.blocks) {
-          console.log(chalk.gray(`  - ${blockRef.blockId}@${blockRef.version}${blockRef.alias ? ` (as ${blockRef.alias})` : ''}`));
-        }
-        
-        if (kit.theme) {
-          console.log(chalk.bold("\nTheme"));
-          console.log(chalk.gray("─".repeat(40)));
-          console.log(chalk.gray(`  Version: ${kit.theme.version}`));
-        }
-        
-        if (kit.content && kit.content.pages.length > 0) {
-          console.log(chalk.bold("\nContent"));
-          console.log(chalk.gray("─".repeat(40)));
-          console.log(chalk.gray(`  Pages: ${kit.content.pages.length}`));
-          for (const page of kit.content.pages) {
-            console.log(chalk.gray(`    - ${page.slug || "(home)"}: ${page.title} (${page.blocks.length} blocks)`));
-          }
-        }
-        
-        if (kit.repository) {
-          console.log(chalk.bold("\nRepository"));
-          console.log(chalk.gray("─".repeat(40)));
-          console.log(chalk.gray(kit.repository));
-        }
-      } catch (error) {
-        spinner.fail(`Failed to show info: ${error}`);
-        process.exit(1);
-      }
-    });
-}
-
-// ============================================================================
-// Command: kit publish
-// ============================================================================
-
-function setupPublishCommand(program: Command): void {
-  program
-    .command("publish")
-    .description("Publish a Kit to registry (simulated)")
-    .option("--dry-run", "Simulate publish without actually publishing")
-    .action(async (options) => {
-      const { dryRun } = options;
-      const spinner = ora(dryRun ? "Simulating publish..." : "Publishing Kit...").start();
-      
-      try {
-        // Simulate publish
-        await new Promise((resolve) => setTimeout(resolve, 1000));
-        
-        if (dryRun) {
-          spinner.succeed("Dry run: Kit would be published");
-        } else {
-          spinner.succeed("Kit published successfully");
-          console.log(chalk.gray("\nNote: Actual publishing requires registry authentication."));
-        }
-      } catch (error) {
-        spinner.fail(`Failed to publish: ${error}`);
-        process.exit(1);
-      }
-    });
-}
-
-// ============================================================================
-// Register Commands
-// ============================================================================
-
-/** Register all kit commands with the program */
-export function registerKitCommands(program: Command): void {
-  const kitProgram = program
-    .command("kit")
-    .description("Kit commands")
-    .alias("k");
-
-  setupValidateCommand(kitProgram);
-  setupInfoCommand(kitProgram);
-  setupPublishCommand(kitProgram);
-}

package/src/commands/logbook.ts

@@ -1,194 +0,0 @@
-/**
- * BLKC CLI - Logbook Commands
- * 
- * Commands for working with BLKC Logbook.
- * 
- * @package @blkc-code/cli
- * @license Apache-2.0
- * @author Black Code Enterprises LLC
- */
-
-import { Command } from "commander";
-import chalk from "chalk";
-import ora from "ora";
-import { stat } from "node:fs/promises";
-import path from "node:path";
-import { Logbook, verifyLogbook, readLogbook, LogbookVerificationResult } from "@blkc-code/logbook";
-
-// ============================================================================
-// Command: logbook verify
-// ============================================================================
-
-function setupVerifyCommand(program: Command): void {
-  program
-    .command("verify <file-path>")
-    .description("Verify Logbook chain integrity")
-    .option("--algorithm <algo>", "Hash algorithm", "sha256")
-    .action(async (filePath: string, options: { algorithm: string }) => {
-      const spinner = ora("Verifying Logbook...").start();
-      
-      try {
-        const absolutePath = path.resolve(process.cwd(), filePath);
-        
-        // Check if file exists
-        try {
-          await stat(absolutePath);
-        } catch {
-          spinner.fail(`File not found: ${absolutePath}`);
-          process.exit(1);
-        }
-        
-        const result: LogbookVerificationResult = await verifyLogbook(absolutePath, options.algorithm);
-        
-        if (result.valid) {
-          spinner.succeed("Logbook verification passed");
-          console.log(chalk.green("\n✓ Chain is valid"));
-          console.log(chalk.gray(`  Entries: ${result.entries.length}`));
-          console.log(chalk.gray(`  Last hash: ${result.lastHash?.substring(0, 16)}...`));
-        } else {
-          spinner.fail("Logbook verification failed");
-          console.error(chalk.red("\n✗ Chain is invalid"));
-          console.error(chalk.red(`  Issues: ${result.issues.length}`));
-          
-          for (const issue of result.issues) {
-            console.error(chalk.red(`\n  Entry ${issue.index}:`));
-            console.error(chalk.red(`    ${issue.message}`));
-          }
-          
-          process.exit(1);
-        }
-      } catch (error) {
-        spinner.fail(`Failed to verify: ${error}`);
-        process.exit(1);
-      }
-    });
-}
-
-// ============================================================================
-// Command: logbook check
-// ============================================================================
-
-function setupCheckCommand(program: Command): void {
-  program
-    .command("check <file-path>")
-    .description("Check Logbook for issues (alias for verify)")
-    .action(async (filePath: string) => {
-      // Delegate to verify
-      const verifyCmd = program.commands.find((c) => c.name() === "verify");
-      if (verifyCmd) {
-        await (verifyCmd.action as unknown as (filePath: string, options: Record<string, unknown>) => Promise<void>)(filePath, {});
-      }
-    });
-}
-
-// ============================================================================
-// Command: logbook info
-// ============================================================================
-
-function setupInfoCommand(program: Command): void {
-  program
-    .command("info <file-path>")
-    .description("Show Logbook information")
-    .action(async (filePath: string) => {
-      const spinner = ora("Loading Logbook info...").start();
-      
-      try {
-        const absolutePath = path.resolve(process.cwd(), filePath);
-        
-        // Check if file exists
-        try {
-          await stat(absolutePath);
-        } catch {
-          spinner.fail(`File not found: ${absolutePath}`);
-          process.exit(1);
-        }
-        
-        const logbook = new Logbook({ filePath: absolutePath });
-        const info = await logbook.info();
-        
-        spinner.succeed(`Logbook: ${info.filePath}`);
-        
-        console.log(chalk.bold("\nLogbook Information"));
-        console.log(chalk.gray("─".repeat(40)));
-        console.log(chalk.gray(`File:          ${info.filePath}`));
-        console.log(chalk.gray(`Entry count:   ${info.entryCount}`));
-        
-        if (info.firstEntry) {
-          console.log(chalk.gray(`\nFirst Entry:`));
-          console.log(chalk.gray(`  Timestamp:    ${info.firstEntry.timestamp}`));
-          console.log(chalk.gray(`  Actor:        ${info.firstEntry.actor.name}`));
-          console.log(chalk.gray(`  Event:        ${info.firstEntry.event}`));
-        }
-        
-        if (info.lastEntry) {
-          console.log(chalk.gray(`\nLast Entry:`));
-          console.log(chalk.gray(`  Timestamp:    ${info.lastEntry.timestamp}`));
-          console.log(chalk.gray(`  Actor:        ${info.lastEntry.actor.name}`));
-          console.log(chalk.gray(`  Event:        ${info.lastEntry.event}`));
-          console.log(chalk.gray(`  Hash:         ${info.lastHash?.substring(0, 16)}...`));
-        }
-      } catch (error) {
-        spinner.fail(`Failed to show info: ${error}`);
-        process.exit(1);
-      }
-    });
-}
-
-// ============================================================================
-// Command: logbook tail
-// ============================================================================
-
-function setupTailCommand(program: Command): void {
-  program
-    .command("tail <file-path>")
-    .description("Show the last N entries from Logbook")
-    .option("--lines <n>", "Number of lines to show", "10")
-    .action(async (filePath: string, options: { lines: string }) => {
-      const spinner = ora("Reading Logbook...").start();
-      
-      try {
-        const absolutePath = path.resolve(process.cwd(), filePath);
-        const lines = parseInt(options.lines, 10) || 10;
-        
-        const entries = await readLogbook(absolutePath);
-        const tailEntries = entries.slice(-lines);
-        
-        spinner.succeed(`Showing last ${tailEntries.length} entries`);
-        
-        for (const entry of tailEntries) {
-          console.log(chalk.gray(`\n[${entry.timestamp}] ${entry.event}`));
-          console.log(chalk.gray(`  Actor: ${entry.actor.name}`));
-          if (entry.subject) {
-            console.log(chalk.gray(`  Subject: ${entry.subject.type}:${entry.subject.id}`));
-          }
-          if (entry.hash) {
-            console.log(chalk.gray(`  Hash: ${entry.hash.substring(0, 16)}...`));
-          }
-        }
-        
-        if (tailEntries.length === 0) {
-          console.log(chalk.gray("\nNo entries found"));
-        }
-      } catch (error) {
-        spinner.fail(`Failed to tail: ${error}`);
-        process.exit(1);
-      }
-    });
-}
-
-// ============================================================================
-// Register Commands
-// ============================================================================
-
-/** Register all logbook commands with the program */
-export function registerLogbookCommands(program: Command): void {
-  const logbookProgram = program
-    .command("logbook")
-    .description("Logbook commands")
-    .alias("l");
-
-  setupVerifyCommand(logbookProgram);
-  setupCheckCommand(logbookProgram);
-  setupInfoCommand(logbookProgram);
-  setupTailCommand(logbookProgram);
-}

package/src/index.ts

@@ -1,70 +0,0 @@
-/**
- * BLKC CLI - Developer tools for BLKC
- * 
- * This package provides command-line tools for working with BLKC Blocks, Kits, Circuits, and Logbook.
- * 
- * @package @blkc-code/cli
- * @version 0.1.0
- * @license Apache-2.0
- * @author Black Code Enterprises LLC
- */
-
-import { Command } from "commander";
-import { registerBlockCommands } from "./commands/block.js";
-import { registerKitCommands } from "./commands/kit.js";
-import { registerCircuitCommands } from "./commands/circuit.js";
-import { registerLogbookCommands } from "./commands/logbook.js";
-import { registerDeployCommands } from "./commands/deploy.js";
-
-/**
- * The main BLKC CLI program.
- */
-export const program = new Command();
-
-// Configure the CLI
-program
-  .name("blkc")
-  .description("BLKC developer CLI - Tools for working with Blocks, Kits, Circuits, and Logbook")
-  .version("0.1.0");
-
-// Show help after errors
-program.showHelpAfterError();
-
-// Configure output to prevent duplicate errors
-program.configureOutput({
-  outputError: (str) => {
-    // Only print the error if it's not already been handled
-    if (str && !str.includes("error:")) {
-      console.error(str.trim());
-    }
-  },
-});
-
-// Register all command groups
-registerBlockCommands(program);
-registerKitCommands(program);
-registerCircuitCommands(program);
-registerLogbookCommands(program);
-registerDeployCommands(program);
-
-// Add a global --help flag
-program.option("--debug", "Enable debug mode");
-
-/**
- * Run the CLI.
- */
-export async function run(): Promise<void> {
-  try {
-    await program.parseAsync(process.argv);
-  } catch (error) {
-    if (error instanceof Error) {
-      console.error(`Error: ${error.message}`);
-    } else {
-      console.error("An unknown error occurred");
-    }
-    process.exit(1);
-  }
-}
-
-// Export for bin usage
-export default program;