nimai-core 0.4.8 → 0.5.0

package/dist/lint.js

@@ -36,329 +36,62 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.lintSpec = lintSpec;
 exports.lintContent = lintContent;
 const fs = __importStar(require("fs"));
+const template_1 = require("./template");
 // Matches unfilled placeholder fields: ___ (3 or more underscores)
-const BLANK_FIELD_RE = /_{3,}/;
+const BLANK_PLACEHOLDER_RE = /_{3,}/;
 // Matches [NEEDS HUMAN INPUT...] flags
 const NHFI_RE = /\[NEEDS HUMAN INPUT/i;
-// Matches pre-checked list items: "- [x] ..." or "* [x] ..."
-const PRE_CHECKED_AC_RE = /^[-*]\s+\[x\]/im;
-// Matches the nimai-spec marker (with or without date)
-const NIMAI_MARKER_RE = /<!--\s*nimai-spec[\s:]/;
-// Unresolved mechanism detection — two-tier:
-//   Pattern A (high confidence, flagged anywhere): parenthetical "(e.g., X or Y)"
-const UNRESOLVED_PAREN_RE = /\(e\.g\.,?\s+[^)\n]+\bor\b[^)\n]*\)/i;
-//   Pattern B (context-sensitive, only inside critical sections):
-//     "e.g., X or Y" / "such as X or Y" / "for example X or Y"
-//     "could/might use/implement X or Y"
-const UNRESOLVED_INLINE_RE = /(?:(?:e\.g\.|such as|for example)\s+\w[^\n.;]*\bor\b|\b(?:could|might)\s+(?:use|implement|be\s+(?:used|implemented?))\s+\w[^\n.;]*\bor\b)/i;
-// Headings that introduce critical sections where a single mechanism must be chosen.
-// No trailing \b so that plurals/suffixes like "Constraints", "Implementation", "Tasks" all match.
-const CRITICAL_SECTION_RE = /\b(?:deliverable|scope|constraints?|must|sub-?tasks?|tasks?|implement\w*|pipeline|mechanism|architect\w*|approach)/i;
-const HEADING_LINE_RE = /^#{1,6}\s+(.+)/;
-const UNRESOLVED_ARCH_VALUE_RE = /(?:_{3,}|\bTBD\b)/i;
-/** Return 1-based line numbers where unresolved mechanism patterns are found. */
-function detectUnresolvedMechanisms(lines) {
-    const matches = [];
-    let inCritical = false;
-    for (let i = 0; i < lines.length; i++) {
-        const headingMatch = lines[i].match(HEADING_LINE_RE);
-        if (headingMatch) {
-            inCritical = CRITICAL_SECTION_RE.test(headingMatch[1]);
-            continue;
-        }
-        // Pattern A: parenthetical "(e.g., X or Y)" — high enough confidence to flag anywhere
-        if (UNRESOLVED_PAREN_RE.test(lines[i])) {
-            matches.push(i + 1);
-            continue;
-        }
-        // Pattern B: inline options — only inside critical sections to avoid prose false-positives
-        if (inCritical && UNRESOLVED_INLINE_RE.test(lines[i])) {
-            matches.push(i + 1);
-        }
-    }
-    return matches;
-}
-// Required top-level sections (by heading text, case-insensitive)
-const REQUIRED_SECTIONS = [
-    'pre-flight',
-    'specification layer',
-    'intent layer',
-    'context layer',
-    'prompt layer',
-    'governance & validation',
+// Matches the nimai-spec marker (with or without tier attribute)
+const NIMAI_MARKER_RE = /<!--\s*nimai-spec(?:\s+tier=(lite|full))?\s*-->/;
+// ─── Required sections per tier ─────────────────────────────────────────────
+// Headings are matched literally against these exact strings.
+const LITE_REQUIRED_SECTIONS = [
+    'Deliverable',
+    'Scope',
+    'Acceptance Criteria',
+    'Mechanism Decisions',
+    'Spec Convergence',
 ];
-// Advisory: architecture quality signals (anti-spaghetti rules)
-// Each rule looks for at least one keyword/heading indicating the concept is addressed.
-// Rules marked hardFailTiers become hard failures (not advisory) when the spec's risk tier
-// matches AND (if codingOnly=true) the spec is a coding/tooling/server spec.
-const ADVISORY_RULES = [
-    {
-        type: 'missing_module_boundary',
-        keywords: ['module boundary', 'package boundary', 'layer boundary', 'separation of concerns', 'packages/core', 'packages/mcp', 'packages/cli', 'app/models', 'app/state', 'app/db'],
-        message: 'No module boundary definition found — document package/layer boundaries and which layers may not import each other',
-        hardFailTiers: ['medium', 'high'],
-        codingOnly: true,
-    },
-    {
-        type: 'missing_interface_contract',
-        keywords: ['interface contract', 'api contract', 'tool schema', 'modeladapter', 'input schema', 'output shape', 'zod'],
-        message: 'No interface contract found — consider documenting API/tool schemas or interfaces',
-    },
-    {
-        type: 'missing_non_goals',
-        keywords: ['non-goal', 'non-goals', 'must-not', 'scope — out', 'out of scope', 'deferred', 'excluded'],
-        message: 'No non-goals or out-of-scope section found — document what this spec explicitly excludes',
-        hardFailTiers: ['medium', 'high'],
-    },
-    {
-        type: 'missing_change_surface',
-        keywords: ['change surface', 'breaking change', 'migration', 'backward compat', 'semver', 'versioning', 'deprecat'],
-        message: 'No change surface documentation found — document compatibility expectations and what this spec must not break',
-        hardFailTiers: ['medium', 'high'],
-    },
-    {
-        type: 'missing_dependency_direction',
-        keywords: ['dependency direction', 'may not import', 'must not import', 'import from', 'no cross-layer', 'dependency rule', 'import rule'],
-        message: 'No dependency direction rules found — document which modules/layers may import which (prevents circular and cross-layer dependencies)',
-        hardFailTiers: ['medium', 'high'],
-        codingOnly: true,
-        skipAdvisoryForTiers: ['low', 'unknown'],
-    },
+const FULL_REQUIRED_SECTIONS = [
+    ...LITE_REQUIRED_SECTIONS,
+    'Task Decomposition',
+    'Architecture Lock',
+    'Change Surface',
+    'Edge Cases and Failure Modes',
 ];
-function lintSpec(filePath) {
-    let content;
-    try {
-        content = fs.readFileSync(filePath, 'utf-8');
-    }
-    catch (err) {
-        throw new Error(`Cannot read spec at "${filePath}": ${err.message}`);
-    }
-    return lintContent(content);
-}
-/** Detect risk tier from checked checkbox in spec content */
-function detectRiskTier(content) {
-    if (/\[x\]\s*high/i.test(content))
-        return 'high';
-    if (/\[x\]\s*medium/i.test(content))
-        return 'medium';
-    if (/\[x\]\s*low/i.test(content))
-        return 'low';
-    return 'unknown';
-}
-/** Detect if this is a coding/tooling/server spec (vs docs/research/strategy) */
-function isCodingSpec(content) {
-    const lower = content.toLowerCase();
-    return (lower.includes('if coding') ||
-        lower.includes('language / framework') ||
-        lower.includes('language/framework') ||
-        lower.includes('test coverage expectation') ||
-        lower.includes('performance targets'));
-}
-function lintContent(content) {
-    const issues = [];
-    const lines = content.split('\n');
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        const lineNum = i + 1;
-        if (BLANK_FIELD_RE.test(line)) {
-            issues.push(issue(lineNum, 'blank_field', `Unfilled placeholder on line ${lineNum}`));
-        }
-        if (NHFI_RE.test(line)) {
-            issues.push(issue(lineNum, 'needs_human_input', `Unresolved [NEEDS HUMAN INPUT] flag on line ${lineNum}`));
-        }
-    }
-    // Pre-checked acceptance criteria — hard fail: ACs must be unchecked in a draft spec
-    if (PRE_CHECKED_AC_RE.test(content)) {
-        const matchLines = lines.reduce((acc, l, i) => {
-            if (/^[-*]\s+\[x\]/i.test(l))
-                acc.push(i + 1);
-            return acc;
-        }, []);
-        for (const lineNum of matchLines) {
-            issues.push(issue(lineNum, 'pre_checked_ac', `Pre-checked list item on line ${lineNum} — acceptance criteria must be unchecked ([ ]) in a draft spec`));
-        }
-    }
-    const lower = content.toLowerCase();
-    for (const section of REQUIRED_SECTIONS) {
-        if (!lower.includes(section)) {
-            issues.push(issue(0, 'missing_section', `Required section missing: "${section}"`));
-        }
-    }
-    // Missing nimai-spec marker — advisory: spec was not created or registered by nimai
-    if (!NIMAI_MARKER_RE.test(content)) {
-        issues.push(advisoryIssue(0, 'missing_marker', 'No <!-- nimai-spec --> marker found — add it so nimai can discover this spec automatically (nimai new stamps it)'));
-    }
-    // Unresolved mechanism — spec offers options instead of committing to one path.
-    // Hard-fail for medium/high risk specs; advisory for low/unknown.
-    const riskTier = detectRiskTier(content);
-    const coding = isCodingSpec(content);
-    const unresolvedMatches = detectUnresolvedMechanisms(lines);
-    for (const lineNum of unresolvedMatches) {
-        const isHard = riskTier === 'medium' || riskTier === 'high';
-        const msg = `Unresolved mechanism on line ${lineNum} — spec must commit to a single implementation path, not offer options (e.g. "e.g., X or Y")`;
-        issues.push(isHard
-            ? issue(lineNum, 'unresolved_mechanism', msg)
-            : advisoryIssue(lineNum, 'unresolved_mechanism', msg));
-    }
-    // Mechanism Decision section — deterministic contract lock
-    issues.push(...mechanismDecisionIssues(content, lines, riskTier));
-    // Spec Convergence section — GO gate: zero open questions, zero ambiguities
-    issues.push(...convergenceIssues(content, lines, riskTier));
-    // Architecture Lock section — process-level architecture completeness gate
-    issues.push(...architectureLockIssues(lines, riskTier, coding));
-    // Edge Cases and Failure Modes — adversarial gap check (Option 3)
-    issues.push(...edgeCasesIssues(lines, riskTier));
-    for (const rule of ADVISORY_RULES) {
-        const found = rule.keywords.some(kw => lower.includes(kw.toLowerCase()));
-        if (!found) {
-            const shouldHardFail = rule.hardFailTiers !== undefined &&
-                rule.hardFailTiers.includes(riskTier) &&
-                (!rule.codingOnly || coding);
-            if (shouldHardFail) {
-                issues.push(issue(0, rule.type, `${rule.message} [required for ${riskTier}-risk${rule.codingOnly ? ' coding' : ''} specs]`));
-            }
-            else if (!rule.skipAdvisoryForTiers?.includes(riskTier)) {
-                issues.push(advisoryIssue(0, rule.type, rule.message));
-            }
-        }
-    }
-    return issues;
-}
-/**
- * Validate the Architecture Lock section contract.
- * - For medium/high coding specs: missing section or unresolved field is hard fail.
- * - For low/unknown/non-coding specs: advisory only.
- * - Unresolved values include blank, placeholder underscores, or "TBD".
- */
-function architectureLockIssues(lines, riskTier, coding) {
-    const result = [];
-    const requiresHardFail = coding && (riskTier === 'medium' || riskTier === 'high');
-    const startIdx = lines.findIndex(l => /^#{1,3}\s+.*architecture\s*lock/i.test(l));
-    if (startIdx === -1) {
-        const msg = 'No "Architecture Lock" section found — add "## 1.6 Architecture Lock" with all required architecture fields before builder handoff';
-        result.push(requiresHardFail ? issue(0, 'missing_architecture_lock', msg) : advisoryIssue(0, 'missing_architecture_lock', msg));
-        return result;
-    }
-    const headingLevel = (lines[startIdx].match(/^(#{1,6})/) ?? ['', '#'])[1].length;
-    let endIdx = lines.length;
-    for (let i = startIdx + 1; i < lines.length; i++) {
-        const m = lines[i].match(/^(#{1,6})\s+/);
-        if (m && m[1].length <= headingLevel) {
-            endIdx = i;
-            break;
-        }
-    }
-    const sectionLines = lines.slice(startIdx, endIdx);
-    const REQUIRED_FIELDS = [
-        { label: 'Persistence layer', keys: ['persistence layer:'] },
-        { label: 'File/object storage', keys: ['file/object storage:', 'file / object storage:'] },
-        { label: 'External model/service + env var', keys: ['external model/service + env var:', 'external model / service + env var:'] },
-        { label: 'API trigger flow', keys: ['api trigger flow:'] },
-        { label: 'Entity status state machine', keys: ['entity status state machine:'] },
-        { label: 'Auth implementation', keys: ['auth implementation:'] },
-    ];
-    for (const field of REQUIRED_FIELDS) {
-        const localIdx = sectionLines.findIndex((line) => {
-            const lower = line.trim().toLowerCase();
-            return field.keys.some((k) => lower.startsWith(k));
-        });
-        if (localIdx === -1) {
-            const msg = `Architecture Lock is missing required field "${field.label}:"`;
-            result.push(requiresHardFail ? issue(startIdx + 1, 'missing_architecture_lock', msg) : advisoryIssue(startIdx + 1, 'missing_architecture_lock', msg));
-            continue;
-        }
-        const absLine = startIdx + localIdx + 1;
-        const value = sectionLines[localIdx].slice(sectionLines[localIdx].indexOf(':') + 1).trim();
-        if (!value || UNRESOLVED_ARCH_VALUE_RE.test(value)) {
-            const msg = `Architecture Lock field "${field.label}" on line ${absLine} is unresolved (blank/placeholder/TBD)`;
-            result.push(requiresHardFail ? issue(absLine, 'missing_architecture_lock', msg) : advisoryIssue(absLine, 'missing_architecture_lock', msg));
-        }
-    }
-    return result;
-}
 /**
- * Validate the Mechanism Decision section contract.
- * - If absent on a medium/high spec: hard-fail. Advisory on low/unknown.
- * - If present: all four required fields must be non-blank; "Chosen approach" must not contain
- *   option language. Validation is scoped to the section, not the whole file.
+ * The pre_checked_ac rule fires only on "- [x]" items inside the
+ * Acceptance Criteria and Task Decomposition sections — not globally.
  */
-function mechanismDecisionIssues(content, lines, riskTier) {
+function findPreCheckedAcsInScope(lines) {
     const result = [];
-    const sectionStartIdx = lines.findIndex(l => /^#{1,3}\s+.*mechanism\s*decision/i.test(l));
-    if (sectionStartIdx === -1) {
-        const msg = 'No "Mechanism Decision" section found — add one with "Chosen approach:", "Rejected alternatives:", "Why rejected:", "Impact on ACs:" for each core mechanism (prevents builder drift in multi-agent workflows)';
-        const isHard = riskTier === 'medium' || riskTier === 'high';
-        result.push(isHard ? issue(0, 'missing_mechanism_decision', msg) : advisoryIssue(0, 'missing_mechanism_decision', msg));
-        return result;
-    }
-    // Determine section end: next heading at same or higher level (fewer #s), or EOF
-    const headingLevel = (lines[sectionStartIdx].match(/^(#{1,6})/) ?? ['', '#'])[1].length;
-    let sectionEndIdx = lines.length;
-    for (let i = sectionStartIdx + 1; i < lines.length; i++) {
-        const m = lines[i].match(/^(#{1,6})\s+/);
-        if (m && m[1].length <= headingLevel) {
-            sectionEndIdx = i;
-            break;
-        }
-    }
-    const sectionLines = lines.slice(sectionStartIdx, sectionEndIdx);
-    // All four required fields must be present and non-blank (N/A is accepted)
-    const REQUIRED_FIELDS = [
-        { key: 'chosen approach:', label: 'Chosen approach' },
-        { key: 'rejected alternatives:', label: 'Rejected alternatives' },
-        { key: 'why rejected:', label: 'Why rejected' },
-        { key: 'impact on acs:', label: 'Impact on ACs' },
-    ];
-    for (const { key, label } of REQUIRED_FIELDS) {
-        const lineIdx = sectionLines.findIndex(l => l.trim().toLowerCase().startsWith(key));
-        if (lineIdx === -1) {
-            result.push(issue(sectionStartIdx + 1, 'ambiguous_chosen_approach', `Mechanism Decision section is missing required field "${label}:" — add it for every core mechanism`));
+    const scopeSections = new Set(['Acceptance Criteria', 'Task Decomposition']);
+    let inScope = false;
+    for (let i = 0; i < lines.length; i++) {
+        const headingMatch = lines[i].match(/^#{1,6}\s+(.+)$/);
+        if (headingMatch) {
+            inScope = scopeSections.has(headingMatch[1].trim());
             continue;
         }
-        const absLine = sectionStartIdx + lineIdx + 1;
-        const colonPos = sectionLines[lineIdx].indexOf(':');
-        const value = sectionLines[lineIdx].slice(colonPos + 1).trim();
-        if (!value || /_{3,}/.test(value)) {
-            result.push(issue(absLine, 'ambiguous_chosen_approach', `"${label}" on line ${absLine} is blank — fill it in or write "N/A" with justification`));
-        }
-        else if (key === 'chosen approach:' &&
-            /\b(?:or|could|might)\b|\be\.g\.|\bsuch as\b|\bfor example\b/i.test(value)) {
-            result.push(issue(absLine, 'ambiguous_chosen_approach', `"Chosen approach" on line ${absLine} contains option language ("or/could/might/e.g./such as/for example") — must commit to one mechanism, not offer choices`));
+        if (inScope && /^[-*]\s+\[x\]/i.test(lines[i])) {
+            result.push(i + 1);
         }
     }
     return result;
 }
 /**
- * Enforce the Edge Cases and Failure Modes section.
- * Requires the spec author to do adversarial thinking before handing off.
- * - Absent on medium/high risk: hard-fail.
- * - Absent on low/unknown: advisory.
- * Content completeness (blank fields) is caught separately by the blank_field rule.
- */
-function edgeCasesIssues(lines, riskTier) {
-    const found = lines.some(l => /^#{1,3}\s+.*(?:edge\s*cases|failure\s*modes)/i.test(l));
-    if (found)
-        return [];
-    const msg = 'No "Edge Cases and Failure Modes" section found — add one to red-team the spec before builder handoff (scope creep, hallucinated completion, intent drift, domain-specific edge cases)';
-    const isHard = riskTier === 'medium' || riskTier === 'high';
-    return [isHard ? issue(0, 'missing_edge_cases', msg) : advisoryIssue(0, 'missing_edge_cases', msg)];
-}
-/**
- * Validate the Spec Convergence section — the formal GO declaration.
- * - If absent on a medium/high spec: hard-fail. Advisory on low/unknown.
- * - If present: open_questions and ambiguities_remaining must both be "0".
- *   ready_for_build: "no" is always a hard-fail (explicit NO_GO declaration).
+ * Check the Spec Convergence section.
+ * - Absent: hard fail (unresolved_convergence via missing_convergence_section mapping)
+ * - open_questions non-zero: hard fail
+ * - ambiguities_remaining non-zero: hard fail
+ * - ready_for_build "no": hard fail
  */
-function convergenceIssues(content, lines, riskTier) {
+function convergenceIssues(lines) {
     const result = [];
-    const sectionStartIdx = lines.findIndex(l => /^#{1,3}\s+.*spec\s*convergence/i.test(l));
+    const sectionStartIdx = lines.findIndex(l => /^#{1,6}\s+Spec Convergence\s*$/.test(l));
     if (sectionStartIdx === -1) {
-        const msg = 'No "Spec Convergence" section found — add one with "open_questions: 0", "ambiguities_remaining: 0", and "ready_for_build: yes" to declare the spec is agent-ready';
-        const isHard = riskTier === 'medium' || riskTier === 'high';
-        result.push(isHard ? issue(0, 'missing_convergence_section', msg) : advisoryIssue(0, 'missing_convergence_section', msg));
-        return result;
+        return [issue(0, 'missing_convergence_section', 'No "Spec Convergence" section found — add one with "open_questions: 0", "ambiguities_remaining: 0", and "ready_for_build: yes"')];
     }
-    // Determine section end: next heading at same or higher level (fewer #s), or EOF
     const headingLevel = (lines[sectionStartIdx].match(/^(#{1,6})/) ?? ['', '#'])[1].length;
     let sectionEndIdx = lines.length;
     for (let i = sectionStartIdx + 1; i < lines.length; i++) {
@@ -369,7 +102,6 @@ function convergenceIssues(content, lines, riskTier) {
         }
     }
     const sectionLines = lines.slice(sectionStartIdx, sectionEndIdx);
-    // Check required integer fields — must be present and equal "0"
     const INTEGER_FIELDS = [
         { key: 'open_questions:', label: 'open_questions' },
         { key: 'ambiguities_remaining:', label: 'ambiguities_remaining' },
@@ -377,28 +109,73 @@ function convergenceIssues(content, lines, riskTier) {
     for (const { key, label } of INTEGER_FIELDS) {
         const lineIdx = sectionLines.findIndex(l => l.trim().toLowerCase().startsWith(key));
         if (lineIdx === -1) {
-            result.push(issue(sectionStartIdx + 1, 'unresolved_convergence', `Spec Convergence section is missing required field "${label}:" — add it and set it to 0 when all issues are resolved`));
+            result.push(issue(sectionStartIdx + 1, 'unresolved_convergence', `Spec Convergence section is missing required field "${label}:" — set it to 0 when resolved`));
             continue;
         }
         const absLine = sectionStartIdx + lineIdx + 1;
-        const colonPos = sectionLines[lineIdx].indexOf(':');
-        const value = sectionLines[lineIdx].slice(colonPos + 1).trim();
+        const value = sectionLines[lineIdx].slice(sectionLines[lineIdx].indexOf(':') + 1).trim();
         if (value !== '0') {
             result.push(issue(absLine, 'unresolved_convergence', `"${label}" on line ${absLine} is "${value}" — must be 0 before handoff to builder`));
         }
     }
-    // Check ready_for_build — explicit "no" is always a hard-fail
     const rfbLineIdx = sectionLines.findIndex(l => l.trim().toLowerCase().startsWith('ready_for_build:'));
     if (rfbLineIdx !== -1) {
         const absLine = sectionStartIdx + rfbLineIdx + 1;
-        const colonPos = sectionLines[rfbLineIdx].indexOf(':');
-        const value = sectionLines[rfbLineIdx].slice(colonPos + 1).trim().toLowerCase();
+        const value = sectionLines[rfbLineIdx].slice(sectionLines[rfbLineIdx].indexOf(':') + 1).trim().toLowerCase();
         if (value === 'no') {
             result.push(issue(absLine, 'unresolved_convergence', `"ready_for_build" on line ${absLine} is "no" — spec is explicitly declared not ready for build`));
         }
     }
     return result;
 }
+function lintSpec(filePath) {
+    let content;
+    try {
+        content = fs.readFileSync(filePath, 'utf-8');
+    }
+    catch (err) {
+        throw new Error(`Cannot read spec at "${filePath}": ${err.message}`);
+    }
+    return lintContent(content);
+}
+function lintContent(content) {
+    const issues = [];
+    const lines = content.split('\n');
+    // ── Rule: blank_placeholder — hard fail when a required section has ___
+    for (let i = 0; i < lines.length; i++) {
+        if (BLANK_PLACEHOLDER_RE.test(lines[i])) {
+            issues.push(issue(i + 1, 'blank_placeholder', `Unfilled placeholder on line ${i + 1} — fill in or remove underscore runs of 3+`));
+        }
+        if (NHFI_RE.test(lines[i])) {
+            // Treat NHFI as a blank_placeholder variant (hard fail)
+            issues.push(issue(i + 1, 'blank_placeholder', `Unresolved [NEEDS HUMAN INPUT] flag on line ${i + 1}`));
+        }
+    }
+    // ── Rule: missing_marker — advisory: no nimai-spec marker found
+    if (!NIMAI_MARKER_RE.test(content)) {
+        issues.push(advisoryIssue(0, 'missing_marker', 'No <!-- nimai-spec --> marker found — add it so nimai can discover this spec (use tier=lite or tier=full)'));
+    }
+    // ── Determine tier from marker (bare marker = full for legacy compat)
+    const tier = (0, template_1.parseTierFromMarker)(content);
+    const requiredSections = tier === 'lite' ? LITE_REQUIRED_SECTIONS : FULL_REQUIRED_SECTIONS;
+    // ── Rule: missing_required_section — tier-aware; literal heading match
+    const headings = lines
+        .filter(l => /^#{1,6}\s+/.test(l))
+        .map(l => l.replace(/^#{1,6}\s+/, '').trim());
+    for (const section of requiredSections) {
+        if (!headings.includes(section)) {
+            issues.push(issue(0, 'missing_required_section', `Required section missing for ${tier}-tier spec: "## ${section}"`));
+        }
+    }
+    // ── Rule: pre_checked_ac — hard fail, scoped to AC and Task Decomposition sections
+    const preCheckedLines = findPreCheckedAcsInScope(lines);
+    for (const lineNum of preCheckedLines) {
+        issues.push(issue(lineNum, 'pre_checked_ac', `Pre-checked item on line ${lineNum} — acceptance criteria must be unchecked ([ ]) in a draft spec`));
+    }
+    // ── Rule: unresolved_convergence — hard fail when convergence section has issues
+    issues.push(...convergenceIssues(lines));
+    return issues;
+}
 function issue(line, type, message) {
     return { line, type, message };
 }

package/dist/lint.js.map

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

package/dist/prompts.d.ts

@@ -1,15 +1,24 @@
 /**
- * FORGE prompt builders — pure string functions, no IO, no LLM calls.
- * These live in @nimai/core so any package can import them without
- * depending on @nimai/mcp internals.
+ * Nimai prompt builders — pure string functions, no IO, no LLM calls.
+ * These live in nimai-core so any package can import them without
+ * depending on nimai-mcp internals.
+ *
+ * Template texts are passed in by callers (MCP server, CLI spec command)
+ * which load them via template.ts. prompts.ts stays pure (no fs/IO).
  */
 /**
- * FORGE Prompt 1 — Self-Spec Agent (from FORGE-quickref.md).
- * Returns the populated prompt ready to hand to a host model.
+ * Nimai Spec Protocol — PHASE 1 through PHASE 4.
+ * Returns the protocol prompt the host model runs to turn a loose request
+ * into a graded, build-ready spec.
+ *
+ * Callers load liteTemplate and fullTemplate via loadTierTemplate() from template.ts
+ * and pass them here. The [EMBED] placeholder is replaced with both template texts.
+ *
+ * Signature: buildSpecProtocol(request, repoPath, liteTemplate, fullTemplate)
  */
-export declare function buildPrompt1(request: string, contextSummary: string): string;
+export declare function buildSpecProtocol(request: string, repoPath: string, liteTemplate: string, fullTemplate: string): string;
 /**
- * FORGE Prompt 1.5 — Spec-Quality Reviewer.
+ * Nimai Prompt 1.5 — Spec-Quality Reviewer.
  * Returns a prompt for a reviewing LLM to evaluate whether a draft spec is
  * executable by an agent without requiring clarifying questions.
  *
@@ -23,8 +32,9 @@ export declare function buildPrompt1(request: string, contextSummary: string): s
  */
 export declare function buildPrompt15(specContent: string): string;
 /**
- * FORGE Prompt 2 — Reviewer / Validator Prompt Generator (from FORGE-quickref.md).
+ * Nimai Prompt 2 — Implementation Reviewer Prompt Generator.
  * Returns the populated reviewer prompt derived from an approved spec.
+ * Used for reviewing an implementation against the spec (target=implementation).
  */
 export declare function buildPrompt2(specContent: string): string;
 //# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAkC5E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAkGzD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAgBxD"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,MAAM,CAsER;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA4GzD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAgBxD"}