@neuroverseos/governance 0.6.1 → 0.7.0

package/dist/radiant/index.d.cts

@@ -970,6 +970,60 @@ interface InterpretResult {
  */
 declare function interpretPatterns(input: InterpretInput): Promise<InterpretResult>;
 
+/**
+ * @neuroverseos/governance/radiant — governance audit
+ *
+ * Runs each GitHub event through the NeuroverseOS guard engine against
+ * the compiled worldmodel. Produces an audit trail showing which events
+ * triggered governance (BLOCK/MODIFY), which side (human/AI/joint),
+ * and what invariants were tested.
+ *
+ * This is where Radiant meets the NeuroverseOS governance engine.
+ * Same evaluateGuard() that runs at API-level, applied retroactively
+ * to activity that already happened. The audit trail is the proof that
+ * the cocoon's walls are holding — or shows where they're being tested.
+ */
+
+interface GovernanceVerdict {
+    eventId: string;
+    domain: ActorDomain;
+    status: 'ALLOW' | 'BLOCK' | 'MODIFY' | 'PAUSE' | 'PENALIZE' | 'REWARD';
+    reason?: string;
+    ruleId?: string;
+    warning?: string;
+}
+interface GovernanceAudit {
+    totalEvents: number;
+    human: {
+        allow: number;
+        modify: number;
+        block: number;
+        details: GovernanceVerdict[];
+    };
+    cyber: {
+        allow: number;
+        modify: number;
+        block: number;
+        details: GovernanceVerdict[];
+    };
+    joint: {
+        allow: number;
+        modify: number;
+        block: number;
+        details: GovernanceVerdict[];
+    };
+    /** Summary for rendering — most important findings. */
+    summary: string;
+}
+/**
+ * Run each classified event through the guard engine against the compiled
+ * worldmodel. Returns a structured audit with human/cyber/joint breakdown.
+ *
+ * @param events — classified events from the GitHub adapter
+ * @param worldPath — path to a compiled .nv-world.md or world directory
+ */
+declare function auditGovernance(events: readonly ClassifiedEvent[], worldPath: string): Promise<GovernanceAudit>;
+
 /**
  * @neuroverseos/governance/radiant — renderer
  *
@@ -1000,6 +1054,8 @@ interface RenderInput {
     move?: string;
     /** Number of prior Radiant reads available (0 = first run). */
     priorReadCount?: number;
+    /** Governance audit trail — events evaluated against the worldmodel. */
+    governance?: GovernanceAudit;
 }
 interface RenderOutput {
     /** The human-readable text output for terminal display. */
@@ -1009,6 +1065,85 @@ interface RenderOutput {
 }
 declare function render(input: RenderInput): RenderOutput;
 
+/**
+ * @neuroverseos/governance/radiant — Memory Palace file operations
+ *
+ * Writes Radiant reads to the exocortex as dated markdown files (with
+ * YAML frontmatter for structured signal data). Reads prior files to
+ * detect pattern persistence across runs.
+ *
+ * The exocortex directory IS the Memory Palace. Files are the tiers:
+ *   - reads/YYYY-MM-DD.md = Tier 2 (structured signals) + Tier 3 (narrative)
+ *   - knowledge.md = accumulated pattern facts with persistence counts
+ *
+ * No database. The file system is the time series. Git is the versioning.
+ */
+interface PriorRead {
+    date: string;
+    filename: string;
+    /** Pattern names found in this read (parsed from frontmatter). */
+    patternNames: string[];
+    /** Raw frontmatter content for signal comparison. */
+    frontmatter: string;
+}
+interface PatternPersistence {
+    name: string;
+    /** How many prior reads contained this pattern. */
+    occurrences: number;
+    /** Dates this pattern was observed. */
+    dates: string[];
+}
+/**
+ * Write a Radiant read to the exocortex. Creates the directory structure
+ * if it doesn't exist.
+ *
+ * @param exocortexDir — root of the exocortex (e.g. ~/exocortex/)
+ * @param frontmatter — YAML frontmatter (Tier 2 structured signals)
+ * @param text — prose output (Tier 3 narrative)
+ * @returns the path of the written file
+ */
+declare function writeRead(exocortexDir: string, frontmatter: string, text: string): string;
+/**
+ * Items from the worldmodel that Radiant tracks for subtraction proposals.
+ */
+interface WorldmodelItem {
+    type: 'invariant' | 'drift_behavior' | 'aligned_behavior' | 'decision_priority';
+    name: string;
+}
+/**
+ * Update the knowledge file with:
+ *   - Pattern persistence (what keeps recurring → consider adding)
+ *   - Subtraction proposals (what hasn't fired → consider removing)
+ *   - Active items (what recently triggered → keep)
+ *
+ * The leader reads this file and makes deliberate, rare, bidirectional
+ * changes to the worldmodel. Radiant proposes; the human decides.
+ */
+declare function updateKnowledge(exocortexDir: string, persistence: PatternPersistence[], options?: {
+    /** Items declared in the worldmodel (invariants, drift behaviors, etc.) */
+    declaredItems?: WorldmodelItem[];
+    /** Item names that triggered governance in this read */
+    triggeredItems?: string[];
+    /** Total number of reads completed (for "hasn't fired in N reads" tracking) */
+    totalReads?: number;
+}): string;
+/**
+ * Load prior Radiant reads from the exocortex. Returns them sorted by
+ * date (oldest first). Each read has its pattern names extracted from
+ * the frontmatter.
+ */
+declare function loadPriorReads(exocortexDir: string): PriorRead[];
+/**
+ * Compute pattern persistence across prior reads + the current patterns.
+ */
+declare function computePersistence(priorReads: PriorRead[], currentPatternNames: string[]): PatternPersistence[];
+/**
+ * Format prior-read context for the AI interpretation prompt.
+ * Tells the AI what patterns were seen in previous runs so it can
+ * reference persistence.
+ */
+declare function formatPriorReadsForPrompt(priorReads: PriorRead[]): string;
+
 /**
  * @neuroverseos/governance/radiant — `think` command
  *
@@ -1100,6 +1235,10 @@ interface EmergentInput {
      *  intent (attention, goals, sprint) and compares against observed
      *  behavior from GitHub. The gap is the most valuable signal. */
     exocortexPath?: string;
+    /** Path to a compiled world directory (for governance audit).
+     *  When present, each event is evaluated through evaluateGuard
+     *  and the GOVERNANCE section appears in the output. */
+    worldPath?: string;
 }
 interface EmergentResult {
     /** The rendered text output (EMERGENT / MEANING / MOVE). */
@@ -1147,17 +1286,16 @@ declare function emergent(input: EmergentInput): Promise<EmergentResult>;
  *     knowledge / synthesis) with a SQLite reference implementation
  *   - CLI entry (bin/radiant.ts) and MCP server entry (bin/radiant-mcp.ts)
  *
- * Build state: step 2 of 17 has landed — core types and L/C/N math.
- * Later steps land actor_domain classification, signals, patterns, the
- * auki-builder rendering lens, adapters, commands, CLI, and MCP.
- * Full roadmap: `radiant/PROJECT-PLAN.md` at the repo root.
+ * Build state: Phase 1 complete — voice layer, behavioral dashboard,
+ * MCP server, Memory Palace write-back, governance audit, ExoCortex
+ * handshake. See radiant/PROJECT-PLAN.md for the full roadmap.
  *
- * Usage (math layer, available today):
+ * Usage:
  *   import {
- *     scoreLife, scoreCyber, scoreNeuroVerse, scoreComposite,
- *     type LifeCapability, type CyberCapability,
+ *     think, emergent, scoreLife, classifyActorDomain,
+ *     aukiBuilderLens, checkForbiddenPhrases,
  *   } from '@neuroverseos/governance/radiant';
  */
 declare const RADIANT_PACKAGE_VERSION = "0.0.0";
 
-export { type Actor, type ActorDomain, type ActorKind, type AlignmentStatus, type BridgingComponent, type BridgingComponentScore, type ClassifiedEvent, type CyberCapability, type CyberDimension, DEFAULT_EVIDENCE_GATE, DEFAULT_SIGNAL_EXTRACTORS, type EmergentInput, type EmergentResult, type Event, type EventReference, type EvidenceGate, type ExemplarRef, type ExocortexContext, type ExtractionResult, type GitHubFetchOptions, type InterpretInput, type InterpretResult, LENSES, type LensVocabulary, type LifeCapability, type LifeDimension, type ObservedPattern, type OverlapDef, type PatternEvidence, type PrimaryFrame, RADIANT_PACKAGE_VERSION, type RadiantAI, type RenderInput, type RenderOutput, type RenderingLens, type RepoScope, type Score, type ScoreSentinel, type ScoredObservation, type Signal, type SignalExtractor, type SignalMatrix, type ThinkInput, type ThinkResult, type VoiceDirectives, type VoiceViolation, aukiBuilderLens, checkForbiddenPhrases, classifyActorDomain, classifyEvents, composeSystemPrompt, createAnthropicAI, createMockAI, createMockGitHubAdapter, emergent, extractSignals, fetchGitHubActivity, formatExocortexForPrompt, formatScope, getLens, interpretPatterns, isPresent, isScored, isSentinel, listLenses, parseRepoScope, presenceAverage, readExocortex, render, scoreComposite, scoreCyber, scoreLife, scoreNeuroVerse, summarizeExocortex, think };
+export { type Actor, type ActorDomain, type ActorKind, type AlignmentStatus, type BridgingComponent, type BridgingComponentScore, type ClassifiedEvent, type CyberCapability, type CyberDimension, DEFAULT_EVIDENCE_GATE, DEFAULT_SIGNAL_EXTRACTORS, type EmergentInput, type EmergentResult, type Event, type EventReference, type EvidenceGate, type ExemplarRef, type ExocortexContext, type ExtractionResult, type GitHubFetchOptions, type GovernanceAudit, type GovernanceVerdict, type InterpretInput, type InterpretResult, LENSES, type LensVocabulary, type LifeCapability, type LifeDimension, type ObservedPattern, type OverlapDef, type PatternEvidence, type PatternPersistence, type PrimaryFrame, type PriorRead, RADIANT_PACKAGE_VERSION, type RadiantAI, type RenderInput, type RenderOutput, type RenderingLens, type RepoScope, type Score, type ScoreSentinel, type ScoredObservation, type Signal, type SignalExtractor, type SignalMatrix, type ThinkInput, type ThinkResult, type VoiceDirectives, type VoiceViolation, type WorldmodelItem, auditGovernance, aukiBuilderLens, checkForbiddenPhrases, classifyActorDomain, classifyEvents, composeSystemPrompt, computePersistence, createAnthropicAI, createMockAI, createMockGitHubAdapter, emergent, extractSignals, fetchGitHubActivity, formatExocortexForPrompt, formatPriorReadsForPrompt, formatScope, getLens, interpretPatterns, isPresent, isScored, isSentinel, listLenses, loadPriorReads, parseRepoScope, presenceAverage, readExocortex, render, scoreComposite, scoreCyber, scoreLife, scoreNeuroVerse, summarizeExocortex, think, updateKnowledge, writeRead };

package/dist/radiant/index.d.ts

@@ -970,6 +970,60 @@ interface InterpretResult {
  */
 declare function interpretPatterns(input: InterpretInput): Promise<InterpretResult>;
 
+/**
+ * @neuroverseos/governance/radiant — governance audit
+ *
+ * Runs each GitHub event through the NeuroverseOS guard engine against
+ * the compiled worldmodel. Produces an audit trail showing which events
+ * triggered governance (BLOCK/MODIFY), which side (human/AI/joint),
+ * and what invariants were tested.
+ *
+ * This is where Radiant meets the NeuroverseOS governance engine.
+ * Same evaluateGuard() that runs at API-level, applied retroactively
+ * to activity that already happened. The audit trail is the proof that
+ * the cocoon's walls are holding — or shows where they're being tested.
+ */
+
+interface GovernanceVerdict {
+    eventId: string;
+    domain: ActorDomain;
+    status: 'ALLOW' | 'BLOCK' | 'MODIFY' | 'PAUSE' | 'PENALIZE' | 'REWARD';
+    reason?: string;
+    ruleId?: string;
+    warning?: string;
+}
+interface GovernanceAudit {
+    totalEvents: number;
+    human: {
+        allow: number;
+        modify: number;
+        block: number;
+        details: GovernanceVerdict[];
+    };
+    cyber: {
+        allow: number;
+        modify: number;
+        block: number;
+        details: GovernanceVerdict[];
+    };
+    joint: {
+        allow: number;
+        modify: number;
+        block: number;
+        details: GovernanceVerdict[];
+    };
+    /** Summary for rendering — most important findings. */
+    summary: string;
+}
+/**
+ * Run each classified event through the guard engine against the compiled
+ * worldmodel. Returns a structured audit with human/cyber/joint breakdown.
+ *
+ * @param events — classified events from the GitHub adapter
+ * @param worldPath — path to a compiled .nv-world.md or world directory
+ */
+declare function auditGovernance(events: readonly ClassifiedEvent[], worldPath: string): Promise<GovernanceAudit>;
+
 /**
  * @neuroverseos/governance/radiant — renderer
  *
@@ -1000,6 +1054,8 @@ interface RenderInput {
     move?: string;
     /** Number of prior Radiant reads available (0 = first run). */
     priorReadCount?: number;
+    /** Governance audit trail — events evaluated against the worldmodel. */
+    governance?: GovernanceAudit;
 }
 interface RenderOutput {
     /** The human-readable text output for terminal display. */
@@ -1009,6 +1065,85 @@ interface RenderOutput {
 }
 declare function render(input: RenderInput): RenderOutput;
 
+/**
+ * @neuroverseos/governance/radiant — Memory Palace file operations
+ *
+ * Writes Radiant reads to the exocortex as dated markdown files (with
+ * YAML frontmatter for structured signal data). Reads prior files to
+ * detect pattern persistence across runs.
+ *
+ * The exocortex directory IS the Memory Palace. Files are the tiers:
+ *   - reads/YYYY-MM-DD.md = Tier 2 (structured signals) + Tier 3 (narrative)
+ *   - knowledge.md = accumulated pattern facts with persistence counts
+ *
+ * No database. The file system is the time series. Git is the versioning.
+ */
+interface PriorRead {
+    date: string;
+    filename: string;
+    /** Pattern names found in this read (parsed from frontmatter). */
+    patternNames: string[];
+    /** Raw frontmatter content for signal comparison. */
+    frontmatter: string;
+}
+interface PatternPersistence {
+    name: string;
+    /** How many prior reads contained this pattern. */
+    occurrences: number;
+    /** Dates this pattern was observed. */
+    dates: string[];
+}
+/**
+ * Write a Radiant read to the exocortex. Creates the directory structure
+ * if it doesn't exist.
+ *
+ * @param exocortexDir — root of the exocortex (e.g. ~/exocortex/)
+ * @param frontmatter — YAML frontmatter (Tier 2 structured signals)
+ * @param text — prose output (Tier 3 narrative)
+ * @returns the path of the written file
+ */
+declare function writeRead(exocortexDir: string, frontmatter: string, text: string): string;
+/**
+ * Items from the worldmodel that Radiant tracks for subtraction proposals.
+ */
+interface WorldmodelItem {
+    type: 'invariant' | 'drift_behavior' | 'aligned_behavior' | 'decision_priority';
+    name: string;
+}
+/**
+ * Update the knowledge file with:
+ *   - Pattern persistence (what keeps recurring → consider adding)
+ *   - Subtraction proposals (what hasn't fired → consider removing)
+ *   - Active items (what recently triggered → keep)
+ *
+ * The leader reads this file and makes deliberate, rare, bidirectional
+ * changes to the worldmodel. Radiant proposes; the human decides.
+ */
+declare function updateKnowledge(exocortexDir: string, persistence: PatternPersistence[], options?: {
+    /** Items declared in the worldmodel (invariants, drift behaviors, etc.) */
+    declaredItems?: WorldmodelItem[];
+    /** Item names that triggered governance in this read */
+    triggeredItems?: string[];
+    /** Total number of reads completed (for "hasn't fired in N reads" tracking) */
+    totalReads?: number;
+}): string;
+/**
+ * Load prior Radiant reads from the exocortex. Returns them sorted by
+ * date (oldest first). Each read has its pattern names extracted from
+ * the frontmatter.
+ */
+declare function loadPriorReads(exocortexDir: string): PriorRead[];
+/**
+ * Compute pattern persistence across prior reads + the current patterns.
+ */
+declare function computePersistence(priorReads: PriorRead[], currentPatternNames: string[]): PatternPersistence[];
+/**
+ * Format prior-read context for the AI interpretation prompt.
+ * Tells the AI what patterns were seen in previous runs so it can
+ * reference persistence.
+ */
+declare function formatPriorReadsForPrompt(priorReads: PriorRead[]): string;
+
 /**
  * @neuroverseos/governance/radiant — `think` command
  *
@@ -1100,6 +1235,10 @@ interface EmergentInput {
      *  intent (attention, goals, sprint) and compares against observed
      *  behavior from GitHub. The gap is the most valuable signal. */
     exocortexPath?: string;
+    /** Path to a compiled world directory (for governance audit).
+     *  When present, each event is evaluated through evaluateGuard
+     *  and the GOVERNANCE section appears in the output. */
+    worldPath?: string;
 }
 interface EmergentResult {
     /** The rendered text output (EMERGENT / MEANING / MOVE). */
@@ -1147,17 +1286,16 @@ declare function emergent(input: EmergentInput): Promise<EmergentResult>;
  *     knowledge / synthesis) with a SQLite reference implementation
  *   - CLI entry (bin/radiant.ts) and MCP server entry (bin/radiant-mcp.ts)
  *
- * Build state: step 2 of 17 has landed — core types and L/C/N math.
- * Later steps land actor_domain classification, signals, patterns, the
- * auki-builder rendering lens, adapters, commands, CLI, and MCP.
- * Full roadmap: `radiant/PROJECT-PLAN.md` at the repo root.
+ * Build state: Phase 1 complete — voice layer, behavioral dashboard,
+ * MCP server, Memory Palace write-back, governance audit, ExoCortex
+ * handshake. See radiant/PROJECT-PLAN.md for the full roadmap.
  *
- * Usage (math layer, available today):
+ * Usage:
  *   import {
- *     scoreLife, scoreCyber, scoreNeuroVerse, scoreComposite,
- *     type LifeCapability, type CyberCapability,
+ *     think, emergent, scoreLife, classifyActorDomain,
+ *     aukiBuilderLens, checkForbiddenPhrases,
  *   } from '@neuroverseos/governance/radiant';
  */
 declare const RADIANT_PACKAGE_VERSION = "0.0.0";
 
-export { type Actor, type ActorDomain, type ActorKind, type AlignmentStatus, type BridgingComponent, type BridgingComponentScore, type ClassifiedEvent, type CyberCapability, type CyberDimension, DEFAULT_EVIDENCE_GATE, DEFAULT_SIGNAL_EXTRACTORS, type EmergentInput, type EmergentResult, type Event, type EventReference, type EvidenceGate, type ExemplarRef, type ExocortexContext, type ExtractionResult, type GitHubFetchOptions, type InterpretInput, type InterpretResult, LENSES, type LensVocabulary, type LifeCapability, type LifeDimension, type ObservedPattern, type OverlapDef, type PatternEvidence, type PrimaryFrame, RADIANT_PACKAGE_VERSION, type RadiantAI, type RenderInput, type RenderOutput, type RenderingLens, type RepoScope, type Score, type ScoreSentinel, type ScoredObservation, type Signal, type SignalExtractor, type SignalMatrix, type ThinkInput, type ThinkResult, type VoiceDirectives, type VoiceViolation, aukiBuilderLens, checkForbiddenPhrases, classifyActorDomain, classifyEvents, composeSystemPrompt, createAnthropicAI, createMockAI, createMockGitHubAdapter, emergent, extractSignals, fetchGitHubActivity, formatExocortexForPrompt, formatScope, getLens, interpretPatterns, isPresent, isScored, isSentinel, listLenses, parseRepoScope, presenceAverage, readExocortex, render, scoreComposite, scoreCyber, scoreLife, scoreNeuroVerse, summarizeExocortex, think };
+export { type Actor, type ActorDomain, type ActorKind, type AlignmentStatus, type BridgingComponent, type BridgingComponentScore, type ClassifiedEvent, type CyberCapability, type CyberDimension, DEFAULT_EVIDENCE_GATE, DEFAULT_SIGNAL_EXTRACTORS, type EmergentInput, type EmergentResult, type Event, type EventReference, type EvidenceGate, type ExemplarRef, type ExocortexContext, type ExtractionResult, type GitHubFetchOptions, type GovernanceAudit, type GovernanceVerdict, type InterpretInput, type InterpretResult, LENSES, type LensVocabulary, type LifeCapability, type LifeDimension, type ObservedPattern, type OverlapDef, type PatternEvidence, type PatternPersistence, type PrimaryFrame, type PriorRead, RADIANT_PACKAGE_VERSION, type RadiantAI, type RenderInput, type RenderOutput, type RenderingLens, type RepoScope, type Score, type ScoreSentinel, type ScoredObservation, type Signal, type SignalExtractor, type SignalMatrix, type ThinkInput, type ThinkResult, type VoiceDirectives, type VoiceViolation, type WorldmodelItem, auditGovernance, aukiBuilderLens, checkForbiddenPhrases, classifyActorDomain, classifyEvents, composeSystemPrompt, computePersistence, createAnthropicAI, createMockAI, createMockGitHubAdapter, emergent, extractSignals, fetchGitHubActivity, formatExocortexForPrompt, formatPriorReadsForPrompt, formatScope, getLens, interpretPatterns, isPresent, isScored, isSentinel, listLenses, loadPriorReads, parseRepoScope, presenceAverage, readExocortex, render, scoreComposite, scoreCyber, scoreLife, scoreNeuroVerse, summarizeExocortex, think, updateKnowledge, writeRead };

package/dist/radiant/index.js

@@ -1,10 +1,12 @@
 import {
   DEFAULT_EVIDENCE_GATE,
   DEFAULT_SIGNAL_EXTRACTORS,
+  auditGovernance,
   checkForbiddenPhrases,
   classifyActorDomain,
   classifyEvents,
   composeSystemPrompt,
+  computePersistence,
   createAnthropicAI,
   createMockAI,
   createMockGitHubAdapter,
@@ -12,11 +14,13 @@ import {
   extractSignals,
   fetchGitHubActivity,
   formatExocortexForPrompt,
+  formatPriorReadsForPrompt,
   formatScope,
   interpretPatterns,
   isPresent,
   isScored,
   isSentinel,
+  loadPriorReads,
   parseRepoScope,
   presenceAverage,
   readExocortex,
@@ -26,14 +30,19 @@ import {
   scoreLife,
   scoreNeuroVerse,
   summarizeExocortex,
-  think
-} from "../chunk-AEVT7DSZ.js";
+  think,
+  updateKnowledge,
+  writeRead
+} from "../chunk-T6EQ7ZBG.js";
 import {
   LENSES,
   aukiBuilderLens,
   getLens,
   listLenses
 } from "../chunk-VGFDMPVB.js";
+import "../chunk-I4RTIMLX.js";
+import "../chunk-ZAF6JH23.js";
+import "../chunk-QLPTHTVB.js";
 import "../chunk-QWGCMQQD.js";
 
 // src/radiant/index.ts
@@ -43,11 +52,13 @@ export {
   DEFAULT_SIGNAL_EXTRACTORS,
   LENSES,
   RADIANT_PACKAGE_VERSION,
+  auditGovernance,
   aukiBuilderLens,
   checkForbiddenPhrases,
   classifyActorDomain,
   classifyEvents,
   composeSystemPrompt,
+  computePersistence,
   createAnthropicAI,
   createMockAI,
   createMockGitHubAdapter,
@@ -55,6 +66,7 @@ export {
   extractSignals,
   fetchGitHubActivity,
   formatExocortexForPrompt,
+  formatPriorReadsForPrompt,
   formatScope,
   getLens,
   interpretPatterns,
@@ -62,6 +74,7 @@ export {
   isScored,
   isSentinel,
   listLenses,
+  loadPriorReads,
   parseRepoScope,
   presenceAverage,
   readExocortex,
@@ -71,5 +84,7 @@ export {
   scoreLife,
   scoreNeuroVerse,
   summarizeExocortex,
-  think
+  think,
+  updateKnowledge,
+  writeRead
 };