helixevo 0.5.0 → 0.6.1

package/dashboard/app/ontology/client.tsx

@@ -6,6 +6,9 @@ import { ConsolePanel } from '@/components/console-panel'
 import { MetricCard } from '@/components/metric-card'
 import { PageHero } from '@/components/page-hero'
 import { SectionFrame } from '@/components/section-frame'
+import { OperatorLoopTrail } from '@/components/operator-loop-trail'
+import { SurfaceJumpLinks } from '@/components/surface-jump-links'
+import { NextStepEmptyState } from '@/components/next-step-empty-state'
 import type { OntologyControlDashboardSummary, OntologyReviewDecisionStatus } from '@/lib/data'
 
 type RunState = 'idle' | 'running' | 'success' | 'error'
@@ -68,43 +71,49 @@ export default function OntologyClient({ initialDashboard }: { initialDashboard:
   return (
     <div style={{ display: 'grid', gap: 22 }}>
       <PageHero
-        eyebrow="Semantic plasticity"
-        title="Ontology Frontier Control"
-        description="Inspect the stable kernel, review frontier concept hypotheses derived from recurring evidence, promote durable concepts into approved extensions, and keep semantic plasticity governed rather than free-form."
+        eyebrow="Semantic control"
+        title="Ontology Semantic Control"
+        description="Inspect the stable kernel, review frontier concept hypotheses, promote approved extensions, track active semantic consumers, and keep ontology adoption governed rather than free-form."
         chips={[
           { label: `${dashboard.summary.frontier} frontier`, tone: dashboard.summary.frontier > 0 ? 'yellow' : 'neutral' },
           { label: `${dashboard.summary.reviewOpen} open review`, tone: dashboard.summary.reviewOpen > 0 ? 'yellow' : 'green' },
           { label: `${dashboard.summary.extensions} approved extensions`, tone: dashboard.summary.extensions > 0 ? 'blue' : 'neutral' },
-          { label: `${dashboard.summary.changeEvents} change events`, tone: dashboard.summary.changeEvents > 0 ? 'purple' : 'neutral' },
+          { label: `${dashboard.adoption.activeConcepts} active concepts`, tone: dashboard.adoption.activeConcepts > 0 ? 'green' : 'neutral' },
+          { label: `${dashboard.adoption.routesInfluenced} semantically influenced routes`, tone: dashboard.adoption.routesInfluenced > 0 ? 'purple' : 'neutral' },
           { label: formatMode(dashboard.governance.activeMode), tone: dashboard.governance.activeMode === 'transfer-focused' ? 'purple' : dashboard.governance.activeMode === 'project-critical' ? 'yellow' : 'blue' },
         ]}
         actions={
           <div style={{ display: 'grid', gap: 12 }}>
             <div className="hero-note-card">
               <div className="hero-note-label">Native ontology state</div>
-              <div className="hero-note-title">Kernel + frontier + extensions</div>
-              <div className="hero-note-copy">Milestone 8 keeps the semantic kernel stable while letting new concepts emerge into a reviewable frontier before promotion.</div>
+              <div className="hero-note-title">Kernel + review + semantic adoption</div>
+              <div className="hero-note-copy">Use this surface to move from frontier hypotheses into approved extensions, inspect active semantic consumers, and manage deprecation with operator-visible risk rather than hidden drift.</div>
             </div>
-            <div style={{ display: 'flex', gap: 10, flexWrap: 'wrap', justifyContent: 'flex-end' }}>
-              <button onClick={() => runAction('refresh', {}, 'ontology refresh')} disabled={runState === 'running'} className="badge badge-blue" style={{ border: 'none', cursor: 'pointer' }}>Refresh ontology frontier</button>
-              <Link href="/coevolution" className="badge badge-gray">Open co-evolution</Link>
-              <Link href="/topology" className="badge badge-gray">Open topology</Link>
+            <div style={{ display: 'grid', gap: 10 }}>
+              <div style={{ display: 'flex', gap: 10, flexWrap: 'wrap', justifyContent: 'flex-end' }}>
+                <button onClick={() => runAction('refresh', {}, 'ontology refresh')} disabled={runState === 'running'} className="badge badge-blue" style={{ border: 'none', cursor: 'pointer' }}>Refresh ontology frontier</button>
+              </div>
+              <SurfaceJumpLinks surface="ontology" variant="compact" title="Semantic handoffs" />
             </div>
           </div>
         }
       />
 
+      <OperatorLoopTrail surface="ontology" />
+
       <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(180px, 1fr))', gap: 16 }}>
         <MetricCard label="Kernel concepts" value={dashboard.summary.kernelConcepts} sublabel={`${dashboard.kernel.relationFamilies.length} relation families`} tone="purple" icon="◎" />
         <MetricCard label="Frontier hypotheses" value={dashboard.summary.frontier} sublabel={`${dashboard.summary.reviewOpen} open • ${dashboard.summary.deferred} deferred`} tone={dashboard.summary.reviewOpen > 0 ? 'yellow' : 'neutral'} icon="◇" />
-        <MetricCard label="Approved extensions" value={dashboard.summary.extensions} sublabel={`${dashboard.summary.deprecated} deprecated`} tone={dashboard.summary.extensions > 0 ? 'blue' : 'neutral'} icon="↑" />
+        <MetricCard label="Approved extensions" value={dashboard.summary.extensions} sublabel={`${dashboard.summary.deprecated} deprecated • ${dashboard.adoption.unusedExtensions} unused`} tone={dashboard.summary.extensions > 0 ? 'blue' : 'neutral'} icon="↑" />
+        <MetricCard label="Active semantic concepts" value={dashboard.adoption.activeConcepts} sublabel={`${dashboard.adoption.totalBindings} bindings • ${dashboard.adoption.routesInfluenced} routed influences`} tone={dashboard.adoption.activeConcepts > 0 ? 'green' : 'neutral'} icon="⇄" />
+        <MetricCard label="Deprecation-sensitive" value={dashboard.adoption.conceptsAtDeprecationRisk} sublabel="approved concepts with live consumers" tone={dashboard.adoption.conceptsAtDeprecationRisk > 0 ? 'yellow' : 'neutral'} icon="!" />
         <MetricCard label="Concept changes" value={dashboard.summary.changeEvents} sublabel={`${dashboard.summary.promoted} promoted • ${dashboard.summary.rejected} rejected`} tone={dashboard.summary.changeEvents > 0 ? 'green' : 'neutral'} icon="⇄" />
       </div>
 
       <SectionFrame
         eyebrow="Kernel"
         title="Stable semantic anchor"
-        description="The kernel remains the constitutional layer. Milestone 8 does not mutate it directly; it materializes and exposes it while adding governed extension growth around it."
+        description="The kernel remains the constitutional layer. HelixEvo still keeps it stable while governed frontier review, approved extensions, and semantic adoption grow around it."
       >
         <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap' }}>
           <span className="badge badge-gray">version {dashboard.kernel.version}</span>
@@ -124,6 +133,45 @@ export default function OntologyClient({ initialDashboard }: { initialDashboard:
         </div>
       </SectionFrame>
 
+      <SectionFrame
+        eyebrow="Adoption"
+        title="Semantic consumer coverage"
+        description="Approved concepts now become visible as live semantic consumers across pressure, route rationale, transfer, and topology interpretation rather than remaining passive approved vocabulary."
+      >
+        <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(220px, 1fr))', gap: 16 }}>
+          <div className="guide-dimension-card" style={{ borderLeftColor: 'var(--green)' }}>
+            <div style={{ fontSize: 12, fontWeight: 700, color: 'var(--green)' }}>Top active concepts</div>
+            <div style={{ display: 'grid', gap: 8, marginTop: 10 }}>
+              {dashboard.adoption.topActiveConcepts.length > 0 ? dashboard.adoption.topActiveConcepts.map((concept) => (
+                <div key={concept.conceptId} style={{ fontSize: 12, color: 'var(--text-dim)', lineHeight: 1.6 }}>
+                  <strong style={{ color: 'var(--text)' }}>{concept.conceptName}</strong>
+                  <div>{concept.totalBindings} bindings • {Object.entries(concept.bindingsByTargetType).map(([target, count]) => `${target}:${count}`).join(' • ')}</div>
+                </div>
+              )) : <div style={{ fontSize: 12, color: 'var(--text-dim)' }}>No active semantic consumers yet.</div>}
+            </div>
+          </div>
+          <div className="guide-dimension-card" style={{ borderLeftColor: 'var(--yellow)' }}>
+            <div style={{ fontSize: 12, fontWeight: 700, color: 'var(--yellow)' }}>Deprecation risk</div>
+            <div style={{ display: 'grid', gap: 8, marginTop: 10 }}>
+              {dashboard.adoption.atRiskConcepts.length > 0 ? dashboard.adoption.atRiskConcepts.map((concept) => (
+                <div key={concept.conceptId} style={{ fontSize: 12, color: 'var(--text-dim)', lineHeight: 1.6 }}>
+                  <strong style={{ color: 'var(--text)' }}>{concept.conceptName}</strong>
+                  <div>{concept.warning}</div>
+                </div>
+              )) : <div style={{ fontSize: 12, color: 'var(--text-dim)' }}>No deprecation-sensitive concepts right now.</div>}
+            </div>
+          </div>
+        </div>
+        <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap', marginTop: 16 }}>
+          <span className="badge badge-gray">bindings → signals {dashboard.adoption.bindingsByTargetType['pressure-signal'] ?? 0}</span>
+          <span className="badge badge-gray">motifs {dashboard.adoption.bindingsByTargetType['pressure-motif'] ?? 0}</span>
+          <span className="badge badge-gray">routes {dashboard.adoption.bindingsByTargetType['route-recommendation'] ?? 0}</span>
+          <span className="badge badge-gray">transfers {dashboard.adoption.bindingsByTargetType['transfer-event'] ?? 0}</span>
+          <span className="badge badge-gray">topology {dashboard.adoption.bindingsByTargetType['topology-review'] ?? 0}</span>
+          <span className="badge badge-gray">unused extensions {dashboard.adoption.unusedExtensions}</span>
+        </div>
+      </SectionFrame>
+
       <SectionFrame
         eyebrow="Frontier"
         title="Reviewable concept hypotheses"
@@ -156,10 +204,13 @@ export default function OntologyClient({ initialDashboard }: { initialDashboard:
               </div>
             </div>
           )) : (
-            <div className="empty-state" style={{ padding: 24 }}>
-              <div className="empty-state-title">No ontology frontier concepts yet</div>
-              <div className="empty-state-desc">Run “Refresh ontology frontier” after pressure motifs, project gaps, or topology review patterns accumulate.</div>
-            </div>
+            <NextStepEmptyState
+              title="No ontology frontier concepts yet"
+              description="Run a frontier refresh after pressure motifs, project gaps, or topology review patterns accumulate. Frontier creation is the first step before any concept can become active semantic control."
+              command="helixevo ontology --refresh"
+              pageLink={{ label: 'Open Co-Evolution', href: '/coevolution', tone: 'purple' }}
+              guideLink={{ label: 'Guide · Semantic Control', anchor: 'semanticcontrol', tone: 'green' }}
+            />
           )}
         </div>
       </SectionFrame>
@@ -167,7 +218,7 @@ export default function OntologyClient({ initialDashboard }: { initialDashboard:
       <SectionFrame
         eyebrow="Extensions"
         title="Approved ontology extensions"
-        description="Promoted concepts live here as approved semantic vocabulary. Deprecation is bounded and explicit — there is no hidden semantic drift."
+        description="Promoted concepts live here as approved semantic vocabulary. Once active, they can shape pressure, route rationale, transfer interpretation, and topology review while deprecation remains bounded and explicit."
       >
         <div style={{ display: 'grid', gap: 12 }}>
           {dashboard.extensions.length > 0 ? dashboard.extensions.map((concept) => (
@@ -180,22 +231,31 @@ export default function OntologyClient({ initialDashboard }: { initialDashboard:
                 <div style={{ display: 'flex', gap: 6, flexWrap: 'wrap' }}>
                   <span className={`badge badge-${toneForConcept(concept.conceptKind)}`}>{concept.conceptKind}</span>
                   <span className="badge badge-gray">{concept.status}</span>
+                  <span className="badge badge-gray">{concept.adoptionCount} bindings</span>
                   <span className="badge badge-gray">{(concept.evidenceIds?.length ?? 0)} evidence ids</span>
+                  {concept.warning ? <span className="badge badge-yellow">deprecation risk</span> : null}
                 </div>
               </div>
               <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap', marginTop: 12 }}>
                 <span className="badge badge-gray">{(concept.projectIds?.length ?? 0)} projects</span>
+                <span className="badge badge-gray">signals {concept.bindingsByTargetType['pressure-signal'] ?? 0}</span>
+                <span className="badge badge-gray">routes {concept.bindingsByTargetType['route-recommendation'] ?? 0}</span>
+                <span className="badge badge-gray">transfers {concept.bindingsByTargetType['transfer-event'] ?? 0}</span>
                 <span className="badge badge-gray">created {formatDate(concept.createdAt)}</span>
                 {concept.status !== 'deprecated' ? (
                   <button onClick={() => runAction('deprecate', { conceptId: concept.id, rationale: `Deprecate ontology extension ${concept.name} after operator review.` }, `deprecate ${concept.name}`)} disabled={pendingKey === concept.id} className="badge badge-gray" style={{ border: 'none', cursor: 'pointer' }}>Deprecate</button>
                 ) : null}
               </div>
+              {concept.warning ? <div className="signal-text" style={{ marginTop: 10 }}>• {concept.warning}</div> : null}
             </div>
           )) : (
-            <div className="empty-state" style={{ padding: 24 }}>
-              <div className="empty-state-title">No approved extensions yet</div>
-              <div className="empty-state-desc">Promoted frontier concepts will appear here once they pass semantic review.</div>
-            </div>
+            <NextStepEmptyState
+              title="No approved extensions yet"
+              description="Approved extensions appear after frontier concepts pass semantic review. Promotion is what turns reviewed ontology into live semantic adoption."
+              command="helixevo ontology --review <conceptId> --decision promote"
+              pageLink={{ label: 'Open Co-Evolution', href: '/coevolution', tone: 'purple' }}
+              guideLink={{ label: 'Guide · Semantic Control', anchor: 'semanticcontrol', tone: 'green' }}
+            />
           )}
         </div>
       </SectionFrame>
@@ -219,10 +279,13 @@ export default function OntologyClient({ initialDashboard }: { initialDashboard:
               </div>
             </div>
           )) : (
-            <div className="empty-state" style={{ padding: 24 }}>
-              <div className="empty-state-title">No ontology changes logged yet</div>
-              <div className="empty-state-desc">Refresh the frontier or review a concept to create the first native ontology events.</div>
-            </div>
+            <NextStepEmptyState
+              title="No ontology changes logged yet"
+              description="Refresh the frontier or review a concept to create the first native ontology events and start a visible semantic history instead of hidden drift."
+              command="helixevo ontology --refresh"
+              pageLink={{ label: 'Open Topology', href: '/topology', tone: 'yellow' }}
+              guideLink={{ label: 'Guide · Semantic Control', anchor: 'semanticcontrol', tone: 'green' }}
+            />
           )}
         </div>
       </SectionFrame>

package/dashboard/app/page.tsx

@@ -4,6 +4,9 @@ import { OverviewActions } from '@/components/overview-actions'
 import { PageHero } from '@/components/page-hero'
 import { MetricCard } from '@/components/metric-card'
 import { SectionFrame } from '@/components/section-frame'
+import { OperatorLoopTrail } from '@/components/operator-loop-trail'
+import { SurfaceJumpLinks } from '@/components/surface-jump-links'
+import { CURRENT_RELEASE_SPOTLIGHT } from '@/lib/release-spotlight'
 
 export const dynamic = 'force-dynamic'
 
@@ -57,6 +60,8 @@ export default function Overview() {
         }
       />
 
+      <OperatorLoopTrail surface="overview" />
+
       <div className="grid-5">
         <MetricCard label="Total skills" value={summary.skills.total} sublabel={`${summary.skills.evolved} evolved • ${summary.skillTests} skill tests`} tone="purple" href="/network" icon="◆" />
         <MetricCard label="Accepted proposals" value={summary.evolution.accepted} sublabel={`${summary.evolution.rejected} rejected`} tone="green" href="/evolution" icon="✓" />
@@ -65,6 +70,29 @@ export default function Overview() {
         <MetricCard label="Frontier candidates" value={frontier.programs.length} sublabel={`${summary.canaries} active canaries`} tone="neutral" href="/frontier" icon="▲" />
       </div>
 
+      <SectionFrame
+        eyebrow={`Release spotlight · v${CURRENT_RELEASE_SPOTLIGHT.version}`}
+        title={CURRENT_RELEASE_SPOTLIGHT.title}
+        description={CURRENT_RELEASE_SPOTLIGHT.summary}
+        tone="blue"
+      >
+        <div className="grid-2" style={{ gap: 16 }}>
+          <div style={{ display: 'grid', gap: 10 }}>
+            {CURRENT_RELEASE_SPOTLIGHT.bullets.map((item) => (
+              <div key={item} className="signal-text">• {item}</div>
+            ))}
+            <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap', marginTop: 4 }}>
+              {CURRENT_RELEASE_SPOTLIGHT.nextActions.map((action) => (
+                <Link key={action.href} href={action.href} className={`hero-chip hero-chip-${action.tone}`} style={{ textDecoration: 'none' }}>
+                  {action.label}
+                </Link>
+              ))}
+            </div>
+          </div>
+          <SurfaceJumpLinks surface="overview" variant="panel" title="Jump into the updated loop" />
+        </div>
+      </SectionFrame>
+
       <SectionFrame
         eyebrow="Execution layer"
         title="Quick actions"
@@ -151,6 +179,14 @@ export default function Overview() {
             href="/ontology"
             icon="◎"
           />
+          <MetricCard
+            label="Active semantic concepts"
+            value={ontology.ontologyLoop.adoption.activeConcepts}
+            sublabel={`${ontology.ontologyLoop.adoption.totalBindings} bindings • ${ontology.ontologyLoop.adoption.routesInfluenced} influenced routes`}
+            tone={ontology.ontologyLoop.adoption.activeConcepts > 0 ? 'green' : 'neutral'}
+            href="/ontology"
+            icon="⇄"
+          />
           <MetricCard
             label="Observed mutation verbs"
             value={ontology.mutationOperationsObserved}
@@ -175,6 +211,8 @@ export default function Overview() {
           <span className="badge badge-gray">{ontology.pressureMotifs.promotionReady} motifs currently recommend generalize</span>
           <span className="badge badge-gray">{ontology.transferEvents.total} transfer events logged ({ontology.transferEvents.realized} realized)</span>
           <span className="badge badge-gray">ontology → {ontology.ontologyLoop.frontier} frontier • {ontology.ontologyLoop.extensions} extensions • {ontology.ontologyLoop.changeEvents} changes</span>
+          <span className="badge badge-gray">semantic adoption → {ontology.ontologyLoop.adoption.activeConcepts} active concepts • {ontology.ontologyLoop.adoption.totalBindings} bindings • {ontology.ontologyLoop.adoption.routesInfluenced} influenced routes</span>
+          <span className="badge badge-gray">deprecation risk → {ontology.ontologyLoop.adoption.conceptsAtDeprecationRisk} concepts • {ontology.ontologyLoop.adoption.unusedExtensions} unused extensions</span>
           <span className="badge badge-gray">topology → {ontology.topologyReviews.open} open • {ontology.topologyReviews.accepted} accepted • {ontology.topologyReviews.generatedFromManualReview} manual-route</span>
           <span className="badge badge-gray">execution → {ontology.topologyExecution.prepared} prepared • {ontology.topologyExecution.applied} applied • {ontology.topologyExecution.rolledBack} rolled back</span>
           <Link href="/ontology" className="badge badge-blue" style={{ textDecoration: 'none' }}>Open ontology control</Link>

package/dashboard/app/projects/client.tsx

@@ -6,6 +6,9 @@ import { ConsolePanel } from '@/components/console-panel'
 import { MetricCard } from '@/components/metric-card'
 import { PageHero } from '@/components/page-hero'
 import { SectionFrame } from '@/components/section-frame'
+import { OperatorLoopTrail } from '@/components/operator-loop-trail'
+import { SurfaceJumpLinks } from '@/components/surface-jump-links'
+import { NextStepEmptyState } from '@/components/next-step-empty-state'
 import type { ProjectProfile } from '@/lib/data'
 
 type SetupState = 'idle' | 'analyzing' | 'done' | 'error' | 'cancelled'
@@ -364,18 +367,13 @@ export default function ProjectsClient({ profiles, skillCount, projectAnalysisTr
               <div className="hero-note-title">Analyze → Match → Gap scan → Action</div>
               <div className="hero-note-copy">Run a profile, review the skill fit, then send uncovered needs into Research or the Skill Network.</div>
             </div>
-            <div style={{ display: 'flex', gap: 10, flexWrap: 'wrap', justifyContent: 'flex-end' }}>
-              <Link href="/network" style={buttonStyle('purple')}>
-                Open Skill Network
-              </Link>
-              <Link href="/research" style={buttonStyle('blue')}>
-                Open Research
-              </Link>
-            </div>
+            <SurfaceJumpLinks surface="projects" variant="compact" title="Observation handoffs" />
           </div>
         }
       />
 
+      <OperatorLoopTrail surface="projects" />
+
       <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(180px, 1fr))', gap: 16, marginBottom: 24 }}>
         <MetricCard
           label="Portfolio"
@@ -764,17 +762,13 @@ export default function ProjectsClient({ profiles, skillCount, projectAnalysisTr
         tone="yellow"
       >
         {profiles.length === 0 ? (
-          <div className="empty-state">
-            <div className="empty-state-icon">
-              <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.5">
-                <path d="M3 7v10a2 2 0 002 2h14a2 2 0 002-2V9a2 2 0 00-2-2h-6l-2-2H5a2 2 0 00-2 2z" />
-              </svg>
-            </div>
-            <div className="empty-state-title">No analyzed projects yet</div>
-            <div className="empty-state-desc">
-              Start with a local folder or GitHub repository. The resulting profile will show matched skills, uncovered gaps, and recommended next steps.
-            </div>
-          </div>
+          <NextStepEmptyState
+            title="No analyzed projects yet"
+            description={`Start with a local folder or GitHub repository. The resulting profile will show matched skills, uncovered gaps, activation traces, and the next routed action against your ${skillCount} current skills.`}
+            command="helixevo project-setup <path>"
+            pageLink={{ label: 'Open Research', href: '/research', tone: 'blue' }}
+            guideLink={{ label: 'Guide · Quick Start', anchor: 'quickstart', tone: 'purple' }}
+          />
         ) : (
           <div style={{ display: 'grid', gap: 18 }}>
             {profiles.map(profile => {

package/dashboard/app/research/client.tsx

@@ -5,6 +5,9 @@ import { ConsolePanel } from '@/components/console-panel'
 import { MetricCard } from '@/components/metric-card'
 import { PageHero } from '@/components/page-hero'
 import { SectionFrame } from '@/components/section-frame'
+import { OperatorLoopTrail } from '@/components/operator-loop-trail'
+import { SurfaceJumpLinks } from '@/components/surface-jump-links'
+import { NextStepEmptyState } from '@/components/next-step-empty-state'
 
 interface Discovery {
   id: string
@@ -190,8 +193,20 @@ export default function ResearchClient({ buffer, projects, coevolution }: Props)
           { label: `${buffer.drafts.length} drafts`, tone: 'yellow' },
           { label: `${nearPass.length} near-pass drafts`, tone: 'green' },
         ]}
+        actions={
+          <div style={{ display: 'grid', gap: 12 }}>
+            <div className="hero-note-card">
+              <div className="hero-note-label">Discovery handoff</div>
+              <div className="hero-note-title">Observe gaps → research patterns → draft reusable skills</div>
+              <div className="hero-note-copy">Use Research when recurring project demand needs external evidence before it can become a stronger response or semantic pattern.</div>
+            </div>
+            <SurfaceJumpLinks surface="research" variant="compact" title="Discovery handoffs" />
+          </div>
+        }
       />
 
+      <OperatorLoopTrail surface="research" />
+
       <SectionFrame
         eyebrow="Why research now"
         title="Current pressure handoff"
@@ -371,10 +386,13 @@ export default function ResearchClient({ buffer, projects, coevolution }: Props)
           tone="blue"
         >
           {buffer.discoveries.length === 0 ? (
-            <div className="empty-state" style={{ padding: 24 }}>
-              <div className="empty-state-title">No discoveries yet</div>
-              <div className="empty-state-desc">Run research to search the web for techniques your skill network does not cover yet.</div>
-            </div>
+            <NextStepEmptyState
+              title="No discoveries yet"
+              description="Run research to search the web for techniques your skill network does not cover yet, then compare those discoveries against the current routed pressure picture."
+              command="helixevo research"
+              pageLink={{ label: 'Open Co-Evolution', href: '/coevolution', tone: 'green' }}
+              guideLink={{ label: 'Guide · Adaptation Loop', anchor: 'loop', tone: 'purple' }}
+            />
           ) : (
             <div className="summary-list">
               {buffer.discoveries.sort((a, b) => b.score - a.score).map((discovery) => (
@@ -400,10 +418,13 @@ export default function ResearchClient({ buffer, projects, coevolution }: Props)
           tone="yellow"
         >
           {buffer.drafts.length === 0 ? (
-            <div className="empty-state" style={{ padding: 24 }}>
-              <div className="empty-state-title">No drafts yet</div>
-              <div className="empty-state-desc">Run research to generate the first draft skills and evaluate them against the current thresholds.</div>
-            </div>
+            <NextStepEmptyState
+              title="No drafts yet"
+              description="Once research has enough evidence, it will generate the first draft skills and evaluate them against the current thresholds before they enter the wider loop."
+              command="helixevo research --verbose"
+              pageLink={{ label: 'Open Projects', href: '/projects', tone: 'blue' }}
+              guideLink={{ label: 'Guide · Quick Start', anchor: 'quickstart', tone: 'purple' }}
+            />
           ) : (
             <div className="summary-list">
               {buffer.drafts.sort((a, b) => b.avgScore - a.avgScore).map((draft) => (

package/dashboard/app/topology/client.tsx

@@ -6,6 +6,9 @@ import { ConsolePanel } from '@/components/console-panel'
 import { MetricCard } from '@/components/metric-card'
 import { PageHero } from '@/components/page-hero'
 import { SectionFrame } from '@/components/section-frame'
+import { OperatorLoopTrail } from '@/components/operator-loop-trail'
+import { SurfaceJumpLinks } from '@/components/surface-jump-links'
+import { NextStepEmptyState } from '@/components/next-step-empty-state'
 import type { GovernanceModeName, GovernanceState, TopologyDashboardSummary, TopologyReviewDecisionStatus, TopologyReviewStatus } from '@/lib/data'
 
 type RunState = 'idle' | 'running' | 'success' | 'error' | 'stopped'
@@ -251,16 +254,18 @@ export default function TopologyClient({
               <div className="hero-note-title">{formatMode(dashboard.governance.activeMode)}</div>
               <div className="hero-note-copy">{dashboard.governance.profile.explanation}</div>
             </div>
-            <div style={{ display: 'flex', gap: 10, flexWrap: 'wrap', justifyContent: 'flex-end' }}>
-              <button onClick={handleOptimize} disabled={runState === 'running'} className="badge badge-blue" style={{ border: 'none', cursor: 'pointer' }}>Run graph optimize</button>
-              <Link href="/ontology" className="badge badge-gray">Open ontology</Link>
-              <Link href="/coevolution" className="badge badge-gray">Open co-evolution</Link>
-              <Link href="/network" className="badge badge-gray">Open network</Link>
+            <div style={{ display: 'grid', gap: 10 }}>
+              <div style={{ display: 'flex', gap: 10, flexWrap: 'wrap', justifyContent: 'flex-end' }}>
+                <button onClick={handleOptimize} disabled={runState === 'running'} className="badge badge-blue" style={{ border: 'none', cursor: 'pointer' }}>Run graph optimize</button>
+              </div>
+              <SurfaceJumpLinks surface="topology" variant="compact" title="Structural handoffs" />
             </div>
           </div>
         }
       />
 
+      <OperatorLoopTrail surface="topology" />
+
       <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(180px, 1fr))', gap: 16 }}>
         <MetricCard label="Open review items" value={dashboard.summary.open} sublabel={`${dashboard.summary.deferred} deferred • ${dashboard.summary.accepted} accepted`} tone={dashboard.summary.open > 0 ? 'yellow' : 'green'} icon="⇄" />
         <MetricCard label="Accepted ready" value={dashboard.acceptedReady.length} sublabel="accepted candidates not yet prepared for execution" tone={dashboard.acceptedReady.length > 0 ? 'blue' : 'neutral'} icon="✓" />
@@ -286,6 +291,7 @@ export default function TopologyClient({
                   <span className={`badge badge-${toneForChange(candidate.changeType)}`}>{candidate.changeType}</span>
                   <span className="badge badge-gray">accepted</span>
                   <span className="badge badge-gray">risk {(candidate.riskScore * 100).toFixed(0)}%</span>
+                  {(candidate.semanticConceptIds ?? []).slice(0, 2).map((conceptId) => <span key={`${candidate.id}-${conceptId}`} className="badge badge-green">{conceptId}</span>)}
                 </div>
                 <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap', marginTop: 12 }}>
                   <button
@@ -299,10 +305,13 @@ export default function TopologyClient({
                 </div>
               </div>
             )) : (
-              <div className="empty-state" style={{ padding: 24 }}>
-                <div className="empty-state-title">No accepted candidates waiting for preparation</div>
-                <div className="empty-state-desc">Accept a topology review item first, then it will enter the reviewed execution pipeline here.</div>
-              </div>
+              <NextStepEmptyState
+                title="No accepted candidates waiting for preparation"
+                description="Accept a topology review item first, then it can enter the reviewed execution pipeline and become a prepared apply plan."
+                command="helixevo graph --optimize"
+                pageLink={{ label: 'Open Co-Evolution', href: '/coevolution', tone: 'purple' }}
+                guideLink={{ label: 'Guide · Maturity & Safety', anchor: 'maturity', tone: 'yellow' }}
+              />
             )}
           </div>
 
@@ -341,10 +350,13 @@ export default function TopologyClient({
                 </div>
               </div>
             )) : (
-              <div className="empty-state" style={{ padding: 24 }}>
-                <div className="empty-state-title">No prepared plans yet</div>
-                <div className="empty-state-desc">Prepared plans will appear here after you convert an accepted review candidate into an explicit apply plan.</div>
-              </div>
+              <NextStepEmptyState
+                title="No prepared plans yet"
+                description="Prepared plans will appear here after an accepted review candidate is converted into an explicit apply plan with snapshot-backed safety."
+                command="helixevo topology --prepare <candidateId>"
+                pageLink={{ label: 'Open Ontology', href: '/ontology', tone: 'green' }}
+                guideLink={{ label: 'Guide · Maturity & Safety', anchor: 'maturity', tone: 'yellow' }}
+              />
             )}
           </div>
         </div>
@@ -414,6 +426,7 @@ export default function TopologyClient({
                     <span className={`badge badge-${toneForChange(candidate.changeType)}`}>{candidate.changeType}</span>
                     <span className="badge badge-gray">{candidate.source}</span>
                     <span className="badge badge-gray">confidence {(candidate.confidence * 100).toFixed(0)}%</span>
+                    {(candidate.semanticConceptIds ?? []).slice(0, 2).map((conceptId) => <span key={`${candidate.id}-${conceptId}`} className="badge badge-green">{conceptId}</span>)}
                   </div>
                   {candidate.latestDecision ? (
                     <div style={{ display: 'grid', gap: 4, marginTop: 10 }}>
@@ -424,10 +437,13 @@ export default function TopologyClient({
                 </div>
               </div>
             )) : (
-              <div className="empty-state" style={{ padding: 24 }}>
-                <div className="empty-state-title">No topology decisions yet</div>
-                <div className="empty-state-desc">Run graph optimize to populate the queue, then accept, defer, or reject structural candidates from here.</div>
-              </div>
+              <NextStepEmptyState
+                title="No topology decisions yet"
+                description="Run graph optimize to populate the queue, then accept, defer, or reject structural candidates from this page so the review memory becomes explicit."
+                command="helixevo graph --optimize"
+                pageLink={{ label: 'Open Co-Evolution', href: '/coevolution', tone: 'purple' }}
+                guideLink={{ label: 'Guide · Surface Map', anchor: 'surfaces', tone: 'blue' }}
+              />
             )}
           </div>
         </SectionFrame>
@@ -466,6 +482,7 @@ export default function TopologyClient({
                     <span className="badge badge-gray">{candidate.source}</span>
                     <span className="badge badge-gray">confidence {(candidate.confidence * 100).toFixed(0)}%</span>
                     <span className="badge badge-gray">risk {(candidate.riskScore * 100).toFixed(0)}%</span>
+                    {(candidate.semanticConceptIds ?? []).slice(0, 2).map((conceptId) => <span key={`${candidate.id}-${conceptId}`} className="badge badge-green">{conceptId}</span>)}
                     {(candidate.projectIds ?? []).slice(0, 3).map((projectId) => <span key={`${candidate.id}-${projectId}`} className="badge badge-gray">{projectId}</span>)}
                   </div>
                   <div style={{ display: 'grid', gap: 4, marginTop: 10 }}>
@@ -488,10 +505,13 @@ export default function TopologyClient({
               </div>
             </div>
           )) : (
-            <div className="empty-state" style={{ padding: 28 }}>
-              <div className="empty-state-title">No topology backlog yet</div>
-              <div className="empty-state-desc">Run <code>graph --optimize</code> from this page to refresh structural review candidates and turn manual-review into a populated operator lane.</div>
-            </div>
+            <NextStepEmptyState
+              title="No topology backlog yet"
+              description="Refresh structural review candidates from this page to turn manual-review into a populated operator lane instead of a placeholder route label."
+              command="helixevo graph --optimize"
+              pageLink={{ label: 'Open Ontology', href: '/ontology', tone: 'green' }}
+              guideLink={{ label: 'Guide · Surface Map', anchor: 'surfaces', tone: 'blue' }}
+            />
           )}
         </div>
       </SectionFrame>
@@ -536,10 +556,12 @@ export default function TopologyClient({
               </div>
             </div>
           )) : (
-            <div className="empty-state" style={{ padding: 24 }}>
-              <div className="empty-state-title">No applied topology history yet</div>
-              <div className="empty-state-desc">Once a prepared safe plan is applied, it will appear here with rollback continuity.</div>
-            </div>
+            <NextStepEmptyState
+              title="No applied topology history yet"
+              description="Applied topology history will appear here once a prepared safe plan is executed and snapshot-backed rollback continuity becomes relevant."
+              command="helixevo topology --apply <planId>"
+              guideLink={{ label: 'Guide · Maturity & Safety', anchor: 'maturity', tone: 'yellow' }}
+            />
           )}
         </div>
       </SectionFrame>
@@ -564,10 +586,13 @@ export default function TopologyClient({
               </div>
             </div>
           )) : (
-            <div className="empty-state" style={{ padding: 24 }}>
-              <div className="empty-state-title">No structural candidates stored yet</div>
-              <div className="empty-state-desc">The ledger will populate after the first topology refresh.</div>
-            </div>
+            <NextStepEmptyState
+              title="No structural candidates stored yet"
+              description="The structural review ledger will populate after the first topology refresh and then persist reviewed intent across decisions and execution."
+              command="helixevo graph --optimize"
+              pageLink={{ label: 'Open Co-Evolution', href: '/coevolution', tone: 'purple' }}
+              guideLink={{ label: 'Guide · Surface Map', anchor: 'surfaces', tone: 'blue' }}
+            />
           )}
         </div>
       </SectionFrame>

package/dashboard/components/guide-deep-link.tsx

@@ -0,0 +1,22 @@
+import Link from 'next/link'
+import { guideHref, type GuideAnchorId, type SurfaceTone } from '@/lib/loop-map'
+
+function toneClass(tone: SurfaceTone) {
+  return `hero-chip hero-chip-${tone}`
+}
+
+export function GuideDeepLink({
+  anchor,
+  label,
+  tone = 'neutral',
+}: {
+  anchor: GuideAnchorId
+  label: string
+  tone?: SurfaceTone
+}) {
+  return (
+    <Link href={guideHref(anchor)} className={toneClass(tone)} style={{ textDecoration: 'none' }}>
+      {label}
+    </Link>
+  )
+}