@n-dx/core 0.1.0

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

@@ -0,0 +1,3 @@
+export { STATUS_ICONS, renderProgressBar, formatTimestamp, filterCompleted, filterDeleted, renderTree, formatStats, } from "./status-shared.js";
+export type { CoverageMap } from "./status-shared.js";
+export declare function cmdStatus(dir: string, flags: Record<string, string>): Promise<void>;

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

@@ -0,0 +1,118 @@
+import { join } from "node:path";
+import { resolveStore } from "../../store/index.js";
+import { computeStats } from "../../core/stats.js";
+import { verify } from "../../core/verify.js";
+import { CLIError } from "../errors.js";
+import { REX_DIR } from "./constants.js";
+import { result, isQuiet } from "../output.js";
+import { groupByFacet, getFacetValue } from "../../core/facets.js";
+import { walkTree } from "../../core/tree.js";
+import { buildCoverageMap, renderJsonOutput, renderStaleReport, renderTreeView, renderCoverageSummary, renderTokenUsageSection, renderAutoCompletableHints, renderStaleWarnings, } from "./status-sections.js";
+// Re-export shared utilities so existing consumers (tests, etc.) keep working.
+export { STATUS_ICONS, renderProgressBar, formatTimestamp, filterCompleted, filterDeleted, renderTree, formatStats, } from "./status-shared.js";
+const VALID_FORMATS = ["json", "tree"];
+/** Render items grouped by a facet key. */
+function renderGroupedByFacet(items, facetKey) {
+    const groups = groupByFacet(items, facetKey);
+    const lines = [];
+    // Items without the facet
+    const ungrouped = [];
+    for (const { item } of walkTree(items)) {
+        if (!getFacetValue(item, facetKey)) {
+            ungrouped.push(item);
+        }
+    }
+    for (const [value, groupItems] of [...groups.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
+        const stats = computeStats(groupItems);
+        lines.push(`${facetKey}:${value} (${stats.completed}/${stats.total} complete)`);
+        for (const item of groupItems) {
+            const icon = { pending: "○", in_progress: "◐", completed: "●", failing: "✗", deferred: "◌", blocked: "⊘", deleted: "✕" }[item.status] ?? "?";
+            const priority = item.priority ? ` [${item.priority}]` : "";
+            lines.push(`  ${icon} ${item.title}${priority}`);
+        }
+        lines.push("");
+    }
+    if (ungrouped.length > 0) {
+        lines.push(`(untagged) (${ungrouped.length} items)`);
+        for (const item of ungrouped) {
+            const icon = { pending: "○", in_progress: "◐", completed: "●", failing: "✗", deferred: "◌", blocked: "⊘", deleted: "✕" }[item.status] ?? "?";
+            lines.push(`  ${icon} ${item.title}`);
+        }
+    }
+    return lines;
+}
+export async function cmdStatus(dir, flags) {
+    const format = flags.format;
+    const showCoverage = flags.coverage === "true";
+    const showTokens = flags.tokens !== "false";
+    const showAll = flags.all === "true";
+    const groupBy = flags["group-by"];
+    const showStaleOnly = flags.stale === "true";
+    if (format && !VALID_FORMATS.includes(format)) {
+        throw new CLIError(`Unknown format: "${format}"`, `Valid formats: ${VALID_FORMATS.join(", ")}`);
+    }
+    const rexDir = join(dir, REX_DIR);
+    const store = await resolveStore(rexDir);
+    const doc = await store.loadDocument();
+    // Compute coverage if requested
+    let verifyResult;
+    if (showCoverage) {
+        verifyResult = await verify({
+            projectDir: dir,
+            items: doc.items,
+            runTests: false,
+        });
+    }
+    // Build time filter for token usage
+    const tokenFilter = {};
+    if (flags.since)
+        tokenFilter.since = flags.since;
+    if (flags.until)
+        tokenFilter.until = flags.until;
+    if (format === "json") {
+        await renderJsonOutput(doc, {
+            showAll,
+            showTokens,
+            verifyResult,
+            store,
+            dir,
+            tokenFilter,
+        });
+        return;
+    }
+    // Quiet mode with non-JSON format: emit a one-line summary
+    if (isQuiet()) {
+        const stats = computeStats(doc.items);
+        const pct = stats.total > 0 ? Math.round((stats.completed / stats.total) * 100) : 0;
+        result(`${pct}% complete (${stats.completed}/${stats.total})`);
+        return;
+    }
+    // --stale: show only stale items
+    if (showStaleOnly) {
+        renderStaleReport(doc.items);
+        return;
+    }
+    // Default and --format=tree both render the tree view
+    result(`PRD: ${doc.title}`);
+    result("");
+    if (doc.items.length === 0) {
+        result("  No items yet. Run: rex add epic --title=\"...\" " + dir);
+        return;
+    }
+    // --group-by: render grouped by facet instead of hierarchy
+    if (groupBy) {
+        for (const line of renderGroupedByFacet(doc.items, groupBy)) {
+            result(line);
+        }
+        return;
+    }
+    const coverageMap = verifyResult ? buildCoverageMap(verifyResult) : undefined;
+    renderTreeView(doc.items, { showAll, coverageMap });
+    renderCoverageSummary(verifyResult);
+    if (showTokens) {
+        await renderTokenUsageSection(store, dir, tokenFilter);
+    }
+    renderAutoCompletableHints(doc.items);
+    renderStaleWarnings(doc.items);
+}
+//# sourceMappingURL=status.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * `rex sync` — synchronize the local PRD with a remote adapter.
+ *
+ * Flags:
+ *   --push             Push local changes to remote only
+ *   --pull             Pull remote changes to local only
+ *   --adapter=<name>   Adapter name (default: notion)
+ *   --format=json      Machine-readable output
+ *   --dry-run          Preview sync without writing
+ */
+export declare function cmdSync(dir: string, flags: Record<string, string>): Promise<void>;

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

@@ -0,0 +1,131 @@
+import { join } from "node:path";
+import { resolveStore, resolveRemoteStore, SyncEngine } from "../../store/index.js";
+import { CLIError } from "../errors.js";
+import { REX_DIR } from "./constants.js";
+import { info, result } from "../output.js";
+/**
+ * `rex sync` — synchronize the local PRD with a remote adapter.
+ *
+ * Flags:
+ *   --push             Push local changes to remote only
+ *   --pull             Pull remote changes to local only
+ *   --adapter=<name>   Adapter name (default: notion)
+ *   --format=json      Machine-readable output
+ *   --dry-run          Preview sync without writing
+ */
+export async function cmdSync(dir, flags) {
+    const rexDir = join(dir, REX_DIR);
+    const direction = flags.push === "true" ? "push" :
+        flags.pull === "true" ? "pull" :
+            "sync";
+    const adapterName = flags.adapter || "notion";
+    const formatJson = flags.format === "json";
+    const dryRun = flags["dry-run"] === "true";
+    // Resolve stores
+    const local = await resolveStore(rexDir);
+    let remote;
+    try {
+        remote = await resolveRemoteStore(rexDir, adapterName);
+    }
+    catch (err) {
+        throw new CLIError(`Adapter "${adapterName}" is not configured.`, `Run 'rex adapter add ${adapterName}' to configure it.`);
+    }
+    const engine = new SyncEngine(local, remote);
+    if (dryRun) {
+        // Load both documents and report what would change
+        const localDoc = await local.loadDocument();
+        const remoteDoc = await remote.loadDocument();
+        const localIds = new Set(collectIds(localDoc.items));
+        const remoteIds = new Set(collectIds(remoteDoc.items));
+        const localOnly = [...localIds].filter((id) => !remoteIds.has(id));
+        const remoteOnly = [...remoteIds].filter((id) => !localIds.has(id));
+        const shared = [...localIds].filter((id) => remoteIds.has(id));
+        const preview = {
+            direction,
+            dryRun: true,
+            localItems: localIds.size,
+            remoteItems: remoteIds.size,
+            wouldPush: direction !== "pull" ? localOnly.length : 0,
+            wouldPull: direction !== "push" ? remoteOnly.length : 0,
+            shared: shared.length,
+        };
+        if (formatJson) {
+            result(JSON.stringify(preview, null, 2));
+        }
+        else {
+            info(`Dry run — ${adapterName} adapter (${direction})`);
+            info(`  Local items:  ${localIds.size}`);
+            info(`  Remote items: ${remoteIds.size}`);
+            info(`  Shared:       ${shared.length}`);
+            if (direction !== "pull") {
+                info(`  Would push:   ${localOnly.length}`);
+            }
+            if (direction !== "push") {
+                info(`  Would pull:   ${remoteOnly.length}`);
+            }
+            result("\nNo changes written (dry run).");
+        }
+        return;
+    }
+    // Execute sync
+    let report;
+    switch (direction) {
+        case "push":
+            report = await engine.push();
+            break;
+        case "pull":
+            report = await engine.pull();
+            break;
+        default:
+            report = await engine.sync();
+            break;
+    }
+    // Log the sync event
+    await local.appendLog({
+        timestamp: report.timestamp,
+        event: "sync_completed",
+        detail: `${direction} sync with ${adapterName}: ${report.pushed.length} pushed, ${report.pulled.length} pulled, ${report.conflicts.length} conflicts`,
+    });
+    if (formatJson) {
+        result(JSON.stringify(report, null, 2));
+        return;
+    }
+    // Human-readable output
+    info(`Sync completed — ${adapterName} adapter (${direction})`);
+    if (report.pushed.length > 0)
+        info(`  Pushed:    ${report.pushed.length}`);
+    if (report.pulled.length > 0)
+        info(`  Pulled:    ${report.pulled.length}`);
+    if (report.skipped.length > 0)
+        info(`  Skipped:   ${report.skipped.length}`);
+    if (report.deleted.length > 0)
+        info(`  Deleted:   ${report.deleted.length}`);
+    if (report.conflicts.length > 0)
+        info(`  Conflicts: ${report.conflicts.length}`);
+    if (report.errors.length > 0) {
+        info(`  Errors:    ${report.errors.length}`);
+        for (const e of report.errors) {
+            info(`    ${e.itemId}: ${e.error}`);
+        }
+    }
+    if (report.pushed.length === 0 &&
+        report.pulled.length === 0 &&
+        report.conflicts.length === 0) {
+        result("Already in sync.");
+    }
+    else {
+        result("Done.");
+    }
+}
+/** Recursively collect all item IDs from a PRD item tree. */
+function collectIds(items) {
+    const ids = [];
+    for (const item of items) {
+        ids.push(item.id);
+        if (item.children) {
+            ids.push(...collectIds(item.children));
+        }
+    }
+    return ids;
+}
+//# sourceMappingURL=sync.js.map

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

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

package/packages/rex/dist/cli/commands/token-format.d.ts

@@ -0,0 +1,31 @@
+/**
+ * CLI presentation formatting for token usage data.
+ *
+ * These functions produce terminal-oriented strings for CLI display.
+ * The domain core (token-usage.ts) exposes raw data structures;
+ * this module composes them with CLI-specific formatting.
+ */
+import type { AggregateTokenUsage, BudgetCheckResult } from "../../core/token-usage.js";
+/**
+ * Format aggregate token usage for CLI display.
+ * Returns an array of lines (without trailing newlines).
+ */
+export declare function formatAggregateTokenUsage(usage: AggregateTokenUsage): string[];
+/**
+ * Format budget check warnings for CLI display.
+ *
+ * Returns an array of formatted lines with severity indicators.
+ * Returns an empty array when no budget is configured or usage is within bounds.
+ */
+export declare function formatBudgetWarnings(result: BudgetCheckResult): string[];
+/**
+ * Pre-flight budget check for orchestration commands.
+ *
+ * Loads the rex config, aggregates current token usage, checks against
+ * budget thresholds, and returns the result. Returns undefined if no
+ * budget is configured.
+ *
+ * @param rexDir  Path to the `.rex/` directory.
+ * @param projectDir  Project root directory.
+ */
+export declare function preflightBudgetCheck(rexDir: string, projectDir: string): Promise<BudgetCheckResult | undefined>;

package/packages/rex/dist/cli/commands/token-format.js

@@ -0,0 +1,86 @@
+/**
+ * CLI presentation formatting for token usage data.
+ *
+ * These functions produce terminal-oriented strings for CLI display.
+ * The domain core (token-usage.ts) exposes raw data structures;
+ * this module composes them with CLI-specific formatting.
+ */
+import { resolveStore } from "../../store/index.js";
+import { aggregateTokenUsage, checkBudget, } from "../../core/token-usage.js";
+/** Format a number with locale-aware commas. */
+function fmt(n) {
+    return n.toLocaleString();
+}
+/**
+ * Format aggregate token usage for CLI display.
+ * Returns an array of lines (without trailing newlines).
+ */
+export function formatAggregateTokenUsage(usage) {
+    const total = usage.totalInputTokens + usage.totalOutputTokens;
+    if (total === 0) {
+        return ["Token usage: none recorded"];
+    }
+    const lines = [];
+    lines.push(`Token usage: ${fmt(total)} tokens (${fmt(usage.totalInputTokens)} in / ${fmt(usage.totalOutputTokens)} out)`);
+    // Per-package breakdown — only show packages with usage
+    const { rex, hench, sv } = usage.packages;
+    const parts = [];
+    if (sv.inputTokens + sv.outputTokens > 0) {
+        const svTotal = sv.inputTokens + sv.outputTokens;
+        parts.push(`sv: ${fmt(svTotal)} (${sv.calls} calls)`);
+    }
+    if (rex.inputTokens + rex.outputTokens > 0) {
+        const rexTotal = rex.inputTokens + rex.outputTokens;
+        parts.push(`rex: ${fmt(rexTotal)} (${rex.calls} calls)`);
+    }
+    if (hench.inputTokens + hench.outputTokens > 0) {
+        const henchTotal = hench.inputTokens + hench.outputTokens;
+        parts.push(`hench: ${fmt(henchTotal)} (${hench.calls} runs)`);
+    }
+    if (parts.length > 0) {
+        lines.push(`  ${parts.join("  ·  ")}`);
+    }
+    return lines;
+}
+/**
+ * Format budget check warnings for CLI display.
+ *
+ * Returns an array of formatted lines with severity indicators.
+ * Returns an empty array when no budget is configured or usage is within bounds.
+ */
+export function formatBudgetWarnings(result) {
+    if (result.severity === "ok" || result.warnings.length === 0)
+        return [];
+    const prefix = result.severity === "exceeded" ? "⚠ BUDGET EXCEEDED" : "⚠ Budget warning";
+    const lines = [`${prefix}:`];
+    for (const warning of result.warnings) {
+        lines.push(`  ${warning}`);
+    }
+    return lines;
+}
+/**
+ * Pre-flight budget check for orchestration commands.
+ *
+ * Loads the rex config, aggregates current token usage, checks against
+ * budget thresholds, and returns the result. Returns undefined if no
+ * budget is configured.
+ *
+ * @param rexDir  Path to the `.rex/` directory.
+ * @param projectDir  Project root directory.
+ */
+export async function preflightBudgetCheck(rexDir, projectDir) {
+    const store = await resolveStore(rexDir);
+    let config;
+    try {
+        config = await store.loadConfig();
+    }
+    catch {
+        return undefined; // Config not available — skip
+    }
+    if (!config.budget)
+        return undefined;
+    const logEntries = await store.readLog();
+    const usage = await aggregateTokenUsage(logEntries, projectDir);
+    return checkBudget(usage, config.budget);
+}
+//# sourceMappingURL=token-format.js.map

package/packages/rex/dist/cli/commands/token-format.js.map

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

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

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

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

@@ -0,0 +1,146 @@
+import { join } from "node:path";
+import { resolveStore } from "../../store/index.js";
+import { REX_DIR } from "./constants.js";
+import { CLIError, requireRexDir } from "../errors.js";
+import { info, result } from "../output.js";
+import { validateTransition } from "../../core/transitions.js";
+import { computeTimestampUpdates } from "../../core/timestamps.js";
+import { findAutoCompletions } from "../../core/parent-completion.js";
+import { validateDAG } from "../../core/dag.js";
+import { findItem } from "../../core/tree.js";
+import { deleteItem, cleanBlockedByRefs } from "../../core/delete.js";
+import { VALID_STATUSES, VALID_PRIORITIES, isItemStatus, isPriority } from "../../schema/index.js";
+export async function cmdUpdate(dir, id, flags) {
+    if (!id) {
+        throw new CLIError("Missing item ID.", "Usage: rex update <id> --status=<s> --priority=<p> --title=<t>");
+    }
+    requireRexDir(dir);
+    const rexDir = join(dir, REX_DIR);
+    const store = await resolveStore(rexDir);
+    const existing = await store.getItem(id);
+    if (!existing) {
+        throw new CLIError(`Item "${id}" not found.`, "Check the ID with 'rex status' and try again.");
+    }
+    const updates = {};
+    if (flags.status) {
+        if (!isItemStatus(flags.status)) {
+            throw new CLIError(`Invalid status "${flags.status}".`, `Must be one of: ${[...VALID_STATUSES].join(", ")}`);
+        }
+        // Validate transition unless --force is set
+        if (flags.force !== "true") {
+            const transition = validateTransition(existing.status, flags.status);
+            if (!transition.allowed) {
+                throw new CLIError(transition.message, "Use --force to override this check.");
+            }
+        }
+        // Handle deletion: remove item and children from tree
+        if (flags.status === "deleted") {
+            const doc = await store.loadDocument();
+            const deletedIds = deleteItem(doc.items, id);
+            cleanBlockedByRefs(doc.items, new Set(deletedIds));
+            await store.saveDocument(doc);
+            await store.appendLog({
+                timestamp: new Date().toISOString(),
+                event: "item_deleted",
+                itemId: id,
+                detail: `Deleted ${existing.level}: ${existing.title} (${deletedIds.length} item(s) removed)`,
+            });
+            if (flags.format === "json") {
+                result(JSON.stringify({ deleted: deletedIds }, null, 2));
+            }
+            else {
+                result(`Deleted ${existing.level}: ${existing.title} (${deletedIds.length} item(s) removed)`);
+            }
+            return;
+        }
+        updates.status = flags.status;
+        // Set failureReason when transitioning to failing
+        if (flags.status === "failing" && flags.reason) {
+            updates.failureReason = flags.reason;
+        }
+        // Compute automatic timestamp updates for the status change
+        const tsUpdates = computeTimestampUpdates(existing.status, updates.status, existing);
+        Object.assign(updates, tsUpdates);
+    }
+    if (flags.priority) {
+        if (!isPriority(flags.priority)) {
+            throw new CLIError(`Invalid priority "${flags.priority}".`, `Must be one of: ${[...VALID_PRIORITIES].join(", ")}`);
+        }
+        updates.priority = flags.priority;
+    }
+    if (flags.title)
+        updates.title = flags.title;
+    if (flags.description)
+        updates.description = flags.description;
+    if (flags.blockedBy !== undefined) {
+        const raw = flags.blockedBy.trim();
+        if (raw === "") {
+            // Clear dependencies
+            updates.blockedBy = undefined;
+        }
+        else {
+            updates.blockedBy = raw.split(",").map((s) => s.trim()).filter(Boolean);
+        }
+    }
+    if (Object.keys(updates).length === 0) {
+        throw new CLIError("No updates specified.", "Use --status, --priority, --title, --description, --blockedBy, or --reason (with --status=failing).");
+    }
+    // Validate dependencies before persisting
+    if (updates.blockedBy && updates.blockedBy.length > 0) {
+        const doc = await store.loadDocument();
+        // Simulate the update to validate the resulting DAG
+        const simItems = JSON.parse(JSON.stringify(doc.items));
+        const simEntry = findItem(simItems, id);
+        if (simEntry) {
+            simEntry.item.blockedBy = updates.blockedBy;
+        }
+        const dagResult = validateDAG(simItems);
+        if (!dagResult.valid) {
+            throw new CLIError(`Invalid dependencies: ${dagResult.errors.join("; ")}`, "Check the IDs with 'rex status' and ensure no cycles exist.");
+        }
+    }
+    await store.updateItem(id, updates);
+    // Log the update
+    await store.appendLog({
+        timestamp: new Date().toISOString(),
+        event: "item_updated",
+        itemId: id,
+        detail: `Updated: ${Object.keys(updates).join(", ")}`,
+    });
+    // Auto-complete parent items when a child is completed or deferred
+    const autoCompleted = [];
+    if (updates.status &&
+        (updates.status === "completed" || updates.status === "deferred")) {
+        const doc = await store.loadDocument();
+        const { completedItems } = findAutoCompletions(doc.items, id);
+        for (const item of completedItems) {
+            const parentItem = await store.getItem(item.id);
+            if (!parentItem)
+                continue;
+            const parentTsUpdates = computeTimestampUpdates(parentItem.status, "completed", parentItem);
+            await store.updateItem(item.id, {
+                status: "completed",
+                ...parentTsUpdates,
+            });
+            await store.appendLog({
+                timestamp: new Date().toISOString(),
+                event: "auto_completed",
+                itemId: item.id,
+                detail: `Auto-completed ${item.level}: ${item.title} (all children done)`,
+            });
+            autoCompleted.push(item);
+        }
+    }
+    if (flags.format === "json") {
+        const updated = await store.getItem(id);
+        result(JSON.stringify({ ...updated, autoCompleted }, null, 2));
+    }
+    else {
+        result(`Updated ${existing.level}: ${existing.title}`);
+        info(`  ${Object.entries(updates).map(([k, v]) => `${k}: ${v}`).join(", ")}`);
+        for (const item of autoCompleted) {
+            info(`  ✓ Auto-completed ${item.level}: ${item.title}`);
+        }
+    }
+}
+//# sourceMappingURL=update.js.map

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

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

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

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