@hanmariyang/drafting 1.6.2

package/bin/drafting.mjs

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+/*
+ * drafting — 터미널에서 데몬을 띄우고 브라우저를 연다.
+ * 서버가 "터미널 프로세스" 컨텍스트로 돌기 때문에:
+ *   · 구독(CLI): 이 터미널의 claude 로그인/키체인을 그대로 사용 → GUI 앱과 달리 막히지 않는다.
+ *   · BYOK(env): ANTHROPIC_API_KEY / OPENAI_API_KEY / OPENROUTER_API_KEY / LITELLM_API_KEY 자동 인식(마법사 불필요).
+ * 사용: drafting serve [--port 8477] [--no-open]
+ */
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+import { mkdirSync, existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { randomBytes } from 'node:crypto';
+
+const args = process.argv.slice(2);
+const cmd = args[0] && !args[0].startsWith('-') ? args[0] : 'serve';
+if (cmd === 'help' || cmd === '--help' || (cmd !== 'serve')) {
+  console.log('사용법: drafting serve [--port 8477] [--no-open]');
+  process.exit(cmd === 'help' || cmd === '--help' ? 0 : 1);
+}
+const flag = (n, d) => { const i = args.indexOf(n); return i >= 0 && args[i + 1] ? args[i + 1] : d; };
+const noOpen = args.includes('--no-open');
+
+const here = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = join(here, '..'); // 설치본 루트 — db/schema.sql·web/dist·api/templates 해석 기준
+const entry = join(pkgRoot, 'api', 'dist', 'index.js');
+if (!existsSync(entry)) {
+  console.error(`빌드 산출물이 없습니다: ${entry}\n먼저 'npm run build' 하세요.`);
+  process.exit(1);
+}
+const port = flag('--port', process.env.PORT || '8477');
+const dataDir = process.env.DRAFTING_HOME || join(homedir(), '.drafting');
+mkdirSync(dataDir, { recursive: true });
+
+// APP_ENCRYPTION_KEY 자동 생성·보관 (사용자가 관리하지 않게). env 로 주면 그걸 우선.
+let encKey = process.env.APP_ENCRYPTION_KEY;
+if (!encKey) {
+  const p = join(dataDir, '.enckey');
+  if (existsSync(p)) encKey = readFileSync(p, 'utf8').trim();
+  else { encKey = randomBytes(32).toString('base64'); writeFileSync(p, encKey, { mode: 0o600 }); }
+}
+
+const env = {
+  ...process.env,
+  DRAFTING_ROOT: process.env.DRAFTING_ROOT || pkgRoot,
+  PORT: port,
+  HOST: process.env.HOST || '127.0.0.1',
+  DATABASE_PATH: process.env.DATABASE_PATH || join(dataDir, 'drafting.sqlite'),
+  APP_ENCRYPTION_KEY: encKey,
+};
+const url = `http://127.0.0.1:${port}`;
+const envKeys = ['ANTHROPIC_API_KEY', 'OPENAI_API_KEY', 'OPENROUTER_API_KEY', 'LITELLM_API_KEY'].filter((k) => process.env[k]);
+console.log('\n  Drafting — 터미널 모드');
+console.log(`  · 데이터   ${env.DATABASE_PATH}`);
+console.log(`  · 구독(CLI) 이 터미널의 claude 로그인/키체인 사용`);
+console.log(`  · BYOK(env) ${envKeys.length ? envKeys.join(', ') : '없음 (설정에서 등록하거나 env 로 주입)'}`);
+console.log(`  · 주소     ${url}\n`);
+
+const child = spawn(process.execPath, [entry], { env, stdio: 'inherit' });
+
+if (!noOpen) {
+  const openBrowser = (u) => {
+    const c = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'cmd' : 'xdg-open';
+    const a = process.platform === 'win32' ? ['/c', 'start', '', u] : [u];
+    spawn(c, a, { stdio: 'ignore', detached: true }).unref();
+  };
+  const t0 = Date.now();
+  const poll = setInterval(async () => {
+    try {
+      const r = await fetch(`${url}/api/health`);
+      if (r.ok) { clearInterval(poll); openBrowser(url); }
+    } catch { /* not up yet */ }
+    if (Date.now() - t0 > 15000) clearInterval(poll);
+  }, 400);
+}
+child.on('exit', (code) => process.exit(code ?? 0));
+process.on('SIGINT', () => child.kill('SIGINT'));
+process.on('SIGTERM', () => child.kill('SIGTERM'));

package/db/schema.sql

@@ -0,0 +1,154 @@
+-- PlanForge schema (SQLite / node:sqlite). Applied idempotently on boot.
+-- Data model: Project · Document · Section · InterviewSession (+ supporting tables).
+
+PRAGMA journal_mode = WAL;
+PRAGMA foreign_keys = ON;
+
+CREATE TABLE IF NOT EXISTS projects (
+  id          TEXT PRIMARY KEY,
+  name        TEXT NOT NULL,
+  description TEXT NOT NULL DEFAULT '',
+  created_at  TEXT NOT NULL,
+  updated_at  TEXT NOT NULL
+);
+
+-- Documents form a chain: PRD -> feature-spec -> ia -> user-flow (parent_document_id).
+CREATE TABLE IF NOT EXISTS documents (
+  id                      TEXT PRIMARY KEY,
+  project_id              TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  type                    TEXT NOT NULL,                       -- prd | feature-spec | ia | user-flow
+  title                   TEXT NOT NULL,
+  status                  TEXT NOT NULL DEFAULT 'draft',       -- draft | streaming | ready
+  parent_document_id      TEXT REFERENCES documents(id) ON DELETE SET NULL,
+  version                 INTEGER NOT NULL DEFAULT 0,          -- bumps on save/regenerate/restore
+  context_stale           INTEGER NOT NULL DEFAULT 0,          -- 1 = parent changed, needs refresh (P-01)
+  context_source_version  INTEGER,                             -- parent version last inherited
+  context_pending_version INTEGER,                             -- parent version awaiting inheritance
+  created_at              TEXT NOT NULL,
+  updated_at              TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_documents_project ON documents(project_id);
+CREATE INDEX IF NOT EXISTS idx_documents_parent  ON documents(parent_document_id);
+
+CREATE TABLE IF NOT EXISTS sections (
+  id          TEXT PRIMARY KEY,
+  document_id TEXT NOT NULL REFERENCES documents(id) ON DELETE CASCADE,
+  position    INTEGER NOT NULL,
+  heading     TEXT NOT NULL DEFAULT '',
+  body        TEXT NOT NULL DEFAULT '',
+  -- AI-authored content is always a PROPOSAL until accepted (SYSTEM.md §0.1).
+  -- Only 'accepted' sections are documents / appear in exports & shares (§0.2).
+  status      TEXT NOT NULL DEFAULT 'proposed',  -- proposed | accepted | rejected
+  created_at  TEXT NOT NULL,
+  updated_at  TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_sections_document ON sections(document_id);
+
+-- AI suggestions (proposals). Every proposal carries a source/basis (§0.3) and
+-- is handled 3 ways: accept / reject / rewrite (§0.4). A suggestion may target a
+-- section, or the whole document (section_id NULL — e.g. a "missing" question).
+CREATE TABLE IF NOT EXISTS suggestions (
+  id          TEXT PRIMARY KEY,
+  document_id TEXT NOT NULL REFERENCES documents(id) ON DELETE CASCADE,
+  section_id  TEXT REFERENCES sections(id) ON DELETE CASCADE,   -- nullable = document-level
+  -- Structure-doc suggestions target a plan_item instead of a section (v0.4+).
+  -- Forward-references plan_items (created below); SQLite resolves at insert time.
+  target_item_id TEXT REFERENCES plan_items(id) ON DELETE CASCADE,
+  kind        TEXT NOT NULL,          -- add | revise | delete | question | stale | lint
+  title       TEXT NOT NULL DEFAULT '',
+  body        TEXT NOT NULL DEFAULT '',   -- human explanation
+  quote_before TEXT NOT NULL DEFAULT '',  -- current text (revise/delete)
+  quote_after  TEXT NOT NULL DEFAULT '',  -- proposed text (add/revise)
+  source      TEXT NOT NULL DEFAULT '',   -- basis: "Q3" | "PRD §2" | lint code "W-ORPHAN-SPEC"
+  status      TEXT NOT NULL DEFAULT 'open',  -- open | accepted | rejected | dismissed
+  created_at  TEXT NOT NULL,
+  resolved_at TEXT
+);
+CREATE INDEX IF NOT EXISTS idx_suggestions_document ON suggestions(document_id);
+CREATE INDEX IF NOT EXISTS idx_suggestions_section  ON suggestions(section_id);
+CREATE INDEX IF NOT EXISTS idx_suggestions_status   ON suggestions(document_id, status);
+
+-- Plan items — the rows of the STRUCTURE documents (feature-spec · IA · user-flow).
+-- They coexist with sections (which back the prose PRD). AI never assigns ref_id
+-- (server-numbered, §1.2); AI output is always 'proposed' until accepted (§0.1).
+CREATE TABLE IF NOT EXISTS plan_items (
+  id           TEXT PRIMARY KEY,
+  document_id  TEXT NOT NULL REFERENCES documents(id) ON DELETE CASCADE,
+  parent_id    TEXT REFERENCES plan_items(id) ON DELETE CASCADE,
+  kind         TEXT NOT NULL,          -- feature-group|feature|page|flow|step
+  ref_id       TEXT NOT NULL,          -- F-01|F-01-3|PG-01|FLOW-01|FLOW-01.2 (server)
+  position     INTEGER NOT NULL,
+  title        TEXT NOT NULL,
+  body         TEXT NOT NULL DEFAULT '',   -- acceptance criteria etc (newline-separated)
+  meta         TEXT NOT NULL DEFAULT '{}', -- JSON: links/priority/page_type/branch (§1.1)
+  status       TEXT NOT NULL DEFAULT 'proposed',  -- proposed|accepted|rejected
+  created_at   TEXT NOT NULL,
+  updated_at   TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_plan_items_document ON plan_items(document_id);
+CREATE INDEX IF NOT EXISTS idx_plan_items_parent   ON plan_items(parent_id);
+
+CREATE TABLE IF NOT EXISTS interview_sessions (
+  id            TEXT PRIMARY KEY,
+  document_id   TEXT NOT NULL REFERENCES documents(id) ON DELETE CASCADE,
+  template_id   TEXT NOT NULL,
+  status        TEXT NOT NULL DEFAULT 'active',   -- active | complete
+  current_index INTEGER NOT NULL DEFAULT 0,
+  answers       TEXT NOT NULL DEFAULT '[]',       -- JSON [{questionId, question, answer}]
+  created_at    TEXT NOT NULL,
+  updated_at    TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_sessions_document ON interview_sessions(document_id);
+
+-- BYOK keys — stored ENCRYPTED only (AES-256-GCM). Never plaintext (G-01).
+CREATE TABLE IF NOT EXISTS api_keys (
+  id         TEXT PRIMARY KEY,
+  provider   TEXT NOT NULL UNIQUE,   -- anthropic | openai | openrouter
+  label      TEXT NOT NULL DEFAULT '',
+  ciphertext TEXT NOT NULL,          -- base64
+  iv         TEXT NOT NULL,          -- base64
+  auth_tag   TEXT NOT NULL,          -- base64
+  last4      TEXT NOT NULL DEFAULT '',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS document_versions (
+  id          TEXT PRIMARY KEY,
+  document_id TEXT NOT NULL REFERENCES documents(id) ON DELETE CASCADE,
+  version     INTEGER NOT NULL,
+  event_type  TEXT NOT NULL,          -- save | context_inherit | restore
+  snapshot    TEXT NOT NULL,          -- JSON {title, sections:[{heading,body,position}]}
+  meta        TEXT NOT NULL DEFAULT '{}',
+  note        TEXT NOT NULL DEFAULT '',
+  created_at  TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_versions_document ON document_versions(document_id);
+
+CREATE TABLE IF NOT EXISTS share_links (
+  id          TEXT PRIMARY KEY,
+  document_id TEXT NOT NULL REFERENCES documents(id) ON DELETE CASCADE,
+  token       TEXT NOT NULL UNIQUE,
+  expires_at  TEXT,                   -- ISO 8601, NULL = never
+  revoked     INTEGER NOT NULL DEFAULT 0,
+  created_at  TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_share_token ON share_links(token);
+
+CREATE TABLE IF NOT EXISTS settings (
+  key        TEXT PRIMARY KEY,
+  value      TEXT NOT NULL,           -- JSON
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS mockups (
+  id          TEXT PRIMARY KEY,
+  project_id  TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  page_ref    TEXT NOT NULL,          -- IA 페이지 ref_id (PG-nn)
+  html        TEXT NOT NULL,          -- 자기완결 HTML 시안
+  status      TEXT NOT NULL DEFAULT 'proposed',  -- proposed | accepted
+  style_key   TEXT,                   -- 생성 시 StyleGuide preset (재생성 판단용)
+  created_at  TEXT NOT NULL,
+  UNIQUE(project_id, page_ref)
+);
+CREATE INDEX IF NOT EXISTS idx_mockups_project ON mockups(project_id);

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@hanmariyang/drafting",
+  "version": "1.6.2",
+  "description": "AI Planning Workspace — self-hosted, BYOK. Draft PRDs & feature specs via staged AI interviews. Run: npx @hanmariyang/drafting serve",
+  "license": "MIT",
+  "homepage": "https://github.com/hanmariyang/drafting",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hanmariyang/drafting.git"
+  },
+  "keywords": [
+    "prd",
+    "planning",
+    "ai",
+    "product",
+    "self-hosted",
+    "byok"
+  ],
+  "bin": {
+    "drafting": "bin/drafting.mjs"
+  },
+  "files": [
+    "bin/",
+    "api/dist/",
+    "api/templates/",
+    "db/schema.sql",
+    "web/dist/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "workspaces": [
+    "api",
+    "web"
+  ],
+  "scripts": {
+    "dev": "concurrently -n api,web -c cyan,magenta \"npm:dev:api\" \"npm:dev:web\"",
+    "dev:api": "npm run dev --workspace api",
+    "dev:web": "npm run dev --workspace web",
+    "build": "npm run build --workspace web && npm run build --workspace api",
+    "start": "node api/dist/index.js",
+    "test": "npm run test --workspace api",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@fastify/cors": "^10.0.1",
+    "@fastify/static": "^8.0.3",
+    "fastify": "^5.2.0",
+    "marked": "^15.0.4",
+    "nanoid": "^5.0.9",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "concurrently": "^9.1.0",
+    "gifenc": "^1.0.3",
+    "playwright": "^1.62.1",
+    "pngjs": "^7.0.0"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}