@n-dx/core 0.1.0

package/packages/sourcevision/dist/analyzers/branch-work-classifier.js.map

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

package/packages/sourcevision/dist/analyzers/branch-work-collector.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Branch work collector — identifies completed rex PRD items on the current branch.
+ *
+ * ## Architecture
+ *
+ * Sourcevision and rex are peer domain packages that **never import each other
+ * at runtime**. This module reads `.rex/prd.json` directly from the filesystem
+ * (and from git history) using lightweight local type definitions that mirror
+ * the rex PRDItem shape. No `import from "rex"` exists here.
+ *
+ * ## Algorithm
+ *
+ * 1. Read the current PRD from `.rex/prd.json` on disk.
+ * 2. Detect the base branch (main or master) and read its PRD via `git show`.
+ * 3. Diff: completed IDs on current branch minus completed IDs on base branch.
+ * 4. Build enriched work items with parent chain and epic summaries.
+ *
+ * When git is unavailable (non-repo directory), all completed items in the
+ * current PRD are returned — the service degrades gracefully rather than
+ * failing.
+ *
+ * @module sourcevision/analyzers/branch-work-collector
+ */
+/** Minimal PRDItem shape needed for collection. */
+interface PRDItemShape {
+    id: string;
+    title: string;
+    status: string;
+    level: string;
+    description?: string;
+    acceptanceCriteria?: string[];
+    completedAt?: string;
+    priority?: string;
+    tags?: string[];
+    children?: PRDItemShape[];
+}
+/** Minimal PRDDocument shape. */
+interface PRDDocumentShape {
+    schema: string;
+    title: string;
+    items: PRDItemShape[];
+}
+/** Reference to an ancestor in the PRD hierarchy. */
+export interface ParentRef {
+    id: string;
+    title: string;
+    level: string;
+}
+/** A completed work item attributed to the current branch. */
+export interface BranchWorkItem {
+    id: string;
+    title: string;
+    level: string;
+    completedAt?: string;
+    priority?: string;
+    tags?: string[];
+    description?: string;
+    acceptanceCriteria?: string[];
+    parentChain: ParentRef[];
+}
+/** Per-epic summary of branch work. */
+export interface EpicSummary {
+    id: string;
+    title: string;
+    completedCount: number;
+}
+/** Full result from the collector. */
+export interface BranchWorkResult {
+    /** Current branch name (or "unknown" when git is unavailable). */
+    branch: string;
+    /** Base branch used for diffing (e.g. "main", "master"). */
+    baseBranch: string;
+    /** ISO timestamp when the collection was performed. */
+    collectedAt: string;
+    /** Completed work items unique to this branch. */
+    items: BranchWorkItem[];
+    /** Per-epic aggregation of branch-specific completions. */
+    epicSummaries?: EpicSummary[];
+    /** Non-fatal errors encountered during collection. */
+    errors?: string[];
+}
+/** Options for the collector. */
+export interface CollectorOptions {
+    /** Project root directory. */
+    dir: string;
+    /** Base branch to diff against. Auto-detected when omitted. */
+    baseBranch?: string;
+}
+/**
+ * Parse a JSON string into a PRD document shape.
+ * Returns null if the input is empty, malformed, or lacks an `items` array.
+ */
+export declare function parsePRDDocument(raw: string): PRDDocumentShape | null;
+/**
+ * Compute the set of item IDs completed on the current branch but not on the base.
+ *
+ * @param currentItems - PRD items from the current branch
+ * @param baseItems    - PRD items from the base branch (empty array if unavailable)
+ * @returns Set of item IDs uniquely completed on the current branch
+ */
+export declare function diffCompletedItems(currentItems: PRDItemShape[], baseItems: PRDItemShape[]): Set<string>;
+/**
+ * Build enriched BranchWorkItem records for the given set of IDs.
+ * Traverses the full tree to reconstruct parent chains.
+ *
+ * @param items     - Full PRD item tree
+ * @param branchIds - Set of IDs to include in the result
+ */
+export declare function buildBranchWorkItems(items: PRDItemShape[], branchIds: Set<string>): BranchWorkItem[];
+/**
+ * Collect completed work items on the current branch that are not
+ * present on the base branch.
+ *
+ * Gracefully handles:
+ * - Non-git directories (returns all completed items)
+ * - Missing `.rex/prd.json` (returns empty result)
+ * - Corrupted PRD JSON (returns empty result with error)
+ * - Missing base branch (falls back to treating all completions as branch work)
+ */
+export declare function collectBranchWork(options: CollectorOptions): Promise<BranchWorkResult>;
+export {};

package/packages/sourcevision/dist/analyzers/branch-work-collector.js

@@ -0,0 +1,301 @@
+/**
+ * Branch work collector — identifies completed rex PRD items on the current branch.
+ *
+ * ## Architecture
+ *
+ * Sourcevision and rex are peer domain packages that **never import each other
+ * at runtime**. This module reads `.rex/prd.json` directly from the filesystem
+ * (and from git history) using lightweight local type definitions that mirror
+ * the rex PRDItem shape. No `import from "rex"` exists here.
+ *
+ * ## Algorithm
+ *
+ * 1. Read the current PRD from `.rex/prd.json` on disk.
+ * 2. Detect the base branch (main or master) and read its PRD via `git show`.
+ * 3. Diff: completed IDs on current branch minus completed IDs on base branch.
+ * 4. Build enriched work items with parent chain and epic summaries.
+ *
+ * When git is unavailable (non-repo directory), all completed items in the
+ * current PRD are returned — the service degrades gracefully rather than
+ * failing.
+ *
+ * @module sourcevision/analyzers/branch-work-collector
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+import { join, resolve } from "node:path";
+import { getCurrentBranch, PROJECT_DIRS } from "@n-dx/llm-client";
+// ---------------------------------------------------------------------------
+// Pure helpers (exported for unit testing)
+// ---------------------------------------------------------------------------
+/**
+ * Parse a JSON string into a PRD document shape.
+ * Returns null if the input is empty, malformed, or lacks an `items` array.
+ */
+export 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;
+    }
+}
+/**
+ * Walk the PRD tree and collect IDs of completed items.
+ */
+function collectCompletedIds(items) {
+    const ids = new Set();
+    function walk(list) {
+        for (const item of list) {
+            if (item.status === "completed") {
+                ids.add(item.id);
+            }
+            if (item.children) {
+                walk(item.children);
+            }
+        }
+    }
+    walk(items);
+    return ids;
+}
+/**
+ * Compute the set of item IDs completed on the current branch but not on the base.
+ *
+ * @param currentItems - PRD items from the current branch
+ * @param baseItems    - PRD items from the base branch (empty array if unavailable)
+ * @returns Set of item IDs uniquely completed on the current branch
+ */
+export function diffCompletedItems(currentItems, baseItems) {
+    const currentCompleted = collectCompletedIds(currentItems);
+    const baseCompleted = collectCompletedIds(baseItems);
+    const branchSpecific = new Set();
+    for (const id of currentCompleted) {
+        if (!baseCompleted.has(id)) {
+            branchSpecific.add(id);
+        }
+    }
+    return branchSpecific;
+}
+/**
+ * Build enriched BranchWorkItem records for the given set of IDs.
+ * Traverses the full tree to reconstruct parent chains.
+ *
+ * @param items     - Full PRD item tree
+ * @param branchIds - Set of IDs to include in the result
+ */
+export function buildBranchWorkItems(items, branchIds) {
+    if (branchIds.size === 0)
+        return [];
+    const result = [];
+    function walk(list, parents) {
+        for (const item of list) {
+            if (branchIds.has(item.id)) {
+                result.push({
+                    id: item.id,
+                    title: item.title,
+                    level: item.level,
+                    ...(item.completedAt !== undefined && { completedAt: item.completedAt }),
+                    ...(item.priority !== undefined && { priority: item.priority }),
+                    ...(item.tags !== undefined && { tags: item.tags }),
+                    ...(item.description !== undefined && { description: item.description }),
+                    ...(item.acceptanceCriteria !== undefined && { acceptanceCriteria: item.acceptanceCriteria }),
+                    parentChain: [...parents],
+                });
+            }
+            if (item.children) {
+                walk(item.children, [
+                    ...parents,
+                    { id: item.id, title: item.title, level: item.level },
+                ]);
+            }
+        }
+    }
+    walk(items, []);
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Git helpers (internal)
+// ---------------------------------------------------------------------------
+/**
+ * Read a file from a specific git ref.
+ * Returns null if the file doesn't exist on that ref or git fails.
+ */
+function gitShowFile(dir, ref, filePath) {
+    try {
+        return execFileSync("git", ["show", `${ref}:${filePath}`], {
+            cwd: dir,
+            encoding: "utf-8",
+            // Suppress stderr for expected failures (file not found on ref)
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check whether a git branch exists locally.
+ */
+function branchExists(dir, branch) {
+    try {
+        execFileSync("git", ["rev-parse", "--verify", branch], {
+            cwd: dir,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Detect whether this directory is inside a git repository.
+ */
+function isGitRepo(dir) {
+    try {
+        execFileSync("git", ["rev-parse", "--git-dir"], {
+            cwd: dir,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Auto-detect the base branch: prefers "main", falls back to "master".
+ * Returns "main" as default when neither exists (covers first-ever branch).
+ */
+function detectBaseBranch(dir) {
+    if (branchExists(dir, "main"))
+        return "main";
+    if (branchExists(dir, "master"))
+        return "master";
+    return "main";
+}
+// ---------------------------------------------------------------------------
+// Epic summary builder
+// ---------------------------------------------------------------------------
+/**
+ * Build per-epic summaries for branch-specific completed items.
+ * Groups items by their top-level epic ancestor.
+ */
+function buildEpicSummaries(items, branchIds) {
+    const summaryMap = new Map();
+    function countInSubtree(item, epicId, epicTitle) {
+        if (branchIds.has(item.id) && item.level !== "epic") {
+            const existing = summaryMap.get(epicId);
+            if (existing) {
+                existing.count++;
+            }
+            else {
+                summaryMap.set(epicId, { title: epicTitle, count: 1 });
+            }
+        }
+        if (item.children) {
+            for (const child of item.children) {
+                countInSubtree(child, epicId, epicTitle);
+            }
+        }
+    }
+    for (const item of items) {
+        if (item.level === "epic") {
+            countInSubtree(item, item.id, item.title);
+        }
+    }
+    return Array.from(summaryMap.entries()).map(([id, { title, count }]) => ({
+        id,
+        title,
+        completedCount: count,
+    }));
+}
+// ---------------------------------------------------------------------------
+// Main collector
+// ---------------------------------------------------------------------------
+/**
+ * Collect completed work items on the current branch that are not
+ * present on the base branch.
+ *
+ * Gracefully handles:
+ * - Non-git directories (returns all completed items)
+ * - Missing `.rex/prd.json` (returns empty result)
+ * - Corrupted PRD JSON (returns empty result with error)
+ * - Missing base branch (falls back to treating all completions as branch work)
+ */
+export async function collectBranchWork(options) {
+    const dir = resolve(options.dir);
+    const errors = [];
+    const now = new Date().toISOString();
+    // ── 1. Determine branch context ──────────────────────────────
+    const gitAvailable = isGitRepo(dir);
+    const branch = gitAvailable ? (getCurrentBranch(dir) ?? "unknown") : "unknown";
+    const baseBranch = options.baseBranch ?? (gitAvailable ? detectBaseBranch(dir) : "main");
+    // ── 2. Read current PRD from disk ────────────────────────────
+    const prdPath = join(dir, PROJECT_DIRS.REX, "prd.json");
+    let currentDoc = null;
+    if (existsSync(prdPath)) {
+        try {
+            const raw = readFileSync(prdPath, "utf-8");
+            currentDoc = parsePRDDocument(raw);
+            if (!currentDoc) {
+                errors.push("Current PRD file exists but could not be parsed");
+            }
+        }
+        catch (err) {
+            errors.push(`Failed to read current PRD: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    if (!currentDoc) {
+        return {
+            branch,
+            baseBranch,
+            collectedAt: now,
+            items: [],
+            ...(errors.length > 0 && { errors }),
+        };
+    }
+    // ── 3. Read base branch PRD from git history ─────────────────
+    let baseDoc = null;
+    if (gitAvailable && branch !== baseBranch) {
+        const rexRelPath = `${PROJECT_DIRS.REX}/prd.json`;
+        const baseRaw = gitShowFile(dir, baseBranch, rexRelPath);
+        if (baseRaw) {
+            baseDoc = parsePRDDocument(baseRaw);
+            if (!baseDoc) {
+                errors.push(`Base branch PRD (${baseBranch}) exists but could not be parsed`);
+            }
+        }
+        // If baseRaw is null, the file doesn't exist on base — that's fine,
+        // all current completions are considered branch work.
+    }
+    else if (gitAvailable && branch === baseBranch) {
+        // Running on the base branch itself — diff against itself yields nothing
+        return {
+            branch,
+            baseBranch,
+            collectedAt: now,
+            items: [],
+        };
+    }
+    // ── 4. Diff completed items ──────────────────────────────────
+    const baseItems = baseDoc?.items ?? [];
+    const branchIds = diffCompletedItems(currentDoc.items, baseItems);
+    // ── 5. Build enriched results ────────────────────────────────
+    const items = buildBranchWorkItems(currentDoc.items, branchIds);
+    const epicSummaries = buildEpicSummaries(currentDoc.items, branchIds);
+    return {
+        branch,
+        baseBranch,
+        collectedAt: now,
+        items,
+        ...(epicSummaries.length > 0 && { epicSummaries }),
+        ...(errors.length > 0 && { errors }),
+    };
+}
+//# sourceMappingURL=branch-work-collector.js.map

package/packages/sourcevision/dist/analyzers/branch-work-collector.js.map

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

package/packages/sourcevision/dist/analyzers/branch-work-filter.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Branch-scoped work item filter — identifies which rex work items are
+ * relevant to the current branch based on git branch metadata and work
+ * item timestamps.
+ *
+ * ## Architecture
+ *
+ * Follows the same patterns as the sibling modules (`branch-work-collector`,
+ * `branch-work-classifier`):
+ *
+ * - **Pure functions** for filtering logic (no I/O, no side effects)
+ * - **Git helper** for detecting branch lifecycle metadata
+ * - **Graceful degradation** when git is unavailable or timestamps are missing
+ *
+ * ## Filtering Strategy
+ *
+ * 1. Determine the branch lifecycle: creation timestamp (via `git merge-base`),
+ *    branch naming pattern, and base branch.
+ * 2. Filter work items by timestamp: only items completed *on or after* the
+ *    branch creation time are considered relevant to the branch.
+ * 3. Exclude items when on main/master (no branch work on the base branch).
+ * 4. When the branch creation timestamp is unavailable, include all items
+ *    (graceful degradation).
+ *
+ * ## Branch pattern support
+ *
+ * Recognizes standard Git Flow and trunk-based patterns:
+ * - `feature/`, `feat/` → feature
+ * - `hotfix/` → hotfix
+ * - `bugfix/`, `fix/` → bugfix
+ * - `release/` → release
+ * - `main`, `master` → main
+ *
+ * @module sourcevision/analyzers/branch-work-filter
+ */
+import type { BranchWorkRecordItem } from "../schema/v1.js";
+/** Recognized branch naming patterns. */
+export type BranchPattern = "feature" | "hotfix" | "bugfix" | "release" | "main" | "other";
+/** Metadata about the current branch's lifecycle. */
+export interface BranchLifecycle {
+    /** Current branch name. */
+    branchName: string;
+    /** Base branch used for comparison (e.g. "main", "master"). */
+    baseBranch: string;
+    /**
+     * ISO timestamp of the branch creation point (merge-base with the base
+     * branch). Null when git is unavailable or the merge-base cannot be
+     * determined.
+     */
+    createdAt: string | null;
+    /** Classified branch naming pattern. */
+    pattern: BranchPattern;
+}
+/** Why an item was excluded from branch-scoped results. */
+export type ExclusionReason = "before_branch_creation" | "on_main_branch" | "invalid_timestamp";
+/** An excluded item with the reason for exclusion. */
+export interface ExcludedItem {
+    /** PRD item ID. */
+    id: string;
+    /** Human-readable title. */
+    title: string;
+    /** Why this item was excluded. */
+    reason: ExclusionReason;
+}
+/** Result of filtering work items by branch scope. */
+export interface BranchFilterResult {
+    /** Items that fall within the branch lifecycle. */
+    included: BranchWorkRecordItem[];
+    /** Items excluded from the branch scope with reasons. */
+    excluded: ExcludedItem[];
+    /** Branch lifecycle metadata used for filtering. */
+    lifecycle: BranchLifecycle;
+}
+/**
+ * Classify a branch name into a recognized pattern.
+ *
+ * Case-insensitive matching against common Git Flow and trunk-based
+ * conventions.
+ *
+ * @param branchName - Git branch name (e.g. "feature/add-auth")
+ * @returns The classified pattern
+ */
+export declare function classifyBranchPattern(branchName: string): BranchPattern;
+/**
+ * Determine whether a work item's completion timestamp falls within the
+ * branch lifecycle (on or after branch creation).
+ *
+ * Graceful degradation:
+ * - When `branchCreatedAt` is null or invalid → returns true (include the item)
+ * - When `completedAt` is empty or invalid → returns false (exclude the item)
+ *
+ * @param completedAt      - ISO timestamp of item completion
+ * @param branchCreatedAt  - ISO timestamp of branch creation (null if unknown)
+ */
+export declare function isWithinBranchLifecycle(completedAt: string, branchCreatedAt: string | null): boolean;
+/**
+ * Filter work items to only those relevant to the given branch lifecycle.
+ *
+ * Pure function — no I/O, no side effects. Does not mutate input arrays.
+ *
+ * Rules:
+ * 1. If the branch pattern is "main", all items are excluded (no branch work
+ *    on the base branch itself).
+ * 2. Items with completedAt on or after the branch creation are included.
+ * 3. Items with completedAt before branch creation are excluded.
+ * 4. Items with invalid timestamps are excluded.
+ * 5. When branch creation time is unknown, all items are included.
+ *
+ * @param items     - Work items to filter
+ * @param lifecycle - Branch lifecycle metadata
+ */
+export declare function filterItemsByBranchScope(items: readonly BranchWorkRecordItem[], lifecycle: BranchLifecycle): BranchFilterResult;