fraim-hub 2.0.338 → 2.0.340

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-hub",
-  "version": "2.0.338",
+  "version": "2.0.340",
   "description": "FRAIM Hub local companion package.",
   "author": "Sid Mathur <sid.mathur@gmail.com>",
   "homepage": "https://github.com/mathursrus/FRAIM#readme",
@@ -18,6 +18,7 @@
   "files": [
     "dist/registry/scripts/learning/learning-domains.json",
     "dist/registry/scripts/learning/entry-format.js",
+    "dist/registry/scripts/learning/completion-state.js",
     "dist/src/ai-hub/",
     "dist/src/api/admin/payments.js",
     "dist/src/api/admin/sales-leads.js",
@@ -72,6 +73,7 @@
     "dist/src/config/stripe.js",
     "dist/src/core/brand-store.js",
     "dist/src/core/capability-pack.js",
+    "dist/src/core/handoff-contracts.js",
     "dist/src/core/quality-evidence.js",
     "dist/src/core/job-visualization.js",
     "dist/src/core/resolve-phase-edge.js",
@@ -93,6 +95,7 @@
     "dist/src/local-mcp-server/agent-token-prices.js",
     "dist/src/local-mcp-server/artifact-retention-cleanup.js",
     "dist/src/local-mcp-server/learning-context-builder.js",
+    "dist/src/local-mcp-server/learning-usage-events.js",
     "dist/src/local-mcp-server/learning-usage-projection.js",
     "dist/src/local-mcp-server/learning-usage-store.js",
     "dist/src/middleware/rate-limit.js",
@@ -225,7 +228,7 @@
     "electron-updater": "^6.8.9",
     "express": "^5.2.1",
     "extract-zip": "^2.0.1",
-    "fraim": "2.0.338",
+    "fraim": "2.0.340",
     "mongodb": "^7.0.0",
     "node-cron": "4.2.1",
     "node-edge-tts": "^1.2.10",

package/public/ai-hub/review.css

@@ -634,3 +634,381 @@
 
 .review-turn .review-actions { border: 0; margin: 0; padding: 0; }
 .review-turn .rb-handoff { flex-basis: 100%; }
+
+/* ===========================================================================
+   Issue #1755 - the learnings library.
+   The corpus was a flat list of full-text cards with no summary, no filter and
+   no sign of whether an entry has ever worked. These rules add the stats row,
+   the filter toolbar, the domain grouping, and the per-card strength + usage
+   footer. Every colour comes from the existing token set.
+   =========================================================================== */
+
+/* Stats row */
+.ll-stats {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 6px 14px;
+  padding: 2px 2px 12px;
+}
+.ll-stats .ll-stat {
+  display: inline-flex;
+  align-items: baseline;
+  gap: 5px;
+  font-size: 11.5px;
+  color: var(--muted);
+  white-space: nowrap;
+}
+.ll-stats .ll-stat b { font-size: 14px; font-weight: 700; color: var(--text); }
+.ll-stats .ll-total b { font-size: 16px; }
+.ll-stats .ll-stat::before {
+  content: '';
+  width: 7px; height: 7px; border-radius: 50%;
+  background: var(--muted);
+  align-self: center;
+}
+.ll-stats .ll-total::before { display: none; }
+.ll-stats .s-strong::before { background: var(--done); }
+.ll-stats .s-wouldfire::before { background: var(--warn); }
+.ll-stats .s-unresolved::before { background: var(--strength-unresolved); }
+.ll-stats .s-weak::before { background: var(--line); box-shadow: inset 0 0 0 1px var(--muted); }
+.ll-stats .s-dead::before { background: transparent; box-shadow: inset 0 0 0 1px var(--line); }
+
+/* Filter + sort toolbar */
+.ll-tools {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  flex-wrap: wrap;
+  gap: 8px;
+  padding-bottom: 12px;
+}
+.ll-tools .ll-tabs { display: flex; flex-wrap: wrap; gap: 6px; }
+.ll-tools .ll-tab {
+  font: inherit;
+  font-size: 11.5px;
+  font-weight: 600;
+  color: var(--muted);
+  background: var(--surface);
+  border: 1px solid var(--line);
+  border-radius: 999px;
+  padding: 4px 11px;
+  cursor: pointer;
+  transition: background 120ms ease, color 120ms ease, border-color 120ms ease;
+}
+.ll-tools .ll-tab:hover { color: var(--text); border-color: var(--muted); }
+.ll-tools .ll-tab.active {
+  color: var(--accent-strong);
+  background: var(--accent-soft);
+  border-color: var(--accent);
+}
+.ll-tools .ll-selects { display: flex; gap: 8px; }
+.ll-tools .ll-sel {
+  font: inherit;
+  font-size: 11.5px;
+  color: var(--text);
+  background: var(--surface);
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  padding: 4px 8px;
+  cursor: pointer;
+  max-width: 190px;
+}
+.ll-tools .ll-sel:focus { outline: none; border-color: var(--accent); }
+
+/* Domain group header */
+.ll-group-head {
+  display: flex;
+  align-items: baseline;
+  gap: 8px;
+  margin-top: 8px;
+  padding-bottom: 5px;
+  border-bottom: 1px solid var(--line);
+}
+.learn-list > .ll-group-head:first-child { margin-top: 0; }
+.ll-group-head .llg-name {
+  font-size: 10.5px;
+  font-weight: 700;
+  letter-spacing: 0.06em;
+  text-transform: uppercase;
+  color: var(--text);
+}
+.ll-group-head .llg-reach { font-size: 11px; color: var(--muted); }
+.ll-group-head .llg-count {
+  margin-left: auto;
+  font-size: 11px;
+  font-weight: 600;
+  color: var(--muted);
+}
+
+/* No-match state */
+.ll-nomatch { font-size: 13px; color: var(--muted); padding: 18px 2px 4px; }
+
+/* Card: domain, strength and score badges */
+.learn-prop .lp-domain {
+  font-size: 10px;
+  font-weight: 700;
+  padding: 2px 8px;
+  border-radius: 6px;
+  letter-spacing: 0.03em;
+  flex-shrink: 0;
+  background: var(--bg);
+  color: var(--muted);
+  box-shadow: inset 0 0 0 1px var(--line);
+}
+.learn-prop .lp-domain.dom-global { color: var(--muted); }
+.learn-prop .lp-domain.dom-c0 { color: var(--domain-slot-0); box-shadow: inset 0 0 0 1px var(--domain-slot-0-ring); }
+.learn-prop .lp-domain.dom-c1 { color: var(--domain-slot-1); box-shadow: inset 0 0 0 1px var(--domain-slot-1-ring); }
+.learn-prop .lp-domain.dom-c2 { color: var(--domain-slot-2); box-shadow: inset 0 0 0 1px var(--domain-slot-2-ring); }
+.learn-prop .lp-domain.dom-c3 { color: var(--domain-slot-3); box-shadow: inset 0 0 0 1px var(--domain-slot-3-ring); }
+.learn-prop .lp-domain.dom-c4 { color: var(--domain-slot-4); box-shadow: inset 0 0 0 1px var(--domain-slot-4-ring); }
+.learn-prop .lp-domain.dom-c5 { color: var(--domain-slot-5); box-shadow: inset 0 0 0 1px var(--domain-slot-5-ring); }
+
+.learn-prop .lp-strength {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  font-size: 10.5px;
+  font-weight: 700;
+  padding: 2px 8px 2px 6px;
+  border-radius: 6px;
+  flex-shrink: 0;
+  background: var(--bg);
+  color: var(--muted);
+}
+.learn-prop .lp-strength .lp-dot {
+  width: 6px; height: 6px; border-radius: 50%; background: currentColor;
+  flex-shrink: 0;
+}
+.learn-prop .lp-strength.s-strong { color: var(--done); }
+.learn-prop .lp-strength.s-wouldfire { color: var(--warn); }
+.learn-prop .lp-strength.s-unresolved { color: var(--strength-unresolved); }
+.learn-prop .lp-strength.s-weak { color: var(--muted); }
+.learn-prop .lp-strength.s-dead { color: var(--muted); opacity: 0.65; }
+.learn-prop .lp-strength.s-dead .lp-dot { background: transparent; box-shadow: inset 0 0 0 1px currentColor; }
+
+.learn-prop .lp-score {
+  font-size: 11px;
+  font-weight: 700;
+  font-variant-numeric: tabular-nums;
+  color: var(--muted);
+  background: var(--bg);
+  border-radius: 6px;
+  padding: 2px 7px;
+  flex-shrink: 0;
+}
+
+/* Card body clamp */
+.learn-prop .lp-body.lp-clamped {
+  display: -webkit-box;
+  -webkit-line-clamp: 3;
+  line-clamp: 3;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+.learn-prop .lp-more {
+  align-self: flex-start;
+  font: inherit;
+  font-size: 11.5px;
+  font-weight: 600;
+  color: var(--accent);
+  background: none;
+  border: none;
+  padding: 0;
+  margin-top: -2px;
+  cursor: pointer;
+}
+.learn-prop .lp-more:hover { color: var(--accent-strong); text-decoration: underline; }
+
+/* Card usage footer */
+.learn-prop .lp-stats {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 6px 12px;
+  margin-top: 2px;
+  padding-top: 9px;
+  border-top: 1px solid var(--line);
+  font-size: 11px;
+  color: var(--muted);
+}
+.learn-prop .lp-stats .lps-none { font-style: italic; }
+.learn-prop .lp-bar {
+  display: flex;
+  width: 68px;
+  height: 4px;
+  border-radius: 999px;
+  overflow: hidden;
+  background: var(--line);
+  flex-shrink: 0;
+}
+.learn-prop .lp-bar i { display: block; height: 100%; }
+.learn-prop .lp-bar .lb-applied { background: var(--done); }
+.learn-prop .lp-bar .lb-prevented { background: var(--accent); }
+.learn-prop .lp-bar .lb-ignored { background: var(--warn); }
+.learn-prop .lp-stats .lps-counts { display: flex; flex-wrap: wrap; gap: 10px; }
+.learn-prop .lp-stats .lps-c { display: inline-flex; align-items: baseline; gap: 4px; }
+.learn-prop .lp-stats .lps-c b { font-weight: 700; color: var(--text); font-variant-numeric: tabular-nums; }
+.learn-prop .lp-stats .lps-last { margin-left: auto; white-space: nowrap; }
+
+/* Domain select in the inline editor */
+.learn-prop .lp-edit-domain {
+  font: inherit; font-size: 12px; padding: 6px 8px; border: 1px solid var(--line);
+  border-radius: 8px; background: var(--surface); color: var(--text);
+}
+.learn-prop .lp-edit-domain:focus { outline: none; border-color: var(--accent); }
+
+/* Collapsed sections (below-threshold + archived). These had no rules at all,
+   so they rendered as an unstyled details block in the middle of a card list. */
+.learn-dormant-section {
+  border: 1px dashed var(--line);
+  border-radius: 14px;
+  padding: 4px 12px;
+  background: transparent;
+}
+.learn-dormant-section > .learn-dormant-header {
+  font-size: 11.5px;
+  font-weight: 600;
+  color: var(--muted);
+  padding: 8px 2px;
+  cursor: pointer;
+  list-style: none;
+}
+.learn-dormant-section > .learn-dormant-header::-webkit-details-marker { display: none; }
+.learn-dormant-section > .learn-dormant-header::before {
+  content: '\25B8';
+  display: inline-block;
+  width: 12px;
+  transition: transform 140ms ease;
+}
+.learn-dormant-section[open] > .learn-dormant-header::before { transform: rotate(90deg); }
+.learn-dormant-section > .learn-prop {
+  margin-bottom: 10px;
+  background: var(--bg);
+}
+
+
+/* Issue #1755: entries are authored as short labelled lines (Takeaway / Why this
+   matters / Example / What to do next). Collapsing them into one paragraph is
+   what made the readable ones read like the dense ones. */
+.learn-prop .lp-body { white-space: pre-line; }
+
+/* The provenance tail, revealed with the rest of the entry. */
+.learn-prop .lp-prov {
+  white-space: pre-line;
+  font-size: 11.5px;
+  line-height: 1.55;
+  color: var(--muted);
+  border-left: 2px solid var(--line);
+  padding-left: 10px;
+}
+
+/* Issue #1755: the accordion body is a capped scroll region (.ctx-acc-body), so
+   the library's summary and controls pin to its top rather than scrolling out of
+   reach behind a hundred cards. */
+.ll-head {
+  position: sticky;
+  top: -4px;
+  z-index: 2;
+  background: var(--ll-head-bg);
+  margin: -4px -2px 0;
+  padding: 6px 2px 0;
+  box-shadow: var(--ll-head-shadow);
+}
+.ll-head .ll-tools { padding-bottom: 10px; }
+
+/* Issue #1755 R6: the proposal card's two zones. Configuration sits in a recessed
+   block so the controls that change what gets written read as settings, and the
+   decision sits below a hairline so it reads as the commit. */
+.learn-prop .lp-config {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  background: var(--lp-recessed);
+  border-radius: 10px;
+  padding: 9px 11px 11px;
+  margin-top: 2px;
+}
+.learn-prop .lp-config .lp-config-head {
+  font-size: 10px;
+  font-weight: 700;
+  letter-spacing: 0.06em;
+  text-transform: uppercase;
+  color: var(--muted);
+}
+.learn-prop .lp-config .lp-actions { margin-top: 0; }
+.learn-prop .lp-decide {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 10px;
+  margin-top: 2px;
+  padding-top: 10px;
+  border-top: 1px solid var(--line);
+}
+.learn-prop .lp-decide .lp-scope-note { margin-left: auto; text-align: right; }
+.learn-prop .lp-decided-badge {
+  font-size: 10.5px;
+  font-weight: 700;
+  padding: 2px 9px;
+  border-radius: 999px;
+  letter-spacing: 0.02em;
+}
+/* Tinted with its own outcome colour rather than --accent-soft: an org brand
+   overrides --accent, and a purple-tinted pill around green text reads as two
+   unrelated signals. */
+.learn-prop .lp-decided-badge.is-saved { background: var(--bg); color: var(--done); box-shadow: inset 0 0 0 1px currentColor; }
+.learn-prop .lp-decided-badge.is-skipped { background: var(--bg); color: var(--muted); box-shadow: inset 0 0 0 1px var(--line); }
+
+/* Issue #1755: at a narrow panel width the head row's badges (domain, category,
+   priority, strength) plus the score chip outrun the row, and an unbreakable
+   title word pushes the card into horizontal overflow. Let the row wrap and let
+   a long title break, rather than letting the card scroll sideways. */
+.learn-prop .lp-head { flex-wrap: wrap; row-gap: 6px; }
+/* A 220px basis is the hinge: while that much room is left after the badges the
+   title stays on their line, and below it the title takes a full row of its own
+   instead of being squeezed into a four-word-wide column. */
+.learn-prop .lp-head .lp-title { flex: 1 1 220px; overflow-wrap: break-word; }
+
+/* Issue #1755: the row actions were display:none until hover, which takes them out
+   of the tab order entirely: a keyboard or screen-reader manager could not reach
+   Edit or Delete at all, and Edit is now also where an entry is re-scoped. Hide
+   them visually instead of structurally, and reveal on focus as well as hover.
+   Reserving their space also stops the title reflowing every time the pointer
+   crosses a card. */
+.learn-prop .lp-act {
+  display: inline-flex;
+  opacity: 0;
+  transition: opacity 120ms ease;
+}
+.learn-prop:hover .lp-act,
+.learn-prop:focus-within .lp-act,
+.learn-prop .lp-act:focus-visible { opacity: 1; }
+.learn-prop .lp-act:focus-visible { outline: 2px solid var(--accent); outline-offset: 1px; }
+.ll-tools .ll-tab:focus-visible,
+.ll-tools .ll-sel:focus-visible,
+.learn-prop .lp-more:focus-visible {
+  outline: 2px solid var(--accent);
+  outline-offset: 2px;
+}
+
+/* Issue #1755 R5: the sleep-on-learnings proposal set, rendered in the
+   conversation where the job wrote it. Full conversation width, because a
+   proposal carries a lesson body, a configuration zone and a decision. */
+.learn-proposal-turn .bubble {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  width: 100%;
+  max-width: 100%;
+  box-sizing: border-box;
+}
+.learn-proposal-turn .review-turn-label { margin-bottom: 0; }
+.learn-proposal-turn .learn-batch {
+  background: var(--lp-raised);
+  border: 1px solid var(--lp-raised-line);
+  border-radius: 12px;
+  padding: 9px 12px;
+}
+.learn-proposal-turn .learn-list { gap: 10px; }
+.learn-proposal-turn .learn-prop { background: var(--surface); }