@oa-sdk/spec-bundler 0.1.0

package/dist/category-parser.js

@@ -0,0 +1,115 @@
+import { sliceMarkdownBySections } from "./section-slicer.js";
+export const STANDARD_CONTRACT_HEADINGS = [
+    "Contract*",
+    "Interface*",
+    "Overview*",
+    "Preconditions*",
+    "Guarantees*",
+    "API*",
+    "Specification*",
+    "Rules*",
+];
+/**
+ * Parses the document category from YAML frontmatter or infers it from path heuristics.
+ */
+export function parseDocumentCategory(content, filePath) {
+    const normPath = filePath.replace(/\\/g, "/").toLowerCase();
+    // 1. Try YAML frontmatter parsing
+    const frontmatterMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
+    if (frontmatterMatch) {
+        const fm = frontmatterMatch[1];
+        const catMatch = fm.match(/^(?:category|type|kind)\s*:\s*["']?([a-zA-Z_-]+)["']?/m);
+        if (catMatch) {
+            const rawCat = catMatch[1].toLowerCase().trim();
+            if (rawCat === "feature" || rawCat === "features")
+                return "feature";
+            if (rawCat === "mechanism" || rawCat === "mechanisms" || rawCat === "tech" || rawCat === "strategy")
+                return "mechanism";
+            if (rawCat === "error" || rawCat === "errors")
+                return "error";
+            if (rawCat === "issue" || rawCat === "issues" || rawCat === "adr" || rawCat === "rfc")
+                return "issue";
+            if (rawCat === "convention" || rawCat === "conventions" || rawCat === "rule" || rawCat === "rules")
+                return "convention";
+        }
+    }
+    // 2. Path-based heuristics
+    if (normPath.includes("/features/") || normPath.includes("/feature/"))
+        return "feature";
+    if (normPath.includes("/mechanisms/") || normPath.includes("/mechanism/") || normPath.includes("/tech/") || normPath.includes("/strategies/"))
+        return "mechanism";
+    if (normPath.includes("/errors/") || normPath.includes("/error/"))
+        return "error";
+    if (normPath.includes("/issues/") || normPath.includes("/issue/") || normPath.includes("/adr/") || normPath.includes("/rfc/"))
+        return "issue";
+    if (normPath.includes("/conventions/") || normPath.includes("/convention/") || normPath.includes("/rules/"))
+        return "convention";
+    // 3. Extension fallback
+    if (normPath.endsWith(".tsp"))
+        return "mechanism";
+    return "feature";
+}
+/**
+ * Extracts document content according to requested fidelity level (full, contract-only, summary).
+ * Prevents bundle bloat by stripping non-contract details for background/upstream documents.
+ */
+export function extractDocumentFidelity(content, category, fidelity = "full", customSections) {
+    if (fidelity === "full") {
+        if (customSections && customSections.length > 0) {
+            const sliceResult = sliceMarkdownBySections(content, customSections);
+            return { content: sliceResult.sliced, isModified: sliceResult.isSliced };
+        }
+        return { content, isModified: false };
+    }
+    if (fidelity === "contract-only") {
+        const headingsToExtract = customSections && customSections.length > 0
+            ? customSections
+            : STANDARD_CONTRACT_HEADINGS;
+        const sliceResult = sliceMarkdownBySections(content, headingsToExtract);
+        if (sliceResult.isSliced) {
+            return { content: sliceResult.sliced, isModified: true };
+        }
+        // If no contract headings explicitly matched, fallback to preamble + frontmatter
+        const frontmatterMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
+        const frontmatter = frontmatterMatch ? frontmatterMatch[0] : "";
+        const body = content.slice(frontmatter.length);
+        const bodyLines = body.split(/\r?\n/);
+        const preambleLines = [];
+        for (const line of bodyLines) {
+            if (/^#{2,6}\s+/.test(line))
+                break; // Stop at first H2+ section
+            preambleLines.push(line);
+        }
+        const fallbackContent = `${frontmatter}${preambleLines.join("\n").trim()}\n`;
+        return { content: fallbackContent, isModified: true };
+    }
+    if (fidelity === "summary") {
+        // 1. Separate frontmatter
+        const frontmatterMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
+        const frontmatter = frontmatterMatch ? frontmatterMatch[0] : "";
+        // 2. Extract summary field if declared in frontmatter
+        let summaryText = "";
+        if (frontmatterMatch) {
+            const sumMatch = frontmatterMatch[1].match(/^summary\s*:\s*["']?([^"'\r\n]+)["']?/m);
+            if (sumMatch) {
+                summaryText = sumMatch[1].trim();
+            }
+        }
+        // 3. Extract title and first body paragraph
+        const body = content.slice(frontmatter.length);
+        const lines = body.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+        const titleLine = lines.find((l) => l.startsWith("# ")) || `# Document (${category})`;
+        const firstParagraph = lines.find((l) => !l.startsWith("#") && !l.startsWith("-")) || "";
+        const summaryContent = `${frontmatter}
+${titleLine}
+
+*(Category: \`${category}\` | Fidelity: \`summary\`)*
+
+> [!NOTE]
+> ${summaryText || firstParagraph || "No detailed summary declared."}
+`;
+        return { content: summaryContent, isModified: true };
+    }
+    return { content, isModified: false };
+}
+//# sourceMappingURL=category-parser.js.map

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map