sdd-forge 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Spread Works Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# {{PROJECT_NAME}}
+
+{{PROJECT_DESCRIPTION}}
+
+## 技術スタック
+
+| カテゴリ | 技術 |
+|----------|------|
+| 言語 | Node.js (ES Modules) |
+| 配布 | npm |
+| テスト | — |
+
+## クイックスタート
+
+```bash
+npm install -g {{PACKAGE_NAME}}
+{{PACKAGE_NAME}} help
+```
+
+## ドキュメント
+
+| 章 | 概要 |
+|----|------|
+| [01. ツール概要とアーキテクチャ](docs/01_overview.md) | `sdd-forge` は、PHP-MVC プロジェクト（CakePHP 等）における「仕様と実装の乖離」および「技術ドキュメントの作成・維持コスト」という課題を解決するための Node.js CLI ツールである。ソースコード静的解析（`scan`）・テンプレート駆動のドキュメント生成（`init` / `populate` / `tfill`）・仕様ゲート管理（`spec` / `gate`）・反復改善ループ（`forge`）を単一パッケージに統合し、Spec-Driven Development（SDD）ワークフローをコマンドラインから一貫して実行できる。 |
+| [02. CLI コマンドリファレンス](docs/02_cli_commands.md) | `SCRIPTS` オブジェクトから `scan:all` を含めると 19 コマンド（エントリは 18 だが `scan:all` は別処理）が確認できます。正確な数を数えます。 |
+| [03. 設定とカスタマイズ](docs/03_configuration.md) | sdd-forge の動作は `.sdd-forge/config.json` を中心とした複数の JSON 設定ファイルによって制御され、言語・テンプレートタイプ・AIプロバイダー・タイムアウト・テキスト生成挙動など幅広い項目をカスタマイズできる。プロジェクトごとのテンプレート差し替えは `project-overrides.json`、解析結果の表現上書きは `overrides.json` で行い、関心ごとに設定を分離できる構成になっている。 |
+| [04. 内部設計](docs/04_internal_design.md) | `src/bin/sdd-forge.js` がサブコマンドを各モジュール（`analyzers/`・`engine/`・`spec/`・`forge/`・`flow/`）へディスパッチし、共通ユーティリティ `lib/` を底辺として解析→生成→改善の方向で一方向に依存が流れる設計になっている。PHPソースを `analyzers/` が `analysis.json` へ変換し、`engine/populate` と `engine/tfill` がそのデータをテンプレートと組み合わせて `docs/` へ展開するパイプラインが中心的な処理フローである。 |
+| [05. 開発・テスト・配布](docs/05_development.md) | `npm link` を使ったビルド不要のローカル開発環境、外部依存ゼロの Node.js 実装、および `npm version` と `npm publish` による npm レジストリへのリリースフローを中心に構成された章である。テストフレームワークは現時点では導入されておらず、動作確認はコマンド直接実行による手動テストで行う。 |
+
+## 開発ワークフロー（SDD）
+
+本プロジェクトは Spec-Driven Development（SDD）を採用しています。
+
+```
+1. sdd-forge spec --title "..."   — 仕様ファイル作成
+2. sdd-forge gate --spec ...      — 仕様ゲート（未解決事項がなければ PASS）
+3. 実装
+4. sdd-forge forge --prompt "..."  — ドキュメント自動更新
+5. sdd-forge review               — ドキュメントレビュー
+```
+
+詳細は [CLAUDE.md](CLAUDE.md) の「SDDフロー」セクションを参照してください。
+
+<!-- MANUAL:START -->
+<!-- MANUAL:END -->

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "sdd-forge",
+  "version": "0.1.0-alpha.1",
+  "description": "Spec-Driven Development tooling for PHP-MVC documentation generation",
+  "type": "module",
+  "bin": {
+    "sdd-forge": "./src/bin/sdd-forge.js"
+  },
+  "files": [
+    "src/"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "sdd",
+    "documentation",
+    "php",
+    "cakephp",
+    "spec-driven-development"
+  ],
+  "license": "MIT"
+}

package/src/analyzers/analyze-controllers.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * tools/analyzers/analyze-controllers.js
+ *
+ * app/Controller/*Controller.php を走査し、
+ * クラス名・components・uses・アクション一覧を抽出する。
+ */
+
+import fs from "fs";
+import path from "path";
+import {
+  stripBlockComments,
+  extractArrayBody,
+  extractQuotedStrings,
+} from "./lib/php-array-parser.js";
+
+const LIFECYCLE_METHODS = new Set([
+  "beforeFilter",
+  "afterFilter",
+  "beforeRender",
+  "beforeRedirect",
+  "constructClasses",
+  "initialize",
+  "startup",
+  "shutdownProcess",
+]);
+
+export function analyzeControllers(appDir) {
+  const controllerDir = path.join(appDir, "Controller");
+  if (!fs.existsSync(controllerDir)) return { controllers: [], summary: {} };
+
+  const files = fs
+    .readdirSync(controllerDir)
+    .filter((f) => f.endsWith("Controller.php") && f !== "AppController.php");
+
+  const controllers = [];
+  for (const file of files) {
+    const filePath = path.join(controllerDir, file);
+    const raw = fs.readFileSync(filePath, "utf8");
+    const src = stripBlockComments(raw);
+
+    const classMatch = src.match(/class\s+(\w+)\s+extends\s+(\w+)/);
+    if (!classMatch) continue;
+
+    const className = classMatch[1];
+    const parentClass = classMatch[2];
+
+    const componentsBody = extractArrayBody(src, "components");
+    const components = componentsBody
+      ? extractQuotedStrings(componentsBody)
+      : [];
+
+    const usesBody = extractArrayBody(src, "uses");
+    const uses = usesBody ? extractQuotedStrings(usesBody) : [];
+
+    const actions = [];
+    const fnRe = /public\s+function\s+(\w+)\s*\(/g;
+    let fm;
+    while ((fm = fnRe.exec(src)) !== null) {
+      const name = fm[1];
+      if (!LIFECYCLE_METHODS.has(name) && !name.startsWith("_")) {
+        actions.push(name);
+      }
+    }
+
+    controllers.push({
+      file: path.relative(path.resolve(appDir, ".."), filePath),
+      className,
+      parentClass,
+      components,
+      uses,
+      actions,
+    });
+  }
+
+  controllers.sort((a, b) => a.className.localeCompare(b.className));
+
+  return {
+    controllers,
+    summary: {
+      total: controllers.length,
+      totalActions: controllers.reduce((s, c) => s + c.actions.length, 0),
+    },
+  };
+}