@n-dx/core 0.1.0

package/packages/sourcevision/dist/analyzers/completion-reader.js

@@ -0,0 +1,355 @@
+/**
+ * Rex PRD completion status reader — extracts completion state, timestamps,
+ * and metadata from the rex PRD for branch work tracking.
+ *
+ * ## Architecture
+ *
+ * Like `branch-work-collector`, this module reads `.rex/prd.json` directly
+ * from the filesystem using lightweight local type definitions. No runtime
+ * import from rex exists here — the domain isolation boundary is preserved.
+ *
+ * ## Purpose
+ *
+ * While the collector focuses on *which* items were completed on a branch,
+ * the completion reader provides a richer view of the *completion state*:
+ *
+ * - Per-item completion metadata (status, timestamps, duration)
+ * - Aggregate completion statistics (by level, overall percentage)
+ * - Chronological completion timeline
+ * - Data integrity checks (inconsistent timestamps/statuses)
+ *
+ * ## Graceful degradation
+ *
+ * Missing files, corrupted JSON, and invalid data are handled without
+ * throwing. Non-fatal errors are collected in an `errors` array on the
+ * result, and partial results are returned wherever possible.
+ *
+ * @module sourcevision/analyzers/completion-reader
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { PROJECT_DIRS } from "@n-dx/llm-client";
+// ---------------------------------------------------------------------------
+// Internal parser
+// ---------------------------------------------------------------------------
+/**
+ * Parse a JSON string into a PRD document shape.
+ * Returns null if the input is empty, malformed, or lacks an `items` array.
+ *
+ * This is a local copy of the parsing logic from `branch-work-collector`
+ * so that the returned type includes `startedAt` (needed for duration
+ * calculations). The collector's version omits `startedAt` because it
+ * only cares about completed items.
+ */
+function parsePRDDocument(raw) {
+    if (!raw || !raw.trim())
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || !Array.isArray(parsed.items))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Pure helpers (exported for unit testing)
+// ---------------------------------------------------------------------------
+/**
+ * Compute the duration between two ISO timestamp strings in milliseconds.
+ * Returns null if either timestamp is missing or produces an invalid date.
+ */
+function computeDuration(startedAt, completedAt) {
+    if (!startedAt || !completedAt)
+        return null;
+    const start = new Date(startedAt).getTime();
+    const end = new Date(completedAt).getTime();
+    if (Number.isNaN(start) || Number.isNaN(end))
+        return null;
+    return end - start;
+}
+/**
+ * Extract completion state for a single PRD item.
+ *
+ * @param item    - PRD item to extract completion state from
+ * @param parents - Optional ancestor chain (from root to parent)
+ */
+export function extractItemCompletion(item, parents = []) {
+    const typed = item;
+    return {
+        id: typed.id,
+        title: typed.title,
+        status: typed.status,
+        level: typed.level,
+        ...(typed.startedAt !== undefined && { startedAt: typed.startedAt }),
+        ...(typed.completedAt !== undefined && { completedAt: typed.completedAt }),
+        durationMs: computeDuration(typed.startedAt, typed.completedAt),
+        ...(typed.priority !== undefined && { priority: typed.priority }),
+        ...(typed.tags !== undefined && { tags: typed.tags }),
+        parentChain: [...parents],
+    };
+}
+/**
+ * Walk the PRD tree and collect completion states for all items.
+ * Optionally filters to only include items in the given ID set.
+ */
+function walkAndExtract(items, itemIds) {
+    const result = [];
+    function walk(list, parents) {
+        for (const item of list) {
+            if (!itemIds || itemIds.has(item.id)) {
+                result.push(extractItemCompletion(item, parents));
+            }
+            if (item.children) {
+                walk(item.children, [
+                    ...parents,
+                    { id: item.id, title: item.title, level: item.level },
+                ]);
+            }
+        }
+    }
+    walk(items, []);
+    return result;
+}
+/**
+ * Compute aggregate completion statistics for a PRD tree.
+ *
+ * Follows rex's convention: `total` counts only tasks and subtasks
+ * (epics and features are containers, not work units). Deleted items
+ * are tracked separately and excluded from the total.
+ *
+ * @param items - Top-level PRD items (with nested children)
+ */
+export function computeCompletionStats(items) {
+    const stats = {
+        total: 0,
+        completed: 0,
+        inProgress: 0,
+        pending: 0,
+        failing: 0,
+        deferred: 0,
+        blocked: 0,
+        deleted: 0,
+        percentComplete: 0,
+        byLevel: {},
+    };
+    function ensureLevel(level) {
+        if (!stats.byLevel[level]) {
+            stats.byLevel[level] = { total: 0, completed: 0 };
+        }
+    }
+    function walk(list) {
+        for (const item of list) {
+            const level = item.level;
+            const status = item.status;
+            const isWorkItem = level === "task" || level === "subtask";
+            ensureLevel(level);
+            // Track per-level counts (all levels)
+            if (status !== "deleted") {
+                stats.byLevel[level].total++;
+                if (status === "completed") {
+                    stats.byLevel[level].completed++;
+                }
+            }
+            // Track work-item stats (tasks + subtasks only, matching rex)
+            if (isWorkItem) {
+                if (status === "deleted") {
+                    stats.deleted++;
+                }
+                else {
+                    stats.total++;
+                    switch (status) {
+                        case "completed":
+                            stats.completed++;
+                            break;
+                        case "in_progress":
+                            stats.inProgress++;
+                            break;
+                        case "pending":
+                            stats.pending++;
+                            break;
+                        case "failing":
+                            stats.failing++;
+                            break;
+                        case "deferred":
+                            stats.deferred++;
+                            break;
+                        case "blocked":
+                            stats.blocked++;
+                            break;
+                    }
+                }
+            }
+            if (item.children) {
+                walk(item.children);
+            }
+        }
+    }
+    walk(items);
+    stats.percentComplete =
+        stats.total > 0 ? (stats.completed / stats.total) * 100 : 0;
+    return stats;
+}
+/**
+ * Detect data inconsistencies in completion timestamps and statuses.
+ *
+ * Checks for:
+ * - `missing_completed_at`: item has status "completed" but no completedAt
+ * - `stale_completed_at`: item has completedAt but status is not "completed"
+ * - `completed_before_started`: completedAt is earlier than startedAt
+ *
+ * @param items - Top-level PRD items (with nested children)
+ */
+export function detectInconsistencies(items) {
+    const issues = [];
+    function walk(list) {
+        for (const item of list) {
+            // Completed without completedAt
+            if (item.status === "completed" && !item.completedAt) {
+                issues.push({
+                    itemId: item.id,
+                    itemTitle: item.title,
+                    type: "missing_completed_at",
+                    message: `Item "${item.title}" is completed but has no completedAt timestamp`,
+                });
+            }
+            // Non-completed with stale completedAt
+            if (item.status !== "completed" && item.completedAt) {
+                issues.push({
+                    itemId: item.id,
+                    itemTitle: item.title,
+                    type: "stale_completed_at",
+                    message: `Item "${item.title}" has completedAt but status is "${item.status}"`,
+                });
+            }
+            // completedAt before startedAt
+            if (item.startedAt && item.completedAt) {
+                const start = new Date(item.startedAt).getTime();
+                const end = new Date(item.completedAt).getTime();
+                if (!Number.isNaN(start) && !Number.isNaN(end) && end < start) {
+                    issues.push({
+                        itemId: item.id,
+                        itemTitle: item.title,
+                        type: "completed_before_started",
+                        message: `Item "${item.title}" has completedAt (${item.completedAt}) before startedAt (${item.startedAt})`,
+                    });
+                }
+            }
+            if (item.children) {
+                walk(item.children);
+            }
+        }
+    }
+    walk(items);
+    return issues;
+}
+/**
+ * Build a chronological timeline of completed items.
+ *
+ * Items are sorted by `completedAt` ascending. Items without a
+ * `completedAt` timestamp are placed at the end of the timeline.
+ *
+ * @param items - Top-level PRD items (with nested children)
+ */
+export function computeCompletionTimeline(items) {
+    const entries = [];
+    function walk(list) {
+        for (const item of list) {
+            if (item.status === "completed") {
+                entries.push({
+                    id: item.id,
+                    title: item.title,
+                    level: item.level,
+                    ...(item.completedAt !== undefined && { completedAt: item.completedAt }),
+                });
+            }
+            if (item.children) {
+                walk(item.children);
+            }
+        }
+    }
+    walk(items);
+    // Sort by completedAt ascending; items without completedAt go to the end
+    entries.sort((a, b) => {
+        if (!a.completedAt && !b.completedAt)
+            return 0;
+        if (!a.completedAt)
+            return 1;
+        if (!b.completedAt)
+            return -1;
+        return a.completedAt.localeCompare(b.completedAt);
+    });
+    // Compute earliest/latest
+    const withTimestamp = entries.filter((e) => e.completedAt);
+    const earliest = withTimestamp.length > 0 ? withTimestamp[0].completedAt : undefined;
+    const latest = withTimestamp.length > 0 ? withTimestamp[withTimestamp.length - 1].completedAt : undefined;
+    return { entries, earliest, latest };
+}
+// ---------------------------------------------------------------------------
+// Main reader
+// ---------------------------------------------------------------------------
+/**
+ * Read completion status from the rex PRD file.
+ *
+ * This is the primary entry point for extracting completion metadata
+ * from `.rex/prd.json`. It composes the pure helper functions above
+ * into a single read-only operation.
+ *
+ * Gracefully handles:
+ * - Missing `.rex/prd.json` (returns empty result)
+ * - Corrupted PRD JSON (returns empty result with error)
+ * - Invalid timestamps (flags inconsistencies)
+ *
+ * @param options - Reader configuration
+ * @returns Full completion status result
+ */
+export async function readCompletionStatus(options) {
+    const dir = resolve(options.dir);
+    const errors = [];
+    const now = new Date().toISOString();
+    const emptyResult = {
+        readAt: now,
+        items: [],
+        stats: computeCompletionStats([]),
+        timeline: { entries: [] },
+        inconsistencies: [],
+    };
+    // ── 1. Read current PRD from disk ────────────────────────────
+    const prdPath = join(dir, PROJECT_DIRS.REX, "prd.json");
+    if (!existsSync(prdPath)) {
+        return emptyResult;
+    }
+    let rawPRD;
+    try {
+        rawPRD = readFileSync(prdPath, "utf-8");
+    }
+    catch (err) {
+        errors.push(`Failed to read PRD: ${err instanceof Error ? err.message : String(err)}`);
+        return { ...emptyResult, errors };
+    }
+    const doc = parsePRDDocument(rawPRD);
+    if (!doc) {
+        errors.push("PRD file exists but could not be parsed");
+        return { ...emptyResult, errors };
+    }
+    // ── 2. Extract completion states ─────────────────────────────
+    const items = walkAndExtract(doc.items, options.itemIds);
+    // ── 3. Compute stats (always over full tree, not filtered) ───
+    const stats = computeCompletionStats(doc.items);
+    // ── 4. Build timeline (from full tree) ───────────────────────
+    const timeline = computeCompletionTimeline(doc.items);
+    // ── 5. Detect inconsistencies (from full tree) ───────────────
+    const inconsistencies = detectInconsistencies(doc.items);
+    return {
+        prdTitle: doc.title,
+        readAt: now,
+        items,
+        stats,
+        timeline,
+        inconsistencies,
+        ...(errors.length > 0 && { errors }),
+    };
+}
+//# sourceMappingURL=completion-reader.js.map

package/packages/sourcevision/dist/analyzers/completion-reader.js.map

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

package/packages/sourcevision/dist/analyzers/components.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Component & route analyzer.
+ * Single AST pass over JSX/TSX files for component definitions,
+ * JSX usage graph, and React Router v7 / Remix route detection.
+ */
+import type { ComponentDefinition, RouteExportKind, Components, Inventory, Imports } from "../schema/index.js";
+export declare function extractComponentDefinitions(sourceText: string, filePath: string): ComponentDefinition[];
+export declare function extractJsxUsages(sourceText: string, filePath: string): Array<{
+    componentName: string;
+    count: number;
+}>;
+export declare function extractConventionExports(sourceText: string, filePath: string): RouteExportKind[];
+export interface ComponentsOptions {
+    previousComponents?: Components;
+    changedFiles?: Set<string>;
+    fileSetChanged?: boolean;
+}
+export declare function analyzeComponents(targetDir: string, inventory: Inventory, imports: Imports, options?: ComponentsOptions): Promise<Components>;