qfai 0.3.2 → 0.3.3

package/README.md

@@ -1,4 +1,4 @@
-# QFAI Toolkit (v0.3.2)
+# QFAI Toolkit (v0.3.3)
 
 Single-package distribution for QFAI.
 
@@ -16,6 +16,12 @@ npx qfai validate --fail-on error --format github
 npx qfai report
 ```
 
+## できること
+
+- `npx qfai init` によるテンプレート生成（specs/contracts に加え、`require/README.md`、`.qfai/rules/pnpm.md`、`.qfai/prompts/require-to-spec.md` を含む）
+- `npx qfai validate` による `.qfai/` 内ドキュメントの整合性・トレーサビリティ検査
+- `npx qfai report` によるレポート出力
+
 ## Usage
 
 `validate` は `--fail-on` / `--strict` によって CI ゲート化できます。`validate` は常に `.qfai/out/validate.json`（`output.validateJsonPath`）へ JSON を出力し、`--format` は表示形式（text/github）のみを制御します。

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

@@ -22,7 +22,9 @@ npx qfai report
 - `specs/README.md`
 - `contracts/README.md`
 - `rules/conventions.md`
+- `rules/pnpm.md`
 - `prompts/README.md`
+- `prompts/require-to-spec.md`
 - `out/README.md`
 
 ## 設定と CI

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

@@ -7,6 +7,12 @@
 - Spec から overview / Business Flow を生成するための素材
 - 将来（v0.9）の adapter/emit 実装に備えた配布物
 
+## プロンプト一覧
+
+- `makeOverview.md`: Spec 一覧（overview）生成
+- `makeBusinessFlow.md`: 業務フロー（BF）整理
+- `require-to-spec.md`: 既存要件から Spec Pack を起こす
+
 ## 使い方（例）
 
 1. 目的のプロンプトを開く（例: `makeOverview.md`）

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

@@ -0,0 +1,39 @@
+# require-to-spec
+
+あなたは仕様書作成アシスタントです。`require/` 配下の既存要件を読み取り、QFAI の Spec Pack を作成してください。
+
+## Inputs
+
+- `require/` 配下の要件定義書・リンク・原本（読み取れる範囲で）
+- 追加資料がある場合は、それも参照して良い
+
+## Output
+
+- `.qfai/specs/spec-0001/spec.md`
+- `.qfai/specs/spec-0001/delta.md`
+- `.qfai/specs/spec-0001/scenario.md`
+- 必要に応じて `.qfai/contracts/{ui,api,db}` 配下
+
+> Spec は `spec-0001` から開始し、必要なら連番で増やすこと。
+
+## Rules
+
+- **推測しない**。要件に書かれていないことは `TBD` と明記する。
+- ID は `PREFIX-0001` 形式（SPEC/BR/SC/UI/API/DATA）。
+- `spec.md` の必須セクションは `qfai.config.yaml` の設定に従う。
+- BR は `## 業務ルール` にのみ定義し、`- [BR-0001][P1] ...` 形式で書く。
+- `scenario.md` は Gherkin で書き、Feature に `@SPEC-xxxx` を付与する。
+- 各 Scenario は `@SC-xxxx` を **ちょうど1つ**、`@BR-xxxx` を **1つ以上**持つこと。
+- 契約 ID（UI/API/DATA）が必要なら、タグまたは本文に明示する。
+- `delta.md` の「変更区分」は **Compatibility / Change/Improvement のいずれか1つにチェック**する。
+  - 判断できない場合は `Compatibility` を選び、`TBD` を理由欄に記載する。
+
+## Output Format
+
+- すべて Markdown
+- 余計な説明文は出力しない（ファイル内容のみ）
+
+## 参照ルール（重要）
+
+- `.qfai/specs` や `contracts` は **require を参照してよい**。
+- `require/` 側から `.qfai/specs` や `contracts` を参照するのは **禁止**。

package/assets/init/.qfai/rules/pnpm.md

@@ -0,0 +1,29 @@
+# pnpm lifecycle script 許可リスト（allowlist）運用ガイド
+
+## 目的
+
+pnpm 環境で表示される `Ignored build scripts: ...` に対し、依存パッケージのビルドスクリプトを
+**安全に許可するための運用手順**を提示します。これは QFAI の validate 対象外です。
+
+## 典型的な事象
+
+- `Ignored build scripts: esbuild` などの警告が表示される
+
+## 影響例
+
+- ビルド成果物が生成されず、実行時エラーや動作不整合が起きる
+- ローカルは動くが CI で失敗するなど、環境差分が発生する
+
+## 最小運用フロー（例）
+
+1. 警告に出た依存を特定する（lockfile/依存ツリーで確認）
+2. 依存の出所・信頼性を確認する（公式パッケージ/署名/公開元など）
+3. チームで許可判断を行う（承認者・記録方法を決める）
+4. pnpm の設定（例: `onlyBuiltDependencies` など）を更新し、許可対象を管理する
+5. 変更内容を記録し、再現可能性を担保する（README/CHANGELOG など）
+
+## 注意
+
+- pnpm のバージョンや設定により手順が変わる場合があります。
+- 実際のコマンドやオプションは **pnpm の公式ドキュメント**を参照してください。
+- allowlist の判断は各プロジェクトのセキュリティ方針に従ってください。

package/assets/init/root/require/README.md

@@ -0,0 +1,28 @@
+# require/
+
+既存の要件定義書や外部資料を集約するためのディレクトリです。
+QFAI は `require/` を **入力（上流）** として扱い、ここに置かれた内容を根拠に Spec を作成します。
+
+## 置き方（例）
+
+- `require/req-0001-<slug>.md`
+- `require/links.md`（外部ドキュメントへのリンク集）
+- `require/raw/`（PDFや画像などの原本）
+
+> 形式は限定しません。内容が参照可能であることを優先してください。
+
+## 参照ルール（重要）
+
+- `require/` は **上流のSSOT** です。
+- `.qfai/specs` や `contracts` は **require を参照してよい**。
+- `require/` 側から `.qfai/specs` や `contracts` を参照するのは **禁止**（循環参照防止）。
+
+## AI プロンプトの利用
+
+- `.qfai/prompts/require-to-spec.md` を使用し、要件から Spec を作成します。
+- 生成後は必ず人間がレビューし、Spec/Scenario/Contracts の整合を確認してください。
+
+## 注意
+
+- `require/` の内容は QFAI の validate 対象外です。
+- 機密情報の取り扱いは各プロジェクトのルールに従ってください。

package/dist/cli/index.cjs

@@ -109,12 +109,29 @@ async function exists(target) {
 }
 
 // src/cli/lib/assets.ts
+var import_node_fs = require("fs");
 var import_node_path2 = __toESM(require("path"), 1);
 var import_node_url = require("url");
 function getInitAssetsDir() {
   const base = __filename;
   const basePath = base.startsWith("file:") ? (0, import_node_url.fileURLToPath)(base) : base;
-  return import_node_path2.default.resolve(import_node_path2.default.dirname(basePath), "../../assets/init");
+  const baseDir = import_node_path2.default.dirname(basePath);
+  const candidates = [
+    import_node_path2.default.resolve(baseDir, "../../../assets/init"),
+    import_node_path2.default.resolve(baseDir, "../../assets/init")
+  ];
+  for (const candidate of candidates) {
+    if ((0, import_node_fs.existsSync)(candidate)) {
+      return candidate;
+    }
+  }
+  throw new Error(
+    [
+      "init \u7528\u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002Template assets not found.",
+      "\u78BA\u8A8D\u3057\u305F\u30D1\u30B9 / Checked paths:",
+      ...candidates.map((candidate) => `- ${candidate}`)
+    ].join("\n")
+  );
 }
 
 // src/cli/lib/logger.ts
@@ -699,8 +716,8 @@ var import_promises6 = require("fs/promises");
 var import_node_path7 = __toESM(require("path"), 1);
 var import_node_url2 = require("url");
 async function resolveToolVersion() {
-  if ("0.3.2".length > 0) {
-    return "0.3.2";
+  if ("0.3.3".length > 0) {
+    return "0.3.3";
   }
   try {
     const packagePath = resolvePackageJsonPath();