Review SPARQL prefix management protocol for CHUCC

[arne-bdt]

Add comprehensive protocol specification and implementation plan for prefix management in CHUCC Server. This enables IDE integration for SPARQL query templates and preserves RDF/XML namespace declarations.

Protocol Documentation:

• protocol/Prefix_Management_Protocol.md - Generic W3C-style protocol

  • Dataset-level only (70% shorter than original proposal)
  • Standard JSON format
  • RDFPatch integration (PA/PD directives)
  • Version control implementation notes
  • Works for any SPARQL server

• docs/api/prefix-management.md - CHUCC implementation guide

  • Version-aware URL structure
  • Prefix changes create commits (via RDFPatch PA/PD)
  • Time-travel support
  • Merge behavior (automatic via PA/PD replay)
  • IDE integration examples
  • No new events needed (reuses CommitCreatedEvent)

Implementation Tasks:

• .tasks/pmp/README.md - Overview and architecture
• .tasks/pmp/session-1-core-implementation.md - GET/PUT/PATCH/DELETE (4-5h)
• .tasks/pmp/session-2-time-travel-support.md - Historical queries (2-3h)
• .tasks/pmp/session-3-suggested-prefixes.md - Namespace discovery (2-3h)
• .tasks/pmp/session-4-openapi-and-tests.md - Documentation (2-3h)
• .tasks/pmp/session-5-merge-conflict-handling.md - Optional enhancement (3-4h)

Key Architectural Decisions:

• No protocol extension needed (prefixes versioned via RDFPatch PA/PD)
• Reuses existing CQRS infrastructure (no new events)
• Simplified from original proposal (removed graph-level, capabilities)
• Total implementation time: 1.5 weeks (1 week for MVP)

Benefits:

• IDE autocomplete for SPARQL queries
• Preserve RDF/XML namespace declarations
• Time-travel prefix queries
• Automatic merge of prefix changes
• Full audit trail via event sourcing

🤖 Generated with Claude Code