State and artifacts

Semantic diffs and artifacts

Give agents compact repository context they can carry between tools: manifests, semantic diff summaries, diagnostics, activity summaries, and handoff bundles.

Honest degradation

When exact native Lore diff data is not available through ForgeLore projections, responses say so and point agents to the official Lore CLI for exact local checks.

Repository manifests

Summarize repository health, branch state, file counts, locks, and agent safety policy.

Semantic diffs

Return a token-efficient change summary and native-data availability status.

Artifact IDs

Attach a stable redacted reference to summaries, diagnostics, diffs, and handoffs.

Handoffs

Pass state, allowed actions, forbidden actions, and verification steps between agents.

CLI examples

$forgelore repo manifest <repoId>
$forgelore repo diff <repoId> main feature/lighting
$forgelore repo artifacts <repoId>

MCP examples

  • `get_repository_manifest` returns a redacted context bundle for onboarding.
  • `semantic_diff` returns projected change context and an artifact reference.
  • `plan_agent_handoff` packages state and safety rules for another agent.
  • `get_artifact` never exposes secrets; regenerate live context when a body is not persisted.

Verify the source

Check the response's availability and provenance fields before treating a summary as an exact native diff. When ForgeLore reports degraded projection data, use the official Lore CLI in the local workspace for exact content verification.