qfai 0.4.2 → 0.4.6

package/README.md

@@ -32,6 +32,20 @@ npx qfai report
 設定はリポジトリ直下の `qfai.config.yaml` で行います。
 命名規約は `docs/rules/naming.md` を参照してください。
 
+## Contracts
+
+Spec では `QFAI-CONTRACT-REF:` 行で参照する契約IDを宣言します（`none` 可、宣言行は必須）。
+契約ファイルは `QFAI-CONTRACT-ID: <ID>` を **1ファイル1ID** で宣言します。
+Contract ID prefix は `UI-0001` / `API-0001` / `DB-0001` です。
+宣言では大文字（`UI-0001`）、ファイル名は小文字（`ui-0001-...`）を使用します。
+
+契約関連の検証は `validation.traceability` で制御します。
+
+- `validation.traceability.allowOrphanContracts`: Spec から参照されない契約の許可（default: `false`）
+- `validation.traceability.unknownContractIdSeverity`: Spec が参照した契約 ID が存在しない場合の severity（default: `error`、`error` / `warning` のみ）
+
+`npx qfai init` は `.qfai/contracts/` 配下に UI/API/DB のサンプルを生成します。
+
 SC→Test の参照はテストコード内の `QFAI:SC-xxxx` アノテーションで宣言します。
 SC→Test の対象ファイルは `validation.traceability.testFileGlobs` で指定します。
 除外は `validation.traceability.testFileExcludeGlobs` で指定できます。

package/assets/init/.qfai/README.md

@@ -12,6 +12,7 @@ npx qfai report
 ## トレーサビリティ（SC→Test）
 
 - `validation.traceability.testFileGlobs` に一致するテストコードで `QFAI:SC-xxxx` を参照する（コメント可）
+- Spec→Contract は `spec.md` の `QFAI-CONTRACT-REF` 行で宣言する
 
 ## ディレクトリ概要
 

package/assets/init/.qfai/contracts/README.md

@@ -1,16 +1,24 @@
 # Contracts (UI / API / DB)
 
-契約は「システム外部との約束」を明文化する場所です。Scenario または Spec から参照される前提で作成します。
+契約は「システム外部との約束」を明文化する場所です。Spec（spec.md）の `QFAI-CONTRACT-REF` による参照が必須で、これが Spec→Contract 対応の SSOT になります。Scenario からの参照は任意です。
 
 ## 置くべきファイル
 
 - UI: `ui/ui-0001-<slug>.yaml` または `.yml`
 - API: `api/api-0001-<slug>.yaml` / `.yml` / `.json`（OpenAPI）
-- DB: `db/db-0001-<slug>.sql`（ID は `DATA-xxxx`）
+- DB: `db/db-0001-<slug>.sql`（ID は `DB-xxxx`）
+
+## 契約ID宣言（必須）
+
+- 1ファイル = 1ID
+- 契約IDの正は契約ファイル側（`QFAI-CONTRACT-ID` が SSOT）
+- ファイル内に `QFAI-CONTRACT-ID: <ID>` をコメント行で宣言する
+- 例: `# QFAI-CONTRACT-ID: API-0001` / `// QFAI-CONTRACT-ID: UI-0001` / `-- QFAI-CONTRACT-ID: DB-0001`
 
 ## 最小例（UI）
 
 ```yaml
+# QFAI-CONTRACT-ID: UI-0001
 id: UI-0001
 name: 受注登録画面
 refs:
@@ -20,6 +28,7 @@ refs:
 ## 最小例（API）
 
 ```yaml
+# QFAI-CONTRACT-ID: API-0001
 openapi: 3.0.0
 info:
   title: Sample API
@@ -36,7 +45,7 @@ paths:
 ## 最小例（DB）
 
 ```sql
--- DATA-0001
+-- QFAI-CONTRACT-ID: DB-0001
 CREATE TABLE sample_table (
   id INTEGER PRIMARY KEY
 );
@@ -44,18 +53,19 @@ CREATE TABLE sample_table (
 
 ## CI でチェックされること（抜粋）
 
-- UI/API: パース失敗は error、ID 未定義は error
-- UI: `UI-xxxx` の ID が必要
-- API: OpenAPI 定義があること、`API-xxxx` の operationId が必要
+- 契約宣言: `QFAI-CONTRACT-ID` の未記載/複数宣言/重複IDは error
+- 契約ID: 配置ディレクトリ（ui/api/db）と prefix（UI/API/DB）の不整合は error
+- UI/API: パース失敗は error
+- API: OpenAPI 定義があること（`openapi`）
 - DB: 危険 SQL（DROP/TRUNCATE 等）の警告
-- 共通: ID 形式（`PREFIX-0001`）、定義 ID の重複検知
+- 共通: ID 形式（`PREFIX-0001`）、ID の重複検知
 
 ## 依存関係
 
-- Scenario → Contracts（UI/API/DATA のいずれかへ接続）
-- Spec → Contracts（参照は許容）
+- Spec → Contracts（spec.md に `QFAI-CONTRACT-REF` を必ず1行以上宣言、0件は `none`。この行が SSOT）
+- Scenario → Contracts（UI/API/DB の参照は任意。付けるなら関連が強い箇所に限定）
 
 ## 良い例 / 悪い例
 
-- 良い例: `@SC-xxxx` から `UI-xxxx` が参照されている
-- 悪い例: 契約が Scenario から一切参照されない
+- 良い例: Spec で契約を参照し、必要に応じて Scenario でも参照している
+- 悪い例: Spec が契約を参照しておらず orphan contract が発生する（allowOrphanContracts=false で error）

package/assets/init/.qfai/contracts/api/api-0001-sample.yaml

@@ -1,6 +1,7 @@
+# QFAI-CONTRACT-ID: API-0001
 # OpenAPI contract sample (API-0001)
+# - 必須: QFAI-CONTRACT-ID (1ファイル1ID)
 # - 必須: openapi, info, paths
-# - 重要: operationId に API-0001 のような ID を含める（validate が参照整合に利用）
 openapi: 3.0.0
 info:
   title: QFAI Sample API
@@ -8,7 +9,7 @@ info:
 paths:
   /health:
     get:
-      operationId: API-0001
+      operationId: healthCheck
       responses:
         "200":
           description: OK

package/assets/init/.qfai/contracts/db/db-0001-sample.sql

@@ -1,4 +1,5 @@
--- DATA-0001 (DB contract sample)
+-- QFAI-CONTRACT-ID: DB-0001
+-- DB-0001 (DB contract sample)
 -- 破壊的 SQL (削除/破棄系) は警告対象
 CREATE TABLE sample_table (
   id INTEGER PRIMARY KEY,

package/assets/init/.qfai/contracts/ui/ui-0001-sample.yaml

@@ -1,5 +1,7 @@
+# QFAI-CONTRACT-ID: UI-0001
 # UI contract sample (UI-0001)
-# - 必須: id (例: UI-0001), name, refs
+# - 必須: QFAI-CONTRACT-ID (1ファイル1ID)
+# - 任意: id, name, refs
 id: UI-0001
 name: Order Registration
 refs:

package/assets/init/.qfai/promptpack/modes/change.md

@@ -1,4 +1,5 @@
 # Mode: Change
 
-- 仕様変更の根拠を delta.md に必ず記録する
-- 影響範囲を整理し、テストを増分で設計する
+- 期待値/挙動/互換性が変わる場合は Change を選ぶ
+- 仕様変更の根拠（Why）を delta.md に必ず記録する
+- 影響範囲、移行・運用への影響、受入テスト更新方針を明記する

package/assets/init/.qfai/promptpack/modes/compatibility.md

@@ -1,4 +1,6 @@
 # Mode: Compatibility
 
 - 既存仕様との整合を最優先にする
+- 期待値/外部I/Fの変更は行わない（変更がある場合は Change へ）
 - 影響範囲を最小化し、回帰テストを重視する
+- 分類と根拠（Why）、影響範囲、受入テスト更新方針を明記する

package/assets/init/.qfai/promptpack/steering/traceability.md

@@ -1,9 +1,10 @@
 # Traceability
 
-参照は下流→上流のみを許可する。
+参照は下流→上流のみを許可する（下流参照禁止の対象はテスト/実装）。
 
-- SC は BR を参照する
-- テスト/コードは SC を参照する
-- Spec は契約/テストを参照しない
+- Spec は QFAI-CONTRACT-REF で契約IDを宣言する（none可、宣言行は必須）
+- Scenario は @SPEC-xxxx / @SC-xxxx / @BR-xxxx を持つ（契約ID参照は任意）
+- テスト/コードは QFAI:SC-xxxx で SC を参照する
+- Spec はテスト/実装（src/tests）を参照しない
 
 違反は CI で検出される前提で運用する。

package/assets/init/.qfai/prompts/makeOverview.md

@@ -18,7 +18,7 @@
 - Spec本文に書かれていないことは推測しない（不明は `TBD` と書く）。
 - SpecのIDとタイトルは、本文先頭の `# SPEC-xxxx ...` を正とし、ファイル名は補助。
 - 各Specについて最低限以下を表にする:
-  - SPEC-ID / Title / Outcome(1行) / Status / SC / UI / API / DB(or DATA) / Tags
+  - SPEC-ID / Title / Outcome(1行) / Status / SC / UI / API / DB / Tags
 - 参照が欠けている場合（例: SCが未記載）は “欠落一覧” に列挙する。
 
 ## Format

package/assets/init/.qfai/prompts/require-to-spec.md

@@ -19,12 +19,14 @@
 ## Rules
 
 - **推測しない**。要件に書かれていないことは `TBD` と明記する。
-- ID は `PREFIX-0001` 形式（SPEC/BR/SC/UI/API/DATA）。
+- ID は `PREFIX-0001` 形式（SPEC/BR/SC/UI/API/DB）。
 - `spec.md` の必須セクションは `qfai.config.yaml` の設定に従う。
 - BR は `## 業務ルール` にのみ定義し、`- [BR-0001][P1] ...` 形式で書く。
+- `spec.md` に `QFAI-CONTRACT-REF:` を必ず記載する（不要なら `none`）。
 - `scenario.md` は Gherkin で書き、Feature に `@SPEC-xxxx` を付与する。
 - 各 Scenario は `@SC-xxxx` を **ちょうど1つ**、`@BR-xxxx` を **1つ以上**持つこと。
-- 契約 ID（UI/API/DATA）が必要なら、タグまたは本文に明示する。
+- 契約ファイルには `QFAI-CONTRACT-ID: <ID>` を宣言する。
+- 契約 ID（UI/API/DB）を Scenario で参照する場合はタグまたは本文に明示する。
 - `delta.md` の「変更区分」は **Compatibility / Change/Improvement のいずれか1つにチェック**する。
   - 判断できない場合は `Compatibility` を選び、`TBD` を理由欄に記載する。
 

package/assets/init/.qfai/specs/README.md

@@ -15,6 +15,8 @@
 ```md
 # SPEC-0001: 注文登録の最小要件
 
+QFAI-CONTRACT-REF: UI-0001, API-0001, DB-0001
+
 ## 背景
 
 - 例: 受注の登録ルールを明文化し、手戻りを減らすため
@@ -30,6 +32,11 @@
 - Priority は **P0/P1/P2/P3** のいずれかを必ず付与
 - BR 定義は **`## 業務ルール` セクション内のみ**（他セクションは参照扱い）
 
+### Contract 参照の書き方
+
+- `QFAI-CONTRACT-REF:` 行で契約IDを宣言する（複数行可）
+- 参照不要な場合は `QFAI-CONTRACT-REF: none`
+
 ## Delta（delta.md）
 
 - 互換維持 / 仕様変更の **どちらか1つ**に必ずチェックする
@@ -44,8 +51,8 @@
 
 ## CI でチェックされること（抜粋）
 
-- Spec: 必須セクション、SPEC/BR ID、BR Priority、ID 形式、Contract 参照の実在性
+- Spec: 必須セクション、SPEC/BR ID、BR Priority、ID 形式、Contract 参照の実在性、Contract 参照の必須宣言
 - Delta: 変更区分（互換/変更）のチェック状態
 - Scenario: Feature/Scenario の存在、タグ要件、Given/When/Then
-- Traceability: BR→SC、SC→契約（UI/API/DATA）、SC→Test の接続、BR の所属 SPEC 整合
+- Traceability: BR→SC、Spec→Contract、SC→Test の接続、BR の所属 SPEC 整合
 - IDs: 定義 ID の重複検知（Spec/Scenario/Contracts）

package/assets/init/.qfai/specs/spec-0001/scenario.md

@@ -3,7 +3,7 @@ Feature: 注文登録
 
 Rule: 承認者が存在する
 
-    @SC-0001 @BR-0001 @UI-0001 @API-0001 @DATA-0001
+    @SC-0001 @BR-0001 @UI-0001 @API-0001 @DB-0001
     Scenario: 承認者が承認するまで注文は確定しない
       Given ...
       When ...

package/assets/init/.qfai/specs/spec-0001/spec.md

@@ -1,5 +1,7 @@
 # SPEC-0001: 注文登録の最小仕様（サンプル）
 
+QFAI-CONTRACT-REF: API-0001, UI-0001, DB-0001
+
 > このテンプレは **最小例** です。実際の仕様に合わせて書き換えてください。
 
 ## 背景

package/assets/init/root/qfai.config.yaml

@@ -19,7 +19,6 @@ validation:
       - 業務ルール
   traceability:
     brMustHaveSc: true
-    scMustTouchContracts: true
     scMustHaveTest: true
     testFileGlobs:
       - tests/**/*.test.ts

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,8 @@
+export type InitOptions = {
+    dir: string;
+    force: boolean;
+    dryRun: boolean;
+    yes: boolean;
+};
+export declare function runInit(options: InitOptions): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBjE"}

package/dist/cli/commands/init.js

@@ -0,0 +1,30 @@
+import path from "node:path";
+import { copyTemplateTree } from "../lib/fs.js";
+import { getInitAssetsDir } from "../lib/assets.js";
+import { info } from "../lib/logger.js";
+export async function runInit(options) {
+    const assetsRoot = getInitAssetsDir();
+    const rootAssets = path.join(assetsRoot, "root");
+    const qfaiAssets = path.join(assetsRoot, ".qfai");
+    const destRoot = path.resolve(options.dir);
+    const destQfai = path.join(destRoot, ".qfai");
+    const rootResult = await copyTemplateTree(rootAssets, destRoot, {
+        force: options.force,
+        dryRun: options.dryRun,
+    });
+    const qfaiResult = await copyTemplateTree(qfaiAssets, destQfai, {
+        force: options.force,
+        dryRun: options.dryRun,
+    });
+    report([...rootResult.copied, ...qfaiResult.copied], [...rootResult.skipped, ...qfaiResult.skipped], options.dryRun, "init");
+}
+function report(copied, skipped, dryRun, label) {
+    info(`qfai ${label}: ${dryRun ? "dry-run" : "done"}`);
+    if (copied.length > 0) {
+        info(`  created: ${copied.length}`);
+    }
+    if (skipped.length > 0) {
+        info(`  skipped: ${skipped.length}`);
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AASxC,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAoB;IAChD,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAElD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE9C,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,UAAU,EAAE,QAAQ,EAAE;QAC9D,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,UAAU,EAAE,QAAQ,EAAE;QAC9D,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,MAAM,CACJ,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,EAC5C,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,EAC9C,OAAO,CAAC,MAAM,EACd,MAAM,CACP,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CACb,MAAgB,EAChB,OAAiB,EACjB,MAAe,EACf,KAAa;IAEb,IAAI,CAAC,QAAQ,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACtD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC,cAAc,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,IAAI,CAAC,cAAc,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/cli/commands/report.d.ts

@@ -0,0 +1,7 @@
+export type ReportOptions = {
+    root: string;
+    format: "md" | "json";
+    outPath?: string;
+};
+export declare function runReport(options: ReportOptions): Promise<void>;
+//# sourceMappingURL=report.d.ts.map

package/dist/cli/commands/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/report.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDrE"}

package/dist/cli/commands/report.js

@@ -0,0 +1,108 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { loadConfig, resolvePath } from "../../core/config.js";
+import { createReportData, formatReportJson, formatReportMarkdown, } from "../../core/report.js";
+import { error, info } from "../lib/logger.js";
+export async function runReport(options) {
+    const root = path.resolve(options.root);
+    const configResult = await loadConfig(root);
+    const input = configResult.config.output.validateJsonPath;
+    const inputPath = path.isAbsolute(input) ? input : path.resolve(root, input);
+    let validation;
+    try {
+        validation = await readValidationResult(inputPath);
+    }
+    catch (err) {
+        if (isMissingFileError(err)) {
+            error([
+                `qfai report: 入力ファイルが見つかりません: ${inputPath}`,
+                "",
+                "まず qfai validate を実行してください。例:",
+                "  qfai validate",
+                "（デフォルトの出力先: .qfai/out/validate.json）",
+                "",
+                "GitHub Actions テンプレを使っている場合は、workflow の validate ジョブを先に実行してください。",
+            ].join("\n"));
+            process.exitCode = 2;
+            return;
+        }
+        throw err;
+    }
+    const data = await createReportData(root, validation, configResult);
+    const output = options.format === "json"
+        ? formatReportJson(data)
+        : formatReportMarkdown(data);
+    const outRoot = resolvePath(root, configResult.config, "outDir");
+    const defaultOut = options.format === "json"
+        ? path.join(outRoot, "report.json")
+        : path.join(outRoot, "report.md");
+    const out = options.outPath ?? defaultOut;
+    const outPath = path.isAbsolute(out) ? out : path.resolve(root, out);
+    await mkdir(path.dirname(outPath), { recursive: true });
+    await writeFile(outPath, `${output}\n`, "utf-8");
+    info(`report: info=${validation.counts.info} warning=${validation.counts.warning} error=${validation.counts.error}`);
+    info(`wrote report: ${outPath}`);
+}
+async function readValidationResult(inputPath) {
+    const raw = await readFile(inputPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (!isValidationResult(parsed)) {
+        throw new Error(`validate.json の形式が不正です: ${inputPath}`);
+    }
+    return parsed;
+}
+function isValidationResult(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const record = value;
+    if (typeof record.toolVersion !== "string") {
+        return false;
+    }
+    if (!Array.isArray(record.issues)) {
+        return false;
+    }
+    const counts = record.counts;
+    if (!counts) {
+        return false;
+    }
+    if (typeof counts.info !== "number" ||
+        typeof counts.warning !== "number" ||
+        typeof counts.error !== "number") {
+        return false;
+    }
+    const traceability = record.traceability;
+    if (!traceability || typeof traceability !== "object") {
+        return false;
+    }
+    const sc = traceability.sc;
+    const testFiles = traceability.testFiles;
+    if (!sc || !testFiles) {
+        return false;
+    }
+    if (typeof sc.total !== "number" ||
+        typeof sc.covered !== "number" ||
+        typeof sc.missing !== "number") {
+        return false;
+    }
+    if (!Array.isArray(sc.missingIds)) {
+        return false;
+    }
+    if (!sc.refs || typeof sc.refs !== "object") {
+        return false;
+    }
+    if (!Array.isArray(testFiles.globs) ||
+        !Array.isArray(testFiles.excludeGlobs) ||
+        typeof testFiles.matchedFileCount !== "number") {
+        return false;
+    }
+    return true;
+}
+function isMissingFileError(error) {
+    if (!error || typeof error !== "object") {
+        return false;
+    }
+    const record = error;
+    return record.code === "ENOENT";
+}
+//# sourceMappingURL=report.js.map

package/dist/cli/commands/report.js.map

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

package/dist/cli/commands/validate.d.ts

@@ -0,0 +1,9 @@
+import type { FailOn, OutputFormat } from "../../core/config.js";
+export type ValidateOptions = {
+    root: string;
+    strict: boolean;
+    failOn?: FailOn;
+    format?: OutputFormat;
+};
+export declare function runValidate(options: ValidateOptions): Promise<number>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/cli/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAMjE,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB3E"}

package/dist/cli/commands/validate.js

@@ -0,0 +1,57 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { loadConfig } from "../../core/config.js";
+import { validateProject } from "../../core/validate.js";
+import { shouldFail } from "../lib/failOn.js";
+export async function runValidate(options) {
+    const root = path.resolve(options.root);
+    const configResult = await loadConfig(root);
+    const result = await validateProject(root, configResult);
+    const format = options.format ?? "text";
+    if (format === "text") {
+        emitText(result);
+    }
+    if (format === "github") {
+        result.issues.forEach(emitGitHub);
+    }
+    await emitJson(result, root, configResult.config.output.validateJsonPath);
+    const failOn = resolveFailOn(options, configResult.config.validation.failOn);
+    return shouldFail(result, failOn) ? 1 : 0;
+}
+function resolveFailOn(options, fallback) {
+    if (options.failOn) {
+        return options.failOn;
+    }
+    if (options.strict) {
+        return "warning";
+    }
+    return fallback;
+}
+function emitText(result) {
+    for (const item of result.issues) {
+        const location = item.file ? ` (${item.file})` : "";
+        const refs = item.refs && item.refs.length > 0 ? ` refs=${item.refs.join(",")}` : "";
+        process.stdout.write(`[${item.severity}] ${item.code} ${item.message}${location}${refs}\n`);
+    }
+    process.stdout.write(`counts: info=${result.counts.info} warning=${result.counts.warning} error=${result.counts.error}\n`);
+}
+function emitGitHub(issue) {
+    const level = issue.severity === "error"
+        ? "error"
+        : issue.severity === "warning"
+            ? "warning"
+            : "notice";
+    const file = issue.file ? `file=${issue.file}` : "";
+    const line = issue.loc?.line ? `,line=${issue.loc.line}` : "";
+    const column = issue.loc?.column ? `,col=${issue.loc.column}` : "";
+    const location = file ? ` ${file}${line}${column}` : "";
+    process.stdout.write(`::${level}${location}::${issue.code}: ${issue.message}\n`);
+}
+async function emitJson(result, root, jsonPath) {
+    const abs = path.isAbsolute(jsonPath)
+        ? jsonPath
+        : path.resolve(root, jsonPath);
+    await mkdir(path.dirname(abs), { recursive: true });
+    await writeFile(abs, `${JSON.stringify(result, null, 2)}\n`, "utf-8");
+}
+//# sourceMappingURL=validate.js.map

package/dist/cli/commands/validate.js.map

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