wstack
v0.4.1
任務工作流程:確認規格、執行、以證據驗證、交付
wStack 讓每個任務在自己的 herdr session 裡跑成一條流程。任務筆記存放在你的 Obsidian vault,證據則貼在 pull request 上。交接指令讓工作可以在不同 session 之間傳遞。服務合約記錄每個服務的運作方式,漂移檢查會找出與程式碼不再相符的合約。
安裝
claude plugin marketplace add 21-BreakinCode/wStack && claude plugin install wstack@wstack Skill(自動啟用)
- create-handover Create a well-formed handover document in the vault handover folder of the current service, seeded from the current conversation context.
- init-org Scaffold handover_handler__initiation.md for the current ORG in $LifeOS/01Project/$ORG/.
- init-service Per-repo setup.
- pause-work Pause the work of this session.
- resume-work Resume paused work from its resume note.
- run-retro Review the past week of wStack tasks, propose improvements, and apply the ones the user picks.
- start-task Start, continue, or resume a wStack task.
- wrap-up-handovers Vault-wide daily wrap-up.
相依外掛
- answer-me-with-html@answer-me-with-html · 外部
更新紀錄
0.4.1 2026-11-23
- fix The contract scripts reject a block-style YAML list for
ignoreorpending. Before, such a list read as empty, and the check reportedfresh. Nowcontract-check.shandcontract-edit.shexit 2 and name the key. A blank line or a comment line before the first item does not hide the list. - fix
contract-check.shexits 2 on a missing or empty argument. Before, it exited 1, which means stale. - fix The guard no longer asks for a command that only reads a file that names a guarded command, such as
cat scripts/evidence-delete.sh. Every part of the command must be a read-only tool. The tools arecat,head,tail,grep,wc,ls,file,stat,diff, andnl. The git commands arediff,show,log,blame, andstatus. The tool must be called by name and not by path. A git option before the subcommand other than-C,--no-pager,-P, or--no-optional-locksgets the normal check. So does a command that runs other commands, for example withbash,eval,xargs, or-exec. A backtick or a$expansion other than a plain$namealso gets the normal check. A redirect with>also gets the normal check. - fix The guard also asks before
yarn npm publish. - fix The Deliver contract undo also removes the empty
decisions/and_archive/folders. - fix The contract tag uses the same kebab rule as
create-handover, so the orgBreakinCodegivesproject/breakin-code/<service>. - docs The text in
start-task/references/confirmation.mdsays where the gate changes the contract (step G4 and step 9). Thecontract-edit.shcomment no longer claims it is the only writer.
0.4.0 2026-11-22
- feat
/wstack:pause-workstops work in the middle, in any session. It writes a resume note first. Then it stops the background agents, shells, and processes that this session started. The note records what it stopped and what still runs. Inside a wStack task, it also sets the task status topaused. - feat
/wstack:resume-workfinds the newest pause note for the current folder. It compares the git state with the note, shows the note, and goes on from the next step. It never resets or stashes. For a paused task, it prints the command that resumes the task in its own folder. - feat A new task status,
paused, withpaused_frominspec.md./wstack:start-task --task <task_id>resumes a paused task, and the open-task list shows it. Notes for a session outside a task go in~/.wstack/pauses/. - feat
/wstack:init-servicechecks the service contract as its last step. If the contract exists, it reports the status. If there is none, it offers to launch a contract task. Outside herdr, it creates the task and prints the command that starts it. - feat
/wstack:run-retrowalks contract drift. It resolves pending write-backs, fetches the base branch, and fast-forwards only a clean base branch. It asks which stale sections to update in the same question as the proposals. It writes the contract under the lock and records the undo under## Contract. - change
/wstack:run-retrogoes on in a week with no task folders, so the drift walk still runs. - change Outside herdr, a code task gets a worktree at
~/.wstack/tasks/<task_id>, and you startclaudethere. A leftoverwstack/<slug>branch stops the launch with exit 6. - change A failed launch (exit 4 or 6) sets the task to
cancelled. - breaking The guard always asks.
WSTACK_GUARD_MODE=denyand theWSTACK_APPROVED=1prefix are gone. - fix The guard also catches
gitandghcalled by full path, and it judges each command segment. It sees a switch to the default branch behind a prefix such asenv,bash -c, orthen. - fix Web checks run playwright-cli in a scratch folder, pick a free port, and close the browser before they delete the folder. No browser and no
.playwright-cli/folder stay behind. - fix The contract scripts handle CRLF files, accept only a hex
verified_commit, keep file modes, and writeset-verifiedin one step.pending-addskips duplicates.applywarns about a new section and takes a repeatable--section. If a write fails,delete-sectionexits 2. - fix The contract hook matches compound and full-path git commands, but not an echoed one.
- fix The gate undo deletes the sections it added and restores
verified_commit. A closed pull request sets its decision files towithdrawn, and a retried write-back adds no duplicate decisions. - fix The redactor keeps short counters, such as
max_tokens=4096, and redacts every other secret value, including a 6-digit code and non-string JSON values. - fix The evidence step replaces old evidence lines, videos are never scaled up, and images are checked against
pr_media_max_mb. - docs The README, the spec, and CLAUDE.md describe the new commands, the drift walk, and the
pausedstatus.
0.3.1 2026-11-22
- fix The guard asks before a push that follows a switch to the default branch. It also asks for
git push --all, for a push inside parentheses, and forpnpm publish,yarn publish, andcargo publish. - fix The redactor uses one name list for headers, URL parameters, and JSON keys. It also redacts every plain-text evidence file before upload, and it handles text with invalid UTF-8.
- fix A repository in
local_evidence_only_reposgets a pull request with no attachments, and Deliver leaves text logs out of the body. - fix A task folder of any earlier day with the same slug now counts as taken, so the new task gets a new slug.
- fix A second retro in the same week writes
<week>-2.mdand keeps the first retro.
0.3.0 2026-11-22
- feat A contract file in the vault for each mapped service, with
plan.mdanddecisions/beside it. - feat A drift check,
contract-check.sh. It comparesverified_commitwithorigin/<base_branch>and makes no network call. - feat A SessionStart hook and a PostToolUse hook. If the contract is stale, they tell the agent. Otherwise they print nothing.
- feat A contract gate for
codeandopstasks, before the spec is written. It writescontract-brief.mdand a gate patch in the task folder. - feat A write-back in Deliver. The contract changes after the pull request merges. A closed pull request drops its pending item.
- feat A
contractwork type that sets up or rebuilds a contract. Deliver moves old vault files into_archive/<task_id>/. - feat Two agents:
contract-readerandcontract-historian. The reviewer reports acontract-mismatchfinding. - change A repository with no service mapping gets no contract. A
contracttask stops and says to run/wstack:init-service. - change Every contract write takes the lock folder
<contract>.lock. A busy lock stops the task.
0.2.0 2026-11-21
- change
retrois nowrun-retro. The command is/wstack:run-retro. - change
review-pageis nowbuild-review-page. - change
evidenceis nowcapture-evidence. - change
deliveris nowdeliver-task. - feat
/wstack:init-org(was/obsidian-kit:handover-init-org). - feat
/wstack:init-service(was/obsidian-kit:handover-init-service). - feat
/wstack:create-handover(was/obsidian-kit:handover-new). - feat
/wstack:wrap-up-handovers(was/obsidian-kit:handover-wrap-up). - change In wStack, the vault path comes from the wStack
vault_pathsetting, not fromOBSIDIAN_KIT_VAULT. - change In wStack,
init-servicewrites/handoverto the local git exclude file. It never edits.gitignore. - change In wStack, the resolvers work inside herdr worktrees and read block-list
github_orgs. - change In wStack, the archive root is fixed at
04Archive.
0.1.1 2026-11-20
- fix A launched task session now gets the idea text, because
new-task-folder.shwrites it under## Goalinspec.md.
0.1.0 2026-11-19
- feat Runs one pipeline from
/wstack:start-task: Confirmation, Execute, Verify, and Deliver, with fix loops back to Execute and to Confirmation. - feat Launches each task in its own herdr workspace and Claude session, in a task folder in your Obsidian vault.
- feat Checks the base tools with
scripts/preflight.shand prints an install command for each missing tool. - feat Builds a review page that fits a 375 px screen, with a sticky navbar and an Excalidraw diagram.
- feat Starts a reviewer agent during Verify. It writes findings into
review.md. - feat Records evidence, compresses it, and uploads it to a private Cloudflare R2 bucket. It attaches copies to pull requests.
- feat Delivers to the targets in the spec. A merge and every other step that you cannot undo wait for your approval.
- feat Supports mobile mode, which also publishes pages as Claude artifacts.
- feat Runs
/wstack:retroonce a week. A retro analyst agent reads the last 7 days of task folders and proposes improvements. - feat Guards merges, pushes to the default branch, force pushes, remote branch deletes, R2 deletes, and deploys. It asks you first.