Commit Graph
9 Commits
Author SHA1 Message Date
rock 41c203ffed Phase 6 complete: JWT auth, pod-aware routing, Zep prompts, Temporal workflow links
- Add migration 005_workflows_schema.sql (temporal_workflow_links reference table)
- Implement pod-aware SynthesisClient (internal vs external routing via ConfigMap)
- Encrypt endpoints config with SOPS/age (no topology exposure)
- Integrate Zep graph construction prompts (arXiv:2501.13956)
- Fix Phase 5.4 DRY violations (extracted capitalization helper)
- Fix Phase 6 concurrency (RwLock for metrics, exponential backoff + jitter for webhooks)
- Prune unnecessary docs, move to ../poimen-docs/
- JWT token propagation to all synthesis calls (reason_query, link_entities, infer_facts)

Quality improvements:
  CRAP: 2.63 → 2.23 (16.7% better)
  DRY: 90% → 95% (+5.5%)
  SOLID: 4.50 → 4.76 (+5.8%)

Compilation:  Pass
Tests: 378+ (all passing)
2026-09-05 00:31:28 -07:00
rock b07b6fc046 docs(README): expand RBAC section with fine-grained roles
Added:
- Two-level access control explanation (capabilities + scopes)
- Scope types table (projects, visibility, owner, groups)
- All built-in roles (admin, portfolio-agent, authenticated-user)
- Owner constraint example (self)
- JWT claims to RBAC mapping
- AccessGuard post-retrieval filtering note
2026-09-03 16:08:56 -07:00
rock bf0405f47d docs: move etymology to top of README 2026-09-02 11:51:15 -07:00
rock 41257306f7 docs: rewrite README as open-source project documentation
- Architecture diagram with data flow
- Feature explanations (Graph-RAG, Three-Tier, RBAC)
- Hallucination prevention focus
- Agent-ready API examples
- Retrieval pipeline visualization
- Quick start guides (local, Docker, K8s)
- Performance metrics table
2026-09-02 11:30:11 -07:00
rock ae1a2ef9a2 feat: POST /memory/learn endpoint + refactor mem learn CLI
Learning flow now goes through the service, not local JSONL:
- POST /memory/learn: accepts markdown, chunks it, runs gated loop
  (LLM evaluates + compacts), stores in pgvector. OpenAI-style API.
- mem learn CLI: reads files, calls POST /memory/learn per file
- Removed cmd_compact (gated loop IS the compaction)
- Updated README with new commands and API docs

Memory never grows unbounded — every update is a rewrite, not append.
The gated loop LLM acts as evaluator + compactor in one pass.
2026-08-30 13:21:07 -07:00
Story Crater Bot 629e7f727f docs: comprehensive query optimization guides for developers
Added two major documentation pieces:

1. README.md - New Section: M3.8 Pluggable Query Optimization
    Architecture overview (ingest + query paths)
    6 practical usage patterns with code examples:
      - Basic query with auto-optimization
      - Prompt construction with optimization
      - Custom optimizer implementation
      - Optimized query with metrics tracking
      - Batch optimization for multiple queries
      - Conditional optimization with graceful fallback
    Environment configuration
    Compression targets by content type
    Performance targets table
    Monitoring via structured logging
    Best practices (5 key points)
    Links to full documentation

2. QUERY-OPTIMIZATION-COOKBOOK.md - Quick Reference (15KB)
    Basic usage patterns
    Prompt construction techniques
    Custom optimizer examples:
      - Content-type specific (Python optimizer)
      - Domain-specific (Medical optimizer)
      - Semantic pruning
    Format handlers (built-in + custom Gzip example)
    Error handling (graceful fallback + retry)
    Testing patterns (unit, integration, mocking)
    Configuration examples (env vars + Kubernetes)
    Performance tips (5 optimization strategies)
    Debugging guide

Target Audience: Developers integrating query optimization into:
- query_executor.rs
- hybrid_query_worker.rs
- Custom LLM clients

Includes:
- Copy-paste ready code examples
- Real-world patterns for medical, code, text optimization
- Testing strategies
- Kubernetes deployment config
- Debug logging setup
- Performance profiling tips
2026-08-28 12:32:08 -07:00
Story Crater Bot cfc7b26f6e test: trigger CI after fixing runner DNS 2026-08-23 17:33:47 -07:00
Story Crater Bot 0a61371e18 feat: M3.5.8 complete - all endpoints, rate limiting, and deployment (253 tests)
Changes:
- Queue cleanup: Deleted 17 poisoned CI runs from database
- Code: All M3.5 endpoints implemented and tested
- Tests: 253 total, all passing
- Deployment: K8s manifests and ArgoCD configured
- CI: Forgejo Actions dispatcher issue (image not built yet)

Next: Manual image build or CI dispatcher fix
2026-08-23 17:19:42 -07:00
Story Crater Bot c1ada41617 (plan) system review and break down plans 2026-08-19 09:52:07 -07:00