Merge pull request #130 from ethosengine/staging

kuzu seed database and qahal, REA shefa, and imagodei modeling.

Author: Mbd06b

.claude/commands/import-content.md

@@ -0,0 +1,62 @@
+# Content Import Command
+
+Import content from source files into lamad ContentNodes.
+
+## Usage
+
+```
+/import-content [action] [options]
+```
+
+## Actions
+
+- `import` - Run incremental import (default)
+- `full` - Run full reimport
+- `preview` - Preview what would change
+- `stats` - Show import statistics
+- `validate` - Validate manifest integrity
+
+## What This Does
+
+This command triggers the elohim-service content import pipeline:
+
+1. **Scans** `/data/content/` for markdown (.md) and Gherkin (.feature) files
+2. **Parses** each file extracting:
+   - Path metadata (domain, epic, user type)
+   - YAML frontmatter
+   - Content sections
+   - Gherkin scenarios
+3. **Transforms** content into ContentNodes:
+   - Source nodes (raw content for provenance)
+   - Epic nodes
+   - Role/Archetype nodes
+   - Scenario nodes
+   - Resource nodes
+4. **Extracts relationships** between nodes:
+   - Explicit references
+   - Path-based (same epic/user type)
+   - Tag-based similarity
+   - Content references
+5. **Writes output** to `/output/lamad/`:
+   - `nodes.json` - All ContentNodes
+   - `relationships.json` - Node relationships
+   - `content-manifest.json` - For incremental updates
+   - `import-summary.json` - Statistics
+
+## Example Prompts
+
+- "Import all content to lamad format"
+- "Run a full content reimport"
+- "Preview what files have changed since last import"
+- "Show me the import statistics"
+- "Validate the import manifest"
+
+## Implementation
+
+Located at: `elohim-library/projects/elohim-service/`
+
+To run manually:
+```bash
+cd elohim-library/projects/elohim-service
+npx ts-node src/cli/import.ts import --source ../../data/content --output ../../output/lamad
+```

.claude/file-relationships.json

@@ -0,0 +1,110 @@
+{
+  "description": "Defines relationships between files that should stay in sync for the Elohim project",
+  "version": "1.0.0",
+  "relationships": {
+    "elohim-import": {
+      "description": "Elohim import pipeline - skill, CLI, and all related models/services",
+      "skill": ".claude/skills/elohim-import/SKILL.md",
+      "cli": "elohim-library/projects/elohim-service/src/cli/import.ts",
+      "models": {
+        "service": [
+          "elohim-library/projects/elohim-service/src/models/content-node.model.ts",
+          "elohim-library/projects/elohim-service/src/models/path-metadata.model.ts",
+          "elohim-library/projects/elohim-service/src/models/manifest.model.ts",
+          "elohim-library/projects/elohim-service/src/models/import-context.model.ts"
+        ],
+        "app": [
+          "elohim-app/src/app/lamad/models/content-node.model.ts",
+          "elohim-app/src/app/lamad/models/learning-path.model.ts",
+          "elohim-app/src/app/lamad/models/exploration.model.ts",
+          "elohim-app/src/app/lamad/models/human-node.model.ts",
+          "elohim-app/src/app/lamad/models/content-attestation.model.ts",
+          "elohim-app/src/app/lamad/models/trust-badge.model.ts",
+          "elohim-app/src/app/lamad/models/content-mastery.model.ts",
+          "elohim-app/src/app/lamad/models/content-lifecycle.model.ts",
+          "elohim-app/src/app/lamad/models/content-access.model.ts",
+          "elohim-app/src/app/lamad/models/knowledge-map.model.ts"
+        ]
+      },
+      "services": [
+        "elohim-library/projects/elohim-service/src/services/import-pipeline.service.ts",
+        "elohim-library/projects/elohim-service/src/services/human.service.ts",
+        "elohim-library/projects/elohim-service/src/services/standards.service.ts",
+        "elohim-library/projects/elohim-service/src/services/trust.service.ts",
+        "elohim-library/projects/elohim-service/src/services/scaffold.service.ts",
+        "elohim-library/projects/elohim-service/src/services/manifest.service.ts",
+        "elohim-library/projects/elohim-service/src/services/relationship-extractor.service.ts"
+      ],
+      "sync_rules": [
+        {
+          "trigger_pattern": "elohim-service/src/cli/import.ts",
+          "notify": ["skill"],
+          "message": "CLI commands changed - update SKILL.md documentation"
+        },
+        {
+          "trigger_pattern": "elohim-service/src/models/*.model.ts",
+          "notify": ["skill", "cli"],
+          "message": "Service model changed - may affect CLI options and skill documentation"
+        },
+        {
+          "trigger_pattern": "elohim-service/src/services/*.service.ts",
+          "notify": ["cli", "skill"],
+          "message": "Service API changed - may require CLI command updates"
+        },
+        {
+          "trigger_pattern": "elohim-app/src/app/lamad/models/*.model.ts",
+          "notify": ["skill"],
+          "message": "App model changed - update skill schema documentation"
+        },
+        {
+          "trigger_pattern": ".claude/skills/elohim-import/SKILL.md",
+          "notify": [],
+          "message": "Skill updated - no action needed"
+        }
+      ]
+    },
+    "model-sync": {
+      "description": "ContentNode models must stay in sync between service and app",
+      "pairs": [
+        {
+          "source": "elohim-library/projects/elohim-service/src/models/content-node.model.ts",
+          "target": "elohim-app/src/app/lamad/models/content-node.model.ts",
+          "sync_direction": "service-to-app",
+          "message": "ContentNode model in elohim-service changed - ensure elohim-app model is compatible"
+        }
+      ]
+    }
+  },
+  "schemas": {
+    "ContentNode": {
+      "description": "Core content unit in lamad system",
+      "definedIn": "elohim-library/projects/elohim-service/src/models/content-node.model.ts",
+      "usedBy": ["import-pipeline", "human.service", "standards.service"],
+      "fields": ["id", "contentType", "title", "description", "content", "contentFormat", "tags", "relatedNodeIds", "metadata"]
+    },
+    "PathMetadata": {
+      "description": "Metadata extracted from file system paths",
+      "definedIn": "elohim-library/projects/elohim-service/src/models/path-metadata.model.ts",
+      "usedBy": ["import-pipeline"],
+      "fields": ["fullPath", "relativePath", "domain", "epic", "userType", "contentCategory"]
+    },
+    "ContentManifest": {
+      "description": "Tracks imported content for incremental updates",
+      "definedIn": "elohim-library/projects/elohim-service/src/models/manifest.model.ts",
+      "usedBy": ["manifest.service", "import-pipeline"],
+      "fields": ["manifestVersion", "schemaVersion", "sourceHashes", "nodeHashes", "migrations"]
+    },
+    "ImportOptions": {
+      "description": "Configuration for import pipeline execution",
+      "definedIn": "elohim-library/projects/elohim-service/src/models/import-context.model.ts",
+      "usedBy": ["cli", "import-pipeline"],
+      "fields": ["mode", "sourceDir", "outputDir", "domains", "epics", "dryRun", "verbose", "skipRelationships"]
+    },
+    "Human": {
+      "description": "Human persona in the network",
+      "definedIn": "elohim-library/projects/elohim-service/src/services/human.service.ts",
+      "usedBy": ["cli"],
+      "fields": ["id", "displayName", "bio", "category", "profileReach", "location", "affinities"]
+    }
+  }
+}

.claude/hooks/load-project-context.py

@@ -0,0 +1,117 @@
+#!/usr/bin/env python3
+"""
+Load Project Context Hook
+
+Runs at session start to provide Claude with project schema knowledge.
+Loads schemas from file-relationships.json so Claude knows about
+ContentNode, PathMetadata, etc. without needing to read the model files.
+
+Hook Type: SessionStart
+"""
+import json
+import sys
+import os
+
+def load_relationships(project_dir: str) -> dict:
+    """Load the file relationships configuration."""
+    rel_path = os.path.join(project_dir, '.claude', 'file-relationships.json')
+    if not os.path.exists(rel_path):
+        return {}
+
+    with open(rel_path, 'r') as f:
+        return json.load(f)
+
+def format_schema_summary(schemas: dict) -> str:
+    """Format schemas for context injection."""
+    if not schemas:
+        return ""
+
+    lines = ["ELOHIM PROJECT SCHEMAS:"]
+    lines.append("")
+
+    for name, info in schemas.items():
+        lines.append(f"• {name}: {info.get('description', 'No description')}")
+        lines.append(f"  Defined in: {info.get('definedIn', 'Unknown')}")
+        fields = info.get('fields', [])
+        if fields:
+            lines.append(f"  Fields: {', '.join(fields[:8])}")
+            if len(fields) > 8:
+                lines.append(f"          ...and {len(fields) - 8} more")
+        lines.append("")
+
+    return "\n".join(lines)
+
+def get_sync_relationships_summary(relationships: dict) -> str:
+    """Summarize file relationships for context."""
+    lines = ["FILE SYNC RELATIONSHIPS:"]
+    lines.append("")
+
+    for group_name, group in relationships.get('relationships', {}).items():
+        desc = group.get('description', group_name)
+        lines.append(f"• {group_name}: {desc}")
+
+        if 'skill' in group:
+            lines.append(f"  Skill: {group['skill']}")
+        if 'cli' in group:
+            lines.append(f"  CLI: {group['cli']}")
+
+        sync_rules = group.get('sync_rules', [])
+        if sync_rules:
+            lines.append(f"  Sync rules: {len(sync_rules)} patterns tracked")
+
+        lines.append("")
+
+    return "\n".join(lines)
+
+def main():
+    try:
+        # Read hook input from stdin
+        data = json.load(sys.stdin)
+
+        # Get project directory
+        project_dir = os.environ.get('CLAUDE_PROJECT_DIR', '/projects/elohim')
+
+        # Load relationships
+        relationships = load_relationships(project_dir)
+        if not relationships:
+            sys.exit(0)
+
+        context_parts = []
+
+        # Add schema summary
+        schemas = relationships.get('schemas', {})
+        if schemas:
+            context_parts.append(format_schema_summary(schemas))
+
+        # Add relationship summary
+        rels = relationships.get('relationships', {})
+        if rels:
+            context_parts.append(get_sync_relationships_summary(relationships))
+
+        if not context_parts:
+            sys.exit(0)
+
+        # Add reminder about hooks
+        context_parts.append("SYNC HOOKS ACTIVE:")
+        context_parts.append("When you modify files in elohim-service or elohim-app,")
+        context_parts.append("hooks will remind you about related files that may need updates.")
+        context_parts.append("")
+
+        # Output context for Claude
+        output = {
+            "hookSpecificOutput": {
+                "hookEventName": "SessionStart",
+                "additionalContext": "\n".join(context_parts)
+            }
+        }
+
+        print(json.dumps(output))
+
+    except json.JSONDecodeError:
+        sys.exit(0)
+    except Exception as e:
+        print(f"load-project-context hook error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()