Skip to content

Runtime Entities

The product brief defines the broad Data Model seed. The Foundry runtime integration architecture adds these runtime-specific entities — the installations, runners, compiled artifacts, requests, results, and traces that drive and record execution. Related concepts include the Foundry Execution Request, the Foundry Run Result, the Foundry Capability Manifest, and the Runtime Topology.

foundry_installations

Represents a Foundry runtime Alloy can target.

  • id
  • project_id or organization_id
  • name
  • foundry_version
  • connection_type
  • last_seen_at
  • capability_manifest
  • status

The capability_manifest field carries the Foundry Capability Manifest.

alloy_runners

Represents a runner or bridge process. See Runtime Topology for how runners fit into the deployment.

  • id
  • organization_id
  • name
  • runner_key_hash
  • allowed_projects
  • status
  • last_poll_at
  • last_heartbeat_at
  • registered_by
  • registered_at

formation_brief_compilations

Represents a compiled brief instance.

  • id
  • brief_template_id nullable
  • project_id
  • source_intent_snapshot
  • compiled_payload
  • compiler_version
  • schema_version
  • digest
  • status
  • created_by
  • created_at
  • approved_by nullable
  • approved_at nullable

prompt_pack_compilations

Represents compiled prompts.

  • id
  • formation_brief_id
  • template_version
  • compiler_version
  • prompts
  • human_edits
  • schema_version
  • digest
  • created_at

gate_overlays

Represents generated or accepted gate overlays.

  • id
  • formation_brief_id
  • project_id
  • mode
  • content
  • digest
  • status
  • created_at
  • approved_by nullable

foundry_run_requests

Represents a request for Foundry execution. See Foundry Execution Request.

  • id
  • project_id
  • runner_id nullable
  • formation_brief_id
  • brief_digest
  • entry_event
  • payload
  • throttle
  • repo_revision
  • branch
  • idempotency_key
  • status
  • requested_by
  • requested_at
  • accepted_at nullable
  • started_at nullable
  • completed_at nullable

foundry_run_results

Represents Foundry's terminal result. See Foundry Run Result.

  • id
  • run_request_id
  • foundry_run_id
  • status
  • repo_revision_before
  • repo_revision_after
  • gate_results
  • retry_count
  • trace_uri
  • summary
  • raw_result
  • completed_at

trace_imports

Represents raw or summarized trace data imported from Foundry.

  • id
  • foundry_run_result_id
  • trace_id
  • trace_format
  • raw_trace
  • summary
  • imported_at

evidence_observations

Represents evidence found during or after execution.

  • id
  • evidence_definition_id
  • run_request_id
  • formation_brief_id
  • status
  • observed_by
  • supporting_artifacts
  • notes
  • observed_at

Source: Integration Architecture §17 (Data Model Additions).

Alloy owns meaning. Foundry owns execution.