@vaubaan/harness 0.0.0-stage → 1.3.2

package/dist/linters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/linters/util.ts","../../src/linters/adr-no-tracks.ts","../../src/linters/cardinal-files.ts","../../src/linters/config.ts","../../src/linters/cross-links.ts","../../src/linters/decision-schema.ts","../../src/linters/doc-layout.ts","../../src/linters/frontmatter-tracks.ts","../../src/linters/gitignore-harness.ts","../../src/linters/orphan-decisions.ts","../../src/linters/quality-schema.ts","../../src/linters/readme-presence.ts","../../src/linters/readme-sections.ts","../../src/linters/spec-has-content.ts","../../src/linters/spec-tech-agnostic.ts","../../src/linters/tracks-drift.ts","../../src/linters/index.ts"],"sourcesContent":["import { execFileSync } from \"node:child_process\";\nimport { existsSync, readFileSync, statSync } from \"node:fs\";\nimport { join, relative } from \"node:path\";\nimport fg from \"fast-glob\";\nimport matter from \"gray-matter\";\n\nexport function fileExists(repoRoot: string, relativePath: string): boolean {\n  return existsSync(join(repoRoot, relativePath));\n}\n\nexport function readText(repoRoot: string, relativePath: string): string {\n  return readFileSync(join(repoRoot, relativePath), \"utf8\");\n}\n\nexport function listMarkdown(repoRoot: string, dir: string): string[] {\n  const cwd = join(repoRoot, dir);\n  if (!existsSync(cwd)) return [];\n  return fg\n    .sync(\"**/*.md\", { cwd, absolute: false, ignore: [\"**/node_modules/**\", \"**/dist/**\"] })\n    .filter((f) => !f.endsWith(\"README.md\"))\n    .map((f) => join(dir, f));\n}\n\nexport function listAllMarkdown(repoRoot: string, dir: string): string[] {\n  const cwd = join(repoRoot, dir);\n  if (!existsSync(cwd)) return [];\n  return fg\n    .sync(\"**/*.md\", { cwd, absolute: false, ignore: [\"**/node_modules/**\", \"**/dist/**\"] })\n    .map((f) => join(dir, f));\n}\n\nexport function dirExists(repoRoot: string, relativePath: string): boolean {\n  const full = join(repoRoot, relativePath);\n  if (!existsSync(full)) return false;\n  return statSync(full).isDirectory();\n}\n\nexport function parseFrontmatter(text: string): { data: Record<string, unknown>; body: string } {\n  const m = matter(text);\n  return { data: m.data, body: m.content };\n}\n\nexport interface GitLogEntry {\n  hash: string;\n  timestamp: number;\n}\n\nexport function gitLastCommitForPath(\n  repoRoot: string,\n  relativePath: string,\n): GitLogEntry | undefined {\n  try {\n    const out = execFileSync(\"git\", [\"log\", \"-1\", \"--format=%H:%ct\", \"--\", relativePath], {\n      cwd: repoRoot,\n      encoding: \"utf8\",\n      stdio: [\"ignore\", \"pipe\", \"ignore\"],\n    }).trim();\n    if (!out) return undefined;\n    const idx = out.indexOf(\":\");\n    if (idx < 0) return undefined;\n    const hash = out.slice(0, idx);\n    const ts = Number.parseInt(out.slice(idx + 1), 10);\n    return { hash, timestamp: ts };\n  } catch {\n    return undefined;\n  }\n}\n\nexport function gitCommitsSince(\n  repoRoot: string,\n  relativePath: string,\n  sinceCommit: string,\n): number {\n  try {\n    const out = execFileSync(\n      \"git\",\n      [\"log\", `${sinceCommit}..HEAD`, \"--format=%H\", \"--\", relativePath],\n      {\n        cwd: repoRoot,\n        encoding: \"utf8\",\n        stdio: [\"ignore\", \"pipe\", \"ignore\"],\n      },\n    ).trim();\n    if (!out) return 0;\n    return out.split(\"\\n\").filter(Boolean).length;\n  } catch {\n    return 0;\n  }\n}\n\nexport function relPath(repoRoot: string, abs: string): string {\n  return relative(repoRoot, abs);\n}\n\nexport function findLineNumber(text: string, needle: string | RegExp): number | undefined {\n  const lines = text.split(\"\\n\");\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i] ?? \"\";\n    if (typeof needle === \"string\" ? line.includes(needle) : needle.test(line)) {\n      return i + 1;\n    }\n  }\n  return undefined;\n}\n","import type { LintIssue, Linter } from \"./types.js\";\nimport { listMarkdown, parseFrontmatter, readText } from \"./util.js\";\n\nconst ADR_DIR = \"docs/decisions\";\n\nexport const adrNoTracks: Linter = {\n  id: \"lint:adr-no-tracks\",\n  pillars: [\"decisions\"],\n  defaultSeverity: \"error\",\n  suggestedSkills: [\"/decision\"],\n  run(repoRoot: string): LintIssue[] {\n    const issues: LintIssue[] = [];\n    const files = listMarkdown(repoRoot, ADR_DIR);\n    for (const f of files) {\n      const text = readText(repoRoot, f);\n      const { data } = parseFrontmatter(text);\n      if (!(\"tracks\" in data)) continue;\n      const value = data.tracks;\n      if (Array.isArray(value) && value.length === 0) continue;\n      issues.push({\n        linter: this.id,\n        severity: \"error\",\n        file: f,\n        message:\n          \"ADRs must not declare `tracks:` (or must set it to []). ADRs document a decision frozen in time, not the current state of code — use status: superseded to mark them obsolete instead.\",\n      });\n    }\n    return issues;\n  },\n};\n","import type { LintIssue, Linter } from \"./types.js\";\nimport { fileExists } from \"./util.js\";\n\nconst REQUIRED_FILES = [\n  \"docs/tests/integration-tests.md\",\n  \"docs/tests/e2e-tests.md\",\n  \"docs/workflow/coding-workflow.md\",\n];\n\nexport const cardinalFiles: Linter = {\n  id: \"lint:cardinal-files\",\n  pillars: [\"tests\", \"workflow\"],\n  defaultSeverity: \"error\",\n  suggestedSkills: [\"/test-plan\", \"/workflow\"],\n  run(repoRoot: string): LintIssue[] {\n    const issues: LintIssue[] = [];\n    for (const f of REQUIRED_FILES) {\n      if (!fileExists(repoRoot, f)) {\n        issues.push({\n          linter: this.id,\n          severity: \"error\",\n          file: f,\n          message: `missing required cardinal file: ${f}`,\n        });\n      }\n    }\n    return issues;\n  },\n};\n","import { cosmiconfigSync } from \"cosmiconfig\";\n\nexport interface HarnessLintConfig {\n  ignore: ReadonlyArray<string>;\n}\n\nconst DEFAULT_CONFIG: HarnessLintConfig = { ignore: [] };\n\nexport function loadLintConfig(repoRoot: string): HarnessLintConfig {\n  const explorer = cosmiconfigSync(\"harness\", {\n    searchPlaces: [\n      \"package.json\",\n      \".harnessrc\",\n      \".harnessrc.json\",\n      \".harnessrc.yaml\",\n      \".harnessrc.yml\",\n      \"harness.config.js\",\n      \"harness.config.cjs\",\n    ],\n  });\n  const result = explorer.search(repoRoot);\n  if (!result || result.isEmpty) return DEFAULT_CONFIG;\n\n  const raw = result.config as Record<string, unknown> | undefined;\n  if (!raw) return DEFAULT_CONFIG;\n\n  const lint = raw.lint as Record<string, unknown> | undefined;\n  if (!lint) return DEFAULT_CONFIG;\n\n  const ignore = lint.ignore;\n  if (!Array.isArray(ignore)) return DEFAULT_CONFIG;\n\n  return { ignore: ignore.filter((x): x is string => typeof x === \"string\") };\n}\n","import { existsSync } from \"node:fs\";\nimport { dirname, isAbsolute, join, resolve } from \"node:path\";\nimport fg from \"fast-glob\";\nimport type { LintContext, LintIssue, Linter } from \"./types.js\";\nimport { readText } from \"./util.js\";\n\nconst LINK_REGEX = /\\[([^\\]]+)\\]\\(([^)]+)\\)/g;\n\nfunction maskCodeSpans(text: string): string {\n  return text\n    .replace(/```[\\s\\S]*?```/g, (m) => m.replace(/[^\\n]/g, \" \"))\n    .replace(/`[^`\\n]*`/g, (m) => \" \".repeat(m.length));\n}\n\nfunction isExternalOrAnchor(url: string): boolean {\n  if (url.startsWith(\"http://\") || url.startsWith(\"https://\")) return true;\n  if (url.startsWith(\"mailto:\")) return true;\n  if (url.startsWith(\"#\")) return true;\n  return false;\n}\n\nfunction stripFragment(url: string): string {\n  const i = url.indexOf(\"#\");\n  return i < 0 ? url : url.slice(0, i);\n}\n\nfunction resolveLink(repoRoot: string, sourceFile: string, link: string): string {\n  const noFrag = stripFragment(link);\n  if (isAbsolute(noFrag)) return join(repoRoot, noFrag);\n  return resolve(dirname(join(repoRoot, sourceFile)), noFrag);\n}\n\nexport const crossLinks: Linter = {\n  id: \"lint:cross-links\",\n  pillars: [\"all\"],\n  defaultSeverity: \"error\",\n  run(repoRoot: string, ctx?: LintContext): LintIssue[] {\n    const extra = ctx?.config.ignore ?? [];\n    const issues: LintIssue[] = [];\n    const allDocs = fg.sync(\"**/*.md\", {\n      cwd: repoRoot,\n      absolute: false,\n      ignore: [\n        \"**/node_modules/**\",\n        \"**/dist/**\",\n        \".harness-overrides/**\",\n        \"skills/**\",\n        \"agents/**\",\n        \"commands/**\",\n        \"templates/**\",\n        \"**/*.skill.md\",\n        \"**/*.cmd.md\",\n        \"**/*.agent.md\",\n        ...extra,\n      ],\n    });\n    for (const f of allDocs) {\n      const text = maskCodeSpans(readText(repoRoot, f));\n      const lines = text.split(\"\\n\");\n      for (let lineNo = 0; lineNo < lines.length; lineNo++) {\n        const line = lines[lineNo] ?? \"\";\n        LINK_REGEX.lastIndex = 0;\n        let match: RegExpExecArray | null;\n        match = LINK_REGEX.exec(line);\n        while (match !== null) {\n          const url = match[2];\n          if (url && !isExternalOrAnchor(url)) {\n            const noFrag = stripFragment(url);\n            if (noFrag !== \"\" && !noFrag.startsWith(\"data:\")) {\n              const target = resolveLink(repoRoot, f, url);\n              if (!existsSync(target)) {\n                issues.push({\n                  linter: this.id,\n                  severity: \"error\",\n                  file: f,\n                  line: lineNo + 1,\n                  message: `broken link: ${url}`,\n                });\n              }\n            }\n          }\n          match = LINK_REGEX.exec(line);\n        }\n      }\n    }\n    return issues;\n  },\n};\n","import type { LintIssue, Linter } from \"./types.js\";\nimport { listMarkdown, readText } from \"./util.js\";\n\n// English headings are canonical; the French ones are still accepted so\n// projects written before the switch to English keep passing.\nconst REQUIRED_SECTIONS: Array<{ label: string; pattern: RegExp }> = [\n  { label: \"Context\", pattern: /^##\\s+(Context|Contexte)\\b/m },\n  { label: \"Decision\", pattern: /^##\\s+(Decision|D[ée]cision)\\b/m },\n  { label: \"Consequences\", pattern: /^##\\s+(Consequences|Cons[ée]quences)\\b/m },\n  {\n    label: \"Rejected alternatives\",\n    pattern: /^##\\s+(Rejected\\s+alternatives|Alternatives(\\s+rejet[ée]es)?)\\b/im,\n  },\n];\n\nexport const decisionSchema: Linter = {\n  id: \"lint:decision-schema\",\n  pillars: [\"decisions\"],\n  defaultSeverity: \"error\",\n  suggestedSkills: [\"/decision\"],\n  run(repoRoot: string): LintIssue[] {\n    const issues: LintIssue[] = [];\n    const files = listMarkdown(repoRoot, \"docs/decisions\");\n    for (const f of files) {\n      const text = readText(repoRoot, f);\n      for (const { label, pattern } of REQUIRED_SECTIONS) {\n        if (!pattern.test(text)) {\n          issues.push({\n            linter: this.id,\n            severity: \"error\",\n            file: f,\n            message: `missing required section: \"${label}\"`,\n          });\n        }\n      }\n    }\n    return issues;\n  },\n};\n","import type { LintIssue, Linter } from \"./types.js\";\nimport { dirExists } from \"./util.js\";\n\nconst REQUIRED_DIRS = [\n  \"docs/spec\",\n  \"docs/decisions\",\n  \"docs/handbook\",\n  \"docs/tests\",\n  \"docs/workflow\",\n];\n\nexport const docLayout: Linter = {\n  id: \"lint:doc-layout\",\n  pillars: [\"all\"],\n  defaultSeverity: \"error\",\n  run(repoRoot: string): LintIssue[] {\n    const issues: LintIssue[] = [];\n    for (const dir of REQUIRED_DIRS) {\n      if (!dirExists(repoRoot, dir)) {\n        issues.push({\n          linter: this.id,\n          severity: \"error\",\n          file: dir,\n          message: `missing required directory: ${dir}/`,\n        });\n      }\n    }\n    return issues;\n  },\n};\n","import { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport fg from \"fast-glob\";\nimport type { LintIssue, Linter } from \"./types.js\";\nimport { listMarkdown, parseFrontmatter, readText } from \"./util.js\";\n\nconst TRACKED_DIRS = [\"docs/handbook\", \"docs/tests\", \"docs/workflow\"];\n\nfunction trackedPathExists(repoRoot: string, pattern: string): boolean {\n  if (pattern.includes(\"*\")) {\n    return fg.sync(pattern, { cwd: repoRoot, absolute: false }).length > 0;\n  }\n  return existsSync(join(repoRoot, pattern));\n}\n\nexport const frontmatterTracks: Linter = {\n  id: \"lint:frontmatter-tracks\",\n  pillars: [\"handbook\", \"tests\", \"workflow\"],\n  defaultSeverity: \"error\",\n  suggestedSkills: [\"/handbook\", \"/test-plan\", \"/workflow\"],\n  run(repoRoot: string): LintIssue[] {\n    const issues: LintIssue[] = [];\n    for (const dir of TRACKED_DIRS) {\n      const files = listMarkdown(repoRoot, dir);\n      for (const f of files) {\n        const text = readText(repoRoot, f);\n        const { data } = parseFrontmatter(text);\n        if (!Array.isArray(data.tracks)) {\n          issues.push({\n            linter: this.id,\n            severity: \"error\",\n            file: f,\n            message: \"missing frontmatter `tracks:` array\",\n          });\n          continue;\n        }\n        for (const tracked of data.tracks as unknown[]) {\n          if (typeof tracked !== \"string\") {\n            issues.push({\n              linter: this.id,\n              severity: \"error\",\n              file: f,\n              message: \"`tracks` entries must be strings\",\n            });\n            continue;\n          }\n          if (!trackedPathExists(repoRoot, tracked)) {\n            issues.push({\n              linter: this.id,\n              severity: \"error\",\n              file: f,\n              message: `tracked path does not exist: ${tracked}`,\n            });\n          }\n        }\n      }\n    }\n    return issues;\n  },\n};\n","import type { LintIssue, Linter } from \"./types.js\";\nimport { fileExists, readText } from \"./util.js\";\n\n/** Paths the harness generates or writes at runtime; none belongs in Git. */\nexport const REQUIRED_GITIGNORE_ENTRIES: ReadonlyArray<string> = [\n  \".harness-overrides/\",\n  \".harness-manifest.json\",\n  \".harness/\",\n  \".claude/\",\n  \".codex/\",\n  \".opencode/\",\n  \".agents/\",\n  \".vaubaan/\",\n  \"AGENTS.md\",\n  \"CLAUDE.md\",\n  \".mcp.json\",\n];\n\nexport const gitignoreHarness: Linter = {\n  id: \"lint:gitignore-harness\",\n  pillars: [\"repo-root\"],\n  defaultSeverity: \"error\",\n  run(repoRoot: string): LintIssue[] {\n    const issues: LintIssue[] = [];\n    if (!fileExists(repoRoot, \".gitignore\")) {\n      issues.push({\n        linter: this.id,\n        severity: \"error\",\n        file: \".gitignore\",\n        message: \".gitignore is missing at repo root\",\n      });\n      return issues;\n    }\n    const text = readText(repoRoot, \".gitignore\");\n    const lines = new Set(\n      text\n        .split(\"\\n\")\n        .map((l) => l.trim())\n        .filter(Boolean),\n    );\n    for (const entry of REQUIRED_GITIGNORE_ENTRIES) {\n      const variants = [entry, entry.replace(/\\/$/, \"\")];\n      if (!variants.some((v) => lines.has(v))) {\n        issues.push({\n          linter: this.id,\n          severity: \"error\",\n          file: \".gitignore\",\n          message: `.gitignore must contain \"${entry}\"`,\n        });\n      }\n    }\n    return issues;\n  },\n};\n","import { basename } from \"node:path\";\nimport fg from \"fast-glob\";\nimport type { LintContext, LintIssue, Linter } from \"./types.js\";\nimport { listMarkdown, readText } from \"./util.js\";\n\nexport const orphanDecisions: Linter = {\n  id: \"lint:orphan-decisions\",\n  pillars: [\"decisions\"],\n  defaultSeverity: \"warning\",\n  suggestedSkills: [\"/handbook\"],\n  run(repoRoot: string, ctx?: LintContext): LintIssue[] {\n    const extra = ctx?.config.ignore ?? [];\n    const issues: LintIssue[] = [];\n    const adrs = listMarkdown(repoRoot, \"docs/decisions\");\n    if (adrs.length === 0) return issues;\n\n    const otherDocs = fg.sync(\"**/*.md\", {\n      cwd: repoRoot,\n      absolute: false,\n      ignore: [\n        \"**/node_modules/**\",\n        \"**/dist/**\",\n        \".harness-overrides/**\",\n        \"docs/decisions/**\",\n        \"skills/**\",\n        \"agents/**\",\n        \"commands/**\",\n        \"templates/**\",\n        ...extra,\n      ],\n    });\n\n    const referenceCorpus = otherDocs.map((f) => readText(repoRoot, f)).join(\"\\n\");\n\n    for (const adr of adrs) {\n      const filename = basename(adr);\n      const stem = filename.replace(/\\.md$/, \"\");\n      const referenced = referenceCorpus.includes(filename) || referenceCorpus.includes(stem);\n      if (!referenced) {\n        issues.push({\n          linter: this.id,\n          severity: \"warning\",\n          file: adr,\n          message: \"ADR is not referenced by any other doc file (orphan)\",\n        });\n      }\n    }\n    return issues;\n  },\n};\n","import type { LintIssue, Linter } from \"./types.js\";\nimport { dirExists, fileExists, readText } from \"./util.js\";\n\nconst QUALITY_DIR = \"docs/quality\";\nconst CARDINAL_FILE = `${QUALITY_DIR}/code-quality.md`;\n\n// English headings are canonical; the French ones are still accepted so\n// projects written before the switch to English keep passing.\nconst REQUIRED_SECTIONS: ReadonlyArray<{ label: string; pattern: RegExp }> = [\n  {\n    label: \"Mechanical checks\",\n    pattern: /^##\\s+(Mechanical\\s+checks|V[ée]rifications\\s+m[ée]caniques)\\s*$/im,\n  },\n  { label: \"Project rules\", pattern: /^##\\s+(Project\\s+rules|R[èe]gles\\s+du\\s+projet)\\s*$/im },\n  {\n    label: \"Accepted deviations\",\n    pattern: /^##\\s+(Accepted\\s+deviations|[ÉE]carts\\s+assum[ée]s)\\s*$/im,\n  },\n];\n\n/**\n * `docs/quality/` is an optional pillar: absent directory = nothing to\n * report. Once the directory exists, its cardinal file and sections are\n * required.\n */\nexport const qualitySchema: Linter = {\n  id: \"lint:quality-schema\",\n  pillars: [\"quality\"],\n  defaultSeverity: \"error\",\n  run(repoRoot: string): LintIssue[] {\n    if (!dirExists(repoRoot, QUALITY_DIR)) return [];\n    if (!fileExists(repoRoot, CARDINAL_FILE)) {\n      return [\n        {\n          linter: this.id,\n          severity: \"error\",\n          file: CARDINAL_FILE,\n          message: `missing required cardinal file: ${CARDINAL_FILE}`,\n        },\n      ];\n    }\n    const text = readText(repoRoot, CARDINAL_FILE);\n    return REQUIRED_SECTIONS.filter(({ pattern }) => !pattern.test(text)).map(({ label }) => ({\n      linter: this.id,\n      severity: \"error\" as const,\n      file: CARDINAL_FILE,\n      message: `missing required section: \"${label}\"`,\n    }));\n  },\n};\n","import type { LintIssue, Linter } from \"./types.js\";\nimport { fileExists } from \"./util.js\";\n\nexport const readmePresence: Linter = {\n  id: \"lint:readme-presence\",\n  pillars: [\"readme\"],\n  defaultSeverity: \"error\",\n  suggestedSkills: [\"/readme\"],\n  run(repoRoot: string): LintIssue[] {\n    if (fileExists(repoRoot, \"README.md\")) return [];\n    return [\n      {\n        linter: this.id,\n        severity: \"error\",\n        file: \"README.md\",\n        message: \"README.md is missing at repo root\",\n      },\n    ];\n  },\n};\n","import type { LintIssue, Linter } from \"./types.js\";\nimport { fileExists, readText } from \"./util.js\";\n\nconst REQUIRED_SECTIONS = [\n  /^#\\s+\\S/m,\n  /^##?\\s+(What is this|Quick start)/im,\n  /^##?\\s+(Quick start|Install|Getting started)/im,\n];\n\nconst REQUIRED_LABELS = [\"title (# H1)\", \"What is this / intro\", \"Quick start / Install\"];\n\nexport const readmeSections: Linter = {\n  id: \"lint:readme-sections\",\n  pillars: [\"readme\"],\n  defaultSeverity: \"error\",\n  suggestedSkills: [\"/readme\"],\n  run(repoRoot: string): LintIssue[] {\n    if (!fileExists(repoRoot, \"README.md\")) return [];\n    const text = readText(repoRoot, \"README.md\");\n    const issues: LintIssue[] = [];\n    for (let i = 0; i < REQUIRED_SECTIONS.length; i++) {\n      const pattern = REQUIRED_SECTIONS[i];\n      const label = REQUIRED_LABELS[i];\n      if (pattern && !pattern.test(text)) {\n        issues.push({\n          linter: this.id,\n          severity: \"error\",\n          file: \"README.md\",\n          message: `missing required section: ${label}`,\n        });\n      }\n    }\n    return issues;\n  },\n};\n","import type { LintIssue, Linter } from \"./types.js\";\nimport { dirExists, listMarkdown } from \"./util.js\";\n\nexport const specHasContent: Linter = {\n  id: \"lint:spec-has-content\",\n  pillars: [\"spec\"],\n  defaultSeverity: \"warning\",\n  suggestedSkills: [\"/spec\"],\n  run(repoRoot: string): LintIssue[] {\n    if (!dirExists(repoRoot, \"docs/spec\")) return [];\n    const files = listMarkdown(repoRoot, \"docs/spec\");\n    if (files.length > 0) return [];\n    return [\n      {\n        linter: this.id,\n        severity: \"warning\",\n        file: \"docs/spec\",\n        message: \"docs/spec/ has no markdown files — write at least one spec document\",\n      },\n    ];\n  },\n};\n","import type { LintIssue, Linter } from \"./types.js\";\nimport { findLineNumber, listMarkdown, readText } from \"./util.js\";\n\nfunction maskFencedBlocks(text: string): string {\n  return text.replace(/```[\\s\\S]*?```/g, (m) => m.replace(/[^\\n]/g, \" \"));\n}\n\nconst TECH_BLOCKLIST: Array<{ pattern: RegExp; keyword: string }> = [\n  { pattern: /\\bNext\\.?js\\b/i, keyword: \"Next.js\" },\n  { pattern: /\\bSupabase\\b/i, keyword: \"Supabase\" },\n  { pattern: /\\bVercel\\b/i, keyword: \"Vercel\" },\n  { pattern: /\\bReact\\b/, keyword: \"React\" },\n  { pattern: /\\bTypeScript\\b/, keyword: \"TypeScript\" },\n  { pattern: /\\bDocker\\b/, keyword: \"Docker\" },\n  { pattern: /\\bKubernetes\\b/i, keyword: \"Kubernetes\" },\n  { pattern: /\\bPostgres(QL)?\\b/i, keyword: \"Postgres\" },\n  { pattern: /\\bMySQL\\b/i, keyword: \"MySQL\" },\n  { pattern: /\\bRedis\\b/i, keyword: \"Redis\" },\n  { pattern: /\\bnpm\\b/, keyword: \"npm\" },\n  { pattern: /\\bpnpm\\b/, keyword: \"pnpm\" },\n  { pattern: /\\byarn\\b/, keyword: \"yarn\" },\n];\n\nexport const specTechAgnostic: Linter = {\n  id: \"lint:spec-tech-agnostic\",\n  pillars: [\"spec\"],\n  defaultSeverity: \"error\",\n  suggestedSkills: [\"/spec\"],\n  run(repoRoot: string): LintIssue[] {\n    const issues: LintIssue[] = [];\n    const files = listMarkdown(repoRoot, \"docs/spec\");\n    for (const f of files) {\n      const text = maskFencedBlocks(readText(repoRoot, f));\n      for (const { pattern, keyword } of TECH_BLOCKLIST) {\n        if (pattern.test(text)) {\n          const issue: LintIssue = {\n            linter: this.id,\n            severity: \"error\",\n            file: f,\n            message: `forbidden tech keyword \"${keyword}\" — should be in handbook/ or decisions/`,\n          };\n          const line = findLineNumber(text, pattern);\n          if (line !== undefined) issue.line = line;\n          issues.push(issue);\n        }\n      }\n    }\n    return issues;\n  },\n};\n","import fg from \"fast-glob\";\nimport type { LintIssue, Linter } from \"./types.js\";\nimport {\n  gitCommitsSince,\n  gitLastCommitForPath,\n  listMarkdown,\n  parseFrontmatter,\n  readText,\n} from \"./util.js\";\n\nconst TRACKED_DIRS = [\"docs/handbook\", \"docs/tests\", \"docs/workflow\"];\nconst DEFAULT_DRIFT_THRESHOLD = 10;\n\nfunction expandGlob(repoRoot: string, pattern: string): string[] {\n  if (pattern.includes(\"*\")) {\n    return fg.sync(pattern, { cwd: repoRoot, absolute: false });\n  }\n  return [pattern];\n}\n\nexport const tracksDrift: Linter = {\n  id: \"lint:tracks-drift\",\n  pillars: [\"handbook\", \"tests\", \"workflow\"],\n  defaultSeverity: \"warning\",\n  suggestedSkills: [\"/drift\", \"/handbook\"],\n  run(repoRoot: string): LintIssue[] {\n    const issues: LintIssue[] = [];\n    for (const dir of TRACKED_DIRS) {\n      const files = listMarkdown(repoRoot, dir);\n      for (const f of files) {\n        const text = readText(repoRoot, f);\n        const { data } = parseFrontmatter(text);\n        if (!Array.isArray(data.tracks)) continue;\n        const docCommit = gitLastCommitForPath(repoRoot, f);\n        if (!docCommit) continue;\n        const threshold =\n          typeof data.driftThreshold === \"number\" && data.driftThreshold > 0\n            ? data.driftThreshold\n            : DEFAULT_DRIFT_THRESHOLD;\n        let driftCount = 0;\n        for (const tracked of data.tracks) {\n          if (typeof tracked !== \"string\") continue;\n          const targets = expandGlob(repoRoot, tracked);\n          for (const t of targets.length > 0 ? targets : [tracked]) {\n            driftCount += gitCommitsSince(repoRoot, t, docCommit.hash);\n          }\n        }\n        if (driftCount > threshold) {\n          issues.push({\n            linter: this.id,\n            severity: \"warning\",\n            file: f,\n            message: `tracked files changed in ${driftCount} commits since doc last edit (threshold ${threshold})`,\n          });\n        }\n      }\n    }\n    return issues;\n  },\n};\n","import { adrNoTracks } from \"./adr-no-tracks.js\";\nimport { cardinalFiles } from \"./cardinal-files.js\";\nimport { loadLintConfig } from \"./config.js\";\nimport { crossLinks } from \"./cross-links.js\";\nimport { decisionSchema } from \"./decision-schema.js\";\nimport { docLayout } from \"./doc-layout.js\";\nimport { frontmatterTracks } from \"./frontmatter-tracks.js\";\nimport { gitignoreHarness } from \"./gitignore-harness.js\";\nimport { orphanDecisions } from \"./orphan-decisions.js\";\nimport { qualitySchema } from \"./quality-schema.js\";\nimport { readmePresence } from \"./readme-presence.js\";\nimport { readmeSections } from \"./readme-sections.js\";\nimport { specHasContent } from \"./spec-has-content.js\";\nimport { specTechAgnostic } from \"./spec-tech-agnostic.js\";\nimport { tracksDrift } from \"./tracks-drift.js\";\nimport type { LintContext, LintIssue, LintReport, Linter } from \"./types.js\";\n\nexport const ALL_LINTERS: ReadonlyArray<Linter> = [\n  readmePresence,\n  readmeSections,\n  docLayout,\n  cardinalFiles,\n  decisionSchema,\n  adrNoTracks,\n  frontmatterTracks,\n  tracksDrift,\n  specTechAgnostic,\n  specHasContent,\n  crossLinks,\n  orphanDecisions,\n  gitignoreHarness,\n  qualitySchema,\n];\n\nexport interface RunOptions {\n  pillar?: string;\n  only?: ReadonlyArray<string>;\n}\n\nexport function runLinters(repoRoot: string, opts: RunOptions = {}): LintReport {\n  const config = loadLintConfig(repoRoot);\n  const ctx: LintContext = { repoRoot, config };\n  const filtered = ALL_LINTERS.filter((l) => {\n    if (opts.only && !opts.only.includes(l.id)) return false;\n    if (opts.pillar && !l.pillars.includes(opts.pillar) && !l.pillars.includes(\"all\")) return false;\n    return true;\n  });\n  const issues: LintIssue[] = [];\n  for (const linter of filtered) {\n    try {\n      issues.push(...linter.run(repoRoot, ctx));\n    } catch (err) {\n      issues.push({\n        linter: linter.id,\n        severity: \"error\",\n        file: \"<internal>\",\n        message: `linter crashed: ${err instanceof Error ? err.message : String(err)}`,\n      });\n    }\n  }\n  const errors = issues.filter((i) => i.severity === \"error\").length;\n  const warnings = issues.filter((i) => i.severity === \"warning\").length;\n  return {\n    version: 1,\n    summary: { errors, warnings, pass: errors === 0 },\n    issues,\n  };\n}\n\nfunction suggestedSkillsFor(linterId: string): ReadonlyArray<string> {\n  const linter = ALL_LINTERS.find((l) => l.id === linterId);\n  return linter?.suggestedSkills ?? [];\n}\n\nexport function formatReportText(report: LintReport): string {\n  const lines: string[] = [];\n  for (const issue of report.issues) {\n    const location = issue.line !== undefined ? `:${issue.line}` : \"\";\n    lines.push(`${issue.file}${location}: ${issue.severity}[${issue.linter}]\\n  ${issue.message}`);\n    const hints = suggestedSkillsFor(issue.linter);\n    if (hints.length > 0) {\n      lines.push(`  → Try: ${hints.join(\", \")}`);\n    }\n  }\n  const { errors, warnings, pass } = report.summary;\n  lines.push(\"\");\n  lines.push(\n    `${errors} ${errors === 1 ? \"error\" : \"errors\"}, ${warnings} ${warnings === 1 ? \"warning\" : \"warnings\"}. ${pass ? \"✔ CI passes.\" : \"✘ CI fails.\"}`,\n  );\n  return lines.join(\"\\n\");\n}\n\nexport type { HarnessLintConfig } from \"./config.js\";\nexport { loadLintConfig } from \"./config.js\";\nexport type { LintContext, Linter, LintIssue, LintReport, Severity } from \"./types.js\";\n"],"mappings":"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","names":["existsSync","join","fg","join","fg","existsSync","existsSync","join","fg","fg","existsSync","join","fg","fg","REQUIRED_SECTIONS","REQUIRED_SECTIONS","fg","TRACKED_DIRS","fg"]}

package/dist/parser/index.d.ts

@@ -0,0 +1,247 @@
+import { z } from 'zod';
+
+interface ParsedFile<T> {
+    meta: T;
+    body: string;
+    sourcePath: string;
+}
+
+declare const SkillFrontmatterSchema: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    engines: z.ZodOptional<z.ZodArray<z.ZodEnum<["claude-code", "codex-cli", "opencode"]>, "many">>;
+    requires: z.ZodOptional<z.ZodArray<z.ZodEnum<["multi-step", "slash-command", "inline-exec"]>, "many">>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    description: string;
+    engines?: ("claude-code" | "codex-cli" | "opencode")[] | undefined;
+    requires?: ("multi-step" | "slash-command" | "inline-exec")[] | undefined;
+    tags?: string[] | undefined;
+}, {
+    id: string;
+    description: string;
+    engines?: ("claude-code" | "codex-cli" | "opencode")[] | undefined;
+    requires?: ("multi-step" | "slash-command" | "inline-exec")[] | undefined;
+    tags?: string[] | undefined;
+}>;
+type SkillFrontmatter = z.infer<typeof SkillFrontmatterSchema>;
+declare const CmdArgSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodLiteral<"enum">;
+    values: z.ZodArray<z.ZodString, "many">;
+    default: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    values: string[];
+    type: "enum";
+    name: string;
+    default?: string | undefined;
+}, {
+    values: string[];
+    type: "enum";
+    name: string;
+    default?: string | undefined;
+}>, z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodLiteral<"string">;
+    default: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    type: "string";
+    name: string;
+    default?: string | undefined;
+}, {
+    type: "string";
+    name: string;
+    default?: string | undefined;
+}>]>;
+type CmdArg = z.infer<typeof CmdArgSchema>;
+declare const CmdFrontmatterSchema: z.ZodObject<{
+    id: z.ZodString;
+    trigger: z.ZodString;
+    invokes_skill: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodLiteral<"enum">;
+        values: z.ZodArray<z.ZodString, "many">;
+        default: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        values: string[];
+        type: "enum";
+        name: string;
+        default?: string | undefined;
+    }, {
+        values: string[];
+        type: "enum";
+        name: string;
+        default?: string | undefined;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodLiteral<"string">;
+        default: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        type: "string";
+        name: string;
+        default?: string | undefined;
+    }, {
+        type: "string";
+        name: string;
+        default?: string | undefined;
+    }>]>, "many">>;
+    description: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    description: string;
+    trigger: string;
+    invokes_skill: string;
+    args?: ({
+        values: string[];
+        type: "enum";
+        name: string;
+        default?: string | undefined;
+    } | {
+        type: "string";
+        name: string;
+        default?: string | undefined;
+    })[] | undefined;
+}, {
+    id: string;
+    description: string;
+    trigger: string;
+    invokes_skill: string;
+    args?: ({
+        values: string[];
+        type: "enum";
+        name: string;
+        default?: string | undefined;
+    } | {
+        type: "string";
+        name: string;
+        default?: string | undefined;
+    })[] | undefined;
+}>;
+type CmdFrontmatter = z.infer<typeof CmdFrontmatterSchema>;
+declare const AgentFrontmatterSchema: z.ZodObject<{
+    id: z.ZodEnum<["coding", "review", "merge", "planning"]>;
+    description: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    id: "coding" | "review" | "merge" | "planning";
+    description: string;
+}, {
+    id: "coding" | "review" | "merge" | "planning";
+    description: string;
+}>;
+type AgentFrontmatter = z.infer<typeof AgentFrontmatterSchema>;
+declare const Schemas: {
+    readonly Skill: z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodString;
+        engines: z.ZodOptional<z.ZodArray<z.ZodEnum<["claude-code", "codex-cli", "opencode"]>, "many">>;
+        requires: z.ZodOptional<z.ZodArray<z.ZodEnum<["multi-step", "slash-command", "inline-exec"]>, "many">>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        description: string;
+        engines?: ("claude-code" | "codex-cli" | "opencode")[] | undefined;
+        requires?: ("multi-step" | "slash-command" | "inline-exec")[] | undefined;
+        tags?: string[] | undefined;
+    }, {
+        id: string;
+        description: string;
+        engines?: ("claude-code" | "codex-cli" | "opencode")[] | undefined;
+        requires?: ("multi-step" | "slash-command" | "inline-exec")[] | undefined;
+        tags?: string[] | undefined;
+    }>;
+    readonly Cmd: z.ZodObject<{
+        id: z.ZodString;
+        trigger: z.ZodString;
+        invokes_skill: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodLiteral<"enum">;
+            values: z.ZodArray<z.ZodString, "many">;
+            default: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            values: string[];
+            type: "enum";
+            name: string;
+            default?: string | undefined;
+        }, {
+            values: string[];
+            type: "enum";
+            name: string;
+            default?: string | undefined;
+        }>, z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodLiteral<"string">;
+            default: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            type: "string";
+            name: string;
+            default?: string | undefined;
+        }, {
+            type: "string";
+            name: string;
+            default?: string | undefined;
+        }>]>, "many">>;
+        description: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        description: string;
+        trigger: string;
+        invokes_skill: string;
+        args?: ({
+            values: string[];
+            type: "enum";
+            name: string;
+            default?: string | undefined;
+        } | {
+            type: "string";
+            name: string;
+            default?: string | undefined;
+        })[] | undefined;
+    }, {
+        id: string;
+        description: string;
+        trigger: string;
+        invokes_skill: string;
+        args?: ({
+            values: string[];
+            type: "enum";
+            name: string;
+            default?: string | undefined;
+        } | {
+            type: "string";
+            name: string;
+            default?: string | undefined;
+        })[] | undefined;
+    }>;
+    readonly Agent: z.ZodObject<{
+        id: z.ZodEnum<["coding", "review", "merge", "planning"]>;
+        description: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: "coding" | "review" | "merge" | "planning";
+        description: string;
+    }, {
+        id: "coding" | "review" | "merge" | "planning";
+        description: string;
+    }>;
+};
+declare class ParseError extends Error {
+    readonly file: string;
+    readonly issues: z.ZodIssue[];
+    constructor(file: string, issues: z.ZodIssue[]);
+}
+
+type Agent = ParsedFile<AgentFrontmatter>;
+declare function parseAgent(filePath: string, source: string): Agent;
+declare function parseAgentFile(filePath: string): Agent;
+
+type Cmd = ParsedFile<CmdFrontmatter>;
+declare function parseCmd(filePath: string, source: string): Cmd;
+declare function parseCmdFile(filePath: string): Cmd;
+
+type Skill = ParsedFile<SkillFrontmatter>;
+declare function parseSkill(filePath: string, source: string): Skill;
+declare function parseSkillFile(filePath: string): Skill;
+
+export { type Agent, type AgentFrontmatter, type Cmd, type CmdArg, type CmdFrontmatter, ParseError, type ParsedFile, Schemas, type Skill, type SkillFrontmatter, parseAgent, parseAgentFile, parseCmd, parseCmdFile, parseSkill, parseSkillFile };

package/dist/parser/index.js

@@ -0,0 +1,114 @@
+// src/parser/common.ts
+import { readFileSync } from "fs";
+import matter from "gray-matter";
+
+// src/parser/schemas.ts
+import { z } from "zod";
+
+// src/types.ts
+var AGENT_IDS = ["coding", "review", "merge", "planning"];
+var ENGINES = ["claude-code", "codex-cli", "opencode"];
+var CAPABILITIES = ["multi-step", "slash-command", "inline-exec"];
+
+// src/parser/schemas.ts
+var IdSchema = z.string().min(1).regex(/^[a-z][a-z0-9-]*$/, "id must be kebab-case (lowercase + digits + hyphens)");
+var SkillFrontmatterSchema = z.object({
+  id: IdSchema,
+  description: z.string().min(1),
+  engines: z.array(z.enum(ENGINES)).min(1).optional(),
+  requires: z.array(z.enum(CAPABILITIES)).optional(),
+  tags: z.array(z.string()).optional()
+}).strict();
+var CmdArgEnumSchema = z.object({
+  name: z.string().min(1),
+  type: z.literal("enum"),
+  values: z.array(z.string()).min(1),
+  default: z.string().optional()
+}).strict();
+var CmdArgStringSchema = z.object({
+  name: z.string().min(1),
+  type: z.literal("string"),
+  default: z.string().optional()
+}).strict();
+var CmdArgSchema = z.discriminatedUnion("type", [CmdArgEnumSchema, CmdArgStringSchema]);
+var CmdFrontmatterSchema = z.object({
+  id: IdSchema,
+  trigger: z.string().regex(/^\/[a-z][a-z0-9-]*$/, "trigger must be /kebab-case"),
+  invokes_skill: IdSchema,
+  args: z.array(CmdArgSchema).optional(),
+  description: z.string().min(1)
+}).strict();
+var AgentFrontmatterSchema = z.object({
+  id: z.enum(AGENT_IDS),
+  description: z.string().min(1)
+}).strict();
+var Schemas = {
+  Skill: SkillFrontmatterSchema,
+  Cmd: CmdFrontmatterSchema,
+  Agent: AgentFrontmatterSchema
+};
+var ParseError = class extends Error {
+  constructor(file, issues) {
+    const messages = issues.map((i) => `  - ${i.path.join(".") || "<root>"}: ${i.message}`).join("\n");
+    super(`Frontmatter validation failed for ${file}:
+${messages}`);
+    this.file = file;
+    this.issues = issues;
+    this.name = "ParseError";
+  }
+  file;
+  issues;
+};
+
+// src/parser/common.ts
+function parseWithSchema(filePath, source, schema) {
+  const parsed = matter(source);
+  const result = schema.safeParse(parsed.data);
+  if (!result.success) {
+    throw new ParseError(filePath, result.error.issues);
+  }
+  return {
+    meta: result.data,
+    body: parsed.content.trim(),
+    sourcePath: filePath
+  };
+}
+function parseFileWithSchema(filePath, schema) {
+  const source = readFileSync(filePath, "utf8");
+  return parseWithSchema(filePath, source, schema);
+}
+
+// src/parser/agent.ts
+function parseAgent(filePath, source) {
+  return parseWithSchema(filePath, source, Schemas.Agent);
+}
+function parseAgentFile(filePath) {
+  return parseFileWithSchema(filePath, Schemas.Agent);
+}
+
+// src/parser/cmd.ts
+function parseCmd(filePath, source) {
+  return parseWithSchema(filePath, source, Schemas.Cmd);
+}
+function parseCmdFile(filePath) {
+  return parseFileWithSchema(filePath, Schemas.Cmd);
+}
+
+// src/parser/skill.ts
+function parseSkill(filePath, source) {
+  return parseWithSchema(filePath, source, Schemas.Skill);
+}
+function parseSkillFile(filePath) {
+  return parseFileWithSchema(filePath, Schemas.Skill);
+}
+export {
+  ParseError,
+  Schemas,
+  parseAgent,
+  parseAgentFile,
+  parseCmd,
+  parseCmdFile,
+  parseSkill,
+  parseSkillFile
+};
+//# sourceMappingURL=index.js.map

package/dist/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/parser/common.ts","../../src/parser/schemas.ts","../../src/types.ts","../../src/parser/agent.ts","../../src/parser/cmd.ts","../../src/parser/skill.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport matter from \"gray-matter\";\nimport type { z } from \"zod\";\nimport { ParseError } from \"./schemas.js\";\n\nexport interface ParsedFile<T> {\n  meta: T;\n  body: string;\n  sourcePath: string;\n}\n\nexport function parseWithSchema<T extends z.ZodTypeAny>(\n  filePath: string,\n  source: string,\n  schema: T,\n): ParsedFile<z.infer<T>> {\n  const parsed = matter(source);\n  const result = schema.safeParse(parsed.data);\n  if (!result.success) {\n    throw new ParseError(filePath, result.error.issues);\n  }\n  return {\n    meta: result.data,\n    body: parsed.content.trim(),\n    sourcePath: filePath,\n  };\n}\n\nexport function parseFileWithSchema<T extends z.ZodTypeAny>(\n  filePath: string,\n  schema: T,\n): ParsedFile<z.infer<T>> {\n  const source = readFileSync(filePath, \"utf8\");\n  return parseWithSchema(filePath, source, schema);\n}\n","import { z } from \"zod\";\nimport { AGENT_IDS, CAPABILITIES, ENGINES } from \"../types.js\";\n\nconst IdSchema = z\n  .string()\n  .min(1)\n  .regex(/^[a-z][a-z0-9-]*$/, \"id must be kebab-case (lowercase + digits + hyphens)\");\n\nconst SkillFrontmatterSchema = z\n  .object({\n    id: IdSchema,\n    description: z.string().min(1),\n    engines: z.array(z.enum(ENGINES)).min(1).optional(),\n    requires: z.array(z.enum(CAPABILITIES)).optional(),\n    tags: z.array(z.string()).optional(),\n  })\n  .strict();\n\nexport type SkillFrontmatter = z.infer<typeof SkillFrontmatterSchema>;\n\nconst CmdArgEnumSchema = z\n  .object({\n    name: z.string().min(1),\n    type: z.literal(\"enum\"),\n    values: z.array(z.string()).min(1),\n    default: z.string().optional(),\n  })\n  .strict();\n\nconst CmdArgStringSchema = z\n  .object({\n    name: z.string().min(1),\n    type: z.literal(\"string\"),\n    default: z.string().optional(),\n  })\n  .strict();\n\nconst CmdArgSchema = z.discriminatedUnion(\"type\", [CmdArgEnumSchema, CmdArgStringSchema]);\n\nexport type CmdArg = z.infer<typeof CmdArgSchema>;\n\nconst CmdFrontmatterSchema = z\n  .object({\n    id: IdSchema,\n    trigger: z.string().regex(/^\\/[a-z][a-z0-9-]*$/, \"trigger must be /kebab-case\"),\n    invokes_skill: IdSchema,\n    args: z.array(CmdArgSchema).optional(),\n    description: z.string().min(1),\n  })\n  .strict();\n\nexport type CmdFrontmatter = z.infer<typeof CmdFrontmatterSchema>;\n\nconst AgentFrontmatterSchema = z\n  .object({\n    id: z.enum(AGENT_IDS),\n    description: z.string().min(1),\n  })\n  .strict();\n\nexport type AgentFrontmatter = z.infer<typeof AgentFrontmatterSchema>;\n\nexport const Schemas = {\n  Skill: SkillFrontmatterSchema,\n  Cmd: CmdFrontmatterSchema,\n  Agent: AgentFrontmatterSchema,\n} as const;\n\nexport class ParseError extends Error {\n  constructor(\n    public readonly file: string,\n    public readonly issues: z.ZodIssue[],\n  ) {\n    const messages = issues\n      .map((i) => `  - ${i.path.join(\".\") || \"<root>\"}: ${i.message}`)\n      .join(\"\\n\");\n    super(`Frontmatter validation failed for ${file}:\\n${messages}`);\n    this.name = \"ParseError\";\n  }\n}\n","export const AGENT_IDS = [\"coding\", \"review\", \"merge\", \"planning\"] as const;\nexport type AgentId = (typeof AGENT_IDS)[number];\n\nexport const ENGINES = [\"claude-code\", \"codex-cli\", \"opencode\"] as const;\nexport type Engine = (typeof ENGINES)[number];\n\nexport const ENGINE_ROOT_DIR: Record<Engine, string> = {\n  \"claude-code\": \".claude\",\n  \"codex-cli\": \".codex\",\n  opencode: \".opencode\",\n};\n\nexport const CAPABILITIES = [\"multi-step\", \"slash-command\", \"inline-exec\"] as const;\nexport type Capability = (typeof CAPABILITIES)[number];\n\nexport interface RenderedFile {\n  path: string;\n  content: string;\n}\n\nexport interface CapabilitiesMatrix {\n  [engine: string]: ReadonlyArray<Capability>;\n}\n\nexport const CAPABILITIES_MATRIX: Record<Engine, ReadonlyArray<Capability>> = {\n  \"claude-code\": [\"multi-step\", \"slash-command\", \"inline-exec\"],\n  \"codex-cli\": [\"multi-step\", \"slash-command\", \"inline-exec\"],\n  opencode: [\"multi-step\", \"slash-command\", \"inline-exec\"],\n};\n\nexport const DEGRADED_CAPABILITIES: Partial<Record<Engine, ReadonlyArray<Capability>>> = {\n  \"codex-cli\": [\"multi-step\"],\n};\n\nexport function engineSupports(engine: Engine, capability: Capability): boolean {\n  return CAPABILITIES_MATRIX[engine].includes(capability);\n}\n","import { parseFileWithSchema, parseWithSchema } from \"./common.js\";\nimport type { ParsedFile } from \"./common.js\";\nimport { type AgentFrontmatter, Schemas } from \"./schemas.js\";\n\nexport type Agent = ParsedFile<AgentFrontmatter>;\n\nexport function parseAgent(filePath: string, source: string): Agent {\n  return parseWithSchema(filePath, source, Schemas.Agent);\n}\n\nexport function parseAgentFile(filePath: string): Agent {\n  return parseFileWithSchema(filePath, Schemas.Agent);\n}\n","import { parseFileWithSchema, parseWithSchema } from \"./common.js\";\nimport type { ParsedFile } from \"./common.js\";\nimport { type CmdFrontmatter, Schemas } from \"./schemas.js\";\n\nexport type Cmd = ParsedFile<CmdFrontmatter>;\n\nexport function parseCmd(filePath: string, source: string): Cmd {\n  return parseWithSchema(filePath, source, Schemas.Cmd);\n}\n\nexport function parseCmdFile(filePath: string): Cmd {\n  return parseFileWithSchema(filePath, Schemas.Cmd);\n}\n","import { parseFileWithSchema, parseWithSchema } from \"./common.js\";\nimport type { ParsedFile } from \"./common.js\";\nimport { Schemas, type SkillFrontmatter } from \"./schemas.js\";\n\nexport type Skill = ParsedFile<SkillFrontmatter>;\n\nexport function parseSkill(filePath: string, source: string): Skill {\n  return parseWithSchema(filePath, source, Schemas.Skill);\n}\n\nexport function parseSkillFile(filePath: string): Skill {\n  return parseFileWithSchema(filePath, Schemas.Skill);\n}\n"],"mappings":"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","names":[]}

package/dist/render-B9_kNtQc.d.ts

@@ -0,0 +1,50 @@
+import { Agent, Skill, Cmd } from './parser/index.js';
+
+declare const MCP_SERVER_IDS: readonly ["context7"];
+type McpServerId = (typeof MCP_SERVER_IDS)[number];
+
+declare const ENGINES: readonly ["claude-code", "codex-cli", "opencode"];
+type Engine = (typeof ENGINES)[number];
+interface RenderedFile {
+    path: string;
+    content: string;
+}
+
+interface Harness {
+    agents: ReadonlyArray<Agent>;
+    skills: ReadonlyArray<Skill>;
+    cmds: ReadonlyArray<Cmd>;
+}
+interface HarnessOverrides {
+    add?: Partial<Harness>;
+    disable?: ReadonlyArray<string>;
+}
+interface RenderInput {
+    harness: Harness;
+    engines: ReadonlyArray<Engine>;
+    overrides?: HarnessOverrides;
+    projectSkills?: ReadonlyArray<Skill>;
+    /** True when the target project ships `docs/quality/code-quality.md` (optional pillar). */
+    hasQualityDoc?: boolean;
+    mcpServers?: ReadonlyArray<McpServerId>;
+    /**
+     * When true (default), each engine's renderer emits a Stop-hook config
+     * that calls `vaubaan-harness stop-hook --engine <engine>` and injects
+     * the lint report (with skill suggestions) into the running session
+     * whenever the worktree is dirty and lint fails. Pass `false` to skip
+     * the hook configs entirely (kill-switch at install time; runtime
+     * kill-switch is `HARNESS_LINT_DISABLE=1`).
+     */
+    withStopHook?: boolean;
+}
+interface RenderOutput {
+    files: RenderedFile[];
+    warnings: string[];
+}
+declare class RenderError extends Error {
+    constructor(message: string);
+}
+declare function applyOverrides(harness: Harness, overrides: HarnessOverrides | undefined): Harness;
+declare function render(input: RenderInput): RenderOutput;
+
+export { type Engine as E, type Harness as H, RenderError as R, type HarnessOverrides as a, type RenderInput as b, type RenderOutput as c, type RenderedFile as d, applyOverrides as e, render as r };

package/dist/render.d.ts

@@ -0,0 +1,3 @@
+export { H as Harness, a as HarnessOverrides, R as RenderError, b as RenderInput, c as RenderOutput, e as applyOverrides, r as render } from './render-B9_kNtQc.js';
+import './parser/index.js';
+import 'zod';