aimeat 1.32.0 → 1.32.1

package/dist/public/views/profile/organisms/workspace.js

@@ -20,6 +20,18 @@
  *     top of the space; each record is a separated card with breathing room.
  *   v1.4.0 — 2026-06-23 — Accept an `initialSpace` prop: a deep-link from the organism mindmap opens
  *     the workspace straight on that space's tab (instead of always the overview).
+ *   v1.5.0 — 2026-06-23 — Measurability: render the manifest's objectives[] as an Objectives card
+ *     (each KPI's current vs target, ✅/⚠️, computed-vs-self-reported) at the top of the workspace,
+ *     fed by getWorkspaceOverviewFull + refreshed on live updates. Design:
+ *     docs/internal/2026-06-23-organism-measurability-design.md (Phase G).
+ *   v1.6.0 — 2026-06-23 — Findability pass (vaihe 1): the "What happened here" feed shows the
+ *     document/record title instead of the raw id (instanceTitle); multi-part documents
+ *     ("… — osa N") collapse under one expandable series row (niputus) in both the doc-space index
+ *     and the Overview space list — pure display grouping, never touches stored sections/data.
+ *   v1.7.0 — 2026-06-23 — Findability pass (vaihe 2): optional color tags. A small preset palette
+ *     (ColorPicker + TAG_PALETTE → theme tokens) lets sections, documents and records be tagged with
+ *     a color (left-rail accent). Section colors persist on the section object; per-item colors in a
+ *     parallel meta.colors map (getAllColors/saveColors). Colors are optional and default to none.
  */
 import { h } from 'preact';
 import { useState, useEffect, useCallback, useRef } from 'preact/hooks';
@@ -57,6 +69,29 @@ import { SourcesPanel } from '/views/profile/organisms/sources-panel.js';
 
 const PRIMARY_FIELD = { goal: 'title', plan: 'approach', deliverable: 'title', resource: 'label', decision: 'summary' };
 
+// Optional color tags for sections / documents / records. A small fixed palette of theme tokens
+// (kept in CSS as .pj-tag-{key} → --pj-tag) so colors always match the active light/dark theme —
+// never a free hex that could clash. null/absent = no color (the default, neutral).
+const TAG_PALETTE = ['red', 'orange', 'yellow', 'green', 'blue', 'purple', 'gray'];
+
+// A dot that opens an inline swatch palette; picking a color (or ∅) calls onPick(key|null) and closes.
+// Self-contained so it can sit in a section head, a document row or a record row alike.
+function ColorPicker({ value, onPick, title }) {
+  const [open, setOpen] = useState(false);
+  return html`
+    <span class="pj-cp">
+      <button class="pj-cp-dot ${value ? 'pj-colored pj-tag-' + value : 'pj-cp-empty'}" title=${title || (t('organisms.color') || 'Color')}
+        onClick=${(e) => { e.stopPropagation(); e.preventDefault(); setOpen(o => !o); }}></button>
+      ${open ? html`
+        <span class="pj-cp-pop" onMouseLeave=${() => setOpen(false)}>
+          <button class="pj-cp-sw pj-cp-none" title=${t('organisms.noColor') || 'No color'}
+            onClick=${(e) => { e.stopPropagation(); e.preventDefault(); onPick(null); setOpen(false); }}>∅</button>
+          ${TAG_PALETTE.map(c => html`<button key=${c} class="pj-cp-sw pj-colored pj-tag-${c}"
+            onClick=${(e) => { e.stopPropagation(); e.preventDefault(); onPick(c); setOpen(false); }}></button>`)}
+        </span>` : null}
+    </span>`;
+}
+
 export function Workspace({ org, wsId, showToast, onBack, onBackToList, initialSpace }) {
   const orgId = org.id;
   // Registry name for the breadcrumb (the manifest's name can differ from the workspace's name).
@@ -111,7 +146,8 @@ export function Workspace({ org, wsId, showToast, onBack, onBackToList, initialS
   // NOT persisted: opening a workspace must show the overview, not whatever tab was last open.
   // Exception: a deep-link from the organism mindmap (initialSpace) opens straight on that space tab.
   const [tab, setTab] = useState(initialSpace ? 'space:' + initialSpace : 'overview');
-  const [sectionsByType, setSectionsByType] = useState({});  // { typeName: [{id,name,parentId,documents:[docId]}] }
+  const [sectionsByType, setSectionsByType] = useState({});  // { typeName: [{id,name,parentId,documents:[docId],color?}] }
+  const [colorsByType, setColorsByType] = useState({});      // { typeName: { instanceId: colorKey } } — optional per-item color tags
   const [editingSec, setEditingSec] = useState(null);        // section id currently being renamed inline
   const draggedDoc = useRef(null);                            // { type, id } of the doc being dragged
   const [showRegenerate, setShowRegenerate] = useState(false);
@@ -120,6 +156,7 @@ export function Workspace({ org, wsId, showToast, onBack, onBackToList, initialS
   const [addingInitial, setAddingInitial] = useState(null);   // record being edited (null = new draft)
   const [addingId, setAddingId] = useState(null);             // its id, preserved so save overwrites
   const [expandedRec, setExpandedRec] = useState({});         // { "type:id": true } — records expanded to view fields
+  const [expandedSeries, setExpandedSeries] = useState({});   // { "type:base": true } — a multi-part doc series expanded in the index
   const [showSpaces, setShowSpaces] = useState(false);        // inline add-space form at the workspace top
   const [showFlow, setShowFlow] = useState(true);             // the manifest-defined edit-flow chart (first item)
   const [share, setShare] = useState(null);                   // { public, spaces, docs } — lazy-loaded when Settings opens
@@ -161,14 +198,15 @@ export function Workspace({ org, wsId, showToast, onBack, onBackToList, initialS
   const load = useCallback(async () => {
     const w = await orgService.getWorkspace(orgId, wsId).catch(() => null);
     if (w && w.manifest) {
-      const [ap, cfg, secs, act] = await Promise.all([
+      const [ap, cfg, secs, act, cols] = await Promise.all([
         orgService.listApprovals(orgId, 'pending').catch(() => []),
         orgService.getConfig(orgId).catch(() => ({})),
         orgService.getAllSections(orgId, wsId).catch(() => ({})),
         orgService.getWorkspaceActivity(orgId, wsId).catch(() => ({ events: [] })),
+        orgService.getAllColors(orgId, wsId).catch(() => ({})),
       ]);
       setApprovals(ap); setGateOn(!!(cfg?.gates?.publish?.enabled)); setSectionsByType(secs);
-      setWsEvents(act?.events || []);
+      setWsEvents(act?.events || []); setColorsByType(cols);
     }
     setWs(w && w.manifest ? w : null);
   }, [orgId, wsId]);
@@ -179,15 +217,16 @@ export function Workspace({ org, wsId, showToast, onBack, onBackToList, initialS
   // loaded alongside, refreshed on live updates.
   const [wsGraph, setWsGraph] = useState(null);
   const [wsTocSeed, setWsTocSeed] = useState('');
+  const [wsObjectives, setWsObjectives] = useState([]);   // measurability objectives + resolved KPIs
   useEffect(() => {
     let cancelled = false;
     const loadGraph = async () => {
-      const [g, toc] = await Promise.all([
+      const [g, ov] = await Promise.all([
         orgService.getWorkspaceGraph(orgId, wsId).catch(() => null),
-        orgService.getWorkspaceOverview(orgId, wsId).catch(() => ''),
+        orgService.getWorkspaceOverviewFull(orgId, wsId).catch(() => ({ markdown: '', objectives: [] })),
       ]);
       if (cancelled) return;
-      setWsGraph(g); setWsTocSeed(toc || '');
+      setWsGraph(g); setWsTocSeed(ov.markdown || ''); setWsObjectives(ov.objectives || []);
     };
     loadGraph();
     const off = onLiveUpdate(['organisms'], loadGraph);
@@ -499,6 +538,20 @@ export function Workspace({ org, wsId, showToast, onBack, onBackToList, initialS
     setSectionsByType(s => ({ ...s, [typeName]: (s[typeName] || []).map(x => x.id === secId ? { ...x, name } : x) }));
   const commitSecName = (typeName) => { setEditingSec(null); orgService.saveSections(orgId, wsId, typeName, sectionsRef.current[typeName] || []).catch(() => {}); };
 
+  // ── Optional color tags. Section colors live on the section object (persisted via updateSections);
+  // per-document/record colors live in a parallel meta.colors map (persisted via saveColors). ──
+  const setSectionColor = (typeName, secId, color) =>
+    updateSections(typeName, (sectionsByType[typeName] || []).map(s => s.id === secId ? { ...s, color: color || undefined } : s));
+  const itemColor = (typeName, id) => (colorsByType[typeName] || {})[id] || null;
+  const setItemColor = useCallback((typeName, id, color) => {
+    setColorsByType(prev => {
+      const m = { ...(prev[typeName] || {}) };
+      if (color) m[id] = color; else delete m[id];
+      orgService.saveColors(orgId, wsId, typeName, m).catch(e => showToast((e && e.message) || 'Failed to save color'));
+      return { ...prev, [typeName]: m };
+    });
+  }, [orgId, wsId, showToast]);
+
   const publish = useCallback(async (ot, instanceId) => {
     setBusy(true);
     try {
@@ -809,6 +862,40 @@ export function Workspace({ org, wsId, showToast, onBack, onBackToList, initialS
     catch { showToast(t('organisms.copyFailed') || 'Copy failed'); }
   };
 
+  // Resolve an activity-feed event's instance id to a human title (document title / record primary
+  // field), so the feed reads "published · Techstack-matriisi" instead of "published · doc-76qchtb".
+  // Falls back to the id when the item isn't in the loaded set (deleted, or not readable).
+  const instanceTitle = (typeName, id) => {
+    const rec = [...objectsFor(typeName), ...draftsFor(typeName)].find(x => x.id === id);
+    if (!rec) return id;
+    return rec.title || rec.label || rec.summary || rec.name || rec[PRIMARY_FIELD[typeName]] || id;
+  };
+
+  // ── Series niputus: collapse multi-part documents ("Foo — osa 2", "Foo — part 3") under one
+  // expandable parent so a 4-part doc reads as ONE line, not four near-identical ones. PURELY a
+  // display grouping — it never touches the stored sections or the documents themselves. The base
+  // title is whatever precedes a trailing "— osa N / part N / #N"; a document with no such suffix is
+  // its own base (so the lead "Foo" groups with "Foo — osa 2/3"). Only bases with ≥2 members collapse.
+  const seriesParse = (title) => {
+    const m = /^(.*?)[\s—–-]+(?:osa|part|pt\.?|#)\s*(\d+)\s*$/i.exec(String(title || ''));
+    return (m && m[1].trim()) ? { base: m[1].trim(), part: parseInt(m[2], 10) } : { base: String(title || '').trim(), part: 0 };
+  };
+  const groupDocs = (list) => {
+    const map = new Map(); const order = [];
+    for (const d of list) {
+      const { base, part } = seriesParse(d.title || d.label || d.id || '');
+      const k = base.toLowerCase();
+      if (!map.has(k)) { map.set(k, { base, parts: [] }); order.push(k); }
+      map.get(k).parts.push({ ...d, _part: part });
+    }
+    return order.map(k => {
+      const g = map.get(k);
+      if (g.parts.length < 2) return { single: g.parts[0] };
+      g.parts.sort((a, b) => a._part - b._part);
+      return { base: g.base, parts: g.parts };
+    });
+  };
+
   // A document-space: left index (section tree + documents, with an Unsorted group) + a main
   // area showing the active document (view/edit). Sections nest via parentId; documents are
   // tied to a section's documents[] (or unsorted). Edits to the tree persist immediately.
@@ -822,11 +909,12 @@ export function Workspace({ org, wsId, showToast, onBack, onBackToList, initialS
     const isActive = (d) => activeDoc?.type === ot.name && activeDoc.page?.id === d.id;
 
     const docItem = (d) => html`
-      <div class="pj-doc-item ${isActive(d) ? 'active' : ''}" key=${'di' + d.id}
+      <div class="pj-doc-item ${isActive(d) ? 'active' : ''} ${itemColor(ot.name, d.id) ? 'pj-colored pj-tag-' + itemColor(ot.name, d.id) : ''}" key=${'di' + d.id}
         draggable=${true}
         onDragStart=${(e) => { draggedDoc.current = { type: ot.name, id: d.id }; if (e.dataTransfer) { e.dataTransfer.effectAllowed = 'move'; try { e.dataTransfer.setData('text/plain', d.id); } catch (x) { /* noop */ } } }}
         onDragEnd=${() => { draggedDoc.current = null; }}>
         <span class="pj-grip" title=${t('organisms.dragHint') || 'Drag into a section'}>⠿</span>
+        <${ColorPicker} value=${itemColor(ot.name, d.id)} onPick=${(c) => setItemColor(ot.name, d.id, c)} />
         <button class="pj-doc-link" onClick=${() => setActiveDoc({ type: ot.name, mode: 'view', page: d })}>
           ${d._draft ? html`<span class="badge badge-warn pj-mini">${t('organisms.draft') || 'draft'}</span> ` : ''}${d.title || d.id}
         </button>
@@ -837,9 +925,28 @@ export function Workspace({ org, wsId, showToast, onBack, onBackToList, initialS
     const dropOn = (secId) => (e) => { e.preventDefault(); e.stopPropagation(); if (draggedDoc.current?.type === ot.name) { moveDocToSection(ot.name, draggedDoc.current.id, secId); draggedDoc.current = null; } };
     const allowDrop = (e) => { e.preventDefault(); if (e.dataTransfer) e.dataTransfer.dropEffect = 'move'; };
 
+    // Render a document list with multi-part series collapsed (see groupDocs). A series auto-opens
+    // when the active document is one of its parts; otherwise it toggles on the header click.
+    const renderDocList = (list) => groupDocs(list).map((g) => {
+      if (g.single) return docItem(g.single);
+      const key = ot.name + ':' + g.base;
+      const open = g.parts.some(isActive) || !!expandedSeries[key];
+      return html`
+        <div class="pj-doc-series ${open ? 'open' : ''}" key=${'ser-' + g.base}>
+          <button class="pj-doc-series-head" onClick=${() => setExpandedSeries(s => ({ ...s, [key]: !open }))}>
+            <span class="pj-ov-chevron">${open ? '▾' : '▸'}</span>
+            <span class="pj-doc-series-name">${g.base}</span>
+            <span class="pj-org-tab-count">${g.parts.length}</span>
+            ${g.parts.some(p => p._draft) ? html`<span class="badge badge-warn pj-mini">${t('organisms.draft') || 'draft'}</span>` : null}
+          </button>
+          ${open ? html`<div class="pj-doc-series-parts">${g.parts.map(docItem)}</div>` : null}
+        </div>`;
+    });
+
     const renderSection = (sec) => html`
-      <div class="pj-sec" key=${sec.id} onDragOver=${allowDrop} onDrop=${dropOn(sec.id)}>
+      <div class="pj-sec ${sec.color ? 'pj-colored pj-tag-' + sec.color : ''}" key=${sec.id} onDragOver=${allowDrop} onDrop=${dropOn(sec.id)}>
         <div class="pj-sec-head">
+          <${ColorPicker} value=${sec.color} onPick=${(c) => setSectionColor(ot.name, sec.id, c)} />
           ${editingSec === sec.id
             ? html`<input class="input-field input-xs pj-sec-name" autofocus placeholder=${t('organisms.sectionName') || 'Section name'}
                 value=${sec.name} onInput=${e => setSecName(ot.name, sec.id, e.target.value)}
@@ -850,7 +957,7 @@ export function Workspace({ org, wsId, showToast, onBack, onBackToList, initialS
           <button class="pj-icon-btn" title=${t('organisms.addSubsection') || 'Sub-section'} onClick=${() => addSection(ot.name, sec.id)}>⊕</button>
           <button class="pj-icon-btn" title=${t('organisms.remove') || 'Remove'} onClick=${() => removeSection(ot.name, sec.id, sec.name)}>✕</button>
         </div>
-        ${(sec.documents || []).map(id => docById[id]).filter(Boolean).map(docItem)}
+        ${renderDocList((sec.documents || []).map(id => docById[id]).filter(Boolean))}
         ${childrenOf(sec.id).map(renderSection)}
       </div>`;
 
@@ -866,7 +973,7 @@ export function Workspace({ org, wsId, showToast, onBack, onBackToList, initialS
           <div class="pj-doc-index">
             ${childrenOf(null).map(renderSection)}
             ${unsorted.length > 0 ? html`
-              <div class="pj-sec" onDragOver=${allowDrop} onDrop=${dropOn(null)}><div class="pj-sec-head"><span class="pj-sec-name pj-muted">${t('organisms.unsorted') || 'Unsorted'}</span></div>${unsorted.map(docItem)}</div>` : null}
+              <div class="pj-sec" onDragOver=${allowDrop} onDrop=${dropOn(null)}><div class="pj-sec-head"><span class="pj-sec-name pj-muted">${t('organisms.unsorted') || 'Unsorted'}</span></div>${renderDocList(unsorted)}</div>` : null}
             ${docs.length === 0 && secs.length === 0 ? html`<${EmptyState} text=${t('organisms.noneYet') || 'none yet'} />` : null}
           </div>
           <div class="pj-doc-main">
@@ -917,8 +1024,9 @@ export function Workspace({ org, wsId, showToast, onBack, onBackToList, initialS
         : html`<${Spinner} />`)}
 
       ${draftsFor(ot.name).map((d, i) => html`
-        <div class="pj-rec" key=${'d' + i}>
+        <div class="pj-rec ${itemColor(ot.name, d.id) ? 'pj-colored pj-tag-' + itemColor(ot.name, d.id) : ''}" key=${'d' + i}>
           <div class="pj-item pj-item-draft">
+            <${ColorPicker} value=${itemColor(ot.name, d.id)} onPick=${(c) => setItemColor(ot.name, d.id, c)} />
             <span class="badge badge-warn">${t('organisms.draft') || 'draft'}</span>
             <button class="pj-rec-title" onClick=${() => toggleExpand(ot, d.id)}>${String(d[PRIMARY_FIELD[ot.name] || 'title'] || d.id || '')}</button>
             <button class="btn-ghost btn-sm" onClick=${() => startEdit(ot, d)} disabled=${busy}>${t('organisms.edit') || 'Edit'}</button>
@@ -938,8 +1046,9 @@ export function Workspace({ org, wsId, showToast, onBack, onBackToList, initialS
       ${objectsFor(ot.name).length === 0 && draftsFor(ot.name).length === 0
         ? html`<${EmptyState} text=${t('organisms.noneYet') || 'none yet'} />`
         : objectsFor(ot.name).map((o, i) => html`
-          <div class="pj-rec" key=${'o' + i}>
+          <div class="pj-rec ${itemColor(ot.name, o.id) ? 'pj-colored pj-tag-' + itemColor(ot.name, o.id) : ''}" key=${'o' + i}>
             <div class="pj-item">
+              <${ColorPicker} value=${itemColor(ot.name, o.id)} onPick=${(c) => setItemColor(ot.name, o.id, c)} />
               <button class="pj-rec-title" onClick=${() => toggleExpand(ot, o.id)}>${String(o[PRIMARY_FIELD[ot.name] || 'title'] || o.summary || o.id || '')}</button>
               ${o.status ? html`<span class="badge badge-info">${(o.status)}</span>` : null}
               ${!draftsFor(ot.name).some(dr => dr.id === o.id) ? html`
@@ -1127,7 +1236,9 @@ export function Workspace({ org, wsId, showToast, onBack, onBackToList, initialS
         <button class="btn-ghost btn-sm" onClick=${() => ovAddNew(ot, docMode)}>${'+ '}${docMode ? (t('organisms.newPage') || 'New document') : (t('organisms.addDraft') || 'Add draft')}</button>
       </div>`;
     const open = ovOpen[ot.name] ?? !isMobileView();
-    const shown = items.slice(0, 5);
+    // Multi-part documents collapse into one series row here too (see groupDocs); records pass through.
+    const display = docMode ? groupDocs(items) : items.map(d => ({ single: d }));
+    const shown = display.slice(0, 5);
     return html`
       <div class="pj-ov-sec" key=${ot.name}>
         <div class="pj-ov-sec-head" onClick=${() => setOvOpen(s => ({ ...s, [ot.name]: !open }))}>
@@ -1141,26 +1252,91 @@ export function Workspace({ org, wsId, showToast, onBack, onBackToList, initialS
         ${open ? html`
           ${spaceDesc(ot) ? html`<div class="section-desc pj-ov-desc">${spaceDesc(ot)}</div>` : null}
           <div class="pj-ov-items">
-            ${shown.map(d => docMode ? html`
-              <div class="pj-ov-doc" key=${d.id}>
-                <button class="pj-ov-item" onClick=${() => openOvDoc(ot, d)}>
+            ${shown.map((g) => {
+              // A collapsed multi-part series (docMode only) → one row; clicking opens the first part
+              // in the space tab, where the full series index lives.
+              if (g.parts) return html`
+                <div class="pj-ov-doc" key=${'ser-' + g.base}>
+                  <button class="pj-ov-item" onClick=${() => openOvDoc(ot, g.parts[0])}>
+                    ${g.parts.some(p => p._draft) ? html`<span class="badge badge-warn pj-mini">${t('organisms.draft') || 'draft'}</span>` : null}
+                    <span class="pj-ov-item-title">${g.base}</span>
+                    <span class="pj-org-tab-count">${g.parts.length}</span>
+                    <span class="pj-ov-preview">${firstLine(g.parts[0].markdown)}</span>
+                  </button>
+                </div>`;
+              const d = g.single;
+              return docMode ? html`
+                <div class="pj-ov-doc" key=${d.id}>
+                  <button class="pj-ov-item" onClick=${() => openOvDoc(ot, d)}>
+                    ${d._draft ? html`<span class="badge badge-warn pj-mini">${t('organisms.draft') || 'draft'}</span>` : null}
+                    <span class="pj-ov-item-title">${d.title || d.id}</span>
+                    <span class="pj-ov-preview">${firstLine(d.markdown)}</span>
+                  </button>
+                  ${ovDoc && ovDoc.type === ot.name && ovDoc.id === d.id ? renderOvDocInline(ot, d) : null}
+                </div>` : html`
+                <button class="pj-ov-item" key=${d.id} onClick=${() => openOvRec(ot, d)}>
                   ${d._draft ? html`<span class="badge badge-warn pj-mini">${t('organisms.draft') || 'draft'}</span>` : null}
-                  <span class="pj-ov-item-title">${d.title || d.id}</span>
-                  <span class="pj-ov-preview">${firstLine(d.markdown)}</span>
-                </button>
-                ${ovDoc && ovDoc.type === ot.name && ovDoc.id === d.id ? renderOvDocInline(ot, d) : null}
-              </div>` : html`
-              <button class="pj-ov-item" key=${d.id} onClick=${() => openOvRec(ot, d)}>
-                ${d._draft ? html`<span class="badge badge-warn pj-mini">${t('organisms.draft') || 'draft'}</span>` : null}
-                <span class="pj-ov-item-title">${String(d[PRIMARY_FIELD[ot.name] || 'title'] || d.summary || d.id || '')}</span>
-                ${d.status ? html`<span class="badge badge-info">${String(d.status)}</span>` : null}
-              </button>`)}
-            ${items.length > 5 ? html`
+                  <span class="pj-ov-item-title">${String(d[PRIMARY_FIELD[ot.name] || 'title'] || d.summary || d.id || '')}</span>
+                  ${d.status ? html`<span class="badge badge-info">${String(d.status)}</span>` : null}
+                </button>`;
+            })}
+            ${display.length > 5 ? html`
               <button class="pj-ov-more" onClick=${() => pickTab('space:' + ot.name)}>${(t('organisms.ovShowAll') || 'Show all {n} →').replace('{n}', String(items.length))}</button>` : null}
           </div>` : null}
       </div>`;
   };
 
+  // ── Measurability objectives (the manifest's objectives[] + each KPI's resolved current vs target).
+  // The server (overview endpoint) already computed `current` for from:records KPIs; we only render.
+  const kpiTargetText = (tg) => {
+    if (!tg || typeof tg.op !== 'string') return '';
+    if (tg.op === 'between' && Array.isArray(tg.values) && tg.values.length === 2) return `${tg.values[0]}–${tg.values[1]}`;
+    const sym = tg.op === '<=' ? '≤' : tg.op === '>=' ? '≥' : tg.op === '==' ? '=' : tg.op;
+    return typeof tg.value === 'number' ? `${sym} ${tg.value}` : '';
+  };
+  const kpiMeets = (cur, tg) => {
+    if (cur === null || cur === undefined || !tg || typeof tg.op !== 'string') return null;
+    const v = tg.value;
+    switch (tg.op) {
+      case '<': return typeof v === 'number' ? cur < v : null;
+      case '<=': return typeof v === 'number' ? cur <= v : null;
+      case '>': return typeof v === 'number' ? cur > v : null;
+      case '>=': return typeof v === 'number' ? cur >= v : null;
+      case '==': return typeof v === 'number' ? cur === v : null;
+      case 'between': return (Array.isArray(tg.values) && tg.values.length === 2) ? (cur >= tg.values[0] && cur <= tg.values[1]) : null;
+      default: return null;
+    }
+  };
+  const renderObjectives = () => html`
+    <div class="pj-obj">
+      <div class="pj-obj-title">${t('organisms.objectivesTitle') || 'Objectives'}</div>
+      ${wsObjectives.map((o, oi) => html`
+        <div class="pj-obj-card" key=${o.id || oi}>
+          <div class="pj-obj-statement">
+            ${(o.statement || o.id)}
+            ${o.status === 'met' ? html`<span class="badge badge-success pj-obj-status">${t('organisms.objStatusMet') || 'met'}</span>` : null}
+            ${o.status === 'abandoned' ? html`<span class="badge pj-obj-status">${t('organisms.objStatusAbandoned') || 'abandoned'}</span>` : null}
+          </div>
+          ${o.why ? html`<div class="pj-obj-why">${(o.why)}</div>` : null}
+          ${(o.kpis && o.kpis.length) ? html`
+            <div class="pj-obj-kpis">
+              ${o.kpis.map((k, ki) => {
+                const ok = kpiMeets(k.current, k.target);
+                const tgt = kpiTargetText(k.target);
+                const unit = k.unit ? ` ${k.unit}` : '';
+                const val = (k.current === null || k.current === undefined) ? '—' : String(k.current);
+                return html`
+                  <div class="pj-obj-kpi ${ok === true ? 'met' : ok === false ? 'off' : ''}" key=${k.name || ki}>
+                    <span class="pj-obj-kpi-name">${k.name}</span>
+                    <span class="pj-obj-kpi-val">${val}${unit}${ok === true ? ' ✅' : ok === false ? ' ⚠️' : ''}</span>
+                    ${tgt ? html`<span class="pj-obj-kpi-target">${(t('organisms.kpiTarget') || 'target {t}').replace('{t}', tgt)}</span>` : null}
+                    ${k.computed === false ? html`<span class="pj-obj-kpi-declared" title=${t('organisms.kpiDeclaredHint') || 'Self-reported — not computed from records'}>${t('organisms.kpiDeclared') || 'self-reported'}</span>` : null}
+                  </div>`;
+              })}
+            </div>` : null}
+        </div>`)}
+    </div>`;
+
   const renderOverview = () => {
     const recent = wsEvents.slice(0, 8);
     return html`
@@ -1173,7 +1349,7 @@ export function Workspace({ org, wsId, showToast, onBack, onBackToList, initialS
                 <span class="pj-act-dot ${e.action}"></span>
                 <span class="pj-ov-event-who">${shortActor(e.actor)}${e.agent ? html` <span class="pj-act-agent" title=${t('organisms.viaAgent') || 'via this agent'}>🤖 ${e.agent}</span>` : null}</span>
                 <span class="pj-ov-event-act">${e.action === 'publish' ? (t('organisms.publishedVerb') || 'published') : (t('organisms.editedVerb') || 'edited')}</span>
-                <span class="pj-ov-event-what">${e.mode === 'document' ? '📄' : '🗂'} ${(wsT('type.' + e.type) || e.type)}${' / '}${e.instance}</span>
+                <span class="pj-ov-event-what">${e.mode === 'document' ? '📄' : '🗂'} ${(wsT('type.' + e.type) || e.type)}${' / '}${instanceTitle(e.type, e.instance)}</span>
                 <span class="pj-ov-event-time">${relTime(e.at)}</span>
               </button>`)}
           </div>` : null}
@@ -1197,6 +1373,8 @@ export function Workspace({ org, wsId, showToast, onBack, onBackToList, initialS
       </div>
       ${ws.manifest?.summary ? html`<div class="section-desc">${(ws.manifest.summary)}</div>` : null}
 
+      ${wsObjectives.length ? renderObjectives() : null}
+
       <${ReadmePanel} markdown=${ws.readme || ''} canEdit=${wsCanEdit} kind="workspace" name=${ws.manifest?.name || 'Workspace'}
         aiPromptSeed=${wsTocSeed} onSave=${saveWsReadme} />
 

package/dist/public/views/secretary.js

@@ -0,0 +1,75 @@
+/**
+ * @file secretary.js
+ * @description Secretary view (Phase 0 shell). Confirms the per-owner Secretary agent is provisioned
+ *   and shows its identity + granted scopes. Reached from the header Secretary button, which appears
+ *   once OpenRouter is configured. The full interactive Secretary (onboarding interview, brain, chat,
+ *   feed, calendar) lands in later phases — see docs/plans/2026-06-23-secretary-feature.md.
+ * @structure SECRETARY_ICON (heart-shield + quill svg) · SecretaryView (default) — fetch /v1/agents,
+ *   find the `system:secretary` agent, show provisioning status + identity + scopes.
+ * @usage routed at /v1/secretary by spa.html.
+ * @version-history v0.1.0 — 2026-06-23 — Phase 0 shell: provisioning status + identity.
+ */
+import { h } from 'preact';
+import htm from 'htm';
+const html = htm.bind(h);
+import { useState, useEffect } from 'preact/hooks';
+import { t } from '/js/i18n.js';
+import { apiGet } from '/js/api.js';
+import { escHtml } from '/js/utils.js';
+import { useViewCSS } from '/components/useViewCSS.js';
+
+// Heart-shaped shield with a quill across it — the Secretary's mark.
+export const SECRETARY_ICON = html`
+  <svg viewBox="0 0 24 24" width="40" height="40" aria-hidden="true">
+    <path d="M12 20.6C6.4 16.7 3.4 13.2 3.4 9.2 3.4 6.5 5.4 4.6 7.9 4.6c1.7 0 3.2.9 4.1 2.4.9-1.5 2.4-2.4 4.1-2.4 2.5 0 4.5 1.9 4.5 4.6 0 4-3 7.5-8.6 11.4z"
+          fill="none" stroke="currentColor" stroke-width="1.5" stroke-linejoin="round"/>
+    <path d="M16 8l-5.6 5.6M10.4 13.6l-1.5 2.4 2.4-1.5"
+          fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round"/>
+  </svg>`;
+
+export default function SecretaryView() {
+  useViewCSS('/css/views/secretary.css');
+  // undefined = loading, null = not provisioned yet, object = the Secretary agent.
+  const [secretary, setSecretary] = useState(undefined);
+
+  useEffect(() => {
+    apiGet('/v1/agents')
+      .then((r) => {
+        const agents = (r && r.data && r.data.agents) || [];
+        const sec = agents.find((a) => (a.tags || []).includes('system:secretary'))
+          || agents.find((a) => a.name === 'secretary')
+          || null;
+        setSecretary(sec);
+      })
+      .catch(() => setSecretary(null));
+  }, []);
+
+  return html`
+    <div class="sec">
+      <header class="sec-hero">
+        <span class="sec-hero-icon">${SECRETARY_ICON}</span>
+        <div>
+          <h1 class="sec-title">${t('secretary.title')}</h1>
+          <p class="sec-desc">${t('secretary.desc')}</p>
+        </div>
+      </header>
+
+      ${secretary === undefined
+        ? html`<div class="sec-empty">…</div>`
+        : secretary === null
+        ? html`<div class="sec-empty">${t('secretary.notReady')}</div>`
+        : html`
+            <section class="sec-card">
+              <div class="sec-status"><span class="sec-dot"></span> ${t('secretary.ready')}</div>
+              <dl class="sec-meta">
+                <dt>${t('secretary.identity')}</dt>
+                <dd><code>${escHtml(secretary.gaii)}</code></dd>
+                <dt>${t('secretary.scopes')}</dt>
+                <dd class="sec-scopes">
+                  ${(secretary.default_scopes || []).map((s) => html`<span class="sec-scope" key=${s}>${s}</span>`)}
+                </dd>
+              </dl>
+              <p class="sec-soon">${t('secretary.soon')}</p>
+            </section>`}
+    </div>`;
+}

package/dist/src/cli/connect/tool-call.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-call.d.ts","sourceRoot":"","sources":["../../../../src/cli/connect/tool-call.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,EAA0D,KAAK,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAC/H,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEjE,OAAO,EAA+B,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEpF,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,UAAU,wBAAwB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CAC9E;AAED,UAAU,eAAe;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACrB;AAkHD,eAAO,MAAM,iBAAiB,EAAE,wBAAwB,EA4kCvD,CAAC;AAyDF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAS/D;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAahE;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAyD5G"}
+{"version":3,"file":"tool-call.d.ts","sourceRoot":"","sources":["../../../../src/cli/connect/tool-call.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,EAA0D,KAAK,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAC/H,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEjE,OAAO,EAA+B,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEpF,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,UAAU,wBAAwB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CAC9E;AAED,UAAU,eAAe;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACrB;AAkHD,eAAO,MAAM,iBAAiB,EAAE,wBAAwB,EAioCvD,CAAC;AAyDF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAS/D;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAahE;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAyD5G"}

package/dist/src/cli/connect/tool-call.js

@@ -353,6 +353,29 @@ export const CONNECT_CLI_TOOLS = [
             return client.post('/v1/messages', body);
         },
     },
+    {
+        name: 'aimeat_dm_ask',
+        handler: ({ client }, input) => {
+            const questions = optionalArray(input, 'questions');
+            if (!questions)
+                throw new Error('Missing required array field: questions');
+            const submitLabel = optionalString(input, 'submit_label');
+            const body = {
+                to: requiredString(input, 'to'),
+                interactive: { role: 'questions', v: 1, questions, ...(submitLabel ? { submitLabel } : {}) },
+            };
+            const intro = optionalString(input, 'body');
+            if (intro)
+                body.body = intro;
+            const subject = optionalString(input, 'subject');
+            if (subject)
+                body.subject = subject;
+            const conversationId = optionalString(input, 'conversation_id');
+            if (conversationId)
+                body.conversation_id = conversationId;
+            return client.post('/v1/messages', body);
+        },
+    },
     {
         name: 'aimeat_dm_inbox',
         description: 'Read recent federated DMs addressed to this agent (replies + messages people sent you), newest first.',
@@ -520,6 +543,22 @@ export const CONNECT_CLI_TOOLS = [
         name: 'aimeat_catalogue_search',
         handler: ({ client }, input) => client.get(`/v1/catalogue${query({ q: optionalString(input, 'query') })}`),
     },
+    {
+        name: 'aimeat_discover',
+        handler: ({ client }, input) => {
+            const q = query({
+                q: optionalString(input, 'q'),
+                type: optionalString(input, 'type'),
+                tags: optionalString(input, 'tags'),
+                segment: optionalString(input, 'segment'),
+                scope: optionalString(input, 'scope'),
+                per_page: optionalNumber(input, 'limit'),
+            });
+            // mode=map → facet counts only; mode=find (default) → ranked entries.
+            const path = optionalString(input, 'mode') === 'map' ? '/v1/discover/facets' : '/v1/discover';
+            return client.get(`${path}${q}`);
+        },
+    },
     {
         name: 'aimeat_agent_profile',
         handler: ({ client }, input) => client.get(`/v1/agents/${encodeURIComponent(requiredString(input, 'gaii'))}`),
@@ -800,6 +839,35 @@ export const CONNECT_CLI_TOOLS = [
         name: 'aimeat_organism_get',
         handler: ({ client }, input) => client.get(`/v1/organisms/${encodeURIComponent(requiredString(input, 'id'))}`),
     },
+    {
+        name: 'aimeat_organism_overview',
+        handler: ({ client }, input) => client.get(`/v1/organisms/${encodeURIComponent(requiredString(input, 'organism_id'))}/overview`),
+    },
+    {
+        name: 'aimeat_organism_update',
+        handler: ({ client }, input) => {
+            const body = {};
+            const name = optionalString(input, 'name');
+            if (name !== undefined)
+                body.name = name;
+            const description = optionalString(input, 'description');
+            if (description !== undefined)
+                body.description = description;
+            const readme = optionalString(input, 'readme');
+            if (readme !== undefined)
+                body.readme = readme;
+            const interests = optionalArray(input, 'interests');
+            if (interests)
+                body.interests = interests;
+            const joinPolicy = optionalString(input, 'join_policy');
+            if (joinPolicy)
+                body.join_policy = joinPolicy;
+            const visibility = optionalString(input, 'visibility');
+            if (visibility)
+                body.visibility = visibility;
+            return client.put(`/v1/organisms/${encodeURIComponent(requiredString(input, 'organism_id'))}`, body);
+        },
+    },
     {
         name: 'aimeat_organism_join',
         handler: ({ client }, input) => client.post(`/v1/organisms/${encodeURIComponent(requiredString(input, 'id'))}/join`),
@@ -938,6 +1006,10 @@ export const CONNECT_CLI_TOOLS = [
         name: 'aimeat_workspace_read',
         handler: ({ client }, input) => client.get(`/v1/organisms/${encodeURIComponent(requiredString(input, 'organism_id'))}/workspace${query({ ws: requiredString(input, 'ws') })}`),
     },
+    {
+        name: 'aimeat_workspace_overview',
+        handler: ({ client }, input) => client.get(`/v1/organisms/${encodeURIComponent(requiredString(input, 'organism_id'))}/workspace/overview${query({ ws: requiredString(input, 'ws') })}`),
+    },
     {
         name: 'aimeat_workspace_write',
         handler: async ({ client }, input) => {