@n-dx/core 0.1.0

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

@@ -0,0 +1,218 @@
+import { join } from "node:path";
+import { readFile } from "node:fs/promises";
+import { SCHEMA_VERSION } from "../../schema/index.js";
+import { validateDocument, validateConfig } from "../../schema/validate.js";
+import { validateDAG } from "../../core/dag.js";
+import { validateStructure } from "../../core/structural.js";
+import { walkTree } from "../../core/tree.js";
+import { computeStats } from "../../core/stats.js";
+import { REX_DIR } from "./constants.js";
+import { result } from "../output.js";
+/** Run validation checks and return structured results (shared logic with validate.ts). */
+async function runChecks(dir) {
+    const rexDir = join(dir, REX_DIR);
+    const checks = [];
+    let doc = null;
+    // Check config.json schema
+    try {
+        const raw = await readFile(join(rexDir, "config.json"), "utf-8");
+        const parsed = JSON.parse(raw);
+        const res = validateConfig(parsed);
+        if (res.ok) {
+            checks.push({ name: "config.json schema", pass: true, errors: [] });
+        }
+        else {
+            checks.push({
+                name: "config.json schema",
+                pass: false,
+                errors: res.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
+    try {
+        const raw = await readFile(join(rexDir, "prd.json"), "utf-8");
+        const parsed = JSON.parse(raw);
+        const res = validateDocument(parsed);
+        if (res.ok) {
+            doc = res.data;
+            checks.push({ name: "prd.json schema", pass: true, errors: [] });
+        }
+        else {
+            checks.push({
+                name: "prd.json schema",
+                pass: false,
+                errors: res.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
+    if (doc) {
+        if (doc.schema === SCHEMA_VERSION) {
+            checks.push({ name: "schema version", pass: true, errors: [] });
+        }
+        else {
+            checks.push({
+                name: "schema version",
+                pass: false,
+                errors: [`Unknown 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}`),
+        });
+        if (structural.warnings.length > 0) {
+            checks.push({
+                name: "blocked item dependencies",
+                pass: false,
+                severity: "warn",
+                errors: structural.warnings,
+            });
+        }
+    }
+    return { checks, doc };
+}
+/** Count items by level, returning a per-level breakdown. */
+function computeBreakdown(items) {
+    const counts = {
+        epic: { total: 0, completed: 0, inProgress: 0, pending: 0, deferred: 0, blocked: 0, deleted: 0 },
+        feature: { total: 0, completed: 0, inProgress: 0, pending: 0, deferred: 0, blocked: 0, deleted: 0 },
+        task: { total: 0, completed: 0, inProgress: 0, pending: 0, deferred: 0, blocked: 0, deleted: 0 },
+        subtask: { total: 0, completed: 0, inProgress: 0, pending: 0, deferred: 0, blocked: 0, deleted: 0 },
+    };
+    for (const { item } of walkTree(items)) {
+        const level = counts[item.level];
+        if (!level)
+            continue;
+        // Deleted items are tracked separately and excluded from total
+        if (item.status === "deleted") {
+            level.deleted++;
+            continue;
+        }
+        level.total++;
+        switch (item.status) {
+            case "completed":
+                level.completed++;
+                break;
+            case "in_progress":
+                level.inProgress++;
+                break;
+            case "pending":
+                level.pending++;
+                break;
+            case "deferred":
+                level.deferred++;
+                break;
+            case "blocked":
+                level.blocked++;
+                break;
+        }
+    }
+    // Only include levels that have items
+    const result = {};
+    for (const [level, data] of Object.entries(counts)) {
+        if (data.total > 0) {
+            result[level] = data;
+        }
+    }
+    return result;
+}
+/**
+ * Generate a machine-readable JSON health report for CI dashboards.
+ *
+ * Combines validation checks, aggregate stats, progress, and per-level
+ * breakdown into a single structured JSON output.
+ *
+ * By default, always exits 0 (informational report). Use --fail-on-error
+ * to exit 1 when validation errors are detected.
+ */
+export async function cmdReport(dir, flags) {
+    const failOnError = flags["fail-on-error"] === "true";
+    const { checks, doc } = await runChecks(dir);
+    // Determine pass/fail: warnings don't cause failure
+    const errorChecks = checks.filter((c) => !c.pass && c.severity !== "warn");
+    const validationOk = errorChecks.length === 0;
+    // Compute stats and progress
+    const items = doc?.items ?? [];
+    const stats = computeStats(items);
+    const percent = stats.total > 0
+        ? Math.round((stats.completed / stats.total) * 100)
+        : 0;
+    const report = {
+        timestamp: new Date().toISOString(),
+        ok: validationOk,
+        validation: {
+            ok: validationOk,
+            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,
+            },
+        },
+        stats,
+        progress: {
+            percent,
+            completed: stats.completed,
+            total: stats.total,
+        },
+        breakdown: computeBreakdown(items),
+    };
+    result(JSON.stringify(report, null, 2));
+    if (failOnError && !validationOk) {
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=report.js.map

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

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

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

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

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

@@ -0,0 +1,182 @@
+import { join } from "node:path";
+import { writeFile } from "node:fs/promises";
+import { resolveStore } from "../../store/index.js";
+import { applyReshape } from "../../core/reshape.js";
+import { toCanonicalJSON } from "../../core/canonical.js";
+import { reasonForReshape, formatReshapeProposal } from "../../analyze/reshape-reason.js";
+import { setLLMConfig, setClaudeConfig } from "../../analyze/reason.js";
+import { loadLLMConfig, loadClaudeConfig } from "../../store/project-config.js";
+import { REX_DIR } from "./constants.js";
+import { CLIError } from "../errors.js";
+import { info, result } from "../output.js";
+import { formatTokenUsage } from "./analyze.js";
+const ARCHIVE_FILE = "archive.json";
+/** Maximum number of archive batches to retain. */
+const MAX_ARCHIVE_BATCHES = 100;
+async function loadArchive(archivePath) {
+    try {
+        const { readFile } = await import("node:fs/promises");
+        const raw = await readFile(archivePath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return { schema: "rex/archive/v1", batches: [] };
+    }
+}
+/**
+ * Trim archive to retain only the most recent batches.
+ */
+function trimArchive(archive, maxBatches = MAX_ARCHIVE_BATCHES) {
+    if (archive.batches.length > maxBatches) {
+        archive.batches = archive.batches.slice(archive.batches.length - maxBatches);
+    }
+}
+export async function cmdReshape(dir, flags) {
+    const rexDir = join(dir, REX_DIR);
+    const store = await resolveStore(rexDir);
+    const doc = await store.loadDocument();
+    if (doc.items.length === 0) {
+        throw new CLIError("PRD is empty — nothing to reshape.", "Run 'rex analyze' first to build your PRD.");
+    }
+    // Load LLM config
+    const llmConfig = await loadLLMConfig(rexDir);
+    setLLMConfig(llmConfig);
+    const claudeConfig = await loadClaudeConfig(rexDir);
+    setClaudeConfig(claudeConfig);
+    const model = flags.model;
+    const dryRun = flags["dry-run"] === "true";
+    const accept = flags.accept === "true";
+    // Get reshape proposals from LLM
+    info("Analyzing PRD structure...");
+    const { proposals, tokenUsage } = await reasonForReshape(doc.items, { dir, model });
+    // Show token usage
+    const usageLine = formatTokenUsage(tokenUsage);
+    if (usageLine) {
+        info(`Token usage: ${usageLine}`);
+    }
+    if (proposals.length === 0) {
+        result("No reshape proposals — PRD structure looks good.");
+        return;
+    }
+    // Display proposals
+    info(`\nFound ${proposals.length} reshape proposal${proposals.length === 1 ? "" : "s"}:\n`);
+    for (let i = 0; i < proposals.length; i++) {
+        info(`${i + 1}. ${formatReshapeProposal(proposals[i], doc.items)}`);
+        info("");
+    }
+    if (flags.format === "json") {
+        result(JSON.stringify({
+            dryRun,
+            proposals: proposals.map((p) => ({
+                id: p.id,
+                ...p.action,
+            })),
+            tokenUsage,
+        }, null, 2));
+        if (dryRun)
+            return;
+    }
+    if (dryRun) {
+        result(`\n${proposals.length} proposal${proposals.length === 1 ? "" : "s"} (dry run — no changes made).`);
+        return;
+    }
+    // Determine which proposals to apply
+    let accepted;
+    if (accept) {
+        accepted = proposals;
+    }
+    else if (process.stdin.isTTY) {
+        accepted = await interactiveReview(proposals, doc.items);
+    }
+    else {
+        info("Proposals shown above. Run with --accept to apply, or use interactively in a TTY.");
+        return;
+    }
+    if (accepted.length === 0) {
+        result("No proposals accepted.");
+        return;
+    }
+    // Apply accepted proposals
+    const reshapeResult = applyReshape(doc.items, accepted);
+    // Report errors
+    for (const err of reshapeResult.errors) {
+        info(`  Warning: ${err.error}`);
+    }
+    // Archive removed items
+    if (reshapeResult.archivedItems.length > 0) {
+        const archivePath = join(rexDir, ARCHIVE_FILE);
+        const archive = await loadArchive(archivePath);
+        archive.batches.push({
+            timestamp: new Date().toISOString(),
+            source: "reshape",
+            items: reshapeResult.archivedItems,
+            count: reshapeResult.archivedItems.length,
+            reason: `Reshape: ${accepted.map((p) => p.action.action).join(", ")}`,
+            actions: accepted,
+        });
+        trimArchive(archive);
+        await writeFile(archivePath, toCanonicalJSON(archive), "utf-8");
+    }
+    // Save document
+    await store.saveDocument(doc);
+    // Log the reshape
+    await store.appendLog({
+        timestamp: new Date().toISOString(),
+        event: "reshape",
+        detail: JSON.stringify({
+            applied: reshapeResult.applied.length,
+            deleted: reshapeResult.deletedIds.length,
+            errors: reshapeResult.errors.length,
+            actions: reshapeResult.applied.map((p) => p.action.action),
+        }),
+    });
+    // Output
+    if (flags.format === "json") {
+        result(JSON.stringify({
+            applied: reshapeResult.applied.length,
+            deletedIds: reshapeResult.deletedIds,
+            archivedCount: reshapeResult.archivedItems.length,
+            errors: reshapeResult.errors.map((e) => e.error),
+        }, null, 2));
+    }
+    else {
+        result(`Applied ${reshapeResult.applied.length} reshape action${reshapeResult.applied.length === 1 ? "" : "s"}.`);
+        if (reshapeResult.deletedIds.length > 0) {
+            info(`  ${reshapeResult.deletedIds.length} item${reshapeResult.deletedIds.length === 1 ? "" : "s"} archived.`);
+        }
+        if (reshapeResult.errors.length > 0) {
+            info(`  ${reshapeResult.errors.length} error${reshapeResult.errors.length === 1 ? "" : "s"} (see above).`);
+        }
+    }
+}
+async function interactiveReview(proposals, items) {
+    const readline = await import("node:readline");
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const ask = (q) => new Promise((resolve) => rl.question(q, resolve));
+    const accepted = [];
+    try {
+        for (let i = 0; i < proposals.length; i++) {
+            const p = proposals[i];
+            info(`\n[${i + 1}/${proposals.length}] ${formatReshapeProposal(p, items)}`);
+            const answer = await ask("  Accept? (y/n/a=all/q=quit) ");
+            const choice = answer.trim().toLowerCase();
+            if (choice === "q")
+                break;
+            if (choice === "a") {
+                accepted.push(...proposals.slice(i));
+                break;
+            }
+            if (choice === "y" || choice === "yes") {
+                accepted.push(p);
+            }
+        }
+    }
+    finally {
+        rl.close();
+    }
+    return accepted;
+}
+//# sourceMappingURL=reshape.js.map

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

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

package/packages/rex/dist/cli/commands/smart-add-duplicates.d.ts

@@ -0,0 +1,45 @@
+import type { PRDItem, ItemLevel, ItemStatus, DuplicateOverrideMarker } from "../../schema/index.js";
+import type { Proposal, DuplicateReasonMetadata } from "../../analyze/index.js";
+export type ProposalNodeKind = "epic" | "feature" | "task";
+export type DuplicateReason = "exact_title" | "semantic_title" | "content_overlap" | "none";
+export interface ProposalNode {
+    key: string;
+    kind: ProposalNodeKind;
+    title: string;
+    description?: string;
+    acceptanceCriteria?: string[];
+}
+export interface MatchedPRDItemRef {
+    id: string;
+    title: string;
+    level: ItemLevel;
+    status: ItemStatus;
+}
+export interface ProposalDuplicateMatch {
+    node: ProposalNode;
+    duplicate: boolean;
+    reason: DuplicateReason;
+    score: number;
+    matchedItem?: MatchedPRDItemRef;
+}
+/**
+ * Build proposal-facing duplicate metadata. Returns undefined for non-duplicates.
+ */
+export declare function buildDuplicateReasonMetadata(match: ProposalDuplicateMatch): DuplicateReasonMetadata | undefined;
+/**
+ * Build persisted audit metadata for an explicit duplicate override.
+ * Returns undefined for non-duplicate matches.
+ */
+export declare function buildDuplicateOverrideMarker(match: ProposalDuplicateMatch, createdAt: string): DuplicateOverrideMarker | undefined;
+/**
+ * Build marker map keyed by proposal node key for use during item creation.
+ */
+export declare function buildDuplicateOverrideMarkerIndex(matches: ProposalDuplicateMatch[], createdAt: string): Record<string, DuplicateOverrideMarker>;
+/**
+ * Attach structured duplicate reason metadata to matched proposal nodes.
+ * Non-duplicate nodes are returned without duplicate metadata.
+ */
+export declare function attachDuplicateReasonsToProposals(proposals: Proposal[], matches: ProposalDuplicateMatch[]): Proposal[];
+export declare function flattenProposalNodes(proposals: Proposal[]): ProposalNode[];
+export declare function matchProposalNodeToPRD(node: ProposalNode, existingItems: PRDItem[]): ProposalDuplicateMatch;
+export declare function matchProposalNodesToPRD(proposals: Proposal[], existingItems: PRDItem[]): ProposalDuplicateMatch[];