ai-spec-dev 0.42.0 → 0.55.0

package/cli/commands/model.ts

@@ -1,156 +0,0 @@
-import { Command } from "commander";
-import * as path from "path";
-import * as fs from "fs-extra";
-import chalk from "chalk";
-import { input, select, confirm } from "@inquirer/prompts";
-import {
-  DEFAULT_MODELS,
-  ENV_KEY_MAP,
-  PROVIDER_CATALOG,
-} from "../../core/spec-generator";
-import { AiSpecConfig, CONFIG_FILE, loadConfig } from "../utils";
-
-export function registerModel(program: Command): void {
-  program
-    .command("model")
-    .description("Interactively switch the active AI provider/model and save to .ai-spec.json")
-    .option("--list", "List all available providers and models")
-    .action(async (opts) => {
-      const currentDir = process.cwd();
-      const configPath = path.join(currentDir, CONFIG_FILE);
-
-      // ── --list ──────────────────────────────────────────────────────────────
-      if (opts.list) {
-        console.log(chalk.bold("\nAvailable providers & models:\n"));
-        for (const [key, meta] of Object.entries(PROVIDER_CATALOG)) {
-          console.log(
-            `  ${chalk.bold.cyan(key.padEnd(10))} ${chalk.white(meta.displayName)}`
-          );
-          console.log(chalk.gray(`             ${meta.description}`));
-          console.log(
-            chalk.gray(
-              `             env: ${meta.envKey}  |  models: ${meta.models.join(", ")}`
-            )
-          );
-          console.log();
-        }
-        return;
-      }
-
-      const existing: AiSpecConfig = await loadConfig(currentDir);
-
-      console.log(chalk.blue("\n─── Model Switcher ─────────────────────────────"));
-      if (Object.keys(existing).length > 0) {
-        console.log(
-          chalk.gray(
-            `  Current: spec=${existing.provider ?? "gemini"}/${existing.model ?? DEFAULT_MODELS[existing.provider ?? "gemini"]}` +
-              (existing.codegenProvider
-                ? `  codegen=${existing.codegenProvider}/${existing.codegenModel ?? ""}`
-                : "")
-          )
-        );
-      }
-      console.log();
-
-      const target = await select({
-        message: "Configure model for:",
-        choices: [
-          { name: "Spec generation  (used for spec writing & refinement)", value: "spec" },
-          { name: "Code generation  (used when --codegen api is active)", value: "codegen" },
-          { name: "Both             (same provider/model for all tasks)", value: "both" },
-        ],
-      });
-
-      async function pickProviderAndModel(label: string): Promise<{ provider: string; model: string }> {
-        const providerKey = await select({
-          message: `${label} — select provider:`,
-          choices: Object.entries(PROVIDER_CATALOG).map(([key, meta]) => ({
-            name: `${meta.displayName.padEnd(22)} ${chalk.gray(meta.description)}`,
-            value: key,
-            short: meta.displayName,
-          })),
-        });
-
-        const meta = PROVIDER_CATALOG[providerKey];
-        const modelChoices = [
-          ...meta.models.map((m) => ({ name: m, value: m })),
-          { name: chalk.italic("✎  Enter custom model name..."), value: "__custom__" },
-        ];
-
-        let chosenModel = await select({
-          message: `${label} — select model (${meta.displayName}):`,
-          choices: modelChoices,
-        });
-
-        if (chosenModel === "__custom__") {
-          chosenModel = await input({
-            message: "Enter model name:",
-            validate: (v) => v.trim().length > 0 || "Model name cannot be empty",
-          });
-        }
-
-        return { provider: providerKey, model: chosenModel };
-      }
-
-      const updated: AiSpecConfig = { ...existing };
-
-      if (target === "spec" || target === "both") {
-        const { provider, model } = await pickProviderAndModel("Spec");
-        updated.provider = provider;
-        updated.model = model;
-      }
-
-      if (target === "codegen" || target === "both") {
-        if (target === "both") {
-          updated.codegenProvider = updated.provider;
-          updated.codegenModel = updated.model;
-        } else {
-          const { provider, model } = await pickProviderAndModel("Codegen");
-          updated.codegenProvider = provider;
-          updated.codegenModel = model;
-        }
-
-        const effectiveCodegenProvider = updated.codegenProvider ?? updated.provider ?? "gemini";
-        if (effectiveCodegenProvider !== "claude") {
-          if (!updated.codegen || updated.codegen === "claude-code") {
-            updated.codegen = "api";
-            console.log(
-              chalk.yellow(
-                `\n  ⚠  provider "${effectiveCodegenProvider}" 不支持 "claude-code" 模式。`
-              )
-            );
-            console.log(chalk.gray(`  已自动将 codegen 模式设为 "api"。`));
-          }
-        }
-      }
-
-      console.log(chalk.blue("\n  Preview:"));
-      console.log(chalk.gray(`    spec    → ${updated.provider}/${updated.model}`));
-      if (updated.codegenProvider) {
-        console.log(
-          chalk.gray(
-            `    codegen → ${updated.codegenProvider}/${updated.codegenModel}  (mode: ${updated.codegen ?? "claude-code"})`
-          )
-        );
-      }
-
-      const ok = await confirm({ message: "Save to .ai-spec.json?", default: true });
-      if (!ok) {
-        console.log(chalk.gray("  Cancelled."));
-        return;
-      }
-
-      await fs.writeJson(configPath, updated, { spaces: 2 });
-      console.log(chalk.green(`\n  ✔ Saved to ${configPath}`));
-
-      const providerToCheck = updated.provider ?? "gemini";
-      const envKey = ENV_KEY_MAP[providerToCheck];
-      if (envKey && !process.env[envKey]) {
-        console.log(
-          chalk.yellow(
-            `  ⚠  Remember to set ${envKey} in your environment or .env file.`
-          )
-        );
-      }
-    });
-}

package/cli/commands/scan.ts

@@ -1,99 +0,0 @@
-import { Command } from "commander";
-import chalk from "chalk";
-import * as path from "path";
-import { runScan, saveIndex, loadIndex, INDEX_FILE, ProjectEntry } from "../../core/project-index";
-
-const ROLE_COLOR: Record<string, (s: string) => string> = {
-  backend:  chalk.blue,
-  frontend: chalk.green,
-  mobile:   chalk.magenta,
-  shared:   chalk.gray,
-};
-
-function formatEntry(entry: ProjectEntry): string {
-  const roleColor = ROLE_COLOR[entry.role] ?? chalk.white;
-  const role = roleColor(entry.role.padEnd(8));
-  const type = chalk.gray(entry.type.padEnd(14));
-  const name = (entry.missing ? chalk.strikethrough.gray : chalk.white)(entry.path.padEnd(30));
-  const badges: string[] = [];
-  if (entry.hasConstitution) badges.push(chalk.cyan("§C"));
-  if (entry.hasWorkspace)    badges.push(chalk.yellow("W"));
-  if (entry.missing)         badges.push(chalk.red("missing"));
-  const stack = chalk.gray(entry.techStack.slice(0, 5).join(", "));
-  return `  ${name} ${role} ${type} ${badges.join(" ")}  ${stack}`;
-}
-
-export function registerScan(program: Command): void {
-  program
-    .command("scan")
-    .description("Discover and index all projects under the current directory")
-    .option("-d, --depth <n>", "Max directory depth to search", "2")
-    .option("--list", "Just print the current index without rescanning")
-    .action(async (opts) => {
-      const cwd = process.cwd();
-
-      // ── List mode ─────────────────────────────────────────────────────────
-      if (opts.list) {
-        const existing = await loadIndex(cwd);
-        if (!existing || existing.projects.length === 0) {
-          console.log(chalk.gray("No index found. Run: ai-spec scan"));
-          return;
-        }
-
-        console.log(chalk.cyan(`\n─── Project Index (${existing.projects.length} projects) ─────────────────────────────`));
-        console.log(chalk.gray(`  Last scanned : ${existing.lastScanned.slice(0, 19).replace("T", " ")}`));
-        console.log(chalk.gray(`  Root         : ${existing.scanRoot}\n`));
-
-        const active = existing.projects.filter((p) => !p.missing);
-        const missing = existing.projects.filter((p) => p.missing);
-
-        for (const entry of active) {
-          console.log(formatEntry(entry));
-        }
-        if (missing.length > 0) {
-          console.log(chalk.gray(`\n  (${missing.length} previously seen, now missing)`));
-          for (const entry of missing) {
-            console.log(formatEntry(entry));
-          }
-        }
-
-        console.log(chalk.cyan("\n─".repeat(52)));
-        console.log(chalk.gray("  §C = has constitution  W = workspace root"));
-        console.log(chalk.gray(`  Index file: ${INDEX_FILE}`));
-        return;
-      }
-
-      // ── Scan mode ─────────────────────────────────────────────────────────
-      const maxDepth = parseInt(opts.depth, 10);
-      console.log(chalk.blue(`\nScanning ${cwd} (depth: ${maxDepth})...`));
-
-      const { index, added, updated, unchanged, nowMissing } = await runScan(cwd, maxDepth);
-      await saveIndex(cwd, index);
-
-      const active = index.projects.filter((p) => !p.missing);
-
-      // ── Summary ───────────────────────────────────────────────────────────
-      console.log(chalk.cyan(`\n─── Scan Results ────────────────────────────────────`));
-      if (added.length > 0)       console.log(chalk.green(`  + ${added.length} new project(s) added`));
-      if (updated.length > 0)     console.log(chalk.yellow(`  ~ ${updated.length} project(s) updated`));
-      if (unchanged.length > 0)   console.log(chalk.gray(`  · ${unchanged.length} project(s) unchanged`));
-      if (nowMissing.length > 0)  console.log(chalk.red(`  ✘ ${nowMissing.length} project(s) no longer found (marked missing)`));
-
-      if (added.length === 0 && updated.length === 0 && nowMissing.length === 0) {
-        console.log(chalk.gray("  Nothing changed."));
-      }
-
-      // ── Full listing ──────────────────────────────────────────────────────
-      if (active.length > 0) {
-        console.log(chalk.cyan(`\n  Projects (${active.length}):`));
-        for (const entry of active) {
-          console.log(formatEntry(entry));
-        }
-      }
-
-      console.log(chalk.cyan("\n─".repeat(52)));
-      console.log(chalk.gray("  §C = has constitution  W = workspace root"));
-      console.log(chalk.gray(`  Index saved : ${path.relative(cwd, path.join(cwd, INDEX_FILE))}`));
-      console.log(chalk.gray(`  Next steps  : ai-spec scan --list | ai-spec init [--global]`));
-    });
-}

package/cli/commands/workspace.ts

@@ -1,219 +0,0 @@
-import { Command } from "commander";
-import * as path from "path";
-import * as fs from "fs-extra";
-import chalk from "chalk";
-import { input, select, confirm } from "@inquirer/prompts";
-import {
-  WorkspaceLoader,
-  WorkspaceConfig,
-  RepoConfig,
-  WORKSPACE_CONFIG_FILE,
-  detectRepoType,
-} from "../../core/workspace-loader";
-
-export function registerWorkspace(program: Command): void {
-  const workspaceCmd = program
-    .command("workspace")
-    .description("Manage multi-repo workspace configuration");
-
-  // ── workspace init ──────────────────────────────────────────────────────────
-  workspaceCmd
-    .command("init")
-    .description(`Interactive workspace setup — creates ${WORKSPACE_CONFIG_FILE}`)
-    .action(async () => {
-      const currentDir = process.cwd();
-      const configPath = path.join(currentDir, WORKSPACE_CONFIG_FILE);
-
-      if (await fs.pathExists(configPath)) {
-        const overwrite = await confirm({
-          message: `${WORKSPACE_CONFIG_FILE} already exists. Overwrite?`,
-          default: false,
-        });
-        if (!overwrite) {
-          console.log(chalk.gray("  Cancelled."));
-          return;
-        }
-      }
-
-      console.log(chalk.blue("\n─── Workspace Setup ────────────────────────────"));
-
-      const workspaceName = await input({
-        message: "Workspace name:",
-        validate: (v) => v.trim().length > 0 || "Name cannot be empty",
-      });
-
-      const repos: RepoConfig[] = [];
-
-      const useAutoScan = await confirm({
-        message: "Auto-scan sibling directories for repos?",
-        default: true,
-      });
-
-      if (useAutoScan) {
-        const workspaceLoader = new WorkspaceLoader(currentDir);
-        const detected = await workspaceLoader.autoDetect();
-
-        if (detected.length === 0) {
-          console.log(chalk.yellow("  No recognizable repos found in sibling directories."));
-        } else {
-          console.log(chalk.cyan("\n  Detected repos:"));
-          for (const r of detected) {
-            console.log(chalk.gray(`    - ${r.name}: ${r.role} (${r.type}) at ${r.path}`));
-          }
-
-          const keepAll = await confirm({
-            message: `Include all ${detected.length} detected repo(s)?`,
-            default: true,
-          });
-
-          if (keepAll) {
-            repos.push(...detected);
-          } else {
-            for (const r of detected) {
-              const keep = await confirm({
-                message: `Include "${r.name}" (${r.role}, ${r.type})?`,
-                default: true,
-              });
-              if (keep) repos.push(r);
-            }
-          }
-          console.log(chalk.green(`  ✔ ${repos.length} repo(s) added from auto-scan.`));
-        }
-      }
-
-      const repoTypeChoices = [
-        { name: "node-express (Node.js/Express backend)", value: "node-express" },
-        { name: "node-koa (Node.js/Koa backend)", value: "node-koa" },
-        { name: "go (Go backend)", value: "go" },
-        { name: "python (Python backend)", value: "python" },
-        { name: "java (Java/Spring backend)", value: "java" },
-        { name: "rust (Rust backend)", value: "rust" },
-        { name: "php (PHP/Lumen/Laravel backend)", value: "php" },
-        { name: "react (React frontend)", value: "react" },
-        { name: "next (Next.js)", value: "next" },
-        { name: "vue (Vue frontend)", value: "vue" },
-        { name: "react-native (React Native mobile)", value: "react-native" },
-        { name: "unknown", value: "unknown" },
-      ];
-
-      let addMore = await confirm({
-        message: repos.length > 0 ? "Manually add more repos?" : "Add repos manually?",
-        default: repos.length === 0,
-      });
-
-      while (addMore) {
-        console.log(chalk.cyan(`\n  Adding repo #${repos.length + 1}`));
-
-        const repoName = await input({
-          message: "Repo name (e.g. api, web, app):",
-          validate: (v) => {
-            if (!v.trim()) return "Name cannot be empty";
-            if (repos.some((r) => r.name === v.trim())) return "Name already used";
-            return true;
-          },
-        });
-
-        const repoPath = await input({
-          message: `Relative path to "${repoName}" from here (default: ./${repoName}):`,
-          default: `./${repoName}`,
-        });
-
-        const absPath = path.resolve(currentDir, repoPath);
-        let detectedType = "unknown";
-        let detectedRole = "shared";
-
-        if (await fs.pathExists(absPath)) {
-          const { type, role } = await detectRepoType(absPath);
-          detectedType = type;
-          detectedRole = role;
-          console.log(chalk.gray(`    Auto-detected: type=${type}, role=${role}`));
-        } else {
-          console.log(chalk.yellow(`    Path "${absPath}" not found — type/role will be manual.`));
-        }
-
-        const repoType = await select({
-          message: `Repo type for "${repoName}":`,
-          choices: repoTypeChoices,
-          default: detectedType,
-        });
-
-        const repoRole = await select({
-          message: `Repo role for "${repoName}":`,
-          choices: [
-            { name: "backend", value: "backend" },
-            { name: "frontend", value: "frontend" },
-            { name: "mobile", value: "mobile" },
-            { name: "shared", value: "shared" },
-          ],
-          default: detectedRole,
-        });
-
-        repos.push({
-          name: repoName,
-          path: repoPath,
-          type: repoType as RepoConfig["type"],
-          role: repoRole as RepoConfig["role"],
-        });
-
-        console.log(chalk.green(`  ✔ Added: ${repoName} (${repoRole}, ${repoType})`));
-
-        addMore = await confirm({
-          message: "Add another repo?",
-          default: false,
-        });
-      }
-
-      const workspaceConfig: WorkspaceConfig = { name: workspaceName, repos };
-
-      console.log(chalk.cyan("\n  Workspace summary:"));
-      console.log(chalk.gray(`  Name: ${workspaceName}`));
-      for (const r of repos) {
-        console.log(chalk.gray(`  - ${r.name}: ${r.role} (${r.type}) at ${r.path}`));
-      }
-
-      const ok = await confirm({ message: `Save to ${WORKSPACE_CONFIG_FILE}?`, default: true });
-      if (!ok) {
-        console.log(chalk.gray("  Cancelled."));
-        return;
-      }
-
-      const loader = new WorkspaceLoader(currentDir);
-      const saved = await loader.save(workspaceConfig);
-      console.log(chalk.green(`\n  ✔ Workspace saved: ${saved}`));
-      console.log(chalk.gray(`  Run \`ai-spec create "your feature"\` — workspace mode will activate automatically.`));
-    });
-
-  // ── workspace status ────────────────────────────────────────────────────────
-  workspaceCmd
-    .command("status")
-    .description("Show current workspace configuration")
-    .action(async () => {
-      const currentDir = process.cwd();
-      const loader = new WorkspaceLoader(currentDir);
-      const config = await loader.load();
-
-      if (!config) {
-        console.log(chalk.yellow(`No ${WORKSPACE_CONFIG_FILE} found in ${currentDir}`));
-        console.log(chalk.gray("  Run `ai-spec workspace init` to create one."));
-        return;
-      }
-
-      console.log(chalk.bold(`\nWorkspace: ${config.name}`));
-      console.log(chalk.gray(`  Config: ${path.join(currentDir, WORKSPACE_CONFIG_FILE)}`));
-      console.log(chalk.gray(`  Repos (${config.repos.length}):\n`));
-
-      for (const repo of config.repos) {
-        const absPath = loader.resolveAbsPath(repo);
-        const exists = await fs.pathExists(absPath);
-        const status = exists ? chalk.green("found") : chalk.red("not found");
-
-        console.log(
-          `  ${chalk.bold(repo.name.padEnd(12))} ${repo.role.padEnd(10)} ${repo.type.padEnd(16)} ${status}`
-        );
-        console.log(chalk.gray(`    path: ${absPath}`));
-        if (repo.constitution) {
-          console.log(chalk.green(`    constitution: found`));
-        }
-      }
-    });
-}

package/demo-backend/.ai-spec-constitution.md

@@ -1,65 +0,0 @@
-# Project Constitution
-
-## 1. 架构规则 (Architecture Rules)
-- **分层架构**：项目采用三层架构 `routes → controllers → services → database`。
-- **禁止跨层调用**：
-  - `routes` 层仅负责定义路由和中间件，不能包含业务逻辑。
-  - `controllers` 层负责接收请求、调用 `services` 和返回响应，不能直接操作数据库。
-  - `services` 层封装核心业务逻辑，是唯一允许直接调用数据访问层（如 Prisma）的层级。
-- **模块组织**：功能模块按领域划分，每个模块包含独立的 `routes.ts`, `controller.ts`, `service.ts` 文件。
-
-## 2. 命名规范 (Naming Conventions)
-- **文件命名**：使用 `kebab-case`（如 `user-profile.controller.ts`）。
-- **变量/函数**：使用 `camelCase`（如 `getUserById`）。
-- **类/接口**：使用 `PascalCase`（如 `UserService`）。
-- **路由路径**：使用 `kebab-case`，资源名词复数（如 `/api/v1/user-profiles`）。
-
-## 3. API 规范 (API Patterns)
-- **路由前缀**：
-  - 客户端 API：`/api/v1/...`
-  - 管理端 API：`/api/v1/admin/...`
-- **统一响应结构**：
-  ```json
-  {
-    "code": 200,
-    "message": "success",
-    "data": {}
-  }
-  ```
-- **错误码规范**：
-  - `400`：客户端请求错误（参数错误、验证失败）
-  - `401`：未认证
-  - `403`：无权限
-  - `404`：资源不存在
-  - `500`：服务器内部错误
-- **认证/鉴权**：使用 `auth.middleware.ts` 保护需要认证的路由，位于 `middleware/` 目录。
-
-## 4. 数据层规范 (Data Layer Rules)
-- **数据库访问**：仅允许在 `service` 层使用 Prisma Client 进行数据库操作。
-- **模型命名**：Prisma model 使用 `PascalCase`（如 `UserProfile`），表名使用 `snake_case`（如 `user_profiles`）。
-- **事务处理**：复杂业务逻辑使用 Prisma 的 `$transaction` API 保证数据一致性。
-
-## 5. 错误处理规范 (Error Handling Patterns)
-- **统一错误中间件**：使用 `error.middleware.ts` 捕获所有错误，位于 `middleware/` 目录。
-- **错误抛出**：在 `service` 或 `controller` 中抛出 `AppError`（自定义错误类，包含 `code` 和 `message`）。
-- **已知错误码**：
-  - `VALIDATION_ERROR` (400)
-  - `UNAUTHORIZED` (401)
-  - `FORBIDDEN` (403)
-  - `NOT_FOUND` (404)
-  - `INTERNAL_ERROR` (500)
-
-## 6. 禁区 (Red Lines — Never Violate)
-- [ ] **禁止**在 `controller` 或 `route` 层直接操作数据库（必须通过 `service`）。
-- [ ] **禁止**创建重复的配置文件（如错误码、路由定义），必须追加到现有文件。
-- [ ] **禁止**使用 `any` 类型，必须定义明确的接口或类型。
-- [ ] **禁止**提交未通过 `vitest` 测试的代码。
-
-## 7. 测试规范 (Testing Rules)
-- **测试文件位置**：与源文件同目录，命名规则为 `*.test.ts` 或 `*.spec.ts`。
-- **测试覆盖**：必须为所有 `service` 和 `controller` 方法编写单元测试，关键业务流程需包含集成测试。
-- **测试框架**：使用 `vitest` 进行单元测试和集成测试，使用 `supertest` 进行 HTTP 接口测试。
-
-## 8. 共享配置文件清单 (Shared Config Files — Append-Only)
-
-(No shared config files detected — will be populated on first run)

package/demo-backend/package.json

@@ -1,21 +0,0 @@
-{
-  "name": "demo-backend",
-  "version": "0.1.0",
-  "private": true,
-  "scripts": {
-    "dev": "ts-node src/index.ts",
-    "build": "tsc",
-    "test": "vitest run"
-  },
-  "dependencies": {
-    "express": "^4.18.2",
-    "cors": "^2.8.5"
-  },
-  "devDependencies": {
-    "typescript": "^5.7.0",
-    "@types/express": "^4.17.21",
-    "@types/cors": "^2.8.17",
-    "ts-node": "^10.9.2",
-    "vitest": "^2.1.0"
-  }
-}

package/demo-backend/prisma/schema.prisma

@@ -1,22 +0,0 @@
-// This is your Prisma schema file,
-// learn more about it in the docs: https://pris.ly/d/prisma-schema
-
-generator client {
-  provider = "prisma-client-js"
-}
-
-datasource db {
-  provider = "postgresql"
-  url      = env("DATABASE_URL")
-}
-
-model Bookmark {
-  id        String   @id @default(uuid())
-  title     String
-  url       String
-  tags      String[]
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  @@map("bookmarks")
-}