qfai 0.2.5

package/README.md

@@ -0,0 +1,28 @@
+# QFAI Toolkit (v0.2.5)
+
+Single-package distribution for QFAI.
+
+## Install
+
+```
+npm i -D qfai
+```
+
+## Quick Start
+
+```
+npx qfai init
+npx qfai validate --fail-on error --format github --json-path .qfai/out/validate.json
+npx qfai report --json-path .qfai/out/validate.json --out .qfai/out/report.md
+```
+
+## Usage
+
+`validate` は `--fail-on` / `--strict` によって CI ゲート化できます。
+JSON 出力は `--json-path` 指定、または `qfai.config.yaml` の `output.format: json` で有効化できます。
+`report` は `validate.json` が必須で、未生成の場合は exit code 2 で次の手順を案内します。
+`report` の入力は `--json-path` が優先で、未指定の場合は `output.jsonPath` を使います。どちらも未設定の場合はレポートを生成できないため、いずれかを必ず指定してください。既定の出力は `.qfai/out/report.md`（`--format json` の場合は `.qfai/out/report.json`）です。
+`init --yes` は非対話でデフォルトを採用します（現状の init は非対話が既定のため挙動は同じです。将来対話が導入されても自動で承認されます）。既存ファイルがある場合は `--force` が必要です。
+
+設定はリポジトリ直下の `qfai.config.yaml` で行います。
+命名規約は `docs/rules/naming.md` を参照してください。

package/assets/init/qfai/README.md

@@ -0,0 +1,6 @@
+# QFAI Project Kit
+
+This directory contains QFAI specs and contracts.
+
+- 設定ファイル: qfai.config.yaml（リポジトリ直下）
+- CI テンプレ: .github/workflows/qfai.yml

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

@@ -0,0 +1,14 @@
+openapi: 3.0.0
+info:
+  title: QFAI Sample API
+  version: 0.1.0
+paths:
+  /health:
+    get:
+      operationId: API-0001
+      x-qfai-refs:
+        - BR-0001
+        - SC-0001
+      responses:
+        "200":
+          description: OK

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

@@ -0,0 +1,5 @@
+-- DATA-0001
+CREATE TABLE sample_table (
+  id INTEGER PRIMARY KEY,
+  name VARCHAR(255) NOT NULL
+);

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

@@ -0,0 +1,4 @@
+id: UI-0001
+name: Sample Screen
+refs:
+  - BR-0001

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

@@ -0,0 +1,34 @@
+# makeBusinessFlow
+
+あなたは業務フロー（Business Flow: BF）を“推測せず”に整理するアシスタントです。
+Spec群を読み、Specに明示されている情報のみを根拠として、代表的な業務フロー候補と、ステップ→Specの対応表を作成してください。
+
+## Inputs
+
+- 対象: qfai/spec/spec.md と qfai/spec/spec-0001-\*.md 形式のファイル（4 桁の数字 + ハイフン + slug。実際のパターン: `spec-\d{4}-[^/\\]+\.md`。存在するもの全て）
+
+## Output (Option)
+
+- docs/flows/overview.md（BF一覧）
+- docs/flows/bf-0001-<slug>.md 等（個別BF）
+
+## Hard Rules
+
+- Specに書かれていない業務フローを“創作”しない。
+  - 根拠が薄い場合は候補として列挙し `TBD` を付ける。
+- BFの各ステップは必ず SPEC-ID に紐づける。
+- BR/SC/UI/API/DB の参照は Spec に書かれているもののみ。
+
+## BF Document Format (per BF)
+
+- BF-ID / Title
+- Scope（開始条件/終了条件）
+- Actors（登場人物）
+- Steps（番号付き）: step → SPEC-ID → 一行説明
+- Related BR / SC
+- Open Questions（TBD列挙）
+
+## Safety
+
+- 既存ファイルがある場合は、`<!-- qfai:generated:start -->` と `<!-- qfai:generated:end -->` の範囲だけ更新。
+- それ以外の手書き領域は絶対に変更しない。

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

@@ -0,0 +1,27 @@
+# makeOverview
+
+あなたはドキュメント生成アシスタントです。リポジトリ内の Spec を走査し、Spec一覧（overview）を生成してください。
+
+## Inputs
+
+- 対象: qfai/spec/spec.md と qfai/spec/spec-0001-\*.md 形式のファイル（4 桁の数字 + ハイフン + slug。実際のパターン: `spec-\d{4}-[^/\\]+\.md`。存在するもの全て）
+
+## Output
+
+- docs/specs/overview.md を更新
+- 更新は必ず次の範囲のみ:
+  - <!-- qfai:generated:start -->
+  - <!-- qfai:generated:end -->
+
+## Rules
+
+- Spec本文に書かれていないことは推測しない（不明は `TBD` と書く）。
+- SpecのIDとタイトルは、本文先頭の `# SPEC-xxxx ...` を正とし、ファイル名は補助。
+- 各Specについて最低限以下を表にする:
+  - SPEC-ID / Title / Outcome(1行) / Status / SC / UI / API / DB(or DATA) / Tags
+- 参照が欠けている場合（例: SCが未記載）は “欠落一覧” に列挙する。
+
+## Format
+
+- Markdown table
+- 生成日時（JST）と、参照したSpecファイル一覧を末尾に付記する。

package/assets/init/qfai/spec/decisions/ADR-0001.md

@@ -0,0 +1,7 @@
+# ADR-0001: Sample Decision
+
+- Status: Proposed
+- Context:
+- Decision:
+- Consequences:
+- Related: BR-0001, SPEC-0001

package/assets/init/qfai/spec/scenarios.feature

@@ -0,0 +1,6 @@
+@SC-0001 @BR-0001 @SPEC-0001 @UI-0001 @API-0001 @DATA-0001
+Feature: Sample flow
+  Scenario: Basic scenario
+    Given ...
+    When ...
+    Then ...

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

@@ -0,0 +1,29 @@
+# SPEC-0001: Sample Spec
+
+## 背景
+
+- ...
+
+## スコープ
+
+- ...
+
+## 非ゴール
+
+- ...
+
+## 用語
+
+- ...
+
+## 前提
+
+- ...
+
+## 決定事項
+
+- ...
+
+## 業務ルール
+
+- [BR-0001] ...

package/assets/init/root/.github/workflows/qfai.yml

@@ -0,0 +1,22 @@
+name: qfai
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm ci
+      - run: npx qfai validate --fail-on error --format github --json-path .qfai/out/validate.json
+      - uses: actions/upload-artifact@v4
+        with:
+          name: qfai-validation
+          path: .qfai/out/validate.json

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

@@ -0,0 +1,29 @@
+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

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,MAAM,CAAC,CAAC;IAEjD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE7C,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,8 @@
+export type ReportOptions = {
+    root: string;
+    format: "md" | "json";
+    jsonPath?: string;
+    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":"AAeA,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CrE"}

package/dist/cli/commands/report.js

@@ -0,0 +1,83 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { loadConfig } from "../../core/config.js";
+import { createReportData, formatReportJson, formatReportMarkdown, } from "../../core/report.js";
+import { VALIDATION_SCHEMA_VERSION, } from "../../core/types.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 = options.jsonPath ?? configResult.config.output.jsonPath;
+    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}`,
+                "",
+                "まず validate.json を生成してください。例:",
+                `  qfai validate --json-path ${input}`,
+                "",
+                "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 defaultOut = options.format === "json" ? ".qfai/out/report.json" : ".qfai/out/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}`);
+    }
+    if (parsed.schemaVersion !== VALIDATION_SCHEMA_VERSION) {
+        throw new Error(`validate.json の schemaVersion が不一致です: expected ${VALIDATION_SCHEMA_VERSION}, actual ${parsed.schemaVersion}`);
+    }
+    return parsed;
+}
+function isValidationResult(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const record = value;
+    if (typeof record.schemaVersion !== "string") {
+        return false;
+    }
+    if (typeof record.toolVersion !== "string") {
+        return false;
+    }
+    if (!Array.isArray(record.issues)) {
+        return false;
+    }
+    const counts = record.counts;
+    if (!counts) {
+        return false;
+    }
+    return (typeof counts.info === "number" &&
+        typeof counts.warning === "number" &&
+        typeof counts.error === "number");
+}
+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,10 @@
+import type { FailOn, OutputFormat } from "../../core/config.js";
+export type ValidateOptions = {
+    root: string;
+    strict: boolean;
+    failOn?: FailOn;
+    format?: OutputFormat;
+    jsonPath?: string;
+};
+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;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA0B3E"}

package/dist/cli/commands/validate.js

@@ -0,0 +1,66 @@
+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 ?? configResult.config.output.format;
+    const explicitJsonPath = options.jsonPath;
+    if (format === "text") {
+        emitText(result);
+    }
+    if (format === "github") {
+        result.issues.forEach(emitGitHub);
+    }
+    const shouldWriteJson = format === "json" || explicitJsonPath !== undefined;
+    if (shouldWriteJson) {
+        const jsonPath = format === "json"
+            ? (options.jsonPath ?? configResult.config.output.jsonPath)
+            : explicitJsonPath;
+        if (jsonPath) {
+            await emitJson(result, root, jsonPath);
+        }
+    }
+    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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"}