popilot 0.3.0 → 0.5.0

package/scaffold/spec-site/sql/schema.sql

@@ -0,0 +1,224 @@
+-- spec-site database schema
+-- Compatible with: SQLite, Turso/LibSQL, PostgreSQL (with minor adjustments)
+--
+-- This schema supports the full interactive mode (Tier 2) of spec-site.
+-- Run this migration to set up your backend database.
+
+-- ── Navigation ──
+
+CREATE TABLE IF NOT EXISTS sprints (
+  id TEXT PRIMARY KEY,
+  label TEXT NOT NULL,
+  theme TEXT NOT NULL DEFAULT '',
+  active INTEGER NOT NULL DEFAULT 0,
+  start_date TEXT,
+  end_date TEXT,
+  sort_order INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS nav_epics (
+  sprint TEXT NOT NULL,
+  epic_id TEXT NOT NULL,
+  label TEXT NOT NULL,
+  badge TEXT,
+  category TEXT NOT NULL DEFAULT 'policy',
+  description TEXT,
+  sort_order INTEGER NOT NULL DEFAULT 0,
+  uid TEXT,
+  origin_sprint TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  PRIMARY KEY (sprint, epic_id)
+);
+
+-- ── PM (Project Management) ──
+
+CREATE TABLE IF NOT EXISTS pm_epics (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  title TEXT NOT NULL,
+  description TEXT,
+  status TEXT NOT NULL DEFAULT 'active',
+  owner TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS pm_stories (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  epic_id INTEGER REFERENCES pm_epics(id),
+  sprint TEXT NOT NULL,
+  epic_uid TEXT NOT NULL DEFAULT '',
+  title TEXT NOT NULL,
+  description TEXT,
+  acceptance_criteria TEXT,
+  assignee TEXT,
+  status TEXT NOT NULL DEFAULT 'draft',
+  priority TEXT NOT NULL DEFAULT 'medium',
+  area TEXT NOT NULL DEFAULT 'FE',
+  story_points INTEGER,
+  sort_order INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS pm_tasks (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  story_id INTEGER NOT NULL REFERENCES pm_stories(id),
+  title TEXT NOT NULL,
+  assignee TEXT,
+  status TEXT NOT NULL DEFAULT 'todo',
+  description TEXT,
+  sort_order INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- ── Page Content ──
+
+CREATE TABLE IF NOT EXISTS page_rules (
+  id TEXT PRIMARY KEY,
+  page_id TEXT NOT NULL,
+  rule_group TEXT NOT NULL,
+  category TEXT NOT NULL,
+  name TEXT NOT NULL,
+  condition TEXT NOT NULL DEFAULT '',
+  severity TEXT NOT NULL DEFAULT 'info',
+  home_message TEXT NOT NULL DEFAULT '',
+  action TEXT NOT NULL DEFAULT '',
+  data_source TEXT NOT NULL DEFAULT '',
+  impl_status TEXT NOT NULL DEFAULT 'new-data',
+  impl_note TEXT,
+  action_route TEXT,
+  sort_order INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS page_scenarios (
+  page_id TEXT NOT NULL,
+  sprint TEXT NOT NULL,
+  scenario_id TEXT NOT NULL,
+  label TEXT NOT NULL,
+  data_json TEXT NOT NULL DEFAULT '{}',
+  is_default INTEGER NOT NULL DEFAULT 0,
+  sort_order INTEGER NOT NULL DEFAULT 0,
+  author TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  PRIMARY KEY (page_id, sprint, scenario_id)
+);
+
+CREATE TABLE IF NOT EXISTS page_spec_areas (
+  page_id TEXT NOT NULL,
+  area_id TEXT NOT NULL,
+  label TEXT NOT NULL,
+  short_label TEXT NOT NULL DEFAULT '',
+  rule_count INTEGER NOT NULL DEFAULT 0,
+  sort_order INTEGER NOT NULL DEFAULT 0,
+  PRIMARY KEY (page_id, area_id)
+);
+
+CREATE TABLE IF NOT EXISTS page_versions (
+  page_id TEXT NOT NULL,
+  sprint TEXT NOT NULL,
+  version TEXT NOT NULL DEFAULT '0.1.0',
+  last_updated TEXT NOT NULL DEFAULT (datetime('now')),
+  status TEXT NOT NULL DEFAULT 'draft',
+  changelog TEXT NOT NULL DEFAULT '[]',
+  PRIMARY KEY (page_id, sprint)
+);
+
+CREATE TABLE IF NOT EXISTS wireframe_meta (
+  page_id TEXT NOT NULL,
+  sprint TEXT NOT NULL,
+  default_scenario_id TEXT NOT NULL DEFAULT 'default',
+  spec_title TEXT NOT NULL DEFAULT '',
+  route_title TEXT NOT NULL DEFAULT '',
+  PRIMARY KEY (page_id, sprint)
+);
+
+-- ── Scenario Data (custom user scenarios) ──
+
+CREATE TABLE IF NOT EXISTS scenario_data (
+  page_id TEXT NOT NULL,
+  sprint TEXT NOT NULL,
+  scenario_id TEXT NOT NULL,
+  label TEXT NOT NULL,
+  data_json TEXT NOT NULL DEFAULT '{}',
+  author TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  PRIMARY KEY (page_id, sprint, scenario_id)
+);
+
+-- ── Retro ──
+
+CREATE TABLE IF NOT EXISTS retro_sessions (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  sprint TEXT NOT NULL UNIQUE,
+  title TEXT,
+  phase TEXT NOT NULL DEFAULT 'write',
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS retro_items (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id INTEGER NOT NULL REFERENCES retro_sessions(id),
+  category TEXT NOT NULL,
+  content TEXT NOT NULL,
+  author TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS retro_votes (
+  item_id INTEGER NOT NULL REFERENCES retro_items(id),
+  voter TEXT NOT NULL,
+  PRIMARY KEY (item_id, voter)
+);
+
+CREATE TABLE IF NOT EXISTS retro_actions (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id INTEGER NOT NULL REFERENCES retro_sessions(id),
+  content TEXT NOT NULL,
+  assignee TEXT,
+  status TEXT NOT NULL DEFAULT 'pending',
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- ── Memos ──
+
+CREATE TABLE IF NOT EXISTS memos (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  page_id TEXT NOT NULL,
+  content TEXT NOT NULL,
+  author TEXT NOT NULL DEFAULT '',
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- ── Auth ──
+
+CREATE TABLE IF NOT EXISTS auth_tokens (
+  token TEXT PRIMARY KEY,
+  user_name TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  expires_at TEXT
+);
+
+CREATE TABLE IF NOT EXISTS user_activity (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  user_name TEXT NOT NULL,
+  action TEXT NOT NULL DEFAULT 'login',
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- ── Indexes ──
+
+CREATE INDEX IF NOT EXISTS idx_nav_epics_sprint ON nav_epics(sprint);
+CREATE INDEX IF NOT EXISTS idx_pm_stories_sprint ON pm_stories(sprint);
+CREATE INDEX IF NOT EXISTS idx_pm_stories_epic ON pm_stories(epic_id);
+CREATE INDEX IF NOT EXISTS idx_pm_tasks_story ON pm_tasks(story_id);
+CREATE INDEX IF NOT EXISTS idx_page_rules_page ON page_rules(page_id);
+CREATE INDEX IF NOT EXISTS idx_retro_items_session ON retro_items(session_id);
+CREATE INDEX IF NOT EXISTS idx_memos_page ON memos(page_id);

package/scaffold/spec-site/src/api/client.ts

@@ -0,0 +1,131 @@
+/**
+ * Generic REST API client for spec-site.
+ *
+ * Provider-agnostic: works with any backend that implements the spec-site
+ * API contract (Turso+CF Workers, Supabase, Lambda+RDS, etc.).
+ *
+ * In static mode (VITE_SPEC_MODE=static), API calls gracefully degrade
+ * and composables fall back to local data sources.
+ */
+
+const apiUrl = import.meta.env.VITE_API_URL as string | undefined
+const specMode = (import.meta.env.VITE_SPEC_MODE as string) || 'static'
+
+let _reachable: boolean | null = null
+
+export function isApiMode(): boolean {
+  return specMode === 'api' && !!apiUrl
+}
+
+export function isStaticMode(): boolean {
+  return !isApiMode()
+}
+
+function getAuthHeader(): Record<string, string> {
+  const token = localStorage.getItem('spec-auth-token')
+  if (!token) return {}
+  return { Authorization: `Bearer ${token}` }
+}
+
+export async function apiGet<T = Record<string, unknown>>(
+  endpoint: string,
+  params?: Record<string, string>,
+): Promise<{ data?: T; error?: string }> {
+  if (!apiUrl) return { error: 'Missing API URL' }
+  if (_reachable === false) return { error: 'API unreachable' }
+
+  try {
+    let url = `${apiUrl}${endpoint}`
+    if (params) {
+      const qs = new URLSearchParams(params).toString()
+      if (qs) url += `?${qs}`
+    }
+    const resp = await fetch(url, {
+      headers: { ...getAuthHeader() },
+      signal: AbortSignal.timeout(5000),
+    })
+    if (!resp.ok) {
+      const text = await resp.text().catch(() => '')
+      if (resp.status !== 401 && resp.status !== 403 && _reachable === null) _reachable = false
+      return { error: `HTTP ${resp.status}: ${text}` }
+    }
+    _reachable = true
+    const data = await resp.json()
+    if (data.error) return { error: data.error }
+    return { data }
+  } catch (err: unknown) {
+    if (_reachable === null) {
+      _reachable = false
+      console.warn('[api] API unreachable, using offline mode')
+    }
+    return { error: err instanceof Error ? err.message : 'Unknown error' }
+  }
+}
+
+export function resetReachable() {
+  _reachable = null
+}
+
+export async function apiPost<T = Record<string, unknown>>(
+  endpoint: string,
+  body: Record<string, unknown>,
+): Promise<{ data?: T; error?: string }> {
+  return apiMutate<T>('POST', endpoint, body)
+}
+
+export async function apiPatch<T = Record<string, unknown>>(
+  endpoint: string,
+  body: Record<string, unknown>,
+): Promise<{ data?: T; error?: string }> {
+  return apiMutate<T>('PATCH', endpoint, body)
+}
+
+export async function apiPut<T = Record<string, unknown>>(
+  endpoint: string,
+  body: Record<string, unknown>,
+): Promise<{ data?: T; error?: string }> {
+  return apiMutate<T>('PUT', endpoint, body)
+}
+
+export async function apiDelete<T = Record<string, unknown>>(
+  endpoint: string,
+  body?: Record<string, unknown>,
+): Promise<{ data?: T; error?: string }> {
+  return apiMutate<T>('DELETE', endpoint, body)
+}
+
+async function apiMutate<T>(
+  method: string,
+  endpoint: string,
+  body?: Record<string, unknown>,
+): Promise<{ data?: T; error?: string }> {
+  if (!apiUrl) return { error: 'Missing API URL' }
+  if (_reachable === false) return { error: 'API unreachable' }
+
+  try {
+    const resp = await fetch(`${apiUrl}${endpoint}`, {
+      method,
+      headers: {
+        'Content-Type': 'application/json',
+        ...getAuthHeader(),
+      },
+      body: body ? JSON.stringify(body) : undefined,
+      signal: AbortSignal.timeout(5000),
+    })
+    if (!resp.ok) {
+      const text = await resp.text().catch(() => '')
+      if (resp.status !== 401 && resp.status !== 403 && _reachable === null) _reachable = false
+      return { error: `HTTP ${resp.status}: ${text}` }
+    }
+    _reachable = true
+    const data = await resp.json()
+    if (data.error) return { error: data.error }
+    return { data }
+  } catch (err: unknown) {
+    if (_reachable === null) {
+      _reachable = false
+      console.warn('[api] API unreachable, using offline mode')
+    }
+    return { error: err instanceof Error ? err.message : 'Unknown error' }
+  }
+}

package/scaffold/spec-site/src/api/types.ts

@@ -0,0 +1,177 @@
+/**
+ * API response types for the spec-site backend contract.
+ *
+ * Any backend implementation (Turso+CF, Supabase, Lambda+RDS, etc.)
+ * must conform to these response shapes.
+ */
+
+// ── Navigation ──
+
+export interface NavApiResponse {
+  sprints: SprintRow[]
+  epics: EpicNavRow[]
+}
+
+export interface SprintRow {
+  id: string
+  label: string
+  theme: string
+  active: number
+  start_date: string | null
+  end_date: string | null
+  sort_order: number
+}
+
+export interface EpicNavRow {
+  sprint: string
+  epic_id: string
+  label: string
+  badge: string | null
+  category: string
+  description: string | null
+  sort_order: number
+  uid: string | null
+  origin_sprint: string | null
+}
+
+// ── Page Content ──
+
+export interface PageContentApiResponse {
+  rules: RuleRow[]
+  scenarios: ScenarioRow[]
+  areas: SpecAreaRow[]
+  versions: VersionRow[]
+  meta: WireframeMetaRow[]
+}
+
+export interface RuleRow {
+  id: string
+  page_id: string
+  rule_group: string
+  category: string
+  name: string
+  condition: string
+  severity: string
+  home_message: string
+  action: string
+  data_source: string
+  impl_status: string
+  impl_note: string | null
+  action_route: string | null
+  sort_order: number
+}
+
+export interface ScenarioRow {
+  scenario_id: string
+  label: string
+  data_json: string
+  is_default: number
+  sort_order: number
+}
+
+export interface SpecAreaRow {
+  area_id: string
+  label: string
+  short_label: string
+  rule_count: number
+  sort_order: number
+}
+
+export interface VersionRow {
+  page_id: string
+  version: string
+  last_updated: string
+  sprint: string
+  status: string
+  changelog: string
+}
+
+export interface WireframeMetaRow {
+  default_scenario_id: string
+  spec_title: string
+  route_title: string
+}
+
+// ── PM (Project Management) ──
+
+export interface PmDataApiResponse {
+  stories: PmStoryRow[]
+  tasks: PmTaskRow[]
+}
+
+export interface PmEpicRow {
+  id: number
+  title: string
+  description: string | null
+  status: string
+  owner: string | null
+  created_at: string
+  updated_at: string
+}
+
+export interface PmStoryRow {
+  id: number
+  epic_id: number | null
+  sprint: string
+  epic_uid: string
+  title: string
+  description: string | null
+  acceptance_criteria: string | null
+  assignee: string | null
+  status: string
+  priority: string
+  area: string
+  story_points: number | null
+  sort_order: number
+  created_at: string
+  updated_at: string
+}
+
+export interface PmTaskRow {
+  id: number
+  story_id: number
+  title: string
+  assignee: string | null
+  status: string
+  description: string | null
+  sort_order: number
+  created_at: string
+  updated_at: string
+}
+
+// ── Auth ──
+
+export interface AuthVerifyResponse {
+  userName: string
+}
+
+// ── Retro ──
+
+export interface RetroSessionRow {
+  id: number
+  sprint: string
+  title: string | null
+  phase: string
+  created_at: string
+  updated_at: string
+}
+
+export interface RetroItemRow {
+  id: number
+  session_id: number
+  category: string
+  content: string
+  author: string
+  created_at: string
+  voteCount: number
+  hasVoted: number
+}
+
+export interface RetroActionRow {
+  id: number
+  session_id: number
+  content: string
+  assignee: string | null
+  status: string
+  created_at: string
+}

package/scaffold/spec-site/src/components/Accordion.vue

@@ -58,7 +58,7 @@ function toggle() {
   background: none;
   border: none;
   cursor: pointer;
-  font-family: var(--font-kr);
+  font-family: var(--font-sans);
   font-size: 15px;
   font-weight: 600;
   color: var(--text-primary);

package/scaffold/spec-site/src/components/AppHeader.vue

@@ -1,16 +1,17 @@
 <script setup lang="ts">
 import { ref, computed, onMounted, onUnmounted } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
-import { sprints, featurePages, type SprintConfig } from '../data/navigation'
+import { sprints, getActiveSprint, type SprintConfig } from '../composables/useNavStore'
+import { featurePages } from '../data/navigation'
 
 const route = useRoute()
 const router = useRouter()
 
 const currentPageId = computed(() => (route.params.pageId as string) || '')
-const currentSprint = computed(() => (route.params.sprint as string) || sprints[0]?.id || '')
+const currentSprint = computed(() => (route.params.sprint as string) || getActiveSprint().id)
 
 const activeSprintLabel = computed(() => {
-  const s = sprints.find(s => s.id === currentSprint.value)
+  const s = sprints.value.find(s => s.id === currentSprint.value)
   return s?.label ?? currentSprint.value.toUpperCase()
 })
 
@@ -212,7 +213,7 @@ onUnmounted(() => document.removeEventListener('click', onDocClick))
   background: none;
   font-size: 13px;
   font-weight: 600;
-  font-family: var(--font-kr);
+  font-family: var(--font-sans);
   color: var(--text-primary);
   cursor: pointer;
   transition: all 0.15s;

package/scaffold/spec-site/src/components/CoachingCard.vue

@@ -99,7 +99,7 @@ function toggleCheck() {
   padding: 7px 16px;
   border-radius: 6px;
   font-size: 13px;
-  font-family: var(--font-kr);
+  font-family: var(--font-sans);
   font-weight: 500;
   cursor: pointer;
   border: none;

package/scaffold/spec-site/src/components/ScenarioSwitcher.vue

@@ -76,7 +76,7 @@ function isCustom(id: string) {
   background: transparent;
   color: #fff;
   font-size: 12px;
-  font-family: var(--font-kr);
+  font-family: var(--font-sans);
   cursor: pointer;
   transition: all 0.15s;
 }

package/scaffold/spec-site/src/composables/navTypes.ts

@@ -0,0 +1,39 @@
+/**
+ * Navigation Store — Type definitions and fallback data
+ *
+ * Fallback data ensures the UI works synchronously before API loads.
+ * Replace with your project's sprints/epics or leave empty for API-only mode.
+ */
+
+// ── Domain types ──
+
+export interface SprintConfig {
+  id: string
+  label: string
+  theme: string
+  active: boolean
+  startDate?: string | null
+  endDate?: string | null
+  sortOrder: number
+}
+
+export interface PageConfig {
+  id: string
+  label: string
+  badge?: string
+  category: string
+  sprint: string
+  description?: string
+  sortOrder: number
+  uid?: string
+  originSprint?: string
+}
+
+// ── Fallback data (ensures sync access before API loads) ──
+// TODO: Replace with your project's initial sprints and epics
+
+export const FALLBACK_SPRINTS: SprintConfig[] = [
+  { id: 's1', label: 'S1', theme: '', active: true, sortOrder: 0 },
+]
+
+export const FALLBACK_EPICS: PageConfig[] = []