chiwaa 0.1.1 → 0.1.3

package/README.md

@@ -18,6 +18,8 @@ npx chiwaa deploy
 | `chiwaa list` | 내 사이트 목록 |
 | `chiwaa versions` | 남아 있는 버전 |
 | `chiwaa rollback [버전]` | 한 단계 전 또는 지정 버전으로 되돌리기 |
+| `chiwaa db` · `db on` · `db create <표>` · `db rows <표>` | 사이트 DB(문의·방명록 등 글 저장) — 켜기·표 만들기·글 보기 |
+| `chiwaa agent` | AI 도구용 안내(AGENTS.md·CLAUDE.md) 만들기 — 처음 deploy 때 자동 |
 | `chiwaa whoami` / `logout` | 계정 확인 / 로그아웃 |
 
 ## AI 도구(Claude Code·Codex·Cursor)에서

package/bin/chiwaa.js

@@ -27,7 +27,7 @@ const OUTPUTS = [
   ["parcel", "dist"],
 ];
 // 그대로 올리는 사이트에서 빼는 것
-const SKIP = new Set([".git", "node_modules", ".chiwaa.json", ".DS_Store", "Thumbs.db", ".vercel", ".netlify"]);
+const SKIP = new Set([".git", "node_modules", ".chiwaa.json", ".DS_Store", "Thumbs.db", ".vercel", ".netlify", "AGENTS.md", "CLAUDE.md"]);
 
 const c = {
   dim: (s) => (TTY ? `\x1b[2m${s}\x1b[0m` : s),
@@ -92,7 +92,7 @@ function parseArgs(argv) {
     if (a.startsWith("--")) {
       const [k, v] = a.slice(2).split("=", 2);
       if (v !== undefined) out[k] = v;
-      else if (["name", "token", "dir"].includes(k) && argv[i + 1] && !argv[i + 1].startsWith("-")) out[k] = argv[++i];
+      else if (["name", "token", "dir", "read", "write", "page"].includes(k) && argv[i + 1] && !argv[i + 1].startsWith("-")) out[k] = argv[++i];
       else out[k] = true;
     } else if (a === "-y") out.yes = true;
     else if (a === "-h") out.help = true;
@@ -307,9 +307,61 @@ function linkSite(dir, site) {
   if (site.source === "github")
     fail(`${site.domain} 은 깃허브(${site.repo})로 배포하는 사이트입니다. CLI 로는 다른 이름을 쓰세요: --name <새 이름>`);
   fs.writeFileSync(path.join(dir, LINK_FILE), JSON.stringify({ site: site.name }, null, 2) + "\n");
+  writeAgentDoc(dir, site.name, false);
   return site;
 }
 
+// ---------- AGENTS.md (AI 코딩 도구가 스스로 읽는 안내) ----------
+// Codex·Cursor 등은 AGENTS.md, Claude Code 는 CLAUDE.md 를 읽는다. 사용자가 쓴 내용은 두고 chiwaa 구간만 넣거나 바꾼다.
+const AGENT_START = "<!-- chiwaa:start -->";
+const AGENT_END = "<!-- chiwaa:end -->";
+
+function agentSection(name) {
+  return `${AGENT_START}
+## chiwaa 배포 (이 폴더는 ${name}.chiwaa.com 사이트)
+
+- 배포: \`npx chiwaa deploy -y\` — 끝나면 주소가 나온다. 잘못 올렸으면 \`npx chiwaa rollback\`.
+- 이 폴더는 \`.chiwaa.json\` 으로 사이트가 정해져 있다. 다른 이름(--name)으로 올리지 않는다.
+- 정적 사이트만 된다(HTML·CSS·JS, Vite·React·Vue·Astro·Next export 빌드). PHP·Express 같은 서버 코드는 안 된다.
+- 글 저장(문의·방명록·게시판)은 사이트 DB: \`npx chiwaa db on\` → \`npx chiwaa db create <표> --read public|owner --write public|owner\`.
+  - 문의·신청서처럼 개인정보가 든 표는 반드시 \`--read owner\`. 사이트에서 안 읽힌다고 public 으로 바꾸지 않는다.
+  - 방문자 글은 화면에 \`textContent\` 로만 넣는다. 비밀번호는 \`<input type="password">\` 로 받는다.
+- 로그인 토큰(~/.chiwaa/config.json, CHIWAA_TOKEN)은 출력하거나 파일·저장소에 적지 않는다.
+- 자세한 규칙·예시: https://chiwaa.kr/llms.txt — 처음 작업하거나 헷갈리면 먼저 읽는다.
+${AGENT_END}`;
+}
+
+// 바뀐 파일 이름 목록을 돌려준다
+function writeAgentDoc(dir, name, loud) {
+  const changed = [];
+  const agents = path.join(dir, "AGENTS.md");
+  const block = agentSection(name);
+  let text = fs.existsSync(agents) ? fs.readFileSync(agents, "utf8") : "";
+  const re = new RegExp(`${AGENT_START}[\\s\\S]*?${AGENT_END}`);
+  const next = re.test(text) ? text.replace(re, block) : (text ? `${text.replace(/\s*$/, "")}\n\n${block}\n` : `${block}\n`);
+  if (next !== text) {
+    fs.writeFileSync(agents, next);
+    changed.push("AGENTS.md");
+  }
+  // Claude Code 는 CLAUDE.md 를 읽는다 — 없을 때만 AGENTS.md 를 불러오는 한 줄짜리를 만든다
+  const claude = path.join(dir, "CLAUDE.md");
+  if (!fs.existsSync(claude)) {
+    fs.writeFileSync(claude, "@AGENTS.md\n");
+    changed.push("CLAUDE.md");
+  } else if (!/@AGENTS\.md|chiwaa:start/.test(fs.readFileSync(claude, "utf8"))) {
+    fs.appendFileSync(claude, "\n@AGENTS.md\n");
+    changed.push("CLAUDE.md");
+  }
+  if (changed.length) console.log(c.dim(`AI 도구용 안내를 ${changed.join("·")} 에 적었습니다(사이트에는 올라가지 않음).`));
+  else if (loud) console.log("AI 도구용 안내가 이미 최신입니다(AGENTS.md).");
+  return changed;
+}
+
+async function agent(args) {
+  const name = await siteName(args);
+  writeAgentDoc(process.cwd(), name, true);
+}
+
 // ---------- deploy ----------
 async function deploy(args) {
   const dir = path.resolve(args._[1] || ".");
@@ -369,6 +421,115 @@ async function rollback(args) {
   console.log(c.green("✓"), r.data.message);
 }
 
+// ---------- db (사이트 DB) ----------
+// 데이터가 지워지는 일(끄기·표 지우기·글 지우기)은 일부러 없다 — chiwaa.kr 사이트 화면에서만 한다.
+const RULE_KO = { public: "누구나", owner: "나만(chiwaa.kr 화면)" };
+
+function snippet(table) {
+  return `<!-- 글 보내기(저장) -->
+<script src="/_chiwaa/data/v1/chiwaa.js"></script>
+<form data-chiwaa-table="${table}" data-chiwaa-done="보냈습니다. 감사합니다.">
+  <input name="이름" placeholder="이름" required>
+  <textarea name="내용" placeholder="내용" required></textarea>
+  <input name="_pw" type="password" placeholder="비밀번호(내 글 수정·삭제용, 4자 이상)">
+  <input name="_hp" style="display:none" tabindex="-1" autocomplete="off">
+  <button type="submit">보내기</button>
+</form>
+
+<!-- 글 목록 보기(읽기 권한이 public 일 때) -->
+<ul id="${table}-list"></ul>
+<script>
+  chiwaa.table("${table}").list({ limit: 20 }).then(function (items) {
+    var ul = document.getElementById("${table}-list");
+    items.forEach(function (item) {
+      var li = document.createElement("li");
+      li.textContent = (item["이름"] || "") + ": " + (item["내용"] || "");  // 방문자 글은 textContent 로만
+      ul.appendChild(li);
+    });
+  });
+</script>
+
+<!-- 스크립트로 직접:
+  chiwaa.table("${table}").add({ 제목, 내용, _pw })        글쓰기(_pw 를 넣으면 그 비밀번호로 수정·삭제 가능)
+  chiwaa.table("${table}").list({ limit: 20, before: 마지막id })  목록(최신순, 다음 쪽은 before)
+  chiwaa.table("${table}").get(id)                       글 하나(상세 화면)
+  chiwaa.table("${table}").update(id, { 제목, 내용 }, 비밀번호)   글쓴이가 고치기
+  chiwaa.table("${table}").remove(id, 비밀번호)            글쓴이가 지우기
+  댓글은 표를 하나 더 만들고(예: comments) 글 번호를 함께 저장 → .list({ where: { post_id: id } }) -->`;
+}
+
+function ruleArg(v, label) {
+  if (v === undefined || v === true) return undefined;
+  if (!["public", "owner"].includes(v)) fail(`${label} 는 public(누구나) 또는 owner(나만) 입니다: ${v}`);
+  return v;
+}
+
+async function db(args) {
+  const sub = args._[1] || "status";
+  const name = await siteName(args);
+  const base = `/api/v1/sites/${encodeURIComponent(name)}/db`;
+  const table = args._[2];
+  const needTable = () => {
+    if (!table) fail(`표 이름을 적어 주세요. 예: npx chiwaa db ${sub} guestbook`);
+    if (!/^[a-z][a-z0-9_]{0,39}$/.test(table)) fail(`표 이름은 영문 소문자로 시작하고 영문 소문자·숫자·밑줄(_) 40자까지입니다: ${table}`);
+    return table;
+  };
+
+  if (sub === "status") {
+    const r = await api("GET", base);
+    if (r.status !== 200) fail(r.data.error || "DB 정보를 받지 못했습니다.");
+    if (!r.data.enabled) return console.log(`${name}.chiwaa.com 의 DB는 꺼져 있습니다. 켜려면: npx chiwaa db on`);
+    console.log(c.bold(`${name}.chiwaa.com DB`), c.dim(`· 쓴 양 ${(r.data.bytes / 1048576).toFixed(1)}MB / ${r.data.limit_mb}MB · 오늘 저장 ${r.data.writes_today}/${r.data.limit_writes}`));
+    if (!r.data.tables.length) return console.log("아직 표가 없습니다. 예: npx chiwaa db create guestbook --read public --write public");
+    for (const t of r.data.tables)
+      console.log(`  ${t.name}  ${c.dim(`읽기 ${RULE_KO[t.read_rule]} · 쓰기 ${RULE_KO[t.write_rule]} · 글 ${t.records}개`)}`);
+    return;
+  }
+  if (sub === "on") {
+    const r = await api("POST", `${base}/on`);
+    if (r.status !== 200) fail(r.data.error || "DB를 켜지 못했습니다.");
+    return console.log(c.green("✓"), r.data.message);
+  }
+  if (sub === "create") {
+    needTable();
+    const read = ruleArg(args.read, "--read") || "owner";
+    const write = ruleArg(args.write, "--write") || "public";
+    const r = await api("POST", `${base}/tables`, { body: { table, read, write } });
+    if (r.status !== 201) fail(r.data.error || "표를 만들지 못했습니다.");
+    console.log(c.green("✓"), `「${table}」 표를 만들었습니다. 읽기 ${RULE_KO[read]} · 쓰기 ${RULE_KO[write]}`);
+    console.log(c.dim("\n사이트 HTML 에 아래를 넣고 다시 deploy 하면 됩니다. 저장된 글은 npx chiwaa db rows " + table + "\n"));
+    return console.log(snippet(table));
+  }
+  if (sub === "rules") {
+    needTable();
+    const read = ruleArg(args.read, "--read");
+    const write = ruleArg(args.write, "--write");
+    if (!read && !write) fail("바꿀 권한을 --read public|owner 나 --write public|owner 로 알려 주세요.");
+    const r = await api("POST", `${base}/tables/${table}/rules`, { body: { read, write } });
+    if (r.status !== 200) fail(r.data.error || "권한을 바꾸지 못했습니다.");
+    return console.log(c.green("✓"), `「${table}」 읽기 ${RULE_KO[r.data.read_rule]} · 쓰기 ${RULE_KO[r.data.write_rule]}`);
+  }
+  if (sub === "rows") {
+    needTable();
+    const page = Math.max(parseInt(args.page, 10) || 1, 1);
+    const r = await api("GET", `${base}/tables/${table}/rows?page=${page}`);
+    if (r.status !== 200) fail(r.data.error || "글을 받지 못했습니다.");
+    const items = r.data.items || [];
+    if (!items.length) return console.log(page > 1 ? "이 쪽에는 글이 없습니다." : "아직 저장된 글이 없습니다.");
+    for (const it of items) {
+      const { id, created_at, _editable, ...rest } = it;
+      const d = new Date(created_at);
+      const p2 = (n) => String(n).padStart(2, "0");
+      const when = isNaN(d) ? String(created_at) : `${d.getFullYear()}-${p2(d.getMonth() + 1)}-${p2(d.getDate())} ${p2(d.getHours())}:${p2(d.getMinutes())}`;
+      console.log(`${c.dim(`#${id} ${when}`)}  ${JSON.stringify(rest)}`);
+    }
+    if (items.length >= 20) console.log(c.dim(`다음 쪽: npx chiwaa db rows ${table} --page ${page + 1}`));
+    return;
+  }
+  if (sub === "code") return console.log(snippet(needTable()));
+  fail(`모르는 db 명령입니다: ${sub}\n  쓸 수 있는 것: status · on · create · rules · rows · code`);
+}
+
 async function whoami() {
   const r = await api("GET", "/api/v1/me");
   if (r.status !== 200) fail(r.data.error || "로그인 정보를 받지 못했습니다.");
@@ -393,6 +554,15 @@ const HELP = `chiwaa ${VERSION} — chiwaa.kr 에 사이트를 바로 올립니
   chiwaa list                 내 사이트 목록
   chiwaa versions             남아 있는 버전 보기
   chiwaa rollback [버전]      한 단계 전(또는 지정 버전)으로 되돌리기
+  chiwaa db                   사이트 DB 상태·표 목록
+  chiwaa db on                DB 켜기
+  chiwaa db create <표>       표 만들기 (--read public|owner, --write public|owner)
+                              예: chiwaa db create guestbook --read public --write public
+  chiwaa db rules <표>        읽기·쓰기 권한 바꾸기
+  chiwaa db rows <표>         저장된 글 보기 (--page 2)
+  chiwaa db code <표>         사이트에 붙일 코드 다시 보기
+  chiwaa agent                AI 도구용 안내(AGENTS.md·CLAUDE.md)를 만들거나 새로 고침
+                              (처음 deploy 할 때 자동으로 만든다)
   chiwaa whoami               로그인한 계정
   chiwaa logout               로그아웃
 
@@ -404,7 +574,7 @@ async function main() {
   const cmd = args._[0];
   if (args.version) return console.log(VERSION);
   if (args.help || !cmd || cmd === "help") return console.log(HELP);
-  const cmds = { deploy, login, list, ls: list, versions, rollback, whoami, logout };
+  const cmds = { deploy, login, list, ls: list, versions, rollback, db, agent, whoami, logout };
   if (!cmds[cmd]) fail(`모르는 명령입니다: ${cmd}\n\n${HELP}`);
   await cmds[cmd](args);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chiwaa",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "chiwaa.kr 에 사이트를 터미널에서 바로 올리는 도구",
   "bin": {
     "chiwaa": "bin/chiwaa.js"