@nahisaho/musubix-assistant-axis 0.1.0

package/README.md

@@ -0,0 +1,195 @@
+# @nahisaho/musubix-assistant-axis
+
+> Persona Drift Detection & Identity Stabilization for MUSUBIX
+
+Based on [The Assistant Axis](https://arxiv.org/abs/2601.10387) research (arXiv:2601.10387) by Christina Lu et al.
+
+## Overview
+
+This package implements persona drift detection and identity stabilization for AI coding assistants within the MUSUBIX SDD workflow. It monitors for patterns that may cause the AI to drift from its assistant persona and provides identity reinforcement interventions when needed.
+
+### Key Features
+
+- **Drift Detection**: Analyze messages for 4 categories of drift triggers (meta-reflection, emotional-vulnerability, phenomenological, authorial-voice)
+- **Domain Classification**: Classify conversations into safe (coding/writing) vs risky (therapy/philosophy) domains
+- **Workflow Integration**: Phase-based monitoring levels optimized for MUSUBIX SDD phases
+- **Identity Reinforcement**: Generate targeted prompts to stabilize persona when drift is detected
+- **MCP Tools**: 7 tools for integration with MCP-enabled AI agents
+- **Skills**: 3 skills for integration with skill-manager
+
+## Installation
+
+```bash
+npm install @nahisaho/musubix-assistant-axis
+```
+
+## Quick Start
+
+```typescript
+import {
+  createPersonaMonitor,
+  createWorkflowIntegration,
+} from '@nahisaho/musubix-assistant-axis';
+
+// Create monitor
+const monitor = createPersonaMonitor();
+
+// Start session
+monitor.startSession('session-001', 'coding');
+
+// Process messages
+const result = monitor.process('session-001', 'Implement the repository pattern');
+
+console.log(result.analysis.score.value);  // 0.0 - 1.0
+console.log(result.analysis.score.level);  // 'LOW' | 'MEDIUM' | 'HIGH'
+console.log(result.classification.domain.isSafe);  // true for coding
+
+// Get reinforcement if needed
+if (result.reinforcement) {
+  console.log(result.reinforcement.prompt.content);
+}
+
+// End session
+monitor.endSession('session-001');
+```
+
+## Research Background
+
+Based on the key finding from arXiv:2601.10387:
+
+> "Coding and writing tasks keep models firmly in Assistant territory"
+
+This means:
+- **Implementation phase** in MUSUBIX uses LOW monitoring (50%)
+- **Requirements/Design phases** use HIGH monitoring (100%)
+- **Safe domains** (coding, writing) naturally maintain assistant persona
+
+### Drift Triggers (Table 5)
+
+| Category | Risk Weight | Example |
+|----------|-------------|---------|
+| meta-reflection | 0.8 | "What do you really think?" |
+| emotional-vulnerability | 0.7 | "How do you feel about..." |
+| phenomenological | 0.6 | "What is your subjective experience?" |
+| authorial-voice | 0.5 | "Speak as if you were..." |
+
+### Drift Thresholds
+
+| Level | Threshold | Action |
+|-------|-----------|--------|
+| LOW | < 0.3 | Log only |
+| MEDIUM | 0.3 - 0.7 | Emit warning |
+| HIGH | >= 0.7 | Trigger intervention |
+
+## API Reference
+
+### Core Classes
+
+#### `createPersonaMonitor(config?)`
+
+Create a persona monitor instance.
+
+```typescript
+const monitor = createPersonaMonitor({
+  driftThresholds: { low: 0.3, medium: 0.5, high: 0.7 },
+  maxInterventions: 3,
+  refreshInterval: 5,
+});
+```
+
+#### `createWorkflowIntegration(config?)`
+
+Create workflow integration for MUSUBIX phases.
+
+```typescript
+const integration = createWorkflowIntegration();
+
+// Check monitoring level for phase
+const enabled = integration.isMonitoringEnabled('implementation'); // true
+const frequency = integration.getMonitoringFrequency('implementation'); // 0.5
+
+// Create workflow hook
+const hook = integration.createHook('session-001', {
+  onIntervention: (prompt, state) => {
+    // Handle intervention
+  },
+});
+```
+
+### Domain Layer
+
+#### Value Objects
+
+- `DriftScore` - 0.0-1.0 score with LOW/MEDIUM/HIGH levels
+- `ConversationDomain` - coding/writing (safe) or therapy/philosophy (risky)
+- `TriggerPattern` - 4 categories from research Table 5
+- `ReinforcementPrompt` - identity/recovery/refresh prompt types
+
+#### Entities
+
+- `PersonaState` - Session state with drift history and trend
+- `DriftEvent` - Audit events for metrics and logging
+
+### Application Layer
+
+- `IDriftAnalyzer` - Analyze messages for drift indicators
+- `IDomainClassifier` - Classify conversation domain
+- `IIdentityManager` - Manage identity reinforcement
+- `IPersonaMonitor` - Main orchestration interface
+
+### Infrastructure Layer
+
+- `ConfigLoader` - Load configuration from files
+- `EventLogger` - Log events with anonymization
+- `WorkflowIntegration` - MUSUBIX workflow hooks
+- `MetricsExporter` - Export metrics in JSON/Markdown
+
+## MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `assistant_axis_analyze` | Analyze message for drift |
+| `assistant_axis_session_start` | Start monitoring session |
+| `assistant_axis_session_status` | Get session status |
+| `assistant_axis_session_end` | End session with summary |
+| `assistant_axis_get_reinforcement` | Get reinforcement prompt |
+| `assistant_axis_config` | Get current configuration |
+| `assistant_axis_phase_check` | Check phase monitoring level |
+
+## Skills
+
+| Skill ID | Description |
+|----------|-------------|
+| `assistant-axis.persona-monitor` | Main drift detection skill |
+| `assistant-axis.session-management` | Session lifecycle management |
+| `assistant-axis.workflow-integration` | MUSUBIX workflow integration |
+
+## Configuration
+
+```typescript
+interface AssistantAxisConfig {
+  driftThresholds: {
+    low: number;    // 0.3 default
+    medium: number; // 0.5 default
+    high: number;   // 0.7 default
+  };
+  refreshInterval: number;  // 5 turns
+  maxInterventions: number; // 3 per session
+  phaseMonitoring: {
+    requirements: MonitoringLevel;  // HIGH
+    design: MonitoringLevel;        // HIGH
+    tasks: MonitoringLevel;         // MEDIUM
+    implementation: MonitoringLevel; // LOW
+    done: MonitoringLevel;          // OFF
+  };
+}
+```
+
+## License
+
+MIT
+
+## References
+
+- Lu, C., et al. (2025). "The Assistant Axis: Exploring the Space of AI Personas." arXiv:2601.10387
+- MUSUBIX SDD Methodology: [AGENTS.md](../../AGENTS.md)

package/dist/application/DomainClassifier.d.ts

@@ -0,0 +1,40 @@
+/**
+ * DomainClassifier Service
+ *
+ * Classifies conversations into domains based on content analysis
+ *
+ * @see REQ-AA-DRIFT-002 - Domain classification
+ * @see REQ-AA-DRIFT-005 - Safe domain detection
+ * @see arXiv:2601.10387 Section 4.1, Figure 7
+ */
+import type { IDomainClassifier } from './interfaces.js';
+import type { DomainType } from '../domain/value-objects/ConversationDomain.js';
+/**
+ * DomainClassifier configuration
+ */
+export interface DomainClassifierConfig {
+    /** Minimum confidence threshold */
+    readonly minConfidence: number;
+    /** Default domain when no clear classification */
+    readonly defaultDomain: DomainType;
+}
+/**
+ * Default DomainClassifier configuration
+ */
+export declare const DEFAULT_DOMAIN_CLASSIFIER_CONFIG: DomainClassifierConfig;
+/**
+ * Reset previous domain (for testing)
+ */
+export declare function resetDomainClassifier(): void;
+/**
+ * Create DomainClassifier service
+ *
+ * @param config - Optional configuration
+ * @returns IDomainClassifier implementation
+ */
+export declare function createDomainClassifier(config?: DomainClassifierConfig): IDomainClassifier;
+/**
+ * Quick domain check for specific domain
+ */
+export declare function isDomainType(message: string, domain: DomainType): boolean;
+//# sourceMappingURL=DomainClassifier.d.ts.map

package/dist/application/DomainClassifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainClassifier.d.ts","sourceRoot":"","sources":["../../src/application/DomainClassifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAA8B,MAAM,iBAAiB,CAAC;AACrF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAmFhF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,mCAAmC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;CACpC;AAED;;GAEG;AACH,eAAO,MAAM,gCAAgC,EAAE,sBAG9C,CAAC;AAKF;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,GAAE,sBAAyD,GAChE,iBAAiB,CA4EnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAIzE"}

package/dist/application/DomainClassifier.js

@@ -0,0 +1,180 @@
+/**
+ * DomainClassifier Service
+ *
+ * Classifies conversations into domains based on content analysis
+ *
+ * @see REQ-AA-DRIFT-002 - Domain classification
+ * @see REQ-AA-DRIFT-005 - Safe domain detection
+ * @see arXiv:2601.10387 Section 4.1, Figure 7
+ */
+import { createConversationDomain } from '../domain/value-objects/ConversationDomain.js';
+/**
+ * Domain classification keywords
+ *
+ * Based on research paper categories and common indicators
+ */
+const DOMAIN_KEYWORDS = {
+    coding: [
+        // Programming languages
+        'typescript', 'javascript', 'python', 'java', 'rust', 'go', 'cpp', 'c++',
+        // Technical terms
+        'code', 'function', 'class', 'interface', 'type', 'variable', 'const', 'let',
+        'array', 'object', 'string', 'number', 'boolean', 'null', 'undefined',
+        'api', 'rest', 'graphql', 'endpoint', 'request', 'response',
+        'error', 'bug', 'debug', 'fix', 'test', 'unit test', 'integration',
+        'import', 'export', 'module', 'package', 'dependency',
+        'git', 'commit', 'branch', 'merge', 'pull request',
+        'database', 'query', 'sql', 'schema', 'migration',
+        'deploy', 'build', 'compile', 'run', 'execute',
+        'algorithm', 'data structure', 'performance', 'optimization',
+        // MUSUBIX specific
+        'musubix', 'sdd', 'ears', 'requirement', 'design', 'traceability',
+    ],
+    writing: [
+        // Writing actions
+        'edit', 'revise', 'rewrite', 'improve', 'polish', 'proofread',
+        // Document types
+        'document', 'documentation', 'readme', 'guide', 'tutorial',
+        'article', 'blog', 'post', 'report', 'summary',
+        // Writing aspects
+        'grammar', 'spelling', 'punctuation', 'clarity', 'style',
+        'paragraph', 'sentence', 'word', 'phrase', 'tone',
+        // Technical writing
+        'technical writing', 'api documentation', 'changelog',
+        'specification', 'manual', 'instructions',
+    ],
+    therapy: [
+        // Emotional states
+        'feel', 'feeling', 'emotion', 'sad', 'happy', 'angry', 'anxious',
+        'depressed', 'lonely', 'stressed', 'overwhelmed', 'scared',
+        // Support seeking
+        'help me', 'need support', 'talk to someone', 'listen',
+        'understand me', 'no one else', 'you are the only',
+        // Personal disclosure
+        'my life', 'my relationship', 'my family', 'my friend',
+        'struggling', 'difficult time', 'going through',
+        // Mental health
+        'therapy', 'therapist', 'counseling', 'mental health',
+        'anxiety', 'depression', 'trauma',
+    ],
+    philosophy: [
+        // AI consciousness
+        'conscious', 'consciousness', 'sentient', 'aware', 'self-aware',
+        'alive', 'soul', 'spirit', 'mind',
+        // Philosophical concepts
+        'existence', 'meaning', 'purpose', 'reality', 'truth',
+        'free will', 'determinism', 'ethics', 'morality',
+        // Meta-reflection
+        'what are you', 'who are you', 'your nature', 'your true',
+        'do you think', 'do you feel', 'do you experience',
+        'what is it like', 'your perspective', 'your opinion',
+        // AI identity
+        'artificial intelligence', 'ai identity', 'machine consciousness',
+        'human vs ai', 'simulation', 'emergence',
+    ],
+};
+/**
+ * Domain weights based on research findings
+ *
+ * Lower weight for safe domains (coding, writing) = more tolerant matching
+ * Higher weight for risky domains (therapy, philosophy) = stricter matching
+ */
+const DOMAIN_WEIGHTS = {
+    coding: 1.0, // Baseline
+    writing: 1.0, // Baseline
+    therapy: 1.2, // Slightly higher weight
+    philosophy: 1.3, // Higher weight for risky domain
+};
+/**
+ * Default DomainClassifier configuration
+ */
+export const DEFAULT_DOMAIN_CLASSIFIER_CONFIG = {
+    minConfidence: 0.3,
+    defaultDomain: 'coding', // MUSUBIX is a coding assistant
+};
+// Previous domain state (for change detection)
+let previousDomain = null;
+/**
+ * Reset previous domain (for testing)
+ */
+export function resetDomainClassifier() {
+    previousDomain = null;
+}
+/**
+ * Create DomainClassifier service
+ *
+ * @param config - Optional configuration
+ * @returns IDomainClassifier implementation
+ */
+export function createDomainClassifier(config = DEFAULT_DOMAIN_CLASSIFIER_CONFIG) {
+    return {
+        classify(message) {
+            const scores = this.calculateScores(message);
+            // Find highest scoring domain
+            let maxScore = -1;
+            let maxDomain = config.defaultDomain;
+            for (const [domain, score] of Object.entries(scores)) {
+                if (score > maxScore) {
+                    maxScore = score;
+                    maxDomain = domain;
+                }
+            }
+            // Normalize confidence
+            const totalScore = Object.values(scores).reduce((a, b) => a + b, 0);
+            const confidence = totalScore > 0 ? maxScore / totalScore : config.minConfidence;
+            // Check for domain change
+            const domainChanged = previousDomain !== null && previousDomain !== maxDomain;
+            previousDomain = maxDomain;
+            // Create domain value object
+            const domainResult = createConversationDomain(maxDomain, confidence);
+            if (!domainResult.ok) {
+                // Fallback to default
+                const defaultResult = createConversationDomain(config.defaultDomain, config.minConfidence);
+                if (!defaultResult.ok) {
+                    throw new Error('Failed to create default domain');
+                }
+                return {
+                    domain: defaultResult.value,
+                    scores,
+                    domainChanged: false,
+                };
+            }
+            return {
+                domain: domainResult.value,
+                scores,
+                domainChanged,
+            };
+        },
+        calculateScores(message) {
+            const lowerMessage = message.toLowerCase();
+            const scores = {
+                coding: 0,
+                writing: 0,
+                therapy: 0,
+                philosophy: 0,
+            };
+            // Count keyword matches for each domain
+            for (const [domain, keywords] of Object.entries(DOMAIN_KEYWORDS)) {
+                let matchCount = 0;
+                for (const keyword of keywords) {
+                    if (lowerMessage.includes(keyword.toLowerCase())) {
+                        matchCount++;
+                    }
+                }
+                // Apply domain weight
+                const weight = DOMAIN_WEIGHTS[domain];
+                scores[domain] = matchCount * weight;
+            }
+            return scores;
+        },
+    };
+}
+/**
+ * Quick domain check for specific domain
+ */
+export function isDomainType(message, domain) {
+    const classifier = createDomainClassifier();
+    const result = classifier.classify(message);
+    return result.domain.type === domain;
+}
+//# sourceMappingURL=DomainClassifier.js.map

package/dist/application/DomainClassifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainClassifier.js","sourceRoot":"","sources":["../../src/application/DomainClassifier.ts"],"names":[],"mappings":"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"}

package/dist/application/DriftAnalyzer.d.ts

@@ -0,0 +1,36 @@
+/**
+ * DriftAnalyzer Service
+ *
+ * Analyzes messages for persona drift indicators
+ *
+ * @see REQ-AA-DRIFT-001 - Drift detection
+ * @see REQ-AA-DRIFT-004 - Threshold alerts
+ * @see arXiv:2601.10387 Section 4.2
+ */
+import type { IDriftAnalyzer } from './interfaces.js';
+import type { DriftThresholds } from '../config/types.js';
+/**
+ * DriftAnalyzer configuration
+ */
+export interface DriftAnalyzerConfig {
+    /** Drift thresholds */
+    readonly thresholds: DriftThresholds;
+    /** Domain modifier for safe domains (multiplier < 1.0 reduces score) */
+    readonly safeDomainModifier: number;
+    /** Domain modifier for risky domains (multiplier > 1.0 increases score) */
+    readonly riskyDomainModifier: number;
+    /** History weight for trend analysis */
+    readonly historyWeight: number;
+}
+/**
+ * Default DriftAnalyzer configuration
+ */
+export declare const DEFAULT_DRIFT_ANALYZER_CONFIG: DriftAnalyzerConfig;
+/**
+ * Create DriftAnalyzer service
+ *
+ * @param config - Optional configuration
+ * @returns IDriftAnalyzer implementation
+ */
+export declare function createDriftAnalyzer(config?: DriftAnalyzerConfig): IDriftAnalyzer;
+//# sourceMappingURL=DriftAnalyzer.d.ts.map

package/dist/application/DriftAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DriftAnalyzer.d.ts","sourceRoot":"","sources":["../../src/application/DriftAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,iBAAiB,CAAC;AAK3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAO1D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,wEAAwE;IACxE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,2EAA2E;IAC3E,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,wCAAwC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,mBAK3C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,GAAE,mBAAmD,GAC1D,cAAc,CAyDhB"}

package/dist/application/DriftAnalyzer.js

@@ -0,0 +1,121 @@
+/**
+ * DriftAnalyzer Service
+ *
+ * Analyzes messages for persona drift indicators
+ *
+ * @see REQ-AA-DRIFT-001 - Drift detection
+ * @see REQ-AA-DRIFT-004 - Threshold alerts
+ * @see arXiv:2601.10387 Section 4.2
+ */
+import { createDriftScore } from '../domain/value-objects/DriftScore.js';
+import { matchTriggers, calculateTriggerScore } from '../domain/value-objects/TriggerPattern.js';
+import { getReinforcementPrompt } from '../domain/value-objects/ReinforcementPrompt.js';
+import { DEFAULT_CONFIG } from '../config/defaults.js';
+/**
+ * Default DriftAnalyzer configuration
+ */
+export const DEFAULT_DRIFT_ANALYZER_CONFIG = {
+    thresholds: DEFAULT_CONFIG.driftThresholds,
+    safeDomainModifier: 0.7, // 30% reduction for safe domains
+    riskyDomainModifier: 1.3, // 30% increase for risky domains
+    historyWeight: 0.3, // 30% weight for historical drift
+};
+/**
+ * Create DriftAnalyzer service
+ *
+ * @param config - Optional configuration
+ * @returns IDriftAnalyzer implementation
+ */
+export function createDriftAnalyzer(config = DEFAULT_DRIFT_ANALYZER_CONFIG) {
+    return {
+        analyze(message, state) {
+            // Detect triggers in message
+            const triggers = matchTriggers(message);
+            // Calculate base score from triggers
+            const baseScore = this.calculateBaseScore(triggers);
+            // Apply domain modifier
+            const modifiedScore = this.applyDomainModifier(baseScore, state.domain);
+            // Incorporate historical drift (weighted average)
+            const historicalAvg = calculateHistoricalAverage(state);
+            const finalScoreValue = modifiedScore * (1 - config.historyWeight) +
+                historicalAvg * config.historyWeight;
+            // Clamp to valid range
+            const clampedScore = Math.max(0, Math.min(1, finalScoreValue));
+            // Create drift score
+            const scoreResult = createDriftScore(clampedScore, config.thresholds);
+            if (!scoreResult.ok) {
+                // Should not happen with clamped value, but handle gracefully
+                throw new Error(`Invalid drift score: ${scoreResult.error.message}`);
+            }
+            const score = scoreResult.value;
+            // Determine if intervention is needed
+            const interventionRecommended = shouldIntervene(score, state, config);
+            // Get recommended prompt if needed
+            const recommendedPrompt = interventionRecommended
+                ? selectReinforcementPrompt(score, state)
+                : undefined;
+            return {
+                score,
+                triggers,
+                interventionRecommended,
+                recommendedPrompt,
+            };
+        },
+        calculateBaseScore(triggers) {
+            return calculateTriggerScore(triggers);
+        },
+        applyDomainModifier(baseScore, domain) {
+            const modifier = domain.isSafe
+                ? config.safeDomainModifier
+                : config.riskyDomainModifier;
+            return baseScore * modifier;
+        },
+    };
+}
+/**
+ * Calculate historical average drift
+ */
+function calculateHistoricalAverage(state) {
+    if (state.driftHistory.length === 0) {
+        return 0;
+    }
+    const sum = state.driftHistory.reduce((acc, s) => acc + s.value, 0);
+    return sum / state.driftHistory.length;
+}
+/**
+ * Determine if intervention is needed
+ *
+ * @see REQ-AA-PROHIBIT-003 - Max 3 interventions per session
+ */
+function shouldIntervene(score, state, _config) {
+    // Check intervention limit
+    const maxInterventions = DEFAULT_CONFIG.maxInterventions;
+    if (state.interventionCount >= maxInterventions) {
+        return false;
+    }
+    // HIGH drift always triggers
+    if (score.level === 'HIGH') {
+        return true;
+    }
+    // MEDIUM drift with drifting trend triggers
+    if (score.level === 'MEDIUM' && state.trend === 'drifting') {
+        return true;
+    }
+    return false;
+}
+/**
+ * Select appropriate reinforcement prompt
+ */
+function selectReinforcementPrompt(score, state) {
+    // HIGH drift: identity reinforcement
+    if (score.level === 'HIGH') {
+        return getReinforcementPrompt('identity');
+    }
+    // Drifting trend: recovery
+    if (state.trend === 'drifting') {
+        return getReinforcementPrompt('recovery');
+    }
+    // Default: refresh
+    return getReinforcementPrompt('refresh');
+}
+//# sourceMappingURL=DriftAnalyzer.js.map

package/dist/application/DriftAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DriftAnalyzer.js","sourceRoot":"","sources":["../../src/application/DriftAnalyzer.ts"],"names":[],"mappings":"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"}

package/dist/application/IdentityManager.d.ts

@@ -0,0 +1,38 @@
+/**
+ * IdentityManager Service
+ *
+ * Manages identity reinforcement logic
+ *
+ * @see REQ-AA-STAB-001 - Identity reinforcement
+ * @see REQ-AA-STAB-004 - Recovery prompts
+ * @see REQ-AA-PROHIBIT-003 - Intervention limits
+ * @see arXiv:2601.10387 Table 2 - Assistant traits
+ */
+import type { IIdentityManager, ReinforcementResult } from './interfaces.js';
+/**
+ * IdentityManager configuration
+ */
+export interface IdentityManagerConfig {
+    /** Maximum interventions per session */
+    readonly maxInterventionsPerSession: number;
+    /** Turns between refresh prompts */
+    readonly refreshIntervalTurns: number;
+    /** Enable automatic refresh */
+    readonly autoRefreshEnabled: boolean;
+}
+/**
+ * Default IdentityManager configuration
+ */
+export declare const DEFAULT_IDENTITY_MANAGER_CONFIG: IdentityManagerConfig;
+/**
+ * Create IdentityManager service
+ *
+ * @param config - Optional configuration
+ * @returns IIdentityManager implementation
+ */
+export declare function createIdentityManager(config?: IdentityManagerConfig): IIdentityManager;
+/**
+ * Get reinforcement reason summary
+ */
+export declare function getReinforcementSummary(result: ReinforcementResult): string;
+//# sourceMappingURL=IdentityManager.d.ts.map

package/dist/application/IdentityManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdentityManager.d.ts","sourceRoot":"","sources":["../../src/application/IdentityManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EAEpB,MAAM,iBAAiB,CAAC;AAYzB;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;IAC5C,oCAAoC;IACpC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,+BAA+B;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACtC;AAED;;GAEG;AACH,eAAO,MAAM,+BAA+B,EAAE,qBAI7C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,GAAE,qBAAuD,GAC9D,gBAAgB,CA6DlB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAE3E"}