sdd-forge 0.1.0-alpha.1

package/src/analyzers/analyze-models.js

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+/**
+ * tools/analyzers/analyze-models.js
+ *
+ * app/Model/*.php + app/Model/Logic/*.php を走査し、
+ * テーブル名・DB設定・リレーション・バリデーション等を抽出する。
+ */
+
+import fs from "fs";
+import path from "path";
+import {
+  stripBlockComments,
+  extractArrayBody,
+  extractTopLevelKeys,
+  extractQuotedStrings,
+  camelToSnake,
+  pluralize,
+} from "./lib/php-array-parser.js";
+
+const RELATION_TYPES = [
+  "belongsTo",
+  "hasMany",
+  "hasOne",
+  "hasAndBelongsToMany",
+];
+
+function extractStringProperty(src, propertyName) {
+  const escaped = propertyName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const re = new RegExp(
+    `(?:var|public|protected|private)\\s+\\$${escaped}\\s*=\\s*['"]([^'"]+)['"]`,
+  );
+  const m = re.exec(src);
+  return m ? m[1] : null;
+}
+
+function inferTableName(className) {
+  const snake = camelToSnake(className);
+  return pluralize(snake);
+}
+
+export function analyzeModels(appDir) {
+  const dirs = [
+    { dir: path.join(appDir, "Model"), isLogic: false },
+    { dir: path.join(appDir, "Model", "Logic"), isLogic: true },
+  ];
+
+  const models = [];
+
+  for (const { dir, isLogic } of dirs) {
+    if (!fs.existsSync(dir)) continue;
+
+    const files = fs
+      .readdirSync(dir)
+      .filter((f) => f.endsWith(".php") && f !== "AppModel.php");
+
+    for (const file of files) {
+      const filePath = path.join(dir, file);
+      const stat = fs.statSync(filePath);
+      if (!stat.isFile()) continue;
+
+      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 useTable = extractStringProperty(src, "useTable");
+      const useDbConfig = extractStringProperty(src, "useDbConfig");
+      const primaryKey = extractStringProperty(src, "primaryKey");
+      const displayField = extractStringProperty(src, "displayField");
+
+      const relations = {};
+      for (const relType of RELATION_TYPES) {
+        const body = extractArrayBody(src, relType);
+        if (body) {
+          relations[relType] = extractTopLevelKeys(body);
+        }
+      }
+
+      const validateBody = extractArrayBody(src, "validate");
+      const validateFields = validateBody
+        ? extractTopLevelKeys(validateBody)
+        : [];
+
+      const actsAsBody = extractArrayBody(src, "actsAs");
+      const actsAs = actsAsBody ? extractQuotedStrings(actsAsBody) : [];
+
+      const tableName = useTable || inferTableName(className);
+      const isFe = className.startsWith("Fe");
+
+      models.push({
+        file: path.relative(path.resolve(appDir, ".."), filePath),
+        className,
+        parentClass,
+        isLogic,
+        isFe,
+        useTable: useTable || null,
+        useDbConfig: useDbConfig || null,
+        primaryKey: primaryKey || null,
+        displayField: displayField || null,
+        tableName,
+        relations,
+        validateFields,
+        actsAs,
+      });
+    }
+  }
+
+  models.sort((a, b) => a.className.localeCompare(b.className));
+
+  const dbGroups = {};
+  for (const m of models) {
+    const db = m.useDbConfig || "default";
+    if (!dbGroups[db]) dbGroups[db] = [];
+    dbGroups[db].push(m.className);
+  }
+
+  return {
+    models,
+    summary: {
+      total: models.length,
+      feModels: models.filter((m) => m.isFe).length,
+      logicModels: models.filter((m) => m.isLogic).length,
+      dbGroups,
+    },
+  };
+}

package/src/analyzers/analyze-routes.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * tools/analyzers/analyze-routes.js
+ *
+ * app/Config/routes.php を読み込み、
+ * Router::connect() パターンを抽出する。
+ */
+
+import fs from "fs";
+import path from "path";
+import { stripBlockComments } from "./lib/php-array-parser.js";
+
+export function analyzeRoutes(appDir) {
+  const routesPath = path.join(appDir, "Config", "routes.php");
+  if (!fs.existsSync(routesPath)) return { routes: [], summary: {} };
+
+  const raw = fs.readFileSync(routesPath, "utf8");
+  const src = stripBlockComments(raw);
+
+  const routes = [];
+  const re =
+    /Router::connect\s*\(\s*['"]([^'"]*)['"]\s*,\s*array\s*\(([^)]*)\)/g;
+  let m;
+  while ((m = re.exec(src)) !== null) {
+    const pattern = m[1];
+    const paramsStr = m[2];
+
+    const controllerMatch = paramsStr.match(
+      /['"]controller['"]\s*=>\s*['"](\w+)['"]/,
+    );
+    const actionMatch = paramsStr.match(
+      /['"]action['"]\s*=>\s*['"](\w+)['"]/,
+    );
+
+    routes.push({
+      pattern,
+      controller: controllerMatch ? controllerMatch[1] : null,
+      action: actionMatch ? actionMatch[1] : null,
+      raw: `Router::connect('${pattern}', array(${paramsStr.trim()}))`,
+    });
+  }
+
+  return {
+    routes,
+    summary: {
+      total: routes.length,
+      controllers: [...new Set(routes.map((r) => r.controller).filter(Boolean))],
+    },
+  };
+}

package/src/analyzers/analyze-shells.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+/**
+ * tools/analyzers/analyze-shells.js
+ *
+ * app/Console/Command/*Shell.php を走査し、
+ * クラス名・公開メソッド・main 有無・App::uses を抽出する。
+ */
+
+import fs from "fs";
+import path from "path";
+import { stripBlockComments } from "./lib/php-array-parser.js";
+
+const LIFECYCLE_METHODS = new Set([
+  "startup",
+  "initialize",
+  "getOptionParser",
+]);
+
+export function analyzeShells(appDir) {
+  const shellDir = path.join(appDir, "Console", "Command");
+  if (!fs.existsSync(shellDir)) return { shells: [], summary: {} };
+
+  const files = fs
+    .readdirSync(shellDir)
+    .filter((f) => f.endsWith("Shell.php") && f !== "AppShell.php");
+
+  const shells = [];
+  for (const file of files) {
+    const filePath = path.join(shellDir, 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 publicMethods = [];
+    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("_")) {
+        publicMethods.push(name);
+      }
+    }
+
+    const hasMain = publicMethods.includes("main");
+
+    const appUses = [];
+    const usesRe = /App::uses\s*\(\s*['"](\w+)['"]\s*,\s*['"]([\w/]+)['"]\s*\)/g;
+    let um;
+    while ((um = usesRe.exec(raw)) !== null) {
+      appUses.push({ class: um[1], package: um[2] });
+    }
+
+    shells.push({
+      file: path.relative(path.resolve(appDir, ".."), filePath),
+      className,
+      publicMethods,
+      hasMain,
+      appUses,
+    });
+  }
+
+  shells.sort((a, b) => a.className.localeCompare(b.className));
+
+  return {
+    shells,
+    summary: {
+      total: shells.length,
+      withMain: shells.filter((s) => s.hasMain).length,
+    },
+  };
+}

package/src/analyzers/lib/php-array-parser.js

@@ -0,0 +1,138 @@
+/**
+ * tools/analyzers/lib/php-array-parser.js
+ *
+ * PHP ソースコード解析ユーティリティ。
+ * CakePHP 2.x の array() 構文からプロパティ・キー・値を抽出する。
+ */
+
+/**
+ * ブロックコメント (/* ... *​/) を除去する。
+ * 行コメント (// ...) は除去しない。
+ */
+export function stripBlockComments(text) {
+  return text.replace(/\/\*[\s\S]*?\*\//g, "");
+}
+
+/**
+ * `$property = array(...)` の中身を括弧バランスで抽出する。
+ * `var`, `public`, `protected`, `private` 修飾子に対応。
+ * 見つからない場合は空文字を返す。
+ */
+export function extractArrayBody(fileContent, propertyName) {
+  const escaped = propertyName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const re = new RegExp(
+    `(?:var|public|protected|private)\\s+\\$${escaped}\\s*=\\s*array\\s*\\(`,
+    "m",
+  );
+  const m = re.exec(fileContent);
+  if (!m) return "";
+
+  const startIdx = m.index + m[0].length;
+  let depth = 1;
+  let i = startIdx;
+  while (i < fileContent.length && depth > 0) {
+    const ch = fileContent[i];
+    if (ch === "(") depth += 1;
+    else if (ch === ")") depth -= 1;
+    i += 1;
+  }
+  if (depth !== 0) return "";
+  return fileContent.slice(startIdx, i - 1);
+}
+
+/**
+ * 連想配列の第一階層キーを抽出する。
+ * `'Key' => array(...)` パターンから Key 部分を返す。
+ */
+export function extractTopLevelKeys(arrayBody) {
+  const keys = [];
+  const re = /['"](\w+)['"]\s*=>/g;
+  let depth = 0;
+  let lastIdx = 0;
+
+  for (let i = 0; i < arrayBody.length; i += 1) {
+    const ch = arrayBody[i];
+    if (ch === "(" || ch === "[") {
+      depth += 1;
+    } else if (ch === ")" || ch === "]") {
+      depth -= 1;
+    }
+
+    if (depth === 0) {
+      const segment = arrayBody.slice(lastIdx, i + 1);
+      re.lastIndex = 0;
+      const m = re.exec(segment);
+      if (m) {
+        keys.push(m[1]);
+      }
+      if (ch === ",") {
+        lastIdx = i + 1;
+      }
+    }
+  }
+
+  if (lastIdx < arrayBody.length) {
+    const segment = arrayBody.slice(lastIdx);
+    re.lastIndex = 0;
+    const m = re.exec(segment);
+    if (m) {
+      keys.push(m[1]);
+    }
+  }
+
+  return [...new Set(keys)];
+}
+
+/**
+ * 配列内の文字列値を全抽出する。
+ * `$uses = array('Content', 'Title')` → ['Content', 'Title']
+ */
+export function extractQuotedStrings(arrayBody) {
+  const strings = [];
+  const re = /['"]([A-Za-z0-9_\/.]+)['"]/g;
+  let m;
+  while ((m = re.exec(arrayBody)) !== null) {
+    strings.push(m[1]);
+  }
+  return strings;
+}
+
+/**
+ * CamelCase → snake_case 変換。
+ */
+export function camelToSnake(name) {
+  return name
+    .replace(/([A-Z])/g, (_, ch, idx) =>
+      idx === 0 ? ch.toLowerCase() : `_${ch.toLowerCase()}`,
+    )
+    .replace(/__+/g, "_");
+}
+
+/**
+ * 簡易英語複数形変換。CakePHP 2.x 規約準拠。
+ */
+export function pluralize(word) {
+  if (!word) return word;
+  const lower = word.toLowerCase();
+
+  const irregulars = {
+    person: "people",
+    man: "men",
+    child: "children",
+    sex: "sexes",
+    move: "moves",
+    goose: "geese",
+    mouse: "mice",
+  };
+  if (irregulars[lower]) {
+    return word[0] === word[0].toUpperCase()
+      ? irregulars[lower][0].toUpperCase() + irregulars[lower].slice(1)
+      : irregulars[lower];
+  }
+
+  if (/(?:s|x|z|ch|sh)$/i.test(word)) return `${word}es`;
+  if (/[^aeiou]y$/i.test(word)) return word.slice(0, -1) + "ies";
+  if (/f$/i.test(word)) return word.slice(0, -1) + "ves";
+  if (/fe$/i.test(word)) return word.slice(0, -2) + "ves";
+  return `${word}s`;
+}

package/src/analyzers/scan.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+/**
+ * sdd-forge/analyzers/scan.js
+ *
+ * 全解析器を実行し、結合結果を .sdd-forge/output/analysis.json へ出力する。
+ * オプション: --only controllers|models|shells|routes, --stdout
+ */
+
+import fs from "fs";
+import path from "path";
+import { analyzeControllers } from "./analyze-controllers.js";
+import { analyzeModels } from "./analyze-models.js";
+import { analyzeShells } from "./analyze-shells.js";
+import { analyzeRoutes } from "./analyze-routes.js";
+import { analyzeExtras } from "./analyze-extras.js";
+import { repoRoot, sourceRoot, parseArgs } from "../lib/cli.js";
+
+function printHelp() {
+  console.log(
+    [
+      "Usage: node sdd-forge/analyzers/scan.js [options]",
+      "",
+      "Options:",
+      "  --only <type>   controllers|models|shells|routes|extras のいずれか",
+      "  --stdout        結果を stdout に出力（ファイル書き込みしない）",
+      "  -h, --help      このヘルプを表示",
+    ].join("\n"),
+  );
+}
+
+const VALID_ONLY = new Set(["controllers", "models", "shells", "routes", "extras"]);
+
+function main() {
+  const cli = parseArgs(process.argv.slice(2), {
+    flags: ["--stdout"],
+    options: ["--only"],
+    defaults: { only: "", stdout: false },
+  });
+  if (cli.help) {
+    printHelp();
+    return;
+  }
+
+  if (cli.only && !VALID_ONLY.has(cli.only)) {
+    throw new Error(
+      `--only must be one of: ${[...VALID_ONLY].join(", ")}`,
+    );
+  }
+
+  const root   = repoRoot(import.meta.url);
+  const appDir = path.join(sourceRoot(), "app");
+
+  if (!fs.existsSync(appDir)) {
+    throw new Error(`app/ directory not found: ${appDir}`);
+  }
+
+  const result = { analyzedAt: new Date().toISOString() };
+  const run = !cli.only;
+
+  if (run || cli.only === "controllers") {
+    console.error("[analyze] controllers ...");
+    result.controllers = analyzeControllers(appDir);
+    console.error(
+      `[analyze] controllers: ${result.controllers.summary.total} files, ${result.controllers.summary.totalActions} actions`,
+    );
+  }
+
+  if (run || cli.only === "models") {
+    console.error("[analyze] models ...");
+    result.models = analyzeModels(appDir);
+    console.error(
+      `[analyze] models: ${result.models.summary.total} files (fe=${result.models.summary.feModels}, logic=${result.models.summary.logicModels})`,
+    );
+  }
+
+  if (run || cli.only === "shells") {
+    console.error("[analyze] shells ...");
+    result.shells = analyzeShells(appDir);
+    console.error(
+      `[analyze] shells: ${result.shells.summary.total} files`,
+    );
+  }
+
+  if (run || cli.only === "routes") {
+    console.error("[analyze] routes ...");
+    result.routes = analyzeRoutes(appDir);
+    console.error(
+      `[analyze] routes: ${result.routes.summary.total} routes`,
+    );
+  }
+
+  if (run || cli.only === "extras") {
+    console.error("[analyze] extras ...");
+    result.extras = analyzeExtras(appDir);
+    const extrasKeys = Object.keys(result.extras);
+    console.error(
+      `[analyze] extras: ${extrasKeys.length} categories (${extrasKeys.join(", ")})`,
+    );
+  }
+
+  const json = JSON.stringify(result, null, 2);
+
+  if (cli.stdout) {
+    process.stdout.write(json + "\n");
+  } else {
+    const outputDir = path.join(root, ".sdd-forge", "output");
+    if (!fs.existsSync(outputDir)) {
+      fs.mkdirSync(outputDir, { recursive: true });
+    }
+    const outputPath = path.join(outputDir, "analysis.json");
+    fs.writeFileSync(outputPath, json + "\n");
+    console.error(`[analyze] output: ${path.relative(root, outputPath)}`);
+  }
+}
+
+main();

package/src/bin/sdd-forge.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+/**
+ * bin/sdd-forge.js
+ *
+ * sdd-forge のメイン CLI エントリポイント。
+ * サブコマンドを対応スクリプトへ振り分ける。
+ *
+ * Usage:
+ *   sdd-forge <subcommand> [options]
+ *   sdd-forge --project <name> <subcommand> [options]
+ *   sdd-forge help
+ */
+
+import { fileURLToPath } from "url";
+import path from "path";
+
+const PKG_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+
+/** サブコマンド → スクリプト相対パス */
+const SCRIPTS = {
+  help:          "help.js",
+  add:           "projects/add.js",
+  default:       "projects/setdefault.js",
+  scan:          "analyzers/scan.js",
+  "scan:ctrl":   "analyzers/scan.js",
+  "scan:model":  "analyzers/scan.js",
+  "scan:shell":  "analyzers/scan.js",
+  "scan:route":  "analyzers/scan.js",
+  "scan:extra":  "analyzers/scan.js",
+  init:          "engine/init.js",
+  populate:      "engine/populate.js",
+  tfill:         "engine/tfill.js",
+  readme:        "engine/readme.js",
+  spec:          "spec/spec.js",
+  gate:          "spec/gate.js",
+  forge:         "forge/forge.js",
+  flow:          "flow/flow.js",
+};
+
+/** サブコマンドに注入する追加引数 */
+const INJECT = {
+  "scan:ctrl":   ["--only", "controllers"],
+  "scan:model":  ["--only", "models"],
+  "scan:shell":  ["--only", "shells"],
+  "scan:route":  ["--only", "routes"],
+  "scan:extra":  ["--only", "extras"],
+};
+
+/** プロジェクトコンテキスト解決が不要なコマンド */
+const PROJECT_MGMT = new Set(["add", "default", "help"]);
+
+// --project フラグを argv から抽出
+const rawArgs = process.argv.slice(2);
+let projectName;
+let filteredArgs = rawArgs;
+
+const projIdx = rawArgs.indexOf("--project");
+if (projIdx !== -1) {
+  projectName = rawArgs[projIdx + 1];
+  filteredArgs = [
+    ...rawArgs.slice(0, projIdx),
+    ...rawArgs.slice(projIdx + 2),
+  ];
+}
+
+const [subCmd, ...rest] = filteredArgs;
+
+// ヘルプ（引数なし / -h / --help）
+if (!subCmd || subCmd === "-h" || subCmd === "--help") {
+  const helpPath = path.join(PKG_DIR, "help.js");
+  process.argv = [process.argv[0], helpPath];
+  await import(helpPath);
+  process.exit(0);
+}
+
+// プロジェクトコンテキストの解決（管理コマンド以外）
+if (!PROJECT_MGMT.has(subCmd)) {
+  const { resolveProject, workRootFor } = await import(
+    path.join(PKG_DIR, "projects/projects.js")
+  );
+  try {
+    const project = resolveProject(projectName);
+    if (project) {
+      process.env.SDD_SOURCE_ROOT = project.path;
+      process.env.SDD_WORK_ROOT   = workRootFor(project.name);
+    }
+  } catch (err) {
+    console.error(`Error: ${err.message}`);
+    process.exit(1);
+  }
+}
+
+// scan:all: 全解析 → populate を順に実行
+if (subCmd === "scan:all") {
+  const scanPath     = path.join(PKG_DIR, "analyzers/scan.js");
+  const populatePath = path.join(PKG_DIR, "engine/populate.js");
+
+  process.argv = [process.argv[0], scanPath, ...rest];
+  await import(scanPath);
+
+  process.argv = [process.argv[0], populatePath];
+  await import(populatePath);
+  process.exit(0);
+}
+
+const scriptRelPath = SCRIPTS[subCmd];
+if (!scriptRelPath) {
+  console.error(`sdd-forge: unknown command '${subCmd}'`);
+  console.error("Run: sdd-forge help");
+  process.exit(1);
+}
+
+const scriptPath = path.join(PKG_DIR, scriptRelPath);
+const inject = INJECT[subCmd] || [];
+process.argv = [process.argv[0], scriptPath, ...inject, ...rest];
+
+await import(scriptPath);

package/src/engine/directive-parser.js

@@ -0,0 +1,72 @@
+/**
+ * tools/engine/directive-parser.js
+ *
+ * テンプレート内の @data-fill / @text-fill ディレクティブを抽出する。
+ *
+ * ディレクティブ構文:
+ *   <!-- @data-fill: <renderer>(<category>, labels=<label1>|<label2>|...) -->
+ *   <!-- @text-fill: <prompt text> -->
+ */
+
+/**
+ * @typedef {Object} DataFillDirective
+ * @property {"data-fill"} type
+ * @property {string} renderer   - table | kv | mermaid-er | bool-matrix
+ * @property {string} category   - 汎用カテゴリ名
+ * @property {string[]} labels   - テーブルヘッダー表示名
+ * @property {string} raw        - ディレクティブ行の全文
+ * @property {number} line        - 行番号 (0-based)
+ */
+
+/**
+ * @typedef {Object} TextFillDirective
+ * @property {"text-fill"} type
+ * @property {string} prompt     - LLM に渡すプロンプト
+ * @property {string} raw        - ディレクティブ行の全文
+ * @property {number} line        - 行番号 (0-based)
+ */
+
+const DATA_FILL_RE = /^<!--\s*@data-fill:\s*([\w-]+)\(([^,)]+)(?:,\s*labels=([^)]+))?\)\s*-->$/;
+const TEXT_FILL_RE = /^<!--\s*@text-fill:\s*(.+?)\s*-->$/;
+
+/**
+ * テンプレートテキストからディレクティブを抽出する。
+ *
+ * @param {string} text - テンプレート全文
+ * @returns {Array<DataFillDirective|TextFillDirective>}
+ */
+export function parseDirectives(text) {
+  const lines = text.split("\n");
+  const directives = [];
+
+  for (let i = 0; i < lines.length; i++) {
+    const trimmed = lines[i].trim();
+
+    const dataMatch = trimmed.match(DATA_FILL_RE);
+    if (dataMatch) {
+      const labels = dataMatch[3] ? dataMatch[3].split("|").map((l) => l.trim()) : [];
+      directives.push({
+        type: "data-fill",
+        renderer: dataMatch[1],
+        category: dataMatch[2].trim(),
+        labels,
+        raw: lines[i],
+        line: i,
+      });
+      continue;
+    }
+
+    const textMatch = trimmed.match(TEXT_FILL_RE);
+    if (textMatch) {
+      directives.push({
+        type: "text-fill",
+        prompt: textMatch[1],
+        raw: lines[i],
+        line: i,
+      });
+      continue;
+    }
+  }
+
+  return directives;
+}