@pi-unipi/kanboard 2.20.4 → 3.0.0-alpha.0

package/skills/kanboard-doctor/SKILL.md

@@ -1,71 +0,0 @@
----
-name: kanboard-doctor
-description: "Diagnose and fix kanboard parser issues — validates all workflow documents, reports errors, suggests fixes."
----
-
-# Kanboard Doctor
-
-Diagnose parser issues across all workflow documents. Non-destructive — only suggests fixes, asks user to confirm.
-
-## Phase 1: Run All Parsers
-
-Execute each parser against its document type directory:
-
-1. Load the parser registry from `@pi-unipi/kanboard`
-2. Run `registry.parseAll(".unipi/docs")` to parse all documents
-3. Collect all `ParsedDoc` results including their `warnings` arrays
-
-## Phase 2: Collect Errors
-
-Group warnings and errors by file with line numbers:
-
-1. For each `ParsedDoc` with `warnings.length > 0`:
-   - Group by `filePath`
-   - Include line numbers where available
-   - Categorize: malformed checkboxes, empty fields, parse failures
-2. Also flag documents that returned 0 items (may indicate parsing failure)
-
-## Phase 3: Present Report
-
-Show a structured error report:
-
-```
-📋 Kanboard Doctor Report
-
-Files scanned: N
-Files with issues: M
-
-📄 .unipi/docs/specs/example.md
-  ⚠ Line 15: Empty checkbox text
-  ⚠ Line 23: Malformed checkbox (missing bracket)
-
-📄 .unipi/docs/plans/old-plan.md
-  ⚠ Line 5: Empty task name after status
-```
-
-## Phase 4: Fix One by One
-
-For each issue, suggest a fix and ask user to confirm:
-
-1. Show the problematic line with context
-2. Suggest the corrected version
-3. Ask: "Apply this fix? (y/n)"
-4. If yes, apply the fix using the edit tool
-5. Move to next issue
-
-**Non-destructive rules:**
-- Never modify without asking
-- Show before/after for each change
-- Allow skipping individual fixes
-- Allow "fix all" for simple patterns (e.g., trailing whitespace)
-
-## Phase 5: Re-validate
-
-After each fix, re-run the parser on the modified file:
-
-1. Parse the file again
-2. Verify the specific error is resolved
-3. Check that no new errors were introduced
-4. Report: "✓ Fixed" or "✗ Still has issues"
-
-After all fixes, run full `registry.parseAll()` to confirm clean state.

package/types.ts

@@ -1,67 +0,0 @@
-/**
- * @pi-unipi/kanboard — Shared types
- */
-
-/** Document types that kanboard can parse */
-export type DocType =
-  | "spec"
-  | "plan"
-  | "milestone"
-  | "quick-work"
-  | "debug"
-  | "fix"
-  | "chore"
-  | "review";
-
-/** Status of a parsed item */
-export type ItemStatus = "todo" | "in-progress" | "done" | "reviewed";
-
-/** A single parsed item from a document */
-export interface ParsedItem {
-  /** Item text content */
-  text: string;
-  /** Current status */
-  status: ItemStatus;
-  /** Line number in source file (1-indexed) */
-  lineNumber: number;
-  /** Source file path (relative) */
-  sourceFile: string;
-  /** Copy command for this item */
-  command?: string;
-}
-
-/** A parsed document */
-export interface ParsedDoc {
-  /** Document type */
-  type: DocType;
-  /** Document title (from frontmatter or filename) */
-  title: string;
-  /** File path (relative) */
-  filePath: string;
-  /** Parsed items */
-  items: ParsedItem[];
-  /** Frontmatter metadata */
-  metadata: Record<string, string>;
-  /** Warnings collected during parsing */
-  warnings: string[];
-}
-
-/** Parser interface — each doc type implements this */
-export interface DocParser {
-  /** Check if this parser can handle the given file */
-  canParse(filePath: string): boolean;
-  /** Parse the file and return a ParsedDoc */
-  parse(filePath: string): ParsedDoc;
-}
-
-/** Kanboard configuration */
-export interface KanboardConfig {
-  /** HTTP server port */
-  port: number;
-  /** Maximum port to try */
-  maxPort: number;
-  /** Root directory for docs */
-  docsRoot: string;
-  /** PID file path */
-  pidFile: string;
-}

package/ui/components/checklist.ts

@@ -1,58 +0,0 @@
-/**
- * @pi-unipi/kanboard — Checklist Component
- *
- * Reusable checklist renderer with status indicators and copy buttons.
- */
-
-import type { ParsedItem } from "../../types.js";
-
-/** Escape HTML */
-function esc(text: string): string {
-  return text
-    .replace(/&/g, "&")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;")
-    .replace(/"/g, "&quot;")
-    .replace(/'/g, "&#39;");
-}
-
-/** Status icon */
-function statusIcon(status: string): string {
-  switch (status) {
-    case "done":
-      return "✓";
-    case "in-progress":
-      return "◐";
-    default:
-      return "○";
-  }
-}
-
-/**
- * Render a checklist of items.
- */
-export function renderChecklist(items: ParsedItem[]): string {
-  if (items.length === 0) {
-    return '<div class="empty-state"><p class="empty-state-text">No items</p></div>';
-  }
-
-  const rows = items
-    .map(
-      (item) => `
-    <li class="checklist-item">
-      <span class="checklist-status ${item.status}" aria-label="${item.status}">
-        <span aria-hidden="true">${statusIcon(item.status)}</span>
-        <span class="visually-hidden">${item.status}</span>
-      </span>
-      <span class="checklist-text${item.status === "done" ? " done" : ""}">${esc(item.text)}</span>
-      ${
-        item.command
-          ? `<button class="copy-btn" onclick="copyToClipboard('${esc(item.command)}', event)" aria-label="Copy ${esc(item.command)} to clipboard">${esc(item.command)}</button>`
-          : ""
-      }
-    </li>`,
-    )
-    .join("\n");
-
-  return `<ul class="checklist">${rows}</ul>`;
-}

package/ui/components/copy-button.ts

@@ -1,23 +0,0 @@
-/**
- * @pi-unipi/kanboard — Copy Button Component
- *
- * Reusable copy-to-clipboard button with visual feedback.
- */
-
-/** Escape HTML */
-function esc(text: string): string {
-  return text
-    .replace(/&/g, "&")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;")
-    .replace(/"/g, "&quot;")
-    .replace(/'/g, "&#39;");
-}
-
-/**
- * Render a copy-to-clipboard button.
- */
-export function renderCopyButton(text: string, label?: string): string {
-  const displayLabel = label ?? (text.length > 40 ? text.slice(0, 37) + "..." : text);
-  return `<button class="copy-btn" onclick="copyToClipboard('${esc(text)}', event)" title="${esc(text)}" aria-label="Copy ${esc(displayLabel)} to clipboard">${esc(displayLabel)}</button>`;
-}

package/ui/components/status-badge.ts

@@ -1,21 +0,0 @@
-/**
- * @pi-unipi/kanboard — Status Badge Component
- *
- * Color-coded status badge for items.
- */
-
-/** Status badge labels */
-const BADGE_LABELS: Record<string, string> = {
-  done: "Done",
-  "in-progress": "In Progress",
-  todo: "To Do",
-  reviewed: "Reviewed",
-};
-
-/**
- * Render a status badge.
- */
-export function renderStatusBadge(status: string): string {
-  const label = BADGE_LABELS[status] ?? status;
-  return `<span class="badge badge-${status}">${label}</span>`;
-}

package/ui/layouts/base.ts

@@ -1,68 +0,0 @@
-/**
- * @pi-unipi/kanboard — Base HTML Layout
- *
- * Shared layout for all kanboard web pages.
- * Includes htmx + Alpine.js CDN, Google Fonts, and responsive layout.
- */
-
-/** Active page type */
-export type ActivePage = "milestones" | "workflow";
-
-/**
- * Render the full HTML layout wrapping page content.
- */
-export function renderLayout(
-  title: string,
-  content: string,
-  activePage: ActivePage,
-): string {
-  return `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${escapeHtml(title)} — Kanboard</title>
-  <script src="https://unpkg.com/htmx.org@1.9.12"></script>
-  <script defer src="https://unpkg.com/alpinejs@3.14.3/dist/cdn.min.js"></script>
-  <link rel="preconnect" href="https://fonts.googleapis.com">
-  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=Bodoni+Moda:ital,opsz,wght@1,6..96,400..900&family=Onest:wght@100..900&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
-  <link rel="stylesheet" href="/static/style.css">
-</head>
-<body>
-  <nav class="navbar">
-    <div class="nav-brand">
-      <span class="nav-icon">✦</span>
-      <span class="nav-title">Kanboard</span>
-    </div>
-    <div class="nav-links">
-      <a href="/" class="nav-link ${activePage === "milestones" ? "active" : ""}" ${activePage === "milestones" ? 'aria-current="page"' : ""}>
-        Milestones
-      </a>
-      <a href="/workflow" class="nav-link ${activePage === "workflow" ? "active" : ""}" ${activePage === "workflow" ? 'aria-current="page"' : ""}>
-        Workflow
-      </a>
-    </div>
-  </nav>
-
-  <main class="container">
-    ${content}
-  </main>
-
-  <footer class="footer">
-    <span>pi-unipi / kanboard</span>
-  </footer>
-
-  <script src="/static/app.js"></script>
-</body>
-</html>`;
-}
-
-/** Escape HTML special characters */
-function escapeHtml(text: string): string {
-  return text
-    .replace(/&/g, "&amp;")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;")
-    .replace(/"/g, "&quot;");
-}

package/ui/milestone/page.ts

@@ -1,140 +0,0 @@
-/**
- * @pi-unipi/kanboard — Milestone Page
- *
- * Renders the milestone page with phases, progress bars, and checklists.
- */
-
-import type { ParsedDoc, ParsedItem } from "../../types.js";
-import { renderLayout } from "../layouts/base.js";
-
-/** Escape HTML special characters */
-function esc(text: string): string {
-  return text
-    .replace(/&/g, "&")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;")
-    .replace(/"/g, "&quot;");
-}
-
-/** Render status icon for an item */
-function statusIcon(status: string): string {
-  switch (status) {
-    case "done":
-      return "✓";
-    case "in-progress":
-      return "◐";
-    default:
-      return "○";
-  }
-}
-
-/** Render a single checklist item */
-function renderItem(item: ParsedItem): string {
-  const doneClass = item.status === "done" ? " done" : "";
-  const commandBtn = item.command
-    ? `<button class="copy-btn" onclick="copyToClipboard('${esc(item.command)}', event)" aria-label="Copy ${esc(item.command)} to clipboard">${esc(item.command)}</button>`
-    : "";
-
-  return `
-    <li class="checklist-item">
-      <span class="checklist-status ${item.status}" aria-label="${item.status}">
-        <span aria-hidden="true">${statusIcon(item.status)}</span>
-        <span class="visually-hidden">${item.status}</span>
-      </span>
-      <span class="checklist-text${doneClass}">${esc(item.text)}</span>
-      ${commandBtn}
-    </li>`;
-}
-
-/** Render the milestone page */
-export function renderMilestonePage(docs: ParsedDoc[]): string {
-  if (docs.length === 0) {
-    const content = `
-      <div class="page-header">
-        <h1 class="page-title">Milestones</h1>
-        <p class="page-subtitle">Track project progress</p>
-      </div>
-      <div class="empty-state">
-        <div class="empty-state-icon">✦</div>
-        <p class="empty-state-text">No MILESTONES.md found</p>
-      </div>`;
-    return renderLayout("Milestones", content, "milestones");
-  }
-
-  const doc = docs[0];
-  const totalItems = doc.items.length;
-  const doneItems = doc.items.filter((i) => i.status === "done").length;
-  const percent = totalItems > 0 ? Math.round((doneItems / totalItems) * 100) : 0;
-
-  const phases = groupByPhase(doc.items);
-
-  let phasesHtml = "";
-  for (const [phase, items] of Object.entries(phases)) {
-    const phaseTotal = items.length;
-    const phaseDone = items.filter((i) => i.status === "done").length;
-    const phasePercent = phaseTotal > 0 ? Math.round((phaseDone / phaseTotal) * 100) : 0;
-
-    phasesHtml += `
-      <div class="section">
-        <button type="button" class="section-header" aria-expanded="true" onclick="toggleSection(event)">
-          <span class="section-toggle">▶</span>
-          <div class="section-title-wrap">
-            <h2 class="section-title">${esc(phase)}</h2>
-          </div>
-          <span class="section-count">${phaseDone}/${phaseTotal}</span>
-          <div class="progress-bar" style="--progress: ${phasePercent};">
-            <div class="progress-fill"></div>
-          </div>
-        </button>
-        <div class="section-content">
-          <ul class="checklist">
-            ${items.map(renderItem).join("\n")}
-          </ul>
-        </div>
-      </div>`;
-  }
-
-  const content = `
-    <div class="page-header">
-      <h1 class="page-title">${esc(doc.title)}</h1>
-      <p class="page-subtitle">${doneItems}/${totalItems} items complete</p>
-      <div class="progress-bar" style="--progress: ${percent};">
-        <div class="progress-fill"></div>
-      </div>
-      <div class="page-header-stat">${percent}% complete</div>
-    </div>
-
-    ${phasesHtml}
-
-    ${doc.warnings.length > 0 ? renderWarnings(doc.warnings) : ""}`;
-
-  return renderLayout("Milestones", content, "milestones");
-}
-
-/** Group items by their phase prefix [Phase Name] */
-function groupByPhase(items: ParsedItem[]): Record<string, ParsedItem[]> {
-  const phases: Record<string, ParsedItem[]> = {};
-
-  for (const item of items) {
-    const match = item.text.match(/^\[(.+?)\]\s*(.*)$/);
-    if (match) {
-      const phase = match[1];
-      const text = match[2];
-      if (!phases[phase]) phases[phase] = [];
-      phases[phase].push({ ...item, text });
-    } else {
-      if (!phases["Other"]) phases["Other"] = [];
-      phases["Other"].push(item);
-    }
-  }
-
-  return phases;
-}
-
-/** Render warnings list */
-function renderWarnings(warnings: string[]): string {
-  return `
-    <div class="warnings">
-      ${warnings.map((w) => `<div class="warning-item">${esc(w)}</div>`).join("\n")}
-    </div>`;
-}

package/ui/static/app.js

@@ -1,73 +0,0 @@
-/* @pi-unipi/kanboard — Client-side JavaScript */
-
-/**
- * Copy text to clipboard and show feedback.
- */
-function copyToClipboard(text, event) {
-  navigator.clipboard.writeText(text).then(() => {
-    const btn = event.currentTarget;
-    btn.classList.add("copied");
-    const original = btn.innerHTML;
-    btn.innerHTML = '<span>copied</span>';
-    setTimeout(() => {
-      btn.classList.remove("copied");
-      btn.innerHTML = original;
-    }, 1800);
-  });
-}
-
-/**
- * Toggle a section's expanded state with animation.
- */
-function toggleSection(event) {
-  const header = event.currentTarget;
-  const content = header.nextElementSibling;
-  if (!content) return;
-
-  const wasOpen = header.getAttribute("aria-expanded") === "true";
-  header.setAttribute("aria-expanded", wasOpen ? "false" : "true");
-
-  const prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
-
-  if (!wasOpen) {
-    content.style.display = "block";
-    if (!prefersReducedMotion) {
-      content.style.opacity = "0";
-      content.style.transform = "translateY(-4px)";
-      requestAnimationFrame(() => {
-        content.style.transition = "opacity 0.2s ease, transform 0.2s ease";
-        content.style.opacity = "1";
-        content.style.transform = "translateY(0)";
-      });
-    } else {
-      content.style.opacity = "1";
-      content.style.transform = "translateY(0)";
-    }
-  } else {
-    if (!prefersReducedMotion) {
-      content.style.transition = "opacity 0.15s ease";
-      content.style.opacity = "0";
-      setTimeout(() => {
-        content.style.display = "none";
-      }, 150);
-    } else {
-      content.style.display = "none";
-    }
-  }
-}
-
-/**
- * Alpine.js data for filtering items by status.
- */
-function kanboardFilters() {
-  return {
-    filter: "all",
-    setFilter(f) {
-      this.filter = f;
-    },
-    isVisible(status) {
-      if (this.filter === "all") return true;
-      return status === this.filter;
-    },
-  };
-}