codebyplan 1.13.60 → 1.13.62

package/dist/ci.js

@@ -0,0 +1,518 @@
+// src/lib/repo-reader.ts
+import * as fsPromises from "node:fs/promises";
+import * as path from "node:path";
+var LocalFsReader = class {
+  constructor(rootDir) {
+    this.rootDir = rootDir;
+  }
+  rootDir;
+  resolve(p) {
+    return path.isAbsolute(p) ? p : path.resolve(this.rootDir, p);
+  }
+  async list(dir) {
+    const abs = this.resolve(dir);
+    try {
+      const entries = await fsPromises.readdir(abs, { withFileTypes: true });
+      return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+    } catch {
+      return [];
+    }
+  }
+  async read(filePath) {
+    const abs = this.resolve(filePath);
+    try {
+      return await fsPromises.readFile(abs, "utf-8");
+    } catch (err) {
+      throw new Error(
+        `repo-reader: could not read '${abs}': ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
+  async exists(filePath) {
+    const abs = this.resolve(filePath);
+    try {
+      await fsPromises.access(abs);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+};
+
+// src/lib/ci-init.ts
+import * as fs2 from "node:fs";
+import * as path2 from "node:path";
+
+// src/lib/atomic-write.ts
+import * as fs from "node:fs";
+function writeJsonAtomic(filePath, value) {
+  const tmpPath = filePath + ".tmp";
+  try {
+    fs.writeFileSync(tmpPath, JSON.stringify(value, null, 2) + "\n", "utf-8");
+    fs.renameSync(tmpPath, filePath);
+  } catch (err) {
+    try {
+      fs.unlinkSync(tmpPath);
+    } catch {
+    }
+    throw err;
+  }
+}
+
+// src/lib/ci-init.ts
+var PLATFORM_COMMAND_MAP = {
+  next_js: {
+    unit_test: {
+      command: "pnpm turbo test",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    typecheck: {
+      command: "pnpm turbo typecheck",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    build: {
+      command: "pnpm turbo build",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    lint: {
+      scope: "per_app_changed",
+      hard_fail: true,
+      delegates_to: ".codebyplan/eslint.json"
+    },
+    e2e: {
+      scope: "per_app_changed",
+      hard_fail: false,
+      delegates_to: ".codebyplan/e2e.json"
+    },
+    audit: {
+      command: "pnpm audit --json",
+      scope: "full_repo",
+      hard_fail: true
+    }
+  },
+  nestjs: {
+    unit_test: {
+      command: "pnpm turbo test",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    typecheck: {
+      command: "pnpm turbo typecheck",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    build: {
+      command: "pnpm turbo build",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    lint: {
+      scope: "per_app_changed",
+      hard_fail: true,
+      delegates_to: ".codebyplan/eslint.json"
+    },
+    e2e: {
+      scope: "per_app_changed",
+      hard_fail: false,
+      delegates_to: ".codebyplan/e2e.json"
+    },
+    audit: {
+      command: "pnpm audit --json",
+      scope: "full_repo",
+      hard_fail: true
+    }
+  },
+  tauri: {
+    unit_test: {
+      command: "pnpm turbo test",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    typecheck: {
+      command: "pnpm turbo typecheck",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    build: {
+      command: "pnpm turbo build",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    lint: {
+      scope: "per_app_changed",
+      hard_fail: true,
+      delegates_to: ".codebyplan/eslint.json"
+    },
+    e2e: {
+      scope: "per_app_changed",
+      hard_fail: false,
+      delegates_to: ".codebyplan/e2e.json"
+    },
+    audit: {
+      command: "pnpm audit --json",
+      scope: "full_repo",
+      hard_fail: true
+    }
+  },
+  vscode: {
+    unit_test: {
+      command: "pnpm turbo test",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    typecheck: {
+      command: "pnpm turbo typecheck",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    build: {
+      command: "pnpm turbo build",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    lint: {
+      scope: "per_app_changed",
+      hard_fail: true,
+      delegates_to: ".codebyplan/eslint.json"
+    },
+    e2e: {
+      scope: "per_app_changed",
+      hard_fail: false,
+      delegates_to: ".codebyplan/e2e.json"
+    },
+    audit: {
+      command: "pnpm audit --json",
+      scope: "full_repo",
+      hard_fail: true
+    }
+  },
+  expo: {
+    unit_test: {
+      command: "pnpm turbo test",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    typecheck: {
+      command: "pnpm turbo typecheck",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    build: {
+      command: "pnpm turbo build",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    lint: {
+      scope: "per_app_changed",
+      hard_fail: true,
+      delegates_to: ".codebyplan/eslint.json"
+    },
+    e2e: {
+      scope: "per_app_changed",
+      hard_fail: false,
+      delegates_to: ".codebyplan/e2e.json"
+    },
+    audit: {
+      command: "pnpm audit --json",
+      scope: "full_repo",
+      hard_fail: true
+    }
+  },
+  package: {
+    unit_test: {
+      command: "pnpm turbo test",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    typecheck: {
+      command: "pnpm turbo typecheck",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    build: {
+      command: "pnpm turbo build",
+      scope: "per_app_changed",
+      hard_fail: true
+    },
+    lint: {
+      scope: "per_app_changed",
+      hard_fail: true,
+      delegates_to: ".codebyplan/eslint.json"
+    },
+    e2e: {
+      scope: "per_app_changed",
+      hard_fail: false,
+      delegates_to: ".codebyplan/e2e.json"
+    },
+    audit: {
+      command: "pnpm audit --json",
+      scope: "full_repo",
+      hard_fail: true
+    }
+  }
+};
+async function tryReadJson(reader, filePath) {
+  try {
+    const raw = await reader.read(filePath);
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function hasDep(pkg, name) {
+  if (!pkg) return false;
+  const deps = pkg["dependencies"];
+  const devDeps = pkg["devDependencies"];
+  return Boolean(deps?.[name] ?? devDeps?.[name]);
+}
+function hasDevDep(pkg, name) {
+  if (!pkg) return false;
+  const devDeps = pkg["devDependencies"];
+  return Boolean(devDeps?.[name]);
+}
+async function detectPlatforms(reader) {
+  const detected = /* @__PURE__ */ new Set();
+  const dirsToScan = [""];
+  const appsChildren = await reader.list("apps");
+  for (const name of appsChildren) {
+    dirsToScan.push(`apps/${name}`);
+  }
+  for (const dir of dirsToScan) {
+    const pkgPath = dir ? `${dir}/package.json` : "package.json";
+    const pkg = await tryReadJson(reader, pkgPath);
+    const nextBase = dir ? `${dir}/` : "";
+    if (await reader.exists(`${nextBase}next.config.ts`) || await reader.exists(`${nextBase}next.config.js`) || await reader.exists(`${nextBase}next.config.mjs`)) {
+      detected.add("next_js");
+    }
+    if (hasDep(pkg, "@nestjs/core")) {
+      detected.add("nestjs");
+    }
+    if (await reader.exists(`${nextBase}tauri.conf.json`) || await reader.exists(`${nextBase}src-tauri`)) {
+      detected.add("tauri");
+    }
+    if (hasDevDep(pkg, "@types/vscode")) {
+      detected.add("vscode");
+    }
+    const deps = pkg?.["dependencies"];
+    if (deps?.["expo"]) {
+      detected.add("expo");
+    }
+  }
+  const packagesChildren = await reader.list("packages");
+  if (packagesChildren.length > 0) {
+    detected.add("package");
+  }
+  if (detected.size === 0) {
+    detected.add("package");
+  }
+  return Array.from(detected);
+}
+function buildDefaultCiConfig(platforms) {
+  const config = {
+    platforms: {},
+    delegation: {
+      lint: ".codebyplan/eslint.json",
+      e2e: ".codebyplan/e2e.json",
+      detection: ".claude/docs/architecture/testing-matrix.md"
+    },
+    workflow: {
+      required_check_enforced: false
+    }
+  };
+  for (const platform of platforms) {
+    const checks = PLATFORM_COMMAND_MAP[platform] ?? PLATFORM_COMMAND_MAP["package"];
+    if (checks) {
+      config.platforms[platform] = { ...checks };
+    }
+  }
+  return config;
+}
+async function runCiInit(opts) {
+  const projectDir = path2.resolve(opts?.projectDir ?? process.cwd());
+  const dryRun = opts?.dryRun ?? false;
+  const force = opts?.force ?? false;
+  const ciPath = path2.join(projectDir, ".codebyplan", "ci.json");
+  const reader = opts?.reader ?? new LocalFsReader(projectDir);
+  const platforms = await detectPlatforms(reader);
+  if (dryRun) {
+    return { status: "dry_run", path: ciPath, platforms };
+  }
+  let existing = null;
+  if (fs2.existsSync(ciPath)) {
+    try {
+      existing = JSON.parse(fs2.readFileSync(ciPath, "utf-8"));
+    } catch {
+    }
+  }
+  const newConfig = buildDefaultCiConfig(platforms);
+  if (existing !== null && !force) {
+    if (!existing.platforms) existing.platforms = {};
+    const newPlatforms = platforms.filter((p) => !(p in existing.platforms));
+    for (const p of newPlatforms) {
+      const checks = newConfig.platforms[p];
+      if (checks) {
+        existing.platforms[p] = checks;
+      }
+    }
+    let categoriesAdded = false;
+    for (const p of platforms) {
+      if (newPlatforms.includes(p)) continue;
+      const existingChecks = existing.platforms[p];
+      const defaultChecks = newConfig.platforms[p];
+      if (!existingChecks || !defaultChecks) continue;
+      for (const [cat, check] of Object.entries(defaultChecks)) {
+        if (!(cat in existingChecks)) {
+          existingChecks[cat] = check;
+          categoriesAdded = true;
+        }
+      }
+    }
+    if (newPlatforms.length === 0 && !categoriesAdded) {
+      return { status: "skipped", path: ciPath, platforms };
+    }
+    writeJsonAtomic(ciPath, existing);
+    return {
+      status: "written",
+      path: ciPath,
+      platforms: newPlatforms.length > 0 ? newPlatforms : platforms
+    };
+  }
+  const codebyplanDir = path2.join(projectDir, ".codebyplan");
+  fs2.mkdirSync(codebyplanDir, { recursive: true });
+  writeJsonAtomic(ciPath, newConfig);
+  return { status: "written", path: ciPath, platforms };
+}
+
+// src/lib/scaffold-ci-workflow.ts
+import * as fs4 from "node:fs";
+import * as path4 from "node:path";
+
+// src/lib/templates-dir.ts
+import * as fs3 from "node:fs";
+import * as path3 from "node:path";
+import { fileURLToPath } from "node:url";
+function resolveTemplatesDir() {
+  const here = path3.dirname(fileURLToPath(import.meta.url));
+  const candidates = [
+    path3.resolve(here, "..", "templates"),
+    path3.resolve(here, "..", "..", "templates"),
+    path3.resolve(here, "..", "..", "..", "templates")
+  ];
+  for (const c of candidates) {
+    if (fs3.existsSync(c) && fs3.statSync(c).isDirectory()) {
+      return c;
+    }
+  }
+  throw new Error(
+    `codebyplan: could not locate templates/ directory. Probed:
+  ${candidates.join(
+      "\n  "
+    )}`
+  );
+}
+
+// src/lib/scaffold-ci-workflow.ts
+function substituteTokens(template, tokens) {
+  let result = template;
+  for (const [token, value] of Object.entries(tokens)) {
+    result = result.split(`{{${token}}}`).join(value);
+  }
+  return result;
+}
+async function detectPnpmVersionFromPackageJson(reader) {
+  try {
+    const raw = await reader.read("package.json");
+    const pkg = JSON.parse(raw);
+    const pm = pkg.packageManager;
+    if (typeof pm === "string" && pm.startsWith("pnpm@")) {
+      const version = pm.slice("pnpm@".length).split("+")[0];
+      if (version && /^\d/.test(version)) {
+        return version;
+      }
+    }
+    return "10";
+  } catch {
+    return "10";
+  }
+}
+async function detectStrictEnforcedFromCiJson(reader) {
+  try {
+    const raw = await reader.read(".codebyplan/ci.json");
+    const parsed = JSON.parse(raw);
+    return parsed.workflow?.strict_check_enforced === true;
+  } catch {
+    return false;
+  }
+}
+async function renderCiWorkflowContent(opts) {
+  const projectDir = path4.resolve(opts?.projectDir ?? process.cwd());
+  const reader = opts?.reader ?? new LocalFsReader(projectDir);
+  const pnpmVersion = opts?.pnpmVersion ?? await detectPnpmVersionFromPackageJson(reader);
+  const nodeVersion = opts?.nodeVersion ?? "22";
+  const strictEnforced = opts?.strictEnforced ?? await detectStrictEnforcedFromCiJson(reader);
+  const templatesDir = opts?.templatesDir ?? resolveTemplatesDir();
+  const templatePath = path4.join(templatesDir, "github-workflows", "ci.yml");
+  if (!fs4.existsSync(templatePath)) {
+    throw new Error(
+      `scaffold-ci-workflow: template not found at ${templatePath}`
+    );
+  }
+  const rawTemplate = fs4.readFileSync(templatePath, "utf-8");
+  return substituteTokens(rawTemplate, {
+    PNPM_VERSION: pnpmVersion,
+    NODE_VERSION: nodeVersion,
+    STRICT_NAME_SUFFIX: strictEnforced ? "" : " (report-only)",
+    STRICT_CONTINUE_ON_ERROR_LINE: strictEnforced ? "" : "\n    continue-on-error: true"
+  });
+}
+async function runScaffoldCiWorkflow(opts) {
+  const dryRun = opts?.dryRun ?? false;
+  const force = opts?.force ?? false;
+  const projectDir = path4.resolve(opts?.projectDir ?? process.cwd());
+  const renderedContent = await renderCiWorkflowContent(opts);
+  const targetPath = path4.join(projectDir, ".github", "workflows", "ci.yml");
+  if (dryRun) {
+    return { status: "dry_run", path: targetPath };
+  }
+  if (fs4.existsSync(targetPath)) {
+    const existingContent = fs4.readFileSync(targetPath, "utf-8");
+    if (existingContent === renderedContent) {
+      return {
+        status: "skipped",
+        path: targetPath,
+        reason: "already up to date"
+      };
+    }
+    if (!force) {
+      throw new Error(
+        `scaffold-ci-workflow: ${targetPath} already exists and differs from the template. Pass --force to overwrite.`
+      );
+    }
+  }
+  const targetDir = path4.dirname(targetPath);
+  fs4.mkdirSync(targetDir, { recursive: true });
+  const tmpPath = targetPath + ".tmp";
+  try {
+    fs4.writeFileSync(tmpPath, renderedContent, "utf-8");
+    fs4.renameSync(tmpPath, targetPath);
+  } catch (err) {
+    try {
+      fs4.unlinkSync(tmpPath);
+    } catch {
+    }
+    throw err;
+  }
+  return { status: "written", path: targetPath };
+}
+export {
+  LocalFsReader,
+  PLATFORM_COMMAND_MAP,
+  buildDefaultCiConfig,
+  detectPlatforms,
+  renderCiWorkflowContent,
+  runCiInit,
+  runScaffoldCiWorkflow
+};