helixevo 0.6.0 → 0.7.0

package/dashboard/lib/loop-map.ts

@@ -0,0 +1,210 @@
+export type LoopStageId = 'observe' | 'route' | 'adopt' | 'restructure' | 'prove'
+export type SurfaceKey = 'overview' | 'projects' | 'research' | 'coevolution' | 'ontology' | 'topology' | 'proof'
+export type SurfaceTone = 'blue' | 'green' | 'purple' | 'yellow' | 'neutral'
+export type GuideAnchorId = 'quickstart' | 'brainstack' | 'loop' | 'semanticcontrol' | 'surfaces' | 'commands' | 'maturity' | 'metrics'
+
+export interface LoopStageMeta {
+  id: LoopStageId
+  label: string
+  href: string
+  tone: SurfaceTone
+  description: string
+}
+
+export interface SurfaceJumpLink {
+  label: string
+  href: string
+  tone: SurfaceTone
+  description: string
+}
+
+export interface GuideDeepLinkDef {
+  label: string
+  anchor: GuideAnchorId
+  tone: SurfaceTone
+  description: string
+}
+
+export interface SurfaceLoopConfig {
+  key: SurfaceKey
+  label: string
+  context: string
+  stage?: LoopStageId
+  adjacentLinks: SurfaceJumpLink[]
+  guideLinks: GuideDeepLinkDef[]
+}
+
+export const LOOP_STAGES: LoopStageMeta[] = [
+  {
+    id: 'observe',
+    label: 'Observe',
+    href: '/projects',
+    tone: 'blue',
+    description: 'Project intake, pressure discovery, and activation-aware observation.',
+  },
+  {
+    id: 'route',
+    label: 'Route',
+    href: '/coevolution',
+    tone: 'purple',
+    description: 'Governed response selection across research, evolve, generalize, and review lanes.',
+  },
+  {
+    id: 'adopt',
+    label: 'Adopt',
+    href: '/ontology',
+    tone: 'green',
+    description: 'Promote approved concepts into active semantic consumers inside the live loop.',
+  },
+  {
+    id: 'restructure',
+    label: 'Restructure',
+    href: '/topology',
+    tone: 'yellow',
+    description: 'Turn reviewed structural intent into prepared, applied, and rollbackable change.',
+  },
+  {
+    id: 'prove',
+    label: 'Prove',
+    href: '/proof',
+    tone: 'neutral',
+    description: 'Review bounded outcome attribution, proof decisions, and the live evidence ledger.',
+  },
+]
+
+export const GUIDE_ANCHOR_LABELS: Record<GuideAnchorId, string> = {
+  quickstart: 'Quick Start',
+  brainstack: 'Brain Stack',
+  loop: 'Adaptation Loop',
+  semanticcontrol: 'Semantic Control',
+  surfaces: 'Surface Map',
+  commands: 'Commands',
+  maturity: 'Maturity & Safety',
+  metrics: 'Closed-Loop Metrics',
+}
+
+export function guideHref(anchor: GuideAnchorId) {
+  return `/guide#${anchor}`
+}
+
+export const SURFACE_LOOP_CONFIG: Record<SurfaceKey, SurfaceLoopConfig> = {
+  overview: {
+    key: 'overview',
+    label: 'Overview',
+    context: 'Use Overview as the cockpit entry into the full loop, then jump into the stage that currently needs attention.',
+    adjacentLinks: [
+      { label: 'Open Projects', href: '/projects', tone: 'blue', description: 'Start from project intake, gap discovery, and observation.' },
+      { label: 'Open Co-Evolution', href: '/coevolution', tone: 'purple', description: 'Inspect governed routing and the active response backlog.' },
+      { label: 'Open Ontology', href: '/ontology', tone: 'green', description: 'Inspect semantic adoption, frontier review, and concept consumers.' },
+      { label: 'Open Topology', href: '/topology', tone: 'yellow', description: 'Review structural candidates, preparation, and rollbackable execution.' },
+      { label: 'Open Proof', href: '/proof', tone: 'neutral', description: 'Review what appears to be working, regressing, or still measuring.' },
+    ],
+    guideLinks: [
+      { label: 'Read Quick Start', anchor: 'quickstart', tone: 'blue', description: 'See the shortest operator path into the live brain loop.' },
+      { label: 'Read Surface Map', anchor: 'surfaces', tone: 'purple', description: 'Understand how each dashboard surface fits together.' },
+    ],
+  },
+  projects: {
+    key: 'projects',
+    label: 'Projects',
+    stage: 'observe',
+    context: 'Projects is where local context becomes explicit observation: capabilities, gaps, activation traces, and pressure feeders.',
+    adjacentLinks: [
+      { label: 'Open Research', href: '/research', tone: 'purple', description: 'Turn uncovered project gaps into discovery work.' },
+      { label: 'Open Co-Evolution', href: '/coevolution', tone: 'green', description: 'See how project pressure is being routed into response.' },
+      { label: 'Open Ontology', href: '/ontology', tone: 'blue', description: 'Check whether recurring project demand is becoming semantic adoption.' },
+      { label: 'Open Skill Network', href: '/network', tone: 'neutral', description: 'Inspect the skills that were matched or may need specialization.' },
+    ],
+    guideLinks: [
+      { label: 'Guide · Quick Start', anchor: 'quickstart', tone: 'blue', description: 'Follow the operator path from project intake to response.' },
+      { label: 'Guide · Adaptation Loop', anchor: 'loop', tone: 'purple', description: 'Trace how project observation becomes routed adaptation.' },
+    ],
+  },
+  research: {
+    key: 'research',
+    label: 'Research',
+    stage: 'observe',
+    context: 'Research extends observation into discovery by turning recurring capability pressure into external evidence and candidate skills.',
+    adjacentLinks: [
+      { label: 'Open Projects', href: '/projects', tone: 'blue', description: 'Return to the project contexts that produced the gaps.' },
+      { label: 'Open Co-Evolution', href: '/coevolution', tone: 'green', description: 'Check how governed routing is prioritizing research pressure.' },
+      { label: 'Open Ontology', href: '/ontology', tone: 'purple', description: 'Inspect whether recurring research demand is becoming active semantics.' },
+    ],
+    guideLinks: [
+      { label: 'Guide · Quick Start', anchor: 'quickstart', tone: 'blue', description: 'See how research fits the current operator path.' },
+      { label: 'Guide · Adaptation Loop', anchor: 'loop', tone: 'purple', description: 'Connect discovery work back to the broader loop.' },
+    ],
+  },
+  coevolution: {
+    key: 'coevolution',
+    label: 'Co-Evolution',
+    stage: 'route',
+    context: 'Co-Evolution is the response cockpit where observed demand is routed under governance into the next adaptation lane.',
+    adjacentLinks: [
+      { label: 'Open Ontology', href: '/ontology', tone: 'green', description: 'Inspect which approved concepts are influencing current route rationale.' },
+      { label: 'Open Topology', href: '/topology', tone: 'yellow', description: 'Escalate mixed-signal structural demand into review and execution.' },
+      { label: 'Open Research', href: '/research', tone: 'blue', description: 'Run or inspect the discovery lane when research is the governed response.' },
+      { label: 'Open Proof', href: '/proof', tone: 'neutral', description: 'See whether routed interventions and transfer appear effective yet.' },
+    ],
+    guideLinks: [
+      { label: 'Guide · Semantic Control', anchor: 'semanticcontrol', tone: 'green', description: 'See how semantic adoption shapes route explanation without bypassing governance.' },
+      { label: 'Guide · Surface Map', anchor: 'surfaces', tone: 'purple', description: 'Compare the response cockpit with the nearby control surfaces.' },
+    ],
+  },
+  ontology: {
+    key: 'ontology',
+    label: 'Ontology',
+    stage: 'adopt',
+    context: 'Ontology is where reviewed concepts become approved extensions and then become visible as active semantic consumers.',
+    adjacentLinks: [
+      { label: 'Open Co-Evolution', href: '/coevolution', tone: 'purple', description: 'See where active concepts are influencing current route rationale.' },
+      { label: 'Open Topology', href: '/topology', tone: 'yellow', description: 'Compare semantic adoption with structural review and execution.' },
+      { label: 'Open Skill Network', href: '/network', tone: 'blue', description: 'Inspect semantic context alongside graph relationships and inspector detail.' },
+      { label: 'Open Proof', href: '/proof', tone: 'neutral', description: 'Review semantic-adoption effectiveness without overclaiming causality.' },
+    ],
+    guideLinks: [
+      { label: 'Guide · Semantic Control', anchor: 'semanticcontrol', tone: 'green', description: 'Read the post-M8 / post-M9 ontology lifecycle and operator playbooks.' },
+      { label: 'Guide · Surface Map', anchor: 'surfaces', tone: 'purple', description: 'See where ontology sits relative to Co-Evolution and Topology.' },
+    ],
+  },
+  topology: {
+    key: 'topology',
+    label: 'Topology',
+    stage: 'restructure',
+    context: 'Topology is the structural handoff where reviewed intent becomes prepared, applied, and rollbackable graph change.',
+    adjacentLinks: [
+      { label: 'Open Ontology', href: '/ontology', tone: 'green', description: 'Check the semantic families clustering around current structural candidates.' },
+      { label: 'Open Co-Evolution', href: '/coevolution', tone: 'purple', description: 'Return to the governed response backlog feeding structural review.' },
+      { label: 'Open Skill Network', href: '/network', tone: 'blue', description: 'Inspect the graph context around the candidates being reviewed or applied.' },
+      { label: 'Open Proof', href: '/proof', tone: 'neutral', description: 'Review whether structural execution appears effective, mixed, or regressed.' },
+    ],
+    guideLinks: [
+      { label: 'Guide · Surface Map', anchor: 'surfaces', tone: 'purple', description: 'See how topology fits the rest of the dashboard operator loop.' },
+      { label: 'Guide · Maturity & Safety', anchor: 'maturity', tone: 'yellow', description: 'Review the current bounded-safe-execution limits before structural action.' },
+    ],
+  },
+  proof: {
+    key: 'proof',
+    label: 'Proof',
+    stage: 'prove',
+    context: 'Proof is where bounded outcome attribution becomes explicit operator review across interventions, semantics, transfer, topology, and evolution.',
+    adjacentLinks: [
+      { label: 'Open Co-Evolution', href: '/coevolution', tone: 'purple', description: 'Compare proof verdicts with the active response backlog and route state.' },
+      { label: 'Open Ontology', href: '/ontology', tone: 'green', description: 'Inspect semantic-adoption evidence alongside concept review and deprecation risk.' },
+      { label: 'Open Topology', href: '/topology', tone: 'yellow', description: 'Compare structural execution outcomes with their reviewed execution history.' },
+      { label: 'Open Overview', href: '/', tone: 'blue', description: 'Return to the cockpit after reviewing what appears to be working.' },
+    ],
+    guideLinks: [
+      { label: 'Guide · Closed-Loop Metrics', anchor: 'metrics', tone: 'blue', description: 'Read how metrics and proof fit together inside the prove stage.' },
+      { label: 'Guide · Surface Map', anchor: 'surfaces', tone: 'purple', description: 'See where Proof sits in the dashboard operator loop.' },
+    ],
+  },
+}
+
+export function getSurfaceLoopConfig(surface: SurfaceKey) {
+  return SURFACE_LOOP_CONFIG[surface]
+}
+
+export function getLoopStage(stageId: LoopStageId) {
+  return LOOP_STAGES.find((stage) => stage.id === stageId)
+}