@gaonjs/cli 0.1.0

package/README.md

@@ -0,0 +1,9 @@
+# @gaonjs/cli
+
+Gaon CLI 구현 — 제너레이터·스캐폴딩. M1 에서는 로드맵 출력 스텁입니다.
+
+> ⚠️ **개발 중 (v0.1.0 스텁).** 모든 명령은 `--json` 출력을 함께 제공합니다.
+
+개발자는 이 패키지를 직접 설치하지 않습니다 — [`gaon`](https://www.npmjs.com/package/gaon) 하나만 설치하세요.
+
+- 홈페이지 / 문서: https://gaonjs.dev

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export interface RoadmapReport {
+    readonly name: "gaon";
+    readonly version: string;
+    readonly stage: "stub";
+    readonly homepage: string;
+    readonly docs: string;
+    readonly milestones: readonly {
+        id: string;
+        title: string;
+        status: string;
+    }[];
+}
+/** `--json` 출력용 구조화 리포트. */
+export declare function roadmapReport(): RoadmapReport;
+/** 사람이 읽는 로드맵 텍스트. */
+export declare function renderRoadmap(): string;
+/** CLI 진입점. argv 는 실행 인자(process.argv.slice(2))를 받는다. */
+export declare function runCli(argv: readonly string[]): void;

package/dist/index.js

@@ -0,0 +1,75 @@
+/**
+ * @gaonjs/cli — Gaon CLI 구현.
+ *
+ * M1(현재) 스텁: 로드맵·개발 상태·참여 안내를 출력한다.
+ * 모든 명령은 `--json` 출력을 함께 제공한다 (CLAUDE.md §4).
+ * 실제 제너레이터·스캐폴딩은 로드맵 이후 마일스톤에서 구현한다.
+ */
+import { MILESTONES, VERSION, HOMEPAGE } from "@gaonjs/core";
+/** `--json` 출력용 구조화 리포트. */
+export function roadmapReport() {
+    return {
+        name: "gaon",
+        version: VERSION,
+        stage: "stub",
+        homepage: HOMEPAGE,
+        docs: HOMEPAGE,
+        milestones: MILESTONES.map((m) => ({ id: m.id, title: m.title, status: m.status })),
+    };
+}
+/** 사람이 읽는 로드맵 텍스트. */
+export function renderRoadmap() {
+    const lines = [];
+    lines.push("");
+    lines.push(`  Gaon (가온) — AI가 개발을 가장 잘하는 Node.js 풀스택 웹 프레임웍`);
+    lines.push(`  v${VERSION} · 개발 중 (스텁) · ${HOMEPAGE}`);
+    lines.push("");
+    lines.push("  이 패키지는 아직 개발 초기 단계입니다. 런타임 기능은 아직 없고,");
+    lines.push("  자리(스코프·이름)를 잡아 두기 위한 동작하는 스텁입니다.");
+    lines.push("");
+    lines.push("  로드맵");
+    lines.push("  ──────");
+    for (const m of MILESTONES) {
+        const mark = m.status === "in-progress" ? "▶" : "·";
+        const tag = m.status === "in-progress" ? " (진행 중)" : "";
+        lines.push(`   ${mark} ${m.id}  ${m.title}${tag}`);
+    }
+    lines.push("");
+    lines.push("  참여 · 소식");
+    lines.push("  ──────────");
+    lines.push(`   문서 / 진행 상황:  ${HOMEPAGE}`);
+    lines.push(`   JSON 출력:         gaon --json`);
+    lines.push("");
+    return lines.join("\n");
+}
+function renderHelp() {
+    return [
+        "",
+        "  gaon — Gaon 프레임웍 CLI (v" + VERSION + ", 스텁)",
+        "",
+        "  사용법:",
+        "    gaon               로드맵과 개발 상태를 출력",
+        "    gaon --json        같은 정보를 JSON 으로 출력",
+        "    gaon --version     버전 출력",
+        "    gaon --help        이 도움말",
+        "",
+        "  문서: " + HOMEPAGE,
+        "",
+    ].join("\n");
+}
+/** CLI 진입점. argv 는 실행 인자(process.argv.slice(2))를 받는다. */
+export function runCli(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        process.stdout.write(renderHelp() + "\n");
+        return;
+    }
+    if (argv.includes("--version") || argv.includes("-v")) {
+        process.stdout.write(VERSION + "\n");
+        return;
+    }
+    if (argv.includes("--json")) {
+        process.stdout.write(JSON.stringify(roadmapReport(), null, 2) + "\n");
+        return;
+    }
+    process.stdout.write(renderRoadmap() + "\n");
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@gaonjs/cli",
+  "version": "0.1.0",
+  "description": "Gaon CLI 구현: 제너레이터·스캐폴딩·로드맵 출력 (M1 스텁)",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://gaonjs.dev",
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@gaonjs/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json"
+  }
+}