@n-dx/core 0.1.0

package/packages/rex/dist/cli/commands/validate.js

@@ -0,0 +1,212 @@
+import { join } from "node:path";
+import { readFile } from "node:fs/promises";
+import { SCHEMA_VERSION, isCompatibleSchema } from "../../schema/index.js";
+import { validateDocument, validateConfig } from "../../schema/validate.js";
+import { validateDAG } from "../../core/dag.js";
+import { validateStructure, findEpiclessFeatures } from "../../core/structural.js";
+import { resolveEpiclessFeatures, applyEpiclessResolutions, } from "./validate-interactive.js";
+import { resolveStore } from "../../store/index.js";
+import { REX_DIR } from "./constants.js";
+import { info, result } from "../output.js";
+export async function cmdValidate(dir, flags, options) {
+    const rexDir = join(dir, REX_DIR);
+    const checks = [];
+    // Check config.json schema
+    try {
+        const raw = await readFile(join(rexDir, "config.json"), "utf-8");
+        const parsed = JSON.parse(raw);
+        const result = validateConfig(parsed);
+        if (result.ok) {
+            checks.push({ name: "config.json schema", pass: true, errors: [] });
+        }
+        else {
+            checks.push({
+                name: "config.json schema",
+                pass: false,
+                errors: result.errors.issues.map((i) => `${i.path.join(".")}: ${i.message}`),
+            });
+        }
+    }
+    catch (err) {
+        checks.push({
+            name: "config.json schema",
+            pass: false,
+            errors: [err.message],
+        });
+    }
+    // Check prd.json schema
+    let doc = null;
+    try {
+        const raw = await readFile(join(rexDir, "prd.json"), "utf-8");
+        const parsed = JSON.parse(raw);
+        const result = validateDocument(parsed);
+        if (result.ok) {
+            doc = result.data;
+            checks.push({ name: "prd.json schema", pass: true, errors: [] });
+        }
+        else {
+            checks.push({
+                name: "prd.json schema",
+                pass: false,
+                errors: result.errors.issues.map((i) => `${i.path.join(".")}: ${i.message}`),
+            });
+        }
+    }
+    catch (err) {
+        checks.push({
+            name: "prd.json schema",
+            pass: false,
+            errors: [err.message],
+        });
+    }
+    // Check schema version compatibility
+    if (doc) {
+        if (isCompatibleSchema(doc.schema)) {
+            checks.push({ name: "schema version", pass: true, errors: [] });
+        }
+        else {
+            checks.push({
+                name: "schema version",
+                pass: false,
+                errors: [`Incompatible schema "${doc.schema}", expected "${SCHEMA_VERSION}"`],
+            });
+        }
+    }
+    // DAG validation
+    if (doc) {
+        const dagResult = validateDAG(doc.items);
+        if (dagResult.valid) {
+            checks.push({ name: "DAG integrity", pass: true, errors: [] });
+        }
+        else {
+            checks.push({
+                name: "DAG integrity",
+                pass: false,
+                errors: dagResult.errors,
+            });
+        }
+    }
+    // Structural validation: orphans, cycles, stuck tasks
+    if (doc) {
+        const structural = validateStructure(doc.items);
+        checks.push({
+            name: "hierarchy placement",
+            pass: structural.orphanedItems.length === 0,
+            errors: structural.orphanedItems.map((o) => `"${o.itemId}" (${o.level}): ${o.reason}`),
+        });
+        checks.push({
+            name: "blockedBy cycles",
+            pass: structural.cycles.length === 0,
+            errors: structural.cycles.map((c) => c.join(" → ")),
+        });
+        checks.push({
+            name: "stuck tasks",
+            pass: structural.stuckItems.length === 0,
+            severity: "warn",
+            errors: structural.stuckItems.map((s) => `"${s.itemId}": ${s.reason}`),
+        });
+        checks.push({
+            name: "empty containers",
+            pass: structural.emptyContainers.length === 0,
+            severity: "warn",
+            errors: structural.emptyContainers.map((e) => `"${e.itemId}" (${e.level}): ${e.reason}`),
+        });
+        // Categorise warnings by type for clearer reporting
+        const blockedWarnings = structural.warnings.filter((w) => w.startsWith("Blocked without"));
+        const timestampWarnings = structural.warnings.filter((w) => w.startsWith("Timestamp inconsistency"));
+        const parentChildWarnings = structural.warnings.filter((w) => w.startsWith("Parent-child inconsistency"));
+        if (blockedWarnings.length > 0) {
+            checks.push({
+                name: "blocked item dependencies",
+                pass: false,
+                severity: "warn",
+                errors: blockedWarnings,
+            });
+        }
+        if (timestampWarnings.length > 0) {
+            checks.push({
+                name: "timestamp consistency",
+                pass: false,
+                severity: "warn",
+                errors: timestampWarnings,
+            });
+        }
+        if (parentChildWarnings.length > 0) {
+            checks.push({
+                name: "parent-child status consistency",
+                pass: false,
+                severity: "warn",
+                errors: parentChildWarnings,
+            });
+        }
+    }
+    // Detect epicless features for interactive resolution
+    const epiclessFeatures = doc ? findEpiclessFeatures(doc.items) : [];
+    // Determine pass/fail: warnings don't cause failure
+    const errorChecks = checks.filter((c) => !c.pass && c.severity !== "warn");
+    const allPass = errorChecks.length === 0;
+    // ── JSON output (non-interactive) ──────────────────────────────────────────
+    if (flags.format === "json") {
+        const report = {
+            ok: allPass,
+            checks,
+            summary: {
+                total: checks.length,
+                passed: checks.filter((c) => c.pass).length,
+                failed: errorChecks.length,
+                warnings: checks.filter((c) => !c.pass && c.severity === "warn").length,
+            },
+            ...(epiclessFeatures.length > 0 ? { epiclessFeatures } : {}),
+        };
+        result(JSON.stringify(report, null, 2));
+        if (!allPass)
+            process.exit(1);
+        return;
+    }
+    // ── Text output ────────────────────────────────────────────────────────────
+    for (const check of checks) {
+        const isWarn = !check.pass && check.severity === "warn";
+        const icon = check.pass ? "✓" : isWarn ? "⚠" : "✗";
+        result(`${icon} ${check.name}`);
+        if (!check.pass) {
+            for (const err of check.errors) {
+                result(`    ${err}`);
+            }
+        }
+    }
+    // ── Interactive epicless feature resolution ────────────────────────────────
+    // Only offered in interactive TTY mode when epicless features are detected.
+    // Non-interactive environments (CI, piped output, JSON mode) skip this.
+    const isInteractive = epiclessFeatures.length > 0 &&
+        doc !== null &&
+        process.stdin.isTTY === true &&
+        flags.yes !== "true" &&
+        flags.y !== "true";
+    if (isInteractive || (epiclessFeatures.length > 0 && options?.prompt)) {
+        const resolutions = await resolveEpiclessFeatures(doc, epiclessFeatures, options?.prompt ? { prompt: options.prompt } : undefined);
+        const actionable = resolutions.filter((r) => r.action !== "skip");
+        if (actionable.length > 0) {
+            const mutated = applyEpiclessResolutions(doc, resolutions);
+            if (mutated > 0) {
+                const store = await resolveStore(rexDir);
+                await store.saveDocument(doc);
+                await store.appendLog({
+                    timestamp: new Date().toISOString(),
+                    event: "validate_interactive_fix",
+                    detail: `Resolved ${mutated} epicless feature${mutated === 1 ? "" : "s"} during interactive validation`,
+                });
+                info("");
+                result(`Resolved ${mutated} epicless feature${mutated === 1 ? "" : "s"}.`);
+            }
+        }
+    }
+    info("");
+    if (allPass) {
+        result("All checks passed.");
+    }
+    else {
+        result("Validation failed.");
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/packages/rex/dist/cli/commands/validate.js.map

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

package/packages/rex/dist/cli/commands/verify.d.ts

@@ -0,0 +1 @@
+export declare function cmdVerify(dir: string, flags: Record<string, string>): Promise<void>;

package/packages/rex/dist/cli/commands/verify.js

@@ -0,0 +1,90 @@
+import { join } from "node:path";
+import { resolveStore } from "../../store/index.js";
+import { verify } from "../../core/verify.js";
+import { REX_DIR } from "./constants.js";
+import { info, result } from "../output.js";
+import { CLIError } from "../errors.js";
+export async function cmdVerify(dir, flags) {
+    const rexDir = join(dir, REX_DIR);
+    const store = await resolveStore(rexDir);
+    const doc = await store.loadDocument();
+    const config = await store.loadConfig();
+    const taskId = flags.task;
+    const runTests = flags["dry-run"] !== "true";
+    const format = flags.format;
+    // Validate task ID if provided
+    if (taskId) {
+        const { findItem } = await import("../../core/tree.js");
+        const entry = findItem(doc.items, taskId);
+        if (!entry) {
+            throw new CLIError(`Task "${taskId}" not found.`, "Use 'rex status' to see available items.");
+        }
+    }
+    const verifyResult = await verify({
+        projectDir: dir,
+        items: doc.items,
+        taskId,
+        testCommand: config.test,
+        runTests,
+    });
+    // JSON output
+    if (format === "json") {
+        result(JSON.stringify(verifyResult, null, 2));
+        return;
+    }
+    // Human-readable output
+    const { tasks, testRun, summary } = verifyResult;
+    if (tasks.length === 0) {
+        if (taskId) {
+            result("No acceptance criteria found for this task.");
+        }
+        else {
+            result("No tasks with acceptance criteria found.");
+        }
+        return;
+    }
+    // Per-task output
+    for (const task of tasks) {
+        info("");
+        result(`${task.title} (${task.level})`);
+        for (const cr of task.criteria) {
+            const icon = cr.covered ? "✓" : "✗";
+            result(`  ${icon} ${cr.criterion}`);
+            if (cr.testFiles.length > 0) {
+                for (const tf of cr.testFiles) {
+                    result(`      → ${tf}`);
+                }
+            }
+        }
+        result(`  Coverage: ${task.coveredCriteria}/${task.totalCriteria} criteria mapped to tests`);
+    }
+    // Summary
+    info("");
+    result(`${summary.coveredCriteria}/${summary.totalCriteria} criteria covered across ${summary.totalTasks} task(s)`);
+    // Test run results
+    if (testRun) {
+        info("");
+        if (testRun.ran) {
+            const icon = testRun.passed ? "✓" : "✗";
+            result(`${icon} Tests ${testRun.passed ? "passed" : "failed"}`);
+            if (testRun.command) {
+                info(`  Command: ${testRun.command}`);
+            }
+            if (testRun.durationMs !== undefined) {
+                info(`  Duration: ${testRun.durationMs}ms`);
+            }
+            if (testRun.output) {
+                info("");
+                info(testRun.output);
+            }
+        }
+        else if (testRun.error) {
+            result(`⚠ ${testRun.error}`);
+        }
+    }
+    // Exit code: fail if tests ran and failed
+    if (testRun?.ran && !testRun.passed) {
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=verify.js.map

package/packages/rex/dist/cli/commands/verify.js.map

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

package/packages/rex/dist/cli/errors.d.ts

@@ -0,0 +1,40 @@
+/**
+ * CLI error handling — user-friendly errors with optional suggestions.
+ *
+ * Rex's CLIError extends the foundation CLIError from @n-dx/llm-client,
+ * providing a consistent error hierarchy across all n-dx packages.
+ */
+import { CLIError as BaseCLIError } from "@n-dx/llm-client";
+/**
+ * Rex CLI error — extends the foundation CLIError.
+ *
+ * Inherits from {@link BaseCLIError} (which extends ClaudeClientError),
+ * so `instanceof ClaudeClientError` checks work across the entire error hierarchy.
+ */
+export declare class CLIError extends BaseCLIError {
+    constructor(message: string, suggestion?: string);
+}
+/**
+ * Thrown when a budget threshold is exceeded and abort is configured.
+ * Exit code 2 to distinguish from general errors (exit code 1).
+ */
+export declare class BudgetExceededError extends CLIError {
+    exitCode: number;
+    constructor(warnings: string[]);
+}
+/**
+ * Format an error for CLI output. Returns lines to print to stderr.
+ * Never includes stack traces in the output.
+ */
+export declare function formatCLIError(err: unknown): string;
+/**
+ * Handle a CLI error: print it and exit.
+ * Drop-in replacement for catch blocks in CLI entry points.
+ * Respects custom exitCode if the error has one.
+ */
+export declare function handleCLIError(err: unknown): never;
+/**
+ * Check that .rex/ exists in the given directory.
+ * Throws a CLIError with an init suggestion if missing.
+ */
+export declare function requireRexDir(dir: string): void;

package/packages/rex/dist/cli/errors.js

@@ -0,0 +1,125 @@
+/**
+ * CLI error handling — user-friendly errors with optional suggestions.
+ *
+ * Rex's CLIError extends the foundation CLIError from @n-dx/llm-client,
+ * providing a consistent error hierarchy across all n-dx packages.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { CLIError as BaseCLIError } from "@n-dx/llm-client";
+import { REX_DIR } from "./commands/constants.js";
+/**
+ * Rex CLI error — extends the foundation CLIError.
+ *
+ * Inherits from {@link BaseCLIError} (which extends ClaudeClientError),
+ * so `instanceof ClaudeClientError` checks work across the entire error hierarchy.
+ */
+export class CLIError extends BaseCLIError {
+    constructor(message, suggestion) {
+        super(message, suggestion);
+        this.name = "CLIError";
+    }
+}
+/**
+ * Thrown when a budget threshold is exceeded and abort is configured.
+ * Exit code 2 to distinguish from general errors (exit code 1).
+ */
+export class BudgetExceededError extends CLIError {
+    exitCode = 2;
+    constructor(warnings) {
+        super(`Budget exceeded:\n  ${warnings.join("\n  ")}`, "Adjust budget with: n-dx config rex.budget.tokens <value> or rex.budget.cost <value>");
+        this.name = "BudgetExceededError";
+    }
+}
+/**
+ * Known error patterns mapped to user-friendly messages and suggestions.
+ * Each entry: [regex to match, user-friendly message, suggestion].
+ */
+const ERROR_HINTS = [
+    [
+        /ENOENT.*\.rex/,
+        "Rex directory not found.",
+        "Run 'n-dx init' to set up the project.",
+    ],
+    [
+        /ENOENT.*prd\.json/,
+        "PRD file not found.",
+        "Run 'n-dx init' to create the initial PRD.",
+    ],
+    [
+        /ENOENT.*config\.json/,
+        "Configuration file not found.",
+        "Run 'n-dx init' to create default configuration.",
+    ],
+    [
+        /Invalid prd\.json/,
+        "PRD file is corrupted or has an invalid format.",
+        "Check .rex/prd.json for syntax errors, or re-initialize with 'n-dx init'.",
+    ],
+    [
+        /Invalid config\.json/,
+        "Configuration file is corrupted.",
+        "Check .rex/config.json for syntax errors, or re-initialize with 'n-dx init'.",
+    ],
+    [
+        /EACCES/,
+        "Permission denied.",
+        "Check file permissions for the .rex/ directory.",
+    ],
+    [
+        /Unexpected token/,
+        "Failed to parse JSON file.",
+        "Check for syntax errors in the file, or re-initialize with 'n-dx init'.",
+    ],
+    [
+        /not found/i,
+        "", // Use original message
+        "Check the ID or path and try again.",
+    ],
+];
+/**
+ * Format an error for CLI output. Returns lines to print to stderr.
+ * Never includes stack traces in the output.
+ */
+export function formatCLIError(err) {
+    // CLIError — already user-friendly
+    if (err instanceof CLIError) {
+        let msg = `Error: ${err.message}`;
+        if (err.suggestion) {
+            msg += `\nHint: ${err.suggestion}`;
+        }
+        return msg;
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    // Check for known patterns
+    for (const [pattern, friendly, suggestion] of ERROR_HINTS) {
+        if (pattern.test(message)) {
+            const displayMsg = friendly || message;
+            return `Error: ${displayMsg}\nHint: ${suggestion}`;
+        }
+    }
+    // Generic fallback — show the message, never the stack
+    return `Error: ${message}`;
+}
+/**
+ * Handle a CLI error: print it and exit.
+ * Drop-in replacement for catch blocks in CLI entry points.
+ * Respects custom exitCode if the error has one.
+ */
+export function handleCLIError(err) {
+    console.error(formatCLIError(err));
+    const exitCode = err instanceof CLIError && "exitCode" in err
+        ? err.exitCode
+        : 1;
+    process.exit(exitCode);
+}
+/**
+ * Check that .rex/ exists in the given directory.
+ * Throws a CLIError with an init suggestion if missing.
+ */
+export function requireRexDir(dir) {
+    if (!existsSync(join(dir, REX_DIR))) {
+        throw new CLIError(`Rex directory not found in ${dir}`, "Run 'n-dx init' to set up the project, or 'rex init' if using rex standalone.");
+    }
+}
+//# sourceMappingURL=errors.js.map

package/packages/rex/dist/cli/errors.js.map

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

package/packages/rex/dist/cli/help.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Command-specific help content for the rex CLI.
+ *
+ * Each command has a dedicated help definition that includes:
+ *   - Synopsis / usage pattern
+ *   - Relevant flags only (not the full global options list)
+ *   - 2–3 practical examples
+ *
+ * Uses the shared formatHelp() from @n-dx/llm-client for consistent
+ * presentation with semantic color coding across all n-dx packages.
+ *
+ * @module rex/cli/help
+ */
+/**
+ * Get the help text for a command without printing it.
+ * Returns null if the command has no dedicated help.
+ */
+export declare function getCommandHelp(command: string): string | null;
+/**
+ * Show command-specific help. Returns true if help was shown, false if
+ * the command has no dedicated help (caller should fall back to general usage).
+ */
+export declare function showCommandHelp(command: string): boolean;