@hybridlabor-api/aos 4.15.0 → 4.16.0

package/skills/playbooks/pb-ship/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: pb-ship
+description: >-
+  Ship the day's work in one repo: triage new issues, review every open PR
+  (description, visual recap, adversarial reviewer, shipping pre-flight and
+  quality gate), merge only after GO, then post a status recap. Use for
+  "ship it", "ship day", "merge the ready PRs", "end of work block".
+category: engineering-method
+kind: playbook
+trigger: ["ship it", "ship day", "merge the ready PRs"]
+inputs: [repo, pr_numbers?]
+requires:
+  skills: [github, triage, git-pr-review, visual-recap, bdb-shipping-skill, godmode-shipping, quick-recap, "gh (external)"]
+  agents: [reviewer]
+  mcps: ["plan (optional)"]
+  store: []
+go_points: [gh pr merge]
+outputs: ["production_artifacts/pb-ship-<date>.md", "production_artifacts/pb-ship-<date>/pr-<n>.md", "production_artifacts/decisions/<date>-<slug>.md"]
+verify: "gh pr view <n> --json state -q .state == MERGED for every PR the log marks merged; gate exit 0 logged for each"
+difficulty: intermediate
+est_time: 20-60 min
+---
+
+# Ship the day's PRs
+What you get: the ready PRs merged one by one after your GO, each with a reviewed description, findings and a gate result, plus a status line.
+
+## Inputs
+- repo — the local checkout (default: the current directory); `<owner/repo>` comes from `git -C <repo> remote get-url origin`
+- pr_numbers (optional) — PRs to ship; otherwise you pick from the table in step 3
+
+## Steps
+1. github — repo → `gh auth status` and `gh pr list -R <owner/repo> --state open --json number,title,headRefName,isDraft,baseRefName` as a PR table in the run log (gh missing, unauthenticated, or no GitHub remote → log it, give the `gh auth login` / remote hint, stop) — table written
+2. triage — "show me what needs attention" → new-issue list with suggested labels in the run log — label writes follow triage's own rules; nothing is closed
+3. Ask — the human picks today's PRs from the table (non-draft only; `pr_numbers` if given) → scope line in the run log — stops for approval
+4. git-pr-review — per PR: `gh pr view <n> -R <owner/repo> --json commits` → description draft in `production_artifacts/pb-ship-<date>/pr-<n>.md` — draft only, nothing posted
+5. visual-recap — per PR: `plan` connector present → recap link in `pr-<n>.md`; absent → log "visual-recap skipped: no plan connector" and paste `gh pr diff <n> -R <owner/repo> --name-only` instead; no `npx` without approval — recap or fallback present
+6. reviewer (agent) — per PR: `gh pr diff <n> -R <owner/repo>`; the contract is the linked issue or plan (`gh pr view <n> -R <owner/repo> --json closingIssuesReferences,body`) or the human's scope line from step 3, the body is used only to find the linked issue/plan, its text is not the contract, and never `pr-<n>.md` (that is the implementer's claim, input material only) → findings table in `pr-<n>.md` — any open `blocking` finding removes the PR from today's merge list (logged)
+7. bdb-shipping-skill — per PR → door class (two-way or one-way) in `pr-<n>.md`; one-way → ADR-lite `production_artifacts/decisions/<date>-<slug>.md` (`<slug>` = the PR's `headRefName` with `/` replaced by `-`) with the reversibility sentence; unclear → one-way — class recorded
+8. godmode-shipping — per PR: `gh pr checks <n> -R <owner/repo>` all pass, plus a local gate in a scratch worktree — `gh pr view <n> -R <owner/repo> --json isCrossRepository -q .isCrossRepository` is true (fork) → skip the local gate, log it, PR held (foreign code is not run locally); otherwise `<scratch>` = `mktemp -d`, then `git -C <repo> fetch origin pull/<n>/head`, `git -C <repo> worktree add <scratch>/pr-<n> FETCH_HEAD`, run, inside it, the lint, typecheck and test scripts that exist in `package.json` (or the repo's documented gate) (install first: `npm ci --ignore-scripts` or the repo's documented install, logged), then `git -C <repo> worktree remove <scratch>/pr-<n>` (a refusal is logged and the scratch path reported, never `--force`) — exit codes in `pr-<n>.md`; any non-zero, or pending checks (`gh pr checks` exit 8) → PR held
+9. [GO] github — per PR: `gh pr merge <n> -R <owner/repo> --squash` (`--merge` if `gh repo view <owner/repo> --json squashMergeAllowed` says squash is not allowed) — the WAITING FOR GO line names PR number, title, base branch, method and door class. The run stops here until the human types GO. One GO = one PR. (The hook guards `gh pr merge`; the other commands here are not hook-guarded.)
+10. github — `gh pr view <n> -R <owner/repo> --json state -q .state` → run log line — equals `MERGED`
+11. quick-recap — run log → final line `🟢|🟡|🔴` with merged / held / skipped counts — line written
+
+Run log: `production_artifacts/pb-ship-<date>.md` in the start directory, never committed
+
+Rules
+- Anything other than the literal GO (case-insensitive) is not a GO; a GO covers only that one step, one time.
+- A failed check stops the run: write the failure into the run log and report. No silent retries.
+- Write one run-log line per step as it completes (`N. done|skipped|failed — artifact — check result`) and `WAITING FOR GO: <step>` at each gate.

package/skills/playbooks/pb-show-build/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: pb-show-build
+description: >-
+  Build a show across lights (grandMA3), media (Resolume) and generative
+  visuals (TouchDesigner) from one cue list, offline first. A lane whose
+  console or app is not running is skipped and logged while the others
+  continue; the live rig is touched only after GO. Use for "build the show",
+  "cue list to grandMA3 Resolume and TouchDesigner", "show programming".
+category: media-eventtech
+kind: playbook
+trigger: ["build the show", "cue list to grandMA3 Resolume and TouchDesigner", "show programming"]
+inputs: [tracker, cue_list, fixture_list, media_folder]
+requires:
+  skills: [godmode-eventtech, bdbmediastorm, bdb-grandma3-mcp, bdb-resolume-mcp, bdb-touchdesigner-mcp, pb-event-tracker]
+  agents: []
+  mcps: [bdb_grandma3_mcp, bdb_resolume_mcp, bdb_td_minddesigner]
+  store: []
+go_points: [patch console, live rehearsal]
+outputs: ["cue-sheet.md", "production_artifacts/pb-show-build-<date>.md"]
+verify: "each available lane answers its ping; TD node errors empty; every cue in cue-sheet.md maps to a TD cue, Resolume clip or MA3 macro"
+difficulty: advanced
+est_time: 2-6 h
+---
+
+# Show build: lights, media, visuals
+What you get: a cue sheet and a show built per lane, rehearsed offline first, with the live rig touched only after your GO. A lane that is not available is skipped, not faked.
+
+## Inputs
+- tracker — the pb-event-tracker output (`tracker.csv`, `brief.md`)
+- cue_list — the cues: number, name, what happens in light, media and visuals
+- fixture_list — fixtures with type, mode, universe and address
+- media_folder — the clip files for Resolume
+
+## Steps
+1. Preflight — one probe per lane, each independent: `grandma3_ping` on `bdb_grandma3_mcp`; `resolume_ping` on `bdb_resolume_mcp`; `get_td_info` on `bdb_td_minddesigner` (pass: `connected: true`). MCP tools may be deferred in the harness: try to load the tool once via the harness tool search before declaring it missing. Tool not loaded, call errors or the pass condition fails → log "Missing MCP: `<server>` (`<tool>` unavailable). Start <the grandMA3 console or onPC|Resolume Arena|TouchDesigner> and check `mcpServers.<server>` in your harness config." and mark that lane `off`; the other lanes continue and every step below runs only for lanes marked `on`. All three `off` → stop and write nothing except the run log — each lane marked `on` or `off` in the run log
+2. bdbmediastorm + godmode-eventtech — tracker, cue_list, fixture_list, media_folder → `cue-sheet.md`, one row per cue with its target per lane (MA3 macro, Resolume clip, TD cue; `lane off` where a lane is missing) — stops for approval
+3. TouchDesigner lane (bdb-touchdesigner-mcp) — cue-sheet → `compose_cue_list` and `create_safety_blackout_chain`, then `get_td_node_errors` — errors empty; offline: nothing is sent to live outputs
+4. Resolume lane (bdb-resolume-mcp) — media_folder, cue-sheet → `get_composition` compared with the clips the cue sheet names — every Resolume clip in the sheet is present in the composition, missing ones listed for the human to load (no MCP tool loads media)
+5. [GO] patch console (grandMA3 lane) — `patch_fixture` for each fixture in fixture_list (patching only, no macro is executed here), the full fixture list named in the WAITING FOR GO line. The run stops here until the human types GO. This changes the live console, and no hook guards it, so this GO is the only guard. One GO = this one list, one time.
+6. [GO] live rehearsal — walk the cue sheet on live outputs with `trigger_clip` and `clear_layer` (Resolume), the TD cue list and `execute_macro` for each macro in cue-sheet.md (grandMA3), only for lanes marked `on`; the cue count, the macro list and the lanes named in the WAITING FOR GO line. The run stops here until the human types GO. Light, video and projection go live, and no hook guards it, so this GO is the only guard. One GO = one rehearsal pass.
+7. Check — every cue row in `cue-sheet.md` maps to a TD cue, Resolume clip or MA3 macro or is marked `lane off`; `get_td_node_errors` empty again after the rehearsal — mapping table and result in the run log
+
+Run log: `production_artifacts/pb-show-build-<date>.md` in the start directory, never committed
+
+Rules
+- Anything other than the literal GO (case-insensitive) is not a GO; a GO covers only that one step, one time.
+- A failed check stops the run: write the failure into the run log and report. No silent retries.
+- Write one run-log line per step as it completes (`N. done|skipped|failed — artifact — check result`) and `WAITING FOR GO: <step>` at each gate. A lane marked `off` is logged `skipped` with its Missing MCP line.

package/skills/playbooks/pb-social-pack/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: pb-social-pack
+description: >-
+  Turn a release or ship recap into a social pack: posts per platform where
+  every claim traces to a facts file, clip cut-downs per aspect ratio cut with
+  ffmpeg and checked with ffprobe, hand-off for publishing only after GO. Use
+  for "social pack for the release", "posts and clips for this launch",
+  "announce the release".
+category: media-eventtech
+kind: playbook
+trigger: ["social pack for the release", "posts and clips for this launch", "announce the release"]
+inputs: [recap, platforms, launch_video?, formats?]
+requires:
+  skills: [copywriting, quick-recap, pb-ship, pb-launch-video, "ffmpeg (external)", "ffprobe (external)"]
+  agents: []
+  mcps: []
+  store: [content-engine]
+go_points: [publish]
+outputs: ["social/<slug>/facts.md", "social/<slug>/posts.md", "social/<slug>/clips/", "social/<slug>/publish.md", "production_artifacts/pb-social-pack-<date>.md"]
+verify: "every post claim cites facts.md; ffprobe shows the asked WxH per clip"
+difficulty: intermediate
+est_time: 30-60 min
+---
+
+# Release social pack
+What you get: posts per platform and clip cut-downs from your release recap, every claim traceable to a fact, handed off for publishing after your GO.
+
+## Inputs
+- recap — release notes, or a pb-ship / pb-release-aos run log
+- platforms — for example LinkedIn, X, Instagram, YouTube Shorts
+- launch_video (optional) — an mp4 from pb-launch-video; without it the pack is posts only and step 4 is skipped
+- formats (optional) — default 9:16 (1080x1920), 1:1 (1080x1080) and 16:9 (1920x1080)
+
+## Steps
+1. Preflight — `test -d ~/.claude/skills/content-engine`; absent → log "content-engine not installed: copywriting fallback" and continue. With launch_video: `command -v ffmpeg` and `command -v ffprobe`; either missing → stop with "Missing tool: <name>. Install ffmpeg and rerun." and write nothing except the run log — probes answered
+2. Ask — recap path, platforms, slug, launch_video, formats → run log — all answered, recap file exists
+3. quick-recap — recap → `social/<slug>/facts.md`, one numbered fact per line with its source line in the recap; no fact without a source — file written
+4. content-engine (if present) or copywriting — facts.md → `social/<slug>/posts.md` per platform, each claim tagged `[F<n>]` — every claim has a tag that exists in facts.md — stops for approval
+5. ffmpeg — launch_video → `social/<slug>/clips/<name>_<WxH>.mp4` per format and per requested cut, for example `ffmpeg -ss <start> -t <seconds> -i <video> -vf "scale=<W>:<H>:force_original_aspect_ratio=increase,crop=<W>:<H>" -c:a copy <out>`, then `ffprobe -v error -select_streams v:0 -show_entries stream=width,height -of csv=p=0 <out>` — ffprobe equals the asked WxH for every clip; on a mismatch stop with "clip <file> has WxH, expected ...", do not publish
+6. [GO] publish — platforms, post texts and the full clip list shown. The run stops here until the human types GO. No publish MCP exists, so the GO releases the hand-off: posts, clips and captions in `social/<slug>/publish.md`; upload is manual unless the human named a tool in step 2 — hand-off file written
+
+Run log: `production_artifacts/pb-social-pack-<date>.md` in the start directory, never committed
+
+Rules
+- Anything other than the literal GO (case-insensitive) is not a GO; a GO covers only that one step, one time.
+- A failed check stops the run: write the failure into the run log and report. No silent retries.
+- Write one run-log line per step as it completes (`N. done|skipped|failed — artifact — check result`) and `WAITING FOR GO: <step>` at each gate.

package/skills/playbooks/pb-todo/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: pb-todo
+description: >-
+  Turn one sentence into a task line in the right to-do list, with project,
+  priority and optional due date. Use for "add a to-do", "remember to ...",
+  "put this on my list", "quick task". Nothing leaves your computer.
+category: bdb-core
+kind: playbook
+trigger: ["add a to-do", "put this on my list", "quick task"]
+inputs: [sentence, lists_folder?]
+requires:
+  skills: [memb-skill]
+  agents: []
+  mcps: []
+  store: []
+go_points: []
+outputs: ["<lists>/<project>.md", "run-log.md"]
+verify: "the approved line appears exactly once, in one list file"
+difficulty: beginner
+est_time: 2-5 min
+---
+
+# Quick to-do
+What you get: one sentence becomes a task line in the right list, with priority and project.
+
+## Inputs
+- One sentence describing the task
+- A lists folder — asked once; default `./todo/`
+- A save folder for the run log — default `./pb-todo-<date>/`
+
+## Steps
+1. Ask once — lists folder (and the sentence if not given) → `run-log.md` — the lists folder exists, or you confirm it may be created
+2. Parse the sentence → task, project, priority (P1-P3), due date if one is named — anything not stated is `?`, never guessed
+3. Pick the list file `<lists>/<project>.md` from the project — a new file only after you say yes → chosen file in `run-log.md`
+4. Show the exact line, e.g. `- [ ] P2 task text (due 2026-10-05)`, and wait for your approval — approval logged
+5. Append the approved line to the chosen list → the line appears exactly once in that file, and in no other list
+6. memb-skill — optional, ask first: store the task — memory id logged; skipped and logged if memB is not installed
+
+Nothing in this plan is sent anywhere, so there is no GO step. It only writes into the lists folder and the save folder, except the opt-in step 6 (writes memB).
+
+Run log: `run-log.md` in the save folder. One line per step as it completes (`N. done|skipped|failed — file — check result`). If a check fails, stop, write the failure into the log and tell the user.

package/skills/playbooks/pb-worktrees-land/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: pb-worktrees-land
+description: >-
+  Clean up git worktrees across your repos: list every worktree, classify it
+  as merged, remote-only, local-only or dirty, recap what each holds, and
+  remove only the merged clean ones after GO. Use for "clean up worktrees",
+  "what is in my aos-wt folders", "land my worktrees", "prune worktrees".
+category: bdb-core
+kind: playbook
+trigger: ["clean up worktrees", "land my worktrees", "prune worktrees"]
+inputs: [repos?]
+requires:
+  skills: [using-git-worktrees, github, visual-recap, pb-ship, "gh (external)"]
+  agents: []
+  mcps: ["plan (optional)"]
+  store: []
+go_points: [git worktree remove]
+outputs: ["production_artifacts/pb-worktrees-land-<date>.md"]
+verify: "git -C <repo> worktree list no longer shows any path the log marks removed; every removed branch was merged before removal"
+difficulty: intermediate
+est_time: 10-30 min
+---
+
+# Land and clean up worktrees
+What you get: an inventory of your worktrees with a class for each, and the merged clean ones removed after your GO.
+
+## Inputs
+- repos (optional) — repo paths to scan; default is the current repo's main worktree (`git rev-parse --path-format=absolute --git-common-dir`, parent dir)
+- `<owner/repo>` for each repo comes from `git -C <repo> remote get-url origin`
+
+## Steps
+1. Ask — repos (default as above) → run log in the start directory — repo list confirmed; stops for approval
+2. using-git-worktrees — per repo: `git -C <repo> worktree list --porcelain` → inventory table (path, branch, HEAD) in the run log — the main worktree, the worktree running this playbook, and any entry marked `locked` or `prunable` are `keep`
+3. github — `gh auth status` (fails → log it, skip the squash predicate, only ancestry merges count); `git -C <repo> fetch origin --prune`; default branch: `default=$(git -C <repo> symbolic-ref --short refs/remotes/origin/HEAD); default=${default#origin/}` (the command prints `origin/main`) → both in the run log — fetch fails → log it, classify against the local refs, mark the table "stale"
+4. Classify, first match wins:
+   - `dirty`: `git -C <wt> status --porcelain --ignored` shows anything other than `!!` entries; `!!` (ignored files, deleted by removal) are listed per row in the GO line
+   - detached HEAD (no `<branch>`): always `local-only`, never removed
+   - `merged`: `git -C <repo> merge-base --is-ancestor <branch> origin/<default>`, or (squash merge) `gh pr list -R <owner/repo> --head <branch> --state merged --json number,headRefOid` has a PR whose `headRefOid` equals the worktree `HEAD` (`git -C <wt> rev-parse HEAD`); a reused branch name with a different `headRefOid` does not count
+   - `remote-only`: the upstream exists and `git -C <wt> rev-list --count @{u}..HEAD` is 0 (safe on the remote, unmerged)
+   - `local-only`: everything else; commits exist only here
+   - check: every row has exactly one class plus the output of its evidence command
+5. visual-recap — per non-merged worktree: recap link; without the `plan` connector log `git -C <wt> log --oneline origin/<default>..HEAD` and `git -C <wt> diff --stat origin/<default>...HEAD` instead — one recap or fallback per row
+6. [GO] removal list = rows classified `merged` and not `keep`, shown in full with these exact commands per row: `git -C <repo> worktree remove <path>` (label the row `merged (empty)` when `git -C <repo> rev-parse <branch>` equals `git -C <repo> rev-parse origin/<default>`; never `--force`; git refuses dirty trees), then `git -C <repo> branch -d <branch>` (`-d` refuses squash-merged branches → log "branch kept, needs -D, human decides"; never `-D`). The run stops here until the human types GO. GO covers exactly that list, once. The hook does not guard these commands, so GO is by contract. Never remove dirty, remote-only, local-only or `keep` rows, and never use `rm -r`.
+7. Verify — `git -C <repo> worktree list` → removed paths are gone, kept rows unchanged
+8. Hand-off — remote-only and local-only rows → next action per row in the run log ("land via /pb-ship", or "push needs GO in that worktree") — nothing runs
+
+Run log: `production_artifacts/pb-worktrees-land-<date>.md` in the start directory, never committed
+
+Rules
+- Anything other than the literal GO (case-insensitive) is not a GO; a GO covers only that one step, one time.
+- A failed check stops the run: write the failure into the run log and report. No silent retries.
+- Write one run-log line per step as it completes (`N. done|skipped|failed — artifact — check result`) and `WAITING FOR GO: <step>` at each gate.