@planu/cli 0.55.0 → 0.57.0

package/dist/engine/doc-generator/portal/kanban-view-builder.js

@@ -0,0 +1,140 @@
+const COLUMNS = [
+    { key: 'draft', label: 'Draft' },
+    { key: 'review', label: 'Review' },
+    { key: 'approved', label: 'Approved' },
+    { key: 'implementing', label: 'Implementing' },
+    { key: 'done', label: 'Done' },
+];
+const DIFFICULTY_CLASSES = {
+    trivial: 'planu-badge-muted',
+    low: 'planu-badge-info',
+    medium: 'planu-badge-warning',
+    high: 'planu-badge-danger',
+    critical: 'planu-badge-danger',
+};
+const RISK_CLASSES = {
+    low: 'planu-badge-success',
+    medium: 'planu-badge-warning',
+    high: 'planu-badge-danger',
+    critical: 'planu-badge-danger',
+};
+/**
+ * Build an HTML fragment (not a full page) containing a kanban board.
+ * Suitable for embedding inside the portal index.html.
+ * Returns empty string when specs is empty.
+ */
+export function buildKanbanView(specs) {
+    if (specs.length === 0) {
+        return '';
+    }
+    const byStatus = new Map();
+    for (const col of COLUMNS) {
+        byStatus.set(col.key, []);
+    }
+    for (const spec of specs) {
+        const col = byStatus.get(spec.status);
+        if (col) {
+            col.push(spec);
+        }
+        else {
+            // Unknown status goes to draft column
+            byStatus.get('draft')?.push(spec);
+        }
+    }
+    const columns = COLUMNS.map(({ key, label }) => {
+        const colSpecs = byStatus.get(key) ?? [];
+        const cards = colSpecs.map((s) => buildCard(s)).join('\n');
+        return `<div class="kanban-col">
+  <div class="kanban-col-header">
+    <span class="kanban-col-title">${escapeHtml(label)}</span>
+    <span class="planu-badge planu-badge-muted">${colSpecs.length}</span>
+  </div>
+  <div class="kanban-cards">
+    ${cards || '<p class="kanban-empty">No specs</p>'}
+  </div>
+</div>`;
+    });
+    return `<style>${KANBAN_CSS}</style>
+<div class="kanban-board" role="region" aria-label="Kanban board">
+  ${columns.join('\n  ')}
+</div>`;
+}
+function buildCard(spec) {
+    const diffClass = DIFFICULTY_CLASSES[spec.difficulty] ?? 'planu-badge-muted';
+    const riskClass = RISK_CLASSES[spec.risk] ?? 'planu-badge-muted';
+    const tags = spec.tags
+        .slice(0, 3)
+        .map((t) => `<span class="kanban-tag">${escapeHtml(t)}</span>`)
+        .join(' ');
+    const shortTitle = spec.title.length > 50 ? spec.title.slice(0, 49) + '…' : spec.title;
+    return `<div class="kanban-card">
+  <div class="kanban-card-id">${escapeHtml(spec.id)}</div>
+  <div class="kanban-card-title">${escapeHtml(shortTitle)}</div>
+  <div class="kanban-card-badges">
+    <span class="planu-badge ${diffClass}">${escapeHtml(String(spec.difficulty))}</span>
+    <span class="planu-badge ${riskClass}">${escapeHtml(spec.risk)}</span>
+  </div>
+  ${tags ? `<div class="kanban-card-tags">${tags}</div>` : ''}
+</div>`;
+}
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+const KANBAN_CSS = `
+  .kanban-board {
+    display: grid;
+    grid-template-columns: repeat(5, 1fr);
+    gap: 12px;
+    overflow-x: auto;
+  }
+  @media (max-width: 900px) {
+    .kanban-board { grid-template-columns: repeat(2, 1fr); }
+  }
+  @media (max-width: 500px) {
+    .kanban-board { grid-template-columns: 1fr; }
+  }
+  .kanban-col {
+    background: #f8f9fa;
+    border: 1px solid #e9ecef;
+    border-radius: 10px;
+    padding: 12px;
+    min-height: 120px;
+  }
+  .kanban-col-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-bottom: 10px;
+  }
+  .kanban-col-title {
+    font-weight: 600;
+    font-size: 0.85rem;
+    color: #1a1a2e;
+  }
+  .kanban-cards { display: flex; flex-direction: column; gap: 8px; }
+  .kanban-card {
+    background: white;
+    border: 1px solid #e9ecef;
+    border-radius: 8px;
+    padding: 10px;
+    box-shadow: 0 1px 2px rgba(0,0,0,0.04);
+  }
+  .kanban-card-id { font-size: 0.7rem; color: #9ca3af; margin-bottom: 4px; }
+  .kanban-card-title { font-size: 0.82rem; color: #2d3436; margin-bottom: 6px; line-height: 1.3; }
+  .kanban-card-badges { display: flex; gap: 4px; flex-wrap: wrap; margin-bottom: 4px; }
+  .kanban-card-tags { display: flex; gap: 4px; flex-wrap: wrap; margin-top: 4px; }
+  .kanban-tag {
+    font-size: 0.68rem;
+    background: #eff6ff;
+    color: #1d4ed8;
+    padding: 1px 6px;
+    border-radius: 99px;
+  }
+  .kanban-empty { font-size: 0.78rem; color: #9ca3af; text-align: center; padding: 12px 0; }
+  @media print { .kanban-board { display: none; } }
+`;
+//# sourceMappingURL=kanban-view-builder.js.map

package/dist/engine/doc-generator/portal/kanban-view-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kanban-view-builder.js","sourceRoot":"","sources":["../../../../src/engine/doc-generator/portal/kanban-view-builder.ts"],"names":[],"mappings":"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"}

package/dist/engine/doc-generator/portal/portal-breadcrumbs.d.ts

@@ -0,0 +1,27 @@
+import type { BreadcrumbItem } from '../../../types/docs.js';
+export type { BreadcrumbItem };
+/**
+ * Build a breadcrumb trail.
+ * Last item is rendered as plain text (current page); all others are links.
+ *
+ * Example: buildBreadcrumbs([
+ *   { label: 'Dashboard', href: '../../index.html' },
+ *   { label: 'SPEC-141', href: './executive-report.html' },
+ *   { label: 'Executive Report' },
+ * ])
+ */
+export declare function buildBreadcrumbs(items: BreadcrumbItem[]): string;
+/**
+ * Build prev/next spec navigation links shown at the bottom of per-spec reports.
+ *
+ * @param currentSpecId - e.g. "SPEC-141"
+ * @param allSpecIds - All known spec IDs (used to find neighbours by numeric order).
+ * @param basePath - Path from current file to planu/specs/ directory, e.g. "../".
+ *                   Each neighbour link appends "{SPEC-ID-slug}/executive-report.html"
+ *                   but since we only have IDs (not slugs), we use the ID as-is.
+ *                   Callers can pass slug-aware paths if needed.
+ * @param reportFilename - The report file to link to in neighbour specs (e.g. "executive-report.html").
+ * @param specFolderFn - Optional function to resolve spec ID → folder name. Defaults to identity.
+ */
+export declare function buildSpecNavigation(currentSpecId: string, allSpecIds: string[], basePath: string, reportFilename?: string, specFolderFn?: (specId: string) => string): string;
+//# sourceMappingURL=portal-breadcrumbs.d.ts.map

package/dist/engine/doc-generator/portal/portal-breadcrumbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-breadcrumbs.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/portal/portal-breadcrumbs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,YAAY,EAAE,cAAc,EAAE,CAAC;AA6D/B;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAoBhE;AAiCD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAAE,EACpB,QAAQ,EAAE,MAAM,EAChB,cAAc,SAA0B,EACxC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GACxC,MAAM,CAuBR"}

package/dist/engine/doc-generator/portal/portal-breadcrumbs.js

@@ -0,0 +1,139 @@
+function getBreadcrumbCss() {
+    return `
+  .planu-breadcrumbs {
+    font-size: 0.82rem;
+    color: #6b7280;
+    margin-bottom: 16px;
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    flex-wrap: wrap;
+  }
+  .planu-breadcrumbs a {
+    color: var(--planu-info, #3498db);
+    text-decoration: none;
+  }
+  .planu-breadcrumbs a:hover { text-decoration: underline; }
+  .planu-breadcrumbs .sep { color: #9ca3af; }
+  .planu-breadcrumbs .current { color: #374151; font-weight: 500; }
+  .planu-spec-nav {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    padding: 12px 0;
+    margin-top: 24px;
+    border-top: 1px solid #e5e7eb;
+    font-size: 0.82rem;
+    gap: 8px;
+  }
+  .planu-spec-nav a {
+    color: var(--planu-info, #3498db);
+    text-decoration: none;
+    padding: 6px 12px;
+    border: 1px solid #e5e7eb;
+    border-radius: 6px;
+    transition: background 0.15s;
+  }
+  .planu-spec-nav a:hover { background: #f3f4f6; }
+  .planu-spec-nav .center-link {
+    color: #6b7280;
+    text-decoration: none;
+    padding: 6px 12px;
+    border: 1px solid #e5e7eb;
+    border-radius: 6px;
+  }
+  .planu-spec-nav .center-link:hover { background: #f3f4f6; }
+  .planu-spec-nav .spacer { flex: 1; }
+  @media print {
+    .planu-breadcrumbs, .planu-spec-nav { display: none !important; }
+  }`;
+}
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+/**
+ * Build a breadcrumb trail.
+ * Last item is rendered as plain text (current page); all others are links.
+ *
+ * Example: buildBreadcrumbs([
+ *   { label: 'Dashboard', href: '../../index.html' },
+ *   { label: 'SPEC-141', href: './executive-report.html' },
+ *   { label: 'Executive Report' },
+ * ])
+ */
+export function buildBreadcrumbs(items) {
+    if (items.length === 0) {
+        return '';
+    }
+    const parts = items.map((item, idx) => {
+        const isLast = idx === items.length - 1;
+        if (isLast || !item.href) {
+            return `<span class="current">${escapeHtml(item.label)}</span>`;
+        }
+        return `<a href="${escapeHtml(item.href)}">${escapeHtml(item.label)}</a>`;
+    });
+    const separator = `<span class="sep" aria-hidden="true">›</span>`;
+    const trail = parts.join(` ${separator} `);
+    return `<style>${getBreadcrumbCss()}</style>
+<nav class="planu-breadcrumbs" aria-label="Breadcrumb">
+  ${trail}
+</nav>`;
+}
+/** Extract numeric ID from a spec ID string like "SPEC-141" */
+function extractSpecNumber(specId) {
+    const m = /SPEC-(\d+)/i.exec(specId);
+    return m?.[1] !== undefined ? parseInt(m[1], 10) : 0;
+}
+/**
+ * Extracts the folder slug from a spec ID + array of known spec IDs mapped to folder names.
+ * Since we only have IDs, we return the neighbouring ID and caller must compute the path.
+ */
+function findNeighbours(currentSpecId, allSpecIds) {
+    const currentNum = extractSpecNumber(currentSpecId);
+    // Sort all IDs numerically
+    const sorted = [...allSpecIds].sort((a, b) => extractSpecNumber(a) - extractSpecNumber(b));
+    const currentIdx = sorted.findIndex((id) => extractSpecNumber(id) === currentNum);
+    if (currentIdx === -1) {
+        return { prev: null, next: null };
+    }
+    return {
+        prev: currentIdx > 0 ? (sorted[currentIdx - 1] ?? null) : null,
+        next: currentIdx < sorted.length - 1 ? (sorted[currentIdx + 1] ?? null) : null,
+    };
+}
+/**
+ * Build prev/next spec navigation links shown at the bottom of per-spec reports.
+ *
+ * @param currentSpecId - e.g. "SPEC-141"
+ * @param allSpecIds - All known spec IDs (used to find neighbours by numeric order).
+ * @param basePath - Path from current file to planu/specs/ directory, e.g. "../".
+ *                   Each neighbour link appends "{SPEC-ID-slug}/executive-report.html"
+ *                   but since we only have IDs (not slugs), we use the ID as-is.
+ *                   Callers can pass slug-aware paths if needed.
+ * @param reportFilename - The report file to link to in neighbour specs (e.g. "executive-report.html").
+ * @param specFolderFn - Optional function to resolve spec ID → folder name. Defaults to identity.
+ */
+export function buildSpecNavigation(currentSpecId, allSpecIds, basePath, reportFilename = 'executive-report.html', specFolderFn) {
+    if (allSpecIds.length === 0) {
+        return '';
+    }
+    const { prev, next } = findNeighbours(currentSpecId, allSpecIds);
+    const resolveFolder = specFolderFn ?? ((id) => id);
+    const prevLink = prev
+        ? `<a href="${escapeHtml(basePath)}${escapeHtml(resolveFolder(prev))}/${escapeHtml(reportFilename)}">← ${escapeHtml(prev)}</a>`
+        : `<span style="opacity:0.3">← Prev</span>`;
+    const nextLink = next
+        ? `<a href="${escapeHtml(basePath)}${escapeHtml(resolveFolder(next))}/${escapeHtml(reportFilename)}">${escapeHtml(next)} →</a>`
+        : `<span style="opacity:0.3">Next →</span>`;
+    const dashboardHref = `${escapeHtml(basePath)}../index.html`;
+    return `<div class="planu-spec-nav">
+  ${prevLink}
+  <a href="${dashboardHref}" class="center-link">📋 Dashboard</a>
+  ${nextLink}
+</div>`;
+}
+//# sourceMappingURL=portal-breadcrumbs.js.map

package/dist/engine/doc-generator/portal/portal-breadcrumbs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-breadcrumbs.js","sourceRoot":"","sources":["../../../../src/engine/doc-generator/portal/portal-breadcrumbs.ts"],"names":[],"mappings":"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"}

package/dist/engine/doc-generator/portal/portal-landing-cards.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Build the Quick Links section rendered between the navbar and the spec table
+ * in planu/index.html. Cards that aren't yet generated are rendered greyed out.
+ *
+ * @param availablePages - Page keys that exist on disk (e.g. ['proposal', 'executive-summary']).
+ */
+export declare function buildQuickLinksSection(availablePages: string[]): string;
+//# sourceMappingURL=portal-landing-cards.d.ts.map

package/dist/engine/doc-generator/portal/portal-landing-cards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-landing-cards.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/portal/portal-landing-cards.ts"],"names":[],"mappings":"AAkJA;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM,CAiCvE"}

package/dist/engine/doc-generator/portal/portal-landing-cards.js

@@ -0,0 +1,177 @@
+const PAGE_CARDS = [
+    {
+        key: 'proposal',
+        icon: '📝',
+        title: 'Proposal',
+        description: 'Executive business proposal for stakeholders',
+        filename: 'proposal.html',
+    },
+    {
+        key: 'executive-summary',
+        icon: '📊',
+        title: 'Executive Summary',
+        description: 'Cross-project overview: metrics, risks, and architecture',
+        filename: 'executive-summary.html',
+    },
+    {
+        key: 'roadmap',
+        icon: '🗺️',
+        title: 'Roadmap',
+        description: 'Timeline and milestone planning across all specs',
+        filename: 'roadmap.html',
+    },
+    {
+        key: 'analytics',
+        icon: '📈',
+        title: 'Analytics',
+        description: 'Velocity, estimates vs actuals, trend analysis',
+        filename: 'analytics.html',
+    },
+    {
+        key: 'risks',
+        icon: '⚠️',
+        title: 'Risks',
+        description: 'Risk register and mitigation strategies',
+        filename: 'risks.html',
+    },
+    {
+        key: 'decisions',
+        icon: '🏛️',
+        title: 'Decisions',
+        description: 'Architectural decisions log (ADRs)',
+        filename: 'decisions.html',
+    },
+    {
+        key: 'architecture',
+        icon: '🔧',
+        title: 'Architecture',
+        description: 'System architecture diagrams and documentation',
+        filename: 'architecture.html',
+    },
+    {
+        key: 'changelog',
+        icon: '📋',
+        title: 'Changelog',
+        description: 'Release history and change tracking',
+        filename: 'changelog.html',
+    },
+];
+function getLandingCardsCss() {
+    return `
+  .planu-quick-links {
+    margin-bottom: 28px;
+  }
+  .planu-quick-links h2 {
+    font-size: 1rem;
+    font-weight: 600;
+    color: #374151;
+    margin-bottom: 14px;
+    text-transform: uppercase;
+    letter-spacing: 0.06em;
+    font-size: 0.78rem;
+  }
+  .planu-cards-grid {
+    display: grid;
+    grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
+    gap: 12px;
+  }
+  .planu-page-card {
+    background: white;
+    border: 1px solid #e5e7eb;
+    border-radius: 10px;
+    padding: 14px 16px;
+    display: flex;
+    align-items: flex-start;
+    gap: 12px;
+    text-decoration: none;
+    color: inherit;
+    transition: box-shadow 0.15s, border-color 0.15s;
+    box-shadow: 0 1px 3px rgba(0,0,0,0.05);
+  }
+  .planu-page-card:hover {
+    box-shadow: 0 4px 12px rgba(0,0,0,0.1);
+    border-color: #a5b4fc;
+  }
+  .planu-page-card.unavailable {
+    opacity: 0.45;
+    pointer-events: none;
+    cursor: default;
+  }
+  .planu-card-icon {
+    font-size: 1.5rem;
+    line-height: 1;
+    flex-shrink: 0;
+  }
+  .planu-card-body { flex: 1; min-width: 0; }
+  .planu-card-title {
+    font-weight: 600;
+    font-size: 0.88rem;
+    color: #111827;
+    margin-bottom: 3px;
+    display: flex;
+    align-items: center;
+    gap: 6px;
+  }
+  .planu-card-desc {
+    font-size: 0.76rem;
+    color: #6b7280;
+    line-height: 1.4;
+  }
+  .planu-avail-badge {
+    display: inline-block;
+    padding: 1px 6px;
+    border-radius: 99px;
+    font-size: 0.65rem;
+    font-weight: 600;
+    flex-shrink: 0;
+  }
+  .planu-avail-badge.available   { background: #d1fae5; color: #065f46; }
+  .planu-avail-badge.unavailable { background: #f3f4f6; color: #9ca3af; }
+  @media (max-width: 640px) {
+    .planu-cards-grid { grid-template-columns: repeat(2, 1fr); }
+  }`;
+}
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+/**
+ * Build the Quick Links section rendered between the navbar and the spec table
+ * in planu/index.html. Cards that aren't yet generated are rendered greyed out.
+ *
+ * @param availablePages - Page keys that exist on disk (e.g. ['proposal', 'executive-summary']).
+ */
+export function buildQuickLinksSection(availablePages) {
+    const availableSet = new Set(availablePages);
+    const cards = PAGE_CARDS.map((card) => {
+        const isAvailable = availableSet.has(card.key);
+        const badgeClass = isAvailable ? 'available' : 'unavailable';
+        const badgeLabel = isAvailable ? 'Available' : 'Not generated';
+        const cardClass = isAvailable ? 'planu-page-card' : 'planu-page-card unavailable';
+        const href = isAvailable ? escapeHtml(card.filename) : '#';
+        return `<a href="${href}" class="${cardClass}" ${isAvailable ? '' : 'tabindex="-1" aria-disabled="true"'}>
+  <div class="planu-card-icon">${card.icon}</div>
+  <div class="planu-card-body">
+    <div class="planu-card-title">
+      ${escapeHtml(card.title)}
+      <span class="planu-avail-badge ${badgeClass}">${badgeLabel}</span>
+    </div>
+    <div class="planu-card-desc">${escapeHtml(card.description)}</div>
+  </div>
+</a>`;
+    }).join('\n');
+    if (PAGE_CARDS.length === 0) {
+        return '';
+    }
+    return `<style>${getLandingCardsCss()}</style>
+<section class="planu-quick-links">
+  <h2>Portal Pages</h2>
+  <div class="planu-cards-grid">
+${cards}
+  </div>
+</section>`;
+}
+//# sourceMappingURL=portal-landing-cards.js.map

package/dist/engine/doc-generator/portal/portal-landing-cards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-landing-cards.js","sourceRoot":"","sources":["../../../../src/engine/doc-generator/portal/portal-landing-cards.ts"],"names":[],"mappings":"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"}

package/dist/engine/doc-generator/portal/portal-navbar.d.ts

@@ -0,0 +1,15 @@
+import type { PortalNavItem } from '../../../types/docs.js';
+export type { PortalNavItem };
+/** All portal pages in display order */
+export declare const NAV_ITEMS: PortalNavItem[];
+/**
+ * Build a horizontal portal navbar.
+ *
+ * @param activePage - Key of the current page (e.g. 'dashboard', 'executive-summary').
+ * @param basePath - Relative path prefix to reach planu/ root (e.g. '' for index.html,
+ *                   '../../' for per-spec reports inside planu/specs/SPEC-XXX/).
+ * @param availablePages - List of page keys that exist on disk. Pages not in this list
+ *                         are rendered greyed-out and non-clickable. Defaults to all pages.
+ */
+export declare function buildNavbar(activePage: string, basePath: string, availablePages?: string[]): string;
+//# sourceMappingURL=portal-navbar.d.ts.map

package/dist/engine/doc-generator/portal/portal-navbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-navbar.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/portal/portal-navbar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,wCAAwC;AACxC,eAAO,MAAM,SAAS,EAAE,aAAa,EAepC,CAAC;AAgGF;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,MAAM,CA6BR"}