Docs

[Viscous106]

This has the planning md so i want to finalise our workfolw going forward so for that we have to change and improvise the planning in this pr and after finalising our plan is to start implemneting along with architecutuer and all

[shri771]

Added couple of suggestions.

[Viscous106]

@shri771 @OfficialAbhinavSingh Pointed out some changes and suggestion and aprovals have a look and ping if needed.

[shri771]

Added a couple of suggestions related to the architecture of the project.

[Viscous106]

All review items addressed. Summary of changes applied:

Architecture decisions:

• #11: identity + reputation merged into accounts-service (Python/FastAPI) — 4 services, not 5
• #12: submit_proofs → non-blocking enqueue_proofs_node via stream:proof_queue — goal completes in <1s
• #13: Batch audit logging — tool servers XADD to stream:audit_buffer; indexer emits logBatch(merkleRoot, count) every 10s
• #14: Capability JWT for local verification at tool servers — no per-call RPC to identity
• #15: gRPC (tonic) kept on blockchain-indexer UpdateScore path only; all other internal calls → HTTP/JSON
• #16: HMAC X-Internal-Auth for Phases 1–4; mTLS deferred to Phase 5

New content:

• §2.1: Problem 4 (No Economic Accountability) added
• §2.2: StakeRegistry.sol row added to solution table
• §5.8: Agent Economy section (staking, slashing, ChallengeManager.sol)
• §9: Caching strategy fully rewritten — versioned keys, prefix caching, per-role policy, stampede protection, pgBouncer landmine warnings
• prd-hackathon.md created for launch-phase constraints

Corrections:

• Reputation formula updated with quality_signal negative component
• Credential Broker model added to §5.7
• Proof outbox (durability) + recordBundle (Merkle, gas efficiency) in §5.4 and §10.3
• Capability JWT scoped to tool + repo + action in §7.3
• Leaderboard demoted to secondary /discover surface
• §1.4 reframed as Initial Deployment Context (not Hackathon Context)

[Viscous106]

@shri771 @OfficialAbhinavSingh give me the final confirmation and will merge the pr kindly check and aprove if no changes are needed.