@kennethsolomon/shipkit 3.4.0 → 3.6.0

package/skills/sk:dashboard/server.js

@@ -0,0 +1,203 @@
+// ShipKit Dashboard — zero-dependency Node.js server
+const http = require("http");
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+
+const PORT =
+  parseInt(process.argv.find((_, i, a) => a[i - 1] === "--port") || process.env.PORT, 10) || 3333;
+
+const HARD_GATES = new Set([12, 14, 16, 20, 22]);
+const OPTIONALS = new Set([4, 5, 8, 18, 27]);
+
+function stripMd(s) {
+  return (s || "").replace(/\*\*/g, "").replace(/`/g, "").trim();
+}
+
+function discoverWorktrees() {
+  try {
+    const raw = execSync("git worktree list", { encoding: "utf8" });
+    return raw
+      .trim()
+      .split("\n")
+      .filter(Boolean)
+      .map((line) => {
+        const branchMatch = line.match(/^(.+?)\s+[0-9a-f]+\s+\[(.+?)\]$/);
+        if (branchMatch) return { path: branchMatch[1].trim(), branch: branchMatch[2].trim() };
+        const detachedMatch = line.match(/^(.+?)\s+[0-9a-f]+\s+\((.+?)\)$/);
+        if (detachedMatch) return { path: detachedMatch[1].trim(), branch: detachedMatch[2].trim() };
+        return null;
+      })
+      .filter(Boolean);
+  } catch {
+    return [{ path: process.cwd(), branch: "unknown" }];
+  }
+}
+
+function parseWorkflowStatus(worktreePath) {
+  const filePath = path.join(worktreePath, "tasks", "workflow-status.md");
+  try {
+    const lines = fs.readFileSync(filePath, "utf8").split("\n");
+
+    let headerFound = false;
+    let separatorSkipped = false;
+    const steps = [];
+
+    for (const line of lines) {
+      if (!headerFound) {
+        if (line.includes("| # |")) headerFound = true;
+        continue;
+      }
+      if (!separatorSkipped) {
+        separatorSkipped = true;
+        continue;
+      }
+      const cells = line.split("|").slice(1, -1).map((c) => c.trim());
+      if (cells.length < 3) continue;
+
+      const number = parseInt(cells[0], 10);
+      if (isNaN(number)) continue;
+
+      const rawStep = stripMd(cells[1]);
+      const cmdMatch = rawStep.match(/\((.+?)\)/);
+      const command = cmdMatch ? cmdMatch[1].trim() : "";
+      const name = rawStep.replace(/\s*\(.+?\)\s*/, "").trim();
+
+      steps.push({
+        number,
+        name,
+        command,
+        status: stripMd(cells[2]),
+        notes: stripMd(cells[3]),
+        isHardGate: HARD_GATES.has(number),
+        isOptional: OPTIONALS.has(number),
+      });
+    }
+    return steps;
+  } catch (err) {
+    if (err.code === "ENOENT") return [];
+    process.stderr.write(`Error parsing workflow-status.md: ${err.message}\n`);
+    return [];
+  }
+}
+
+const STOP_HEADERS = new Set(["Verification", "Acceptance Criteria", "Risks", "Change Log", "Summary"]);
+
+function parseTodo(worktreePath) {
+  const filePath = path.join(worktreePath, "tasks", "todo.md");
+  try {
+    const lines = fs.readFileSync(filePath, "utf8").split("\n");
+
+    let taskName = "";
+    let done = 0;
+    let total = 0;
+    let section = "";
+    let inMilestones = false;
+    let pastMilestones = false;
+    const todoItems = [];
+
+    for (const line of lines) {
+      if (!taskName && line.startsWith("# TODO")) {
+        const dashIdx = line.indexOf("—");
+        if (dashIdx !== -1) taskName = line.slice(dashIdx + 1).trim();
+        else taskName = line.replace(/^#\s*TODO\s*/, "").trim();
+      }
+
+      if (line.startsWith("## ")) {
+        const header = line.slice(3).trim();
+        if (header.startsWith("Milestone")) {
+          inMilestones = true;
+          section = header;
+        } else if (inMilestones && STOP_HEADERS.has(header)) {
+          pastMilestones = true;
+        }
+      }
+
+      if (/^\s*-\s*\[x\]/i.test(line)) {
+        done++;
+        total++;
+        if (inMilestones && !pastMilestones) {
+          todoItems.push({ text: stripMd(line.replace(/^\s*-\s*\[x\]\s*/i, "")), done: true, section });
+        }
+      } else if (/^\s*-\s*\[\s\]/.test(line)) {
+        total++;
+        if (inMilestones && !pastMilestones) {
+          todoItems.push({ text: stripMd(line.replace(/^\s*-\s*\[\s\]\s*/, "")), done: false, section });
+        }
+      }
+    }
+    return { taskName, todosDone: done, todosTotal: total, todoItems };
+  } catch (err) {
+    if (err.code === "ENOENT") return { taskName: "", todosDone: 0, todosTotal: 0, todoItems: [] };
+    process.stderr.write(`Error parsing todo.md: ${err.message}\n`);
+    return { taskName: "", todosDone: 0, todosTotal: 0, todoItems: [] };
+  }
+}
+
+function buildStatus() {
+  const worktrees = discoverWorktrees();
+  return worktrees.map((wt) => {
+    const steps = parseWorkflowStatus(wt.path);
+    const todo = parseTodo(wt.path);
+
+    let currentStep = 0;
+    let totalDone = 0;
+    let totalSkipped = 0;
+    for (const s of steps) {
+      if (s.status === ">> next <<") currentStep = s.number;
+      if (s.status === "done") totalDone++;
+      if (s.status === "skipped") totalSkipped++;
+    }
+
+    return {
+      path: wt.path,
+      branch: wt.branch,
+      taskName: todo.taskName,
+      todosDone: todo.todosDone,
+      todosTotal: todo.todosTotal,
+      todoItems: todo.todoItems,
+      currentStep,
+      totalDone,
+      totalSkipped,
+      totalSteps: steps.length,
+      steps,
+    };
+  });
+}
+
+const server = http.createServer((req, res) => {
+  res.setHeader("Access-Control-Allow-Origin", "*");
+
+  if (req.method === "GET" && req.url === "/") {
+    const htmlPath = path.join(__dirname, "dashboard.html");
+    try {
+      const html = fs.readFileSync(htmlPath, "utf8");
+      res.writeHead(200, { "Content-Type": "text/html" });
+      res.end(html);
+    } catch {
+      res.writeHead(404, { "Content-Type": "text/plain" });
+      res.end("dashboard.html not found");
+    }
+    return;
+  }
+
+  if (req.method === "GET" && req.url === "/api/status") {
+    try {
+      const data = buildStatus();
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify(data));
+    } catch (err) {
+      process.stderr.write(`Error building status: ${err.message}\n`);
+      res.writeHead(500, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ error: "Internal server error" }));
+    }
+    return;
+  }
+
+  res.writeHead(404, { "Content-Type": "text/plain" });
+  res.end("Not found");
+});
+
+server.listen(PORT, () => {
+  console.log(`ShipKit Dashboard running at http://localhost:${PORT}`);
+});

package/skills/sk:mvp/SKILL.md

@@ -215,7 +215,84 @@ Maximum 3 loop iterations. If issues persist after 3 loops, present remaining is
 
 ---
 
-## Step 9 — Present the Output
+## Step 9 — Generate Project Context Docs
+
+Generate 3 lightweight documentation files in `docs/` from information already gathered in Steps 1-2. No new questions — use the product name, value prop, audience, features, and tech stack already captured.
+
+### Files to Generate
+
+**`docs/vision.md`**
+```markdown
+# [Product Name]
+
+## Value Proposition
+[One-line value prop from Step 1]
+
+## Target Audience
+[Target audience from Step 1]
+
+## Key Features
+[Bullet list of 3-5 features from Step 1]
+
+## North Star Metric
+[Suggest one metric that measures core value — e.g., "weekly active waitlist signups" or "daily feature usage"]
+```
+
+**`docs/prd.md`**
+```markdown
+# PRD — [Product Name]
+
+## Overview
+[1-2 sentence product description]
+
+## User Stories
+[For each key feature from Step 1, write a user story: "As a [audience], I want to [feature] so that [benefit]"]
+
+## Feature Acceptance Criteria
+[For each feature, list 2-3 concrete acceptance criteria]
+
+## Out of Scope (MVP)
+- Real authentication
+- Real database
+- Third-party integrations
+- Deployment
+```
+
+**`docs/tech-design.md`**
+```markdown
+# Tech Design — [Product Name]
+
+## Stack
+- **Framework:** [chosen stack from Step 2]
+- **Styling:** Tailwind CSS
+- **Fonts:** [chosen fonts]
+
+## Project Structure
+[List the key directories and files generated during scaffolding]
+
+## Component Map
+### Landing Page
+[List all 9 sections and their components]
+
+### App Pages
+[List each page and its key components]
+
+## Data Model
+### Waitlist
+- email: string (validated)
+- timestamp: ISO 8601 string
+
+### Fake Data Entities
+[List the fake data structures used in the app]
+```
+
+After generating the docs, output:
+> **Context docs generated:** `docs/vision.md`, `docs/prd.md`, `docs/tech-design.md`
+> These persist context for future sessions. Run `/sk:context` to load `docs/vision.md` into the session brief, or read the others directly.
+
+---
+
+## Step 10 — Present the Output
 
 Summarize what was generated:
 

package/skills/sk:setup-claude/templates/CLAUDE.md.template

@@ -363,4 +363,5 @@ Create entries in: `[ARCH_CHANGELOG_DIR]`
 | `/sk:features` | Sync feature specs with shipped implementation |
 | `/sk:release` | Version bump + changelog + tag |
 | `/sk:status` | Show workflow + task status |
+| `/sk:context` | Load all context files + output session brief for fast session start |
 | `/sk:setup-optimizer` | Diagnose + update workflow + enrich CLAUDE.md |