artifact-query

What problem does it solve?

Locate relevant historical context, past handoffs, and prior plans quickly so engineers and planners can learn from what succeeded and failed instead of repeating mistakes. This reduces duplicated work, surfaces proven solutions, and highlights past failures to avoid.

Core Features & Use Cases

• Semantic full-text search across Ring's Artifact Index using SQLite FTS5 with BM25 ranking.
• Filtered results by artifact type (handoffs, plans, continuity), outcome, and limit, with JSON and stats output for programmatic workflows.
• Planning integration that separates successful and failed precedents to inform new implementation plans and debugging efforts.
• Use Case: Before designing a new authentication flow, query the index for prior authentication handoffs, read what_worked and what_failed, and cite those precedents in your plan.

Quick Start

Search the artifact index for relevant precedent on authentication and return the top five handoffs and plans in JSON.