@neuroverseos/governance 0.8.0 → 0.8.1

package/dist/radiant/index.d.cts

@@ -544,6 +544,31 @@ declare function classifyActorDomain(event: Event): ActorDomain;
  */
 declare const aukiBuilderLens: RenderingLens;
 
+/**
+ * @neuroverseos/governance/radiant — Sovereign Conduit Lens
+ *
+ * The rendering lens for the NeuroVerseOS base worldmodel. Where the
+ * aukiBuilderLens encodes how Auki-grade builders think and speak,
+ * this lens encodes how the Sovereign Conduit thinks and speaks.
+ *
+ * The voice is fundamentally different from the builder lens:
+ *   - Warm, not compressed. Accessible, not technical.
+ *   - Analogies from everyday life (mom rules, friend's house, idea
+ *     calculator), not from architecture (stacks, bottlenecks, territory).
+ *   - Emotions named, not contained. When governance works, it feels
+ *     like trust. When it fails, it feels like being funneled. Say so.
+ *   - The audience is everyone — leaders, parents, people learning AI,
+ *     people who don't code. If a mom can't understand the output, the
+ *     voice is wrong.
+ *   - Teaching, not lecturing. Every output helps people think for
+ *     themselves. The difference: lecturing tells you what to think.
+ *     Teaching helps you think.
+ *
+ * Tagline: Humanity first. In constant learning. In shared teaching.
+ */
+
+declare const sovereignConduitLens: RenderingLens;
+
 /**
  * @neuroverseos/governance/radiant/lenses
  *
@@ -557,10 +582,9 @@ declare const aukiBuilderLens: RenderingLens;
  * registered set.
  *
  * Current registry:
- *   - auki-builder — Auki's vanguard leadership lens. Reason internally
- *     through Future Foresight / Narrative Dynamics / Shared Prosperity;
- *     express externally with the skill-level vocabulary inside each
- *     domain. See ./auki-builder.ts for the content.
+ *   - auki-builder — Auki's vanguard leadership lens.
+ *   - sovereign-conduit — NeuroVerseOS base lens. Warm, accessible,
+ *     teaching. Stewardship / Sovereignty / Integration.
  *
  * To add a new lens:
  *   1. Create src/radiant/lenses/<name>.ts exporting a `RenderingLens`.
@@ -924,13 +948,17 @@ interface ExocortexContext {
     filesLoaded: number;
 }
 /**
- * Read stated intent from an exocortex directory.
+ * Read stated intent from an exocortex directory, optionally scoped
+ * to a specific project.
+ *
+ * When a repoName is provided (e.g. "reconstruction-server"), the reader
+ * looks for a matching subdirectory in the exocortex (symlinked project
+ * repos in the Auki exocortex pattern) and reads project-specific
+ * sprint.md and roadmap.md alongside the global personal context.
  *
- * Silently skips missing files. Returns whatever it finds. An exocortex
- * with only attention.md is still useful — partial context is better
- * than no context.
+ * Silently skips missing files. Partial context is better than no context.
  */
-declare function readExocortex(dirPath: string): ExocortexContext;
+declare function readExocortex(dirPath: string, repoName?: string): ExocortexContext;
 /**
  * Format the exocortex context as a section for the AI interpretation
  * prompt. Only includes fields that were actually loaded.
@@ -1298,6 +1326,58 @@ interface RenderOutput {
 }
 declare function render(input: RenderInput): RenderOutput;
 
+/**
+ * @neuroverseos/governance/radiant — world discovery
+ *
+ * Automatically discovers and loads worldmodels from three sources,
+ * in precedence order:
+ *
+ *   1. NeuroVerse base (built-in, universal — always loaded)
+ *   2. User worlds (~/.neuroverse/worlds/ — your personal model)
+ *   3. Repo worlds (./worlds/ in the current repo — local authority)
+ *
+ * Worlds live where the work lives. You don't switch between them —
+ * you walk into them. Open an Auki repo → Auki's worlds load.
+ * Leave → they disappear. No toggle, no config, no removal.
+ *
+ * Precedence: repo > user > base. When you're in someone else's
+ * system, their worlds take authority. Your personal world stays
+ * as your baseline perspective. The NeuroVerse base is the universal
+ * foundation both sit on top of.
+ */
+interface DiscoveredWorld {
+    name: string;
+    source: 'base' | 'user' | 'repo';
+    path: string;
+    content: string;
+}
+interface WorldStack {
+    worlds: DiscoveredWorld[];
+    /** Combined content for the AI prompt (compressed by the caller). */
+    combinedContent: string;
+    /** Human-readable list of what's loaded. */
+    summary: string;
+}
+/**
+ * Discover and load worldmodels from all three sources.
+ *
+ * @param repoDir — the repo being analyzed (for repo-level worlds).
+ *   If not provided, skips repo-level discovery.
+ * @param userWorldsDir — override for user worlds location.
+ *   Default: ~/.neuroverse/worlds/
+ * @param explicitWorldsDir — explicit --worlds flag (overrides discovery).
+ *   When provided, this is used AS the repo-level source.
+ */
+declare function discoverWorlds(options?: {
+    repoDir?: string;
+    userWorldsDir?: string;
+    explicitWorldsDir?: string;
+}): WorldStack;
+/**
+ * Format the active worlds list for display in the output header.
+ */
+declare function formatActiveWorlds(stack: WorldStack): string;
+
 /**
  * @neuroverseos/governance/radiant — Memory Palace file operations
  *
@@ -1377,6 +1457,48 @@ declare function computePersistence(priorReads: PriorRead[], currentPatternNames
  */
 declare function formatPriorReadsForPrompt(priorReads: PriorRead[]): string;
 
+/**
+ * @neuroverseos/governance/radiant — Memory Palace compression
+ *
+ * Applies the three-tier principle to everything that enters the AI
+ * prompt: raw data is not the memory; structured signals are.
+ *
+ * Compresses worldmodel content, exocortex context, lens data, and
+ * prior reads into the minimum tokens the AI needs to produce a
+ * good interpretation. Cuts prompt size by 60-70%.
+ */
+
+/**
+ * Compress a worldmodel markdown file into just the structured elements
+ * the AI needs: invariants, decision priorities, signals, domains,
+ * and mission (one line). Strips prose, commentary, and structure.
+ */
+declare function compressWorldmodel(content: string): string;
+/**
+ * Compress exocortex context into one-line summaries per field.
+ * The AI doesn't need the full prose — just the essence.
+ */
+declare function compressExocortex(ctx: ExocortexContext): string;
+/**
+ * Compress a rendering lens into just what the AI interpreter needs:
+ * evaluation questions + forbidden phrases + jargon translations.
+ * Vocabulary substitutions and voice directives go to the renderer,
+ * not the interpreter.
+ */
+declare function compressLens(lens: RenderingLens): {
+    evaluationQuestions: string;
+    scoringRubric: string;
+    forbiddenPhrases: string;
+    jargonTranslations: string;
+    strategicPatterns: string;
+};
+/**
+ * Compress prior reads into pattern names + occurrence counts.
+ * The AI needs to know WHAT was seen before and HOW OFTEN — not the
+ * full frontmatter.
+ */
+declare function compressPriorReads(reads: PriorRead[]): string;
+
 /**
  * @neuroverseos/governance/radiant — `think` command
  *
@@ -1492,6 +1614,10 @@ interface EmergentResult {
     };
     /** Event count fetched from GitHub. */
     eventCount: number;
+    /** Active adapters used in this read. */
+    activeAdapters?: string[];
+    /** World stack — what worlds were discovered and loaded. */
+    worldStack?: WorldStack;
 }
 declare function emergent(input: EmergentInput): Promise<EmergentResult>;
 
@@ -1531,4 +1657,4 @@ declare function emergent(input: EmergentInput): Promise<EmergentResult>;
  */
 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 DiscordFetchOptions, type DiscordSignals, 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 NotionFetchOptions, type NotionSignals, type ObservedPattern, type OrgScope, type OverlapDef, type PatternEvidence, type PatternPersistence, type PrimaryFrame, type PriorRead, RADIANT_PACKAGE_VERSION, type RadiantAI, type RenderInput, type RenderOutput, type RenderingLens, type RepoScope, type Scope, type Score, type ScoreSentinel, type ScoredObservation, type Signal, type SignalExtractor, type SignalMatrix, type SlackFetchOptions, type SlackSignals, type ThinkInput, type ThinkResult, type ViewLevel, type VoiceDirectives, type VoiceViolation, type WorldmodelItem, auditGovernance, aukiBuilderLens, checkForbiddenPhrases, classifyActorDomain, classifyEvents, composeSystemPrompt, computePersistence, createAnthropicAI, createMockAI, createMockGitHubAdapter, emergent, extractSignals, fetchDiscordActivity, fetchGitHubActivity, fetchGitHubOrgActivity, fetchNotionActivity, fetchSlackActivity, formatDiscordSignalsForPrompt, formatExocortexForPrompt, formatNotionSignalsForPrompt, formatPriorReadsForPrompt, formatScope, formatSlackSignalsForPrompt, formatTeamExocorticesForPrompt, getLens, interpretPatterns, isPresent, isScored, isSentinel, listLenses, loadPriorReads, parseRepoScope, parseScope, presenceAverage, readExocortex, readTeamExocortices, render, scoreComposite, scoreCyber, scoreLife, scoreNeuroVerse, summarizeExocortex, think, updateKnowledge, writeRead };
+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 DiscordFetchOptions, type DiscordSignals, type DiscoveredWorld, 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 NotionFetchOptions, type NotionSignals, type ObservedPattern, type OrgScope, type OverlapDef, type PatternEvidence, type PatternPersistence, type PrimaryFrame, type PriorRead, RADIANT_PACKAGE_VERSION, type RadiantAI, type RenderInput, type RenderOutput, type RenderingLens, type RepoScope, type Scope, type Score, type ScoreSentinel, type ScoredObservation, type Signal, type SignalExtractor, type SignalMatrix, type SlackFetchOptions, type SlackSignals, type ThinkInput, type ThinkResult, type ViewLevel, type VoiceDirectives, type VoiceViolation, type WorldStack, type WorldmodelItem, auditGovernance, aukiBuilderLens, checkForbiddenPhrases, classifyActorDomain, classifyEvents, composeSystemPrompt, compressExocortex, compressLens, compressPriorReads, compressWorldmodel, computePersistence, createAnthropicAI, createMockAI, createMockGitHubAdapter, discoverWorlds, emergent, extractSignals, fetchDiscordActivity, fetchGitHubActivity, fetchGitHubOrgActivity, fetchNotionActivity, fetchSlackActivity, formatActiveWorlds, formatDiscordSignalsForPrompt, formatExocortexForPrompt, formatNotionSignalsForPrompt, formatPriorReadsForPrompt, formatScope, formatSlackSignalsForPrompt, formatTeamExocorticesForPrompt, getLens, interpretPatterns, isPresent, isScored, isSentinel, listLenses, loadPriorReads, parseRepoScope, parseScope, presenceAverage, readExocortex, readTeamExocortices, render, scoreComposite, scoreCyber, scoreLife, scoreNeuroVerse, sovereignConduitLens, summarizeExocortex, think, updateKnowledge, writeRead };

package/dist/radiant/index.d.ts

@@ -544,6 +544,31 @@ declare function classifyActorDomain(event: Event): ActorDomain;
  */
 declare const aukiBuilderLens: RenderingLens;
 
+/**
+ * @neuroverseos/governance/radiant — Sovereign Conduit Lens
+ *
+ * The rendering lens for the NeuroVerseOS base worldmodel. Where the
+ * aukiBuilderLens encodes how Auki-grade builders think and speak,
+ * this lens encodes how the Sovereign Conduit thinks and speaks.
+ *
+ * The voice is fundamentally different from the builder lens:
+ *   - Warm, not compressed. Accessible, not technical.
+ *   - Analogies from everyday life (mom rules, friend's house, idea
+ *     calculator), not from architecture (stacks, bottlenecks, territory).
+ *   - Emotions named, not contained. When governance works, it feels
+ *     like trust. When it fails, it feels like being funneled. Say so.
+ *   - The audience is everyone — leaders, parents, people learning AI,
+ *     people who don't code. If a mom can't understand the output, the
+ *     voice is wrong.
+ *   - Teaching, not lecturing. Every output helps people think for
+ *     themselves. The difference: lecturing tells you what to think.
+ *     Teaching helps you think.
+ *
+ * Tagline: Humanity first. In constant learning. In shared teaching.
+ */
+
+declare const sovereignConduitLens: RenderingLens;
+
 /**
  * @neuroverseos/governance/radiant/lenses
  *
@@ -557,10 +582,9 @@ declare const aukiBuilderLens: RenderingLens;
  * registered set.
  *
  * Current registry:
- *   - auki-builder — Auki's vanguard leadership lens. Reason internally
- *     through Future Foresight / Narrative Dynamics / Shared Prosperity;
- *     express externally with the skill-level vocabulary inside each
- *     domain. See ./auki-builder.ts for the content.
+ *   - auki-builder — Auki's vanguard leadership lens.
+ *   - sovereign-conduit — NeuroVerseOS base lens. Warm, accessible,
+ *     teaching. Stewardship / Sovereignty / Integration.
  *
  * To add a new lens:
  *   1. Create src/radiant/lenses/<name>.ts exporting a `RenderingLens`.
@@ -924,13 +948,17 @@ interface ExocortexContext {
     filesLoaded: number;
 }
 /**
- * Read stated intent from an exocortex directory.
+ * Read stated intent from an exocortex directory, optionally scoped
+ * to a specific project.
+ *
+ * When a repoName is provided (e.g. "reconstruction-server"), the reader
+ * looks for a matching subdirectory in the exocortex (symlinked project
+ * repos in the Auki exocortex pattern) and reads project-specific
+ * sprint.md and roadmap.md alongside the global personal context.
  *
- * Silently skips missing files. Returns whatever it finds. An exocortex
- * with only attention.md is still useful — partial context is better
- * than no context.
+ * Silently skips missing files. Partial context is better than no context.
  */
-declare function readExocortex(dirPath: string): ExocortexContext;
+declare function readExocortex(dirPath: string, repoName?: string): ExocortexContext;
 /**
  * Format the exocortex context as a section for the AI interpretation
  * prompt. Only includes fields that were actually loaded.
@@ -1298,6 +1326,58 @@ interface RenderOutput {
 }
 declare function render(input: RenderInput): RenderOutput;
 
+/**
+ * @neuroverseos/governance/radiant — world discovery
+ *
+ * Automatically discovers and loads worldmodels from three sources,
+ * in precedence order:
+ *
+ *   1. NeuroVerse base (built-in, universal — always loaded)
+ *   2. User worlds (~/.neuroverse/worlds/ — your personal model)
+ *   3. Repo worlds (./worlds/ in the current repo — local authority)
+ *
+ * Worlds live where the work lives. You don't switch between them —
+ * you walk into them. Open an Auki repo → Auki's worlds load.
+ * Leave → they disappear. No toggle, no config, no removal.
+ *
+ * Precedence: repo > user > base. When you're in someone else's
+ * system, their worlds take authority. Your personal world stays
+ * as your baseline perspective. The NeuroVerse base is the universal
+ * foundation both sit on top of.
+ */
+interface DiscoveredWorld {
+    name: string;
+    source: 'base' | 'user' | 'repo';
+    path: string;
+    content: string;
+}
+interface WorldStack {
+    worlds: DiscoveredWorld[];
+    /** Combined content for the AI prompt (compressed by the caller). */
+    combinedContent: string;
+    /** Human-readable list of what's loaded. */
+    summary: string;
+}
+/**
+ * Discover and load worldmodels from all three sources.
+ *
+ * @param repoDir — the repo being analyzed (for repo-level worlds).
+ *   If not provided, skips repo-level discovery.
+ * @param userWorldsDir — override for user worlds location.
+ *   Default: ~/.neuroverse/worlds/
+ * @param explicitWorldsDir — explicit --worlds flag (overrides discovery).
+ *   When provided, this is used AS the repo-level source.
+ */
+declare function discoverWorlds(options?: {
+    repoDir?: string;
+    userWorldsDir?: string;
+    explicitWorldsDir?: string;
+}): WorldStack;
+/**
+ * Format the active worlds list for display in the output header.
+ */
+declare function formatActiveWorlds(stack: WorldStack): string;
+
 /**
  * @neuroverseos/governance/radiant — Memory Palace file operations
  *
@@ -1377,6 +1457,48 @@ declare function computePersistence(priorReads: PriorRead[], currentPatternNames
  */
 declare function formatPriorReadsForPrompt(priorReads: PriorRead[]): string;
 
+/**
+ * @neuroverseos/governance/radiant — Memory Palace compression
+ *
+ * Applies the three-tier principle to everything that enters the AI
+ * prompt: raw data is not the memory; structured signals are.
+ *
+ * Compresses worldmodel content, exocortex context, lens data, and
+ * prior reads into the minimum tokens the AI needs to produce a
+ * good interpretation. Cuts prompt size by 60-70%.
+ */
+
+/**
+ * Compress a worldmodel markdown file into just the structured elements
+ * the AI needs: invariants, decision priorities, signals, domains,
+ * and mission (one line). Strips prose, commentary, and structure.
+ */
+declare function compressWorldmodel(content: string): string;
+/**
+ * Compress exocortex context into one-line summaries per field.
+ * The AI doesn't need the full prose — just the essence.
+ */
+declare function compressExocortex(ctx: ExocortexContext): string;
+/**
+ * Compress a rendering lens into just what the AI interpreter needs:
+ * evaluation questions + forbidden phrases + jargon translations.
+ * Vocabulary substitutions and voice directives go to the renderer,
+ * not the interpreter.
+ */
+declare function compressLens(lens: RenderingLens): {
+    evaluationQuestions: string;
+    scoringRubric: string;
+    forbiddenPhrases: string;
+    jargonTranslations: string;
+    strategicPatterns: string;
+};
+/**
+ * Compress prior reads into pattern names + occurrence counts.
+ * The AI needs to know WHAT was seen before and HOW OFTEN — not the
+ * full frontmatter.
+ */
+declare function compressPriorReads(reads: PriorRead[]): string;
+
 /**
  * @neuroverseos/governance/radiant — `think` command
  *
@@ -1492,6 +1614,10 @@ interface EmergentResult {
     };
     /** Event count fetched from GitHub. */
     eventCount: number;
+    /** Active adapters used in this read. */
+    activeAdapters?: string[];
+    /** World stack — what worlds were discovered and loaded. */
+    worldStack?: WorldStack;
 }
 declare function emergent(input: EmergentInput): Promise<EmergentResult>;
 
@@ -1531,4 +1657,4 @@ declare function emergent(input: EmergentInput): Promise<EmergentResult>;
  */
 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 DiscordFetchOptions, type DiscordSignals, 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 NotionFetchOptions, type NotionSignals, type ObservedPattern, type OrgScope, type OverlapDef, type PatternEvidence, type PatternPersistence, type PrimaryFrame, type PriorRead, RADIANT_PACKAGE_VERSION, type RadiantAI, type RenderInput, type RenderOutput, type RenderingLens, type RepoScope, type Scope, type Score, type ScoreSentinel, type ScoredObservation, type Signal, type SignalExtractor, type SignalMatrix, type SlackFetchOptions, type SlackSignals, type ThinkInput, type ThinkResult, type ViewLevel, type VoiceDirectives, type VoiceViolation, type WorldmodelItem, auditGovernance, aukiBuilderLens, checkForbiddenPhrases, classifyActorDomain, classifyEvents, composeSystemPrompt, computePersistence, createAnthropicAI, createMockAI, createMockGitHubAdapter, emergent, extractSignals, fetchDiscordActivity, fetchGitHubActivity, fetchGitHubOrgActivity, fetchNotionActivity, fetchSlackActivity, formatDiscordSignalsForPrompt, formatExocortexForPrompt, formatNotionSignalsForPrompt, formatPriorReadsForPrompt, formatScope, formatSlackSignalsForPrompt, formatTeamExocorticesForPrompt, getLens, interpretPatterns, isPresent, isScored, isSentinel, listLenses, loadPriorReads, parseRepoScope, parseScope, presenceAverage, readExocortex, readTeamExocortices, render, scoreComposite, scoreCyber, scoreLife, scoreNeuroVerse, summarizeExocortex, think, updateKnowledge, writeRead };
+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 DiscordFetchOptions, type DiscordSignals, type DiscoveredWorld, 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 NotionFetchOptions, type NotionSignals, type ObservedPattern, type OrgScope, type OverlapDef, type PatternEvidence, type PatternPersistence, type PrimaryFrame, type PriorRead, RADIANT_PACKAGE_VERSION, type RadiantAI, type RenderInput, type RenderOutput, type RenderingLens, type RepoScope, type Scope, type Score, type ScoreSentinel, type ScoredObservation, type Signal, type SignalExtractor, type SignalMatrix, type SlackFetchOptions, type SlackSignals, type ThinkInput, type ThinkResult, type ViewLevel, type VoiceDirectives, type VoiceViolation, type WorldStack, type WorldmodelItem, auditGovernance, aukiBuilderLens, checkForbiddenPhrases, classifyActorDomain, classifyEvents, composeSystemPrompt, compressExocortex, compressLens, compressPriorReads, compressWorldmodel, computePersistence, createAnthropicAI, createMockAI, createMockGitHubAdapter, discoverWorlds, emergent, extractSignals, fetchDiscordActivity, fetchGitHubActivity, fetchGitHubOrgActivity, fetchNotionActivity, fetchSlackActivity, formatActiveWorlds, formatDiscordSignalsForPrompt, formatExocortexForPrompt, formatNotionSignalsForPrompt, formatPriorReadsForPrompt, formatScope, formatSlackSignalsForPrompt, formatTeamExocorticesForPrompt, getLens, interpretPatterns, isPresent, isScored, isSentinel, listLenses, loadPriorReads, parseRepoScope, parseScope, presenceAverage, readExocortex, readTeamExocortices, render, scoreComposite, scoreCyber, scoreLife, scoreNeuroVerse, sovereignConduitLens, summarizeExocortex, think, updateKnowledge, writeRead };