popilot 0.2.0

package/scaffold/spec-site/src/pages/shared/PolicyFallback.vue

@@ -0,0 +1,145 @@
+<script setup lang="ts">
+import { ref, watchEffect, computed } from 'vue'
+import { sprints, getPagesByCategory, getEpicSpecFileName } from '@/data/navigation'
+import { renderMarkdown } from '@/utils/markdown'
+
+const props = defineProps<{
+  sprint: string
+  epicId: string
+  pageLabel: string
+}>()
+
+const sprintLabel = computed(() => sprints.find(s => s.id === props.sprint)?.label ?? props.sprint)
+const epicConfig = computed(() => {
+  const epics = getPagesByCategory(props.sprint, 'policy')
+  return epics.find(e => e.id === props.epicId)
+})
+
+const markdownHtml = ref('')
+const loading = ref(true)
+const error = ref(false)
+
+const mdModules = import.meta.glob(
+  '../../../../.context/sprints/*/epic-specs/*.md',
+  { query: '?raw', import: 'default' }
+)
+
+watchEffect(async () => {
+  loading.value = true
+  error.value = false
+  markdownHtml.value = ''
+
+  const fileName = getEpicSpecFileName(props.sprint, props.epicId)
+  if (!fileName) {
+    error.value = true
+    loading.value = false
+    return
+  }
+
+  const key = `../../../../.context/sprints/${props.sprint}/epic-specs/${fileName}`
+  const loader = mdModules[key]
+
+  if (!loader) {
+    error.value = true
+    loading.value = false
+    return
+  }
+
+  try {
+    const raw = (await loader()) as string
+    markdownHtml.value = renderMarkdown(raw)
+  } catch {
+    error.value = true
+  }
+  loading.value = false
+})
+</script>
+
+<template>
+  <div class="policy-fallback">
+    <div class="fallback-banner">
+      <span class="banner-icon">📄</span>
+      <span>No wireframe spec for <strong>{{ pageLabel }}</strong> in {{ sprintLabel }}. Showing policy document ({{ epicId }}) instead.</span>
+    </div>
+
+    <div class="fallback-content">
+      <div v-if="loading" class="fallback-loading">Loading...</div>
+      <div v-else-if="error" class="fallback-error">
+        <p>Policy document not found.</p>
+      </div>
+      <article v-else class="markdown-body" v-html="markdownHtml"></article>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.policy-fallback {
+  height: calc(100vh - var(--header-height));
+  overflow-y: auto;
+  background: var(--bg);
+}
+
+.fallback-banner {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 10px 24px;
+  background: var(--blue-bg);
+  border-bottom: 1px solid var(--border-light);
+  font-size: 13px;
+  color: var(--text-secondary);
+}
+.banner-icon { font-size: 16px; }
+
+.fallback-content {
+  max-width: 800px;
+  margin: 0 auto;
+  padding: 32px 40px;
+}
+
+.fallback-loading,
+.fallback-error {
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  height: 200px;
+  color: var(--text-muted);
+  font-size: 14px;
+}
+
+/* ---- Markdown styles ---- */
+.markdown-body {
+  font-size: 14px;
+  line-height: 1.7;
+  color: var(--text-primary);
+}
+.markdown-body :deep(h1) { font-size: 24px; font-weight: 700; margin: 0 0 16px; padding-bottom: 8px; border-bottom: 2px solid var(--border); }
+.markdown-body :deep(h2) { font-size: 19px; font-weight: 700; margin: 32px 0 12px; }
+.markdown-body :deep(h3) { font-size: 15px; font-weight: 700; margin: 24px 0 8px; }
+.markdown-body :deep(h4) { font-size: 14px; font-weight: 700; margin: 20px 0 6px; color: var(--text-secondary); }
+.markdown-body :deep(p) { margin: 0 0 10px; }
+.markdown-body :deep(strong) { font-weight: 700; }
+.markdown-body :deep(code) {
+  font-size: 12px; background: var(--border-light); padding: 2px 5px;
+  border-radius: 3px; font-family: 'SF Mono', 'Menlo', monospace;
+}
+.markdown-body :deep(pre) {
+  background: var(--text-primary); color: #e5e7eb; padding: 16px;
+  border-radius: var(--radius-sm); overflow-x: auto; margin: 12px 0;
+  font-size: 12px; line-height: 1.6;
+}
+.markdown-body :deep(pre code) { background: none; padding: 0; color: inherit; }
+.markdown-body :deep(ul), .markdown-body :deep(ol) { margin: 8px 0; padding-left: 24px; }
+.markdown-body :deep(li) { margin: 4px 0; }
+.markdown-body :deep(blockquote) {
+  border-left: 3px solid var(--primary); padding: 8px 16px; margin: 12px 0;
+  background: var(--primary-light); color: var(--text-secondary);
+  border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
+}
+.markdown-body :deep(hr) { border: none; border-top: 1px solid var(--border); margin: 24px 0; }
+.markdown-body :deep(table) { width: 100%; border-collapse: collapse; margin: 12px 0; font-size: 13px; }
+.markdown-body :deep(th) { text-align: left; padding: 8px 12px; background: var(--border-light); font-weight: 700; border: 1px solid var(--border); }
+.markdown-body :deep(td) { padding: 8px 12px; border: 1px solid var(--border); }
+.markdown-body :deep(a) { color: var(--primary); text-decoration: none; }
+.markdown-body :deep(a:hover) { text-decoration: underline; }
+</style>

package/scaffold/spec-site/src/pages/wireframe/WireframeShell.vue

@@ -0,0 +1,151 @@
+<script setup lang="ts">
+import { computed, watch, onMounted, ref } from 'vue'
+import { useRoute } from 'vue-router'
+import SplitPaneLayout from '@/layouts/SplitPaneLayout.vue'
+import ScenarioSwitcher from '@/components/ScenarioSwitcher.vue'
+import VersionBadge from '@/components/VersionBadge.vue'
+import MockupShell from '@/components/MockupShell.vue'
+import PolicyFallback from '@/pages/shared/PolicyFallback.vue'
+import NoContentPlaceholder from '@/pages/shared/NoContentPlaceholder.vue'
+import { provideScenario } from '@/composables/useScenario'
+import { useScenarioStore } from '@/composables/useScenarioStore'
+import { useUser } from '@/composables/useUser'
+import { getWireframe } from '@/data/wireframeRegistry'
+import { featurePages } from '@/data/navigation'
+import type { Scenario } from '@/data/types'
+
+const route = useRoute()
+const { currentUser } = useUser()
+
+const pageId = computed(() => (route.params.pageId as string) || '')
+const sprint = computed(() => (route.params.sprint as string) || '')
+
+const wireframeConfig = computed(() => getWireframe(pageId.value, sprint.value))
+const hasWireframe = computed(() => !!wireframeConfig.value)
+
+const featurePage = computed(() => featurePages.find(p => p.id === pageId.value))
+
+const fallbackEpicId = computed(() => {
+  if (hasWireframe.value) return null
+  return featurePage.value?.epicMap[sprint.value] ?? null
+})
+
+const renderMode = computed<'wireframe' | 'policy' | 'empty'>(() => {
+  if (hasWireframe.value) return 'wireframe'
+  if (fallbackEpicId.value) return 'policy'
+  return 'empty'
+})
+
+// Turso custom scenario store
+const store = useScenarioStore(pageId.value, sprint.value)
+const storeRef = ref(store)
+
+const initialConfig = wireframeConfig.value
+const { scenarios, activeScenarioId, setScenario, updateScenarios } = provideScenario(
+  initialConfig?.scenarios ?? [],
+  initialConfig?.defaultScenarioId ?? '',
+)
+
+async function mergeCustomScenarios() {
+  const config = getWireframe(pageId.value, sprint.value)
+  const baseScenarios: Scenario<any>[] = config?.scenarios ?? []
+  const custom = await storeRef.value.loadCustomScenarios()
+  if (storeRef.value.error) {
+    console.warn('[WireframeShell] custom scenario sync failed:', storeRef.value.error)
+  }
+  updateScenarios([...baseScenarios, ...custom], config?.defaultScenarioId ?? '')
+}
+
+async function handleDuplicate(sourceId: string) {
+  const source = scenarios.value.find(s => s.id === sourceId)
+  if (!source) return
+  const label = `${source.label} (copy)`
+  const newId = await storeRef.value.duplicateScenario(source, label, currentUser.value ?? 'unknown')
+  if (!newId) return
+  await mergeCustomScenarios()
+}
+
+async function handleDeleteCustom(scenarioId: string) {
+  const ok = await storeRef.value.deleteScenario(scenarioId)
+  if (!ok) return
+  await mergeCustomScenarios()
+}
+
+watch([pageId, sprint], () => {
+  const newStore = useScenarioStore(pageId.value, sprint.value)
+  storeRef.value = newStore
+  mergeCustomScenarios()
+})
+
+onMounted(() => {
+  mergeCustomScenarios()
+})
+
+const showScenarioSwitcher = computed(() =>
+  hasWireframe.value && (wireframeConfig.value?.scenarios.length ?? 0) > 0
+)
+</script>
+
+<template>
+  <div class="wireframe-shell">
+    <!-- Wireframe mode -->
+    <SplitPaneLayout
+      v-if="renderMode === 'wireframe'"
+      :spec-areas="wireframeConfig!.specAreas"
+      :title="wireframeConfig!.specTitle"
+    >
+      <template #mockup>
+        <div v-if="showScenarioSwitcher" class="mockup-toolbar">
+          <ScenarioSwitcher
+            :scenarios="scenarios"
+            :active-id="activeScenarioId"
+            @change="setScenario"
+            @duplicate="handleDuplicate"
+            @delete-custom="handleDeleteCustom"
+          />
+          <div class="mockup-version">
+            <VersionBadge :version="wireframeConfig!.version" />
+          </div>
+        </div>
+        <MockupShell>
+          <component :is="wireframeConfig!.mockup" :key="`${pageId}-${sprint}`" />
+        </MockupShell>
+      </template>
+
+      <template #spec>
+        <component :is="wireframeConfig!.specPanel" :key="`${pageId}-${sprint}`" />
+      </template>
+    </SplitPaneLayout>
+
+    <!-- Policy fallback -->
+    <PolicyFallback
+      v-else-if="renderMode === 'policy'"
+      :sprint="sprint"
+      :epic-id="fallbackEpicId!"
+      :page-label="featurePage?.label ?? pageId"
+    />
+
+    <!-- No content -->
+    <NoContentPlaceholder
+      v-else
+      :page-id="pageId"
+      :sprint="sprint"
+    />
+  </div>
+</template>
+
+<style scoped>
+.wireframe-shell { height: 100%; }
+.mockup-toolbar {
+  position: sticky;
+  top: 0;
+  z-index: 100;
+}
+.mockup-version {
+  background: #fff;
+  padding: 6px 16px;
+  border-bottom: 1px solid var(--border);
+  display: flex;
+  justify-content: flex-end;
+}
+</style>

package/scaffold/spec-site/src/router.ts

@@ -0,0 +1,85 @@
+import { createRouter, createWebHistory } from 'vue-router'
+import { isValidFeaturePage, getActiveSprint, featurePages } from './data/navigation'
+import { getWireframe, getAvailableSprints } from './data/wireframeRegistry'
+
+const activeSprint = getActiveSprint().id
+
+const routes = [
+  { path: '/', component: () => import('./pages/IndexPage.vue') },
+
+  // -- Policy documents --
+  {
+    path: '/policy',
+    redirect: `/policy/${activeSprint}`,
+  },
+  {
+    path: '/policy/:sprint',
+    component: () => import('./pages/PolicyIndex.vue'),
+    meta: { title: 'Policy' },
+  },
+  {
+    path: '/policy/:sprint/:epicId',
+    component: () => import('./pages/PolicyDetail.vue'),
+    meta: { title: 'Policy' },
+  },
+
+  // -- Retro (Turso-based team collaboration) --
+  {
+    path: '/retro',
+    redirect: `/retro/${activeSprint}`,
+  },
+  {
+    path: '/retro/:sprint',
+    component: () => import('./pages/retro/RetroPage.vue'),
+    meta: { title: 'Retro' },
+  },
+
+  // -- Feature pages (wireframe shell) --
+  {
+    path: '/:pageId',
+    redirect: (to: any) => {
+      const id = to.params.pageId as string
+      if (!isValidFeaturePage(id)) return '/'
+      const sprints = getAvailableSprints(id)
+      const best = sprints.includes(activeSprint) ? activeSprint : sprints[0] ?? activeSprint
+      return `/${id}/${best}`
+    },
+  },
+  {
+    path: '/:pageId/:sprint',
+    component: () => import('./pages/wireframe/WireframeShell.vue'),
+    beforeEnter: (to: any) => {
+      if (!isValidFeaturePage(to.params.pageId as string)) return '/'
+    },
+  },
+
+  // Catch-all
+  {
+    path: '/:pathMatch(.*)*',
+    redirect: '/',
+  },
+]
+
+const router = createRouter({
+  history: createWebHistory(),
+  routes,
+})
+
+router.afterEach((to) => {
+  const pageId = to.params.pageId as string
+  const sprint = to.params.sprint as string
+
+  if (pageId && sprint) {
+    const config = getWireframe(pageId, sprint)
+    if (config) {
+      document.title = config.routeTitle ?? 'Spec Site'
+    } else {
+      const fp = featurePages.find(p => p.id === pageId)
+      document.title = fp ? `${fp.label} — Spec Site` : 'Spec Site'
+    }
+  } else {
+    document.title = (to.meta.title as string) ?? 'Spec Site'
+  }
+})
+
+export default router

package/scaffold/spec-site/src/styles/base.css

@@ -0,0 +1,21 @@
+* { margin: 0; padding: 0; box-sizing: border-box; }
+
+body {
+  font-family: var(--font-kr);
+  background: var(--bg);
+  color: var(--text-primary);
+  -webkit-font-smoothing: antialiased;
+}
+
+a { color: inherit; text-decoration: none; }
+
+button {
+  font-family: var(--font-kr);
+  cursor: pointer;
+}
+
+/* Scrollbar */
+::-webkit-scrollbar { width: 6px; }
+::-webkit-scrollbar-track { background: transparent; }
+::-webkit-scrollbar-thumb { background: var(--border); border-radius: 3px; }
+::-webkit-scrollbar-thumb:hover { background: var(--text-muted); }

package/scaffold/spec-site/src/styles/split-pane.css

@@ -0,0 +1,143 @@
+/* ========== Split-Pane Layout ========== */
+.split-pane {
+  display: flex;
+  height: calc(100vh - var(--header-height));
+  overflow: hidden;
+  width: 100%;
+}
+
+.pane-left {
+  width: 55%;
+  min-width: 400px;
+  overflow-y: auto;
+  overflow-x: hidden;
+  position: relative;
+  flex-shrink: 0;
+}
+
+.pane-divider {
+  width: 6px;
+  background: var(--border);
+  cursor: col-resize;
+  flex-shrink: 0;
+  position: relative;
+  z-index: 200;
+  transition: background 0.15s;
+}
+.pane-divider:hover,
+.pane-divider.dragging { background: var(--primary); }
+.pane-divider::after {
+  content: '\22EE';
+  position: absolute;
+  top: 50%;
+  left: 50%;
+  transform: translate(-50%, -50%);
+  color: var(--text-muted);
+  font-size: 14px;
+  pointer-events: none;
+}
+
+.pane-right {
+  flex: 1;
+  min-width: 360px;
+  overflow-y: auto;
+  background: #fff;
+  display: flex;
+  flex-direction: column;
+}
+
+/* ========== Area Highlight ========== */
+[data-area] {
+  position: relative;
+  cursor: pointer;
+  transition: outline 0.2s, box-shadow 0.2s;
+  border-radius: 2px;
+}
+[data-area]:hover {
+  outline: 2px dashed var(--primary);
+  outline-offset: -2px;
+}
+[data-area].area-active {
+  outline: 3px solid var(--primary);
+  outline-offset: -3px;
+  box-shadow: inset 0 0 0 9999px rgba(0, 85, 212, 0.04);
+}
+[data-area]::before {
+  content: attr(data-area-label);
+  position: absolute;
+  top: 4px;
+  right: 4px;
+  background: var(--primary);
+  color: #fff;
+  font-size: 10px;
+  font-weight: 700;
+  padding: 2px 8px;
+  border-radius: 4px;
+  opacity: 0;
+  transition: opacity 0.15s;
+  pointer-events: none;
+  z-index: 10;
+  letter-spacing: 0.3px;
+}
+[data-area]:hover::before,
+[data-area].area-active::before { opacity: 1; }
+
+/* ========== Spec Panel ========== */
+.spec-panel-header {
+  position: sticky;
+  top: 0;
+  z-index: 50;
+  background: #fff;
+  border-bottom: 2px solid var(--border);
+  padding: 12px 16px;
+}
+.spec-panel-title {
+  font-size: 15px;
+  font-weight: 700;
+  margin-bottom: 10px;
+  color: var(--text-primary);
+}
+.spec-nav {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px;
+}
+.spec-nav-btn {
+  padding: 4px 10px;
+  border-radius: 6px;
+  border: 1px solid var(--border);
+  background: #fff;
+  font-size: 11px;
+  font-family: var(--font-kr);
+  cursor: pointer;
+  transition: all 0.15s;
+  font-weight: 600;
+  color: var(--text-secondary);
+}
+.spec-nav-btn:hover { background: var(--bg); }
+.spec-nav-btn.active {
+  background: var(--primary);
+  color: #fff;
+  border-color: var(--primary);
+}
+.spec-panel-body {
+  flex: 1;
+  overflow-y: auto;
+}
+.spec-placeholder {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  height: 400px;
+  color: var(--text-muted);
+  font-size: 14px;
+  text-align: center;
+  line-height: 1.8;
+  padding: 40px;
+}
+.spec-placeholder .placeholder-icon {
+  font-size: 48px;
+  margin-bottom: 16px;
+  opacity: 0.3;
+}

package/scaffold/spec-site/src/styles/variables.css

@@ -0,0 +1,47 @@
+:root {
+  /* Brand */
+  --primary: #0055d4;
+  --primary-light: #e8f0fe;
+  --primary-dark: #003d9e;
+
+  /* Background */
+  --bg: #F8F8FB;
+  --card-bg: #ffffff;
+
+  /* Text */
+  --text-primary: #1f2123;
+  --text-secondary: #6b7280;
+  --text-muted: #9ca3af;
+
+  /* Border */
+  --border: #e5e7eb;
+  --border-light: #f3f4f6;
+
+  /* Severity colors */
+  --red: #E53E3E;
+  --red-bg: #FEF2F2;
+  --red-border: #FECACA;
+  --yellow: #D69E2E;
+  --yellow-bg: #FFFBEB;
+  --yellow-border: #FDE68A;
+  --green: #38A169;
+  --green-bg: #F0FFF4;
+  --green-border: #C6F6D5;
+  --blue: #3B82F6;
+  --blue-bg: #EFF6FF;
+  --blue-border: #BFDBFE;
+  --negative: #fc4747;
+
+  /* Layout */
+  --header-height: 48px;
+  --radius: 12px;
+  --radius-sm: 8px;
+
+  /* Shadow */
+  --shadow: 0 1px 3px rgba(0,0,0,0.06), 0 1px 2px rgba(0,0,0,0.04);
+  --shadow-md: 0 4px 6px rgba(0,0,0,0.05), 0 2px 4px rgba(0,0,0,0.04);
+
+  /* Font */
+  --font-kr: 'Noto Sans KR', sans-serif;
+  --font-num: 'Roboto', 'Noto Sans KR', sans-serif;
+}