@neuroverseos/governance 0.8.1 → 0.9.0

package/dist/radiant/index.d.cts

@@ -584,7 +584,7 @@ declare const sovereignConduitLens: RenderingLens;
  * Current registry:
  *   - auki-builder — Auki's vanguard leadership lens.
  *   - sovereign-conduit — NeuroVerseOS base lens. Warm, accessible,
- *     teaching. Stewardship / Sovereignty / Integration.
+ *     teaching. Stewardship / Agency / Integration.
  *
  * To add a new lens:
  *   1. Create src/radiant/lenses/<name>.ts exporting a `RenderingLens`.
@@ -1326,30 +1326,112 @@ 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 three sources,
- * in precedence order:
+ * 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. Repo worlds (./worlds/ in the current repo — local authority)
+ *   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.
  *
- * 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.
+ * 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' | 'repo';
+    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[];
@@ -1357,6 +1439,8 @@ interface WorldStack {
     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.
@@ -1367,17 +1451,68 @@ interface WorldStack {
  *   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
  *
@@ -1657,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 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 };
+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

@@ -584,7 +584,7 @@ declare const sovereignConduitLens: RenderingLens;
  * Current registry:
  *   - auki-builder — Auki's vanguard leadership lens.
  *   - sovereign-conduit — NeuroVerseOS base lens. Warm, accessible,
- *     teaching. Stewardship / Sovereignty / Integration.
+ *     teaching. Stewardship / Agency / Integration.
  *
  * To add a new lens:
  *   1. Create src/radiant/lenses/<name>.ts exporting a `RenderingLens`.
@@ -1326,30 +1326,112 @@ 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 three sources,
- * in precedence order:
+ * 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. Repo worlds (./worlds/ in the current repo — local authority)
+ *   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.
  *
- * 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.
+ * 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' | 'repo';
+    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[];
@@ -1357,6 +1439,8 @@ interface WorldStack {
     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.
@@ -1367,17 +1451,68 @@ interface WorldStack {
  *   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
  *
@@ -1657,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 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 };
+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.js

@@ -14,6 +14,7 @@ import {
   createAnthropicAI,
   createMockAI,
   createMockGitHubAdapter,
+  detectOrgExtendsSpec,
   discoverWorlds,
   emergent,
   extractSignals,
@@ -30,17 +31,25 @@ import {
   formatScope,
   formatSlackSignalsForPrompt,
   formatTeamExocorticesForPrompt,
+  getCacheDir,
+  getRepoOrigin,
   interpretPatterns,
   isPresent,
   isScored,
   isSentinel,
+  loadExtendsConfig,
   loadPriorReads,
+  parseExtendsSpec,
+  parseRemoteUrl,
   parseRepoScope,
   parseScope,
   presenceAverage,
   readExocortex,
+  readOriginRemote,
   readTeamExocortices,
   render,
+  resolveAllExtends,
+  resolveExtendsSpec,
   scoreComposite,
   scoreCyber,
   scoreLife,
@@ -49,14 +58,14 @@ import {
   think,
   updateKnowledge,
   writeRead
-} from "../chunk-ETDIEVAX.js";
+} from "../chunk-3ZWU7C43.js";
 import {
   LENSES,
   aukiBuilderLens,
   getLens,
   listLenses,
   sovereignConduitLens
-} from "../chunk-F2LWMOM5.js";
+} from "../chunk-TCGGED4G.js";
 import "../chunk-I4RTIMLX.js";
 import "../chunk-ZAF6JH23.js";
 import "../chunk-QLPTHTVB.js";
@@ -83,6 +92,7 @@ export {
   createAnthropicAI,
   createMockAI,
   createMockGitHubAdapter,
+  detectOrgExtendsSpec,
   discoverWorlds,
   emergent,
   extractSignals,
@@ -99,19 +109,27 @@ export {
   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,

package/dist/{server-ZSQ6DRSN.js → server-JKUBUK5H.js}

@@ -3,8 +3,8 @@ import {
   emergent,
   parseRepoScope,
   think
-} from "./chunk-ETDIEVAX.js";
-import "./chunk-F2LWMOM5.js";
+} from "./chunk-3ZWU7C43.js";
+import "./chunk-TCGGED4G.js";
 import "./chunk-I4RTIMLX.js";
 import "./chunk-ZAF6JH23.js";
 import "./chunk-QLPTHTVB.js";

package/examples/radiant-weekly-workflow.yml

@@ -0,0 +1,81 @@
+# Weekly Radiant Read — GitHub Actions workflow template
+#
+# Copy this file into your org's exocortex repo at:
+#   .github/workflows/radiant-weekly.yml
+#
+# Every Monday at 9am UTC it:
+#   1. Checks out this repo (the exocortex — where reads persist)
+#   2. Runs `radiant emergent <your-org>/` against the latest 14 days of activity
+#   3. Writes the read to radiant/reads/YYYY-MM-DD.md
+#   4. Commits and pushes the new file
+#
+# Each run extends the palace history. Week over week, Radiant gains the
+# baselines / drift detection / pattern confidence promised in the DEPTH
+# section of the output.
+#
+# Required repo secrets:
+#   ANTHROPIC_API_KEY    — for the MEANING/MOVE interpretation step
+#
+# Required repo settings:
+#   Settings → Actions → General → Workflow permissions → "Read and write"
+#   (so the job can push its own commit)
+#
+# Optional:
+#   Replace the hardcoded org (NeuroverseOS) with your own.
+#   Replace the lens (sovereign-conduit) with your chosen lens.
+
+name: Weekly Radiant Read
+
+on:
+  schedule:
+    # Monday at 09:00 UTC. Change to whatever rhythm your team uses.
+    - cron: '0 9 * * MON'
+  # Allow manual trigger from the Actions tab for testing.
+  workflow_dispatch:
+
+permissions:
+  contents: write  # needed to push the new read back into this repo
+
+jobs:
+  read:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out this exocortex repo
+        uses: actions/checkout@v4
+
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install @neuroverseos/governance
+        run: npm install --no-save @neuroverseos/governance@latest
+
+      - name: Run Radiant emergent read
+        env:
+          # GITHUB_TOKEN is auto-provided by Actions and is enough to read the
+          # NeuroverseOS org's public repos. For private repo reads, replace
+          # with a fine-grained PAT stored in secrets.RADIANT_GITHUB_TOKEN.
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          # Memory Palace writes into THIS repo — since we checked it out at
+          # the workflow root, point the CLI at $GITHUB_WORKSPACE.
+          RADIANT_EXOCORTEX: ${{ github.workspace }}
+        run: |
+          npx @neuroverseos/governance@latest radiant emergent NeuroverseOS/ \
+            --lens sovereign-conduit
+          # No --worlds flag needed — discovery probes NeuroverseOS/worlds
+          # directly from the scope arg. See the governance repo for details.
+
+      - name: Commit and push the new read
+        run: |
+          git config user.name  'radiant-bot'
+          git config user.email 'radiant-bot@users.noreply.github.com'
+          # Only commit if the read actually produced a file.
+          if [[ -n "$(git status --porcelain radiant/reads/)" ]]; then
+            git add radiant/reads/
+            git commit -m "radiant: weekly read $(date -u +%Y-%m-%d)"
+            git push
+          else
+            echo "No new read file produced — nothing to commit."
+          fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neuroverseos/governance",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "Deterministic governance engine for AI agents — enforce worlds (permanent rules) and plans (mission constraints) with full audit trace",
   "license": "Apache-2.0",
   "type": "module",
@@ -114,6 +114,7 @@
     "dist/browser.global.js",
     "policies",
     "examples/social-media-sim",
+    "examples/radiant-weekly-workflow.yml",
     "simulate.html",
     "LICENSE.md",
     "README.md",