Artifacts
Choose an artifact provider and look up the guarantees shared by local and mirrored storage.
The artifacts configuration selects where woostack stores development artifacts. Local storage is
the default and remains authoritative when provider mirroring is enabled.
Local
Files, run directories, retention, authority, and provider-free behavior.
GitHub
GitHub fields, Project README specification, parentless issues, and lifecycle behavior.
Linear
Linear fields, identities, project hierarchy, and lifecycle behavior.
Plane
Plane fields, identities, work-item hierarchy, and lifecycle behavior.
artifacts.provider | Storage | Effect |
|---|---|---|
omitted or "local" | Local | Stores Build and project-backed Fix artifacts under .woostack/tmp/runs/. Makes no artifact-provider calls. |
"github" | GitHub | Keeps the local run authoritative and mirrors through the host-authenticated official GitHub CLI (gh). |
"linear" | Linear | Keeps the local run authoritative and mirrors through the authenticated official Linear MCP. |
"plane" | Plane | Keeps the local run authoritative and mirrors through the authenticated official Plane MCP. |
Mirror guarantees
Configuration is non-secret policy. It never grants permission to access a provider, approve artifact
content, or perform repository work. Credentials remain in the host's MCP, OAuth, or gh secret store.
Every provider boundary requires the exact official interface capabilities it uses. Reads require complete pagination. Creates use a stable identity allocated before the first attempt, and created or recovered resources receive an independent exact read before later mutations. Missing, partial, ambiguous, duplicate, or foreign results fail closed at that provider boundary.
A mirror failure is recorded in the local manifest and remains nonblocking for local authority.
Provider synchronization never changes GitHub merge authority. woostack-change never contacts an
artifact provider.
The canonical implementation rules live in the local run artifact and provider mirror contract.