@neuroverseos/governance 0.8.0 → 0.9.0

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 / Agency / 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.
  *
- * Silently skips missing files. Returns whatever it finds. An exocortex
- * with only attention.md is still useful — partial context is better
- * than no context.
+ * 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. 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,193 @@ interface RenderOutput {
 }
 declare function render(input: RenderInput): RenderOutput;
 
+/**
+ * @neuroverseos/governance/radiant — extends (org-wide world sharing)
+ *
+ * Lets a repo declare worldmodels that live in another repo, so one
+ * source of truth can govern many repos. Auki has 51 repos — one
+ * `aukiNetwork/worlds` repo holds the canonical worldmodel, every
+ * other repo declares `extends: ["github:aukiNetwork/worlds"]`.
+ *
+ * Spec grammar:
+ *   github:OWNER/REPO               — latest default branch, repo root
+ *   github:OWNER/REPO@REF           — specific ref (branch, tag, or sha)
+ *   github:OWNER/REPO@REF:SUBPATH   — subpath inside the cloned repo
+ *   ./relative/path                 — local dir relative to repo root
+ *   /absolute/path                  — absolute local dir
+ *
+ * github: sources are shallow-cloned into ~/.neuroverse/cache/extends/<hash>/
+ * Cache is reused for 1 hour; set NEUROVERSE_REFRESH=1 to force refetch,
+ * or NEUROVERSE_NO_FETCH=1 to forbid network access (cache-or-nothing).
+ */
+interface ExtendsSpec {
+    raw: string;
+    kind: 'github' | 'local';
+    owner?: string;
+    repo?: string;
+    ref?: string;
+    subpath?: string;
+    path?: string;
+}
+interface ExtendsConfig {
+    extends?: string[];
+}
+interface ResolveResult {
+    spec: ExtendsSpec;
+    dir: string | null;
+    warning?: string;
+}
+type Fetcher = (spec: ExtendsSpec, destDir: string) => void;
+declare function loadExtendsConfig(repoDir: string): ExtendsConfig | null;
+declare function parseExtendsSpec(raw: string): ExtendsSpec | null;
+declare function getCacheDir(spec: ExtendsSpec, baseCacheDir?: string): string;
+declare function resolveExtendsSpec(spec: ExtendsSpec, repoDir: string, options?: {
+    cacheDir?: string;
+    fetcher?: Fetcher;
+    ttlMs?: number;
+    forceRefresh?: boolean;
+    noFetch?: boolean;
+    /** Suppress warnings when the remote source doesn't exist.
+     * Used by the org tier, where a missing <org>/worlds repo is the
+     * common case and should silently skip. */
+    silentOnMissing?: boolean;
+}): ResolveResult;
+/**
+ * Detect the conventional org-level worldmodel source from the current
+ * repo's git remote. Returns an ExtendsSpec pointing at `<owner>/worlds`
+ * on the same host, or null if:
+ *   - no git repo / no origin remote
+ *   - remote is on a non-GitHub host (v1 only supports github.com)
+ *   - the current repo IS the worlds repo (avoid self-loop)
+ *
+ * Example: in a repo with origin github.com/NeuroverseOS/foo, this
+ * returns a spec for `github:NeuroverseOS/worlds`. If that repo doesn't
+ * exist on GitHub, discovery's silentOnMissing flag swallows the failure
+ * so nothing noisy surfaces.
+ */
+declare function detectOrgExtendsSpec(repoDir: string): ExtendsSpec | null;
+declare function resolveAllExtends(repoDir: string, options?: {
+    cacheDir?: string;
+    fetcher?: Fetcher;
+    ttlMs?: number;
+    forceRefresh?: boolean;
+    noFetch?: boolean;
+    config?: ExtendsConfig | null;
+}): ResolveResult[];
+
+/**
+ * @neuroverseos/governance/radiant — world discovery
+ *
+ * Automatically discovers and loads worldmodels from five sources,
+ * in precedence order (later tiers override earlier ones):
+ *
+ *   1. NeuroVerse base (built-in, universal — always loaded)
+ *   2. User worlds (~/.neuroverse/worlds/ — your personal model)
+ *   3. Org worlds (github:<owner>/worlds for current repo's GitHub org — zero config)
+ *   4. Extends (declared in .neuroverse/config.json — explicit overrides)
+ *   5. 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.
+ *
+ * The org tier piggybacks on GitHub's existing org structure: discovery
+ * reads .git/config, extracts the owner from the origin remote, and
+ * probes `github:<owner>/worlds`. If the repo exists, its worldmodels
+ * load automatically — no per-repo config needed. Missing silently.
+ *
+ * The extends tier is the explicit override for non-conventional sources
+ * (private mirrors, local paths, alternate orgs).
+ */
+
+interface DiscoveredWorld {
+    name: string;
+    source: 'base' | 'user' | 'org' | 'extends' | 'repo';
+    path: string;
+    content: string;
+    /** For extends- and org-sourced worlds: the resolved spec. */
+    extendsFrom?: 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;
+    /** Non-fatal warnings (e.g. failed extends fetch, stale cache). */
+    warnings: 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.
+ * @param scopeOwner — GitHub org/owner hint derived from a CLI scope
+ *   argument (e.g. the "NeuroverseOS" in `radiant emergent NeuroverseOS/`).
+ *   When provided, discovery also probes `github:<scopeOwner>/worlds`
+ *   in the org tier. This lets the command work without a local clone —
+ *   the scope itself tells us which org's worlds to load.
+ */
+declare function discoverWorlds(options?: {
+    repoDir?: string;
+    userWorldsDir?: string;
+    explicitWorldsDir?: string;
+    scopeOwner?: string;
+    /** Override the extends cache location (default ~/.neuroverse/cache/extends/). */
+    extendsCacheDir?: string;
+    /** Inject a fetcher (tests use this to avoid real network calls). */
+    extendsFetcher?: Fetcher;
+    /** Cache TTL for github: extends (default 1 hour). */
+    extendsTtlMs?: number;
+    /** Disable extends resolution entirely. */
+    disableExtends?: boolean;
+    /** Disable org auto-detect tier. Also disabled by NEUROVERSE_NO_ORG=1. */
+    disableOrg?: boolean;
+}): WorldStack;
+/**
+ * Format the active worlds list for display in the output header.
+ */
+declare function formatActiveWorlds(stack: WorldStack): string;
+
+/**
+ * @neuroverseos/governance/radiant — git remote introspection
+ *
+ * Reads the current repo's origin remote and parses out the host/owner/repo.
+ * Used by the org-level discovery tier to ask "what GitHub org owns this
+ * repo?" and then look for a conventional <org>/worlds source of truth.
+ *
+ * Works for both `.git/` directories and `.git` files (git worktrees /
+ * submodules, which store a `gitdir: <path>` pointer instead of a full dir).
+ */
+interface ParsedRemote {
+    host: string;
+    owner: string;
+    repo: string;
+}
+/**
+ * Read the `origin` remote URL from a repo's git config.
+ * Returns null if no repo, no remote, or read fails.
+ */
+declare function readOriginRemote(repoDir: string): string | null;
+/**
+ * Parse a git remote URL into host/owner/repo.
+ *
+ * Supported forms:
+ *   https://github.com/OWNER/REPO(.git)
+ *   http://github.com/OWNER/REPO(.git)
+ *   git@github.com:OWNER/REPO(.git)
+ *   ssh://git@github.com/OWNER/REPO(.git)
+ */
+declare function parseRemoteUrl(url: string): ParsedRemote | null;
+/**
+ * One-shot: read origin and parse it.
+ */
+declare function getRepoOrigin(repoDir: string): ParsedRemote | null;
+
 /**
  * @neuroverseos/governance/radiant — Memory Palace file operations
  *
@@ -1377,6 +1592,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 +1749,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 +1792,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 ExtendsConfig, type ExtendsSpec, type ExtractionResult, type Fetcher, 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 ParsedRemote, type PatternEvidence, type PatternPersistence, type PrimaryFrame, type PriorRead, RADIANT_PACKAGE_VERSION, type RadiantAI, type RenderInput, type RenderOutput, type RenderingLens, type RepoScope, type ResolveResult, 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, detectOrgExtendsSpec, discoverWorlds, emergent, extractSignals, fetchDiscordActivity, fetchGitHubActivity, fetchGitHubOrgActivity, fetchNotionActivity, fetchSlackActivity, formatActiveWorlds, formatDiscordSignalsForPrompt, formatExocortexForPrompt, formatNotionSignalsForPrompt, formatPriorReadsForPrompt, formatScope, formatSlackSignalsForPrompt, formatTeamExocorticesForPrompt, getCacheDir, getLens, getRepoOrigin, interpretPatterns, isPresent, isScored, isSentinel, listLenses, loadExtendsConfig, loadPriorReads, parseExtendsSpec, parseRemoteUrl, parseRepoScope, parseScope, presenceAverage, readExocortex, readOriginRemote, readTeamExocortices, render, resolveAllExtends, resolveExtendsSpec, 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 / Agency / 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.
  *
- * Silently skips missing files. Returns whatever it finds. An exocortex
- * with only attention.md is still useful — partial context is better
- * than no context.
+ * 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. 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,193 @@ interface RenderOutput {
 }
 declare function render(input: RenderInput): RenderOutput;
 
+/**
+ * @neuroverseos/governance/radiant — extends (org-wide world sharing)
+ *
+ * Lets a repo declare worldmodels that live in another repo, so one
+ * source of truth can govern many repos. Auki has 51 repos — one
+ * `aukiNetwork/worlds` repo holds the canonical worldmodel, every
+ * other repo declares `extends: ["github:aukiNetwork/worlds"]`.
+ *
+ * Spec grammar:
+ *   github:OWNER/REPO               — latest default branch, repo root
+ *   github:OWNER/REPO@REF           — specific ref (branch, tag, or sha)
+ *   github:OWNER/REPO@REF:SUBPATH   — subpath inside the cloned repo
+ *   ./relative/path                 — local dir relative to repo root
+ *   /absolute/path                  — absolute local dir
+ *
+ * github: sources are shallow-cloned into ~/.neuroverse/cache/extends/<hash>/
+ * Cache is reused for 1 hour; set NEUROVERSE_REFRESH=1 to force refetch,
+ * or NEUROVERSE_NO_FETCH=1 to forbid network access (cache-or-nothing).
+ */
+interface ExtendsSpec {
+    raw: string;
+    kind: 'github' | 'local';
+    owner?: string;
+    repo?: string;
+    ref?: string;
+    subpath?: string;
+    path?: string;
+}
+interface ExtendsConfig {
+    extends?: string[];
+}
+interface ResolveResult {
+    spec: ExtendsSpec;
+    dir: string | null;
+    warning?: string;
+}
+type Fetcher = (spec: ExtendsSpec, destDir: string) => void;
+declare function loadExtendsConfig(repoDir: string): ExtendsConfig | null;
+declare function parseExtendsSpec(raw: string): ExtendsSpec | null;
+declare function getCacheDir(spec: ExtendsSpec, baseCacheDir?: string): string;
+declare function resolveExtendsSpec(spec: ExtendsSpec, repoDir: string, options?: {
+    cacheDir?: string;
+    fetcher?: Fetcher;
+    ttlMs?: number;
+    forceRefresh?: boolean;
+    noFetch?: boolean;
+    /** Suppress warnings when the remote source doesn't exist.
+     * Used by the org tier, where a missing <org>/worlds repo is the
+     * common case and should silently skip. */
+    silentOnMissing?: boolean;
+}): ResolveResult;
+/**
+ * Detect the conventional org-level worldmodel source from the current
+ * repo's git remote. Returns an ExtendsSpec pointing at `<owner>/worlds`
+ * on the same host, or null if:
+ *   - no git repo / no origin remote
+ *   - remote is on a non-GitHub host (v1 only supports github.com)
+ *   - the current repo IS the worlds repo (avoid self-loop)
+ *
+ * Example: in a repo with origin github.com/NeuroverseOS/foo, this
+ * returns a spec for `github:NeuroverseOS/worlds`. If that repo doesn't
+ * exist on GitHub, discovery's silentOnMissing flag swallows the failure
+ * so nothing noisy surfaces.
+ */
+declare function detectOrgExtendsSpec(repoDir: string): ExtendsSpec | null;
+declare function resolveAllExtends(repoDir: string, options?: {
+    cacheDir?: string;
+    fetcher?: Fetcher;
+    ttlMs?: number;
+    forceRefresh?: boolean;
+    noFetch?: boolean;
+    config?: ExtendsConfig | null;
+}): ResolveResult[];
+
+/**
+ * @neuroverseos/governance/radiant — world discovery
+ *
+ * Automatically discovers and loads worldmodels from five sources,
+ * in precedence order (later tiers override earlier ones):
+ *
+ *   1. NeuroVerse base (built-in, universal — always loaded)
+ *   2. User worlds (~/.neuroverse/worlds/ — your personal model)
+ *   3. Org worlds (github:<owner>/worlds for current repo's GitHub org — zero config)
+ *   4. Extends (declared in .neuroverse/config.json — explicit overrides)
+ *   5. 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.
+ *
+ * The org tier piggybacks on GitHub's existing org structure: discovery
+ * reads .git/config, extracts the owner from the origin remote, and
+ * probes `github:<owner>/worlds`. If the repo exists, its worldmodels
+ * load automatically — no per-repo config needed. Missing silently.
+ *
+ * The extends tier is the explicit override for non-conventional sources
+ * (private mirrors, local paths, alternate orgs).
+ */
+
+interface DiscoveredWorld {
+    name: string;
+    source: 'base' | 'user' | 'org' | 'extends' | 'repo';
+    path: string;
+    content: string;
+    /** For extends- and org-sourced worlds: the resolved spec. */
+    extendsFrom?: 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;
+    /** Non-fatal warnings (e.g. failed extends fetch, stale cache). */
+    warnings: 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.
+ * @param scopeOwner — GitHub org/owner hint derived from a CLI scope
+ *   argument (e.g. the "NeuroverseOS" in `radiant emergent NeuroverseOS/`).
+ *   When provided, discovery also probes `github:<scopeOwner>/worlds`
+ *   in the org tier. This lets the command work without a local clone —
+ *   the scope itself tells us which org's worlds to load.
+ */
+declare function discoverWorlds(options?: {
+    repoDir?: string;
+    userWorldsDir?: string;
+    explicitWorldsDir?: string;
+    scopeOwner?: string;
+    /** Override the extends cache location (default ~/.neuroverse/cache/extends/). */
+    extendsCacheDir?: string;
+    /** Inject a fetcher (tests use this to avoid real network calls). */
+    extendsFetcher?: Fetcher;
+    /** Cache TTL for github: extends (default 1 hour). */
+    extendsTtlMs?: number;
+    /** Disable extends resolution entirely. */
+    disableExtends?: boolean;
+    /** Disable org auto-detect tier. Also disabled by NEUROVERSE_NO_ORG=1. */
+    disableOrg?: boolean;
+}): WorldStack;
+/**
+ * Format the active worlds list for display in the output header.
+ */
+declare function formatActiveWorlds(stack: WorldStack): string;
+
+/**
+ * @neuroverseos/governance/radiant — git remote introspection
+ *
+ * Reads the current repo's origin remote and parses out the host/owner/repo.
+ * Used by the org-level discovery tier to ask "what GitHub org owns this
+ * repo?" and then look for a conventional <org>/worlds source of truth.
+ *
+ * Works for both `.git/` directories and `.git` files (git worktrees /
+ * submodules, which store a `gitdir: <path>` pointer instead of a full dir).
+ */
+interface ParsedRemote {
+    host: string;
+    owner: string;
+    repo: string;
+}
+/**
+ * Read the `origin` remote URL from a repo's git config.
+ * Returns null if no repo, no remote, or read fails.
+ */
+declare function readOriginRemote(repoDir: string): string | null;
+/**
+ * Parse a git remote URL into host/owner/repo.
+ *
+ * Supported forms:
+ *   https://github.com/OWNER/REPO(.git)
+ *   http://github.com/OWNER/REPO(.git)
+ *   git@github.com:OWNER/REPO(.git)
+ *   ssh://git@github.com/OWNER/REPO(.git)
+ */
+declare function parseRemoteUrl(url: string): ParsedRemote | null;
+/**
+ * One-shot: read origin and parse it.
+ */
+declare function getRepoOrigin(repoDir: string): ParsedRemote | null;
+
 /**
  * @neuroverseos/governance/radiant — Memory Palace file operations
  *
@@ -1377,6 +1592,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 +1749,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 +1792,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 ExtendsConfig, type ExtendsSpec, type ExtractionResult, type Fetcher, 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 ParsedRemote, type PatternEvidence, type PatternPersistence, type PrimaryFrame, type PriorRead, RADIANT_PACKAGE_VERSION, type RadiantAI, type RenderInput, type RenderOutput, type RenderingLens, type RepoScope, type ResolveResult, 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, detectOrgExtendsSpec, discoverWorlds, emergent, extractSignals, fetchDiscordActivity, fetchGitHubActivity, fetchGitHubOrgActivity, fetchNotionActivity, fetchSlackActivity, formatActiveWorlds, formatDiscordSignalsForPrompt, formatExocortexForPrompt, formatNotionSignalsForPrompt, formatPriorReadsForPrompt, formatScope, formatSlackSignalsForPrompt, formatTeamExocorticesForPrompt, getCacheDir, getLens, getRepoOrigin, interpretPatterns, isPresent, isScored, isSentinel, listLenses, loadExtendsConfig, loadPriorReads, parseExtendsSpec, parseRemoteUrl, parseRepoScope, parseScope, presenceAverage, readExocortex, readOriginRemote, readTeamExocortices, render, resolveAllExtends, resolveExtendsSpec, scoreComposite, scoreCyber, scoreLife, scoreNeuroVerse, sovereignConduitLens, summarizeExocortex, think, updateKnowledge, writeRead };