@profpowell/vb-project-planning 0.2.1 → 0.2.3

package/src/web-components/impact-effort/static.html

@@ -5,19 +5,27 @@
 -->
 <impact-effort>
   <user-story data-quadrant="quick-wins" draggable="true" data-id="PROJ-201"
-    story-id="PROJ-201" persona="PM" action="add CSV export to reports"
+    story-id="PROJ-201"
     priority="medium" status="to-do" points="2" detail="minimal">
+    <span slot="persona">PM</span>
+    <span slot="action">add CSV export to reports</span>
   </user-story>
   <user-story data-quadrant="big-bets" draggable="true" data-id="PROJ-301"
-    story-id="PROJ-301" persona="Developer" action="migrate to new API gateway"
+    story-id="PROJ-301"
     priority="high" status="in-progress" points="13" detail="minimal">
+    <span slot="persona">Developer</span>
+    <span slot="action">migrate to new API gateway</span>
   </user-story>
   <user-story data-quadrant="fill-ins" draggable="true" data-id="PROJ-401"
-    story-id="PROJ-401" persona="Developer" action="update README with new setup steps"
+    story-id="PROJ-401"
     priority="low" status="backlog" points="1" detail="minimal">
+    <span slot="persona">Developer</span>
+    <span slot="action">update README with new setup steps</span>
   </user-story>
   <user-story data-quadrant="money-pit" draggable="true" data-id="PROJ-501"
-    story-id="PROJ-501" persona="Admin" action="rewrite legacy auth module"
+    story-id="PROJ-501"
     priority="medium" status="backlog" points="21" detail="minimal">
+    <span slot="persona">Admin</span>
+    <span slot="action">rewrite legacy auth module</span>
   </user-story>
 </impact-effort>

package/src/web-components/iron-triangle/_capacity.js

@@ -19,24 +19,6 @@ export function defaultFormula(time, cost, focusFactor) {
   return Math.ceil(weeks * fte * f);
 }
 
-/**
- * Format the formula string used as the human-readable explanation
- * shown beneath the readout. Matches the formula above; if either
- * factor is missing the string degrades gracefully.
- */
-export function defaultFormulaText(time, cost, focusFactor) {
-  const sprintCount = num(time?.sprintCount);
-  const sprintWeeks = num(time?.sprintWeeks) || 1;
-  const totalWeeks = sprintCount > 0 ? sprintCount * sprintWeeks : sprintWeeks;
-  const fte = num(cost?.teamFTE);
-  const f = clamp(num(focusFactor), 0, 1);
-  const points = defaultFormula(time, cost, focusFactor);
-  if (!points) return 'Set sprint length, team size, and focus factor to compute capacity.';
-  const weeksLabel = sprintCount > 0
-    ? `${sprintCount} × ${sprintWeeks}wk = ${totalWeeks}wk`
-    : `${sprintWeeks}wk`;
-  return `${weeksLabel} × ${fte} FTE × ${f} = ${(totalWeeks * fte * f).toFixed(1)} → ${points} points`;
-}
 
 /**
  * FNV-1a (32-bit) hash over a stable JSON serialization of the triangle.

package/src/web-components/kanban-board/api.json

@@ -5,8 +5,8 @@
   "description": "Columnar drag-and-drop board with user-defined columns, count badges, and optional WIP limits",
   "htmlvalidate": { "flow": true, "permittedContent": ["section"] },
   "attributes": [
-    { "name": "src",     "kind": "host-api", "purpose": "config", "type": "string",  "description": "URL to JSON data for columns and items" },
-    { "name": "title",   "kind": "host-api", "purpose": "config", "type": "string",  "description": "Optional heading above the board" },
+    { "name": "src",     "kind": "host-api", "purpose": "config", "type": "string",  "description": "URL to JSON data for columns and items. Fetched once per value; a new value replaces the board and aborts an older in-flight request" },
+    { "name": "title",   "kind": "host-api", "purpose": "config", "type": "string",  "description": "Optional heading above the board; also names the board region" },
     { "name": "compact", "kind": "host-api", "purpose": "config", "type": "boolean", "description": "Reduced spacing variant" }
   ],
   "childAttributes": [
@@ -16,9 +16,11 @@
     { "name": "data-column-color", "on": "section", "type": "string",  "description": "Color token for column tint (success, warning, error, info)" }
   ],
   "events": [
-    { "name": "kanban-board:transfer",     "detail": "{ itemId, fromColumn, toColumn, newIndex, item }",  "description": "Item moved between columns" },
-    { "name": "kanban-board:reorder",      "detail": "{ itemId, column, oldIndex, newIndex }",            "description": "Item reordered within a column" },
-    { "name": "kanban-board:ready",        "detail": "{ columnCount, itemCount }",                        "description": "Fired after component initializes" },
-    { "name": "kanban-board:wip-exceeded", "detail": "{ column, limit, count }",                          "description": "Fired when a column exceeds its WIP limit" }
+    { "name": "kanban-board:transfer",      "detail": "{ itemId, fromColumn, toColumn, newIndex, item }", "description": "Item moved between columns" },
+    { "name": "kanban-board:reorder",       "detail": "{ itemId, column, oldIndex, newIndex }",           "description": "Item reordered within a column" },
+    { "name": "kanban-board:ready",         "detail": "{ columnCount, itemCount }",                       "description": "Fired once after the first render. With src, fired once the JSON has loaded and rendered. Once per element: not re-fired by a later src change (watch items-changed with source 'src') or when the board is moved in the DOM" },
+    { "name": "kanban-board:wip-exceeded",  "detail": "{ column, limit, count }",                         "description": "Fired when a drop takes a column over its WIP limit" },
+    { "name": "kanban-board:items-changed", "detail": "{ items, source: 'api' | 'drag' | 'src' }",        "description": "Fired after the items array changes: an .items assignment, or a .columns assignment that drops cards (source 'api'), a drag (source 'drag'), or each src load once its data has rendered (source 'src'). Filter on source to avoid feedback loops" },
+    { "name": "kanban-board:upgraded",      "detail": "",                                                 "description": "Fired (in a microtask) each time the board connects and upgrades; a safe signal for assigning .columns / .items from a framework" }
   ]
 }