Build with reviewed project memory.

// GET project context (read scope)
const res = await fetch(
  "https://shelvia.net/api/v1/project-memory/projects/$PROJECT_ID/context",
  { headers: { Authorization: `Bearer ${SHELVIA_TOKEN}` } }
);
const { ok, data, provenance } = await res.json();
// data.decisions, data.sources, data.prompts, data.next_steps,
// data.open_questions, data.constraints, data.connector_activity,
// data.memory_health
// provenance: { workspace_id, token_id, generated_at, api_version }

// Semantic search across reviewed memory
const res = await fetch(
  "https://shelvia.net/api/v1/project-memory/search",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${SHELVIA_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      query: "What did we decide about the payment provider?",
      project_id: PROJECT_ID,
      mode: "hybrid", // keyword | semantic | hybrid
      limit: 10,
    }),
  }
);

// Generate a context pack ranked by semantic similarity
//   + structured priority + source-backed bonus + recency
const res = await fetch(
  "https://shelvia.net/api/v1/project-memory/projects/$PROJECT_ID/context-pack",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${SHELVIA_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      purpose: "Continue the v2 launch checklist",
      target_tool: "claude",
      max_chars: 12000,
      semantic_ranking: true,
    }),
  }
);
// response.ranking.top_reasons surfaces human-readable match
// reasons, never raw similarity scores.

// Create a review candidate (write scope)
// Writes ALWAYS enter the review queue, never trusted memory.
const res = await fetch(
  "https://shelvia.net/api/v1/project-memory/projects/$PROJECT_ID/candidates",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${SHELVIA_TOKEN}`,
      "Content-Type": "application/json",
      "Idempotency-Key": IDEMPOTENCY_KEY, // optional
    },
    body: JSON.stringify({
      type: "decision",
      title: "Use Paystack for African card payments",
      content: "Decision body...",
      source_url: "https://example.com/source",
    }),
  }
);