@n-dx/core 0.1.0

package/packages/sourcevision/dist/generators/pr-markdown-template.js

@@ -0,0 +1,264 @@
+/**
+ * Rex-based PR markdown template generator.
+ *
+ * Transforms a {@link BranchWorkRecord} into a PR-ready markdown document
+ * structured around completed epics, features, and significant changes
+ * rather than raw git diffs.
+ *
+ * Content is prioritized by significance: breaking changes appear first
+ * (high-visibility), followed by major changes, then the full completed
+ * work listing sorted by significance within each feature group.
+ *
+ * All functions are pure — no I/O, no side effects.
+ *
+ * @module sourcevision/generators/pr-markdown-template
+ */
+// ── Significance ordering ───────────────────────────────────────────────────
+const SIGNIFICANCE_ORDER = {
+    major: 0,
+    minor: 1,
+    patch: 2,
+};
+/** Default significance for items without explicit classification. */
+const DEFAULT_SIGNIFICANCE = "patch";
+// ── Helpers ─────────────────────────────────────────────────────────────────
+/**
+ * Groups items by their root epic ancestor title.
+ * Items without an epic in their parentChain land under `"(Ungrouped)"`.
+ */
+export function groupItemsByEpic(items) {
+    const grouped = new Map();
+    for (const item of items) {
+        const epicRef = item.parentChain.find((ref) => ref.level === "epic");
+        const key = epicRef?.title ?? "(Ungrouped)";
+        const group = grouped.get(key) ?? [];
+        group.push(item);
+        grouped.set(key, group);
+    }
+    return grouped;
+}
+/** Returns items flagged as breaking changes. */
+export function extractBreakingChanges(items) {
+    return items.filter((item) => item.breakingChange === true);
+}
+/** Returns items with `changeSignificance === "major"`. */
+export function extractMajorChanges(items) {
+    return items.filter((item) => item.changeSignificance === "major");
+}
+/** Returns items with `changeSignificance === "minor"`. */
+export function extractMinorChanges(items) {
+    return items.filter((item) => item.changeSignificance === "minor");
+}
+/**
+ * Sort items by change significance (major → minor → patch).
+ * Items without explicit significance default to "patch".
+ * Preserves relative order within the same significance level (stable sort).
+ */
+export function sortItemsBySignificance(items) {
+    return [...items].sort((a, b) => {
+        const aOrder = SIGNIFICANCE_ORDER[a.changeSignificance ?? DEFAULT_SIGNIFICANCE];
+        const bOrder = SIGNIFICANCE_ORDER[b.changeSignificance ?? DEFAULT_SIGNIFICANCE];
+        return aOrder - bOrder;
+    });
+}
+// ── Feature grouping within an epic ─────────────────────────────────────────
+function getFeatureTitle(item) {
+    const featureRef = item.parentChain.find((ref) => ref.level === "feature");
+    return featureRef?.title ?? "(Other)";
+}
+function groupItemsByFeature(items) {
+    const grouped = new Map();
+    for (const item of items) {
+        const key = getFeatureTitle(item);
+        const group = grouped.get(key) ?? [];
+        group.push(item);
+        grouped.set(key, group);
+    }
+    return grouped;
+}
+// ── Item rendering ──────────────────────────────────────────────────────────
+/**
+ * Whether an item's significance warrants inline context
+ * (description + acceptance criteria) in the completed work section.
+ */
+function isSignificant(item) {
+    return (item.changeSignificance === "major" ||
+        item.changeSignificance === "minor");
+}
+/**
+ * Render a single item line with optional significance indicator and context.
+ *
+ * - Breaking items get ⚠️ prefix and bold title
+ * - Major items get 🔶 prefix and bold title
+ * - Significant items (major/minor) include description and acceptance criteria
+ * - Patch/unclassified items render as plain list items
+ */
+function renderItemLines(item) {
+    const lines = [];
+    const levelTag = item.level !== "task" ? ` *(${item.level})*` : "";
+    // Title line with significance indicator
+    if (item.breakingChange) {
+        lines.push(`- ⚠️ **${item.title}**${levelTag}`);
+    }
+    else if (item.changeSignificance === "major") {
+        lines.push(`- 🔶 **${item.title}**${levelTag}`);
+    }
+    else {
+        lines.push(`- ${item.title}${levelTag}`);
+    }
+    // Inline context for significant items (minor+)
+    if (isSignificant(item) && item.description) {
+        lines.push(`  ${item.description}`);
+    }
+    if (isSignificant(item) &&
+        item.acceptanceCriteria &&
+        item.acceptanceCriteria.length > 0) {
+        for (const criterion of item.acceptanceCriteria) {
+            lines.push(`  - ${criterion}`);
+        }
+    }
+    return lines;
+}
+// ── Section renderers ───────────────────────────────────────────────────────
+/** Renders the top-level summary section. */
+export function renderSummarySection(record) {
+    const lines = [];
+    lines.push("## Summary");
+    lines.push("");
+    lines.push(`**Branch:** \`${record.branch}\``);
+    lines.push(`**Base:** \`${record.baseBranch}\``);
+    lines.push(`**Completed items:** ${record.items.length}`);
+    if (record.epicSummaries.length > 0) {
+        lines.push("");
+        lines.push("| Epic | Completed |");
+        lines.push("|------|-----------|");
+        for (const summary of record.epicSummaries) {
+            lines.push(`| ${summary.title} | ${summary.completedCount} |`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Renders a single epic section with items grouped by feature.
+ * Items within each feature group are sorted by significance (major first).
+ */
+export function renderEpicSection(epicTitle, items) {
+    const lines = [];
+    lines.push(`### ${epicTitle}`);
+    lines.push("");
+    const byFeature = groupItemsByFeature(items);
+    const featureKeys = [...byFeature.keys()].sort((a, b) => {
+        // "(Other)" always goes last
+        if (a === "(Other)")
+            return 1;
+        if (b === "(Other)")
+            return -1;
+        return a.localeCompare(b);
+    });
+    for (const featureTitle of featureKeys) {
+        const featureItems = byFeature.get(featureTitle) ?? [];
+        const sorted = sortItemsBySignificance(featureItems);
+        if (featureTitle !== "(Other)") {
+            lines.push(`**${featureTitle}**`);
+        }
+        for (const item of sorted) {
+            lines.push(...renderItemLines(item));
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/** Renders the breaking changes section. Returns empty string if no items. */
+export function renderBreakingChangesSection(items) {
+    if (items.length === 0)
+        return "";
+    const lines = [];
+    lines.push("## ⚠️ Breaking Changes");
+    lines.push("");
+    for (const item of items) {
+        lines.push(`- **${item.title}**`);
+        if (item.description) {
+            lines.push(`  ${item.description}`);
+        }
+        if (item.acceptanceCriteria && item.acceptanceCriteria.length > 0) {
+            for (const criterion of item.acceptanceCriteria) {
+                lines.push(`  - ${criterion}`);
+            }
+        }
+    }
+    return lines.join("\n");
+}
+/** Renders the major changes section. Returns empty string if no items. */
+export function renderMajorChangesSection(items) {
+    if (items.length === 0)
+        return "";
+    const lines = [];
+    lines.push("## Major Changes");
+    lines.push("");
+    for (const item of items) {
+        const priorityTag = item.priority ? ` [${item.priority}]` : "";
+        lines.push(`- **${item.title}**${priorityTag}`);
+        if (item.description) {
+            lines.push(`  ${item.description}`);
+        }
+    }
+    return lines.join("\n");
+}
+// ── Main entry point ────────────────────────────────────────────────────────
+/**
+ * Generates a complete PR markdown document from a branch work record.
+ *
+ * Content is organized in reviewer-friendly priority order:
+ *
+ * 1. **Summary** — branch, base, item counts, epic table
+ * 2. **Breaking Changes** — ⚠️ high-visibility section (only when present)
+ * 3. **Major Changes** — non-breaking major items (only when present)
+ * 4. **Completed Work** — all items grouped by epic → feature,
+ *    sorted by significance within each group
+ */
+export function renderPRMarkdownFromRecord(record) {
+    const sections = [];
+    // 1. Summary
+    sections.push(renderSummarySection(record));
+    // 2. Breaking changes — high-visibility, immediately after summary
+    const breakingItems = extractBreakingChanges(record.items);
+    const breakingSection = renderBreakingChangesSection(breakingItems);
+    if (breakingSection) {
+        sections.push(breakingSection);
+    }
+    // 3. Major changes — non-breaking major items (breaking ones already shown above)
+    const majorNonBreaking = extractMajorChanges(record.items).filter((item) => !item.breakingChange);
+    const majorSection = renderMajorChangesSection(majorNonBreaking);
+    if (majorSection) {
+        sections.push(majorSection);
+    }
+    // 4. Completed work grouped by epic, sorted by significance within groups
+    if (record.items.length === 0) {
+        sections.push("## Completed Work\n\nNo completed work items on this branch.");
+    }
+    else {
+        sections.push(renderCompletedWorkSection(record.items));
+    }
+    return sections.join("\n\n") + "\n";
+}
+// ── Internal ────────────────────────────────────────────────────────────────
+function renderCompletedWorkSection(items) {
+    const lines = [];
+    lines.push("## Completed Work");
+    lines.push("");
+    const byEpic = groupItemsByEpic(items);
+    const epicKeys = [...byEpic.keys()].sort((a, b) => {
+        // "(Ungrouped)" always goes last
+        if (a === "(Ungrouped)")
+            return 1;
+        if (b === "(Ungrouped)")
+            return -1;
+        return a.localeCompare(b);
+    });
+    for (const epicTitle of epicKeys) {
+        const epicItems = byEpic.get(epicTitle) ?? [];
+        lines.push(renderEpicSection(epicTitle, epicItems));
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=pr-markdown-template.js.map

package/packages/sourcevision/dist/generators/pr-markdown-template.js.map

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

package/packages/sourcevision/dist/public.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Public API for the sourcevision package.
+ *
+ * ## API philosophy: MCP factory + types
+ *
+ * Sourcevision is primarily a **CLI tool** and **MCP server**. Other packages
+ * interact with its analysis output through:
+ *
+ * 1. **MCP server** — the web package creates an MCP server instance
+ * 2. **Filesystem reads** — the web dashboard and rex's analyze command
+ *    read `.sourcevision/*.json` files directly from disk
+ *
+ * This public API exports the MCP factory for (1) and schema types for (2),
+ * letting consumers validate JSON file shapes at compile time without
+ * creating unnecessary runtime coupling to the analysis engine.
+ *
+ * Each package's public surface reflects its actual consumption pattern —
+ * see PACKAGE_GUIDELINES.md for the full decision tree and comparison table.
+ *
+ * ## Configuration
+ *
+ * Sourcevision has no persistent config file — only an ephemeral manifest
+ * generated per-analysis run. This matches the pattern across all three
+ * packages: config/manifest factories are internal implementation details,
+ * not part of the public API.
+ *
+ * ## Architectural isolation
+ *
+ * Sourcevision depends only on `@n-dx/llm-client` (the shared
+ * foundation) and has **no dependency on rex or hench**:
+ *
+ * ```
+ *   hench → rex → claude-client ← sourcevision
+ * ```
+ *
+ * @module sourcevision/public
+ */
+export { createSourcevisionMcpServer } from "./cli/mcp.js";
+export { SCHEMA_VERSION as SV_SCHEMA_VERSION } from "./schema/v1.js";
+export { DATA_FILES, ALL_DATA_FILES, SUPPLEMENTARY_FILES } from "./schema/data-files.js";
+export type { Manifest, ModuleInfo, ModuleStatus, SubAnalysisRef, AnalyzeTokenUsage, Inventory, FileEntry, FileRole, InventorySummary, Imports, ImportEdge, ImportType, ExternalImport, CircularDependency, ImportsSummary, Classifications, FileClassification, ClassificationEvidence, ClassificationsSummary, ArchetypeDefinition, ArchetypeSignal, Zones, Zone, ZoneSummary, ZoneRiskMetrics, RiskLevel, ZoneCrossing, ZoneTokenUsage, Finding, FindingType, Components, ComponentDefinition, ComponentKind, ComponentUsageEdge, RouteModule, RouteExportKind, RouteTreeNode, ComponentsSummary, CallGraph, CallEdge, CallType, FunctionNode, CallGraphSummary, WorkspaceMember, WorkspaceConfig, SourcevisionOutput, TokenUsage, NextStep, } from "./schema/v1.js";

package/packages/sourcevision/dist/public.js

@@ -0,0 +1,43 @@
+/**
+ * Public API for the sourcevision package.
+ *
+ * ## API philosophy: MCP factory + types
+ *
+ * Sourcevision is primarily a **CLI tool** and **MCP server**. Other packages
+ * interact with its analysis output through:
+ *
+ * 1. **MCP server** — the web package creates an MCP server instance
+ * 2. **Filesystem reads** — the web dashboard and rex's analyze command
+ *    read `.sourcevision/*.json` files directly from disk
+ *
+ * This public API exports the MCP factory for (1) and schema types for (2),
+ * letting consumers validate JSON file shapes at compile time without
+ * creating unnecessary runtime coupling to the analysis engine.
+ *
+ * Each package's public surface reflects its actual consumption pattern —
+ * see PACKAGE_GUIDELINES.md for the full decision tree and comparison table.
+ *
+ * ## Configuration
+ *
+ * Sourcevision has no persistent config file — only an ephemeral manifest
+ * generated per-analysis run. This matches the pattern across all three
+ * packages: config/manifest factories are internal implementation details,
+ * not part of the public API.
+ *
+ * ## Architectural isolation
+ *
+ * Sourcevision depends only on `@n-dx/llm-client` (the shared
+ * foundation) and has **no dependency on rex or hench**:
+ *
+ * ```
+ *   hench → rex → claude-client ← sourcevision
+ * ```
+ *
+ * @module sourcevision/public
+ */
+// ---- MCP server factory -----------------------------------------------------
+export { createSourcevisionMcpServer } from "./cli/mcp.js";
+// ---- Schema constants -------------------------------------------------------
+export { SCHEMA_VERSION as SV_SCHEMA_VERSION } from "./schema/v1.js";
+export { DATA_FILES, ALL_DATA_FILES, SUPPLEMENTARY_FILES } from "./schema/data-files.js";
+//# sourceMappingURL=public.js.map

package/packages/sourcevision/dist/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../src/public.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,gFAAgF;AAEhF,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAE3D,gFAAgF;AAEhF,OAAO,EAAE,cAAc,IAAI,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/packages/sourcevision/dist/schema/data-files.d.ts

@@ -0,0 +1,11 @@
+export declare const DATA_FILES: {
+    readonly manifest: "manifest.json";
+    readonly inventory: "inventory.json";
+    readonly imports: "imports.json";
+    readonly classifications: "classifications.json";
+    readonly zones: "zones.json";
+    readonly components: "components.json";
+    readonly callGraph: "callgraph.json";
+};
+export declare const ALL_DATA_FILES: ("manifest.json" | "inventory.json" | "imports.json" | "classifications.json" | "zones.json" | "components.json" | "callgraph.json")[];
+export declare const SUPPLEMENTARY_FILES: readonly ["llms.txt", "CONTEXT.md"];

package/packages/sourcevision/dist/schema/data-files.js

@@ -0,0 +1,12 @@
+export const DATA_FILES = {
+    manifest: "manifest.json",
+    inventory: "inventory.json",
+    imports: "imports.json",
+    classifications: "classifications.json",
+    zones: "zones.json",
+    components: "components.json",
+    callGraph: "callgraph.json",
+};
+export const ALL_DATA_FILES = Object.values(DATA_FILES);
+export const SUPPLEMENTARY_FILES = ["llms.txt", "CONTEXT.md"];
+//# sourceMappingURL=data-files.js.map

package/packages/sourcevision/dist/schema/data-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-files.js","sourceRoot":"","sources":["../../src/schema/data-files.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,QAAQ,EAAE,eAAe;IACzB,SAAS,EAAE,gBAAgB;IAC3B,OAAO,EAAE,cAAc;IACvB,eAAe,EAAE,sBAAsB;IACvC,KAAK,EAAE,YAAY;IACnB,UAAU,EAAE,iBAAiB;IAC7B,SAAS,EAAE,gBAAgB;CACnB,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,UAAU,EAAE,YAAY,CAAU,CAAC"}

package/packages/sourcevision/dist/schema/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./v1.js";
+export { ManifestSchema, InventorySchema, ImportsSchema, ClassificationsSchema, ZonesSchema, FindingSchema, ComponentsSchema, CallGraphSchema, BranchWorkRecordSchema, validateManifest, validateInventory, validateImports, validateClassifications, validateZones, validateComponents, validateCallGraph, validateBranchWorkRecord, validateModule, formatValidationErrors, } from "./validate.js";
+export type { ValidationResult } from "./validate.js";

package/packages/sourcevision/dist/schema/index.js

@@ -0,0 +1,3 @@
+export * from "./v1.js";
+export { ManifestSchema, InventorySchema, ImportsSchema, ClassificationsSchema, ZonesSchema, FindingSchema, ComponentsSchema, CallGraphSchema, BranchWorkRecordSchema, validateManifest, validateInventory, validateImports, validateClassifications, validateZones, validateComponents, validateCallGraph, validateBranchWorkRecord, validateModule, formatValidationErrors, } from "./validate.js";
+//# sourceMappingURL=index.js.map

package/packages/sourcevision/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,cAAc,EACd,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,cAAc,EACd,sBAAsB,GACvB,MAAM,eAAe,CAAC"}