musubix2 0.1.0

package/bin/musubix.mjs

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import { CLIDispatcher, createCLIDispatcher, getDefaultCommands, parseArgs, showHelp } from '../dist/index.js';
+
+const args = process.argv.slice(2);
+
+if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+  console.log(showHelp());
+  process.exit(0);
+}
+
+if (args.includes('--version') || args.includes('-v')) {
+  const pkg = await import('../package.json', { with: { type: 'json' } });
+  console.log(`musubix2 v${pkg.default.version}`);
+  process.exit(0);
+}
+
+const dispatcher = createCLIDispatcher();
+const commands = getDefaultCommands();
+commands.forEach(cmd => dispatcher.register(cmd.name, cmd.description, cmd.handler));
+
+const parsed = parseArgs(args);
+try {
+  const exitCode = await dispatcher.dispatch(parsed.command, parsed.args, parsed.flags);
+  process.exit(exitCode);
+} catch (err) {
+  console.error('Error:', err instanceof Error ? err.message : err);
+  process.exit(1);
+}

package/dist/cli.d.ts

@@ -0,0 +1,87 @@
+/**
+ * MUSUBIX2 CLI Entry Point — DES-PKG-001
+ *
+ * Unified CLI for all MUSUBIX2 commands.
+ * Lightweight dispatcher with argument parsing, --help support,
+ * and wired-up handlers for tasks / init commands.
+ *
+ * @see REQ-ARC-003, REQ-SDD-004, REQ-SDD-005
+ */
+import { type ExitCodeValue } from '@musubix2/core';
+export interface ParsedArgs {
+    command: string;
+    subcommand?: string;
+    args: string[];
+    flags: Record<string, string | boolean>;
+}
+/**
+ * Parse raw argv tokens into a structured ParsedArgs object.
+ * Supports `--flag`, `--key value`, `-h`, and positional args.
+ */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+/**
+ * Return formatted help text. If `command` is given, return subcommand help;
+ * otherwise return root-level help listing all commands.
+ */
+export declare function showHelp(command?: string): string;
+export interface CLICommand {
+    name: string;
+    description: string;
+    options?: Array<{
+        flag: string;
+        description: string;
+        default?: unknown;
+    }>;
+    action: (args: Record<string, unknown>) => Promise<void>;
+}
+export interface CLIConfig {
+    name: string;
+    version: string;
+    description: string;
+    commands: CLICommand[];
+}
+export declare class CLIDispatcher {
+    private commands;
+    private config;
+    constructor(config: CLIConfig);
+    register(command: CLICommand): void;
+    registerBatch(commands: CLICommand[]): void;
+    getCommand(name: string): CLICommand | undefined;
+    listCommands(): CLICommand[];
+    dispatch(commandName: string, args?: Record<string, unknown>): Promise<void>;
+    getHelp(): string;
+    getVersion(): string;
+    /**
+     * High-level entry: parse argv, handle --help / -h, dispatch command,
+     * and return an ExitCode value.
+     */
+    run(argv: string[]): Promise<ExitCodeValue>;
+}
+import { type TaskInfo } from '@musubix2/workflow-engine';
+/**
+ * Parse a simple markdown task file into TaskInfo objects.
+ * Expected format — one task per line: `- [status] id | title | priority | complexity`
+ */
+export declare function parseTaskFile(content: string): TaskInfo[];
+export declare function handleTasksValidate(filePath: string): Promise<ExitCodeValue>;
+export declare function handleTasksList(filePath?: string): Promise<ExitCodeValue>;
+export declare function handleTasksStats(filePath?: string): Promise<ExitCodeValue>;
+export declare function handleInit(targetPath?: string, name?: string, force?: boolean): Promise<ExitCodeValue>;
+export declare function handleTrace(sub: string | undefined, args: string[]): Promise<ExitCodeValue>;
+export declare function handleTraceVerify(): Promise<ExitCodeValue>;
+export declare function handlePolicy(sub: string | undefined, args: string[]): Promise<ExitCodeValue>;
+export declare function handleOntology(sub: string | undefined): Promise<ExitCodeValue>;
+export declare function handleCodegraph(sub: string | undefined, args: string[]): Promise<ExitCodeValue>;
+export declare function handleSecurity(filePath: string): Promise<ExitCodeValue>;
+export declare function handleWorkflow(sub: string | undefined, args: string[]): Promise<ExitCodeValue>;
+export declare function handleStatus(): Promise<ExitCodeValue>;
+export declare function handleReqValidate(filePath: string): Promise<ExitCodeValue>;
+export declare function handleReqWizard(): Promise<ExitCodeValue>;
+export declare function handleDesignGenerate(filePath: string): Promise<ExitCodeValue>;
+export declare function handleDesignC4(filePath: string, level?: string): Promise<ExitCodeValue>;
+export declare function handleDesignVerify(filePath: string): Promise<ExitCodeValue>;
+export declare function handleCodegen(name: string, type?: string): Promise<ExitCodeValue>;
+export declare function handleTestGen(filePath: string): Promise<ExitCodeValue>;
+export declare function getDefaultCommands(): CLICommand[];
+export declare function createCLIDispatcher(): CLIDispatcher;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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