rcf-lite 0.28.2 → 0.29.0

package/src/view/doc-renderers/build.js

@@ -0,0 +1,160 @@
+// Build-tab renderers (viewer UI refresh PR 5, w-2026-10-02-dave-010
+// decisions 2, 3, 6, 12, 14; design doc section 5.6).
+//
+// This module ships the Build tab's own small pieces:
+//   - renderBuildStats(stats): the one-line totals card above the
+//     sub-tabstrip. Totals come from the pre-computed BuildStats
+//     payload the panel assembles from `computeQueue` (Build Queue is
+//     the authoritative source for "buildable now", decision 6 + the
+//     brief evidence row).
+//   - renderBuildPageHead(bs): the one-line page head carrying the BS
+//     id and its generation strategy.
+//   - renderSpecBody(fbs, model, buildable): the body shown inside an
+//     expanded Spec row - summary, approach, AC and dependency links,
+//     deliverables, context links, "Show in the DAG".
+//
+// The list row chrome (DocRow summary with order / AC / deps / size /
+// buildable pill / status) is composed in html-page.js so the row
+// renderer stays close to the FilterBar and the sub-tabstrip wiring.
+//
+// The Test suites section and the FBS slots block are dropped (design
+// doc section 3, decision 6); suites stay reachable through AC links
+// and the ID lookup once PR 7 ships.
+
+import { escapeHtml, rawJsonDisclosure } from './helpers.js';
+
+/**
+ * BuildStats payload shape consumed by renderBuildStats.
+ *
+ * @typedef {object} BuildStatsPayload
+ * @property {number} items
+ * @property {number} verified
+ * @property {number} complete
+ * @property {number} inProgress
+ * @property {number} notStarted
+ * @property {number} buildableNow     actionable count from computeQueue
+ */
+
+/**
+ * @param {BuildStatsPayload} stats
+ * @returns {string}
+ */
+export function renderBuildStats(stats) {
+  const row = [
+    { n: stats.items ?? 0, l: 'build specs' },
+    { n: stats.verified ?? 0, l: 'verified' },
+    { n: stats.complete ?? 0, l: 'complete' },
+    { n: stats.inProgress ?? 0, l: 'in progress' },
+    { n: stats.notStarted ?? 0, l: 'not started' },
+    { n: stats.buildableNow ?? 0, l: 'buildable now' },
+  ];
+  const items = stats.items > 0 ? stats.items : 1;
+  const pct = (n) => Math.max(0, Math.min(100, Math.round((n / items) * 100)));
+  const verifiedPct = pct(stats.verified ?? 0);
+  const completePct = pct(stats.complete ?? 0);
+  const inProgressPct = pct(stats.inProgress ?? 0);
+  const statRow = row.map((s) => (
+    `<div class="rcf-build-stat"><span class="rcf-build-stat-n">${escapeHtml(String(s.n))}</span><span class="rcf-build-stat-l">${escapeHtml(s.l)}</span></div>`
+  )).join('');
+  return `<div class="rcf-build-stats card" role="group" aria-label="Build totals">
+  <div class="rcf-build-stats-row">${statRow}</div>
+  <div class="rcf-build-progress" aria-hidden="true">
+    <span class="rcf-build-progress-seg rcf-build-progress-seg--verified" style="width:${verifiedPct}%"></span>
+    <span class="rcf-build-progress-seg rcf-build-progress-seg--complete" style="width:${completePct}%"></span>
+    <span class="rcf-build-progress-seg rcf-build-progress-seg--inprogress" style="width:${inProgressPct}%"></span>
+  </div>
+</div>`;
+}
+
+/**
+ * @param {object | null | undefined} bs - the Build Sequence doc from the tree
+ * @returns {string}
+ */
+export function renderBuildPageHead(bs) {
+  if (!bs) return `<div class="rcf-build-head"></div>`;
+  const title = typeof bs.title === 'string' ? bs.title : '';
+  const strategy = typeof bs.generationStrategy === 'string' ? bs.generationStrategy : '';
+  const parts = [`<span class="rcf-build-head-id mono">${escapeHtml(bs.bsId ?? 'BS')}</span>`];
+  const detail = [title, strategy].filter((v) => typeof v === 'string' && v.length > 0).join(' - ');
+  if (detail) parts.push(`<span class="muted small">${escapeHtml(detail)}</span>`);
+  return `<div class="rcf-build-head">${parts.join('')}</div>`;
+}
+
+/**
+ * Spec row body: summary, approach, AC and dependency links, deliverables,
+ * context links, and the "Show in the DAG" pointer (DAG panel ships in
+ * PR 6; the hash target is #tab=build&sub=dag&entity=<id>).
+ *
+ * @param {object} fbs
+ * @param {import('../tree-model.js').BuiltTreeModel} model
+ * @param {string} [raw]  raw JSON string for the <details class="raw-json"> disclosure
+ * @returns {string}
+ */
+export function renderSpecBody(fbs, model, raw) {
+  const summary = typeof fbs.summary === 'string' && fbs.summary.length > 0
+    ? `<p class="rcf-spec-summary">${escapeHtml(fbs.summary)}</p>`
+    : '';
+  const approach = typeof fbs.approach === 'string' && fbs.approach.length > 0
+    ? `<section class="rcf-spec-block"><h4>Approach</h4><p>${escapeHtml(fbs.approach)}</p></section>`
+    : '';
+
+  const acIds = Array.isArray(fbs.acIds) ? fbs.acIds : [];
+  const acBlock = acIds.length > 0
+    ? `<section class="rcf-spec-block"><h4>Acceptance criteria (${acIds.length})</h4><p class="rcf-spec-link-row">${acIds.map((id) => renderAcLink(id)).join(', ')}</p></section>`
+    : '';
+
+  const depIds = Array.isArray(fbs.dependsOnFbsIds) ? fbs.dependsOnFbsIds : [];
+  const depBlock = depIds.length > 0
+    ? `<section class="rcf-spec-block"><h4>Depends on</h4><ul class="rcf-spec-deps">${depIds.map((id) => renderDepLine(id, model)).join('')}</ul></section>`
+    : '';
+
+  const deliverables = Array.isArray(fbs.deliverables) ? fbs.deliverables.filter((d) => typeof d === 'string' && d.length > 0) : [];
+  const deliverableBlock = deliverables.length > 0
+    ? `<section class="rcf-spec-block"><h4>Deliverables</h4><ul class="rcf-spec-deliverables">${deliverables.map((d) => `<li>${escapeHtml(d)}</li>`).join('')}</ul></section>`
+    : '';
+
+  const contextBlock = renderContextLinks(fbs.contextRequirements);
+
+  const dagLink = `<p class="rcf-spec-dag"><a href="#tab=build&amp;sub=dag&amp;entity=${escapeHtml(fbs.fbsId ?? '')}">Show in the DAG</a></p>`;
+
+  const rawBlock = rawJsonDisclosure(raw, fbs, fbs.fbsId);
+
+  return `${summary}${approach}${acBlock}${depBlock}${deliverableBlock}${contextBlock}${dagLink}${rawBlock}`;
+}
+
+function renderAcLink(id) {
+  const esc = escapeHtml(id);
+  return `<a class="mono" href="#tab=requirements&amp;entity=${esc}">${esc}</a>`;
+}
+
+function renderDepLine(id, model) {
+  const esc = escapeHtml(id);
+  const dep = model.byId?.get(id);
+  const title = typeof dep?.title === 'string' ? dep.title : '';
+  const titleFrag = title ? ` <span class="muted">${escapeHtml(title)}</span>` : '';
+  return `<li><a class="mono" href="#tab=build&amp;sub=specs&amp;entity=${esc}">${esc}</a>${titleFrag}</li>`;
+}
+
+function renderContextLinks(ctx) {
+  if (!ctx || typeof ctx !== 'object') return '';
+  const parts = [];
+  const tacIds = Array.isArray(ctx.tacIds) ? ctx.tacIds : [];
+  const adrIds = Array.isArray(ctx.adrIds) ? ctx.adrIds : [];
+  const tadSections = Array.isArray(ctx.tadSections) ? ctx.tadSections : [];
+  if (tacIds.length === 0 && adrIds.length === 0 && tadSections.length === 0) return '';
+  if (tacIds.length > 0) {
+    parts.push(`<p class="rcf-spec-link-row"><strong>TACs:</strong> ${tacIds.map((id) => archLink(id)).join(', ')}</p>`);
+  }
+  if (adrIds.length > 0) {
+    parts.push(`<p class="rcf-spec-link-row"><strong>ADRs:</strong> ${adrIds.map((id) => archLink(id)).join(', ')}</p>`);
+  }
+  if (tadSections.length > 0) {
+    parts.push(`<p class="rcf-spec-link-row"><strong>TAD sections:</strong> ${tadSections.map((k) => `<a class="mono" href="#tab=architecture&amp;open=${escapeHtml(k)}">${escapeHtml(k)}</a>`).join(', ')}</p>`);
+  }
+  return `<section class="rcf-spec-block"><h4>Context</h4>${parts.join('')}</section>`;
+}
+
+function archLink(id) {
+  const esc = escapeHtml(id);
+  return `<a class="mono" href="#tab=architecture&amp;entity=${esc}">${esc}</a>`;
+}

package/src/view/doc-renderers/helpers.js

@@ -128,9 +128,9 @@ export function fieldObjectTable(label, rows, columns) {
  * @param {string} parentDocId - the enclosing doc's display id (e.g. "REQ-002")
  * @returns {string}
  */
-export function rawJsonDisclosure(raw, doc, parentDocId) {
+export function rawJsonDisclosure(raw, doc, parentDocId, idPrefix) {
   const json = raw ?? JSON.stringify(doc, null, 2);
-  const rawId = `${parentDocId ?? 'doc'}::raw`;
+  const rawId = `${idPrefix ?? ''}${parentDocId ?? 'doc'}::raw`;
   return `<details class="raw-json" data-doc-id="${escapeHtml(rawId)}"><summary>Show raw JSON</summary><pre>${escapeHtml(json)}</pre></details>`;
 }
 

package/src/view/doc-renderers/index.js

@@ -5,8 +5,10 @@ export { renderPrd } from './prd.js';
 export { renderReq } from './req.js';
 export { renderUserStory } from './user-story.js';
 export { renderTad } from './tad.js';
+export { renderTadSections, shortenDocId } from './architecture.js';
 export { renderTac } from './tac.js';
 export { renderAdr } from './adr.js';
 export { renderBuildSequence } from './build-sequence.js';
 export { renderFbs } from './fbs.js';
 export { renderTestSuite } from './test-suite.js';
+export { renderBuildStats, renderBuildPageHead, renderSpecBody } from './build.js';

package/src/view/doc-renderers/prd.js

@@ -18,6 +18,16 @@ import {
  * @param {string|undefined} ctx.raw
  * @param {import('#core/errors').RcfError[]} [ctx.errors]
  * @param {string[]} [ctx.requirementIds] - computed REQ children for this PRD
+ * @param {boolean} [ctx.suppressRequirementList] - viewer UI refresh PR 3
+ *   (decision 4): the PRD tab replaces the inline doc-link paragraph with
+ *   an EntitySelector mounted outside this article, so renderPrd no
+ *   longer emits the 109 inline requirement anchors when that flag is on.
+ *   Non-tab callers (if any) still see the legacy paragraph by default.
+ * @param {boolean} [ctx.collapsibleLists] - viewer UI refresh PR 3 (design
+ *   section 5): the PRD tab collapses Target users / In scope / Out of
+ *   scope / Objectives / Constraints each with a count badge; Executive
+ *   summary and Problem statement stay open. Non-tab callers (if any)
+ *   still see the open sections by default.
  * @returns {string}
  */
 export function renderPrd(prd, ctx) {
@@ -25,15 +35,19 @@ export function renderPrd(prd, ctx) {
   const anchor = anchorIdFor(prd.prdId ?? 'PRD');
   const broken = ctx.errors?.length ? brokenBanner(ctx.errors) : '';
   const requirementIds = ctx.requirementIds ?? [];
+  const requirementSection = ctx.suppressRequirementList
+    ? ''
+    : `<section class="field-list"><h4>Requirements</h4><p>${docLinkList(requirementIds)}</p></section>`;
+  const renderList = ctx.collapsibleLists ? collapsibleFieldList : fieldList;
   const sections = [
     fieldPara('Executive summary', prd.executiveSummary),
     fieldPara('Problem statement', prd.problemStatement),
-    fieldList('Target users', prd.targetUsers),
-    fieldList('In scope', prd.inScope),
-    fieldList('Out of scope', prd.outOfScope),
-    fieldList('Objectives', prd.objectives),
-    fieldList('Constraints', prd.constraints),
-    `<section class="field-list"><h4>Requirements</h4><p>${docLinkList(requirementIds)}</p></section>`,
+    renderList('Target users', prd.targetUsers),
+    renderList('In scope', prd.inScope),
+    renderList('Out of scope', prd.outOfScope),
+    renderList('Objectives', prd.objectives),
+    renderList('Constraints', prd.constraints),
+    requirementSection,
   ].filter(Boolean).join('\n');
   return `
 <article id="${anchor}" class="doc doc-prd">
@@ -43,3 +57,18 @@ export function renderPrd(prd, ctx) {
   ${rawJsonDisclosure(ctx.raw, prd, prd.prdId)}
 </article>`.trim();
 }
+
+/**
+ * Collapsible variant of `fieldList`: a <details> whose summary names
+ * the field and carries the count badge, body is the same `<ul>` list.
+ * The count badge uses the shared Badge class names so it looks the
+ * same as the Requirements-tab counts.
+ *
+ * @param {string} label
+ * @param {string[] | undefined} items
+ */
+function collapsibleFieldList(label, items) {
+  if (!Array.isArray(items) || items.length === 0) return '';
+  const li = items.map((s) => `<li>${escapeHtml(s)}</li>`).join('');
+  return `<details class="rcf-prd-list field-list"><summary><strong>${escapeHtml(label)}</strong> <span class="rcf-badge rcf-badge--count"><span class="rcf-badge-value">${items.length}</span></span></summary><div class="rcf-prd-list-body"><ul>${li}</ul></div></details>`;
+}

package/src/view/doc-renderers/req.js

@@ -18,11 +18,19 @@ import {
  * @param {string|undefined} ctx.raw
  * @param {import('#core/errors').RcfError[]} [ctx.errors]
  * @param {string|undefined} [ctx.subdiagram]
+ * @param {string|undefined} [ctx.idPrefix] - prefix prepended to every emitted
+ *   id/anchor so the same REQ can be rendered under multiple Product Map
+ *   buckets without duplicating ids. Empty when rendered from the
+ *   Requirements tab so its anchors stay canonical.
+ * @param {boolean} [ctx.suppressRawJson] - when true, the raw-JSON disclosure
+ *   is not emitted (Product Map compact cards; the disclosure stays on
+ *   the Requirements tab). AC-17007-1 payload weight.
  * @returns {string}
  */
 export function renderReq(req, ctx) {
   if (!req) return '';
-  const anchor = anchorIdFor(req.reqId ?? 'REQ');
+  const prefix = ctx.idPrefix ?? '';
+  const anchor = `${prefix}${anchorIdFor(req.reqId ?? 'REQ')}`;
   const broken = ctx.errors?.length ? brokenBanner(ctx.errors) : '';
   const subdiagram = ctx.subdiagram
     ? `<section class="subdiagram"><h4>Slice diagram</h4><pre class="mermaid">${escapeHtml(ctx.subdiagram)}</pre></section>`
@@ -38,6 +46,6 @@ export function renderReq(req, ctx) {
   ${fieldPara('Rationale', req.rationale)}
   ${fieldList('Tags', req.tags)}
   ${subdiagram}
-  ${rawJsonDisclosure(ctx.raw, req, req.reqId)}
+  ${ctx.suppressRawJson ? '' : rawJsonDisclosure(ctx.raw, req, req.reqId, prefix)}
 </article>`.trim();
 }

package/src/view/doc-renderers/user-story.js

@@ -18,13 +18,18 @@ import {
  * @param {string|undefined} ctx.raw
  * @param {import('#core/errors').RcfError[]} [ctx.errors]
  * @param {Map<string, object[]>} [ctx.fbsByAcId]
+ * @param {string|undefined} [ctx.idPrefix] - prefix prepended to every emitted
+ *   id/anchor (article, AC li items, raw-JSON disclosure) so a US rendered
+ *   under multiple Product Map buckets does not collide with the canonical
+ *   Requirements-tab anchors. Empty from the Requirements tab.
  * @returns {string}
  */
 export function renderUserStory(us, ctx) {
   if (!us) return '';
-  const anchor = anchorIdFor(us.usId ?? 'US');
+  const prefix = ctx.idPrefix ?? '';
+  const anchor = `${prefix}${anchorIdFor(us.usId ?? 'US')}`;
   const broken = ctx.errors?.length ? brokenBanner(ctx.errors) : '';
-  const acItems = (us.acceptanceCriteria ?? []).map((ac) => renderAcItem(ac, ctx)).join('\n');
+  const acItems = (us.acceptanceCriteria ?? []).map((ac) => renderAcItem(ac, ctx, prefix)).join('\n');
   return `
 <article id="${anchor}" class="doc doc-us">
   <h3>${escapeHtml(us.usId ?? 'US')} - ${escapeHtml(us.title ?? '')}</h3>
@@ -40,13 +45,13 @@ export function renderUserStory(us, ctx) {
       ${acItems}
     </ul>
   </section>
-  ${rawJsonDisclosure(ctx.raw, us, us.usId)}
+  ${ctx.suppressRawJson ? '' : rawJsonDisclosure(ctx.raw, us, us.usId, prefix)}
 </article>`.trim();
 }
 
-function renderAcItem(ac, ctx) {
+function renderAcItem(ac, ctx, prefix) {
   const acId = ac.id ?? 'AC';
-  const acAnchor = anchorIdFor(acId);
+  const acAnchor = `${prefix ?? ''}${anchorIdFor(acId)}`;
   const fbsList = ctx.fbsByAcId?.get(acId) ?? [];
   const coveredBy = fbsList.length === 0
     ? '<em>not yet delivered by any FBS</em>'