create-task-ops 0.1.3 → 0.1.5

package/README.md

@@ -6,7 +6,7 @@
 
 - 새 리포를 빠르게 시작
 - 기존 리포에 task-ops 구조 주입
-- `tasks/*.md` 와 Task API 계약을 기본으로 포함
+- `tasks/*.md` 와 OrbitOps API 계약을 기본으로 포함
 
 ## 사용 예시
 
@@ -33,7 +33,7 @@ npx create-task-ops add --docs-only
 - `create-task-ops create my-project`
   위와 같지만 명시적으로 create를 적는 형태
 - `create-task-ops add`
-  현재 리포에 task docs + Task API 추가
+  현재 리포에 task docs + OrbitOps API 추가
 - `create-task-ops add --docs-only`
   현재 리포에 문서와 task 파일 규약만 추가
 
@@ -42,10 +42,37 @@ npx create-task-ops add --docs-only
 - `create`
   내부적으로 `full` 템플릿을 사용한다.
 - `add`
-  내부적으로 `api` 템플릿을 사용한다.
+  내부적으로 `api` 수신기 파일만 선택적으로 추가한다.
 - `add --docs-only`
   내부적으로 `docs` 템플릿을 사용한다.
 
+## add가 넣는 파일
+
+`add` 는 기존 리포를 통째로 덮어쓰지 않는다. 기본적으로 아래만 추가한다.
+
+- `tasks/example-task.md`
+- `CLAUDE.md`
+- `AGENT.md`
+- `docs/TASK_API_CONTRACT.md`
+- `docs/DASHBOARD_CONNECTION.md`
+- `app/api/orbitops/health/route.ts`
+- `app/api/orbitops/tasks/route.ts`
+- `app/api/orbitops/tasks/[id]/route.ts`
+- `lib/task-api.ts`
+
+즉 기존 `package.json`, `app/page.tsx`, `app/layout.tsx`, `tsconfig.json` 같은 루트 파일은 건드리지 않는다.
+
+기본 동작에서 기존 `CLAUDE.md`, `AGENT.md`, `tasks/*`, `docs/*` 같은 운영 문서는 스킵한다.
+
+대신 아래 receiver 경로가 이미 있으면 충돌 가능성이 크므로 경고 후 중단한다.
+
+- `app/api/orbitops/health/route.ts`
+- `app/api/orbitops/tasks/route.ts`
+- `app/api/orbitops/tasks/[id]/route.ts`
+- `lib/task-api.ts`
+
+이 receiver 파일까지 강제로 교체하려면 `--force` 를 쓴다.
+
 ## 로컬 테스트
 
 ```bash

package/bin/create-task-ops.js

@@ -8,6 +8,12 @@ import process from "node:process";
 const args = process.argv.slice(2);
 const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const templatesRoot = path.join(packageRoot, "templates");
+const addApiFiles = [
+  "app/api/orbitops/health/route.ts",
+  "app/api/orbitops/tasks/route.ts",
+  "app/api/orbitops/tasks/[id]/route.ts",
+  "lib/task-api.ts",
+];
 
 function parseArgs(argv) {
   const options = {
@@ -80,7 +86,7 @@ function renderTemplate(content, projectName) {
   return content.replaceAll("__PROJECT_NAME__", projectName);
 }
 
-function copyTemplateTree(sourceDir, targetDir, projectName, force) {
+function copyTemplateTree(sourceDir, targetDir, projectName, force, skipExisting = false) {
   mkdirSync(targetDir, { recursive: true });
   const files = listFiles(sourceDir);
 
@@ -90,6 +96,11 @@ function copyTemplateTree(sourceDir, targetDir, projectName, force) {
     const targetFolder = path.dirname(targetPath);
     mkdirSync(targetFolder, { recursive: true });
 
+    if (existsSync(targetPath) && skipExisting && !force) {
+      console.log(`Skipping existing file: ${targetPath}`);
+      continue;
+    }
+
     if (existsSync(targetPath) && !force) {
       console.error(`Refusing to overwrite existing file: ${targetPath}`);
       console.error("Use --force if you want to replace scaffolded files.");
@@ -101,6 +112,32 @@ function copyTemplateTree(sourceDir, targetDir, projectName, force) {
   }
 }
 
+function copySelectedFiles(sourceDir, targetDir, projectName, force, selectedFiles, skipExisting = false) {
+  mkdirSync(targetDir, { recursive: true });
+
+  for (const relativeFile of selectedFiles) {
+    const sourcePath = path.join(sourceDir, relativeFile);
+    const targetPath = path.join(targetDir, relativeFile);
+    const targetFolder = path.dirname(targetPath);
+    mkdirSync(targetFolder, { recursive: true });
+
+    if (existsSync(targetPath) && skipExisting && !force) {
+      console.log(`Skipping existing file: ${targetPath}`);
+      continue;
+    }
+
+    if (existsSync(targetPath) && !force) {
+      console.error(`Refusing to overwrite existing receiver file: ${targetPath}`);
+      console.error("This path is reserved for task API integration.");
+      console.error("Use --force if you want to replace the existing receiver files.");
+      process.exit(1);
+    }
+
+    const content = readFileSync(sourcePath, "utf8");
+    writeFileSync(targetPath, renderTemplate(content, projectName), "utf8");
+  }
+}
+
 function main() {
   const options = parseArgs(args);
   if (options.command === "add") {
@@ -130,8 +167,15 @@ function main() {
   const commonDir = path.join(templatesRoot, "common");
   const modeDir = path.join(templatesRoot, options.mode);
 
-  copyTemplateTree(commonDir, targetDir, projectName, options.force);
-  copyTemplateTree(modeDir, targetDir, projectName, options.force);
+  const skipExistingDocs = options.command === "add";
+
+  copyTemplateTree(commonDir, targetDir, projectName, options.force, skipExistingDocs);
+
+  if (options.command === "add" && options.mode === "api") {
+    copySelectedFiles(modeDir, targetDir, projectName, options.force, addApiFiles, false);
+  } else {
+    copyTemplateTree(modeDir, targetDir, projectName, options.force, skipExistingDocs);
+  }
 
   console.log(`create-task-ops completed`);
   console.log(`target: ${targetDir}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-task-ops",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Next.js-first task-ops scaffold generator for task docs and task APIs",
   "license": "MIT",
   "type": "module",

package/templates/api/app/api/{health → orbitops/health}/route.ts

@@ -6,7 +6,7 @@ export const dynamic = "force-dynamic";
 export async function GET() {
   return NextResponse.json({
     ok: true,
-    service: "__PROJECT_NAME__-task-api",
+    service: "__PROJECT_NAME__-orbitops-api",
     updatedAt: new Date().toISOString(),
   });
 }

package/templates/api/app/page.tsx

@@ -1,8 +1,8 @@
 export default function Home() {
   return (
     <main style={{ padding: 32, fontFamily: "sans-serif" }}>
-      <h1>__PROJECT_NAME__ Task API</h1>
-      <p>`/api/health`, `/api/tasks`, `/api/tasks/:id` 를 통해 중앙 대시보드와 연동한다.</p>
+      <h1>__PROJECT_NAME__ OrbitOps API</h1>
+      <p>`/api/orbitops/health`, `/api/orbitops/tasks`, `/api/orbitops/tasks/:id` 를 통해 중앙 대시보드와 연동한다.</p>
     </main>
   );
 }

package/templates/common/docs/DASHBOARD_CONNECTION.md

@@ -1,12 +1,12 @@
 # Dashboard Connection
 
-이 프로젝트를 중앙 task dashboard에 연결하려면 이 리포의 Task API를 외부에서 읽을 수 있어야 한다.
+이 프로젝트를 중앙 task dashboard에 연결하려면 이 리포의 OrbitOps API를 외부에서 읽을 수 있어야 한다.
 
 ## 제공 엔드포인트
 
-- `GET /api/health`
-- `GET /api/tasks`
-- `GET /api/tasks/:id`
+- `GET /api/orbitops/health`
+- `GET /api/orbitops/tasks`
+- `GET /api/orbitops/tasks/:id`
 
 ## 로컬 개발 연결 예시
 
@@ -30,6 +30,6 @@
 ## 체크리스트
 
 1. `tasks/*.md` 가 최신 상태인가
-2. `/api/tasks` 응답이 정상인가
+2. `/api/orbitops/tasks` 응답이 정상인가
 3. source `id` 와 `label` 이 명확한가
 4. 필요하면 API key 또는 reverse proxy 를 설정했는가

package/templates/common/docs/TASK_API_CONTRACT.md

@@ -1,12 +1,12 @@
-# Task API Contract
+# OrbitOps API Contract
 
 중앙 대시보드가 외부 리포를 읽기 위해 기대하는 최소 계약이다.
 
 ## Endpoints
 
-- `GET /api/health`
-- `GET /api/tasks`
-- `GET /api/tasks/:id`
+- `GET /api/orbitops/health`
+- `GET /api/orbitops/tasks`
+- `GET /api/orbitops/tasks/:id`
 
 ## Task Fields
 

package/templates/docs/README.md

@@ -13,4 +13,4 @@ Task-ops 문서 모드로 생성된 프로젝트다.
 
 1. `tasks/example-task.md` 를 실제 작업으로 교체
 2. 리포 규약에 맞게 `CLAUDE.md`, `AGENT.md` 조정
-3. 필요해지면 Next.js Task API를 추가
+3. 필요해지면 Next.js OrbitOps API를 추가

package/templates/full/app/api/{health → orbitops/health}/route.ts

@@ -6,7 +6,7 @@ export const dynamic = "force-dynamic";
 export async function GET() {
   return NextResponse.json({
     ok: true,
-    service: "__PROJECT_NAME__-task-api",
+    service: "__PROJECT_NAME__-orbitops-api",
     updatedAt: new Date().toISOString(),
   });
 }

package/templates/full/app/page.tsx

@@ -7,9 +7,9 @@ export default async function Home() {
     <main className="page-shell">
       <section className="hero">
         <div className="hero-card">
-          <span className="eyebrow">Task Ops</span>
+          <span className="eyebrow">OrbitOps</span>
           <h1>__PROJECT_NAME__</h1>
-          <p>이 프로젝트는 task-first 운영 구조와 Next.js 기반 Task API를 기본으로 시작한다.</p>
+          <p>이 프로젝트는 task-first 운영 구조와 Next.js 기반 OrbitOps API를 기본으로 시작한다.</p>
         </div>
       </section>
       <section className="task-grid">