Artifacts

State the purpose in prose — what the document should produce — rather than a template. The corpus decides the sections; the purpose decides what is worth saying.

**Generation is detached.** The dispatch returns a running task; poll it, or watch the file stream to see the artifact land. Naming an existing `artifactId` is refused on the API surface today — omit it to generate a new one.

The artifact lands under `Artifacts/`, which is the classification rather than a naming convention: the pipeline treats it as a derived product and will not read it back as evidence. Promoting it to source is the folder move in the Changes lane, and is a deliberate act.

Dispatched as `{"action": "artifact_update", "input": {"purpose": "..."}}`.

curl -X POST "https://runlog-7613480744.us-central1.run.app/v1/api/actions" \
  -H "Authorization: Bearer $RUNLOG_API_KEY" \
  -H "X-Project-Id: p7Kd2mQx" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "artifact_update",
  "input": {
    "purpose": "an envelope takeoff for the north elevation, with the glazing schedule"
  }
}'

{
  "action": "artifact_update",
  "result": {
    "artifactId": "art_5Hn2Kp",
    "status": "running",
    "taskId": "tk_6Wr4Bn"
  }
}

There is no separate promote endpoint, and that is deliberate. The `.runlog/Artifacts/` folder boundary IS the classification, so one move gesture is the whole operation and the tree can never disagree with the label.

**Demote** — moving a file INTO `.runlog/Artifacts/` relabels it generated: it becomes a derived product, and the pipeline stops treating it as evidence.

**Promote** — moving a file OUT of `.runlog/Artifacts/` relabels it ingested: it becomes source evidence, and the derivation cascade re-reconciles everything that rests on it.

Each crossing triggers its reconciliation cascade, and discrepancies the cascade finds are surfaced rather than silently resolved. A batch that fails lands on each file's own status as `error`; nothing is skipped quietly.

curl -X PATCH "https://runlog-7613480744.us-central1.run.app/v1/projects/p7Kd2mQx/files/4mHqZ1nR8vTbC0sWyLpAeGkJ3dXfU6iO2rN" \
  -H "Authorization: Bearer $RUNLOG_API_KEY" \
  -H "X-Project-Id: p7Kd2mQx" \
  -H "Content-Type: application/json" \
  -d '{
  "filepath": ".runlog/Artifacts/design"
}'

{
  "chunkIds": [
    "4mHqZ1nR8vTbC0sWyLpAeGkJ3dXfU6iO2rN"
  ],
  "chunking": "",
  "createdAt": "2026-08-07T18:22:10Z",
  "ext": "swift",
  "fileId": "4mHqZ1nR8vTbC0sWyLpAeGkJ3dXfU6iO2rN",
  "fileSize": 41822,
  "fileType": "code",
  "filepath": ".runlog/Artifacts/design",
  "name": "Router.swift",
  "projectId": "p7Kd2mQx",
  "sourceClass": "generated",
  "status": "queued",
  "updatedAt": "2026-08-07T18:22:10Z"
}