agentic-dev 0.2.9 → 0.2.11

package/lib/scaffold.mjs

@@ -43,7 +43,8 @@ function copyDirectoryContents(sourceRoot, destinationRoot) {
 }
 
 function fetchPage(url) {
-  const token = process.env.GH_TOKEN || process.env.GITHUB_TOKEN || process.env.AGENTIC_GITHUB_TOKEN;
+  const token =
+    process.env.GH_TOKEN || process.env.GITHUB_TOKEN || process.env.AGENTIC_GITHUB_TOKEN;
   return fetch(url, {
     headers: {
       Accept: "application/vnd.github+json",
@@ -58,8 +59,13 @@ export function parseArgs(argv) {
   const options = {
     command: "init",
     targetDir: "",
+    projectName: "",
     template: "",
     owner: DEFAULT_TEMPLATE_OWNER,
+    appMode: "",
+    aiProviders: [],
+    githubAuthMode: "",
+    githubPat: "",
     force: false,
     yes: false,
     skipBootstrap: false,
@@ -76,9 +82,30 @@ export function parseArgs(argv) {
       case "-t":
         options.template = args.shift() ?? "";
         break;
+      case "--project-name":
+        options.projectName = args.shift() ?? "";
+        break;
       case "--owner":
         options.owner = args.shift() ?? DEFAULT_TEMPLATE_OWNER;
         break;
+      case "--app-mode":
+        options.appMode = args.shift() ?? "";
+        break;
+      case "--providers":
+      case "--provider": {
+        const value = args.shift() ?? "";
+        options.aiProviders = value
+          .split(",")
+          .map((entry) => entry.trim())
+          .filter(Boolean);
+        break;
+      }
+      case "--github-auth":
+        options.githubAuthMode = args.shift() ?? "";
+        break;
+      case "--github-pat":
+        options.githubPat = args.shift() ?? "";
+        break;
       case "--force":
         options.force = true;
         break;
@@ -115,10 +142,16 @@ export function usage() {
     "  npx agentic-dev",
     "  npx agentic-dev init my-app",
     "  npx agentic-dev init my-app --template template-web --yes",
+    "  npx agentic-dev init my-app --template template-web --project-name my-app --providers codex,claude",
     "",
     "Options:",
     "  --template, -t     Template repo name or suffix to use",
+    "  --project-name     Project name written into scaffold metadata",
     "  --owner            GitHub owner for template-* repos (default: say828)",
+    "  --app-mode         App mode: fullstack, frontend, backend",
+    "  --providers        Comma-separated AI providers: codex, claude, ollama",
+    "  --github-auth      GitHub auth mode: public, env, pat",
+    "  --github-pat       GitHub PAT for this run only",
     "  --force            Allow scaffolding into a non-empty directory",
     "  --yes, -y          Skip interactive prompts",
     "  --skip-bootstrap   Copy the template but skip install/bootstrap",
@@ -177,6 +210,22 @@ export async function fetchTemplateRepos({ owner = DEFAULT_TEMPLATE_OWNER } = {}
   return repos;
 }
 
+function updateJsonFile(filePath, updater) {
+  if (!fs.existsSync(filePath)) {
+    return;
+  }
+
+  let current = {};
+  try {
+    current = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+  } catch (error) {
+    return;
+  }
+
+  const next = updater(current);
+  fs.writeFileSync(filePath, `${JSON.stringify(next, null, 2)}\n`);
+}
+
 export function resolveTemplateRepo(input, repos) {
   const normalized = (input || "").trim();
   if (!normalized) {
@@ -323,7 +372,51 @@ function validateTemplateRepoContents(destinationRoot, templateRepo) {
   }
 }
 
-function runInstallSteps(destinationRoot, bootstrapTarget) {
+function writeSetupConfig(destinationRoot, setupSelections = {}) {
+  const outputDir = path.join(destinationRoot, ".agentic-dev");
+  fs.mkdirSync(outputDir, { recursive: true });
+  const outputPath = path.join(outputDir, "setup.json");
+
+  const setupConfig = {
+    project_name: setupSelections.projectName || path.basename(destinationRoot),
+    template_repo: setupSelections.templateRepo || "",
+    template_owner: setupSelections.owner || DEFAULT_TEMPLATE_OWNER,
+    app_mode: setupSelections.appMode || "fullstack",
+    ai_providers: Array.isArray(setupSelections.aiProviders) ? setupSelections.aiProviders : [],
+    github_auth_mode: setupSelections.githubAuthMode || "public",
+    github_pat_supplied: Boolean(setupSelections.githubPat),
+    skip_bootstrap: Boolean(setupSelections.skipBootstrap),
+  };
+
+  fs.writeFileSync(outputPath, `${JSON.stringify(setupConfig, null, 2)}\n`);
+}
+
+function applyProviderSelections(destinationRoot, providers = []) {
+  if (providers.length === 0) {
+    return;
+  }
+
+  if (!providers.includes("claude")) {
+    fs.rmSync(path.join(destinationRoot, ".claude"), { recursive: true, force: true });
+  }
+
+  if (!providers.includes("codex")) {
+    fs.rmSync(path.join(destinationRoot, ".codex"), { recursive: true, force: true });
+  }
+}
+
+function applyProjectMetadata(destinationRoot, setupSelections = {}) {
+  if (!setupSelections.projectName) {
+    return;
+  }
+
+  updateJsonFile(path.join(destinationRoot, ".claude", "workspace-config.json"), (current) => ({
+    ...current,
+    nickname: setupSelections.projectName,
+  }));
+}
+
+function runInstallSteps(destinationRoot, bootstrapTarget, { installBrowser = true } = {}) {
   maybeCreateEnvFile(destinationRoot);
 
   const pnpmCommand = ensurePnpm();
@@ -334,7 +427,7 @@ function runInstallSteps(destinationRoot, bootstrapTarget) {
 
   const executedSteps = ["pnpm install"];
 
-  if (bootstrapTarget) {
+  if (bootstrapTarget && installBrowser) {
     runCommand(
       pnpmCommand[0],
       [
@@ -395,14 +488,24 @@ export function scaffoldFromTemplateRepo({ destinationRoot, templateRepo }) {
 export function installTemplateRepo({
   destinationRoot,
   templateRepo,
+  setupSelections = {},
   skipBootstrap = false,
 }) {
   scaffoldFromTemplateRepo({ destinationRoot, templateRepo });
+  applyProviderSelections(destinationRoot, setupSelections.aiProviders);
+  applyProjectMetadata(destinationRoot, setupSelections);
+  writeSetupConfig(destinationRoot, {
+    ...setupSelections,
+    templateRepo: templateRepo.name,
+    skipBootstrap,
+  });
   validateTemplateRepoContents(destinationRoot, templateRepo);
   const bootstrapTarget = resolveBootstrapTarget(destinationRoot);
+  const effectiveSkipBootstrap = skipBootstrap || setupSelections.appMode === "backend";
+  const installBrowser = setupSelections.appMode !== "backend";
 
-  const executedSteps = runInstallSteps(destinationRoot, bootstrapTarget);
-  if (!skipBootstrap) {
+  const executedSteps = runInstallSteps(destinationRoot, bootstrapTarget, { installBrowser });
+  if (!effectiveSkipBootstrap) {
     executedSteps.push(...runBootstrapStep(destinationRoot, bootstrapTarget));
   }
   const bootstrapHint = bootstrapTarget
@@ -412,6 +515,6 @@ export function installTemplateRepo({
     destinationRoot,
     templateRepo: templateRepo.name,
     executedSteps,
-    nextSteps: skipBootstrap ? [bootstrapHint] : [],
+    nextSteps: effectiveSkipBootstrap ? [bootstrapHint] : [],
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-dev",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "Scaffold a public say828/template-* repo and run install/bootstrap automatically.",
   "type": "module",
   "packageManager": "pnpm@10.32.0",

package/client/admin/.dockerignore

@@ -1,3 +0,0 @@
-node_modules
-dist
-.env

package/client/admin/.env.example

@@ -1 +0,0 @@
-VITE_API_BASE_URL=http://127.0.0.1:8000/api/v1

package/client/admin/Dockerfile

@@ -1,16 +0,0 @@
-FROM node:20-slim
-
-WORKDIR /app
-
-COPY pnpm-lock.yaml pnpm-workspace.yaml ./
-COPY client/admin/package.json ./client/admin/package.json
-
-RUN npm install -g pnpm@10.32.0 && pnpm install --filter @do4ai/client-admin-template...
-
-COPY . .
-
-WORKDIR /app/client/admin
-
-EXPOSE 4000
-
-CMD ["pnpm", "dev", "--host", "0.0.0.0", "--port", "4000"]

package/client/admin/Dockerfile.dev

@@ -1,18 +0,0 @@
-FROM node:20-slim
-
-WORKDIR /app
-
-RUN npm install -g pnpm@10.32.0
-
-COPY pnpm-lock.yaml pnpm-workspace.yaml ./
-COPY client/admin/package.json ./client/admin/package.json
-
-RUN pnpm install --frozen-lockfile --filter @do4ai/client-admin-template...
-
-COPY client/admin ./client/admin
-
-WORKDIR /app/client/admin
-
-EXPOSE 4000
-
-CMD ["sh", "-lc", "pnpm exec vite --host 0.0.0.0 --port ${PORT:-4000}"]

package/client/admin/README.md

@@ -1,20 +0,0 @@
-# admin
-
-운영 콘솔형 관리자 UI 보일러플레이트다.
-
-포함 패턴:
-
-- 좌측 sidebar + 상단 topbar
-- route 이동 대신 열리는 알림 drawer
-- 목록형 운영 테이블
-- modal/drawer를 제품 shell에서 직접 제어하는 구조
-- CSS variable 기반 parity-friendly token surface
-
-시작:
-
-```bash
-npm install
-npm run dev
-```
-
-기본 DEV 포트는 `4000`이다.

package/client/admin/index.html

@@ -1,12 +0,0 @@
-<!doctype html>
-<html lang="ko">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>client-admin template</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
-</html>

package/client/admin/package.json

@@ -1,41 +0,0 @@
-{
-  "name": "@do4ai/client-admin-template",
-  "private": true,
-  "version": "0.1.0",
-  "type": "module",
-  "packageManager": "pnpm@10.32.0",
-  "scripts": {
-    "dev": "vite --host 0.0.0.0 --port 4000",
-    "build": "tsc -b && vite build",
-    "preview": "vite preview --host 0.0.0.0 --port 4400",
-    "ui:parity:init": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/init_frontend_parity.sh ../.. admin",
-    "ui:parity:bootstrap": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/bootstrap_frontend_parity.sh ../.. admin",
-    "ui:parity:scaffold": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh scaffold ../.. admin",
-    "ui:parity:materialize-references": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh materialize_references ../.. admin",
-    "ui:parity:route-gap": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh route_gap ../.. admin",
-    "ui:parity:proof": "bash ../../sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh proof ../.. admin"
-  },
-  "dependencies": {
-    "class-variance-authority": "^0.7.1",
-    "clsx": "^2.1.1",
-    "lucide-react": "^0.576.0",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
-    "react-router-dom": "^6.30.1",
-    "tailwind-merge": "^3.5.0"
-  },
-  "devDependencies": {
-    "@playwright/test": "^1.58.2",
-    "@types/react": "^18.3.18",
-    "@types/react-dom": "^18.3.5",
-    "@vitejs/plugin-react": "^4.7.0",
-    "autoprefixer": "^10.4.21",
-    "pixelmatch": "^7.1.0",
-    "pngjs": "^7.0.0",
-    "postcss": "^8.5.3",
-    "tailwindcss": "^3.4.17",
-    "typescript": "^5.8.3",
-    "vite": "^5.4.19",
-    "yaml": "^2.8.1"
-  }
-}

package/client/admin/postcss.config.js

@@ -1,6 +0,0 @@
-export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-};

package/client/admin/scripts/ui-parity-admin-adapter.mjs

@@ -1,65 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const scriptDir = path.dirname(fileURLToPath(import.meta.url));
-const screens = JSON.parse(
-  fs.readFileSync(path.resolve(scriptDir, "../src/lib/specScreens.json"), "utf8"),
-);
-const routes = JSON.parse(
-  fs.readFileSync(path.resolve(scriptDir, "../src/lib/specRouteCatalog.json"), "utf8"),
-);
-
-const routeMap = new Map(routes.map((entry) => [entry.id, entry.route]));
-
-export default {
-  service: "templates-admin",
-  targetBaseUrl: "http://127.0.0.1:4400",
-  viewport: {
-    width: 1440,
-    height: 1024,
-  },
-  screens: screens.map((screen) => ({
-    id: screen.id,
-    title: screen.title,
-    route: routeMap.get(screen.id) ?? "/",
-    referenceImage: `sdd/03_verify/10_test/ui_parity/reference/${screen.id}.png`,
-    readySelector: "body",
-    readyTimeoutMs: 10000,
-    tags: ["template", "admin"],
-  })),
-  async preparePage(page, { route }) {
-    await page.route("**/auth/me", async (routeRequest) => {
-      await routeRequest.fulfill({
-        status: 200,
-        contentType: "application/json",
-        body: JSON.stringify({
-          id: "tmpl-admin",
-          name: "Template Admin",
-          email: "admin@example.com",
-          role: "admin",
-        }),
-      });
-    });
-    await page.addInitScript(() => {
-      window.localStorage.setItem(
-        "admin.auth.token",
-        JSON.stringify({
-          access_token: "template-access-token",
-          token_type: "bearer",
-        }),
-      );
-    });
-    if (route === "/login") {
-      await page.addInitScript(() => {
-        window.localStorage.removeItem("admin.auth.token");
-      });
-    }
-  },
-  async waitForReady(page) {
-    await page.waitForLoadState("networkidle");
-  },
-  async resolveMaskRects() {
-    return [];
-  },
-};

package/client/admin/src/api/alerts.ts

@@ -1,33 +0,0 @@
-import { apiGet, apiPost } from "@/api/client";
-
-export interface AlertItem {
-  id: string;
-  source: string;
-  title: string;
-  message: string;
-  tone: string;
-  created_at: string;
-  read: boolean;
-}
-
-export interface AlertsPayload {
-  unread_count: number;
-  items: AlertItem[];
-}
-
-export interface AlertsReadAllResult {
-  updated_count: number;
-  unread_count: number;
-}
-
-export function fetchAlerts(accessToken: string) {
-  return apiGet<AlertsPayload>("/alerts", { accessToken });
-}
-
-export function markAlertRead(alertId: string, accessToken: string) {
-  return apiPost<AlertItem>(`/alerts/${alertId}/read`, { accessToken });
-}
-
-export function markAllAlertsRead(accessToken: string) {
-  return apiPost<AlertsReadAllResult>("/alerts/read-all", { accessToken });
-}

package/client/admin/src/api/client.ts

@@ -1,71 +0,0 @@
-const API_BASE_URL =
-  (import.meta.env.VITE_API_BASE_URL as string | undefined)?.replace(/\/$/, "") ??
-  "";
-
-interface RequestOptions {
-  accessToken?: string;
-}
-
-interface WriteOptions extends RequestOptions {
-  body?: unknown;
-}
-
-async function readJson<T>(response: Response): Promise<T> {
-  if (!response.ok) {
-    let message = "Request failed";
-    try {
-      const data = (await response.json()) as { detail?: string };
-      if (typeof data.detail === "string" && data.detail.length > 0) {
-        message = data.detail;
-      }
-    } catch {
-      message = response.statusText || message;
-    }
-    throw new Error(message);
-  }
-
-  return (await response.json()) as T;
-}
-
-export async function apiGet<T>(
-  path: string,
-  options?: RequestOptions,
-): Promise<T> {
-  const response = await fetch(`${API_BASE_URL}${path}`, {
-    headers: options?.accessToken
-      ? { Authorization: `Bearer ${options.accessToken}` }
-      : undefined,
-  });
-
-  return readJson<T>(response);
-}
-
-async function writeJson<T>(
-  method: "POST" | "PATCH",
-  path: string,
-  options?: WriteOptions,
-): Promise<T> {
-  const headers: Record<string, string> = {
-    "Content-Type": "application/json",
-  };
-
-  if (options?.accessToken) {
-    headers.Authorization = `Bearer ${options.accessToken}`;
-  }
-
-  const response = await fetch(`${API_BASE_URL}${path}`, {
-    method,
-    headers,
-    body: JSON.stringify(options?.body ?? {}),
-  });
-
-  return readJson<T>(response);
-}
-
-export function apiPost<T>(path: string, options?: WriteOptions): Promise<T> {
-  return writeJson("POST", path, options);
-}
-
-export function apiPatch<T>(path: string, options?: WriteOptions): Promise<T> {
-  return writeJson("PATCH", path, options);
-}

package/client/admin/src/api/orders.ts

@@ -1,33 +0,0 @@
-import { apiGet } from "@/api/client";
-
-export interface DashboardCard {
-  label: string;
-  value: string;
-  tone?: string | null;
-}
-
-export interface StageStatus {
-  label: string;
-  value: string;
-}
-
-export interface AdminOverviewResponse {
-  cards: DashboardCard[];
-  stage_statuses: StageStatus[];
-}
-
-export interface AdminQueueItem {
-  order_id: string;
-  product_name: string;
-  customer_name: string;
-  status: string;
-  sla: string;
-}
-
-export function fetchAdminOverview(accessToken: string) {
-  return apiGet<AdminOverviewResponse>("/orders/admin/overview", { accessToken });
-}
-
-export function fetchAdminQueue(accessToken: string) {
-  return apiGet<AdminQueueItem[]>("/orders/admin/queue", { accessToken });
-}

package/client/admin/src/api/support.ts

@@ -1,11 +0,0 @@
-import { apiGet } from "@/api/client";
-
-export interface SupportFaq {
-  id: string;
-  question: string;
-  visibility: string;
-}
-
-export function fetchSupportFaqs(accessToken: string) {
-  return apiGet<SupportFaq[]>("/support/faqs", { accessToken });
-}

package/client/admin/src/app/App.tsx

@@ -1,23 +0,0 @@
-import { Route, Routes } from "react-router-dom";
-
-import { ProtectedRoute } from "@/auth/ProtectedRoute";
-import { AdminShell } from "@/components/AdminShell";
-import { AdminDashboardPage } from "@/pages/AdminDashboardPage";
-import { AdminLoginPage } from "@/pages/AdminLoginPage";
-import { AdminQueuePage } from "@/pages/AdminQueuePage";
-import { AdminSupportPage } from "@/pages/AdminSupportPage";
-
-export function App() {
-  return (
-    <Routes>
-      <Route path="/login" element={<AdminLoginPage />} />
-      <Route element={<ProtectedRoute />}>
-        <Route element={<AdminShell />}>
-          <Route path="/" element={<AdminDashboardPage />} />
-          <Route path="/queue" element={<AdminQueuePage />} />
-          <Route path="/support" element={<AdminSupportPage />} />
-        </Route>
-      </Route>
-    </Routes>
-  );
-}

package/client/admin/src/auth/AuthProvider.tsx

@@ -1,122 +0,0 @@
-import { createContext, useContext, useEffect, useMemo, useState, type ReactNode } from "react";
-
-import { getMe, login as loginRequest } from "@/auth/auth-client";
-import type { AuthToken, AuthUser, LoginCommand } from "@/auth/types";
-
-const STORAGE_KEY = "admin.auth.token";
-
-interface AuthContextValue {
-  user: AuthUser | null;
-  token: AuthToken | null;
-  initializing: boolean;
-  authenticating: boolean;
-  login: (command: LoginCommand) => Promise<void>;
-  logout: () => void;
-}
-
-const AuthContext = createContext<AuthContextValue | undefined>(undefined);
-
-function readStoredToken(): AuthToken | null {
-  const raw = window.localStorage.getItem(STORAGE_KEY);
-  if (!raw) {
-    return null;
-  }
-
-  try {
-    return JSON.parse(raw) as AuthToken;
-  } catch {
-    window.localStorage.removeItem(STORAGE_KEY);
-    return null;
-  }
-}
-
-function storeToken(token: AuthToken | null) {
-  if (token) {
-    window.localStorage.setItem(STORAGE_KEY, JSON.stringify(token));
-    return;
-  }
-
-  window.localStorage.removeItem(STORAGE_KEY);
-}
-
-export function AuthProvider({ children }: { children: ReactNode }) {
-  const [token, setToken] = useState<AuthToken | null>(() => readStoredToken());
-  const [user, setUser] = useState<AuthUser | null>(null);
-  const [initializing, setInitializing] = useState(true);
-  const [authenticating, setAuthenticating] = useState(false);
-
-  useEffect(() => {
-    let cancelled = false;
-
-    async function bootstrap() {
-      if (!token) {
-        setUser(null);
-        setInitializing(false);
-        return;
-      }
-
-      try {
-        const currentUser = await getMe(token.access_token);
-        if (!cancelled) {
-          setUser(currentUser);
-        }
-      } catch {
-        if (!cancelled) {
-          setToken(null);
-          setUser(null);
-          storeToken(null);
-        }
-      } finally {
-        if (!cancelled) {
-          setInitializing(false);
-        }
-      }
-    }
-
-    void bootstrap();
-
-    return () => {
-      cancelled = true;
-    };
-  }, [token]);
-
-  const value = useMemo<AuthContextValue>(
-    () => ({
-      user,
-      token,
-      initializing,
-      authenticating,
-      async login(command) {
-        setAuthenticating(true);
-        try {
-          const nextToken = await loginRequest(command);
-          storeToken(nextToken);
-          setToken(nextToken);
-          const currentUser = await getMe(nextToken.access_token);
-          setUser(currentUser);
-        } finally {
-          setAuthenticating(false);
-          setInitializing(false);
-        }
-      },
-      logout() {
-        storeToken(null);
-        setToken(null);
-        setUser(null);
-        setInitializing(false);
-      },
-    }),
-    [authenticating, initializing, token, user],
-  );
-
-  return <AuthContext.Provider value={value}>{children}</AuthContext.Provider>;
-}
-
-export function useAuth() {
-  const context = useContext(AuthContext);
-  if (!context) {
-    throw new Error("useAuth must be used within an AuthProvider");
-  }
-
-  return context;
-}