@neuroverseos/governance 0.7.0 → 0.8.0

package/dist/radiant/index.d.cts

@@ -777,31 +777,56 @@ declare function createMockAI(fixedResponse: string): RadiantAI;
 /**
  * @neuroverseos/governance/radiant — scope resolution
  *
- * Parses scope strings like "aukiverse/posemesh" into typed scope objects
- * that adapters (GitHub, etc.) know how to fetch.
+ * Parses scope strings into typed scope objects that adapters know how
+ * to fetch. Supports two levels:
+ *
+ *   "owner/repo"  → RepoScope (single repo)
+ *   "owner/"      → OrgScope (entire organization)
+ *   "owner"       → OrgScope (entire organization)
  */
 /**
- * A GitHub repository scope — the unit of activity Radiant reads.
+ * A GitHub repository scope — single repo.
  */
 interface RepoScope {
+    type: 'repo';
     owner: string;
     repo: string;
 }
 /**
- * Parse a scope string into a RepoScope.
+ * A GitHub organization scope — all repos in an org.
+ */
+interface OrgScope {
+    type: 'org';
+    owner: string;
+}
+type Scope = RepoScope | OrgScope;
+/**
+ * Visibility level for a Radiant read. Controls what sources are
+ * included and where output goes.
  *
- * Accepts:
- *   "owner/repo"
- *   "https://github.com/owner/repo"
- *   "github.com/owner/repo"
+ *   community — public repos + public Discord. Anyone can reproduce.
+ *   team      — public + private repos + team channels. Team exocortex.
+ *   full      — everything + cross-exocortex. Leader's personal exocortex.
+ */
+type ViewLevel = 'community' | 'team' | 'full';
+/**
+ * Parse a scope string into a RepoScope or OrgScope.
  *
- * Throws on unparseable input.
+ * Accepts:
+ *   "owner/repo"                    → RepoScope
+ *   "owner/" or "owner"             → OrgScope
+ *   "https://github.com/owner/repo" → RepoScope
+ *   "https://github.com/owner"      → OrgScope
+ */
+declare function parseScope(scope: string): Scope;
+/**
+ * Backward-compatible: parse as RepoScope only. Throws if org-level.
  */
 declare function parseRepoScope(scope: string): RepoScope;
 /**
- * Format a RepoScope back to a display string.
+ * Format any scope back to a display string.
  */
-declare function formatScope(scope: RepoScope): string;
+declare function formatScope(scope: Scope): string;
 
 /**
  * @neuroverseos/governance/radiant — GitHub activity adapter
@@ -844,6 +869,15 @@ interface GitHubFetchOptions {
  * @param options — window size and pagination
  */
 declare function fetchGitHubActivity(scope: RepoScope, token: string, options?: GitHubFetchOptions): Promise<Event[]>;
+/**
+ * Fetch recent activity across an ENTIRE GitHub organization.
+ * Uses /orgs/{org}/repos to list repos, then fetches activity from
+ * each active repo.
+ */
+declare function fetchGitHubOrgActivity(scope: OrgScope, token: string, options?: GitHubFetchOptions): Promise<{
+    events: Event[];
+    repos: string[];
+}>;
 /**
  * Create a mock GitHub adapter for testing. Returns fixed events
  * without calling the GitHub API.
@@ -902,11 +936,210 @@ declare function readExocortex(dirPath: string): ExocortexContext;
  * prompt. Only includes fields that were actually loaded.
  */
 declare function formatExocortexForPrompt(ctx: ExocortexContext): string;
+/**
+ * Read multiple exocortices from a team directory. Each subdirectory
+ * (or symlink) is treated as one person's exocortex.
+ *
+ * Returns an array of { name, context } for each person.
+ */
+declare function readTeamExocortices(teamDir: string): Array<{
+    name: string;
+    context: ExocortexContext;
+}>;
+/**
+ * Format multiple exocortices for the AI prompt — shows each person's
+ * stated intent so the AI can compare them against each other and
+ * against observed activity.
+ */
+declare function formatTeamExocorticesForPrompt(team: Array<{
+    name: string;
+    context: ExocortexContext;
+}>): string;
 /**
  * One-line summary of what was loaded, for CLI status output.
  */
 declare function summarizeExocortex(ctx: ExocortexContext): string;
 
+/**
+ * @neuroverseos/governance/radiant — Discord adapter
+ *
+ * Reads conversational activity from Discord channels and maps it to
+ * Radiant's Event type. This is where Narrative Dynamics and Shared
+ * Prosperity signals become visible — how the team communicates,
+ * coordinates, welcomes newcomers, resolves debates.
+ *
+ * Two modes:
+ *   - Channel message reading (via Discord Bot API)
+ *   - Signal compression (aggregate metrics from raw messages)
+ *
+ * Privacy:
+ *   - Public channels → community view (anyone can reproduce)
+ *   - Team channels → team view (team exocortex only)
+ *   - Private channels / DMs → never read unless explicitly configured
+ *   - The bot token IS consent. Radiant respects Discord's permissions.
+ *
+ * Rate limiting:
+ *   - Caps at 100 messages per channel per fetch
+ *   - Produces compressed signals, not raw message dumps
+ *   - AI receives a sample of 20-30 representative messages, not the firehose
+ */
+
+interface DiscordFetchOptions {
+    /** Channel IDs to read from. If empty, reads all accessible channels. */
+    channelIds?: string[];
+    /** How many days of history to fetch. Default: 14. */
+    windowDays?: number;
+    /** Max messages per channel. Default: 100. */
+    perChannel?: number;
+    /** Visibility level — determines which channels to read. */
+    visibility?: 'public' | 'team';
+}
+interface DiscordSignals {
+    /** Total messages across all channels in the window. */
+    totalMessages: number;
+    /** Number of active channels. */
+    activeChannels: number;
+    /** Unique participants. */
+    uniqueParticipants: number;
+    /** Average response time in minutes (for threaded/reply messages). */
+    avgResponseMinutes: number | null;
+    /** Number of help requests detected (messages containing "help", "stuck", "how do I"). */
+    helpRequests: number;
+    /** Number of unresolved threads (threads with no reply). */
+    unresolvedThreads: number;
+    /** Top discussed topics (extracted from channel names + frequent terms). */
+    topTopics: string[];
+    /** Messages from new participants (first seen in this window). */
+    newcomerMessages: number;
+}
+/**
+ * Fetch Discord activity and return Radiant Events + compressed signals.
+ *
+ * Uses the Discord Bot API (raw fetch, no SDK dependency).
+ * Requires a bot token with MESSAGE_CONTENT intent enabled.
+ */
+declare function fetchDiscordActivity(guildId: string, token: string, options?: DiscordFetchOptions): Promise<{
+    events: Event[];
+    signals: DiscordSignals;
+}>;
+/**
+ * Format Discord signals for the AI interpretation prompt.
+ */
+declare function formatDiscordSignalsForPrompt(signals: DiscordSignals): string;
+
+/**
+ * @neuroverseos/governance/radiant — Slack adapter
+ *
+ * Reads conversational activity from Slack workspaces. For Auki, Slack
+ * is used for external client and partner communication — FairPrice,
+ * retail pilots, Intercognitive coalition partners.
+ *
+ * What it captures:
+ *   - Partner coordination patterns (peaq, Mawari, GEODNET)
+ *   - Client communication quality (responsiveness, follow-through)
+ *   - External contributor onboarding
+ *   - Cross-organization alignment signals
+ *   - Decision-making in channels (debates → outcomes)
+ *
+ * Privacy: workspace token controls access. Bot tokens see channels
+ * the bot is invited to. User tokens see what the user sees. Private
+ * channels and DMs only accessible if explicitly configured.
+ *
+ * Uses Slack Web API via raw fetch (no SDK dependency).
+ * Requires a Bot Token with channels:history + channels:read scopes.
+ */
+
+interface SlackFetchOptions {
+    /** Channel IDs to read. If empty, reads all public channels the bot can see. */
+    channelIds?: string[];
+    /** How many days of history to fetch. Default: 14. */
+    windowDays?: number;
+    /** Max messages per channel. Default: 100. */
+    perChannel?: number;
+    /** Visibility level. */
+    visibility?: 'public' | 'team';
+}
+interface SlackSignals {
+    totalMessages: number;
+    activeChannels: number;
+    uniqueParticipants: number;
+    avgResponseMinutes: number | null;
+    externalParticipants: number;
+    unresolvedThreads: number;
+    topChannels: string[];
+    reactionCount: number;
+}
+/**
+ * Fetch Slack activity and return Radiant Events + compressed signals.
+ */
+declare function fetchSlackActivity(token: string, options?: SlackFetchOptions): Promise<{
+    events: Event[];
+    signals: SlackSignals;
+}>;
+/**
+ * Format Slack signals for the AI interpretation prompt.
+ */
+declare function formatSlackSignalsForPrompt(signals: SlackSignals): string;
+
+/**
+ * @neuroverseos/governance/radiant — Notion adapter
+ *
+ * Reads documentation and knowledge-base activity from Notion.
+ * For Auki, Notion is where team documentation lives — specs, meeting
+ * notes, strategy docs, project plans, decision records.
+ *
+ * What it captures:
+ *   - Documentation freshness (when pages were last edited)
+ *   - Who maintains what (authorship patterns across pages)
+ *   - Knowledge gaps (sprint mentions things that have no doc page)
+ *   - Decision crystallization (are debates in Discord becoming docs in Notion?)
+ *   - Documentation velocity alongside code velocity
+ *
+ * The behavioral signal: high code shipping + low documentation =
+ * the team is building but not recording what they learn. That's a
+ * Narrative Dynamics gap — the story of what's being built isn't
+ * being told, even internally.
+ *
+ * Uses Notion API v1 via raw fetch (no SDK dependency).
+ * Requires an internal integration token with read access.
+ */
+
+interface NotionFetchOptions {
+    /** Specific database IDs to query. If empty, searches all accessible pages. */
+    databaseIds?: string[];
+    /** How many days of history to fetch. Default: 14. */
+    windowDays?: number;
+    /** Max pages to fetch. Default: 100. */
+    maxPages?: number;
+}
+interface NotionSignals {
+    /** Total pages created or updated in the window. */
+    pagesActive: number;
+    /** Pages created (new docs). */
+    pagesCreated: number;
+    /** Pages updated (edited docs). */
+    pagesUpdated: number;
+    /** Unique editors. */
+    uniqueEditors: number;
+    /** Pages not touched in 30+ days. */
+    stalePages: number;
+    /** Average days since last edit across all tracked pages. */
+    avgDaysSinceEdit: number | null;
+    /** Top page titles by recent activity. */
+    topPages: string[];
+}
+/**
+ * Fetch Notion page activity and return Radiant Events + compressed signals.
+ */
+declare function fetchNotionActivity(token: string, options?: NotionFetchOptions): Promise<{
+    events: Event[];
+    signals: NotionSignals;
+}>;
+/**
+ * Format Notion signals for the AI interpretation prompt.
+ */
+declare function formatNotionSignalsForPrompt(signals: NotionSignals): string;
+
 /**
  * @neuroverseos/governance/radiant — AI pattern interpretation
  *
@@ -1037,7 +1270,7 @@ declare function auditGovernance(events: readonly ClassifiedEvent[], worldPath:
  */
 
 interface RenderInput {
-    scope: RepoScope;
+    scope: Scope;
     windowDays: number;
     eventCount: number;
     signals: readonly Signal[];
@@ -1224,7 +1457,7 @@ declare function think(input: ThinkInput): Promise<ThinkResult>;
  */
 
 interface EmergentInput {
-    scope: RepoScope;
+    scope: RepoScope | OrgScope;
     githubToken: string;
     worldmodelContent: string;
     lensId: string;
@@ -1298,4 +1531,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 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 };
+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 };

package/dist/radiant/index.d.ts

@@ -777,31 +777,56 @@ declare function createMockAI(fixedResponse: string): RadiantAI;
 /**
  * @neuroverseos/governance/radiant — scope resolution
  *
- * Parses scope strings like "aukiverse/posemesh" into typed scope objects
- * that adapters (GitHub, etc.) know how to fetch.
+ * Parses scope strings into typed scope objects that adapters know how
+ * to fetch. Supports two levels:
+ *
+ *   "owner/repo"  → RepoScope (single repo)
+ *   "owner/"      → OrgScope (entire organization)
+ *   "owner"       → OrgScope (entire organization)
  */
 /**
- * A GitHub repository scope — the unit of activity Radiant reads.
+ * A GitHub repository scope — single repo.
  */
 interface RepoScope {
+    type: 'repo';
     owner: string;
     repo: string;
 }
 /**
- * Parse a scope string into a RepoScope.
+ * A GitHub organization scope — all repos in an org.
+ */
+interface OrgScope {
+    type: 'org';
+    owner: string;
+}
+type Scope = RepoScope | OrgScope;
+/**
+ * Visibility level for a Radiant read. Controls what sources are
+ * included and where output goes.
  *
- * Accepts:
- *   "owner/repo"
- *   "https://github.com/owner/repo"
- *   "github.com/owner/repo"
+ *   community — public repos + public Discord. Anyone can reproduce.
+ *   team      — public + private repos + team channels. Team exocortex.
+ *   full      — everything + cross-exocortex. Leader's personal exocortex.
+ */
+type ViewLevel = 'community' | 'team' | 'full';
+/**
+ * Parse a scope string into a RepoScope or OrgScope.
  *
- * Throws on unparseable input.
+ * Accepts:
+ *   "owner/repo"                    → RepoScope
+ *   "owner/" or "owner"             → OrgScope
+ *   "https://github.com/owner/repo" → RepoScope
+ *   "https://github.com/owner"      → OrgScope
+ */
+declare function parseScope(scope: string): Scope;
+/**
+ * Backward-compatible: parse as RepoScope only. Throws if org-level.
  */
 declare function parseRepoScope(scope: string): RepoScope;
 /**
- * Format a RepoScope back to a display string.
+ * Format any scope back to a display string.
  */
-declare function formatScope(scope: RepoScope): string;
+declare function formatScope(scope: Scope): string;
 
 /**
  * @neuroverseos/governance/radiant — GitHub activity adapter
@@ -844,6 +869,15 @@ interface GitHubFetchOptions {
  * @param options — window size and pagination
  */
 declare function fetchGitHubActivity(scope: RepoScope, token: string, options?: GitHubFetchOptions): Promise<Event[]>;
+/**
+ * Fetch recent activity across an ENTIRE GitHub organization.
+ * Uses /orgs/{org}/repos to list repos, then fetches activity from
+ * each active repo.
+ */
+declare function fetchGitHubOrgActivity(scope: OrgScope, token: string, options?: GitHubFetchOptions): Promise<{
+    events: Event[];
+    repos: string[];
+}>;
 /**
  * Create a mock GitHub adapter for testing. Returns fixed events
  * without calling the GitHub API.
@@ -902,11 +936,210 @@ declare function readExocortex(dirPath: string): ExocortexContext;
  * prompt. Only includes fields that were actually loaded.
  */
 declare function formatExocortexForPrompt(ctx: ExocortexContext): string;
+/**
+ * Read multiple exocortices from a team directory. Each subdirectory
+ * (or symlink) is treated as one person's exocortex.
+ *
+ * Returns an array of { name, context } for each person.
+ */
+declare function readTeamExocortices(teamDir: string): Array<{
+    name: string;
+    context: ExocortexContext;
+}>;
+/**
+ * Format multiple exocortices for the AI prompt — shows each person's
+ * stated intent so the AI can compare them against each other and
+ * against observed activity.
+ */
+declare function formatTeamExocorticesForPrompt(team: Array<{
+    name: string;
+    context: ExocortexContext;
+}>): string;
 /**
  * One-line summary of what was loaded, for CLI status output.
  */
 declare function summarizeExocortex(ctx: ExocortexContext): string;
 
+/**
+ * @neuroverseos/governance/radiant — Discord adapter
+ *
+ * Reads conversational activity from Discord channels and maps it to
+ * Radiant's Event type. This is where Narrative Dynamics and Shared
+ * Prosperity signals become visible — how the team communicates,
+ * coordinates, welcomes newcomers, resolves debates.
+ *
+ * Two modes:
+ *   - Channel message reading (via Discord Bot API)
+ *   - Signal compression (aggregate metrics from raw messages)
+ *
+ * Privacy:
+ *   - Public channels → community view (anyone can reproduce)
+ *   - Team channels → team view (team exocortex only)
+ *   - Private channels / DMs → never read unless explicitly configured
+ *   - The bot token IS consent. Radiant respects Discord's permissions.
+ *
+ * Rate limiting:
+ *   - Caps at 100 messages per channel per fetch
+ *   - Produces compressed signals, not raw message dumps
+ *   - AI receives a sample of 20-30 representative messages, not the firehose
+ */
+
+interface DiscordFetchOptions {
+    /** Channel IDs to read from. If empty, reads all accessible channels. */
+    channelIds?: string[];
+    /** How many days of history to fetch. Default: 14. */
+    windowDays?: number;
+    /** Max messages per channel. Default: 100. */
+    perChannel?: number;
+    /** Visibility level — determines which channels to read. */
+    visibility?: 'public' | 'team';
+}
+interface DiscordSignals {
+    /** Total messages across all channels in the window. */
+    totalMessages: number;
+    /** Number of active channels. */
+    activeChannels: number;
+    /** Unique participants. */
+    uniqueParticipants: number;
+    /** Average response time in minutes (for threaded/reply messages). */
+    avgResponseMinutes: number | null;
+    /** Number of help requests detected (messages containing "help", "stuck", "how do I"). */
+    helpRequests: number;
+    /** Number of unresolved threads (threads with no reply). */
+    unresolvedThreads: number;
+    /** Top discussed topics (extracted from channel names + frequent terms). */
+    topTopics: string[];
+    /** Messages from new participants (first seen in this window). */
+    newcomerMessages: number;
+}
+/**
+ * Fetch Discord activity and return Radiant Events + compressed signals.
+ *
+ * Uses the Discord Bot API (raw fetch, no SDK dependency).
+ * Requires a bot token with MESSAGE_CONTENT intent enabled.
+ */
+declare function fetchDiscordActivity(guildId: string, token: string, options?: DiscordFetchOptions): Promise<{
+    events: Event[];
+    signals: DiscordSignals;
+}>;
+/**
+ * Format Discord signals for the AI interpretation prompt.
+ */
+declare function formatDiscordSignalsForPrompt(signals: DiscordSignals): string;
+
+/**
+ * @neuroverseos/governance/radiant — Slack adapter
+ *
+ * Reads conversational activity from Slack workspaces. For Auki, Slack
+ * is used for external client and partner communication — FairPrice,
+ * retail pilots, Intercognitive coalition partners.
+ *
+ * What it captures:
+ *   - Partner coordination patterns (peaq, Mawari, GEODNET)
+ *   - Client communication quality (responsiveness, follow-through)
+ *   - External contributor onboarding
+ *   - Cross-organization alignment signals
+ *   - Decision-making in channels (debates → outcomes)
+ *
+ * Privacy: workspace token controls access. Bot tokens see channels
+ * the bot is invited to. User tokens see what the user sees. Private
+ * channels and DMs only accessible if explicitly configured.
+ *
+ * Uses Slack Web API via raw fetch (no SDK dependency).
+ * Requires a Bot Token with channels:history + channels:read scopes.
+ */
+
+interface SlackFetchOptions {
+    /** Channel IDs to read. If empty, reads all public channels the bot can see. */
+    channelIds?: string[];
+    /** How many days of history to fetch. Default: 14. */
+    windowDays?: number;
+    /** Max messages per channel. Default: 100. */
+    perChannel?: number;
+    /** Visibility level. */
+    visibility?: 'public' | 'team';
+}
+interface SlackSignals {
+    totalMessages: number;
+    activeChannels: number;
+    uniqueParticipants: number;
+    avgResponseMinutes: number | null;
+    externalParticipants: number;
+    unresolvedThreads: number;
+    topChannels: string[];
+    reactionCount: number;
+}
+/**
+ * Fetch Slack activity and return Radiant Events + compressed signals.
+ */
+declare function fetchSlackActivity(token: string, options?: SlackFetchOptions): Promise<{
+    events: Event[];
+    signals: SlackSignals;
+}>;
+/**
+ * Format Slack signals for the AI interpretation prompt.
+ */
+declare function formatSlackSignalsForPrompt(signals: SlackSignals): string;
+
+/**
+ * @neuroverseos/governance/radiant — Notion adapter
+ *
+ * Reads documentation and knowledge-base activity from Notion.
+ * For Auki, Notion is where team documentation lives — specs, meeting
+ * notes, strategy docs, project plans, decision records.
+ *
+ * What it captures:
+ *   - Documentation freshness (when pages were last edited)
+ *   - Who maintains what (authorship patterns across pages)
+ *   - Knowledge gaps (sprint mentions things that have no doc page)
+ *   - Decision crystallization (are debates in Discord becoming docs in Notion?)
+ *   - Documentation velocity alongside code velocity
+ *
+ * The behavioral signal: high code shipping + low documentation =
+ * the team is building but not recording what they learn. That's a
+ * Narrative Dynamics gap — the story of what's being built isn't
+ * being told, even internally.
+ *
+ * Uses Notion API v1 via raw fetch (no SDK dependency).
+ * Requires an internal integration token with read access.
+ */
+
+interface NotionFetchOptions {
+    /** Specific database IDs to query. If empty, searches all accessible pages. */
+    databaseIds?: string[];
+    /** How many days of history to fetch. Default: 14. */
+    windowDays?: number;
+    /** Max pages to fetch. Default: 100. */
+    maxPages?: number;
+}
+interface NotionSignals {
+    /** Total pages created or updated in the window. */
+    pagesActive: number;
+    /** Pages created (new docs). */
+    pagesCreated: number;
+    /** Pages updated (edited docs). */
+    pagesUpdated: number;
+    /** Unique editors. */
+    uniqueEditors: number;
+    /** Pages not touched in 30+ days. */
+    stalePages: number;
+    /** Average days since last edit across all tracked pages. */
+    avgDaysSinceEdit: number | null;
+    /** Top page titles by recent activity. */
+    topPages: string[];
+}
+/**
+ * Fetch Notion page activity and return Radiant Events + compressed signals.
+ */
+declare function fetchNotionActivity(token: string, options?: NotionFetchOptions): Promise<{
+    events: Event[];
+    signals: NotionSignals;
+}>;
+/**
+ * Format Notion signals for the AI interpretation prompt.
+ */
+declare function formatNotionSignalsForPrompt(signals: NotionSignals): string;
+
 /**
  * @neuroverseos/governance/radiant — AI pattern interpretation
  *
@@ -1037,7 +1270,7 @@ declare function auditGovernance(events: readonly ClassifiedEvent[], worldPath:
  */
 
 interface RenderInput {
-    scope: RepoScope;
+    scope: Scope;
     windowDays: number;
     eventCount: number;
     signals: readonly Signal[];
@@ -1224,7 +1457,7 @@ declare function think(input: ThinkInput): Promise<ThinkResult>;
  */
 
 interface EmergentInput {
-    scope: RepoScope;
+    scope: RepoScope | OrgScope;
     githubToken: string;
     worldmodelContent: string;
     lensId: string;
@@ -1298,4 +1531,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 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 };
+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 };