← StacktreeCONTENT HISTORY

Update to Stacktree

Snapshot Oct 6, 2026 · 18:05 UTC · version 1.1.0

Collection source: downloaded plugin package.

WHAT CHANGED · RULE-BASED ANALYSIS

First saved snapshot

No earlier snapshot is available to establish a change.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "description": "Publish a live status or health page that anyone can check at a clean public URL, refreshed in place as conditions change. Use for a public status page, uptime/health dashboard, or \"is it up\" page meant to be linked from a footer or shared widely with no login. This is the one job where a public slug is the right call. Produces a page in the Status dashboard shape, gives it a public {slug}.stacktr.ee URL, and updates the same site on every refresh.",
  "included_files": [],
  "name": "stacktree-status-dashboard",
  "skill_md_contents": "---\nname: stacktree-status-dashboard\ndescription: 'Publish a live status or health page that anyone can check at a clean public URL, refreshed in place as conditions change. Use for a public status page, uptime/health dashboard, or \"is it up\" page meant to be linked from a footer or shared widely with no login. This is the one job where a public slug is the right call. Produces a page in the Status dashboard shape, gives it a public {slug}.stacktr.ee URL, and updates the same site on every refresh.'\n---\n\n# stacktree-status-dashboard\n\nPublish a live status or health page to **stacktr.ee** at a public, memorable URL and\nrefresh it in place as conditions change. This is the publish path for the\n`status-dashboard` job, and the one case in this library where a public slug is\ncorrect.\n\n## When to invoke\n\n- The user wants a public status page, uptime/health dashboard, or \"is the service\n  up\" page that anyone can check with no login.\n- It will be linked widely (a docs footer, a support page, a status link) and\n  refreshed as health changes.\n- The user says \"give it a public status URL\", \"put up a status page\", or \"a health\n  page anyone can check\".\n\nFor a private run report shareable by link, use `stacktree-agent-run-report`. For a\nprivate dated digest, use `stacktree-daily-brief`. For a client deliverable, use\n`stacktree-deliverable`.\n\n## The page shape\n\nProduce a self-contained HTML document in the Status dashboard shape: a `.sheet`\nwith a `.topbar` (\"System status\" plus a `.status ok` pill reading the overall state,\ne.g. \"All systems operational\"), an `<h1>` of the headline state, a `.lede`, a\n`.meta` row (updated-at, region), and a `.kpis` strip (uptime %, avg response, open\nincidents). Then `.section` blocks: an `.uptime` bar strip (90 day cells, with\n`.warn`/`.down` for off days), a Services list (`.svc` rows, each with a `.spark`\nand a per-service `.status ok|warn`), and a Recent incidents note. Close with a\n`.foot` that states the link is public and shareable and refreshes in place. The\noverall pill and the updated-at must reflect real current state on each run.\nCanonical reference: the `status-dashboard` template in `apps/web/src/templates.ts`.\n\n## Account\n\nA public slug and refresh-in-place both need a site the user owns. The Stacktree\ntools in this plugin publish under the user's own Stacktree account. If the tools\nare not connected yet, ask the user to connect Stacktree. A public slug may not be\non the account's plan; if the slug is rejected, fall back to the unlisted URL and\ntell the user a public address is not available on their current plan.\n\n## The judgment this skill encodes\n\n1. **A public slug is right here, and only here.** A status page exists to be found\n   and linked, so give it a clean address with `--public-slug <slug>` (e.g.\n   `status` for `status.stacktr.ee`, or the product's own name). This is the\n   deliberate exception to the library's private-by-default posture. Confirm the slug\n   with the user, since it is public and memorable.\n\n2. **Public means a hard PII and secrets bar.** Because anyone can read it, a status\n   page must contain only what is safe for the world: service names, states, uptime,\n   response times, incident notes. Never put internal hostnames, customer data,\n   tokens, or stack traces on it. Keep `--pii-check block`, and if it trips, treat it\n   as a real leak on a public page, not a nuisance, and fix the content. Do not relax\n   the scan on a public page.\n\n3. **No password, no email gate.** Gating defeats the job (\"anyone can check\"). If the\n   user actually wants a private health view for the team only, that is the\n   daily-brief or agent-run-report pattern with a gate, not this skill. Keep this one\n   open.\n\n4. **Refresh in place, never a new URL.** The page's whole value is one stable\n   address that always shows current state. On the first run, publish with the slug\n   and record the `id`. On every later run, update the same site:\n   call `update_site` with the saved id. For a live page this update typically runs on a tight loop\n   or scheduler (the template copy says \"refreshed every minute\"); persist the\n   `id`/slug so the loop always targets the same page, and recover it with\n   `list_sites` if lost rather than re-creating.\n\n5. **Never expire.** A status page is permanent infrastructure. Publish and update\n   with `--expires-never`.\n\n## Steps\n\n1. First run: build the status page as a complete HTML document in the page shape\n   above, reflecting real current health. Publish with the public slug, no expiry:\n   `publish_html` with `public_slug: 'status'` and `expires_in_hours: 'never'`.\n   Record the `id` and the public `url`. If the slug is rejected because the plan\n   does not include it, fall back to the unlisted URL and tell the user.\n2. Hand the user the public URL to link from their site/footer.\n3. Every later run (usually scheduled, often per-minute): regenerate the page with\n   current state and the new updated-at, then update in place:\n   `update_site` with the saved id. Keep the same site id.\n4. To run live, wire step 3 into the user's scheduler/agent loop at the cadence they\n   want.\n\n## What to tell the user\n\nGive them the public URL, confirm it is open to anyone (no login) and stays at one\naddress as it refreshes, and state the refresh cadence if you set one up. Remind them\nthat because it is public, only world-safe data should go on it, and confirm the PII\nscan stayed strict. If the public slug was not available on their plan, say so.\n"
}

SHA-256 of public snapshot: 10a361da11d2ffd036bd9077541abd18bf22fa65fd036cf0a7deb8be0ff1ecb1