@swarmclawai/swarmclaw 1.7.3 → 1.8.1

package/src/app/missions/page.tsx

@@ -1,8 +1,10 @@
 'use client'
 
 import { useCallback, useEffect, useMemo, useState } from 'react'
+import { useRouter, useSearchParams } from 'next/navigation'
 import { api } from '@/lib/app/api-client'
 import { MainContent } from '@/components/layout/main-content'
+import { EvidenceShelf } from '@/components/evidence/evidence-shelf'
 import { HintTip } from '@/components/shared/hint-tip'
 import { inputClass } from '@/components/shared/form-styles'
 import { MissionTemplateGallery } from '@/components/missions/mission-template-gallery'
@@ -11,10 +13,22 @@ import {
   type InstantiateInput,
 } from '@/components/missions/mission-template-install-dialog'
 import { MissionEditSheet, isMissionEditable } from '@/components/missions/mission-edit-sheet'
-import type { Mission, MissionReport, MissionEvent, MissionTemplate, Session } from '@/types'
+import type { EvidenceArtifact, Mission, MissionReport, MissionEvent, MissionTemplate, Session } from '@/types'
 import { toast } from 'sonner'
 
 const POLL_MS = 4_000
+const RELEASE_QA_TEMPLATE_ID = 'release-candidate-qa'
+
+interface ShareLink {
+  id: string
+  token: string
+  entityType: 'mission' | 'skill' | 'session'
+  entityId: string
+  label: string | null
+  createdAt: number
+  expiresAt: number | null
+  revokedAt: number | null
+}
 
 const STATUS_BADGE: Record<Mission['status'], { label: string; cls: string }> = {
   draft: { label: 'Draft', cls: 'bg-white/[0.05] text-text-3' },
@@ -398,7 +412,88 @@ interface DetailProps {
 
 function MissionDetail({ mission, reports, events, busy, onAction, onForceReport, onEdit }: DetailProps) {
   const [selectedReport, setSelectedReport] = useState<MissionReport | null>(null)
+  const [shareLinks, setShareLinks] = useState<ShareLink[]>([])
+  const [artifacts, setArtifacts] = useState<EvidenceArtifact[]>([])
+  const [artifactsLoading, setArtifactsLoading] = useState(false)
+  const [shareBusy, setShareBusy] = useState<string | null>(null)
   const wallclockCapMs = mission.budget.maxWallclockSec != null ? mission.budget.maxWallclockSec * 1000 : null
+  const activeShare = useMemo(
+    () => shareLinks.find((link) => !link.revokedAt && (!link.expiresAt || link.expiresAt > Date.now())) ?? null,
+    [shareLinks],
+  )
+
+  const loadShareLinks = useCallback(async () => {
+    try {
+      const links = await api<ShareLink[]>('GET', `/share?entityType=mission&entityId=${encodeURIComponent(mission.id)}`)
+      setShareLinks(Array.isArray(links) ? links : [])
+    } catch {
+      setShareLinks([])
+    }
+  }, [mission.id])
+
+  const loadArtifacts = useCallback(async () => {
+    setArtifactsLoading(true)
+    try {
+      const list = await api<EvidenceArtifact[]>('GET', `/artifacts?missionId=${encodeURIComponent(mission.id)}`)
+      setArtifacts(Array.isArray(list) ? list : [])
+    } catch {
+      setArtifacts([])
+    } finally {
+      setArtifactsLoading(false)
+    }
+  }, [mission.id])
+
+  useEffect(() => {
+    void loadShareLinks()
+    void loadArtifacts()
+  }, [loadArtifacts, loadShareLinks])
+
+  const shareUrl = activeShare && typeof window !== 'undefined'
+    ? `${window.location.origin}/s/${activeShare.token}`
+    : ''
+
+  const createShareLink = useCallback(async () => {
+    setShareBusy('create')
+    try {
+      const link = await api<ShareLink>('POST', '/share', {
+        entityType: 'mission',
+        entityId: mission.id,
+        label: `${mission.title} public report`,
+      })
+      setShareLinks((prev) => [link, ...prev])
+      void loadArtifacts()
+      toast.success('Mission share link created')
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : 'Unable to create share link')
+    } finally {
+      setShareBusy(null)
+    }
+  }, [loadArtifacts, mission.id, mission.title])
+
+  const revokeShareLink = useCallback(async () => {
+    if (!activeShare) return
+    setShareBusy(activeShare.id)
+    try {
+      const revoked = await api<ShareLink>('DELETE', `/share/${activeShare.id}`)
+      setShareLinks((prev) => prev.map((link) => (link.id === revoked.id ? revoked : link)))
+      void loadArtifacts()
+      toast.success('Mission share link revoked')
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : 'Unable to revoke share link')
+    } finally {
+      setShareBusy(null)
+    }
+  }, [activeShare, loadArtifacts])
+
+  const copyShareUrl = useCallback(async () => {
+    if (!shareUrl) return
+    try {
+      await navigator.clipboard.writeText(shareUrl)
+      toast.success('Share URL copied')
+    } catch {
+      toast.error('Unable to copy share URL')
+    }
+  }, [shareUrl])
 
   return (
     <div className="flex flex-col gap-4 p-4">
@@ -428,6 +523,60 @@ function MissionDetail({ mission, reports, events, busy, onAction, onForceReport
         <MissionControls mission={mission} onAction={onAction} onForceReport={onForceReport} onEdit={onEdit} busy={busy} />
       </div>
 
+      <div className="rounded-[12px] border border-white/[0.06] bg-white/[0.025] p-4">
+        <div className="flex flex-col gap-3 lg:flex-row lg:items-start lg:justify-between">
+          <div>
+            <div className="text-[11px] font-600 uppercase tracking-wide text-text-3">Public share</div>
+            <p className="mt-1 max-w-[620px] text-[12px] leading-relaxed text-text-3/70">
+              Publish a revocable mission artifact with status, budgets, milestones, and generated reports. Secrets, credentials, private files, and hidden runtime metadata stay out of the payload.
+            </p>
+          </div>
+          <div className="flex shrink-0 flex-wrap gap-2">
+            {activeShare ? (
+              <>
+                <button
+                  type="button"
+                  onClick={() => void copyShareUrl()}
+                  className="rounded-[9px] border border-emerald-500/25 bg-emerald-500/10 px-2.5 py-1.5 text-[11px] font-700 text-emerald-200 hover:bg-emerald-500/15"
+                >
+                  Copy link
+                </button>
+                <button
+                  type="button"
+                  disabled={!!shareBusy}
+                  onClick={() => void revokeShareLink()}
+                  className="rounded-[9px] border border-rose-500/20 bg-rose-500/[0.06] px-2.5 py-1.5 text-[11px] font-700 text-rose-200 hover:bg-rose-500/[0.1] disabled:opacity-40"
+                >
+                  {shareBusy === activeShare.id ? 'Revoking...' : 'Revoke'}
+                </button>
+              </>
+            ) : (
+              <button
+                type="button"
+                disabled={!!shareBusy}
+                onClick={() => void createShareLink()}
+                className="rounded-[9px] border border-emerald-500/30 bg-emerald-500/10 px-2.5 py-1.5 text-[11px] font-700 text-emerald-200 hover:bg-emerald-500/15 disabled:opacity-40"
+              >
+                {shareBusy === 'create' ? 'Creating...' : 'Create share link'}
+              </button>
+            )}
+          </div>
+        </div>
+        {activeShare && (
+          <div className="mt-3 rounded-[10px] border border-white/[0.06] bg-black/20 px-3 py-2 text-[11px] text-text-3">
+            <span className="font-mono text-text">{shareUrl}</span>
+            <span className="ml-2 text-text-3/55">Created {formatTimestamp(activeShare.createdAt)}</span>
+          </div>
+        )}
+      </div>
+
+      <EvidenceShelf
+        artifacts={artifacts}
+        loading={artifactsLoading}
+        title="Evidence Shelf"
+        emptyLabel="No mission reports, public share links, or milestone evidence yet."
+      />
+
       {mission.successCriteria.length > 0 && (
         <div>
           <div className="text-[11px] font-600 uppercase tracking-wide text-text-3 mb-2">Success criteria</div>
@@ -503,6 +652,8 @@ function MissionDetail({ mission, reports, events, busy, onAction, onForceReport
 }
 
 export default function MissionsPage() {
+  const router = useRouter()
+  const searchParams = useSearchParams()
   const [missions, setMissions] = useState<Mission[]>([])
   const [selectedId, setSelectedId] = useState<string | null>(null)
   const [reports, setReports] = useState<MissionReport[]>([])
@@ -570,6 +721,24 @@ export default function MissionsPage() {
     return () => { cancelled = true }
   }, [])
 
+  useEffect(() => {
+    const templateId = searchParams.get('template')?.trim()
+    if (!templateId || templates.length === 0) return
+    const template = templates.find((item) => item.id === templateId)
+    if (!template) return
+    setGalleryOpen(false)
+    setInstallTemplate(template)
+    router.replace('/missions', { scroll: false })
+  }, [router, searchParams, templates])
+
+  useEffect(() => {
+    const missionId = searchParams.get('mission')?.trim()
+    if (!missionId || missions.length === 0) return
+    if (!missions.some((mission) => mission.id === missionId)) return
+    setSelectedId(missionId)
+    router.replace('/missions', { scroll: false })
+  }, [missions, router, searchParams])
+
   const handleAction = useCallback(async (action: string, reason?: string) => {
     if (!selectedId) return
     setBusy(true)
@@ -633,10 +802,17 @@ export default function MissionsPage() {
                 <div className="text-[10px] text-text-3">Autonomous goal-driven runs</div>
               </div>
               <button
-                onClick={() => setCreateOpen(true)}
+                onClick={() => {
+                  const template = templates.find((item) => item.id === RELEASE_QA_TEMPLATE_ID)
+                  if (template) {
+                    setInstallTemplate(template)
+                    return
+                  }
+                  setCreateOpen(true)
+                }}
                 className="text-[11px] font-600 px-2.5 py-1 rounded border border-emerald-500/30 bg-emerald-500/10 text-emerald-300 hover:bg-emerald-500/15"
               >
-                + New
+                + Mission
               </button>
             </div>
             {templates.length > 0 && (
@@ -736,6 +912,9 @@ export default function MissionsPage() {
         sessions={sessions}
         onClose={() => setInstallTemplate(null)}
         onInstall={handleInstallTemplate}
+        onSessionCreated={(session) => {
+          setSessions((prev) => [session, ...prev.filter((item) => item.id !== session.id)])
+        }}
       />
 
       <MissionEditSheet

package/src/app/s/[token]/page.tsx

@@ -19,65 +19,190 @@ export default async function SharedEntityPage({
   if (!payload) notFound()
 
   return (
-    <div className="mx-auto max-w-3xl px-6 py-10 font-sans">
-      <header className="mb-8">
-        <div className="text-xs uppercase tracking-wider text-neutral-500">
-          Shared {payload.kind}
-        </div>
-        {link.label ? (
-          <h1 className="mt-1 text-2xl font-semibold">{link.label}</h1>
-        ) : null}
-      </header>
-      {renderBody(payload)}
-      <footer className="mt-10 border-t border-neutral-200 pt-4 text-xs text-neutral-500">
-        Public share link. Secrets and credentials are omitted.
-      </footer>
+    <main className="min-h-screen bg-[#080a0f] text-white">
+      <div className="mx-auto flex w-full max-w-5xl flex-col gap-8 px-5 py-8 sm:px-8 lg:px-10">
+        <header className="border-b border-white/10 pb-6">
+          <div className="text-[11px] font-700 uppercase tracking-[0.16em] text-emerald-300/80">
+            SwarmClaw shared {payload.kind}
+          </div>
+          <h1 className="mt-3 max-w-3xl font-display text-[28px] font-700 tracking-normal text-white">
+            {link.label || payloadTitle(payload)}
+          </h1>
+          <p className="mt-3 max-w-2xl text-[13px] leading-relaxed text-white/60">
+            Public, revocable share link. Runtime secrets, credentials, private files, and hidden control metadata are omitted.
+          </p>
+        </header>
+        {renderBody(payload)}
+        <footer className="border-t border-white/10 pt-4 text-[11px] text-white/45">
+          Generated by SwarmClaw. This page only contains the entity fields explicitly allowed by the share resolver.
+        </footer>
+      </div>
+    </main>
+  )
+}
+
+function payloadTitle(payload: SharedPayload): string {
+  if (payload.kind === 'mission') return payload.title
+  if (payload.kind === 'skill') return payload.name
+  return payload.name
+}
+
+function formatUsd(n: number): string {
+  return `$${n.toFixed(n < 0.01 ? 4 : 2)}`
+}
+
+function formatNumber(n: number): string {
+  return Math.round(n).toLocaleString()
+}
+
+function formatDuration(ms: number): string {
+  if (!ms) return '0s'
+  if (ms < 1000) return `${ms}ms`
+  const sec = Math.round(ms / 1000)
+  if (sec < 60) return `${sec}s`
+  const min = Math.round(sec / 60)
+  if (min < 60) return `${min}m`
+  if (min < 60 * 24) return `${Math.round((min / 60) * 10) / 10}h`
+  return `${Math.round((min / 1440) * 10) / 10}d`
+}
+
+function Stat({ label, value, hint }: { label: string; value: string; hint?: string }) {
+  return (
+    <div className="rounded-[12px] border border-white/10 bg-white/[0.035] px-4 py-3">
+      <div className="text-[10px] font-700 uppercase tracking-[0.12em] text-white/45">{label}</div>
+      <div className="mt-2 font-display text-[22px] font-700 tracking-normal text-white">{value}</div>
+      {hint ? <div className="mt-1 text-[11px] leading-relaxed text-white/45">{hint}</div> : null}
+    </div>
+  )
+}
+
+function ReportMarkdown({ content }: { content: string }) {
+  const lines = content.split('\n')
+
+  return (
+    <div className="text-[13px] leading-relaxed text-white/72">
+      {lines.map((line, index) => renderReportLine(line, index))}
     </div>
   )
 }
 
+function parseNumberedListItem(line: string): { marker: string; text: string } | null {
+  const dotIndex = line.indexOf('. ')
+  if (dotIndex <= 0 || dotIndex > 3) return null
+  for (let i = 0; i < dotIndex; i += 1) {
+    const code = line.charCodeAt(i)
+    if (code < 48 || code > 57) return null
+  }
+  return { marker: line.slice(0, dotIndex + 1), text: line.slice(dotIndex + 2) }
+}
+
+function renderReportLine(line: string, index: number) {
+  const trimmed = line.trim()
+  if (!trimmed) return <div key={index} className="h-2" />
+  if (trimmed === '---') return <hr key={index} className="my-4 border-white/10" />
+  if (trimmed.startsWith('### ')) {
+    return <h5 key={index} className="mb-2 mt-4 text-[13px] font-800 text-white">{trimmed.slice(4)}</h5>
+  }
+  if (trimmed.startsWith('## ')) {
+    return <h4 key={index} className="mb-2 mt-5 text-[13px] font-800 uppercase tracking-[0.1em] text-white/70">{trimmed.slice(3)}</h4>
+  }
+  if (trimmed.startsWith('# ')) {
+    return <h3 key={index} className="mb-3 mt-1 font-display text-[18px] font-700 text-white">{trimmed.slice(2)}</h3>
+  }
+  if (trimmed.startsWith('- ') || trimmed.startsWith('* ')) {
+    return (
+      <div key={index} className="my-1 flex gap-2">
+        <span className="text-white/40">•</span>
+        <span>{trimmed.slice(2)}</span>
+      </div>
+    )
+  }
+  const numbered = parseNumberedListItem(trimmed)
+  if (numbered) {
+    return (
+      <div key={index} className="my-1 flex gap-2">
+        <span className="min-w-5 text-white/40">{numbered.marker}</span>
+        <span>{numbered.text}</span>
+      </div>
+    )
+  }
+  return <p key={index} className="my-2">{trimmed}</p>
+}
+
 function renderBody(payload: SharedPayload) {
   if (payload.kind === 'mission') {
+    const statusTone =
+      payload.status === 'running'
+        ? 'border-emerald-400/25 bg-emerald-400/10 text-emerald-200'
+        : payload.status === 'failed' || payload.status === 'budget_exhausted'
+          ? 'border-rose-400/25 bg-rose-400/10 text-rose-200'
+          : 'border-white/10 bg-white/[0.04] text-white/70'
     return (
-      <section>
-        <h2 className="text-xl font-semibold">{payload.title}</h2>
-        <p className="mt-3 whitespace-pre-wrap text-neutral-800">{payload.goal}</p>
+      <section className="flex flex-col gap-6">
+        <div className="flex flex-col gap-4 lg:flex-row lg:items-start lg:justify-between">
+          <div className="max-w-3xl">
+            <div className={`inline-flex rounded-full border px-2.5 py-1 text-[11px] font-800 uppercase tracking-[0.1em] ${statusTone}`}>
+              {payload.status.replaceAll('_', ' ')}
+            </div>
+            <h2 className="mt-4 font-display text-[24px] font-700 tracking-normal text-white">{payload.title}</h2>
+            <p className="mt-3 whitespace-pre-wrap text-[14px] leading-relaxed text-white/68">{payload.goal}</p>
+          </div>
+          <div className="grid min-w-[280px] grid-cols-2 gap-2">
+            <Stat label="Turns" value={formatNumber(payload.usage.turnsRun)} hint={payload.budget.maxTurns != null ? `cap ${formatNumber(payload.budget.maxTurns)}` : 'no cap'} />
+            <Stat label="Spend" value={formatUsd(payload.usage.usdSpent)} hint={payload.budget.maxUsd != null ? `cap ${formatUsd(payload.budget.maxUsd)}` : 'no cap'} />
+            <Stat label="Tokens" value={formatNumber(payload.usage.tokensUsed)} hint={payload.budget.maxTokens != null ? `cap ${formatNumber(payload.budget.maxTokens)}` : 'no cap'} />
+            <Stat label="Wallclock" value={formatDuration(payload.usage.wallclockMsElapsed)} hint={payload.budget.maxWallclockSec != null ? `cap ${formatDuration(payload.budget.maxWallclockSec * 1000)}` : 'no cap'} />
+          </div>
+        </div>
         {payload.successCriteria.length > 0 ? (
-          <>
-            <h3 className="mt-6 font-semibold">Success criteria</h3>
-            <ul className="mt-2 list-disc pl-6 text-neutral-800">
+          <div className="rounded-[14px] border border-white/10 bg-white/[0.025] p-4">
+            <h3 className="text-[12px] font-800 uppercase tracking-[0.12em] text-white/55">Success criteria</h3>
+            <ul className="mt-3 grid gap-2 text-[13px] text-white/70 md:grid-cols-2">
               {payload.successCriteria.map((c, i) => (
-                <li key={i}>{c}</li>
+                <li key={i} className="rounded-[10px] border border-white/10 bg-white/[0.025] px-3 py-2">{c}</li>
               ))}
             </ul>
-          </>
+          </div>
+        ) : null}
+        {payload.latestReport ? (
+          <article className="rounded-[14px] border border-emerald-400/20 bg-emerald-400/[0.04] p-4">
+            <div className="text-[11px] font-800 uppercase tracking-[0.12em] text-emerald-200/80">Latest report</div>
+            <div className="mt-1 text-[15px] font-800 text-white">{payload.latestReport.title}</div>
+            <div className="mt-1 text-[11px] text-white/45">{formatTime(payload.latestReport.at)} - {payload.latestReport.format}</div>
+            <div className="mt-4 rounded-[12px] border border-white/10 bg-black/20 px-4 py-3">
+              <ReportMarkdown content={payload.latestReport.content} />
+            </div>
+          </article>
         ) : null}
         {payload.milestones.length > 0 ? (
-          <>
-            <h3 className="mt-6 font-semibold">Milestones</h3>
-            <ol className="mt-2 space-y-1 text-sm text-neutral-800">
+          <div className="rounded-[14px] border border-white/10 bg-white/[0.025] p-4">
+            <h3 className="text-[12px] font-800 uppercase tracking-[0.12em] text-white/55">Milestones</h3>
+            <ol className="mt-3 space-y-2">
               {payload.milestones.map((m, i) => (
-                <li key={i}>
-                  <span className="text-neutral-500">{formatTime(m.at)}:</span> {m.note}
+                <li key={i} className="flex gap-3 rounded-[10px] border border-white/10 bg-white/[0.02] px-3 py-2 text-[12px]">
+                  <span className="shrink-0 text-white/40">{formatTime(m.at)}</span>
+                  <span className="shrink-0 font-800 text-white/55">{m.kind}</span>
+                  <span className="text-white/75">{m.summary}</span>
                 </li>
               ))}
             </ol>
-          </>
+          </div>
         ) : null}
-        {payload.reports.length > 0 ? (
-          <>
-            <h3 className="mt-6 font-semibold">Reports</h3>
-            <div className="mt-3 space-y-4">
-              {payload.reports.map((r, i) => (
-                <article key={i} className="rounded border border-neutral-200 p-4">
-                  <div className="mb-2 text-xs text-neutral-500">
-                    {formatTime(r.at)} · {r.format}
+        {payload.reports.length > 1 ? (
+          <div className="rounded-[14px] border border-white/10 bg-white/[0.025] p-4">
+            <h3 className="text-[12px] font-800 uppercase tracking-[0.12em] text-white/55">Earlier reports</h3>
+            <div className="mt-3 grid gap-3">
+              {payload.reports.slice(1).map((r) => (
+                <article key={r.id} className="rounded-[12px] border border-white/10 bg-white/[0.02] p-4">
+                  <div className="text-[13px] font-800 text-white">{r.title}</div>
+                  <div className="mt-1 text-[11px] text-white/45">{formatTime(r.at)} - {r.format}</div>
+                  <div className="mt-3">
+                    <ReportMarkdown content={r.content} />
                   </div>
-                  <pre className="whitespace-pre-wrap text-sm text-neutral-800">{r.content}</pre>
                 </article>
               ))}
             </div>
-          </>
+          </div>
         ) : null}
       </section>
     )
@@ -85,19 +210,19 @@ function renderBody(payload: SharedPayload) {
 
   if (payload.kind === 'skill') {
     return (
-      <section>
-        <h2 className="text-xl font-semibold">{payload.name}</h2>
+      <section className="rounded-[14px] border border-white/10 bg-white/[0.025] p-5">
+        <h2 className="font-display text-[22px] font-700 text-white">{payload.name}</h2>
         {payload.tags.length > 0 ? (
           <div className="mt-2 flex flex-wrap gap-2">
             {payload.tags.map((t) => (
-              <span key={t} className="rounded bg-neutral-100 px-2 py-0.5 text-xs text-neutral-700">
+              <span key={t} className="rounded bg-white/10 px-2 py-0.5 text-xs text-white/70">
                 {t}
               </span>
             ))}
           </div>
         ) : null}
-        <p className="mt-4 text-neutral-800">{payload.description}</p>
-        <pre className="mt-6 whitespace-pre-wrap rounded border border-neutral-200 bg-neutral-50 p-4 text-sm text-neutral-800">
+        <p className="mt-4 text-[13px] leading-relaxed text-white/65">{payload.description}</p>
+        <pre className="mt-6 whitespace-pre-wrap rounded-[12px] border border-white/10 bg-black/20 p-4 text-sm text-white/70">
           {payload.content}
         </pre>
       </section>
@@ -105,22 +230,22 @@ function renderBody(payload: SharedPayload) {
   }
 
   return (
-    <section>
-      <h2 className="text-xl font-semibold">{payload.name}</h2>
+    <section className="rounded-[14px] border border-white/10 bg-white/[0.025] p-5">
+      <h2 className="font-display text-[22px] font-700 text-white">{payload.name}</h2>
       {payload.agentName ? (
-        <div className="mt-1 text-sm text-neutral-500">Agent: {payload.agentName}</div>
+        <div className="mt-1 text-sm text-white/50">Agent: {payload.agentName}</div>
       ) : null}
       <div className="mt-6 space-y-4">
         {payload.messages.map((m, i) => (
           <article
             key={i}
-            className="rounded border border-neutral-200 p-4"
+            className="rounded-[12px] border border-white/10 bg-white/[0.02] p-4"
           >
-            <div className="mb-1 flex items-center justify-between text-xs text-neutral-500">
+            <div className="mb-1 flex items-center justify-between text-xs text-white/45">
               <span className="uppercase">{m.role}</span>
               {m.at ? <span>{formatTime(m.at)}</span> : null}
             </div>
-            <pre className="whitespace-pre-wrap text-sm text-neutral-800">{m.text}</pre>
+            <pre className="whitespace-pre-wrap text-sm text-white/70">{m.text}</pre>
           </article>
         ))}
       </div>

package/src/cli/index.js

@@ -67,6 +67,13 @@ const COMMAND_GROUPS = [
       cmd('resolve', 'POST', '/approvals', 'Resolve a human-loop approval', { expectsJsonBody: true }),
     ],
   },
+  {
+    name: 'artifacts',
+    description: 'Resolve evidence artifacts for runs, missions, and tasks',
+    commands: [
+      cmd('list', 'GET', '/artifacts', 'List evidence artifacts (use --query runId=, --query missionId=, or --query taskId=)'),
+    ],
+  },
   {
     name: 'claude-skills',
     description: 'Read local Claude skills directory metadata',
@@ -198,6 +205,13 @@ const COMMAND_GROUPS = [
       }),
     ],
   },
+  {
+    name: 'operations',
+    description: 'Operator triage and readiness summaries',
+    commands: [
+      cmd('pulse', 'GET', '/operations/pulse', 'Get Operations Pulse summary (use --query range=24h or --query range=7d)'),
+    ],
+  },
   {
     name: 'documents',
     description: 'Manage documents',
@@ -544,6 +558,7 @@ const COMMAND_GROUPS = [
       cmd('list', 'GET', '/runs', 'List runs (use --query sessionId=, --query status=, --query limit=)'),
       cmd('get', 'GET', '/runs/:id', 'Get run by id'),
       cmd('events', 'GET', '/runs/:id/events', 'Get run event history by run id'),
+      cmd('brief', 'GET', '/runs/:id/brief', 'Get deterministic run brief by run id'),
     ],
   },
   {

package/src/cli/spec.js

@@ -184,6 +184,12 @@ const COMMAND_GROUPS = {
       'task-status': { description: 'Check A2A task status', method: 'GET', path: '/a2a/tasks/:taskId/status', params: ['taskId'] },
     },
   },
+  artifacts: {
+    description: 'Resolve evidence artifacts for runs, missions, and tasks',
+    commands: {
+      list: { description: 'List evidence artifacts (supports --query runId=,missionId=,taskId=)', method: 'GET', path: '/artifacts' },
+    },
+  },
   uploads: {
     description: 'Manage uploaded artifacts',
     commands: {
@@ -193,6 +199,12 @@ const COMMAND_GROUPS = {
       'delete-many': { description: 'Delete uploads by filter/body (filenames, olderThanDays, category, or all)', method: 'DELETE', path: '/uploads' },
     },
   },
+  operations: {
+    description: 'Operator triage and readiness summaries',
+    commands: {
+      pulse: { description: 'Get Operations Pulse summary (supports --query range=24h|7d)', method: 'GET', path: '/operations/pulse' },
+    },
+  },
   files: {
     description: 'Serve/open local files',
     commands: {
@@ -526,6 +538,7 @@ const COMMAND_GROUPS = {
       list: { description: 'List runs (supports --query sessionId=,status=,limit=)', method: 'GET', path: '/runs' },
       get: { description: 'Get run by id', method: 'GET', path: '/runs/:id', params: ['id'] },
       events: { description: 'Get run event history by run id', method: 'GET', path: '/runs/:id/events', params: ['id'] },
+      brief: { description: 'Get deterministic run brief by run id', method: 'GET', path: '/runs/:id/brief', params: ['id'] },
     },
   },
   webhooks: {