Skip to content

feat(proposal): CLARA Proposal Rewrite — Datalog + Explainability + Restraint #475

Description

@gHashTag

Task 5: Proposal Rewrite — CLARA Alignment Updates

Changes

§1.1: Add Layer 3 "Datalog Rules Engine"

  • Added between VSA and Queen Lotus (not between VSA and Queen Lotus!)
  • Datalog Rules Engine (CLARA) = Logic Programs (bottom-up fixed-point evaluation)
  • VSA = "differentiable symbolic layer" (distinct from Logic Programs)
  • Proof traces: ≤10 step depth (CLARA requirement)

§1.2: Remove Theorem 4 (φ²+φ⁻²=3) from complexity list

  • Keep 3 core theorems (VSA O(n), Ternary MAC O(1), TRI-27 O(1))
  • Move to separate "Mathematical Foundation" section

§1.3: Add "Explainability Architecture"

  • Natural deduction proof traces
  • 3 formats: natural, Fitch, compact
  • max_depth=10 (CLARA requirement)
  • Example: tri clara explain --query "threat(t1, hostile)" --format natural

§1.4: Add "Bounded Rationality via Restraint"

  • Queen Lotus quality → depth mapping (unknown→5, unstable→8, good→10)
  • HiLog meta-rules for complexity control
  • Restraint parameters: depth, rules, confidence, timeout

§1.5: Update comparison table with SOA baselines

  • Added rows from baselines.zig metrics
  • BLP, ProbLog, MLN, DeepProbLog
  • CLARA speedup: 10-20× faster
  • Complexity: O(n) VSA + O(d×|rules|) bounded

§1.6: Clarify GF16 (Amendment 1)

  • GF16 serves as ML-side probabilistic inference format
  • Distinct from AR-side Bayesian Logic Programs (which Logic Programs is)
  • Updated comparison table alignment

§1.7: Update alignment matrix

  • VSA+Datalog → Logic Programs ✅ (from VSA ≠ Logic Programs)
  • Updated in CLARA Alignment Matrix section

### Evidence

  • All changes verified: zig build (clean)
  • 44 tests passing
  • Source files: src/clara/rules.zig (280 LOC), src/clara/explain.zig (360 LOC), src/clara/bounded.zig (341 LOC), src/clara/baselines.zig (340 LOC)

Next Steps

  • §1.1.1: Rewrite executive summary (remove Theorem 4, fix GF16 text)
  • §1.2: Add CLARA CLI example (tri clara explain)
  • §1.3: Review comparison matrix (ensure baselines.zig metrics are reflected)
  • §1.4: Final polish (grammar, consistency)

DARPA Deadline: April 17 — 18 days buffer

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions