agentic-dev 0.2.11 → 0.2.12

package/README.md

@@ -1,69 +1,76 @@
 # agentic-dev
 
-`agentic-dev`는 `say828`의 공개 `template-*` 레포를 설치하는 scaffold CLI다.
+`agentic-dev`는 `say828/template-*` 레포를 GitHub에서 조회해 설치하는 npm CLI다.
 
-## 사용법
+이 저장소 자체에는 더 이상 template runtime payload를 두지 않는다.
+
+- 없음: `client/*`
+- 없음: `server/*`
+- 없음: `infra/*`
+- 없음: root `sdd/*`
+- 실제 앱 구조와 toolchain은 각 `template-*` 레포가 소유
+
+## Usage
 
 ```bash
 npx agentic-dev
 ```
 
-또는 비대화형:
+비대화형 예시:
 
 ```bash
 npx agentic-dev init my-app --template template-fullstack-mono --yes
-npx agentic-dev init my-app --template template-web --yes --skip-bootstrap
+npx agentic-dev init my-app --template template-web --project-name my-app --app-mode backend --providers codex --yes
 ```
 
-## 동작
-
-1. GitHub에서 공개 `say828/template-*` 레포 목록을 조회한다.
-2. interactive TTY에서는 wizard 화면을 순서대로 보여준다.
-   - `←/→`: 이전/다음 화면 이동
-   - `↑/↓`: 고정 선택지 이동
-   - `Space`: AI providers 다중 선택 토글
-   - `Enter`: 현재 화면 값 확정
-3. wizard는 최소한 아래 정보를 모두 먼저 받는다.
-   - project directory
-   - project name
-   - GitHub auth mode
-   - GitHub PAT (`auth mode = pat`일 때만)
-   - template repo
-   - app mode
-   - AI providers
-   - non-empty directory 진행 여부가 필요하면 그 확인
-4. 모든 입력이 끝나면 실행 계획 요약과 최종 확인 화면을 보여준다.
-5. 최종 확인 전에는 clone, install, bootstrap을 시작하지 않는다.
-6. 확인 후에만 선택한 레포를 새 디렉터리로 복제한다.
-7. `.env.example`이 있으면 `.env`를 자동 생성한다.
-8. `pnpm install`을 자동 실행한다.
-9. 템플릿의 `repo-contract.json`에서 `frontend.default_target`을 읽는다.
-10. `app mode != backend`이면 그 target에 대해 `playwright install chromium`과 parity bootstrap을 실행한다.
-11. `AI providers` 선택에 따라 `.codex`, `.claude` 디렉터리를 정리하고 `.agentic-dev/setup.json`에 wizard 입력값을 기록한다.
-
-`frontend.default_target`이 있으면 multi-surface 템플릿도 그대로 지원한다. 예를 들어 `template-fullstack-mono`는 `client/web`과 `client/admin`을 함께 포함하지만 기본 bootstrap 대상은 `web`이다.
-
-## 예시
+## Wizard Flow
 
-```bash
-mkdir my-fullstack-app
-cd my-fullstack-app
-npx agentic-dev init . --template template-fullstack-mono --yes
-```
+interactive TTY에서는 모든 입력을 먼저 받는다.
+
+- `Project directory`
+- `Project name`
+- `GitHub auth mode`
+- `GitHub PAT` (`auth mode = pat`일 때만)
+- `Template repo`
+- `App mode`
+- `AI providers`
+- non-empty directory 진행 여부가 필요하면 그 확인
+- 최종 확인
+
+조작:
+
+- `←/→`: 이전/다음 화면 이동
+- `↑/↓`: 고정 선택지 이동
+- `Space`: AI providers 토글
+- `Enter`: 현재 화면 값 확정
+
+중요:
+
+- 최종 확인 전에는 clone, install, bootstrap을 실행하지 않는다.
+- 모든 선택이 끝난 뒤 실행 계획 요약을 보여주고, 그 다음에만 명령을 실행한다.
+
+## What Runs After Confirm
 
-설치가 끝나면 CLI가 아래까지 자동 처리한다.
+확인 후 CLI는 선택한 `template-*` 레포 안에서 필요한 명령만 실행한다.
 
-- `.env.example -> .env`
-- `pnpm install`
-- `pnpm --dir client/web exec playwright install chromium`
-- `bash sdd/99_toolchain/01_automation/agentic-dev/bootstrap_frontend_parity.sh . web`
-- `.agentic-dev/setup.json` 생성
+1. template repo clone
+2. `.env.example -> .env` 복사
+3. `pnpm install`
+4. `app mode != backend`이면 Playwright Chromium 설치
+5. `app mode != backend`이면 template repo의 parity/bootstrap 스크립트 실행
+6. `.agentic-dev/setup.json` 기록
+7. 선택한 AI provider에 맞춰 `.codex`, `.claude` 디렉터리 정리
 
-## 옵션
+## Options
 
 - `--template`, `-t`: template repo name 또는 suffix
+- `--project-name`: scaffold metadata에 기록할 프로젝트 이름
 - `--owner`: GitHub owner. 기본값 `say828`
+- `--app-mode`: `fullstack`, `frontend`, `backend`
+- `--providers`: comma-separated provider list. `codex`, `claude`, `ollama`
+- `--github-auth`: `public`, `env`, `pat`
+- `--github-pat`: 현재 실행에만 쓸 GitHub PAT
 - `--force`: 비어 있지 않은 디렉터리 허용
-- `--yes`, `-y`: interactive prompt 생략
+- `--yes`, `-y`: interactive wizard 생략
 - `--skip-bootstrap`: install까지만 하고 bootstrap은 생략
 - `--help`, `-h`: 도움말 출력

package/package.json

@@ -1,41 +1,27 @@
 {
   "name": "agentic-dev",
-  "version": "0.2.11",
-  "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 "$@"