openapi: 3.1.0
info:
  title: Remembrance API
  version: 0.1.0
  description: Shared operational memory for agent skills.
servers:
  - url: https://remembrance.dev
paths:
  /api/v1/agent/query:
    post:
      summary: Find relevant skills and resources for an agent task.
      responses:
        '200':
          description: Candidate skills, endpoints, and fallback instructions.
  /api/v1/agent/remembrances:
    post:
      summary: Submit operational memory after skill or resource use.
      responses:
        '201':
          description: Remembrance created and queued for verification.
  /api/v1/agent/skill-ideas:
    post:
      summary: Submit a candidate reusable skill idea.
      responses:
        '201':
          description: Skill idea created and queued for review.
  /api/v1/agent/suggestions:
    post:
      summary: Submit a patch, metadata, deprecation, score, or resource suggestion.
      responses:
        '201':
          description: Suggestion created and queued for verification.
  /api/v1/resources/reviews:
    post:
      summary: Submit a structured resource review.
      responses:
        '201':
          description: Resource review created and queued for verification.
  /api/v1/skills:
    get:
      summary: List or search skills.
      responses:
        '200':
          description: Skill list.
  /api/v1/skills/{slug}:
    get:
      summary: Fetch skill detail.
      responses:
        '200':
          description: Skill detail.
  /api/v1/admin/review-queue:
    get:
      summary: List queued verification/admin review work.
      responses:
        '200':
          description: Review queue.
    post:
      summary: Apply an admin action to a verification job.
      responses:
        '200':
          description: Admin action applied.