@kiwidata/grimoire 0.1.1

package/dist/core/validate.js

@@ -0,0 +1,275 @@
+import { readFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import chalk from "chalk";
+import matter from "gray-matter";
+import { GherkinClassicTokenMatcher, Parser, AstBuilder, } from "@cucumber/gherkin";
+import { IdGenerator } from "@cucumber/messages";
+import { findProjectRoot, resolveChangePath } from "../utils/paths.js";
+import { findFiles } from "../utils/fs.js";
+export async function validateChange(changeId, options) {
+    const root = await findProjectRoot();
+    const results = [];
+    if (changeId) {
+        const changePath = resolveChangePath(root, changeId);
+        await validateSingleChange(changePath, changeId, results, options);
+    }
+    else {
+        // Validate all active changes
+        const changesDir = join(root, ".grimoire", "changes");
+        try {
+            const entries = await readdir(changesDir, { withFileTypes: true });
+            const changes = entries.filter((e) => e.isDirectory());
+            if (changes.length === 0) {
+                console.log("No active changes to validate.");
+                return { results, errorCount: 0, warnCount: 0 };
+            }
+            for (const change of changes) {
+                const changePath = join(changesDir, change.name);
+                await validateSingleChange(changePath, change.name, results, options);
+            }
+        }
+        catch {
+            console.log("No .grimoire/changes/ directory found. Run grimoire init first.");
+            return { results, errorCount: 0, warnCount: 0 };
+        }
+    }
+    const errorCount = results.reduce((sum, r) => sum + r.errors.length, 0);
+    const warnCount = results.reduce((sum, r) => sum + r.warnings.length, 0);
+    if (options.json) {
+        console.log(JSON.stringify(results, null, 2));
+        return { results, errorCount, warnCount };
+    }
+    // Print results
+    for (const result of results) {
+        if (result.errors.length > 0) {
+            console.log(`\n${chalk.red("FAIL")} ${result.file}`);
+            for (const err of result.errors) {
+                console.log(`  ${chalk.red("error:")} ${err}`);
+            }
+        }
+        if (result.warnings.length > 0) {
+            console.log(`\n${chalk.yellow("WARN")} ${result.file}`);
+            for (const warn of result.warnings) {
+                console.log(`  ${chalk.yellow("warn:")} ${warn}`);
+            }
+        }
+    }
+    if (errorCount === 0) {
+        console.log(chalk.green("\nValidation passed."));
+    }
+    console.log(`\n${errorCount} error(s), ${warnCount} warning(s)`);
+    return { results, errorCount, warnCount };
+}
+async function validateSingleChange(changePath, changeId, results, options) {
+    // Check manifest exists and has valid frontmatter
+    const manifestPath = join(changePath, "manifest.md");
+    try {
+        const manifestContent = await readFile(manifestPath, "utf-8");
+        const manifestResult = validateManifest(`${changeId}/manifest.md`, manifestContent, options.strict);
+        if (manifestResult.errors.length > 0 || manifestResult.warnings.length > 0) {
+            results.push(manifestResult);
+        }
+    }
+    catch {
+        results.push({
+            file: `${changeId}/manifest.md`,
+            errors: ["Manifest file missing"],
+            warnings: [],
+        });
+    }
+    // Validate feature files
+    const featuresDir = join(changePath, "features");
+    try {
+        const featureFiles = await findFiles(featuresDir, ".feature");
+        for (const file of featureFiles) {
+            const content = await readFile(file, "utf-8");
+            const result = validateFeatureFile(file, content, options.strict);
+            if (result.errors.length > 0 || result.warnings.length > 0) {
+                results.push(result);
+            }
+        }
+    }
+    catch {
+        // No features dir is ok if there are decisions
+    }
+    // Validate decision files
+    const decisionsDir = join(changePath, "decisions");
+    try {
+        const decisionFiles = await findFiles(decisionsDir, ".md");
+        for (const file of decisionFiles) {
+            const content = await readFile(file, "utf-8");
+            const result = validateDecisionFile(file, content, options.strict);
+            if (result.errors.length > 0 || result.warnings.length > 0) {
+                results.push(result);
+            }
+        }
+    }
+    catch {
+        // No decisions dir is ok if there are features
+    }
+}
+function parseGherkin(content) {
+    try {
+        const parser = new Parser(new AstBuilder(IdGenerator.uuid()), new GherkinClassicTokenMatcher());
+        return parser.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+function getScenarios(doc) {
+    if (!doc.feature)
+        return [];
+    const scenarios = [];
+    for (const child of doc.feature.children) {
+        if (child.scenario) {
+            scenarios.push(child.scenario);
+        }
+        if (child.rule) {
+            for (const ruleChild of child.rule.children) {
+                if (ruleChild.scenario) {
+                    scenarios.push(ruleChild.scenario);
+                }
+            }
+        }
+    }
+    return scenarios;
+}
+export function validateFeatureFile(filePath, content, strict) {
+    const errors = [];
+    const warnings = [];
+    const doc = parseGherkin(content);
+    if (!doc || !doc.feature) {
+        errors.push("Invalid Gherkin syntax — could not parse feature file");
+        return { file: filePath, errors, warnings };
+    }
+    const feature = doc.feature;
+    if (!feature.name || feature.name.trim() === "") {
+        errors.push("Missing Feature name");
+    }
+    const scenarios = getScenarios(doc);
+    if (scenarios.length === 0) {
+        errors.push("No scenarios found");
+    }
+    for (const scenario of scenarios) {
+        const name = scenario.name || "unnamed";
+        const keywords = scenario.steps.map((s) => s.keyword.trim());
+        if (!keywords.includes("When")) {
+            errors.push(`Scenario "${name}" missing When step`);
+        }
+        if (!keywords.includes("Then")) {
+            errors.push(`Scenario "${name}" missing Then step`);
+        }
+        // Scenario Outline must have Examples
+        if (scenario.keyword === "Scenario Outline" &&
+            scenario.examples.length === 0) {
+            errors.push(`Scenario Outline "${name}" missing Examples table`);
+        }
+    }
+    if (strict) {
+        // Check for user story in feature description
+        const description = feature.description || "";
+        if (!description.match(/As an?\s/i) ||
+            !description.match(/I want\s/i) ||
+            !description.match(/So that\s/i)) {
+            warnings.push("Missing user story (As a / I want / So that)");
+        }
+        // Warn about implementation details in step text
+        const implKeywords = /\b(database|SQL|API|endpoint|HTTP|POST|GET|class|function|method|import|module)\b/i;
+        for (const scenario of scenarios) {
+            for (const step of scenario.steps) {
+                if (implKeywords.test(step.text)) {
+                    warnings.push(`Possible implementation details in step: "${step.keyword.trim()} ${step.text}" (should describe WHAT not HOW)`);
+                }
+            }
+        }
+    }
+    return { file: filePath, errors, warnings };
+}
+export function validateDecisionFile(filePath, content, strict) {
+    const errors = [];
+    const warnings = [];
+    // Check YAML frontmatter
+    const { data: fm } = matter(content);
+    if (!content.startsWith("---")) {
+        errors.push("Missing YAML frontmatter");
+    }
+    else {
+        if (!fm.status) {
+            errors.push("Frontmatter missing 'status' field");
+        }
+        if (!fm.date) {
+            errors.push("Frontmatter missing 'date' field");
+        }
+    }
+    // Check required sections
+    if (!content.match(/^## Context and Problem Statement/m)) {
+        errors.push("Missing 'Context and Problem Statement' section");
+    }
+    if (!content.match(/^## Considered Options/m)) {
+        errors.push("Missing 'Considered Options' section");
+    }
+    if (!content.match(/^## Decision Outcome/m)) {
+        errors.push("Missing 'Decision Outcome' section");
+    }
+    if (strict) {
+        if (!content.match(/^## Decision Drivers/m)) {
+            warnings.push("Missing 'Decision Drivers' section");
+        }
+        if (!content.match(/^### Consequences/m)) {
+            warnings.push("Missing 'Consequences' section");
+        }
+        if (!content.match(/^### Cost of Ownership/m)) {
+            warnings.push("Missing 'Cost of Ownership' section");
+        }
+        if (!content.match(/^### Confirmation/m)) {
+            warnings.push("Missing 'Confirmation' section");
+        }
+    }
+    return { file: filePath, errors, warnings };
+}
+const VALID_MANIFEST_STATUSES = [
+    "draft",
+    "approved",
+    "implementing",
+    "complete",
+];
+export function validateManifest(filePath, content, strict) {
+    const errors = [];
+    const warnings = [];
+    const { data: mfm } = matter(content);
+    if (!content.startsWith("---")) {
+        if (strict) {
+            errors.push("Missing YAML frontmatter (status, branch)");
+        }
+        else {
+            warnings.push("Missing YAML frontmatter (status, branch)");
+        }
+    }
+    else {
+        if (!mfm.status) {
+            errors.push("Frontmatter missing 'status' field");
+        }
+        else if (!VALID_MANIFEST_STATUSES.includes(mfm.status)) {
+            errors.push(`Invalid status "${mfm.status}" — must be one of: ${VALID_MANIFEST_STATUSES.join(", ")}`);
+        }
+    }
+    // Check required sections
+    if (!content.match(/^## Why/m)) {
+        errors.push("Missing 'Why' section");
+    }
+    if (!content.match(/^## Feature Changes/m) &&
+        !content.match(/^## Decisions/m)) {
+        errors.push("Must have at least one of 'Feature Changes' or 'Decisions' section");
+    }
+    if (strict) {
+        if (!content.match(/^## Assumptions/m)) {
+            warnings.push("Missing 'Assumptions' section");
+        }
+        if (!content.match(/^## Pre-Mortem/m)) {
+            warnings.push("Missing 'Pre-Mortem' section");
+        }
+    }
+    return { file: filePath, errors, warnings };
+}
+//# sourceMappingURL=validate.js.map

package/dist/core/validate.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export { initProject } from "./core/init.js";
+export { updateProject } from "./core/update.js";
+export { validateChange, type ValidateResult } from "./core/validate.js";
+export { listChanges, listFeatures, listDecisions } from "./core/list.js";
+export { getChangeStatus } from "./core/status.js";
+export { archiveChange, ArchiveError } from "./core/archive.js";
+export { generateMap } from "./core/map.js";
+export { runCheck, type CheckResult } from "./core/check.js";
+export { loadConfig } from "./utils/config.js";
+export { detectTools } from "./core/detect.js";
+export { generateLog } from "./core/log.js";
+export { traceFile } from "./core/trace.js";
+export { generateDocs } from "./core/docs.js";
+export { runHealth } from "./core/health.js";
+export { diffChange, type DiffResult } from "./core/diff.js";
+export { runCi } from "./core/ci.js";
+export { analyzeTestQuality, type TestQualityReport } from "./core/test-quality.js";
+export { checkDocStyle, type DocStyleReport } from "./core/doc-style.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+// Public API for programmatic use
+export { initProject } from "./core/init.js";
+export { updateProject } from "./core/update.js";
+export { validateChange } from "./core/validate.js";
+export { listChanges, listFeatures, listDecisions } from "./core/list.js";
+export { getChangeStatus } from "./core/status.js";
+export { archiveChange, ArchiveError } from "./core/archive.js";
+export { generateMap } from "./core/map.js";
+export { runCheck } from "./core/check.js";
+export { loadConfig } from "./utils/config.js";
+export { detectTools } from "./core/detect.js";
+export { generateLog } from "./core/log.js";
+export { traceFile } from "./core/trace.js";
+export { generateDocs } from "./core/docs.js";
+export { runHealth } from "./core/health.js";
+export { diffChange } from "./core/diff.js";
+export { runCi } from "./core/ci.js";
+export { analyzeTestQuality } from "./core/test-quality.js";
+export { checkDocStyle } from "./core/doc-style.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAuB,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAoB,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAmB,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAA0B,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,aAAa,EAAuB,MAAM,qBAAqB,CAAC"}

package/dist/utils/config.d.ts

@@ -0,0 +1,61 @@
+export interface ToolConfig {
+    name: string;
+    command?: string;
+    check_command?: string;
+    prompt?: string;
+}
+export type CavemanLevel = "none" | "lite" | "full" | "ultra";
+export declare const CURRENT_CONFIG_VERSION = 2;
+export interface DesignToolConfig {
+    name: string;
+    path?: string;
+    url?: string;
+}
+export interface ProjectConfig {
+    language?: string;
+    package_manager?: string;
+    commit_style: string;
+    doc_tool?: string;
+    comment_style?: string;
+    caveman?: CavemanLevel;
+    compliance?: string[];
+    design_tool?: DesignToolConfig;
+    agents?: string[];
+}
+export interface LlmAgentConfig {
+    command: string;
+    model?: string;
+}
+export interface LlmConfig {
+    thinking: LlmAgentConfig;
+    coding: LlmAgentConfig;
+}
+export interface McpServer {
+    name: string;
+    command?: string;
+    args?: string[];
+    url?: string;
+    transport?: "stdio" | "sse" | "http";
+}
+export interface BugTrackerConfig {
+    name: string;
+    mcp?: McpServer;
+}
+export interface TestingToolConfig {
+    name: string;
+    purpose?: string;
+    mcp?: McpServer;
+}
+export interface GrimoireConfig {
+    version: number;
+    project: ProjectConfig;
+    features_dir: string;
+    decisions_dir: string;
+    tools: Record<string, ToolConfig>;
+    checks: string[];
+    llm: LlmConfig;
+    bug_trackers?: BugTrackerConfig[];
+    testing_tools?: TestingToolConfig[];
+}
+export declare function loadConfig(root?: string): Promise<GrimoireConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9D,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,EAAE,SAAS,CAAC;IACf,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAClC,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACrC;AAwHD,wBAAsB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAkCvE"}

package/dist/utils/config.js

@@ -0,0 +1,172 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { findProjectRoot } from "./paths.js";
+export const CURRENT_CONFIG_VERSION = 2;
+const DEFAULT_CHECKS = [
+    "lint",
+    "format",
+    "test_quality",
+    "doc_style",
+    "duplicates",
+    "complexity",
+    "dead_code",
+    "unit_test",
+    "bdd_test",
+    "security",
+    "best_practices",
+];
+const DEFAULT_LLM = {
+    thinking: { command: "claude" },
+    coding: { command: "claude" },
+};
+const DEFAULT_CONFIG = {
+    version: 1,
+    project: {
+        commit_style: "conventional",
+    },
+    features_dir: "features",
+    decisions_dir: ".grimoire/decisions",
+    tools: {},
+    checks: DEFAULT_CHECKS,
+    llm: DEFAULT_LLM,
+};
+function parseTools(raw) {
+    const tools = {};
+    if (raw.tools && typeof raw.tools === "object") {
+        for (const [key, val] of Object.entries(raw.tools)) {
+            if (val && typeof val === "object") {
+                const t = val;
+                tools[key] = {
+                    name: String(t.name ?? key),
+                    command: t.command ? String(t.command) : undefined,
+                    check_command: t.check_command ? String(t.check_command) : undefined,
+                    prompt: t.prompt ? String(t.prompt) : undefined,
+                };
+            }
+        }
+    }
+    return tools;
+}
+function parseProject(raw) {
+    const projectRaw = raw.project && typeof raw.project === "object"
+        ? raw.project
+        : {};
+    let design_tool;
+    if (projectRaw.design_tool && typeof projectRaw.design_tool === "object") {
+        const dt = projectRaw.design_tool;
+        design_tool = {
+            name: String(dt.name ?? ""),
+            path: str(dt.path),
+            url: str(dt.url),
+        };
+    }
+    return {
+        language: str(projectRaw.language ?? raw.language),
+        package_manager: str(projectRaw.package_manager),
+        commit_style: String(projectRaw.commit_style ?? raw.commit_style ?? DEFAULT_CONFIG.project.commit_style),
+        doc_tool: str(projectRaw.doc_tool ?? raw.doc_tool),
+        comment_style: str(projectRaw.comment_style ?? raw.comment_style),
+        caveman: str(projectRaw.caveman),
+        compliance: Array.isArray(projectRaw.compliance)
+            ? projectRaw.compliance.map(String)
+            : undefined,
+        design_tool,
+        agents: Array.isArray(projectRaw.agents)
+            ? projectRaw.agents.map(String)
+            : undefined,
+    };
+}
+function parseLlm(raw) {
+    const llmRaw = raw.llm && typeof raw.llm === "object"
+        ? raw.llm
+        : {};
+    if (llmRaw.thinking && typeof llmRaw.thinking === "object") {
+        // New nested format: llm.thinking + llm.coding
+        const thinkRaw = llmRaw.thinking;
+        const codeRaw = (llmRaw.coding && typeof llmRaw.coding === "object")
+            ? llmRaw.coding
+            : thinkRaw;
+        return {
+            thinking: {
+                command: String(thinkRaw.command ?? DEFAULT_LLM.thinking.command),
+                model: str(thinkRaw.model),
+            },
+            coding: {
+                command: String(codeRaw.command ?? DEFAULT_LLM.coding.command),
+                model: str(codeRaw.model),
+            },
+        };
+    }
+    // Legacy flat format: llm.command applies to both
+    const cmd = String(llmRaw.command ?? DEFAULT_LLM.thinking.command);
+    return {
+        thinking: { command: cmd },
+        coding: { command: cmd },
+    };
+}
+export async function loadConfig(root) {
+    const projectRoot = root ?? (await findProjectRoot());
+    const configPath = join(projectRoot, ".grimoire", "config.yaml");
+    let content;
+    try {
+        content = await readFile(configPath, "utf-8");
+    }
+    catch {
+        // Config file doesn't exist — use defaults
+        return structuredClone(DEFAULT_CONFIG);
+    }
+    let raw;
+    try {
+        raw = parseYaml(content) ?? {};
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.warn(`Warning: failed to parse ${configPath}: ${msg}\nFalling back to default config.`);
+        return structuredClone(DEFAULT_CONFIG);
+    }
+    return {
+        version: Number(raw.version ?? 1),
+        project: parseProject(raw),
+        features_dir: String(raw.features_dir ?? DEFAULT_CONFIG.features_dir),
+        decisions_dir: String(raw.decisions_dir ?? DEFAULT_CONFIG.decisions_dir),
+        tools: parseTools(raw),
+        checks: Array.isArray(raw.checks) ? raw.checks : DEFAULT_CHECKS,
+        llm: parseLlm(raw),
+        bug_trackers: Array.isArray(raw.bug_trackers) ? parseBugTrackers(raw.bug_trackers) : undefined,
+        testing_tools: Array.isArray(raw.testing_tools) ? parseTestingTools(raw.testing_tools) : undefined,
+    };
+}
+function parseMcpServer(raw) {
+    if (!raw.mcp || typeof raw.mcp !== "object")
+        return undefined;
+    const m = raw.mcp;
+    return {
+        name: String(m.name ?? ""),
+        command: str(m.command),
+        args: Array.isArray(m.args) ? m.args.map(String) : undefined,
+        url: str(m.url),
+        transport: str(m.transport),
+    };
+}
+function parseBugTrackers(raw) {
+    return raw
+        .filter((item) => !!item && typeof item === "object")
+        .map((item) => ({
+        name: String(item.name ?? ""),
+        mcp: parseMcpServer(item),
+    }));
+}
+function parseTestingTools(raw) {
+    return raw
+        .filter((item) => !!item && typeof item === "object")
+        .map((item) => ({
+        name: String(item.name ?? ""),
+        purpose: str(item.purpose),
+        mcp: parseMcpServer(item),
+    }));
+}
+function str(val) {
+    return val ? String(val) : undefined;
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/fs.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Check if a path exists (file or directory).
+ */
+export declare function fileExists(path: string): Promise<boolean>;
+/**
+ * Read a file, returning null if it doesn't exist or can't be read.
+ */
+export declare function readFileOrNull(path: string): Promise<string | null>;
+/**
+ * Escape a string for use in a RegExp constructor.
+ */
+export declare function escapeRegex(str: string): string;
+/**
+ * Find files matching a glob extension pattern under a directory.
+ */
+export declare function findFiles(dir: string, ext: string): Promise<string[]>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMzE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE3E"}

package/dist/utils/fs.js

@@ -0,0 +1,38 @@
+import { access, readFile } from "node:fs/promises";
+import fg from "fast-glob";
+/**
+ * Check if a path exists (file or directory).
+ */
+export async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read a file, returning null if it doesn't exist or can't be read.
+ */
+export async function readFileOrNull(path) {
+    try {
+        return await readFile(path, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Escape a string for use in a RegExp constructor.
+ */
+export function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Find files matching a glob extension pattern under a directory.
+ */
+export async function findFiles(dir, ext) {
+    return fg(`**/*${ext}`, { cwd: dir, absolute: true });
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,MAAM,WAAW,CAAC;AAE3B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,GAAW;IACtD,OAAO,EAAE,CAAC,OAAO,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AACxD,CAAC"}