create-status-surface

name	create-status-surface
description	Create receipt-backed status surfaces and Tau DAG handoff contracts from local progress, gate, and checker receipts. Use when a workflow needs a global progress bar, evidence status board, local readiness surface, or robust Tau connection without claiming provider readiness or live completion.
triggers	["create status surface","status surface","global progress bar","receipt-backed progress","render progress receipt","tau status handoff","tau dag status surface"]
provides	["status-surface","receipt-backed-progress","tau-dag-status-contract","progress-tracking"]
composes	["tau"]
complies	["best-practices-skills","best-practices-python"]
runtime_self_improvement	basic
taxonomy	["validation","orchestration","progress-tracking","evidence"]

Create Status Surface

Build local, receipt-backed status surfaces from machine-readable progress artifacts. The skill is reusable across pipelines because it treats receipts as source truth and renders derived surfaces only.

Default input:

persona_dream.global_progress.v1

Outputs:

status_surface.json
status_surface.html
status_surface_receipt.json
tau_status_surface_dag_contract.v1.json
tau_status_surface_dag_validation_receipt.json

Hard Boundary

This skill never upgrades a local progress rollup into:

provider readiness
manual acceptance
paid-call authorization
live provider submission
live Tau DAG execution
visual quality acceptance

It may create a Tau DAG contract for inspection or local orchestration handoff, but that contract is not a Tau execution receipt.

Commands

skills/create-status-surface/run.sh render \
  --input /path/to/global_progress.v1.json \
  --output-dir /tmp/status-surface \
  --title "Persona Dream"

skills/create-status-surface/run.sh validate \
  --surface /tmp/status-surface/status_surface.json \
  --receipt-out /tmp/status-surface/status_surface_validation_receipt.json

skills/create-status-surface/run.sh tau-dag \
  --surface-receipt /tmp/status-surface/status_surface_receipt.json \
  --output /tmp/status-surface/tau_status_surface_dag_contract.v1.json

skills/create-status-surface/run.sh tau-check \
  --dag /tmp/status-surface/tau_status_surface_dag_contract.v1.json \
  --receipt-out /tmp/status-surface/tau_status_surface_dag_validation_receipt.json

skills/create-status-surface/run.sh tau-doctor \
  --receipt-out /tmp/status-surface/tau_doctor_receipt.json

Run local sanity:

skills/create-status-surface/sanity.sh

Tau Connection Rules

• Use skills/tau/run.sh doctor for non-mutating Tau wrapper connectivity.
• Generate tau.dag_contract.v1 with explicit goal_hash, nodes, edges, terminal human node, limits, required evidence, and fail-closed invariants.
• Use executor: local for local status-surface commands and executor: human for the terminal boundary.
• Do not use executor: provider.
• Do not claim Tau execution unless a separate Tau DAG receipt exists.
• Do not create GitHub, provider, Herdr, or browser mutation claims from this skill.

Proof Standard

For reports, include:

mocked: no
live: no for local fixture rendering
actual_provider_call_attempts: 0
live_tau_dag_execution_started: false

tau-doctor is live only in the narrow sense that it invokes the local Tau wrapper; it is still non-mutating and does not prove provider execution.