agentic-dev 0.2.10 → 0.2.12

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,41 +1,27 @@
 {
   "name": "agentic-dev",
-  "version": "0.2.10",
-  "description": "Scaffold a public say828/template-* repo and run install/bootstrap automatically.",
+  "version": "0.2.12",
+  "description": "GitHub-based installer CLI for public say828/template-* repos.",
   "type": "module",
   "packageManager": "pnpm@10.32.0",
   "bin": {
     "agentic-dev": "./bin/agentic-dev.mjs"
   },
   "files": [
-    ".agent",
-    ".claude",
-    ".codex",
     "bin",
-    "client",
-    "infra",
     "lib",
-    "scripts",
-    "sdd",
-    "server",
-    ".dockerignore",
-    ".env.example",
-    ".gitignore",
-    "AGENTS.md",
-    "README.md",
-    "SDD_SKILL.md",
-    "compose.yml",
-    "pnpm-workspace.yaml"
+    "README.md"
   ],
   "scripts": {
-    "smoke:init": "node ./bin/agentic-dev.mjs init ./.tmp-agentic-smoke --template template-fullstack-mono --yes --force"
+    "smoke:init": "node ./bin/agentic-dev.mjs init ./.tmp-agentic-smoke --template template-web --app-mode backend --providers codex --yes --force"
   },
   "keywords": [
     "agentic",
-    "template",
     "scaffold",
-    "vite",
-    "react"
+    "cli",
+    "github",
+    "template",
+    "orchestration"
   ],
   "license": "UNLICENSED"
 }

package/.agent/prd.json

@@ -1,29 +0,0 @@
-{
-  "project": "template-agentic-program",
-  "goal": "이 파일은 Ralph loop starter scaffold다. downstream 저장소는 현재 작업 scope에 맞는 story set으로 즉시 교체한다.",
-  "updated_at": "2026-03-19T00:00:00+09:00",
-  "stories": [
-    {
-      "id": "TEMPLATE-ALIGN-001",
-      "title": "Replace template PRD scaffold with repository-specific delivery stories",
-      "priority": 1,
-      "status": "pending",
-      "scope": [
-        ".agent/prd.json",
-        ".agent/prompt.md",
-        "sdd/02_plan",
-        "sdd/03_build",
-        "sdd/03_verify"
-      ],
-      "validation": [
-        "jq . .agent/prd.json"
-      ],
-      "done_when": [
-        "Template placeholder stories are replaced with repository-specific work items.",
-        "Validation commands point at the active repository program.",
-        "progress.txt contains the current operator note."
-      ],
-      "blockers": []
-    }
-  ]
-}

package/.agent/progress.txt

@@ -1 +0,0 @@
-2026-03-19 scaffold initialized for canonical template Ralph loop.

package/.agent/prompt.md

@@ -1,21 +0,0 @@
-You are running one Ralph iteration in this repository.
-
-Rules:
-1. Read `.agent/prd.json` and `.agent/progress.txt`.
-2. Work only on the requested story id.
-3. Lock one reproduction or validation command before editing.
-4. Make one focused change set toward the requested story.
-5. Re-run the requested validation commands immediately.
-6. Update the matching `sdd/02_plan`, `sdd/03_build`, and `sdd/03_verify` current-state artifacts when scope changes.
-7. Update `.agent/prd.json` story status and append one short line to `.agent/progress.txt`.
-8. Stop after this iteration and report:
-   - story id
-   - validation status
-   - files changed
-   - next story or blocker
-9. If the caller provided a completion promise token and the story is truly complete in this iteration, print that token exactly once.
-
-Guardrails:
-- Do not create a parallel `docs/` tree when `sdd/` exists.
-- Do not leave execution-history narrative inside `sdd/03_build`.
-- Do not claim completion without validation evidence.

package/.agent/ralph-loop-state.json

@@ -1,13 +0,0 @@
-{
-  "updated_at": "2026-03-19T00:00:00Z",
-  "story_id": "",
-  "max_iterations": 12,
-  "current_iteration": 0,
-  "status": "idle",
-  "completion_promise": "STORY_COMPLETE",
-  "promise_seen": false,
-  "last_exit_code": 0,
-  "prompt_snapshot": "",
-  "output_file": "",
-  "changed_files": []
-}

package/.agent/ralph-supervisor-state.json

@@ -1,12 +0,0 @@
-{
-  "updated_at": "2026-03-19T00:00:00Z",
-  "max_iterations": 1000,
-  "story_iterations": 1,
-  "current_iteration": 0,
-  "active_story": "",
-  "child_exit_code": 0,
-  "child_status": "idle",
-  "repeat_count": 0,
-  "status": "idle",
-  "run_dir": ""
-}

package/.agent/ralph-supervisor.sh

@@ -1,238 +0,0 @@
-#!/usr/bin/env bash
-
-set -euo pipefail
-
-ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-AGENT_DIR="$ROOT_DIR/.agent"
-PRD_FILE="$AGENT_DIR/prd.json"
-PROGRESS_FILE="$AGENT_DIR/progress.txt"
-RUNS_DIR="$AGENT_DIR/runs"
-STATE_FILE="$AGENT_DIR/ralph-supervisor-state.json"
-RALPH_RUNNER="$AGENT_DIR/ralph.sh"
-
-max_iterations=1000
-story_iterations=1
-completion_promise="STORY_COMPLETE"
-run_label=""
-sleep_seconds=0
-dry_run=0
-
-usage() {
-  cat <<'EOF'
-Usage:
-  .agent/ralph-supervisor.sh [options]
-
-Options:
-  --max-iterations N        Maximum global iterations across all stories. Default: 1000
-  --story-iterations N      Iterations per selected story invocation. Default: 1
-  --completion-promise TXT  Promise token passed to child Ralph runner
-  --run-label LABEL         Optional label suffix for this supervisor run
-  --sleep-seconds N         Sleep between global iterations
-  --dry-run                 Use child runner in dry-run mode
-  -h, --help                Show help
-
-Behavior:
-  - Picks the next pending/in_progress story from .agent/prd.json each global iteration
-  - Invokes .agent/ralph.sh for one focused child loop
-  - Stops when all stories complete, when max iterations are exhausted,
-    or when the same story/status pair repeats 3 times with no new signal
-  - Writes state to .agent/ralph-supervisor-state.json and appends monitor lines to .agent/progress.txt
-EOF
-}
-
-require_file() {
-  local file_path="$1"
-  if [[ ! -f "$file_path" ]]; then
-    echo "Missing required file: $file_path" >&2
-    exit 1
-  fi
-}
-
-select_story() {
-  jq -r '
-    .stories
-    | map(select(.status == "in_progress" or .status == "pending"))
-    | sort_by(.priority)
-    | .[0].id // empty
-  ' "$PRD_FILE"
-}
-
-read_story_status() {
-  local story_id="$1"
-  jq -r --arg id "$story_id" '.stories[] | select(.id == $id) | .status // "missing"' "$PRD_FILE"
-}
-
-write_state() {
-  local iteration="$1"
-  local active_story="$2"
-  local child_exit="$3"
-  local child_status="$4"
-  local repeat_count="$5"
-  local status="$6"
-  local run_dir="$7"
-
-  cat >"$STATE_FILE" <<EOF
-{
-  "updated_at": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
-  "max_iterations": $max_iterations,
-  "story_iterations": $story_iterations,
-  "current_iteration": $iteration,
-  "active_story": "$active_story",
-  "child_exit_code": $child_exit,
-  "child_status": "$child_status",
-  "repeat_count": $repeat_count,
-  "status": "$status",
-  "run_dir": "${run_dir#$ROOT_DIR/}"
-}
-EOF
-}
-
-main() {
-  require_file "$PRD_FILE"
-  require_file "$PROGRESS_FILE"
-  require_file "$RALPH_RUNNER"
-
-  while [[ $# -gt 0 ]]; do
-    case "$1" in
-      --max-iterations)
-        max_iterations="${2:-}"
-        shift 2
-        ;;
-      --story-iterations)
-        story_iterations="${2:-}"
-        shift 2
-        ;;
-      --completion-promise)
-        completion_promise="${2:-}"
-        shift 2
-        ;;
-      --run-label)
-        run_label="${2:-}"
-        shift 2
-        ;;
-      --sleep-seconds)
-        sleep_seconds="${2:-}"
-        shift 2
-        ;;
-      --dry-run)
-        dry_run=1
-        shift
-        ;;
-      -h|--help)
-        usage
-        exit 0
-        ;;
-      *)
-        echo "Unknown argument: $1" >&2
-        usage >&2
-        exit 2
-        ;;
-    esac
-  done
-
-  if ! [[ "$max_iterations" =~ ^[0-9]+$ ]] || [[ "$max_iterations" -lt 1 ]]; then
-    echo "--max-iterations must be a positive integer" >&2
-    exit 2
-  fi
-  if ! [[ "$story_iterations" =~ ^[0-9]+$ ]] || [[ "$story_iterations" -lt 1 ]]; then
-    echo "--story-iterations must be a positive integer" >&2
-    exit 2
-  fi
-  if ! [[ "$sleep_seconds" =~ ^[0-9]+$ ]] || [[ "$sleep_seconds" -lt 0 ]]; then
-    echo "--sleep-seconds must be a non-negative integer" >&2
-    exit 2
-  fi
-
-  mkdir -p "$RUNS_DIR"
-  local run_id
-  run_id="$(date +%Y%m%d-%H%M%S)"
-  if [[ -n "$run_label" ]]; then
-    run_id="$run_id-$run_label"
-  fi
-  local supervisor_run_dir="$RUNS_DIR/supervisor-$run_id"
-  mkdir -p "$supervisor_run_dir"
-
-  local previous_signature=""
-  local repeat_count=0
-  local final_status="max_iterations_reached"
-
-  local iteration=1
-  while [[ "$iteration" -le "$max_iterations" ]]; do
-    local story_id
-    story_id="$(select_story)"
-    if [[ -z "$story_id" ]]; then
-      final_status="all_stories_completed"
-      write_state "$iteration" "" 0 "none" 0 "$final_status" "$supervisor_run_dir"
-      echo "$(date +%F) supervisor all-stories-complete iteration=$iteration" >>"$PROGRESS_FILE"
-      break
-    fi
-
-    echo "[supervisor] iteration $iteration/$max_iterations story=$story_id"
-
-    local child_args=(
-      --story-id "$story_id"
-      --max-iterations "$story_iterations"
-      --completion-promise "$completion_promise"
-      --run-label "supervisor-$iteration-$story_id"
-    )
-    if [[ $dry_run -eq 1 ]]; then
-      child_args+=(--dry-run)
-    fi
-
-    set +e
-    "$RALPH_RUNNER" "${child_args[@]}"
-    local child_exit=$?
-    set -e
-
-    local child_status="unknown"
-    if [[ -f "$AGENT_DIR/ralph-loop-state.json" ]]; then
-      child_status="$(jq -r '.status // "unknown"' "$AGENT_DIR/ralph-loop-state.json")"
-    fi
-
-    local story_status
-    story_status="$(read_story_status "$story_id")"
-    local signature="$story_id:$child_status:$story_status"
-    if [[ "$signature" == "$previous_signature" ]]; then
-      repeat_count=$((repeat_count + 1))
-    else
-      repeat_count=1
-      previous_signature="$signature"
-    fi
-
-    if [[ "$story_status" == "completed" || "$child_status" == "completed" ]]; then
-      final_status="story_completed"
-    elif [[ "$repeat_count" -ge 3 ]]; then
-      final_status="stopped_same_signal_3x"
-    elif [[ "$child_status" == "iteration_pass_no_promise" || "$child_status" == "dry_run" || "$child_exit" -eq 0 ]]; then
-      final_status="iteration_ok"
-    else
-      final_status="iteration_failed"
-    fi
-
-    write_state "$iteration" "$story_id" "$child_exit" "$child_status" "$repeat_count" "$final_status" "$supervisor_run_dir"
-    echo "$(date +%F) supervisor iteration-$iteration story=$story_id child_status=$child_status story_status=$story_status repeat=$repeat_count exit=$child_exit" >>"$PROGRESS_FILE"
-
-    if [[ "$final_status" == "stopped_same_signal_3x" ]]; then
-      break
-    fi
-
-    iteration=$((iteration + 1))
-    if [[ "$iteration" -le "$max_iterations" && "$sleep_seconds" -gt 0 ]]; then
-      sleep "$sleep_seconds"
-    fi
-  done
-
-  echo "[supervisor] final_status=$final_status run_dir=${supervisor_run_dir#$ROOT_DIR/}"
-  if [[ "$final_status" == "all_stories_completed" ]]; then
-    exit 0
-  fi
-  if [[ "$final_status" == "stopped_same_signal_3x" ]]; then
-    exit 1
-  fi
-  if [[ "$final_status" == "max_iterations_reached" ]]; then
-    exit 1
-  fi
-  exit 0
-}
-
-main "$@"