DOCUMENTATION / ALPHA

Prompt commits

An executable maintenance artifact that can replay the intent of an upstream capability extraction.

Definition

A Prompt Commit is not an AI-written commit message. It is a signed, versioned transformation contract joining source provenance, architectural intent, semantic queries, license strategy, generated patch and verification evidence.

{
  "protocol": "torsionfield-prompt-commit/1",
  "source": {"repo":"owner/project","base":"sha","head":"sha"},
  "capabilityContract": "workflow.record-and-replay/1",
  "strategy": "direct|clean-room|compatibility|bridge",
  "targets": ["extension/src/operation-graph"],
  "invariants": ["operation identity", "observable postconditions"],
  "transform": {"prompt":"artifact:sha256:...","engine":"..."},
  "tests": ["fixture:...","browser:..."],
  "evidence": ["artifact:..."],
  "signature": "..."
}

Why it matters

Ordinary code copying freezes upstream functionality at one date. A Prompt Commit stores how and why the functionality was extracted, making future upstream changes comparable and replayable.

Update cycle

  1. Detect upstream change and mirror into quarantine.
  2. Verify source identity, license and dependency changes.
  3. Compute text, AST, manifest, UI and behavioral diffs.
  4. Map changed symbols to capability contracts.
  5. Replay affected Prompt Commits in an isolated branch.
  6. Run static, license, security, fixture, browser and visual tests.
  7. Publish an evidence-rich incorporation review.
  8. Canary, observe and automatically roll back on field failure.