nexus-prime 7.9.29 → 7.9.30

package/dist/dashboard/app/styles/workforce.css

@@ -134,7 +134,7 @@
 .kanban-meta { font-size: 0.75rem; color: var(--text-dim); margin-bottom: 8px; padding: 0 4px; }
 .kanban-scroll { display: flex; gap: 10px; overflow-x: auto; padding-bottom: 8px; }
 .kanban-lane {
-    min-width: 160px; max-width: 200px; flex-shrink: 0;
+    min-width: 220px; max-width: 280px; flex-shrink: 0;
     background: var(--bg-panel); border: 1px solid var(--border);
     border-radius: var(--radius); display: flex; flex-direction: column;
 }
@@ -170,6 +170,56 @@
 }
 .kc-id { font-size: 0.65rem; color: var(--text-dim); font-family: var(--font-mono); }
 .kc-title { font-size: 0.74rem; color: var(--text-main); line-height: 1.35; word-break: break-word; }
+.kc-goal {
+    margin-top: 5px;
+    color: var(--text-main);
+    font-size: 0.72rem;
+    line-height: 1.35;
+    word-break: break-word;
+}
+.kc-flow {
+    margin-top: 7px;
+    display: grid;
+    gap: 5px;
+}
+.kc-flow div {
+    border-left: 2px solid rgba(255,255,255,0.08);
+    padding-left: 7px;
+}
+.kc-flow span {
+    display: block;
+    margin-bottom: 1px;
+    color: var(--text-dim);
+    font-size: 0.58rem;
+    font-family: var(--font-mono);
+    text-transform: uppercase;
+}
+.kc-flow p {
+    margin: 0;
+    color: var(--text-muted);
+    font-size: 0.66rem;
+    line-height: 1.3;
+    word-break: break-word;
+}
+.kc-meta {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 4px;
+    margin-top: 7px;
+}
+.kc-meta span {
+    max-width: 100%;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    color: var(--text-dim);
+    background: var(--bg-panel);
+    border: 1px solid rgba(255,255,255,0.06);
+    border-radius: 3px;
+    padding: 1px 5px;
+    font-size: 0.6rem;
+    font-family: var(--font-mono);
+}
 .kc-worker { font-size: 0.65rem; color: var(--text-dim); font-family: var(--font-mono); margin-top: 3px; display: block; }
 .kanban-overflow { font-size: 0.7rem; color: var(--text-dim); text-align: center; padding: 4px; }
 .kanban-empty { color: var(--text-dim); font-size: 0.8rem; padding: 20px; text-align: center; }

package/dist/dashboard/app/views/board.js

@@ -524,16 +524,19 @@ function renderFirstRunHero() {
             }
             btn.disabled = true; btn.textContent = 'Hiring…';
             setFirstRunStatus('Submitting hire request…');
+            const input = card.querySelector('#frh-goal-input');
+            const goal = (input?.value || `Use ${btn.dataset.specname || 'this specialist'} to inspect ${S.workspace?.repoName || 'this repo'} and report the next useful task`).trim();
             const result = await post('/api/synapse/hire', {
                 specialistId: btn.dataset.specid,
                 name: btn.dataset.specname,
                 budgetCapUsd: 2,
                 fireFirstSortie: true,
+                goal,
             });
             if (result.ok) {
                 setFirstRunStatus(readiness.notes.some(note => note.tone === 'warn')
-                    ? 'Hired successfully. Fallback storage warning is still active.'
-                    : 'Hired successfully.');
+                    ? 'Hired and first goal queued. Fallback storage warning is still active.'
+                    : 'Hired and first goal queued.');
                 try { localStorage.setItem(FIRST_RUN_KEY, '1'); } catch { /* ignore */ }
                 bustCache('/api/synapse/health');
                 setTimeout(load, 800);

package/dist/dashboard/app/views/workforce.js

@@ -26,6 +26,25 @@ function statusChip(s) {
     if (['failed','error','blocked','zombie','dead'].includes(v)) return chipHtml(s,'bad');
     return chipHtml(s);
 }
+function firstText(...values) {
+    for (const value of values) {
+        if (typeof value === 'string' && value.trim()) return value.trim();
+    }
+    return '';
+}
+function clipText(value, max=140) {
+    const text = String(value ?? '').trim();
+    return text.length > max ? `${text.slice(0, max - 1)}…` : text;
+}
+function lifecycleLabel(card, payload) {
+    const status = String(card?.status ?? payload?.status ?? '').toLowerCase();
+    if (status === 'done') return 'Completed';
+    if (status === 'failed') return 'Failed';
+    if (status === 'blocked') return 'Blocked';
+    if (status === 'review') return 'In review';
+    if (status === 'wip' || status === 'claimed') return 'Running';
+    return 'Queued';
+}
 
 /* ── Active-dispatch state (push-mode) ── */
 // Keyed by runId.  Entries are created on dispatch.started and removed on complete/failed/cancelled.
@@ -202,7 +221,7 @@ function renderKanban() {
     if (total === 0) {
         el.innerHTML = `<div class="kanban-empty kanban-empty-panel">
             <div class="kanban-empty-title">No workforce jobs yet</div>
-            <div class="kanban-empty-sub">Run a goal or hire a specialist; the board will populate when work is actually dispatched.</div>
+            <div class="kanban-empty-sub">Run a dashboard goal or hire a specialist with a first goal; this board only shows real assigned work.</div>
         </div>`;
         return;
     }
@@ -214,7 +233,7 @@ function renderKanban() {
         const MAX_VISIBLE = 8;
         const visible = cards.slice(0, MAX_VISIBLE);
         const overflow = cards.length - MAX_VISIBLE;
-        const cardsHtml = visible.map(c => _buildKanbanCard(c)).join('');
+        const cardsHtml = visible.map(c => _buildKanbanCard(c, lane)).join('');
         const overflowHtml = overflow > 0
             ? `<div class="kanban-overflow">+${overflow} more</div>`
             : '';
@@ -231,14 +250,31 @@ function renderKanban() {
         <div class="kanban-scroll">${lanesHtml || '<div class="kanban-empty">No visible lanes for the selected filters.</div>'}</div>`;
 }
 
-function _buildKanbanCard(c) {
+function _buildKanbanCard(c, lane) {
+    const payload = c.payload && typeof c.payload === 'object' ? c.payload : {};
     const shortId = String(c.id ?? '').slice(0, 8);
     const title   = esc(String(c.title ?? shortId).slice(0, 60));
+    const goal    = clipText(firstText(payload.goal, c.title), 120);
+    const expected = clipText(firstText(payload.expectedBehavior, 'Worker owns this dashboard job and closes it with proof.'), 132);
+    const actual  = clipText(firstText(payload.actualStatus, lifecycleLabel({ status: lane }, payload)), 132);
+    const runId   = firstText(payload.runId, payload.completedRunId);
+    const mode    = firstText(payload.mode, c.client);
     const wid     = c.workerId ? `<span class="kc-worker">→ ${esc(String(c.workerId).slice(0, 8))}</span>` : '';
     const pri     = c.priority != null ? `<span class="kc-pri">${c.priority}</span>` : '';
-    return `<div class="kanban-card" title="${title}">
+    const meta = [
+        mode ? `<span>${esc(mode)}</span>` : '',
+        runId ? `<span>${esc(String(runId).slice(0, 12))}</span>` : '',
+        c.tokensUsed ? `<span>${fmtNum(c.tokensUsed)}t</span>` : '',
+    ].filter(Boolean).join('');
+    return `<div class="kanban-card" title="${esc([title, goal, actual].filter(Boolean).join(' · '))}">
         <div class="kc-top">${pri}<span class="kc-id">${shortId}</span></div>
         <div class="kc-title">${title}</div>
+        ${goal ? `<div class="kc-goal">${esc(goal)}</div>` : ''}
+        <div class="kc-flow">
+            <div><span>Expected</span><p>${esc(expected)}</p></div>
+            <div><span>Actual</span><p>${esc(actual)}</p></div>
+        </div>
+        ${meta ? `<div class="kc-meta">${meta}</div>` : ''}
         ${wid}
     </div>`;
 }
@@ -470,6 +506,7 @@ function _formatHireFailure(result) {
 function _showHireSheet(specialistId, name) {
     const { opOptions, teamOptions } = _buildHireSelectors();
     const readiness = _getHireReadiness();
+    const defaultGoal = `Use ${name} to inspect ${S.workspace?.repoName || 'this repo'} and identify the next useful task.`;
     const noticesHtml = readiness.notes.length
         ? `<div class="dsec" style="margin-bottom:var(--space-4)">
             ${readiness.notes.map(note => `<div style="padding:8px 10px;border:1px solid ${note.tone === 'bad' ? '#ff5f5733' : '#ffd14d33'};background:${note.tone === 'bad' ? '#ff5f5712' : '#ffd14d12'};color:${note.tone === 'bad' ? 'var(--bad)' : '#ffd14d'};border-radius:8px;font-size:var(--text-sm);margin-bottom:8px">${esc(note.text)}</div>`).join('')}
@@ -485,7 +522,10 @@ function _showHireSheet(specialistId, name) {
             <label style="display:block;margin-bottom:var(--space-2);font-size:var(--text-sm);color:var(--text-muted)">Budget cap (USD)</label>
             <input type="number" id="hire-budget" value="2.00" step="0.50" min="0.50" max="50"
                 style="width:100%;background:var(--bg-panel);border:1px solid var(--border);border-radius:var(--radius);padding:6px 10px;font-size:var(--text-sm);color:var(--text-main);margin-bottom:var(--space-4)">
-            <button class="btn btn-primary" id="hire-confirm-btn" data-specid="${esc(specialistId)}" data-specname="${esc(name)}" ${readiness.blocked ? 'disabled title="Synapse is not ready"' : ''}>Confirm Hire</button>
+            <label style="display:block;margin-bottom:var(--space-2);font-size:var(--text-sm);color:var(--text-muted)">First goal</label>
+            <textarea id="hire-goal" rows="3"
+                style="width:100%;background:var(--bg-panel);border:1px solid var(--border);border-radius:var(--radius);padding:8px 10px;font-size:var(--text-sm);color:var(--text-main);margin-bottom:var(--space-4);resize:vertical">${esc(defaultGoal)}</textarea>
+            <button class="btn btn-primary" id="hire-confirm-btn" data-specid="${esc(specialistId)}" data-specname="${esc(name)}" ${readiness.blocked ? 'disabled title="Synapse is not ready"' : ''}>Hire and Run Goal</button>
             <div id="hire-inline-status" style="margin-top:var(--space-3);font-size:var(--text-sm);color:${readiness.blocked ? 'var(--bad)' : 'var(--text-muted)'}">${readiness.blocked ? esc(readiness.notes[0]?.text || 'Synapse is not ready for hires.') : ''}</div>
         </div>` });
 
@@ -500,6 +540,7 @@ function _showHireSheet(specialistId, name) {
         const budget = parseFloat(document.getElementById('hire-budget')?.value||'2');
         const reportsToVal = (document.getElementById('hire-reports-to')?.value||'').trim()||null;
         const teamVal = (document.getElementById('hire-team')?.value||'').trim()||null;
+        const goal = (document.getElementById('hire-goal')?.value || defaultGoal).trim() || defaultGoal;
         const inlineStatus = document.getElementById('hire-inline-status');
         if (inlineStatus) {
             inlineStatus.textContent = readiness.notes.some(note => note.tone === 'warn')
@@ -518,6 +559,7 @@ function _showHireSheet(specialistId, name) {
             reportsToOperativeId: reportsToVal,
             strikeTeamId: teamVal,
             fireFirstSortie: true,
+            goal,
         }, { optimistic: optimisticRecord });
 
         // Immediately open drawer with pending state.
@@ -529,6 +571,7 @@ function _showHireSheet(specialistId, name) {
                 <div class="drow"><span class="drow-k">Reports to</span><span class="drow-v">${esc(reportsToVal || 'team lead')}</span></div>
                 <div class="drow"><span class="drow-k">Strike team</span><span class="drow-v">${esc(teamVal || 'solo')}</span></div>
                 <div class="drow"><span class="drow-k">Budget cap</span><span class="drow-v">$${budget.toFixed(2)}</span></div>
+                <div class="drow"><span class="drow-k">Goal</span><span class="drow-v">${esc(clipText(goal, 120))}</span></div>
             </div>` });
 
         // Reconcile when real response arrives.
@@ -537,8 +580,8 @@ function _showHireSheet(specialistId, name) {
             if (real.ok) {
                 if (msg) {
                     msg.textContent = readiness.notes.some(note => note.tone === 'warn')
-                        ? 'Hired successfully. Fallback storage warning is still active.'
-                        : 'Hired successfully.';
+                        ? 'Hired and first goal queued. Fallback storage warning is still active.'
+                        : 'Hired and first goal queued.';
                 }
                 const idRow = document.getElementById('hire-id-row');
                 const idVal = document.getElementById('hire-id-val');
@@ -564,7 +607,7 @@ function _showHireSheet(specialistId, name) {
                             drawerBody.appendChild(stripDiv);
                         }
                         const warmupKey = `__warmup__:${operativeId}`;
-                        const warmupRun = { runId: warmupKey, operativeId, status: 'queued', tokens: 0, costUsd: 0, messages: ['Adapter pending; waiting for dispatch.started…'], filesChanged: [], pendingAdapter: true };
+                        const warmupRun = { runId: warmupKey, operativeId, status: 'queued', tokens: 0, costUsd: 0, messages: [`Goal queued: ${goal}`, 'Adapter pending; waiting for dispatch.started…'], filesChanged: [], pendingAdapter: true };
                         _dispatches.set(warmupKey, warmupRun);
                         stripDiv.innerHTML = _buildDispatchStrip(warmupRun);
                     }

package/dist/dashboard/routes/governance.js

@@ -78,6 +78,9 @@ export const handleGovernanceRoutes = async (ctx, req, res, url) => {
         const specialistId = typeof body.specialistId === 'string'
             ? body.specialistId
             : (typeof body.specialist === 'string' ? body.specialist : undefined);
+        const requestedGoal = typeof body.goal === 'string' && body.goal.trim()
+            ? body.goal.trim()
+            : null;
         if (!name && !specialistId) {
             ctx.respondJson(res, { error: 'name-or-specialistId-required' }, 400);
             return true;
@@ -117,13 +120,23 @@ export const handleGovernanceRoutes = async (ctx, req, res, url) => {
             // Non-blocking: the dashboard gets an immediate hire response while the
             // Workforce job and run lifecycle continue through SSE and kanban state.
             if (body.fireFirstSortie === true && operativeId) {
-                firstDispatch = { queued: true, operativeId, mode: 'pending' };
+                const displayName = result?.name ?? specialistProfile?.name ?? name ?? specialistId ?? operativeId;
+                const repoName = path.basename(ctx.repoRoot ?? process.cwd());
+                const firstGoal = requestedGoal
+                    ?? `Use ${displayName} to inspect ${repoName}, report what is working, and name the next useful task.`;
+                firstDispatch = {
+                    queued: true,
+                    operativeId,
+                    mode: 'pending',
+                    goal: firstGoal,
+                    expectedBehavior: 'Hire creates an operative, assigns this goal as a Workforce job, and moves the job through dispatch or orchestrator fallback.',
+                };
                 runDashboardAgentControl(ctx, new URL(`${baseUrl}/api/workforce/agents/${encodeURIComponent(operativeId)}/dispatch`), {
                     operativeId,
                     specialistId: result?.specialistId ?? specialistId ?? null,
                     budgetCapUsd: result?.budgetCapUsd ?? 0.50,
-                    title: `First sortie: ${result?.name ?? specialistProfile?.name ?? operativeId}`,
-                    goal: 'Introduce yourself to the codebase. Read the README and two source files, then report the repo shape and next useful task.',
+                    title: requestedGoal ? `Dashboard goal: ${firstGoal.slice(0, 64)}` : `First sortie: ${displayName}`,
+                    goal: firstGoal,
                 }).then(r => {
                     nexusEventBus.emit('dashboard.action', {
                         action: 'synapse.first-sortie.dispatched',

package/dist/dashboard/routes/workforce.js

@@ -77,6 +77,11 @@ export async function runDashboardAgentControl(ctx, url, input) {
             operativeId,
             specialistId: input.specialistId ?? worker.role,
             source: 'dashboard-agent-control',
+            expectedBehavior: 'A real Workforce job is owned by this operative, routed through dispatch when available, then moved to done or failed with proof.',
+            actualStatus: 'Job enqueued and claimed; waiting for dispatch adapter.',
+            lifecycle: ['worker-materialized', 'job-enqueued', 'claim-acquired'],
+            mode: input.preferredRuntime ? `preferred:${input.preferredRuntime}` : 'dispatch',
+            assignedAt: Date.now(),
         },
     });
     const claim = wf.claimJob(job.id, worker.id, 15 * 60_000);
@@ -105,12 +110,29 @@ export async function runDashboardAgentControl(ctx, url, input) {
             crGraphContext,
             storeMemory: async (content, priority, tags) => { memory?.store?.(content, priority, tags); },
         });
+        wf.patchJobPayload(job.id, {
+            runId: dispatch.runId,
+            invoker: dispatch.invoker,
+            mode: 'dispatch',
+            actualStatus: 'Dispatch accepted; waiting for runtime completion.',
+            lifecycle: ['worker-materialized', 'job-enqueued', 'claim-acquired', 'dispatch-accepted'],
+        });
         const cleanup = [
             nexusEventBus.on('dispatch.complete', (payload) => {
                 if (payload.runId !== dispatch.runId)
                     return;
                 wf.recordTokens(job.id, worker.id, Number(payload.tokensUsed ?? 0));
-                if (payload.success === false)
+                const ok = payload.success !== false;
+                wf.patchJobPayload(job.id, {
+                    actualStatus: ok ? 'Completed through dispatch runtime.' : 'Dispatch runtime reported failure.',
+                    completedRunId: dispatch.runId,
+                    tokensUsed: Number(payload.tokensUsed ?? 0),
+                    filesChanged: Array.isArray(payload.filesChanged) ? payload.filesChanged : [],
+                    lifecycle: ok
+                        ? ['worker-materialized', 'job-enqueued', 'claim-acquired', 'dispatch-accepted', 'dispatch-complete']
+                        : ['worker-materialized', 'job-enqueued', 'claim-acquired', 'dispatch-accepted', 'dispatch-failed'],
+                });
+                if (!ok)
                     wf.failJob(job.id, worker.id);
                 else
                     wf.completeJob(job.id, worker.id);
@@ -119,6 +141,12 @@ export async function runDashboardAgentControl(ctx, url, input) {
             nexusEventBus.on('dispatch.failed', (payload) => {
                 if (payload.runId !== dispatch.runId)
                     return;
+                wf.patchJobPayload(job.id, {
+                    actualStatus: 'Dispatch failed before completion.',
+                    runId: dispatch.runId,
+                    failureReason: payload.error ?? 'dispatch.failed',
+                    lifecycle: ['worker-materialized', 'job-enqueued', 'claim-acquired', 'dispatch-accepted', 'dispatch-failed'],
+                });
                 wf.failJob(job.id, worker.id);
                 cleanup.forEach((unsubscribe) => unsubscribe());
             }),
@@ -127,6 +155,12 @@ export async function runDashboardAgentControl(ctx, url, input) {
     }
     catch (dispatchError) {
         if (!orchestrator) {
+            wf.patchJobPayload(job.id, {
+                actualStatus: 'Dispatch failed and no local orchestrator fallback was available.',
+                failureReason: dispatchError?.message ?? String(dispatchError),
+                mode: 'dispatch-unavailable',
+                lifecycle: ['worker-materialized', 'job-enqueued', 'claim-acquired', 'dispatch-failed'],
+            });
             wf.failJob(job.id, worker.id);
             throw dispatchError;
         }
@@ -137,6 +171,18 @@ export async function runDashboardAgentControl(ctx, url, input) {
             specialistId: input.specialistId ?? worker.role,
             operativeId,
         });
+        wf.patchJobPayload(job.id, {
+            runId: run.runId,
+            mode: 'orchestrator-fallback',
+            invoker: 'nexus-orchestrator',
+            fallbackReason: dispatchError?.message ?? String(dispatchError),
+            actualStatus: run.state === 'failed'
+                ? 'Local orchestrator fallback failed.'
+                : 'Completed through local orchestrator fallback.',
+            lifecycle: run.state === 'failed'
+                ? ['worker-materialized', 'job-enqueued', 'claim-acquired', 'dispatch-failed', 'orchestrator-fallback-failed']
+                : ['worker-materialized', 'job-enqueued', 'claim-acquired', 'dispatch-failed', 'orchestrator-fallback-complete'],
+        });
         if (run.state === 'failed')
             wf.failJob(job.id, worker.id);
         else

package/dist/workforce/db/schema.d.ts

@@ -5,5 +5,5 @@
  * (no DROP, no rename). Migration copies live data on first init.
  */
 import type { WorkforceDb } from '../types.js';
-export declare const WORKFORCE_SCHEMA = "\nCREATE TABLE IF NOT EXISTS workforce_workers (\n  id               TEXT PRIMARY KEY,\n  name             TEXT NOT NULL UNIQUE,\n  role             TEXT,\n  client           TEXT NOT NULL DEFAULT 'unknown',\n  status           TEXT NOT NULL DEFAULT 'idle'\n    CHECK(status IN ('idle','active','stale','retired')),\n  budget_cap_usd   REAL NOT NULL DEFAULT 10.0,\n  spent_usd        REAL NOT NULL DEFAULT 0.0,\n  score            REAL NOT NULL DEFAULT 0.0,\n  last_heartbeat   INTEGER NOT NULL DEFAULT 0,\n  created_at       INTEGER NOT NULL DEFAULT (strftime('%s','now')*1000)\n);\n\nCREATE TABLE IF NOT EXISTS workforce_jobs (\n  id               TEXT PRIMARY KEY,\n  title            TEXT NOT NULL,\n  tier             TEXT NOT NULL DEFAULT 'tactical'\n    CHECK(tier IN ('strategy','tactical')),\n  status           TEXT NOT NULL DEFAULT 'ready'\n    CHECK(status IN ('backlog','ready','claimed','wip','blocked','review','done','failed','cancelled')),\n  priority         INTEGER NOT NULL DEFAULT 5,\n  worker_id        TEXT,\n  parent_id        TEXT,\n  depends_on       TEXT NOT NULL DEFAULT '[]',\n  budget_cap_usd   REAL,\n  tokens_used      INTEGER NOT NULL DEFAULT 0,\n  payload          TEXT NOT NULL DEFAULT '{}',\n  client           TEXT NOT NULL DEFAULT 'unknown',\n  claimed_at       INTEGER,\n  completed_at     INTEGER,\n  created_at       INTEGER NOT NULL DEFAULT (strftime('%s','now')*1000)\n);\n\nCREATE TABLE IF NOT EXISTS workforce_claims (\n  id               TEXT PRIMARY KEY,\n  job_id           TEXT NOT NULL REFERENCES workforce_jobs(id) ON DELETE CASCADE,\n  worker_id        TEXT NOT NULL,\n  acquired_at      INTEGER NOT NULL DEFAULT (strftime('%s','now')*1000),\n  released_at      INTEGER,\n  lease_ms         INTEGER NOT NULL DEFAULT 300000,\n  expires_at       INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_wf_jobs_status       ON workforce_jobs(status, priority);\nCREATE INDEX IF NOT EXISTS idx_wf_jobs_worker        ON workforce_jobs(worker_id, status);\nCREATE INDEX IF NOT EXISTS idx_wf_jobs_parent        ON workforce_jobs(parent_id);\nCREATE INDEX IF NOT EXISTS idx_wf_workers_status     ON workforce_workers(status, last_heartbeat);\nCREATE INDEX IF NOT EXISTS idx_wf_claims_job         ON workforce_claims(job_id, released_at);\nCREATE INDEX IF NOT EXISTS idx_wf_claims_expiry      ON workforce_claims(job_id, expires_at, released_at);\n\nCREATE VIEW IF NOT EXISTS vw_kanban AS\n  SELECT\n    status AS lane,\n    id, title, worker_id, priority, tokens_used,\n    budget_cap_usd, client, created_at, claimed_at\n  FROM workforce_jobs\n  WHERE\n    -- Active lanes: always show\n    status NOT IN ('done', 'failed', 'cancelled')\n    OR\n    -- Terminal lanes: only show last 7 days to prevent unbounded growth\n    completed_at > (strftime('%s','now') - 7*86400) * 1000\n  ORDER BY\n    CASE status\n      WHEN 'backlog'   THEN 1\n      WHEN 'ready'     THEN 2\n      WHEN 'claimed'   THEN 3\n      WHEN 'wip'       THEN 4\n      WHEN 'blocked'   THEN 5\n      WHEN 'review'    THEN 6\n      WHEN 'done'      THEN 7\n      WHEN 'failed'    THEN 8\n      WHEN 'cancelled' THEN 9\n      ELSE 10\n    END,\n    priority,\n    created_at;\n\nCREATE VIEW IF NOT EXISTS vw_worker_load AS\n  SELECT\n    w.id, w.name, w.role, w.status, w.client,\n    COUNT(j.id)        AS active_jobs,\n    COALESCE(SUM(j.tokens_used), 0) AS total_tokens,\n    w.spent_usd,\n    w.budget_cap_usd,\n    w.last_heartbeat\n  FROM workforce_workers w\n  LEFT JOIN workforce_jobs j\n    ON j.worker_id = w.id AND j.status IN ('claimed','wip','review')\n  GROUP BY w.id;\n";
+export declare const WORKFORCE_SCHEMA = "\nCREATE TABLE IF NOT EXISTS workforce_workers (\n  id               TEXT PRIMARY KEY,\n  name             TEXT NOT NULL UNIQUE,\n  role             TEXT,\n  client           TEXT NOT NULL DEFAULT 'unknown',\n  status           TEXT NOT NULL DEFAULT 'idle'\n    CHECK(status IN ('idle','active','stale','retired')),\n  budget_cap_usd   REAL NOT NULL DEFAULT 10.0,\n  spent_usd        REAL NOT NULL DEFAULT 0.0,\n  score            REAL NOT NULL DEFAULT 0.0,\n  last_heartbeat   INTEGER NOT NULL DEFAULT 0,\n  created_at       INTEGER NOT NULL DEFAULT (strftime('%s','now')*1000)\n);\n\nCREATE TABLE IF NOT EXISTS workforce_jobs (\n  id               TEXT PRIMARY KEY,\n  title            TEXT NOT NULL,\n  tier             TEXT NOT NULL DEFAULT 'tactical'\n    CHECK(tier IN ('strategy','tactical')),\n  status           TEXT NOT NULL DEFAULT 'ready'\n    CHECK(status IN ('backlog','ready','claimed','wip','blocked','review','done','failed','cancelled')),\n  priority         INTEGER NOT NULL DEFAULT 5,\n  worker_id        TEXT,\n  parent_id        TEXT,\n  depends_on       TEXT NOT NULL DEFAULT '[]',\n  budget_cap_usd   REAL,\n  tokens_used      INTEGER NOT NULL DEFAULT 0,\n  payload          TEXT NOT NULL DEFAULT '{}',\n  client           TEXT NOT NULL DEFAULT 'unknown',\n  claimed_at       INTEGER,\n  completed_at     INTEGER,\n  created_at       INTEGER NOT NULL DEFAULT (strftime('%s','now')*1000)\n);\n\nCREATE TABLE IF NOT EXISTS workforce_claims (\n  id               TEXT PRIMARY KEY,\n  job_id           TEXT NOT NULL REFERENCES workforce_jobs(id) ON DELETE CASCADE,\n  worker_id        TEXT NOT NULL,\n  acquired_at      INTEGER NOT NULL DEFAULT (strftime('%s','now')*1000),\n  released_at      INTEGER,\n  lease_ms         INTEGER NOT NULL DEFAULT 300000,\n  expires_at       INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_wf_jobs_status       ON workforce_jobs(status, priority);\nCREATE INDEX IF NOT EXISTS idx_wf_jobs_worker        ON workforce_jobs(worker_id, status);\nCREATE INDEX IF NOT EXISTS idx_wf_jobs_parent        ON workforce_jobs(parent_id);\nCREATE INDEX IF NOT EXISTS idx_wf_workers_status     ON workforce_workers(status, last_heartbeat);\nCREATE INDEX IF NOT EXISTS idx_wf_claims_job         ON workforce_claims(job_id, released_at);\nCREATE INDEX IF NOT EXISTS idx_wf_claims_expiry      ON workforce_claims(job_id, expires_at, released_at);\n\nDROP VIEW IF EXISTS vw_kanban;\n\nCREATE VIEW vw_kanban AS\n  SELECT\n    status AS lane,\n    id, title, worker_id, priority, tokens_used,\n    budget_cap_usd, payload, client, created_at, claimed_at, completed_at\n  FROM workforce_jobs\n  WHERE\n    -- Active lanes: always show\n    status NOT IN ('done', 'failed', 'cancelled')\n    OR\n    -- Terminal lanes: only show last 7 days to prevent unbounded growth\n    completed_at > (strftime('%s','now') - 7*86400) * 1000\n  ORDER BY\n    CASE status\n      WHEN 'backlog'   THEN 1\n      WHEN 'ready'     THEN 2\n      WHEN 'claimed'   THEN 3\n      WHEN 'wip'       THEN 4\n      WHEN 'blocked'   THEN 5\n      WHEN 'review'    THEN 6\n      WHEN 'done'      THEN 7\n      WHEN 'failed'    THEN 8\n      WHEN 'cancelled' THEN 9\n      ELSE 10\n    END,\n    priority,\n    created_at;\n\nCREATE VIEW IF NOT EXISTS vw_worker_load AS\n  SELECT\n    w.id, w.name, w.role, w.status, w.client,\n    COUNT(j.id)        AS active_jobs,\n    COALESCE(SUM(j.tokens_used), 0) AS total_tokens,\n    w.spent_usd,\n    w.budget_cap_usd,\n    w.last_heartbeat\n  FROM workforce_workers w\n  LEFT JOIN workforce_jobs j\n    ON j.worker_id = w.id AND j.status IN ('claimed','wip','review')\n  GROUP BY w.id;\n";
 export declare function initWorkforceSchema(db: WorkforceDb): void;

package/dist/workforce/db/schema.js

@@ -56,11 +56,13 @@ CREATE INDEX IF NOT EXISTS idx_wf_workers_status     ON workforce_workers(status
 CREATE INDEX IF NOT EXISTS idx_wf_claims_job         ON workforce_claims(job_id, released_at);
 CREATE INDEX IF NOT EXISTS idx_wf_claims_expiry      ON workforce_claims(job_id, expires_at, released_at);
 
-CREATE VIEW IF NOT EXISTS vw_kanban AS
+DROP VIEW IF EXISTS vw_kanban;
+
+CREATE VIEW vw_kanban AS
   SELECT
     status AS lane,
     id, title, worker_id, priority, tokens_used,
-    budget_cap_usd, client, created_at, claimed_at
+    budget_cap_usd, payload, client, created_at, claimed_at, completed_at
   FROM workforce_jobs
   WHERE
     -- Active lanes: always show

package/dist/workforce/index.d.ts

@@ -5,14 +5,14 @@
  * All MCP tools go through getWorkforce(root).
  */
 import { registerWorker, getWorker, listWorkers, listCompanies, heartbeat, retireWorker, markStaleWorkers, recordSpend, adjustScore } from './workers.js';
-import { enqueueJob, getJob, listJobs, claimNextReady, advanceToWip, advanceToReview, recordTokens, completeJob, failJob, blockJob, cancelJob } from './jobs.js';
+import { enqueueJob, getJob, listJobs, claimNextReady, advanceToWip, advanceToReview, recordTokens, completeJob, failJob, blockJob, cancelJob, patchJobPayload } from './jobs.js';
 import { claimJob, renewClaim, releaseClaim, reclaimExpiredLocks } from './claim-lock.js';
 import { getKanbanBoard, getLaneJobs } from './kanban-view.js';
 import { reconcileDag } from './dag.js';
 import type { WorkforceDb, Worker, Job, Claim, KanbanBoard, KanbanCard, JobStatus, RegisterWorkerInput, EnqueueJobInput } from './types.js';
 export type { Worker, Job, Claim, KanbanBoard, KanbanCard, JobStatus, WorkforceDb };
 export { registerWorker, getWorker, listWorkers, listCompanies, heartbeat, retireWorker, markStaleWorkers, recordSpend, adjustScore };
-export { enqueueJob, getJob, listJobs, claimNextReady, advanceToWip, advanceToReview, recordTokens, completeJob, failJob, blockJob, cancelJob };
+export { enqueueJob, getJob, listJobs, claimNextReady, advanceToWip, advanceToReview, recordTokens, completeJob, failJob, blockJob, cancelJob, patchJobPayload };
 export { claimJob, renewClaim, releaseClaim, reclaimExpiredLocks };
 export { getKanbanBoard, getLaneJobs };
 export { reconcileDag };
@@ -37,6 +37,7 @@ export declare class WorkforceRuntime {
     advanceToWip(jobId: string, workerId: string): void;
     advanceToReview(jobId: string, workerId: string): void;
     recordTokens(jobId: string, workerId: string, tokens: number): void;
+    patchJobPayload(jobId: string, patch: Record<string, unknown>): Job | null;
     completeJob(jobId: string, workerId: string): Job | null;
     failJob(jobId: string, workerId: string): Job | null;
     blockJob(jobId: string, workerId: string): Job | null;

package/dist/workforce/index.js

@@ -7,12 +7,12 @@
 import path from 'path';
 import { openWorkforceDb } from './db/client.js';
 import { registerWorker, getWorker, listWorkers, listCompanies, heartbeat, retireWorker, markStaleWorkers, recordSpend, adjustScore } from './workers.js';
-import { enqueueJob, getJob, listJobs, claimNextReady, advanceToWip, advanceToReview, recordTokens, completeJob, failJob, blockJob, cancelJob } from './jobs.js';
+import { enqueueJob, getJob, listJobs, claimNextReady, advanceToWip, advanceToReview, recordTokens, completeJob, failJob, blockJob, cancelJob, patchJobPayload } from './jobs.js';
 import { claimJob, renewClaim, releaseClaim, reclaimExpiredLocks } from './claim-lock.js';
 import { getKanbanBoard, getLaneJobs } from './kanban-view.js';
 import { reconcileDag } from './dag.js';
 export { registerWorker, getWorker, listWorkers, listCompanies, heartbeat, retireWorker, markStaleWorkers, recordSpend, adjustScore };
-export { enqueueJob, getJob, listJobs, claimNextReady, advanceToWip, advanceToReview, recordTokens, completeJob, failJob, blockJob, cancelJob };
+export { enqueueJob, getJob, listJobs, claimNextReady, advanceToWip, advanceToReview, recordTokens, completeJob, failJob, blockJob, cancelJob, patchJobPayload };
 export { claimJob, renewClaim, releaseClaim, reclaimExpiredLocks };
 export { getKanbanBoard, getLaneJobs };
 export { reconcileDag };
@@ -46,6 +46,7 @@ export class WorkforceRuntime {
     advanceToWip(jobId, workerId) { advanceToWip(this.db, jobId, workerId); }
     advanceToReview(jobId, workerId) { advanceToReview(this.db, jobId, workerId); }
     recordTokens(jobId, workerId, tokens) { recordTokens(this.db, jobId, workerId, tokens); }
+    patchJobPayload(jobId, patch) { return patchJobPayload(this.db, jobId, patch); }
     completeJob(jobId, workerId) { return completeJob(this.db, jobId, workerId); }
     failJob(jobId, workerId) { return failJob(this.db, jobId, workerId); }
     blockJob(jobId, workerId) { return blockJob(this.db, jobId, workerId); }

package/dist/workforce/jobs.d.ts

@@ -7,6 +7,7 @@
 import type { WorkforceDb, Job, JobStatus, EnqueueJobInput } from './types.js';
 import type { Claim } from './types.js';
 export declare function enqueueJob(db: WorkforceDb, input: EnqueueJobInput): Job;
+export declare function patchJobPayload(db: WorkforceDb, jobId: string, patch: Record<string, unknown>): Job | null;
 export declare function getJob(db: WorkforceDb, id: string): Job | null;
 export declare function listJobs(db: WorkforceDb, status?: JobStatus, limit?: number, companyId?: string): Job[];
 export declare function claimNextReady(db: WorkforceDb, workerId: string, leaseMs?: number): Claim | null;

package/dist/workforce/jobs.js

@@ -55,6 +55,13 @@ export function enqueueJob(db, input) {
         reconcileDag(db);
     return getJob(db, id);
 }
+export function patchJobPayload(db, jobId, patch) {
+    const job = getJob(db, jobId);
+    if (!job)
+        return null;
+    db.prepare(`UPDATE workforce_jobs SET payload = ? WHERE id = ?`).run(JSON.stringify({ ...(job.payload ?? {}), ...patch }), jobId);
+    return getJob(db, jobId);
+}
 // ─── Read ─────────────────────────────────────────────────────────────────────
 export function getJob(db, id) {
     const row = db.prepare('SELECT * FROM workforce_jobs WHERE id = ?').get(id);

package/dist/workforce/kanban-view.js

@@ -3,6 +3,17 @@
  * Reads from vw_kanban SQL view; no business logic here.
  */
 const ALL_LANES = ['backlog', 'ready', 'claimed', 'wip', 'blocked', 'review', 'done', 'failed', 'cancelled'];
+function parsePayload(raw) {
+    if (!raw)
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
 export function getKanbanBoard(db, client) {
     const rows = client
         ? db.prepare(`SELECT * FROM vw_kanban WHERE client = ?`).all(client)
@@ -18,9 +29,11 @@ export function getKanbanBoard(db, client) {
             priority: r.priority,
             tokensUsed: r.tokens_used,
             budgetCapUsd: r.budget_cap_usd,
+            payload: parsePayload(r.payload),
             client: r.client,
             createdAt: r.created_at,
             claimedAt: r.claimed_at,
+            completedAt: r.completed_at,
         });
     }
     return {
@@ -38,8 +51,10 @@ export function getLaneJobs(db, lane) {
         priority: r.priority,
         tokensUsed: r.tokens_used,
         budgetCapUsd: r.budget_cap_usd,
+        payload: parsePayload(r.payload),
         client: r.client,
         createdAt: r.created_at,
         claimedAt: r.claimed_at,
+        completedAt: r.completed_at,
     }));
 }

package/dist/workforce/types.d.ts

@@ -78,9 +78,11 @@ export interface KanbanCard {
     priority: number;
     tokensUsed: number;
     budgetCapUsd: number | null;
+    payload: Record<string, unknown>;
     client: string;
     createdAt: number;
     claimedAt: number | null;
+    completedAt: number | null;
 }
 export interface KanbanBoard {
     lanes: Record<JobStatus, KanbanCard[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-prime",
-  "version": "7.9.29",
+  "version": "7.9.30",
   "description": "Local-first MCP control plane for coding agents with bootstrap-orchestrate execution, memory fabric, token budgeting, and worktree-backed swarms",
   "type": "module",
   "main": "dist/index.js",