qfai 0.2.5

package/dist/cli/main.js

@@ -0,0 +1,73 @@
+import { runInit } from "./commands/init.js";
+import { runReport } from "./commands/report.js";
+import { runValidate } from "./commands/validate.js";
+import { parseArgs } from "./lib/args.js";
+import { error, info } from "./lib/logger.js";
+export async function run(argv, cwd) {
+    const { command, options } = parseArgs(argv, cwd);
+    if (!command || options.help) {
+        info(usage());
+        return;
+    }
+    switch (command) {
+        case "init":
+            await runInit({
+                dir: options.dir,
+                force: options.force,
+                dryRun: options.dryRun,
+                yes: options.yes,
+            });
+            return;
+        case "validate":
+            process.exitCode = await runValidate({
+                root: options.root,
+                strict: options.strict,
+                format: options.validateFormat,
+                ...(options.failOn !== undefined ? { failOn: options.failOn } : {}),
+                ...(options.jsonPath !== undefined
+                    ? { jsonPath: options.jsonPath }
+                    : {}),
+            });
+            return;
+        case "report":
+            await runReport({
+                root: options.root,
+                format: options.reportFormat,
+                ...(options.jsonPath !== undefined
+                    ? { jsonPath: options.jsonPath }
+                    : {}),
+                ...(options.reportOut !== undefined
+                    ? { outPath: options.reportOut }
+                    : {}),
+            });
+            return;
+        default:
+            error(`Unknown command: ${command}`);
+            info(usage());
+            return;
+    }
+}
+function usage() {
+    return `qfai <command> [options]
+
+Commands:
+  init       テンプレを生成
+  validate   仕様/契約/参照の検査
+  report     検証結果と集計を出力
+
+Options:
+  --root <path>   対象ディレクトリ
+  --dir <path>    init の出力先
+  --force         既存ファイルを上書き
+  --yes           init: 非対話でデフォルトを採用（現在は非対話が既定、将来の対話導入時も自動Yes）
+  --dry-run       変更を行わず表示のみ
+  --format <text|json|github>  validate の出力形式
+  --format <md|json>           report の出力形式
+  --strict              validate: warning 以上で exit 1
+  --fail-on <error|warning|never>  validate: 失敗条件
+  --json-path <path>     validate: JSON 出力先 / report: validate JSON 入力
+  --out <path>           report: 出力先
+  -h, --help      ヘルプ表示
+`;
+}
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc,EAAE,GAAW;IACnD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAElD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACd,OAAO;IACT,CAAC;IAED,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,MAAM,OAAO,CAAC;gBACZ,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC,CAAC;YACH,OAAO;QACT,KAAK,UAAU;YACb,OAAO,CAAC,QAAQ,GAAG,MAAM,WAAW,CAAC;gBACnC,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,MAAM,EAAE,OAAO,CAAC,cAAc;gBAC9B,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS;oBAChC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE;oBAChC,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAC;YACH,OAAO;QACT,KAAK,QAAQ;YACX,MAAM,SAAS,CAAC;gBACd,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,MAAM,EAAE,OAAO,CAAC,YAAY;gBAC5B,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS;oBAChC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE;oBAChC,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS;oBACjC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE;oBAChC,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAC;YACH,OAAO;QACT;YACE,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YACrC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACd,OAAO;IACX,CAAC;AACH,CAAC;AAED,SAAS,KAAK;IACZ,OAAO;;;;;;;;;;;;;;;;;;;;CAoBR,CAAC;AACF,CAAC"}

package/dist/core/config.d.ts

@@ -0,0 +1,46 @@
+import type { Issue } from "./types.js";
+export type FailOn = "never" | "warning" | "error";
+export type OutputFormat = "text" | "json" | "github";
+export type QfaiPaths = {
+    specDir: string;
+    decisionsDir: string;
+    scenariosDir: string;
+    rulesDir: string;
+    contractsDir: string;
+    uiContractsDir: string;
+    apiContractsDir: string;
+    dataContractsDir: string;
+    srcDir: string;
+    testsDir: string;
+};
+export type QfaiValidationConfig = {
+    failOn: FailOn;
+    require: {
+        specSections: string[];
+    };
+    traceability: {
+        brMustHaveSc: boolean;
+        scMustTouchContracts: boolean;
+        allowOrphanContracts: boolean;
+    };
+};
+export type QfaiOutputConfig = {
+    format: OutputFormat;
+    jsonPath: string;
+};
+export type QfaiConfig = {
+    paths: QfaiPaths;
+    validation: QfaiValidationConfig;
+    output: QfaiOutputConfig;
+};
+export type ConfigPathKey = keyof QfaiPaths;
+export type ConfigLoadResult = {
+    config: QfaiConfig;
+    issues: Issue[];
+    configPath: string;
+};
+export declare const defaultConfig: QfaiConfig;
+export declare function getConfigPath(root: string): string;
+export declare function loadConfig(root: string): Promise<ConfigLoadResult>;
+export declare function resolvePath(root: string, config: QfaiConfig, key: ConfigPathKey): string;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AACnD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtD,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IACF,YAAY,EAAE;QACZ,YAAY,EAAE,OAAO,CAAC;QACtB,oBAAoB,EAAE,OAAO,CAAC;QAC9B,oBAAoB,EAAE,OAAO,CAAC;KAC/B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,oBAAoB,CAAC;IACjC,MAAM,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,SAAS,CAAC;AAE5C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,UAoC3B,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkBxE;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,aAAa,GACjB,MAAM,CAER"}

package/dist/core/config.js

@@ -0,0 +1,224 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+export const defaultConfig = {
+    paths: {
+        specDir: "qfai/spec",
+        decisionsDir: "qfai/spec/decisions",
+        scenariosDir: "qfai/spec",
+        rulesDir: "qfai/rules",
+        contractsDir: "qfai/contracts",
+        uiContractsDir: "qfai/contracts/ui",
+        apiContractsDir: "qfai/contracts/api",
+        dataContractsDir: "qfai/contracts/db",
+        srcDir: "src",
+        testsDir: "tests",
+    },
+    validation: {
+        failOn: "error",
+        require: {
+            specSections: [
+                "背景",
+                "スコープ",
+                "非ゴール",
+                "用語",
+                "前提",
+                "決定事項",
+                "業務ルール",
+            ],
+        },
+        traceability: {
+            brMustHaveSc: true,
+            scMustTouchContracts: true,
+            allowOrphanContracts: false,
+        },
+    },
+    output: {
+        format: "text",
+        jsonPath: ".qfai/out/validate.json",
+    },
+};
+export function getConfigPath(root) {
+    return path.join(root, "qfai.config.yaml");
+}
+export async function loadConfig(root) {
+    const configPath = getConfigPath(root);
+    const issues = [];
+    let parsed;
+    try {
+        const raw = await readFile(configPath, "utf-8");
+        parsed = parseYaml(raw);
+    }
+    catch (error) {
+        if (isMissingFile(error)) {
+            return { config: defaultConfig, issues, configPath };
+        }
+        issues.push(configIssue(configPath, formatError(error)));
+        return { config: defaultConfig, issues, configPath };
+    }
+    const normalized = normalizeConfig(parsed, configPath, issues);
+    return { config: normalized, issues, configPath };
+}
+export function resolvePath(root, config, key) {
+    return path.resolve(root, config.paths[key]);
+}
+function normalizeConfig(raw, configPath, issues) {
+    if (!isRecord(raw)) {
+        issues.push(configIssue(configPath, "設定ファイルの形式が不正です。"));
+        return defaultConfig;
+    }
+    return {
+        paths: normalizePaths(raw.paths, configPath, issues),
+        validation: normalizeValidation(raw.validation, configPath, issues),
+        output: normalizeOutput(raw.output, configPath, issues),
+    };
+}
+function normalizePaths(raw, configPath, issues) {
+    const base = defaultConfig.paths;
+    if (!raw) {
+        return base;
+    }
+    if (!isRecord(raw)) {
+        issues.push(configIssue(configPath, "paths はオブジェクトである必要があります。"));
+        return base;
+    }
+    return {
+        specDir: readString(raw.specDir, base.specDir, "paths.specDir", configPath, issues),
+        decisionsDir: readString(raw.decisionsDir, base.decisionsDir, "paths.decisionsDir", configPath, issues),
+        scenariosDir: readString(raw.scenariosDir, base.scenariosDir, "paths.scenariosDir", configPath, issues),
+        rulesDir: readString(raw.rulesDir, base.rulesDir, "paths.rulesDir", configPath, issues),
+        contractsDir: readString(raw.contractsDir, base.contractsDir, "paths.contractsDir", configPath, issues),
+        uiContractsDir: readString(raw.uiContractsDir, base.uiContractsDir, "paths.uiContractsDir", configPath, issues),
+        apiContractsDir: readString(raw.apiContractsDir, base.apiContractsDir, "paths.apiContractsDir", configPath, issues),
+        dataContractsDir: readString(raw.dataContractsDir, base.dataContractsDir, "paths.dataContractsDir", configPath, issues),
+        srcDir: readString(raw.srcDir, base.srcDir, "paths.srcDir", configPath, issues),
+        testsDir: readString(raw.testsDir, base.testsDir, "paths.testsDir", configPath, issues),
+    };
+}
+function normalizeValidation(raw, configPath, issues) {
+    const base = defaultConfig.validation;
+    if (!raw) {
+        return base;
+    }
+    if (!isRecord(raw)) {
+        issues.push(configIssue(configPath, "validation はオブジェクトである必要があります。"));
+        return base;
+    }
+    let requireRaw;
+    if (raw.require === undefined) {
+        requireRaw = undefined;
+    }
+    else if (isRecord(raw.require)) {
+        requireRaw = raw.require;
+    }
+    else {
+        issues.push(configIssue(configPath, "validation.require はオブジェクトである必要があります。"));
+        requireRaw = undefined;
+    }
+    let traceabilityRaw;
+    if (raw.traceability === undefined) {
+        traceabilityRaw = undefined;
+    }
+    else if (isRecord(raw.traceability)) {
+        traceabilityRaw = raw.traceability;
+    }
+    else {
+        issues.push(configIssue(configPath, "validation.traceability はオブジェクトである必要があります。"));
+        traceabilityRaw = undefined;
+    }
+    return {
+        failOn: readFailOn(raw.failOn, base.failOn, "validation.failOn", configPath, issues),
+        require: {
+            specSections: readStringArray(requireRaw?.specSections, base.require.specSections, "validation.require.specSections", configPath, issues),
+        },
+        traceability: {
+            brMustHaveSc: readBoolean(traceabilityRaw?.brMustHaveSc, base.traceability.brMustHaveSc, "validation.traceability.brMustHaveSc", configPath, issues),
+            scMustTouchContracts: readBoolean(traceabilityRaw?.scMustTouchContracts, base.traceability.scMustTouchContracts, "validation.traceability.scMustTouchContracts", configPath, issues),
+            allowOrphanContracts: readBoolean(traceabilityRaw?.allowOrphanContracts, base.traceability.allowOrphanContracts, "validation.traceability.allowOrphanContracts", configPath, issues),
+        },
+    };
+}
+function normalizeOutput(raw, configPath, issues) {
+    const base = defaultConfig.output;
+    if (!raw) {
+        return base;
+    }
+    if (!isRecord(raw)) {
+        issues.push(configIssue(configPath, "output はオブジェクトである必要があります。"));
+        return base;
+    }
+    return {
+        format: readOutputFormat(raw.format, base.format, "output.format", configPath, issues),
+        jsonPath: readString(raw.jsonPath, base.jsonPath, "output.jsonPath", configPath, issues),
+    };
+}
+function readString(value, fallback, label, configPath, issues) {
+    if (typeof value === "string" && value.trim().length > 0) {
+        return value;
+    }
+    if (value !== undefined) {
+        issues.push(configIssue(configPath, `${label} は文字列である必要があります。`));
+    }
+    return fallback;
+}
+function readStringArray(value, fallback, label, configPath, issues) {
+    if (Array.isArray(value) && value.every((item) => typeof item === "string")) {
+        return value;
+    }
+    if (value !== undefined) {
+        issues.push(configIssue(configPath, `${label} は文字列配列である必要があります。`));
+    }
+    return fallback;
+}
+function readBoolean(value, fallback, label, configPath, issues) {
+    if (typeof value === "boolean") {
+        return value;
+    }
+    if (value !== undefined) {
+        issues.push(configIssue(configPath, `${label} は真偽値である必要があります。`));
+    }
+    return fallback;
+}
+function readFailOn(value, fallback, label, configPath, issues) {
+    if (value === "never" || value === "warning" || value === "error") {
+        return value;
+    }
+    if (value !== undefined) {
+        issues.push(configIssue(configPath, `${label} は never|warning|error のいずれかである必要があります。`));
+    }
+    return fallback;
+}
+function readOutputFormat(value, fallback, label, configPath, issues) {
+    if (value === "text" || value === "json" || value === "github") {
+        return value;
+    }
+    if (value !== undefined) {
+        issues.push(configIssue(configPath, `${label} は text|json|github のいずれかである必要があります。`));
+    }
+    return fallback;
+}
+function configIssue(file, message) {
+    return {
+        code: "QFAI_CONFIG_INVALID",
+        severity: "error",
+        message,
+        file,
+        rule: "config.invalid",
+    };
+}
+function isMissingFile(error) {
+    if (error && typeof error === "object" && "code" in error) {
+        return error.code === "ENOENT";
+    }
+    return false;
+}
+function formatError(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/discovery.d.ts

@@ -0,0 +1,11 @@
+export type ContractFiles = {
+    api: string[];
+    ui: string[];
+    db: string[];
+};
+export declare function collectSpecFiles(specRoot: string): Promise<string[]>;
+export declare function collectUiContractFiles(uiRoot: string): Promise<string[]>;
+export declare function collectApiContractFiles(apiRoot: string): Promise<string[]>;
+export declare function collectDataContractFiles(dataRoot: string): Promise<string[]>;
+export declare function collectContractFiles(uiRoot: string, apiRoot: string, dataRoot: string): Promise<ContractFiles>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/core/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/core/discovery.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;CACd,CAAC;AAEF,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAG1E;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB;AAED,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC,CAOxB"}

package/dist/core/discovery.js

@@ -0,0 +1,31 @@
+import path from "node:path";
+import { collectFiles } from "./fs.js";
+const LEGACY_SPEC_NAME = "spec.md";
+// Four-digit, zero-padded spec number (e.g. spec-0001-...); basename is lowercased before match.
+const SPEC_NAMED_PATTERN = /^spec-\d{4}-[^/\\]+\.md$/;
+export async function collectSpecFiles(specRoot) {
+    const files = await collectFiles(specRoot, { extensions: [".md"] });
+    return files.filter((file) => isSpecFile(file));
+}
+export async function collectUiContractFiles(uiRoot) {
+    return collectFiles(uiRoot, { extensions: [".yaml", ".yml"] });
+}
+export async function collectApiContractFiles(apiRoot) {
+    return collectFiles(apiRoot, { extensions: [".yaml", ".yml", ".json"] });
+}
+export async function collectDataContractFiles(dataRoot) {
+    return collectFiles(dataRoot, { extensions: [".sql"] });
+}
+export async function collectContractFiles(uiRoot, apiRoot, dataRoot) {
+    const [ui, api, db] = await Promise.all([
+        collectUiContractFiles(uiRoot),
+        collectApiContractFiles(apiRoot),
+        collectDataContractFiles(dataRoot),
+    ]);
+    return { ui, api, db };
+}
+function isSpecFile(filePath) {
+    const name = path.basename(filePath).toLowerCase();
+    return name === LEGACY_SPEC_NAME || SPEC_NAMED_PATTERN.test(name);
+}
+//# sourceMappingURL=discovery.js.map

package/dist/core/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/core/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AACnC,iGAAiG;AACjG,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAQtD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IACrD,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAc;IAEd,OAAO,YAAY,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAe;IAEf,OAAO,YAAY,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,QAAgB;IAEhB,OAAO,YAAY,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAc,EACd,OAAe,EACf,QAAgB;IAEhB,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACtC,sBAAsB,CAAC,MAAM,CAAC;QAC9B,uBAAuB,CAAC,OAAO,CAAC;QAChC,wBAAwB,CAAC,QAAQ,CAAC;KACnC,CAAC,CAAC;IACH,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACnD,OAAO,IAAI,KAAK,gBAAgB,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC"}

package/dist/core/fs.d.ts

@@ -0,0 +1,6 @@
+export type CollectFilesOptions = {
+    extensions?: string[];
+    ignoreDirs?: string[];
+};
+export declare function collectFiles(root: string, options?: CollectFilesOptions): Promise<string[]>;
+//# sourceMappingURL=fs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/core/fs.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB"}

package/dist/core/fs.js

@@ -0,0 +1,55 @@
+import { access, readdir } from "node:fs/promises";
+import path from "node:path";
+const DEFAULT_IGNORE_DIRS = new Set([
+    "node_modules",
+    ".git",
+    "dist",
+    ".pnpm",
+    "tmp",
+    ".mcp-tools",
+]);
+export async function collectFiles(root, options = {}) {
+    const entries = [];
+    if (!(await exists(root))) {
+        return entries;
+    }
+    const ignoreDirs = new Set([
+        ...DEFAULT_IGNORE_DIRS,
+        ...(options.ignoreDirs ?? []),
+    ]);
+    const extensions = options.extensions?.map((ext) => ext.toLowerCase()) ?? [];
+    await walk(root, root, ignoreDirs, extensions, entries);
+    return entries;
+}
+async function walk(base, current, ignoreDirs, extensions, out) {
+    const items = await readdir(current, { withFileTypes: true });
+    for (const item of items) {
+        const fullPath = path.join(current, item.name);
+        if (item.isDirectory()) {
+            if (ignoreDirs.has(item.name)) {
+                continue;
+            }
+            await walk(base, fullPath, ignoreDirs, extensions, out);
+            continue;
+        }
+        if (item.isFile()) {
+            if (extensions.length > 0) {
+                const ext = path.extname(item.name).toLowerCase();
+                if (!extensions.includes(ext)) {
+                    continue;
+                }
+            }
+            out.push(fullPath);
+        }
+    }
+}
+async function exists(target) {
+    try {
+        await access(target);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/core/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/core/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,cAAc;IACd,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;IACL,YAAY;CACb,CAAC,CAAC;AAOH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,UAA+B,EAAE;IAEjC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;QACzB,GAAG,mBAAmB;QACtB,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;KAC9B,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAE7E,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACxD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,IAAI,CACjB,IAAY,EACZ,OAAe,EACf,UAAuB,EACvB,UAAoB,EACpB,GAAa;IAEb,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE/C,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,SAAS;YACX,CAAC;YACD,MAAM,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;YACxD,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YAClB,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;gBAClD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC9B,SAAS;gBACX,CAAC;YACH,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,MAAc;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/core/ids.d.ts

@@ -0,0 +1,5 @@
+export type IdPrefix = "SPEC" | "BR" | "SC" | "UI" | "API" | "DATA";
+export declare function extractIds(text: string, prefix: IdPrefix): string[];
+export declare function extractAllIds(text: string): string[];
+export declare function extractInvalidIds(text: string, prefixes: IdPrefix[]): string[];
+//# sourceMappingURL=ids.d.ts.map

package/dist/core/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/core/ids.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;AAoBpE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,MAAM,EAAE,CAInE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMpD;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,EAAE,GACnB,MAAM,EAAE,CAWV"}

package/dist/core/ids.js

@@ -0,0 +1,49 @@
+const ID_PATTERNS = {
+    SPEC: /\bSPEC-[A-Z0-9-]+\b/g,
+    BR: /\bBR-[A-Z0-9-]+\b/g,
+    SC: /\bSC-[A-Z0-9-]+\b/g,
+    UI: /\bUI-[A-Z0-9-]+\b/g,
+    API: /\bAPI-[A-Z0-9-]+\b/g,
+    DATA: /\bDATA-[A-Z0-9-]+\b/g,
+};
+const LOOSE_ID_PATTERNS = {
+    SPEC: /\bSPEC-[A-Za-z0-9_-]+\b/gi,
+    BR: /\bBR-[A-Za-z0-9_-]+\b/gi,
+    SC: /\bSC-[A-Za-z0-9_-]+\b/gi,
+    UI: /\bUI-[A-Za-z0-9_-]+\b/gi,
+    API: /\bAPI-[A-Za-z0-9_-]+\b/gi,
+    DATA: /\bDATA-[A-Za-z0-9_-]+\b/gi,
+};
+export function extractIds(text, prefix) {
+    const pattern = ID_PATTERNS[prefix];
+    const matches = text.match(pattern);
+    return unique(matches ?? []);
+}
+export function extractAllIds(text) {
+    const all = [];
+    Object.keys(ID_PATTERNS).forEach((prefix) => {
+        all.push(...extractIds(text, prefix));
+    });
+    return unique(all);
+}
+export function extractInvalidIds(text, prefixes) {
+    const invalid = [];
+    for (const prefix of prefixes) {
+        const candidates = text.match(LOOSE_ID_PATTERNS[prefix]) ?? [];
+        for (const candidate of candidates) {
+            if (!isValidId(candidate, prefix)) {
+                invalid.push(candidate);
+            }
+        }
+    }
+    return unique(invalid);
+}
+function unique(values) {
+    return Array.from(new Set(values));
+}
+function isValidId(value, prefix) {
+    const pattern = ID_PATTERNS[prefix];
+    const strict = new RegExp(pattern.source);
+    return strict.test(value);
+}
+//# sourceMappingURL=ids.js.map

package/dist/core/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/core/ids.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAA6B;IAC5C,IAAI,EAAE,sBAAsB;IAC5B,EAAE,EAAE,oBAAoB;IACxB,EAAE,EAAE,oBAAoB;IACxB,EAAE,EAAE,oBAAoB;IACxB,GAAG,EAAE,qBAAqB;IAC1B,IAAI,EAAE,sBAAsB;CAC7B,CAAC;AAEF,MAAM,iBAAiB,GAA6B;IAClD,IAAI,EAAE,2BAA2B;IACjC,EAAE,EAAE,yBAAyB;IAC7B,EAAE,EAAE,yBAAyB;IAC7B,EAAE,EAAE,yBAAyB;IAC7B,GAAG,EAAE,0BAA0B;IAC/B,IAAI,EAAE,2BAA2B;CAClC,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,MAAgB;IACvD,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,GAAG,GAAa,EAAE,CAAC;IACxB,MAAM,CAAC,IAAI,CAAC,WAAW,CAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QAC1D,GAAG,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,QAAoB;IAEpB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/D,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,MAAM,CAAC,MAAgB;IAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,MAAgB;IAChD,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./config.js";
+export * from "./ids.js";
+export * from "./report.js";
+export * from "./types.js";
+export * from "./validate.js";
+export * from "./version.js";
+export * from "./validators/contracts.js";
+export * from "./validators/scenario.js";
+export * from "./validators/spec.js";
+export * from "./validators/traceability.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,11 @@
+export * from "./config.js";
+export * from "./ids.js";
+export * from "./report.js";
+export * from "./types.js";
+export * from "./validate.js";
+export * from "./version.js";
+export * from "./validators/contracts.js";
+export * from "./validators/scenario.js";
+export * from "./validators/spec.js";
+export * from "./validators/traceability.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC"}

package/dist/core/report.d.ts

@@ -0,0 +1,41 @@
+import { type ConfigLoadResult } from "./config.js";
+import type { Issue, ValidationCounts, ValidationResult } from "./types.js";
+export type ReportSummary = {
+    specs: number;
+    scenarios: number;
+    decisions: number;
+    rules: number;
+    contracts: {
+        api: number;
+        ui: number;
+        db: number;
+    };
+    counts: ValidationCounts;
+};
+export type ReportIds = {
+    spec: string[];
+    br: string[];
+    sc: string[];
+    ui: string[];
+    api: string[];
+    data: string[];
+};
+export type ReportTraceability = {
+    upstreamIdsFound: number;
+    referencedInCodeOrTests: boolean;
+};
+export type ReportData = {
+    tool: "qfai";
+    version: string;
+    generatedAt: string;
+    root: string;
+    configPath: string;
+    summary: ReportSummary;
+    ids: ReportIds;
+    traceability: ReportTraceability;
+    issues: Issue[];
+};
+export declare function createReportData(root: string, validation?: ValidationResult, configResult?: ConfigLoadResult): Promise<ReportData>;
+export declare function formatReportMarkdown(data: ReportData): string;
+export declare function formatReportJson(data: ReportData): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/core/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/core/report.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAI7E,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAI5E,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE;QACT,GAAG,EAAE,MAAM,CAAC;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF,MAAM,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,GAAG,EAAE,SAAS,CAAC;IACf,YAAY,EAAE,kBAAkB,CAAC;IACjC,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB,CAAC;AAIF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,gBAAgB,EAC7B,YAAY,CAAC,EAAE,gBAAgB,GAC9B,OAAO,CAAC,UAAU,CAAC,CAqFrB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAsF7D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEzD"}