@n-dx/core 0.1.0

package/packages/rex/dist/core/requirements.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Requirements collection, validation, and traceability.
+ *
+ * Requirements are first-class objects attached to PRD items. They flow
+ * downward: a task inherits the requirements of its parent chain
+ * (epic/feature). This module provides utilities to:
+ *
+ * 1. **Collect** — gather all applicable requirements for a given item
+ *    by walking up the parent chain.
+ * 2. **Validate** — check whether requirements are met (automated,
+ *    metric, or flagged for manual review).
+ * 3. **Trace** — map requirements back to their source items for
+ *    audit and reporting.
+ *
+ * @module rex/core/requirements
+ */
+import type { PRDItem, Requirement, RequirementCategory, RequirementValidationType } from "../schema/index.js";
+/**
+ * A requirement paired with the item it was defined on.
+ * Used for traceability — knowing *where* a requirement came from.
+ */
+export interface TracedRequirement {
+    /** The requirement definition. */
+    requirement: Requirement;
+    /** ID of the item that defined this requirement. */
+    sourceItemId: string;
+    /** Title of the source item (for display). */
+    sourceItemTitle: string;
+    /** Level of the source item. */
+    sourceItemLevel: string;
+}
+/**
+ * Collect all requirements that apply to a specific item.
+ *
+ * Requirements are **inherited**: a task picks up requirements from its
+ * own definition plus all ancestor items (parent, grandparent, etc.).
+ * This mirrors how non-functional requirements cascade from epics down
+ * to individual tasks.
+ *
+ * Order: own requirements first, then parent's, then grandparent's, etc.
+ */
+export declare function collectRequirements(items: PRDItem[], itemId: string): TracedRequirement[];
+/**
+ * Collect requirements for an item filtered by category.
+ */
+export declare function collectRequirementsByCategory(items: PRDItem[], itemId: string, category: RequirementCategory): TracedRequirement[];
+/**
+ * Collect requirements for an item filtered by validation type.
+ */
+export declare function collectRequirementsByValidationType(items: PRDItem[], itemId: string, validationType: RequirementValidationType): TracedRequirement[];
+/**
+ * Result of validating a single requirement.
+ */
+export interface RequirementValidationResult {
+    /** The requirement that was validated. */
+    requirementId: string;
+    requirementTitle: string;
+    /** Whether the requirement passed validation. */
+    passed: boolean;
+    /** Validation type used. */
+    validationType: RequirementValidationType;
+    /** Human-readable reason for pass/fail. */
+    reason: string;
+    /** For metric type: the measured value. */
+    measuredValue?: number;
+    /** For metric type: the required threshold. */
+    threshold?: number;
+    /** Source item that defined this requirement. */
+    sourceItemId: string;
+}
+/**
+ * Aggregate result of validating all requirements for an item.
+ */
+export interface RequirementsValidationSummary {
+    /** ID of the item whose requirements were validated. */
+    itemId: string;
+    /** Whether all requirements passed. */
+    allPassed: boolean;
+    /** Total number of requirements checked. */
+    total: number;
+    /** Number that passed. */
+    passed: number;
+    /** Number that failed. */
+    failed: number;
+    /** Number requiring manual review. */
+    manualReviewRequired: number;
+    /** Individual results. */
+    results: RequirementValidationResult[];
+}
+/**
+ * Callback that runs a shell command and returns the result.
+ *
+ * The requirements module itself doesn't execute commands — that's
+ * the caller's responsibility (keeps this module side-effect free).
+ * Hench provides the actual executor that respects guard rails.
+ */
+export type CommandExecutor = (command: string) => Promise<{
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}>;
+/**
+ * Validate all requirements for a given item.
+ *
+ * - `automated` requirements: runs the validationCommand; pass if exit code 0.
+ * - `metric` requirements: runs the validationCommand; parses stdout for a
+ *   number and compares against threshold.
+ * - `manual` requirements: flagged as needing manual review (cannot auto-pass).
+ *
+ * Requirements without a validationCommand (except manual type) are
+ * reported as needing attention.
+ */
+export declare function validateRequirements(items: PRDItem[], itemId: string, executor?: CommandExecutor): Promise<RequirementsValidationSummary>;
+/**
+ * Validate only automated and metric requirements (skip manual).
+ * This is the gate used by hench before task completion — manual
+ * requirements don't block automated task completion.
+ */
+export declare function validateAutomatedRequirements(items: PRDItem[], itemId: string, executor?: CommandExecutor): Promise<RequirementsValidationSummary>;
+/**
+ * Format a validation summary as a human-readable string.
+ */
+export declare function formatRequirementsValidation(summary: RequirementsValidationSummary): string;
+/**
+ * Build a traceability matrix: for each requirement, list the items
+ * it applies to. Useful for audit and coverage reports.
+ */
+export declare function buildTraceabilityMatrix(items: PRDItem[]): Map<string, {
+    requirement: Requirement;
+    appliesTo: string[];
+}>;

package/packages/rex/dist/core/requirements.js

@@ -0,0 +1,263 @@
+/**
+ * Requirements collection, validation, and traceability.
+ *
+ * Requirements are first-class objects attached to PRD items. They flow
+ * downward: a task inherits the requirements of its parent chain
+ * (epic/feature). This module provides utilities to:
+ *
+ * 1. **Collect** — gather all applicable requirements for a given item
+ *    by walking up the parent chain.
+ * 2. **Validate** — check whether requirements are met (automated,
+ *    metric, or flagged for manual review).
+ * 3. **Trace** — map requirements back to their source items for
+ *    audit and reporting.
+ *
+ * @module rex/core/requirements
+ */
+import { findItem, walkTree } from "./tree.js";
+/**
+ * Collect all requirements that apply to a specific item.
+ *
+ * Requirements are **inherited**: a task picks up requirements from its
+ * own definition plus all ancestor items (parent, grandparent, etc.).
+ * This mirrors how non-functional requirements cascade from epics down
+ * to individual tasks.
+ *
+ * Order: own requirements first, then parent's, then grandparent's, etc.
+ */
+export function collectRequirements(items, itemId) {
+    const entry = findItem(items, itemId);
+    if (!entry)
+        return [];
+    const traced = [];
+    // Own requirements first
+    if (entry.item.requirements?.length) {
+        for (const req of entry.item.requirements) {
+            traced.push({
+                requirement: req,
+                sourceItemId: entry.item.id,
+                sourceItemTitle: entry.item.title,
+                sourceItemLevel: entry.item.level,
+            });
+        }
+    }
+    // Walk up parent chain (immediate parent → root)
+    for (const parent of [...entry.parents].reverse()) {
+        if (parent.requirements?.length) {
+            for (const req of parent.requirements) {
+                traced.push({
+                    requirement: req,
+                    sourceItemId: parent.id,
+                    sourceItemTitle: parent.title,
+                    sourceItemLevel: parent.level,
+                });
+            }
+        }
+    }
+    return traced;
+}
+/**
+ * Collect requirements for an item filtered by category.
+ */
+export function collectRequirementsByCategory(items, itemId, category) {
+    return collectRequirements(items, itemId).filter((tr) => tr.requirement.category === category);
+}
+/**
+ * Collect requirements for an item filtered by validation type.
+ */
+export function collectRequirementsByValidationType(items, itemId, validationType) {
+    return collectRequirements(items, itemId).filter((tr) => tr.requirement.validationType === validationType);
+}
+/**
+ * Validate all requirements for a given item.
+ *
+ * - `automated` requirements: runs the validationCommand; pass if exit code 0.
+ * - `metric` requirements: runs the validationCommand; parses stdout for a
+ *   number and compares against threshold.
+ * - `manual` requirements: flagged as needing manual review (cannot auto-pass).
+ *
+ * Requirements without a validationCommand (except manual type) are
+ * reported as needing attention.
+ */
+export async function validateRequirements(items, itemId, executor) {
+    const traced = collectRequirements(items, itemId);
+    const results = [];
+    for (const tr of traced) {
+        const req = tr.requirement;
+        const base = {
+            requirementId: req.id,
+            requirementTitle: req.title,
+            validationType: req.validationType,
+            sourceItemId: tr.sourceItemId,
+        };
+        if (req.validationType === "manual") {
+            results.push({
+                ...base,
+                passed: false,
+                reason: `Manual review required: ${req.title}`,
+            });
+            continue;
+        }
+        if (!req.validationCommand) {
+            results.push({
+                ...base,
+                passed: false,
+                reason: `No validation command configured for ${req.validationType} requirement "${req.title}"`,
+            });
+            continue;
+        }
+        if (!executor) {
+            results.push({
+                ...base,
+                passed: false,
+                reason: `No command executor available to validate "${req.title}"`,
+            });
+            continue;
+        }
+        try {
+            const { exitCode, stdout } = await executor(req.validationCommand);
+            if (req.validationType === "metric") {
+                const measured = parseMetricValue(stdout);
+                const threshold = req.threshold ?? 0;
+                if (measured === null) {
+                    results.push({
+                        ...base,
+                        passed: false,
+                        reason: `Could not parse metric value from command output for "${req.title}"`,
+                        threshold,
+                    });
+                }
+                else {
+                    const passed = measured >= threshold;
+                    results.push({
+                        ...base,
+                        passed,
+                        reason: passed
+                            ? `Metric ${measured} meets threshold ${threshold}`
+                            : `Metric ${measured} below threshold ${threshold}`,
+                        measuredValue: measured,
+                        threshold,
+                    });
+                }
+            }
+            else {
+                // automated
+                results.push({
+                    ...base,
+                    passed: exitCode === 0,
+                    reason: exitCode === 0
+                        ? `Validation command passed`
+                        : `Validation command failed (exit code ${exitCode})`,
+                });
+            }
+        }
+        catch (err) {
+            results.push({
+                ...base,
+                passed: false,
+                reason: `Validation command error: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+    }
+    const passed = results.filter((r) => r.passed).length;
+    const failed = results.filter((r) => !r.passed && r.validationType !== "manual").length;
+    const manualReviewRequired = results.filter((r) => !r.passed && r.validationType === "manual").length;
+    return {
+        itemId,
+        allPassed: results.every((r) => r.passed),
+        total: results.length,
+        passed,
+        failed,
+        manualReviewRequired,
+        results,
+    };
+}
+/**
+ * Validate only automated and metric requirements (skip manual).
+ * This is the gate used by hench before task completion — manual
+ * requirements don't block automated task completion.
+ */
+export async function validateAutomatedRequirements(items, itemId, executor) {
+    const traced = collectRequirements(items, itemId).filter((tr) => tr.requirement.validationType !== "manual");
+    // Rebuild item list with only the target item's non-manual requirements
+    // We use the full validation flow but only on automated/metric requirements
+    const fullSummary = await validateRequirements(items, itemId, executor);
+    const automatedResults = fullSummary.results.filter((r) => r.validationType !== "manual");
+    const passed = automatedResults.filter((r) => r.passed).length;
+    const failed = automatedResults.filter((r) => !r.passed).length;
+    return {
+        itemId,
+        allPassed: automatedResults.every((r) => r.passed),
+        total: automatedResults.length,
+        passed,
+        failed,
+        manualReviewRequired: 0,
+        results: automatedResults,
+    };
+}
+// ── Formatting ────────────────────────────────────────────────────
+/**
+ * Format a validation summary as a human-readable string.
+ */
+export function formatRequirementsValidation(summary) {
+    if (summary.total === 0) {
+        return "No requirements to validate.";
+    }
+    const lines = [
+        `Requirements validation: ${summary.passed}/${summary.total} passed`,
+    ];
+    if (summary.manualReviewRequired > 0) {
+        lines.push(`Manual review needed: ${summary.manualReviewRequired}`);
+    }
+    for (const result of summary.results) {
+        const icon = result.passed ? "\u2713" : "\u2717";
+        lines.push(`  ${icon} [${result.validationType}] ${result.requirementTitle}: ${result.reason}`);
+    }
+    return lines.join("\n");
+}
+// ── Traceability ──────────────────────────────────────────────────
+/**
+ * Build a traceability matrix: for each requirement, list the items
+ * it applies to. Useful for audit and coverage reports.
+ */
+export function buildTraceabilityMatrix(items) {
+    const matrix = new Map();
+    for (const { item } of walkTree(items)) {
+        if (!item.requirements?.length)
+            continue;
+        for (const req of item.requirements) {
+            const existing = matrix.get(req.id);
+            if (existing) {
+                existing.appliesTo.push(item.id);
+            }
+            else {
+                matrix.set(req.id, {
+                    requirement: req,
+                    appliesTo: [item.id],
+                });
+            }
+        }
+    }
+    return matrix;
+}
+// ── Helpers ───────────────────────────────────────────────────────
+/**
+ * Parse a numeric value from command output.
+ * Looks for the last number in the output (supports decimals).
+ */
+function parseMetricValue(stdout) {
+    const trimmed = stdout.trim();
+    if (!trimmed)
+        return null;
+    // Try to parse the entire output as a number first
+    const direct = Number(trimmed);
+    if (!isNaN(direct) && isFinite(direct))
+        return direct;
+    // Fall back to extracting the last number from the output
+    const matches = trimmed.match(/-?\d+(?:\.\d+)?/g);
+    if (!matches || matches.length === 0)
+        return null;
+    const last = Number(matches[matches.length - 1]);
+    return isNaN(last) ? null : last;
+}
+//# sourceMappingURL=requirements.js.map

package/packages/rex/dist/core/requirements.js.map

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

package/packages/rex/dist/core/reshape.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Reshape operations for restructuring the PRD tree.
+ *
+ * Provides typed proposal actions (merge, update, reparent, obsolete, split)
+ * and an apply function that executes accepted proposals using existing
+ * tree primitives.
+ *
+ * @module core/reshape
+ */
+import type { PRDItem } from "../schema/index.js";
+export interface MergeAction {
+    action: "merge";
+    /** ID of the item that survives the merge. */
+    survivorId: string;
+    /** IDs of items to merge into the survivor (will be removed). */
+    mergedIds: string[];
+    /** Optional updated title for the survivor. */
+    title?: string;
+    /** Optional updated description for the survivor. */
+    description?: string;
+    reason: string;
+}
+export interface UpdateAction {
+    action: "update";
+    itemId: string;
+    updates: {
+        title?: string;
+        description?: string;
+        acceptanceCriteria?: string[];
+        priority?: string;
+    };
+    reason: string;
+}
+export interface ReparentAction {
+    action: "reparent";
+    itemId: string;
+    /** New parent ID, or undefined to move to root. */
+    newParentId?: string;
+    reason: string;
+}
+export interface ObsoleteAction {
+    action: "obsolete";
+    itemId: string;
+    reason: string;
+}
+export interface SplitAction {
+    action: "split";
+    /** ID of the item to split (will be removed). */
+    sourceId: string;
+    /** New children to create under the same parent. */
+    children: Array<{
+        title: string;
+        description?: string;
+        acceptanceCriteria?: string[];
+        priority?: string;
+        level: string;
+    }>;
+    reason: string;
+}
+export type ReshapeAction = MergeAction | UpdateAction | ReparentAction | ObsoleteAction | SplitAction;
+export interface ReshapeProposal {
+    /** Unique ID for this proposal (generated during parsing). */
+    id: string;
+    action: ReshapeAction;
+}
+export interface ReshapeResult {
+    applied: ReshapeProposal[];
+    /** IDs of items that were removed (for sync deletion tracking). */
+    deletedIds: string[];
+    /** Items that were archived (for archive persistence). */
+    archivedItems: PRDItem[];
+    errors: Array<{
+        proposal: ReshapeProposal;
+        error: string;
+    }>;
+}
+/**
+ * Apply a set of accepted reshape proposals to the PRD tree.
+ *
+ * Proposals are applied in order. Each uses existing tree primitives
+ * (updateInTree, removeFromTree, insertChild, moveItem). Failures on
+ * individual proposals are collected in `errors` without aborting.
+ *
+ * @param items - The mutable items array (modified in place)
+ * @param proposals - Accepted reshape proposals to apply
+ * @returns Result with applied proposals, deleted IDs, archived items, and errors
+ */
+export declare function applyReshape(items: PRDItem[], proposals: ReshapeProposal[]): ReshapeResult;

package/packages/rex/dist/core/reshape.js

@@ -0,0 +1,168 @@
+/**
+ * Reshape operations for restructuring the PRD tree.
+ *
+ * Provides typed proposal actions (merge, update, reparent, obsolete, split)
+ * and an apply function that executes accepted proposals using existing
+ * tree primitives.
+ *
+ * @module core/reshape
+ */
+import { randomUUID } from "node:crypto";
+import { findItem, removeFromTree, updateInTree, insertChild } from "./tree.js";
+import { moveItem } from "./move.js";
+// ── Apply logic ──
+function applyMerge(items, action, result, proposal) {
+    const survivorEntry = findItem(items, action.survivorId);
+    if (!survivorEntry) {
+        result.errors.push({ proposal, error: `Survivor item "${action.survivorId}" not found.` });
+        return;
+    }
+    // Update survivor with merged info
+    const updates = {};
+    if (action.title)
+        updates.title = action.title;
+    if (action.description)
+        updates.description = action.description;
+    updateInTree(items, action.survivorId, updates);
+    // Remove merged items and collect children to reparent
+    for (const mergedId of action.mergedIds) {
+        const mergedEntry = findItem(items, mergedId);
+        if (!mergedEntry) {
+            result.errors.push({ proposal, error: `Merged item "${mergedId}" not found, skipping.` });
+            continue;
+        }
+        // Reparent children of merged item to survivor before removing
+        const mergedItem = mergedEntry.item;
+        if (mergedItem.children && mergedItem.children.length > 0) {
+            for (const child of [...mergedItem.children]) {
+                removeFromTree(items, child.id);
+                if (!survivorEntry.item.children)
+                    survivorEntry.item.children = [];
+                survivorEntry.item.children.push(child);
+            }
+        }
+        const removed = removeFromTree(items, mergedId);
+        if (removed) {
+            // Clear children since they were reparented
+            removed.children = [];
+            result.archivedItems.push(removed);
+            result.deletedIds.push(mergedId);
+        }
+    }
+    result.applied.push(proposal);
+}
+function applyUpdate(items, action, result, proposal) {
+    const entry = findItem(items, action.itemId);
+    if (!entry) {
+        result.errors.push({ proposal, error: `Item "${action.itemId}" not found.` });
+        return;
+    }
+    const updates = {};
+    if (action.updates.title)
+        updates.title = action.updates.title;
+    if (action.updates.description)
+        updates.description = action.updates.description;
+    if (action.updates.acceptanceCriteria)
+        updates.acceptanceCriteria = action.updates.acceptanceCriteria;
+    if (action.updates.priority)
+        updates.priority = action.updates.priority;
+    updateInTree(items, action.itemId, updates);
+    result.applied.push(proposal);
+}
+function applyReparent(items, action, result, proposal) {
+    try {
+        moveItem(items, action.itemId, action.newParentId);
+        result.applied.push(proposal);
+    }
+    catch (err) {
+        result.errors.push({ proposal, error: err.message });
+    }
+}
+function applyObsolete(items, action, result, proposal) {
+    const entry = findItem(items, action.itemId);
+    if (!entry) {
+        result.errors.push({ proposal, error: `Item "${action.itemId}" not found.` });
+        return;
+    }
+    updateInTree(items, action.itemId, { status: "deferred" });
+    result.applied.push(proposal);
+}
+function applySplit(items, action, result, proposal) {
+    const entry = findItem(items, action.sourceId);
+    if (!entry) {
+        result.errors.push({ proposal, error: `Source item "${action.sourceId}" not found.` });
+        return;
+    }
+    const parentId = entry.parents.length > 0
+        ? entry.parents[entry.parents.length - 1].id
+        : undefined;
+    // Create new children
+    for (const child of action.children) {
+        const newItem = {
+            id: randomUUID(),
+            title: child.title,
+            level: child.level,
+            status: "pending",
+            description: child.description,
+            acceptanceCriteria: child.acceptanceCriteria,
+            priority: child.priority,
+        };
+        if (parentId) {
+            const inserted = insertChild(items, parentId, newItem);
+            if (!inserted) {
+                // Fall back to root if hierarchy doesn't allow
+                items.push(newItem);
+            }
+        }
+        else {
+            items.push(newItem);
+        }
+    }
+    // Remove the source item
+    const removed = removeFromTree(items, action.sourceId);
+    if (removed) {
+        result.archivedItems.push(removed);
+        result.deletedIds.push(action.sourceId);
+    }
+    result.applied.push(proposal);
+}
+/**
+ * Apply a set of accepted reshape proposals to the PRD tree.
+ *
+ * Proposals are applied in order. Each uses existing tree primitives
+ * (updateInTree, removeFromTree, insertChild, moveItem). Failures on
+ * individual proposals are collected in `errors` without aborting.
+ *
+ * @param items - The mutable items array (modified in place)
+ * @param proposals - Accepted reshape proposals to apply
+ * @returns Result with applied proposals, deleted IDs, archived items, and errors
+ */
+export function applyReshape(items, proposals) {
+    const result = {
+        applied: [],
+        deletedIds: [],
+        archivedItems: [],
+        errors: [],
+    };
+    for (const proposal of proposals) {
+        switch (proposal.action.action) {
+            case "merge":
+                applyMerge(items, proposal.action, result, proposal);
+                break;
+            case "update":
+                applyUpdate(items, proposal.action, result, proposal);
+                break;
+            case "reparent":
+                applyReparent(items, proposal.action, result, proposal);
+                break;
+            case "obsolete":
+                applyObsolete(items, proposal.action, result, proposal);
+                break;
+            case "split":
+                applySplit(items, proposal.action, result, proposal);
+                break;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=reshape.js.map

package/packages/rex/dist/core/reshape.js.map

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