feat: pending_review() API — LLM/agent can evaluate deprecated memories before prune

[ajianaz]

Overview

Tambahkan API endpoint + core method untuk list deprecated memories yang belum ter-prune. LLM atau agent bisa evaluasi: promote (kalau penting) atau forget (kalau spam).

Core Method

/// Get deprecated memories pending prune for LLM/agent review.
/// Returns memories sorted by prune urgency (oldest deprecation first).
pub fn pending_review(
    &self,
    namespace: Option<&str>,
    limit: usize,
) -> Result<Vec<PendingReview>, Error> {
    let ns = namespace.unwrap_or(DEFAULT_NAMESPACE);
    // Deprecated memories not yet past TTL
    let rows = self.store.query(
        "SELECT id, content, namespace, tags, valid_until, metadata,
                (julianday(valid_until) - julianday(now)) as days_until_prune
         FROM memories
         WHERE namespace = ?1 AND deprecated = 1
         ORDER BY valid_until ASC LIMIT ?2",
        params![ns, limit],
    )?;
    // Map to PendingReview structs
}

HTTP API Endpoint

GET /api/lifecycle/pending?namespace=default&limit=20

Response:
{
  "pending": [
    {
      "id": "abc123",
      "content": "User prefers dark mode...",
      "namespace": "default",
      "tags": ["preference", "ui"],
      "deprecated_at": "2024-08-01T10:00:00Z",
      "deprecated_reason": "auto_lifecycle",
      "days_until_prune": 25,
      "metadata": {...}
    }
  ],
  "total_pending": 10,
  "total_expiring_soon": 3
}

HTTP API — Promote/Forget

POST /api/lifecycle/promote
Body: { "id": "abc123" }

POST /api/lifecycle/forget
Body: { "id": "abc123", "confirm": true }

Files Changed

File	Change
crates/uteke-core/src/maintenance.rs or new lifecycle.rs	Add pending_review() method
crates/uteke-server/src/handlers.rs	Add GET /api/lifecycle/pending
crates/uteke-server/src/handlers.rs	Add POST /api/lifecycle/promote
crates/uteke-server/src/handlers.rs	Add POST /api/lifecycle/forget

Acceptance Criteria

• pending_review() returns deprecated memories sorted by urgency
• Each result includes days_until_prune countdown
• HTTP API endpoint returns JSON with pending list
• Promote endpoint works via POST
• Forget endpoint requires confirm: true (safety)
• Namespace-aware filtering
• Pagination via limit param

Dependencies

• Depends on feat: deprecate_with_reason() + promote() + Store undeprecate #929 (deprecate_with_reason, promote)
• Depends on feat: aging_cleanup() — soft-delete instead of hard-delete when soft_delete_only=true #930 (aging_cleanup soft-delete — creates deprecated entries)

[ajianaz]

Closed as completed — the pending review use case is covered by the lifecycle endpoints shipped in v0.13.0:

• GET /lifecycle/status returns deprecated memory count + IDs
• POST /lifecycle/promote?id=xxx restores deprecated memories to active

CLI equivalents: uteke lifecycle status, uteke lifecycle promote <id>

Shipped in PR #938.

[ajianaz]

Reopening: pending_review() API was not implemented in PR #938. The HTTP endpoints (GET /lifecycle/status, POST /lifecycle/cycle, POST /lifecycle/promote) are from #935, not #936. This issue covers the separate pending_review() feature — LLM/agent evaluates deprecated memories before prune.