Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion apps/help-wanted-dashboard/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@
</style>
</head>
<body>
<nav aria-label="Primary"><a class="brand" href="https://timerloggedout-spec.github.io/">Autonomous AI Employees</a><a href="https://timerloggedout-spec.github.io/">Marketing</a><a href="https://timerloggedout-spec.github.io/help-wanted/" aria-current="page">Ops · Tribute</a><a href="https://github.com/timerloggedout-spec/termux-monorepo">Monorepo</a></nav>
<nav aria-label="Primary"><a class="brand" href="https://timerloggedout-spec.github.io/">Autonomous AI Employees</a><a href="https://timerloggedout-spec.github.io/">Marketing</a><a href="https://timerloggedout-spec.github.io/help-wanted/" aria-current="page">Ops · Tribute</a><a href="https://help-wanted-oversight-8w13bl125-timerloggedout-5184s-projects.vercel.app/">Vercel deployment</a><a href="/sitemap.xml">Sitemap</a><a href="https://github.com/timerloggedout-spec/termux-monorepo">Monorepo</a></nav>
<header><div class="hero"><div><div class="eyebrow">Contributor lane · evidence + control surface</div><h1>Help-Wanted <span>with</span> <span class="gold">Tribute</span></h1><p class="lede">Observe the upstream contribution lane from scout → claim → PR → follow-up → evidence → publication. This surface is a projection of repository evidence, not a second source of truth and not a MoneyBall admission score.</p><div id="pipeline" class="links" style="margin-top:1rem" aria-label="Pipeline"></div></div><div class="fresh" aria-live="polite"><strong id="freshness">Loading…</strong><small id="generated">Fetching snapshot.</small></div></div></header>
<main>
<section aria-labelledby="overview"><div class="head"><h2 id="overview">Live board</h2><span class="note" id="summary">—</span></div><div class="grid" id="kpis"></div></section>
Expand Down
4 changes: 4 additions & 0 deletions apps/help-wanted-dashboard/robots.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
User-agent: *
Allow: /

Sitemap: https://timerloggedout-spec.github.io/help-wanted/sitemap.xml
5 changes: 5 additions & 0 deletions apps/help-wanted-dashboard/sitemap.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url><loc>https://timerloggedout-spec.github.io/help-wanted/</loc></url>
<url><loc>https://help-wanted-oversight-8w13bl125-timerloggedout-5184s-projects.vercel.app/</loc></url>
</urlset>
58 changes: 24 additions & 34 deletions docs/ops/HELP-WANTED-DASHBOARD.md
Original file line number Diff line number Diff line change
@@ -1,49 +1,39 @@
# Help-Wanted Oversight Dashboard — Live Surfaces

**Skill:** `github-pages-operator` (`.agents/skills/github-pages-operator/SKILL.md`)
## Canonical public dashboard

## Open in browser (rendered HTML)
**GitHub Pages:** https://timerloggedout-spec.github.io/help-wanted/

| Priority | URL | Notes |
|----------|-----|--------|
| **1 GitHack** | https://raw.githack.com/timerloggedout-spec/termux-monorepo/master/apps/help-wanted-dashboard/index.html | Correct HTML MIME |
| **2 User site** | https://timerloggedout-spec.github.io/help-wanted/ | After mirror job (PAT) |
| **3 Project Pages** | https://timerloggedout-spec.github.io/termux-monorepo/ | After enable-pages job succeeds |
| jsDelivr | https://cdn.jsdelivr.net/gh/timerloggedout-spec/termux-monorepo@master/apps/help-wanted-dashboard/index.html | Often **text/plain** → looks like raw source |

Status JSON:
https://raw.githubusercontent.com/timerloggedout-spec/termux-monorepo/master/docs/ops/generated/help-wanted-status.json

## Operator deploy

Workflow: `.github/workflows/help-wanted-dashboard-deploy.yml`
Machine-readable discovery:
- `/help-wanted/sitemap.xml`
- `/help-wanted/robots.txt`

Jobs:
## Verified Vercel deployment

1. **enable-project-pages** — POST/PUT Pages API (`OPERATOR_GITHUB_TOKEN` / `ARCHWIZ_GITHUB_TOKEN` preferred)
2. **publish-gh-pages** — content on `gh-pages`
3. **mirror-user-github-io** — `timerloggedout-spec.github.io/help-wanted/`
4. **vercel-prod** — optional, `continue-on-error`
https://help-wanted-oversight-8w13bl125-timerloggedout-5184s-projects.vercel.app/

```bash
gh workflow run help-wanted-dashboard-deploy.yml -f target=all
```
- State: READY
- Source SHA: `44626f77baa64d49f452f25f6cf23ef992160ce0`
- Project: `help-wanted-oversight`
- This hostname is deployment-specific, not canonical. Re-verify before publishing a replacement link.

Credential inventory: issue **#184** (notes only; never paste secrets).
## Other browser surfaces

Agent-Identity: Grok (Administrator) · BIUDL


## Control-surface topology
| Priority | URL | Notes |
|---|---|---|
| 1 | https://timerloggedout-spec.github.io/help-wanted/ | Canonical public static ops dashboard |
| 2 | https://help-wanted-oversight-8w13bl125-timerloggedout-5184s-projects.vercel.app/ | Current READY Vercel deployment |
| 3 | https://raw.githack.com/timerloggedout-spec/termux-monorepo/master/apps/help-wanted-dashboard/index.html | HTML fallback |
| 4 | https://timerloggedout-spec.github.io/termux-monorepo/ | Thin project hub, not dashboard twin |

The public dashboard is now a provenance-aware projection rather than a static KPI page. The machine snapshot carries a `help-wanted.control-surface.v2` contract with source SHA, registered lane paths, complete commit history for those paths, and deployment topology. The UI exposes this as operator inspection/navigation plus a commit-derived evolution timeline.
Status JSON: https://raw.githubusercontent.com/timerloggedout-spec/termux-monorepo/master/docs/ops/generated/help-wanted-status.json

### Evidence flow
## Operator deploy

`GitHub issues/PRs + Actions + evidence JSONL → help_wanted_status.py → versioned status snapshot → Pages/Vercel dashboard`
Workflow: `.github/workflows/help-wanted-dashboard-deploy.yml`

The dashboard never writes inferred facts back to the repository. Browser controls are navigation into authoritative GitHub surfaces. Reachability of a deployment is not accepted as proof that the intended SHA was deployed; provider/source verification remains part of promotion evidence.
Jobs: enable project Pages, publish project hub, mirror the user GitHub Pages dashboard, and optionally deploy Vercel production.

### Additive-feature accounting
## Sitemap boundary

A dashboard feature is considered accounted for when its implementation/contract path is covered by the registered lane history and the resulting snapshot records the source SHA. This deliberately includes workflow, skill, generator, contract, and UI changes—not only `index.html`.
The XML sitemap contains only public dashboard destinations. Internal repository paths, Actions URLs, Vercel inspector URLs, and credential-bearing surfaces are deliberately excluded.
36 changes: 19 additions & 17 deletions docs/ops/SITE-MAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,37 +4,39 @@

```text
https://timerloggedout-spec.github.io/ MARKETING / REFERRALS
brand: Autonomous AI Employees (CellCog partner)
CTA: invitation credits
nav → Why | Demo | Ops dashboard | Get started

https://timerloggedout-spec.github.io/help-wanted/ OPS DASHBOARD (canonical UI)
help-wanted KPIs / receipts / neighbor policy
nav → Marketing | Ops (here) | Monorepo | Preview | Project hub

sitemap → /help-wanted/sitemap.xml
robots → /help-wanted/robots.txt
https://timerloggedout-spec.github.io/termux-monorepo/ PROJECT HUB (thin)
NOT a dashboard clone — links + optional redirect to /help-wanted/

https://help-wanted-oversight-8w13bl125-timerloggedout-5184s-projects.vercel.app/
VERIFIED VERCEL DEPLOYMENT (current observed production deployment)
not canonical: Vercel deployment hostnames are ephemeral
source SHA: 44626f77baa64d49f452f25f6cf23ef992160ce0
https://termux-monorepo.vercel.app PREVIEW PORTAL (WIP)
https://github.com/timerloggedout-spec/termux-monorepo SOURCE
```

## Dashboard URL policy

- **Canonical public dashboard:** `https://timerloggedout-spec.github.io/help-wanted/`.
- **Vercel:** the verified deployment URL above is deployment evidence/navigation only; it is not canonical because Vercel deployment hostnames are ephemeral.
- A reachable URL is not proof of source freshness; source SHA and deployment evidence remain authoritative.
- The dashboard sitemap indexes public dashboard destinations only; internal GitHub/Actions/inspector URLs are excluded.

## Navigation intent

| From | To | Why |
|------|----|-----|
| Marketing | CellCog invitation | Referral conversion |
| Marketing | `/help-wanted/` | Public ops transparency / operator entry |
| Marketing | Vercel portal | Product demo |
| `/help-wanted/` | Marketing home | Exit ops → brand |
| `/termux-monorepo/` | `/help-wanted/` | Project Pages is hub, not product twin |
| Dashboard | `/help-wanted/sitemap.xml` | Machine-readable public discovery |
| Dashboard | `/help-wanted/robots.txt` | Crawler policy |

## Anti-patterns (fixed)
## Anti-patterns

- Publishing the **same dashboard HTML** as both project Pages root and `/help-wanted/` (false parity).
- Leaving marketing with **zero link** into the ops surface.
- Publishing the same dashboard HTML as both project Pages root and `/help-wanted/`.
- Treating a Vercel deployment hostname as a permanent canonical URL.
- Using jsDelivr as primary HTML host (`text/plain`).

Skill: `github-pages-operator` · Deploy: `help-wanted-dashboard-deploy.yml`

Agent-Identity: Grok (Administrator)
Skill: `github-pages-operator` · Deploy: `help-wanted-dashboard-deploy.yml`
Loading