flex-md 4.7.2 → 4.7.3

package/dist/tokens/improvements.js

@@ -1,13 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectImprovements = detectImprovements;
-exports.formatImprovementReport = formatImprovementReport;
-const parser_js_1 = require("./parser.js");
-const compliance_js_1 = require("./compliance.js");
+import { parseSystemPart } from './parser.js';
+import { detectSystemPartLevel } from './compliance.js';
 /**
  * Main improvement detector
  */
-function detectImprovements(spec, targetLevel = 2) {
+export function detectImprovements(spec, targetLevel = 2) {
     const improvements = [];
     const antiPatterns = [];
     const optimizations = [];
@@ -36,8 +32,8 @@ function detectImprovements(spec, targetLevel = 2) {
 function detectSectionImprovements(section, targetLevel) {
     const improvements = [];
     const kind = (section.kind || 'text');
-    const systemPart = (0, parser_js_1.parseSystemPart)(section.instruction, kind);
-    const currentLevel = systemPart ? (0, compliance_js_1.detectSystemPartLevel)(systemPart, kind) : null;
+    const systemPart = parseSystemPart(section.instruction, kind);
+    const currentLevel = systemPart ? detectSystemPartLevel(systemPart, kind) : null;
     // 1. Missing system part
     if (!systemPart) {
         improvements.push({
@@ -319,7 +315,7 @@ function detectUnreasonableValues(systemPart, section) {
 function detectSectionAntiPatterns(section) {
     const patterns = [];
     const kind = (section.kind || 'text');
-    const systemPart = (0, parser_js_1.parseSystemPart)(section.instruction, kind);
+    const systemPart = parseSystemPart(section.instruction, kind);
     const isRequired = section.required !== false;
     // Anti-pattern: Required section with no instruction at all
     if (isRequired && !section.instruction) {
@@ -348,7 +344,7 @@ function detectSectionAntiPatterns(section) {
     }
     // Anti-pattern: Optional section with higher compliance than required
     if (!isRequired && systemPart) {
-        const level = (0, compliance_js_1.detectSystemPartLevel)(systemPart, kind);
+        const level = detectSystemPartLevel(systemPart, kind);
         if (level === 3) {
             patterns.push({
                 sectionName: section.name,
@@ -398,9 +394,9 @@ function detectSpecOptimizations(spec) {
     const firstKind = (spec.sections[0].kind || 'text');
     // Optimization: All sections at L1, could upgrade key ones to L2
     const levels = spec.sections
-        .map(s => (0, parser_js_1.parseSystemPart)(s.instruction, (s.kind || 'text')))
+        .map(s => parseSystemPart(s.instruction, (s.kind || 'text')))
         .filter(sp => sp !== null)
-        .map(sp => (0, compliance_js_1.detectSystemPartLevel)(sp, firstKind));
+        .map(sp => detectSystemPartLevel(sp, firstKind));
     const allL1 = levels.length > 0 && levels.every(l => l === 1);
     if (allL1 && levels.length >= 3) {
         opts.push({
@@ -428,7 +424,7 @@ function detectSpecOptimizations(spec) {
         });
     }
     // Optimization: Too many sections without system parts
-    const withoutSystemParts = spec.sections.filter(s => (0, parser_js_1.parseSystemPart)(s.instruction, (s.kind || 'text')) === null);
+    const withoutSystemParts = spec.sections.filter(s => parseSystemPart(s.instruction, (s.kind || 'text')) === null);
     if (withoutSystemParts.length > spec.sections.length * 0.3) {
         opts.push({
             type: 'simplify',
@@ -453,7 +449,7 @@ function detectSpecOptimizations(spec) {
     // Optimization: All text sections could benefit from more specific lengths
     const textSections = spec.sections.filter(s => (s.kind || 'text') === 'text');
     const vagueLengths = textSections.filter(s => {
-        const sp = (0, parser_js_1.parseSystemPart)(s.instruction, 'text');
+        const sp = parseSystemPart(s.instruction, 'text');
         return sp?.parsed.type === 'length' &&
             ['brief', 'moderate', 'detailed', 'extensive'].includes(sp.parsed.value);
     });
@@ -609,7 +605,7 @@ function byImpact(a, b) {
 /**
  * Format improvement report
  */
-function formatImprovementReport(analysis) {
+export function formatImprovementReport(analysis) {
     const lines = [];
     lines.push('\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2551');
     lines.push('\u2551      IMPROVEMENT DETECTION REPORT                \u2551');

package/dist/tokens/index.js

@@ -1,35 +1,17 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMaxTokens = getMaxTokens;
-exports.getMaxTokensFromInstructions = getMaxTokensFromInstructions;
-const parser_js_1 = require("../ofs/parser.js");
-const spec_estimator_js_1 = require("./spec-estimator.js");
-__exportStar(require("./types.js"), exports);
-__exportStar(require("./parser.js"), exports);
-__exportStar(require("./estimator.js"), exports);
-__exportStar(require("./spec-estimator.js"), exports);
-__exportStar(require("./runtime-estimator.js"), exports);
-__exportStar(require("./validator.js"), exports);
-__exportStar(require("./compliance.js"), exports);
-__exportStar(require("./cognitive-cost.js"), exports);
-__exportStar(require("./confidence.js"), exports);
-__exportStar(require("./smart-report.js"), exports);
-__exportStar(require("./improvements.js"), exports);
-__exportStar(require("./auto-fix.js"), exports);
+import { parseOutputFormatSpec, parseFormatSpecs } from '../ofs/parser.js';
+import { estimateSpecTokens, estimateFormatSpecsTokens } from './spec-estimator.js';
+export * from './types.js';
+export * from './parser.js';
+export * from './estimator.js';
+export * from './spec-estimator.js';
+export * from './runtime-estimator.js';
+export * from './validator.js';
+export * from './compliance.js';
+export * from './cognitive-cost.js';
+export * from './confidence.js';
+export * from './smart-report.js';
+export * from './improvements.js';
+export * from './auto-fix.js';
 /**
  * Convenience function: estimate max_tokens from spec
  *
@@ -37,26 +19,26 @@ __exportStar(require("./auto-fix.js"), exports);
  * @param options - Estimation options
  * @returns Estimated max_tokens value
  */
-function getMaxTokens(spec, options) {
+export function getMaxTokens(spec, options) {
     if (!spec)
         return 0;
     const extractFromInstructions = options?.extractFromInstructions ?? false;
     // If extractFromInstructions is true and spec is a string, try to extract both formats
     if (extractFromInstructions && typeof spec === 'string') {
-        const formatSpecs = (0, parser_js_1.parseFormatSpecs)(spec);
+        const formatSpecs = parseFormatSpecs(spec);
         if (formatSpecs.input || formatSpecs.output) {
-            const estimate = (0, spec_estimator_js_1.estimateFormatSpecsTokens)(formatSpecs.input, formatSpecs.output, options);
+            const estimate = estimateFormatSpecsTokens(formatSpecs.input, formatSpecs.output, options);
             return estimate.total.estimated;
         }
         // Fall through to output-only parsing if no formats found
     }
     // Original behavior: parse as output format spec
     const parsedSpec = typeof spec === 'string'
-        ? (0, parser_js_1.parseOutputFormatSpec)(spec)
+        ? parseOutputFormatSpec(spec)
         : spec;
     if (!parsedSpec)
         return 0;
-    const estimate = (0, spec_estimator_js_1.estimateSpecTokens)(parsedSpec, options);
+    const estimate = estimateSpecTokens(parsedSpec, options);
     return estimate.total.estimated;
 }
 /**
@@ -67,8 +49,8 @@ function getMaxTokens(spec, options) {
  * @param options - Estimation options
  * @returns Estimated max_tokens value based on both input and output formats
  */
-function getMaxTokensFromInstructions(instructions, options) {
-    const formatSpecs = (0, parser_js_1.parseFormatSpecs)(instructions);
-    const estimate = (0, spec_estimator_js_1.estimateFormatSpecsTokens)(formatSpecs.input, formatSpecs.output, options);
+export function getMaxTokensFromInstructions(instructions, options) {
+    const formatSpecs = parseFormatSpecs(instructions);
+    const estimate = estimateFormatSpecsTokens(formatSpecs.input, formatSpecs.output, options);
     return estimate.total.estimated;
 }

package/dist/tokens/parser.js

@@ -1,19 +1,16 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseSystemPart = parseSystemPart;
-const patterns_js_1 = require("./patterns.js");
-function parseSystemPart(instruction, kind // Allow 'code' as a special case if needed
+import { SYSTEM_PART_PATTERNS, INSTRUCTION_SPLIT } from './patterns.js';
+export function parseSystemPart(instruction, kind // Allow 'code' as a special case if needed
 ) {
     if (!instruction)
         return null;
-    const pattern = patterns_js_1.SYSTEM_PART_PATTERNS[kind];
+    const pattern = SYSTEM_PART_PATTERNS[kind];
     if (!pattern)
         return null;
     const match = instruction.match(pattern);
     if (!match)
         return null;
     // Split into system and guidance parts
-    const parts = instruction.split(patterns_js_1.INSTRUCTION_SPLIT);
+    const parts = instruction.split(INSTRUCTION_SPLIT);
     const raw = parts[0];
     const guidance = parts.slice(1).join('. ') || null;
     const parsed = parseMatchByKind(kind, match);

package/dist/tokens/patterns.js

@@ -1,8 +1,5 @@
-"use strict";
 // patterns.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.INSTRUCTION_SPLIT = exports.SYSTEM_PART_PATTERNS = void 0;
-exports.SYSTEM_PART_PATTERNS = {
+export const SYSTEM_PART_PATTERNS = {
     // TEXT: Enumerated literal strings only
     text: /^Length:\s*(1\s+sentence|1-2\s+sentences|1\s+paragraph|2-3\s+paragraphs|brief|moderate|detailed|extensive)/i,
     // LIST/ORDERED-LIST: [optional "at least"] + number + [optional range]
@@ -20,4 +17,4 @@ exports.SYSTEM_PART_PATTERNS = {
     code: /^Lines:\s*(~)?(\d+)(?:-(\d+))?/i
 };
 // Separator for splitting system part from guidance
-exports.INSTRUCTION_SPLIT = /\.\s+/;
+export const INSTRUCTION_SPLIT = /\.\s+/;

package/dist/tokens/runtime-estimator.js

@@ -1,9 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runtimeEstimateTokens = runtimeEstimateTokens;
-const parser_js_1 = require("../ofs/parser.js");
-const spec_estimator_js_1 = require("./spec-estimator.js");
-const estimator_js_1 = require("./estimator.js");
+import { parseFormatSpecs } from '../ofs/parser.js';
+import { estimateFormatSpecsTokens } from './spec-estimator.js';
+import { estimateTextTokens } from './estimator.js';
 /**
  * Estimate max_tokens for an LLM API call at runtime.
  *
@@ -19,7 +16,7 @@ const estimator_js_1 = require("./estimator.js");
  * @param params - Runtime estimation parameters
  * @returns Token estimate with breakdown
  */
-function runtimeEstimateTokens(params) {
+export function runtimeEstimateTokens(params) {
     const { prompt = '', context = '', instructions = '' } = params;
     const opts = {
         includeOptional: params.options?.includeOptional ?? true,
@@ -31,14 +28,14 @@ function runtimeEstimateTokens(params) {
         additionalOverhead: params.options?.additionalOverhead ?? 0
     };
     // Extract format specs from instructions (only output format is used at runtime)
-    const formatSpecs = (0, parser_js_1.parseFormatSpecs)(instructions);
+    const formatSpecs = parseFormatSpecs(instructions);
     // Estimate tokens for each component
-    const promptTokens = opts.estimatePrompt ? (0, estimator_js_1.estimateTextTokens)(prompt) : 0;
-    const contextTokens = opts.estimateContext ? (0, estimator_js_1.estimateTextTokens)(context) : 0;
-    const instructionsTokens = opts.estimateInstructions ? (0, estimator_js_1.estimateTextTokens)(instructions) : 0;
+    const promptTokens = opts.estimatePrompt ? estimateTextTokens(prompt) : 0;
+    const contextTokens = opts.estimateContext ? estimateTextTokens(context) : 0;
+    const instructionsTokens = opts.estimateInstructions ? estimateTextTokens(instructions) : 0;
     // Estimate output tokens from output format spec (input format is for planning only)
     const outputEstimate = formatSpecs.output
-        ? (0, spec_estimator_js_1.estimateFormatSpecsTokens)(undefined, formatSpecs.output, {
+        ? estimateFormatSpecsTokens(undefined, formatSpecs.output, {
             includeOptional: opts.includeOptional,
             safetyMultiplier: 1.0, // Don't apply safety multiplier here, apply at the end
             strategy: opts.strategy

package/dist/tokens/smart-report.js

@@ -1,19 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.analyzeSpec = analyzeSpec;
-exports.formatSmartReport = formatSmartReport;
-const compliance_js_1 = require("./compliance.js");
-const cognitive_cost_js_1 = require("./cognitive-cost.js");
-const confidence_js_1 = require("./confidence.js");
-const spec_estimator_js_1 = require("./spec-estimator.js");
+import { checkSpecCompliance } from './compliance.js';
+import { calculateCognitiveCost } from './cognitive-cost.js';
+import { calculateConfidence } from './confidence.js';
+import { estimateSpecTokens } from './spec-estimator.js';
 /**
  * Comprehensive smart analysis of spec
  */
-function analyzeSpec(spec, targetLevel = 2) {
-    const compliance = (0, compliance_js_1.checkSpecCompliance)(spec, targetLevel);
-    const cognitiveCost = (0, cognitive_cost_js_1.calculateCognitiveCost)(spec);
-    const confidence = (0, confidence_js_1.calculateConfidence)(spec);
-    const tokenEstimate = (0, spec_estimator_js_1.estimateSpecTokens)(spec);
+export function analyzeSpec(spec, targetLevel = 2) {
+    const compliance = checkSpecCompliance(spec, targetLevel);
+    const cognitiveCost = calculateCognitiveCost(spec);
+    const confidence = calculateConfidence(spec);
+    const tokenEstimate = estimateSpecTokens(spec);
     const recommendations = generateSmartRecommendations(compliance, cognitiveCost, confidence, tokenEstimate);
     return {
         spec,
@@ -85,7 +81,7 @@ function generateSmartRecommendations(compliance, cost, confidence, estimate) {
 /**
  * Format comprehensive smart report
  */
-function formatSmartReport(analysis) {
+export function formatSmartReport(analysis) {
     const lines = [];
     lines.push('╔═══════════════════════════════════════════════════╗');
     lines.push('║         FLEX-MD SMART ANALYSIS REPORT            ║');

package/dist/tokens/spec-estimator.js

@@ -1,11 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.estimateSpecTokens = estimateSpecTokens;
-exports.estimateInputSpecTokens = estimateInputSpecTokens;
-exports.estimateFormatSpecsTokens = estimateFormatSpecsTokens;
-const parser_js_1 = require("./parser.js");
-const estimator_js_1 = require("./estimator.js");
-function estimateSpecTokens(spec, options = {}) {
+import { parseSystemPart } from './parser.js';
+import { estimateTokens, getFallbackEstimate, TOKEN_CONSTANTS } from './estimator.js';
+export function estimateSpecTokens(spec, options = {}) {
     const { includeOptional = true, safetyMultiplier = 1.2, strategy = 'average' } = options;
     const bySectionName = {};
     let totalEstimated = 0;
@@ -17,13 +12,13 @@ function estimateSpecTokens(spec, options = {}) {
         if (!includeOptional && !isRequired)
             continue;
         const kind = section.kind || 'text';
-        const systemPart = (0, parser_js_1.parseSystemPart)(section.instruction, kind);
+        const systemPart = parseSystemPart(section.instruction, kind);
         let estimate;
         if (systemPart) {
-            estimate = (0, estimator_js_1.estimateTokens)(systemPart);
+            estimate = estimateTokens(systemPart);
         }
         else {
-            estimate = (0, estimator_js_1.getFallbackEstimate)(kind, isRequired);
+            estimate = getFallbackEstimate(kind, isRequired);
         }
         // Apply optional section discount
         if (!isRequired) {
@@ -40,8 +35,8 @@ function estimateSpecTokens(spec, options = {}) {
         totalMax += estimate.max;
     }
     // Add overhead
-    const overhead = estimator_js_1.TOKEN_CONSTANTS.baseOverhead +
-        (spec.sections.length * estimator_js_1.TOKEN_CONSTANTS.headingOverhead);
+    const overhead = TOKEN_CONSTANTS.baseOverhead +
+        (spec.sections.length * TOKEN_CONSTANTS.headingOverhead);
     totalEstimated += overhead;
     totalMin += overhead;
     totalMax += overhead;
@@ -75,7 +70,7 @@ function estimateSpecTokens(spec, options = {}) {
  * Estimate tokens for an Input Format Spec.
  * Uses the same logic as output format estimation.
  */
-function estimateInputSpecTokens(spec, options = {}) {
+export function estimateInputSpecTokens(spec, options = {}) {
     // Input format uses the same structure as output format, so reuse the same logic
     const outputSpec = {
         ...spec,
@@ -87,7 +82,7 @@ function estimateInputSpecTokens(spec, options = {}) {
  * Estimate tokens for both input and output format specs.
  * Combines estimates from both if present.
  */
-function estimateFormatSpecsTokens(inputSpec, outputSpec, options = {}) {
+export function estimateFormatSpecsTokens(inputSpec, outputSpec, options = {}) {
     const inputEstimate = inputSpec ? estimateInputSpecTokens(inputSpec, options) : null;
     const outputEstimate = outputSpec ? estimateSpecTokens(outputSpec, options) : null;
     // If only one is present, return it

package/dist/tokens/types.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/tokens/validator.js

@@ -1,8 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateSystemParts = validateSystemParts;
-const parser_js_1 = require("./parser.js");
-function validateSystemParts(spec) {
+import { parseSystemPart } from './parser.js';
+export function validateSystemParts(spec) {
     const errors = [];
     const warnings = [];
     for (const section of spec.sections) {
@@ -17,7 +14,7 @@ function validateSystemParts(spec) {
             }
             continue;
         }
-        const systemPart = (0, parser_js_1.parseSystemPart)(section.instruction, kind);
+        const systemPart = parseSystemPart(section.instruction, kind);
         if (!systemPart) {
             warnings.push({
                 sectionName: section.name,

package/dist/types.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/validate/compliance.js

@@ -1,19 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkCompliance = checkCompliance;
-exports.hasFlexMdContract = hasFlexMdContract;
-const parser_js_1 = require("../ofs/parser.js");
+import { parseFormatSpecs } from "../ofs/parser.js";
 /**
  * Check if instructions meet the required flex-md compliance level.
  * Returns detailed results including what's missing or wrong.
  * Now also checks for Input Format Spec if present.
  */
-async function checkCompliance(instructions, complianceLevel) {
+export async function checkCompliance(instructions, complianceLevel) {
     const issues = [];
     const suggestions = [];
     const lower = instructions.toLowerCase();
     // Extract both input and output format specs
-    const formatSpecs = (0, parser_js_1.parseFormatSpecs)(instructions);
+    const formatSpecs = parseFormatSpecs(instructions);
     const hasInputFormat = !!formatSpecs.input;
     const hasOutputFormat = !!formatSpecs.output;
     const hasMarkdownMention = lower.includes("markdown");
@@ -97,7 +93,7 @@ async function checkCompliance(instructions, complianceLevel) {
  * Check if instructions meet the required flex-md compliance level.
  * @deprecated Use checkCompliance for detailed results.
  */
-async function hasFlexMdContract(instructions, complianceLevel) {
+export async function hasFlexMdContract(instructions, complianceLevel) {
     const result = await checkCompliance(instructions, complianceLevel);
     return result.meetsCompliance;
 }

package/dist/validate/connection.js

@@ -1,14 +1,11 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkConnection = checkConnection;
-const outline_js_1 = require("../md/outline.js");
-const parse_js_1 = require("../md/parse.js");
+import { buildOutline } from "../md/outline.js";
+import { normalizeName } from "../md/parse.js";
 /**
  * Checks if a specific key (section) is "connected" in the given markdown.
  */
-function checkConnection(md, key) {
-    const outline = (0, outline_js_1.buildOutline)(md);
-    const normKey = (0, parse_js_1.normalizeName)(key);
+export function checkConnection(md, key) {
+    const outline = buildOutline(md);
+    const normKey = normalizeName(key);
     const path = [];
     // Breadth-first search for the key
     const queue = outline.nodes.map(n => ({ node: n, currentPath: [n.title] }));

package/dist/validate/types.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/validate/validate.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateMarkdownAgainstOfs = validateMarkdownAgainstOfs;
-const parse_js_1 = require("../md/parse.js");
+import { extractFencedBlocks, parseHeadingsAndSections, normalizeName, isIssuesEnvelopeCheck } from "../md/parse.js";
 function enforcementToSeverity(e) {
     if (e === "ignore")
         return null;
@@ -35,19 +32,19 @@ function isRequiredSection(spec, level) {
 function stripToWorkingMarkdown(input, level) {
     if (level < 2)
         return { working: input, container: null };
-    const fences = (0, parse_js_1.extractFencedBlocks)(input);
+    const fences = extractFencedBlocks(input);
     if (fences.length === 1) {
         const f = fences[0];
         return { working: f.content, container: { fence: f } };
     }
     return { working: input, container: null };
 }
-function validateMarkdownAgainstOfs(input, spec, level, policyOverride) {
+export function validateMarkdownAgainstOfs(input, spec, level, policyOverride) {
     const policy = { ...defaultPolicy(level), ...(policyOverride ?? {}) };
     const issues = [];
-    const fencesAll = (0, parse_js_1.extractFencedBlocks)(input);
+    const fencesAll = extractFencedBlocks(input);
     if (level === 0) {
-        const env = (0, parse_js_1.isIssuesEnvelopeCheck)(input);
+        const env = isIssuesEnvelopeCheck(input);
         return {
             ok: true,
             level,
@@ -61,7 +58,7 @@ function validateMarkdownAgainstOfs(input, spec, level, policyOverride) {
             },
         };
     }
-    const env = (0, parse_js_1.isIssuesEnvelopeCheck)(input);
+    const env = isIssuesEnvelopeCheck(input);
     if (env.isIssuesEnvelope) {
         issues.push({
             code: "ISSUES_ENVELOPE_PRESENT",
@@ -110,10 +107,10 @@ function validateMarkdownAgainstOfs(input, spec, level, policyOverride) {
         }
     }
     const { working } = stripToWorkingMarkdown(input, level);
-    const parsed = (0, parse_js_1.parseHeadingsAndSections)(working);
+    const parsed = parseHeadingsAndSections(working);
     const specByNorm = new Map();
     for (const s of spec.sections)
-        specByNorm.set((0, parse_js_1.normalizeName)(s.name), s);
+        specByNorm.set(normalizeName(s.name), s);
     const occurrences = new Map();
     const bodiesByNorm = {};
     for (const sec of parsed) {
@@ -128,7 +125,7 @@ function validateMarkdownAgainstOfs(input, spec, level, policyOverride) {
         const req = isRequiredSection(s, level);
         if (!req)
             continue;
-        const norm = (0, parse_js_1.normalizeName)(s.name);
+        const norm = normalizeName(s.name);
         const count = occurrences.get(norm) ?? 0;
         if (count === 0) {
             missingRequired.push(s.name);
@@ -144,12 +141,12 @@ function validateMarkdownAgainstOfs(input, spec, level, policyOverride) {
         const req = isRequiredSection(s, level);
         if (!req)
             continue;
-        const norm = (0, parse_js_1.normalizeName)(s.name);
+        const norm = normalizeName(s.name);
         const bodies = bodiesByNorm[norm] ?? [];
         if (!bodies.length)
             continue;
         const allEmpty = bodies.every(b => b.trim().length === 0);
-        const allNone = bodies.every(b => (0, parse_js_1.normalizeName)(b) === (0, parse_js_1.normalizeName)(noneValue));
+        const allNone = bodies.every(b => normalizeName(b) === normalizeName(noneValue));
         const emptyByPolicy = allEmpty || (!policy.noneIsAcceptableContent && allNone);
         if (emptyByPolicy) {
             addIssue(issues, policy.emptyRequiredSection, {
@@ -173,14 +170,14 @@ function validateMarkdownAgainstOfs(input, spec, level, policyOverride) {
     }
     if (level >= 3) {
         for (const s of spec.sections) {
-            const norm = (0, parse_js_1.normalizeName)(s.name);
+            const norm = normalizeName(s.name);
             const bodies = bodiesByNorm[norm] ?? [];
             if (!bodies.length)
                 continue;
             const kind = s.kind ?? "text";
             for (const body of bodies) {
                 const b = body.trim();
-                if ((0, parse_js_1.normalizeName)(b) === (0, parse_js_1.normalizeName)(noneValue))
+                if (normalizeName(b) === normalizeName(noneValue))
                     continue;
                 if (kind === "text")
                     continue;
@@ -214,9 +211,9 @@ function validateMarkdownAgainstOfs(input, spec, level, policyOverride) {
                         });
                         continue;
                     }
-                    const cols = (s.columns ?? []).map(c => (0, parse_js_1.normalizeName)(c));
+                    const cols = (s.columns ?? []).map(c => normalizeName(c));
                     if (cols.length) {
-                        const headerNorm = table.header.map(c => (0, parse_js_1.normalizeName)(c));
+                        const headerNorm = table.header.map(c => normalizeName(c));
                         const missingCols = cols.filter(c => !headerNorm.includes(c));
                         if (missingCols.length) {
                             addIssue(issues, policy.malformedTable, {
@@ -227,7 +224,7 @@ function validateMarkdownAgainstOfs(input, spec, level, policyOverride) {
                         }
                     }
                     if (kind === "ordered_table") {
-                        const header0 = (0, parse_js_1.normalizeName)(table.header[0] ?? "");
+                        const header0 = normalizeName(table.header[0] ?? "");
                         if (header0 !== "#") {
                             addIssue(issues, policy.malformedOrderedTable, {
                                 code: "MALFORMED_ORDERED_TABLE",

package/dist-cjs/__tests__/diagnostics.test.cjs

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const index_js_1 = require("../index.cjs");
+(0, vitest_1.describe)("Diagnostics", () => {
+    (0, vitest_1.describe)("checkCompliance", () => {
+        (0, vitest_1.it)("should return meetsCompliance: true for L0 if Markdown is mentioned", async () => {
+            const res = await (0, index_js_1.checkCompliance)("Reply in Markdown.", "L0");
+            (0, vitest_1.expect)(res.meetsCompliance).toBe(true);
+            (0, vitest_1.expect)(res.issues).toHaveLength(0);
+        });
+        (0, vitest_1.it)("should return issues for L2 if container is missing", async () => {
+            const res = await (0, index_js_1.checkCompliance)("Reply in Markdown. Include headings.", "L2");
+            (0, vitest_1.expect)(res.meetsCompliance).toBe(false);
+            (0, vitest_1.expect)(res.issues.some(i => i.type === "missing-container")).toBe(true);
+        });
+        (0, vitest_1.it)("should return false for hasFlexMdContract if requirements not met", async () => {
+            const ok = await (0, index_js_1.hasFlexMdContract)("Hello", "L0");
+            (0, vitest_1.expect)(ok).toBe(false);
+        });
+    });
+    (0, vitest_1.describe)("enrichInstructionsWithFlexMd", () => {
+        (0, vitest_1.it)("should append guidance to existing instructions", async () => {
+            const res = await (0, index_js_1.enrichInstructionsWithFlexMd)("Do a good job.", "L0");
+            (0, vitest_1.expect)(res.enriched).toContain("Do a good job.");
+            (0, vitest_1.expect)(res.enriched).toContain("Reply in Markdown.");
+            (0, vitest_1.expect)(res.changes).toHaveLength(1);
+            (0, vitest_1.expect)(res.metadata?.guidanceAdded).toBe(true);
+        });
+        (0, vitest_1.it)("should track container addition for L2", async () => {
+            const res = await (0, index_js_1.enrichInstructionsWithFlexMd)("Do a good job.", "L2");
+            (0, vitest_1.expect)(res.changes.some(c => c.type === "added-container")).toBe(true);
+            (0, vitest_1.expect)(res.metadata?.containerAdded).toBe(true);
+        });
+    });
+    (0, vitest_1.describe)("validateFormat", () => {
+        (0, vitest_1.it)("should validate a correct flex-md OFS", async () => {
+            const ofs = `## Output format\n- Summary — prose\n- Actions — list`;
+            const res = await (0, index_js_1.validateFormat)(ofs);
+            (0, vitest_1.expect)(res.valid).toBe(true);
+            (0, vitest_1.expect)(res.metadata?.sectionCount).toBe(2);
+        });
+        (0, vitest_1.it)("should return errors for missing heading", async () => {
+            const ofs = `- Summary — prose`;
+            const res = await (0, index_js_1.validateFormat)(ofs);
+            (0, vitest_1.expect)(res.valid).toBe(false);
+            (0, vitest_1.expect)(res.issues.some(i => i.type === "missing-heading")).toBe(true);
+        });
+        (0, vitest_1.it)("should validate JSON schema", async () => {
+            const schema = `{"type": "object"}`;
+            const res = await (0, index_js_1.validateFormat)(schema, "json-schema");
+            (0, vitest_1.expect)(res.valid).toBe(true);
+        });
+        (0, vitest_1.it)("should fail on invalid JSON schema", async () => {
+            const schema = `{"type": "object"`;
+            const res = await (0, index_js_1.validateFormat)(schema, "json-schema");
+            (0, vitest_1.expect)(res.valid).toBe(false);
+            (0, vitest_1.expect)(res.issues[0].type).toBe("syntax-error");
+        });
+    });
+});