popilot 0.5.0 → 0.7.0

package/scaffold/pm-api/src/utils/sprint-lifecycle.ts

@@ -0,0 +1,96 @@
+/**
+ * Sprint Lifecycle — pure domain logic
+ * No DB dependency. Fully testable.
+ */
+
+export interface StoryRow {
+  id: number
+  title: string
+  sprint: string | null
+  status: string
+  story_points: number | null
+  assignee: string | null
+}
+
+export interface SprintStatus {
+  id: string
+  status: 'planning' | 'active' | 'closed'
+}
+
+export interface VelocityRecord {
+  sprintId: string
+  assignee: string
+  doneSP: number
+  totalSP: number
+}
+
+export interface CloseSummary {
+  sprintId: string
+  completedCount: number
+  incompleteCount: number
+  totalStories: number
+  doneSP: number
+  totalSP: number
+  completionRate: number
+}
+
+/** Check whether the sprint can be closed */
+export function canClose(sprint: SprintStatus): { ok: boolean; error?: string } {
+  if (sprint.status !== 'active') {
+    return { ok: false, error: `Can only close sprints in active state (current: ${sprint.status})` }
+  }
+  return { ok: true }
+}
+
+/** Filter incomplete stories */
+export function getIncompleteStories(stories: StoryRow[]): StoryRow[] {
+  return stories.filter(s => s.status !== 'done')
+}
+
+/** Filter completed stories */
+export function getCompletedStories(stories: StoryRow[]): StoryRow[] {
+  return stories.filter(s => s.status === 'done')
+}
+
+/** Move incomplete stories to backlog (pure function — returns new array) */
+export function moveToBacklog(stories: StoryRow[]): StoryRow[] {
+  return stories.map(s => ({ ...s, sprint: null }))
+}
+
+/** Aggregate completed SP per team member */
+export function aggregateVelocity(sprintId: string, stories: StoryRow[]): VelocityRecord[] {
+  const map = new Map<string, { done: number; total: number }>()
+
+  for (const s of stories) {
+    const assignee = s.assignee ?? 'Unassigned'
+    if (!map.has(assignee)) map.set(assignee, { done: 0, total: 0 })
+    const entry = map.get(assignee)!
+    entry.total += s.story_points ?? 0
+    if (s.status === 'done') entry.done += s.story_points ?? 0
+  }
+
+  return [...map.entries()].map(([assignee, { done, total }]) => ({
+    sprintId,
+    assignee,
+    doneSP: done,
+    totalSP: total,
+  }))
+}
+
+/** Generate close summary */
+export function generateCloseSummary(sprintId: string, stories: StoryRow[]): CloseSummary {
+  const completed = getCompletedStories(stories)
+  const incomplete = getIncompleteStories(stories)
+  const totalDoneSP = completed.reduce((sum, s) => sum + (s.story_points ?? 0), 0)
+  const totalSP = stories.reduce((sum, s) => sum + (s.story_points ?? 0), 0)
+
+  return {
+    sprintId,
+    completedCount: completed.length,
+    incompleteCount: incomplete.length,
+    totalStories: stories.length,
+    doneSP: totalDoneSP,
+    totalSP,
+    completionRate: totalSP > 0 ? Math.round((totalDoneSP / totalSP) * 100) : 0,
+  }
+}

package/scaffold/pm-api/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022"],
+    "types": ["@cloudflare/workers-types"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["src"],
+  "exclude": ["src/**/*.test.ts"]
+}

package/scaffold/pm-api/wrangler.toml.hbs

@@ -0,0 +1,11 @@
+name = "{{project.name}}-pm-api"
+main = "src/index.ts"
+compatibility_date = "2025-03-10"
+
+# Database credentials: npx wrangler secret put TURSO_URL && npx wrangler secret put TURSO_AUTH_TOKEN
+
+# Proactive Nudge schedule (UTC)
+# 01:00 UTC: Morning check — review_overdue, sprint_deadline, task_stagnant, blocker_open
+# 08:00 UTC: Afternoon check — all rules + standup_missing, sprint_daily_report
+[triggers]
+crons = ["0 1 * * *", "0 8 * * *"]

package/scaffold/spec-site/package-lock.json

@@ -8,6 +8,9 @@
       "name": "spec-site",
       "version": "1.0.0",
       "dependencies": {
+        "dompurify": "^3.2.0",
+        "lucide-vue-next": "^0.470.0",
+        "marked": "^15.0.0",
         "vue": "^3.5.27",
         "vue-router": "^4.5.0"
       },
@@ -869,6 +872,13 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/@types/trusted-types": {
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/@types/trusted-types/-/trusted-types-2.0.7.tgz",
+      "integrity": "sha512-ScaPdn1dQczgbl0QFTeTOmVHFULt394XJgOQNoyVhZ6r2vLnMLJfBPd53SB52T/3G36VI1/g2MZaX0cwDuXsfw==",
+      "license": "MIT",
+      "optional": true
+    },
     "node_modules/@vitejs/plugin-vue": {
       "version": "5.2.4",
       "resolved": "https://registry.npmjs.org/@vitejs/plugin-vue/-/plugin-vue-5.2.4.tgz",
@@ -1091,6 +1101,15 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/dompurify": {
+      "version": "3.3.3",
+      "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.3.3.tgz",
+      "integrity": "sha512-Oj6pzI2+RqBfFG+qOaOLbFXLQ90ARpcGG6UePL82bJLtdsa6CYJD7nmiU8MW9nQNOtCHV3lZ/Bzq1X0QYbBZCA==",
+      "license": "(MPL-2.0 OR Apache-2.0)",
+      "optionalDependencies": {
+        "@types/trusted-types": "^2.0.7"
+      }
+    },
     "node_modules/entities": {
       "version": "7.0.1",
       "resolved": "https://registry.npmjs.org/entities/-/entities-7.0.1.tgz",
@@ -1194,6 +1213,15 @@
         "he": "bin/he"
       }
     },
+    "node_modules/lucide-vue-next": {
+      "version": "0.470.0",
+      "resolved": "https://registry.npmjs.org/lucide-vue-next/-/lucide-vue-next-0.470.0.tgz",
+      "integrity": "sha512-hqcVn93ghGJIEFo1MiQuy0PrZbp5nHZZcSxumZ+0qIRYy+f7e0ngVTsFOiQYL2Gl1YZ+PQR0WJkIDH5MCp3gGw==",
+      "license": "ISC",
+      "peerDependencies": {
+        "vue": ">=3.0.1"
+      }
+    },
     "node_modules/magic-string": {
       "version": "0.30.21",
       "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
@@ -1203,6 +1231,18 @@
         "@jridgewell/sourcemap-codec": "^1.5.5"
       }
     },
+    "node_modules/marked": {
+      "version": "15.0.12",
+      "resolved": "https://registry.npmjs.org/marked/-/marked-15.0.12.tgz",
+      "integrity": "sha512-8dD6FusOQSrpv9Z1rdNMdlSgQOIP880DHqnohobOmYLElGEqAL/JvxvuxZO16r4HtjTlfPRDC1hbvxC9dPN2nA==",
+      "license": "MIT",
+      "bin": {
+        "marked": "bin/marked.js"
+      },
+      "engines": {
+        "node": ">= 18"
+      }
+    },
     "node_modules/minimatch": {
       "version": "9.0.9",
       "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.9.tgz",

package/scaffold/spec-site/package.json

@@ -9,7 +9,10 @@
   },
   "dependencies": {
     "vue": "^3.5.27",
-    "vue-router": "^4.5.0"
+    "vue-router": "^4.5.0",
+    "dompurify": "^3.2.0",
+    "marked": "^15.0.0",
+    "lucide-vue-next": "^0.470.0"
   },
   "devDependencies": {
     "@vitejs/plugin-vue": "^5.2.3",

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

@@ -122,6 +122,10 @@ export interface PmStoryRow {
   priority: string
   area: string
   story_points: number | null
+  start_date: string | null
+  due_date: string | null
+  figma_url: string | null
+  related_prs: string | null
   sort_order: number
   created_at: string
   updated_at: string
@@ -134,6 +138,8 @@ export interface PmTaskRow {
   assignee: string | null
   status: string
   description: string | null
+  story_points: number | null
+  due_date: string | null
   sort_order: number
   created_at: string
   updated_at: string