helixevo 0.4.0 → 0.5.0

package/dashboard/app/ontology/client.tsx

@@ -0,0 +1,247 @@
+'use client'
+
+import Link from 'next/link'
+import { useState } from 'react'
+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 type { OntologyControlDashboardSummary, OntologyReviewDecisionStatus } from '@/lib/data'
+
+type RunState = 'idle' | 'running' | 'success' | 'error'
+
+function consoleTone(state: RunState): 'neutral' | 'green' | 'red' | 'yellow' {
+  if (state === 'success') return 'green'
+  if (state === 'error') return 'red'
+  return 'neutral'
+}
+
+function toneForConcept(kind: string): 'blue' | 'green' | 'purple' | 'yellow' | 'neutral' {
+  if (kind === 'capability') return 'blue'
+  if (kind === 'pressure-type') return 'yellow'
+  if (kind === 'topology-motif') return 'purple'
+  return 'neutral'
+}
+
+function formatDate(value: string | undefined) {
+  if (!value) return '—'
+  return new Date(value).toLocaleString()
+}
+
+function formatMode(value: string) {
+  return value.replace(/-/g, ' ')
+}
+
+export default function OntologyClient({ initialDashboard }: { initialDashboard: OntologyControlDashboardSummary }) {
+  const [dashboard, setDashboard] = useState(initialDashboard)
+  const [runState, setRunState] = useState<RunState>('idle')
+  const [output, setOutput] = useState('')
+  const [pendingKey, setPendingKey] = useState<string | null>(null)
+
+  const runAction = async (action: 'refresh' | 'review' | 'deprecate', payload: { conceptId?: string; decision?: OntologyReviewDecisionStatus; rationale?: string }, label: string) => {
+    setPendingKey(payload.conceptId ?? action)
+    setRunState('running')
+    setOutput('')
+    try {
+      const res = await fetch('/api/ontology', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ action, ...payload }),
+      })
+      const data = await res.json()
+      if (!res.ok || !data.success) {
+        setRunState('error')
+        setOutput(data.error ?? `${label} failed`)
+        return
+      }
+      setDashboard(data.dashboard)
+      setRunState('success')
+      setOutput(data.output || `${label} completed`)
+    } catch (err: unknown) {
+      setRunState('error')
+      setOutput(err instanceof Error ? err.message : `${label} failed`)
+    } finally {
+      setPendingKey(null)
+    }
+  }
+
+  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."
+        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: 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>
+            <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>
+          </div>
+        }
+      />
+
+      <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="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."
+      >
+        <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap' }}>
+          <span className="badge badge-gray">version {dashboard.kernel.version}</span>
+          <span className="badge badge-gray">{dashboard.kernel.entityNames.length} kernel entities</span>
+          <span className="badge badge-gray">{dashboard.kernel.mutationOperations.length} mutation operations</span>
+          <span className="badge badge-gray">{dashboard.kernel.invariantIds.length} invariants</span>
+        </div>
+        <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(220px, 1fr))', gap: 12, marginTop: 16 }}>
+          <div className="guide-dimension-card" style={{ borderLeftColor: 'var(--blue)' }}>
+            <div style={{ fontSize: 12, fontWeight: 700, color: 'var(--blue)' }}>Kernel pillars</div>
+            <div style={{ fontSize: 12, color: 'var(--text-dim)', marginTop: 8, lineHeight: 1.6 }}>{dashboard.kernel.pillars.join(' • ')}</div>
+          </div>
+          <div className="guide-dimension-card" style={{ borderLeftColor: 'var(--green)' }}>
+            <div style={{ fontSize: 12, fontWeight: 700, color: 'var(--green)' }}>Allowed layers</div>
+            <div style={{ fontSize: 12, color: 'var(--text-dim)', marginTop: 8, lineHeight: 1.6 }}>{dashboard.kernel.layers.join(' • ')}</div>
+          </div>
+        </div>
+      </SectionFrame>
+
+      <SectionFrame
+        eyebrow="Frontier"
+        title="Reviewable concept hypotheses"
+        description="These concepts remain provisional until reviewed. Promotion materializes an approved extension; reject and defer preserve semantic memory without silent drift."
+      >
+        <div style={{ display: 'grid', gap: 12 }}>
+          {dashboard.frontier.length > 0 ? dashboard.frontier.map((concept) => (
+            <div key={concept.id} style={{ padding: '16px 18px', borderRadius: 18, border: '1px solid var(--border)', background: 'rgba(255,255,255,0.74)' }}>
+              <div style={{ display: 'flex', justifyContent: 'space-between', gap: 16, alignItems: 'flex-start', flexWrap: 'wrap' }}>
+                <div style={{ display: 'grid', gap: 4, flex: 1 }}>
+                  <div style={{ fontSize: 13, fontWeight: 700, color: 'var(--text)' }}>{concept.name}</div>
+                  <div style={{ fontSize: 12, color: 'var(--text-dim)', lineHeight: 1.6 }}>{concept.description ?? concept.sourceSummary ?? 'Provisional ontology hypothesis.'}</div>
+                </div>
+                <div style={{ display: 'flex', gap: 6, flexWrap: 'wrap' }}>
+                  <span className={`badge badge-${toneForConcept(concept.conceptKind)}`}>{concept.conceptKind}</span>
+                  <span className="badge badge-gray">{concept.reviewStatus}</span>
+                  <span className="badge badge-gray">{concept.observationCount ?? 0} obs</span>
+                  <span className="badge badge-gray">{((concept.confidence ?? 0) * 100).toFixed(0)}% confidence</span>
+                </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">{(concept.evidenceIds?.length ?? 0)} evidence ids</span>
+                <span className="badge badge-gray">last seen {formatDate(concept.lastObservedAt)}</span>
+              </div>
+              <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap', marginTop: 14 }}>
+                <button onClick={() => runAction('review', { conceptId: concept.id, decision: 'promote', rationale: `Promote ${concept.name} into approved ontology extension.` }, `promote ${concept.name}`)} disabled={pendingKey === concept.id} className="badge badge-blue" style={{ border: 'none', cursor: 'pointer' }}>Promote</button>
+                <button onClick={() => runAction('review', { conceptId: concept.id, decision: 'defer', rationale: `Defer ${concept.name} for more evidence.` }, `defer ${concept.name}`)} disabled={pendingKey === concept.id} className="badge badge-purple" style={{ border: 'none', cursor: 'pointer' }}>Defer</button>
+                <button onClick={() => runAction('review', { conceptId: concept.id, decision: 'reject', rationale: `Reject ${concept.name} as a weak or overlapping frontier concept.` }, `reject ${concept.name}`)} disabled={pendingKey === concept.id} className="badge badge-gray" style={{ border: 'none', cursor: 'pointer' }}>Reject</button>
+              </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>
+          )}
+        </div>
+      </SectionFrame>
+
+      <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."
+      >
+        <div style={{ display: 'grid', gap: 12 }}>
+          {dashboard.extensions.length > 0 ? dashboard.extensions.map((concept) => (
+            <div key={concept.id} style={{ padding: '16px 18px', borderRadius: 18, border: '1px solid var(--border)', background: 'rgba(255,255,255,0.74)' }}>
+              <div style={{ display: 'flex', justifyContent: 'space-between', gap: 16, alignItems: 'flex-start', flexWrap: 'wrap' }}>
+                <div style={{ display: 'grid', gap: 4, flex: 1 }}>
+                  <div style={{ fontSize: 13, fontWeight: 700, color: 'var(--text)' }}>{concept.name}</div>
+                  <div style={{ fontSize: 12, color: 'var(--text-dim)', lineHeight: 1.6 }}>{concept.description ?? concept.sourceSummary ?? 'Approved ontology extension.'}</div>
+                </div>
+                <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.evidenceIds?.length ?? 0)} evidence ids</span>
+                </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">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>
+            </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>
+          )}
+        </div>
+      </SectionFrame>
+
+      <SectionFrame
+        eyebrow="Change log"
+        title="Recent semantic transitions"
+        description="Every meaningful ontology action should leave behind a visible change trail instead of becoming invisible semantic drift."
+      >
+        <div style={{ display: 'grid', gap: 10 }}>
+          {dashboard.recentChanges.length > 0 ? dashboard.recentChanges.map((event) => (
+            <div key={event.id} style={{ padding: '14px 16px', borderRadius: 18, border: '1px solid var(--border)', background: 'rgba(255,255,255,0.72)' }}>
+              <div style={{ display: 'flex', justifyContent: 'space-between', gap: 16, flexWrap: 'wrap' }}>
+                <div style={{ fontSize: 12.5, fontWeight: 700, color: 'var(--text)' }}>{event.changeType}</div>
+                <span className="badge badge-gray">{formatDate(event.timestamp)}</span>
+              </div>
+              <div style={{ fontSize: 12, color: 'var(--text-dim)', marginTop: 6, lineHeight: 1.6 }}>{event.reason}</div>
+              <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap', marginTop: 10 }}>
+                <span className="badge badge-gray">{event.conceptIds.join(', ')}</span>
+                <span className="badge badge-gray">{(event.evidenceIds?.length ?? 0)} evidence ids</span>
+              </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>
+          )}
+        </div>
+      </SectionFrame>
+
+      <ConsolePanel
+        title="Ontology console"
+        tone={consoleTone(runState)}
+        actions={<span className="badge badge-gray">{runState === 'running' ? 'running' : runState === 'success' ? 'success' : runState === 'error' ? 'error' : 'idle'}</span>}
+      >
+        <pre style={{ margin: 0, whiteSpace: 'pre-wrap', fontSize: 12, lineHeight: 1.7, color: 'var(--text-dim)' }}>
+          {runState === 'running'
+            ? 'Running ontology control…\n\n' + (output || '')
+            : runState === 'success'
+              ? (output || 'Ontology action completed.')
+              : runState === 'error'
+                ? (output || 'Ontology action failed.')
+                : 'Refresh the frontier or review concepts to inspect semantic changes.'}
+        </pre>
+      </ConsolePanel>
+    </div>
+  )
+}

package/dashboard/app/ontology/page.tsx

@@ -0,0 +1,9 @@
+import OntologyClient from './client'
+import { loadOntologyControlSummary } from '@/lib/data'
+
+export const dynamic = 'force-dynamic'
+
+export default function OntologyPage() {
+  const dashboard = loadOntologyControlSummary()
+  return <OntologyClient initialDashboard={dashboard} />
+}

package/dashboard/app/page.tsx

@@ -83,8 +83,8 @@ export default function Overview() {
       <SectionFrame
         eyebrow="Brain foundation"
         title="Semantic backbone"
-        description="A compatibility-era view of the living brain, derived from the current skill graph, evolution history, and captured failures while native ontology events are being wired in."
-        actions={<span className="badge badge-gray">{ontology.source === 'graph' ? `Ontology ${ontology.specVersion}` : 'Compatibility-derived'}</span>}
+        description="A hybrid ontology view of the living brain, combining derived skill-graph semantics with native ontology frontier, extension, and semantic review activity."
+        actions={<span className="badge badge-gray">{ontology.source === 'hybrid-native-derived' ? `Ontology ${ontology.specVersion} · hybrid native + derived` : ontology.source === 'graph' ? `Ontology ${ontology.specVersion}` : 'Compatibility-derived'}</span>}
       >
         <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(180px, 1fr))', gap: 16 }}>
           <MetricCard
@@ -143,6 +143,14 @@ export default function Overview() {
             href="/topology"
             icon="⇄"
           />
+          <MetricCard
+            label="Ontology frontier"
+            value={ontology.ontologyLoop.frontier}
+            sublabel={`${ontology.ontologyLoop.reviewOpen} open • ${ontology.ontologyLoop.extensions} approved extensions`}
+            tone={ontology.ontologyLoop.reviewOpen > 0 ? 'yellow' : ontology.ontologyLoop.extensions > 0 ? 'blue' : 'neutral'}
+            href="/ontology"
+            icon="◎"
+          />
           <MetricCard
             label="Observed mutation verbs"
             value={ontology.mutationOperationsObserved}
@@ -166,8 +174,10 @@ export default function Overview() {
           <span className="badge badge-gray">{coevolution.crossProjectGapAreas.length} cross-project gap motifs</span>
           <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">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>
           <Link href="/topology" className="badge badge-blue" style={{ textDecoration: 'none' }}>Open topology control</Link>
           <span className="badge badge-gray">governance: {ontology.governance.activeMode.replace(/-/g, ' ')} ({ontology.governance.source})</span>
           <span className="badge badge-gray">routes → research {ontology.governedRoutes.research} • specialize {ontology.governedRoutes.specialize} • evolve {ontology.governedRoutes.evolve} • generalize {ontology.governedRoutes.generalize} • manual-review {ontology.governedRoutes['manual-review']}</span>

package/dashboard/app/topology/client.tsx

@@ -253,6 +253,7 @@ export default function TopologyClient({
             </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>

package/dashboard/components/sidebar-nav.tsx

@@ -12,6 +12,7 @@ interface NavItem {
 const WORKSPACE_NAV: NavItem[] = [
   { href: '/', label: 'Overview', icon: 'M3 12l2-2m0 0l7-7 7 7M5 10v10a1 1 0 001 1h3m10-11l2 2m-2-2v10a1 1 0 01-1 1h-3m-4 0a1 1 0 01-1-1v-4a1 1 0 011-1h2a1 1 0 011 1v4a1 1 0 01-1 1' },
   { href: '/network', label: 'Skill Network', icon: 'M13.828 10.172a4 4 0 00-5.656 0l-4 4a4 4 0 105.656 5.656l1.102-1.101m-.758-4.899a4 4 0 005.656 0l4-4a4 4 0 00-5.656-5.656l-1.1 1.1' },
+  { href: '/ontology', label: 'Ontology', icon: 'M12 3l8 4.5v9L12 21l-8-4.5v-9L12 3zm0 4.2l-4 2.25v4.95l4 2.25 4-2.25V9.45L12 7.2zm0 0V21' },
   { href: '/topology', label: 'Topology', icon: 'M4 7h6m4 0h6M7 4v6m10-6v6M5 17h14M12 10v10' },
   { href: '/coevolution', label: 'Co-Evolution', icon: 'M4 12h4m8 0h4M12 4v4m0 8v4M7.05 7.05l2.83 2.83m4.24 4.24l2.83 2.83m0-9.9l-2.83 2.83m-4.24 4.24l-2.83 2.83' },
   { href: '/evolution', label: 'Evolution', icon: 'M13 7h8m0 0v8m0-8l-8 8-4-4-6 6' },