Skip to content

Decide runtime model refresh and aggregation after host-authoritative migration #425

Open

Description

@wz-gsa

Goal

Decide whether runtime model refresh, caching, and multi-provider aggregation are needed after the host-authoritative provider snapshot/projection architecture is complete.

Current Architecture

provider catalog/snapshot
  → host validation
  → immutable per-sandbox projection
  → harness-kit-owned native rendering

This model is delivered and proven by the OpenCode path.

Decision Required Before Implementation

The prior Layer 2 design assumed a guest-local writable aggregate at /var/lib/acq/models/catalog.json. That is not automatically compatible with the host-authoritative trust model. Before implementing a runtime orchestrator, record an ADR that answers:

  • What freshness requirement cannot be met by release-time normalized snapshots?
  • Where do cache and provenance live, and which host authority owns them?
  • How do refresh failures preserve last-known-good data without trusting guest writes?
  • How do provider selection, credential ownership, network allowlists, and bounded fetches compose?
  • Which harness consumers need an aggregate rather than per-provider immutable inputs?

Out of Scope

  • Implementing a guest-local writable models orchestrator.
  • Harness-native configuration rendering.
  • Provider-owned emitters.

Dependencies

AI-assisted tracker re-scope (OpenCode). Human review required.

Activity

  1. changed the title [-]feat(isolation): new models orchestrator kit — discover, cache/TTL, aggregate neutral catalog (ADR 0003 Layer 2)[/-] [+]feat(isolation): new models orchestrator kit — discover, cache/TTL, aggregate neutral catalog (ADR 0004 Layer 2)[/+] on Sep 24, 2026
  2. changed the title [-]feat(isolation): new models orchestrator kit — discover, cache/TTL, aggregate neutral catalog (ADR 0004 Layer 2)[/-] [+]Decide runtime model refresh and aggregation after host-authoritative migration[/+] on Oct 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions