alma-memory 0.3.0__tar.gz → 0.4.0__tar.gz

{alma_memory-0.3.0 → alma_memory-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alma-memory
-Version: 0.3.0
+Version: 0.4.0
 Summary: Agent Learning Memory Architecture - Persistent memory for AI agents
 Author-email: RBKunnela <aiagentsprompt@gmail.com>
 License: MIT
@@ -366,8 +366,8 @@ alma:
 | 8 | Forgetting Mechanism | ✅ Done |
 | 9 | MCP Server + Testing Suite | ✅ Done |
 | 10 | Progress, Sessions, Domains | ✅ Done |
-| 11 | Initializer Agent Pattern | Planned |
-| 12 | Forward-Looking Confidence | Planned |
+| 11 | Initializer Agent Pattern | ✅ Done |
+| 12 | Forward-Looking Confidence | ✅ Done |
 
 ## API Reference
 
@@ -425,6 +425,56 @@ schema = get_coding_schema()  # or research, sales, general
 alma = factory.create_alma(schema, "project-id")
 ```
 
+### Session Initializer (NEW in v0.4.0)
+
+```python
+from alma.initializer import SessionInitializer
+
+initializer = SessionInitializer(alma)
+
+# Full initialization before starting work
+result = initializer.initialize(
+    project_id="my-project",
+    agent="Helena",
+    user_prompt="Test the login form validation",
+    project_path="/path/to/project",
+)
+
+# Inject into agent prompt
+prompt = f"""
+{result.to_prompt()}
+
+Now proceed with the first work item.
+"""
+```
+
+### Confidence Engine (NEW in v0.4.0)
+
+```python
+from alma.confidence import ConfidenceEngine
+
+engine = ConfidenceEngine(alma)
+
+# Assess a strategy before trying it
+signal = engine.assess_strategy(
+    strategy="Use incremental validation",
+    context="Testing a 5-field registration form",
+    agent="Helena",
+)
+
+print(f"Confidence: {signal.confidence_score:.0%}")
+print(f"Recommendation: {signal.recommendation}")
+# → Confidence: 78%
+# → Recommendation: yes
+
+# Rank multiple strategies
+rankings = engine.rank_strategies(
+    strategies=["Strategy A", "Strategy B", "Strategy C"],
+    context="Current task",
+    agent="Helena",
+)
+```
+
 ## License
 
 MIT

{alma_memory-0.3.0 → alma_memory-0.4.0}/README.md

@@ -322,8 +322,8 @@ alma:
 | 8 | Forgetting Mechanism | ✅ Done |
 | 9 | MCP Server + Testing Suite | ✅ Done |
 | 10 | Progress, Sessions, Domains | ✅ Done |
-| 11 | Initializer Agent Pattern | Planned |
-| 12 | Forward-Looking Confidence | Planned |
+| 11 | Initializer Agent Pattern | ✅ Done |
+| 12 | Forward-Looking Confidence | ✅ Done |
 
 ## API Reference
 
@@ -381,6 +381,56 @@ schema = get_coding_schema()  # or research, sales, general
 alma = factory.create_alma(schema, "project-id")
 ```
 
+### Session Initializer (NEW in v0.4.0)
+
+```python
+from alma.initializer import SessionInitializer
+
+initializer = SessionInitializer(alma)
+
+# Full initialization before starting work
+result = initializer.initialize(
+    project_id="my-project",
+    agent="Helena",
+    user_prompt="Test the login form validation",
+    project_path="/path/to/project",
+)
+
+# Inject into agent prompt
+prompt = f"""
+{result.to_prompt()}
+
+Now proceed with the first work item.
+"""
+```
+
+### Confidence Engine (NEW in v0.4.0)
+
+```python
+from alma.confidence import ConfidenceEngine
+
+engine = ConfidenceEngine(alma)
+
+# Assess a strategy before trying it
+signal = engine.assess_strategy(
+    strategy="Use incremental validation",
+    context="Testing a 5-field registration form",
+    agent="Helena",
+)
+
+print(f"Confidence: {signal.confidence_score:.0%}")
+print(f"Recommendation: {signal.recommendation}")
+# → Confidence: 78%
+# → Recommendation: yes
+
+# Rank multiple strategies
+rankings = engine.rank_strategies(
+    strategies=["Strategy A", "Strategy B", "Strategy C"],
+    context="Current task",
+    agent="Helena",
+)
+```
+
 ## License
 
 MIT

{alma_memory-0.3.0 → alma_memory-0.4.0}/alma/__init__.py

@@ -14,7 +14,7 @@ This makes any tool-using agent appear to "learn" by injecting relevant
 memory slices before each run and updating memory after.
 """
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"
 
 # Core
 from alma.core import ALMA
@@ -76,6 +76,22 @@ from alma.domains import (
     get_general_schema,
 )
 
+# Session Initializer (Phase 11)
+from alma.initializer import (
+    CodebaseOrientation,
+    InitializationResult,
+    RulesOfEngagement,
+    SessionInitializer,
+)
+
+# Confidence Engine (Phase 12)
+from alma.confidence import (
+    ConfidenceEngine,
+    ConfidenceSignal,
+    OpportunitySignal,
+    RiskSignal,
+)
+
 __all__ = [
     # Core
     "ALMA",
@@ -121,4 +137,14 @@ __all__ = [
     "get_research_schema",
     "get_sales_schema",
     "get_general_schema",
+    # Session Initializer
+    "CodebaseOrientation",
+    "InitializationResult",
+    "RulesOfEngagement",
+    "SessionInitializer",
+    # Confidence Engine
+    "ConfidenceEngine",
+    "ConfidenceSignal",
+    "OpportunitySignal",
+    "RiskSignal",
 ]

alma_memory-0.4.0/alma/confidence/__init__.py

@@ -0,0 +1,47 @@
+"""
+ALMA Confidence Module.
+
+Forward-looking confidence signals for strategies.
+Not just "this worked before" but "this will likely work now."
+
+Inspired by Ilya Sutskever's insight: emotions are forward-looking value functions,
+while reinforcement learning is backward-looking.
+
+Usage:
+    from alma.confidence import ConfidenceEngine, ConfidenceSignal
+
+    engine = ConfidenceEngine(alma)
+
+    # Assess a strategy
+    signal = engine.assess_strategy(
+        strategy="Use incremental validation for forms",
+        context="Testing a registration form with 5 fields",
+        agent="Helena",
+    )
+
+    print(f"Confidence: {signal.confidence_score:.0%}")
+    print(f"Recommendation: {signal.recommendation}")
+
+    # Rank multiple strategies
+    rankings = engine.rank_strategies(
+        strategies=["Strategy A", "Strategy B"],
+        context="Current context",
+        agent="Helena",
+    )
+"""
+
+from alma.confidence.types import (
+    ConfidenceSignal,
+    OpportunitySignal,
+    Recommendation,
+    RiskSignal,
+)
+from alma.confidence.engine import ConfidenceEngine
+
+__all__ = [
+    "ConfidenceSignal",
+    "ConfidenceEngine",
+    "OpportunitySignal",
+    "Recommendation",
+    "RiskSignal",
+]