@ikon85/agent-workflow-kit 0.43.0 → 0.44.0

package/README.md

@@ -169,9 +169,20 @@ enter outside the plan funnel and feed straight into Execute:
 > handoff.* The land phase puts mechanical gates in front of the commit.
 
 - **`wrapup`** — the land-and-clean closeout: make the branch landable, enforce
-  the PR body contract, merge the PR, reconcile the board, sweep merged branches,
-  and surface anything still open. It does not replace live verification; verify
-  the user outcome before landing.
+  the PR body contract, merge the PR, reconcile the board, tear the finished
+  worktree down, retire the branch, sweep merged branches, and surface anything
+  still open. It does not replace live verification; verify the user outcome
+  before landing. Interrupted halfway? Re-run it — every step re-reads present
+  state (does the PR exist, is it merged, is the worktree still there?) and skips
+  what is already done, so there is no separate resume mode and no journal to
+  repair.
+- **Teardown asks your repository, not a config file.** Finishing a worktree
+  classifies it with git's own file taxonomy at the moment it acts: a tracked
+  change or an unmerged path blocks, an untracked file your repo does *not*
+  ignore blocks with a bounded report, and an ignored entry is scratch that dies
+  with the worktree. Making something disposable therefore means ignoring it —
+  the full rules, the `.env*` exception, and the breaking change from the pattern
+  keys are in [the worktree lifecycle](#the-worktree-lifecycle).
 - **The pre-commit / pre-push gate fires automatically** — TypeScript, lint, and
   contract guards block a broken commit or push. You don't run a skill here; the
   gate was installed once at setup (`git-guardrails` / `setup-pre-commit`, both
@@ -307,6 +318,71 @@ Status stage names are yours too: scripts and skills address stages by semantic
 your option names, e.g. `board-sync.py add --status-role spec`), so a board in
 any language works — map each role once, rename an option with one profile edit.
 
+### The worktree lifecycle
+
+An optional capability, offered once by `/setup-workflow` and recorded in your
+own `docs/agents/workflow-capabilities.json`. Enabled, it gives each build its
+own linked worktree: `python3 scripts/worktree-lifecycle/setup.py` cuts the
+branch, creates the worktree from your naming templates, and runs your project's
+setup steps; on Claude Code a set of hook adapters keeps edits, verification
+commands, and Git mutations in the checkout they belong to; and `wrapup` tears
+the worktree down after the merge. A worktree belongs to a **build** — a session
+that only plans or grills stays in the main checkout, keeps its scratch on disk,
+and lands its durable output as ordinary content.
+
+The profile carries structural facts only: where worktrees live
+(`worktreeRoot`), how branches and paths are named (`branchTemplate`,
+`contentBranchTemplate`, `pathTemplate`, `branchRegex`), which branches are
+protected (`mainBranches`, `protectedBranches`), the setup command and its
+ordered steps, and the command patterns that must run inside the active
+worktree. Keys the loader does not know are ignored in silence, so a profile
+written for an older kit keeps working without warning noise.
+
+**Teardown authority is the repository's current state, read at the moment of
+action, and nothing else.** It classifies the worktree with git's own file
+taxonomy over your standard exclude sources — the repository's `.gitignore`
+files, `.git/info/exclude`, and your global excludes file:
+
+| What git reports | What teardown does |
+|---|---|
+| a tracked modification, or an unmerged path | blocks, and names it |
+| an untracked file you do **not** ignore | blocks with a bounded report — a count plus the top directories, never a page-long path dump |
+| an ignored entry | scratch: deleted together with the worktree |
+
+Two rules sit on top of that taxonomy. An `.env*` file (basename glob) is the
+single hardcoded exception — ignored, yet potentially irreplaceable — so it is
+removed only when it is byte-identical to the file at the same relative path in
+your main checkout; divergent, missing there, or not a plain file stops teardown
+and names the exact file. An ignored symlink is unlinked, never followed, and
+only while its target stays inside the worktree: an absolute, escaping, dangling,
+or since-changed target keeps the worktree and names the link.
+
+Branch retirement is authorized, never assumed. A branch that is an ancestor of
+the freshly fetched protected branch is deleted normally. A branch that is not is
+force-deleted only when exactly one merged pull request matches it completely —
+your repository as base, no fork head, the same head and base ref — and that
+PR's head commit still equals the branch tip when the tip is re-read immediately
+before deletion. Anything else keeps the branch and reports why. Without
+platform access this degrades to ancestry only, and says so.
+
+For a read-only inventory of every linked worktree and local branch — issue, PR,
+merge, age, and removal facts, nothing removed — run
+`python3 scripts/worktree-lifecycle/cleanup.py sweep`.
+
+> **Breaking — the deletion pattern keys are gone, with no migration.** Earlier
+> releases configured what teardown could delete with
+> `worktreeLifecycle.scratchPatterns` and
+> `wrapup.landingGeneratedArtifactPatterns`. Both keys are removed. Deletion
+> policy now has exactly one configuration surface: the ignore mechanism. There
+> is nothing to migrate — a profile that still carries either key simply keeps
+> it as consumer data; nothing reads it, nothing warns, nothing rewrites it —
+> but the behaviour did change. If you used a pattern to make a file deletable,
+> ignore the file instead; `/setup-workflow` offers (never installs) the ignore
+> rules for the planning artefacts the shipped skills write. And note the risk
+> this deliberately accepts: a file you keep gitignored inside a worktree is
+> deletable at teardown unless it matches `.env*`. The decision record is
+> `docs/adr/0009-teardown-authority-is-stateless-repository-classification.md`.
+
 ### What's yours vs. the kit's
 
 `init` records a sha256 of every file it installs. That's the line between the
@@ -425,8 +501,42 @@ Explicit fork with its own identity and update line instead.
 
 ## Upgrade notes
 
+### 0.44.0 — teardown classifies, and the package ships less
+
+**Action required only if your profile configured teardown patterns.**
+
+`worktreeLifecycle.scratchPatterns` and `wrapup.landingGeneratedArtifactPatterns`
+are gone, with no migration. Teardown now classifies what it may delete from the
+repository's own ignore rules at the moment it acts, so the ignore mechanism is
+the single place deletion policy is configured. A profile still carrying either
+key simply keeps it, unread — nothing breaks, but the key no longer does
+anything. Move whatever those patterns protected into `.gitignore` (to make it
+deletable scratch) or out of the ignore rules (to make it a blocker).
+
+Two consequences worth knowing before your next `/wrapup`:
+
+- A gitignored file that is not `.env*` is deletable at teardown. That is the
+  deliberate trade for having no pattern list to maintain.
+- The session-teardown CLI `scripts/worktree-lifecycle/session.py` is removed,
+  along with both of its recovery flags. Re-running the command is the recovery
+  route; there is no attempt journal to repair. Worktree creation now goes
+  through `scripts/worktree-lifecycle/setup.py`.
+
+**The long "removed:" list in the release notes below is mostly narrower
+packaging, not deleted features.** Tests, this repository's own ADRs and
+research notes, and its build tooling stopped being published into
+`node_modules`; none of them was ever installed into a consumer repo by `init`,
+and every one of the 338 installed files is unchanged in scope. The only entry
+that removes something consumers could have used is `session.py`.
+
 ### 0.38.0 — explicit landing-artifact policy
 
+**Superseded — no action required.** A later release removed the pattern keys
+without a migration: teardown now classifies from the repository's own ignore
+rules, so `wrapup.landingGeneratedArtifactPatterns` is no longer read, the
+requirement is no longer registered, and a profile still carrying the key
+simply keeps it. The original note is kept below as history.
+
 Existing consumers must run `setup-workflow` once after `kit-update`, review
 the generated `wrapup.landingGeneratedArtifactPatterns` decision in
 `docs/agents/workflow-capabilities.json`, and commit that profile change.
@@ -469,6 +579,135 @@ the old way. Decision record:
 
 ## Release notes
 
+### 0.44.0
+
+- added: `scripts/worktree-lifecycle/classify.py`
+- removed: `docs/adr/0001-consumer-divergence-policy.md`
+- removed: `docs/adr/0002-capability-gated-orchestration.md`
+- removed: `docs/adr/0003-kit-core-and-project-extension-lifecycle.md`
+- removed: `docs/adr/0004-release-intent-is-a-version-tag.md`
+- removed: `docs/adr/0005-to-issues-is-the-planning-facade.md`
+- removed: `docs/adr/0006-routing-knowledge-access-and-policy-are-separate.md`
+- removed: `docs/adr/0007-session-teardown-requires-provenance-bound-ownership.md`
+- removed: `docs/adr/0008-planning-ignore-rules-are-offered-never-installed.md`
+- removed: `docs/adr/0009-teardown-authority-is-stateless-repository-classification.md`
+- removed: `docs/adr/0010-model-roster-replaces-the-optimization-dial.md`
+- removed: `docs/agents/board-sync.md`
+- removed: `docs/agents/code-review.md`
+- removed: `docs/agents/workflow-capabilities.json`
+- removed: `docs/research/agent-task-taxonomy-benchmark-coverage.md`
+- removed: `docs/research/benchlm-routing-source.md`
+- removed: `docs/research/consumer-owned-protocol-files.md`
+- removed: `docs/research/frontend-agent-benchmarks.md`
+- removed: `docs/research/model-effort-routing-benchmarks.md`
+- removed: `docs/research/provider-neutral-agent-routing.md`
+- removed: `docs/research/wave-152-consumer-acceptance.md`
+- removed: `docs/research/wave-43-script-hook-census.md`
+- removed: `scripts/build-kit.mjs`
+- removed: `scripts/build-kit.test.mjs`
+- removed: `scripts/census-contract.test.mjs`
+- removed: `scripts/census/census.test.mjs`
+- removed: `scripts/census/state.test.mjs`
+- removed: `scripts/census/transaction.test.mjs`
+- removed: `scripts/check-kit-staleness.mjs`
+- removed: `scripts/check-kit-staleness.test.mjs`
+- removed: `scripts/codex-exec-scenarios/fake-codex.mjs`
+- removed: `scripts/codex-exec.test.mjs`
+- removed: `scripts/grill-census-wiring-guard.mjs`
+- removed: `scripts/grill-census-wiring-guard.test.mjs`
+- removed: `scripts/kit-release.test.mjs`
+- removed: `scripts/kit-update-pr.test.mjs`
+- removed: `scripts/lib/audit-refs.mjs`
+- removed: `scripts/lib/scrub.mjs`
+- removed: `scripts/lib/scrub.test.mjs`
+- removed: `scripts/memory-lifecycle/memory-lifecycle.test.mjs`
+- removed: `scripts/portability_profile_scan.py`
+- removed: `scripts/release-delta-guard.test.mjs`
+- removed: `scripts/release-parity.test.mjs`
+- removed: `scripts/release-state.test.mjs`
+- removed: `scripts/test_anchor_table.py`
+- removed: `scripts/test_board_bootstrap.py`
+- removed: `scripts/test_board_sync.py`
+- removed: `scripts/test_board_sync_create_idempotency.py`
+- removed: `scripts/test_board_sync_wave_title.py`
+- removed: `scripts/test_census_backstop.py`
+- removed: `scripts/test_census_forward_contract.py`
+- removed: `scripts/test_census_update_contract.test.mjs`
+- removed: `scripts/test_codex_adapter_sync_contract.py`
+- removed: `scripts/test_dist_kit_smoke.py`
+- removed: `scripts/test_drift_guard_diagnostics.py`
+- removed: `scripts/test_issue_claim_contract.py`
+- removed: `scripts/test_kit_docs_language_census.py`
+- removed: `scripts/test_marker_lib.py`
+- removed: `scripts/test_orchestrate_wave_contract.py`
+- removed: `scripts/test_pr_body_check.py`
+- removed: `scripts/test_profile_globs.py`
+- removed: `scripts/test_program_planning_contract.py`
+- removed: `scripts/test_release_authorization_contract.py`
+- removed: `scripts/test_render_anchor.py`
+- removed: `scripts/test_retro_wrapup_contract.py`
+- removed: `scripts/test_skill_code_review_seed.py`
+- removed: `scripts/test_skill_codex_exec_lifecycle.py`
+- removed: `scripts/test_skill_frontmatter_lint.py`
+- removed: `scripts/test_skill_gh_lint.py`
+- removed: `scripts/test_skill_language_census.py`
+- removed: `scripts/test_skill_optional_readiness.py`
+- removed: `scripts/test_skill_portability_lint.py`
+- removed: `scripts/test_skill_precommit_template.py`
+- removed: `scripts/test_skill_publish_audit.py`
+- removed: `scripts/test_skill_readiness_contract.py`
+- removed: `scripts/test_skill_readiness_preflight.py`
+- removed: `scripts/test_skill_required_readiness.py`
+- removed: `scripts/test_skill_selfcontainment_lint.py`
+- removed: `scripts/test_skill_setup_workflow_seeds.py`
+- removed: `scripts/test_skill_stale_name_lint.py`
+- removed: `scripts/test_skill_surface_refs.py`
+- removed: `scripts/test_skill_trailing_artifact_lint.py`
+- removed: `scripts/test_tdd_contract.py`
+- removed: `scripts/test_worktree_ignore_seed.py`
+- removed: `scripts/test_worktree_setup_base_guard.py`
+- removed: `scripts/test_worktree_wrapup_contract.py`
+- removed: `scripts/test_wrapup_land.py`
+- removed: `scripts/worktree-lifecycle/session.py`
+- changed: `.agents/skills/grill-me/SKILL.md`
+- changed: `.agents/skills/grill-with-docs/SKILL.md`
+- changed: `.agents/skills/kit-update/SKILL.md`
+- changed: `.agents/skills/orchestrate-wave/SKILL.md`
+- changed: `.agents/skills/setup-workflow/SKILL.md`
+- changed: `.agents/skills/setup-workflow/board-sync.md`
+- changed: `.agents/skills/setup-workflow/workflow-advisories.md`
+- changed: `.agents/skills/setup-workflow/worktree-lifecycle.md`
+- changed: `.agents/skills/to-issues/SKILL.md`
+- changed: `.agents/skills/wrapup/SKILL.md`
+- changed: `.claude/skills/grill-me-codex/SKILL.md`
+- changed: `.claude/skills/grill-me/SKILL.md`
+- changed: `.claude/skills/grill-with-docs-codex/SKILL.md`
+- changed: `.claude/skills/grill-with-docs/SKILL.md`
+- changed: `.claude/skills/kit-update/SKILL.md`
+- changed: `.claude/skills/orchestrate-wave/SKILL.md`
+- changed: `.claude/skills/setup-workflow/SKILL.md`
+- changed: `.claude/skills/setup-workflow/board-sync.md`
+- changed: `.claude/skills/setup-workflow/workflow-advisories.md`
+- changed: `.claude/skills/setup-workflow/worktree-lifecycle.md`
+- changed: `.claude/skills/to-issues/SKILL.md`
+- changed: `.claude/skills/wrapup/SKILL.md`
+- changed: `README.md`
+- changed: `agent-workflow-kit.package.json`
+- changed: `package.json`
+- changed: `scripts/marker_lib.py`
+- changed: `scripts/profile_globs.py`
+- changed: `scripts/release-delta-guard.mjs`
+- changed: `scripts/worktree-lifecycle/README.md`
+- changed: `scripts/worktree-lifecycle/capabilities.json`
+- changed: `scripts/worktree-lifecycle/cleanup.py`
+- changed: `scripts/worktree-lifecycle/core.py`
+- changed: `scripts/worktree-lifecycle/ignore_seed.py`
+- changed: `scripts/worktree-lifecycle/profile.py`
+- changed: `scripts/worktree-lifecycle/setup.py`
+- changed: `scripts/wrapup-land.py`
+- changed: `src/consumer-migrations.json`
+- changed: `src/lib/bundle.mjs`
+
 ### 0.43.0
 
 - removed: `docs/agents/domain.md`
@@ -1470,10 +1709,13 @@ skip these on a Codex-first repo): `write-a-skill`, `git-guardrails-claude-code`
 `codex-build`.
 
 **Helper scripts** — `board_config.py` (profile loader), `board-sync.py`,
-`execute-ready-check.py`, `pr-body-check.py`, the handoff drift-guard, the
-skill-drift-hint and board-status hooks (Claude only — wired via
-`.claude/settings.json`, no Codex mirror), the opt-in LoC-offender gate, and the
-wave-anchor + security-audit-runbook templates.
+`execute-ready-check.py`, `pr-body-check.py`, `wrapup-land.py` (the landing and
+teardown driver), the `scripts/worktree-lifecycle/` set (setup entry, teardown
+classification, cleanup plus the read-only sweep, and the planning-artifact
+ignore-rule offer), the handoff drift-guard, the skill-drift-hint, board-status
+and worktree hooks (Claude only — wired via `.claude/settings.json`, no Codex
+mirror), the opt-in LoC-offender gate, and the wave-anchor +
+security-audit-runbook templates.
 
 This kit deliberately ships without a test suite (a leaner `npx` payload) — the
 scripts and skills are tested in the maintainer's private source repo they're

package/agent-workflow-kit.package.json

@@ -1,5 +1,5 @@
 {
-  "kitVersion": "0.43.0",
+  "kitVersion": "0.44.0",
   "files": [
     {
       "path": ".agents/skills/ask-matt/SKILL.md",
@@ -207,7 +207,7 @@
       "ownerSkill": "grill-me",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "b13087563adda186f62aa6206a9233034310ff2458535362246294a45e03079f",
+      "sha256": "f23fe7dfbe7e546cfbce5af8467d7d119008e4379f47f2904b53cb6cab9ec538",
       "mode": 420,
       "origin": "kit"
     },
@@ -247,7 +247,7 @@
       "ownerSkill": "grill-with-docs",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "93694d55fe8d164c4c0e0eef27529bd1211acdaddc18224a921c2b0f3b5a10ed",
+      "sha256": "677068c8ed1bf024cf36dda04e8843dd39e00dbcc1c6a45145036c5eb7ffc176",
       "mode": 420,
       "origin": "kit"
     },
@@ -377,7 +377,7 @@
       "ownerSkill": "kit-update",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "15d265be0c2b3b73c32f786644d271fffb4b269cf8e3c624c61296fe838dda9e",
+      "sha256": "4ab23b5ec7df6b89dd0e63ae74956aee282231c0c5b497eef52f142a3ae52a4e",
       "mode": 420,
       "origin": "kit"
     },
@@ -447,7 +447,7 @@
       "ownerSkill": "orchestrate-wave",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "fab4fb2f4d6fee820c9b7a737fa955a5ea2cd398987246bd7a04c5fba2c75b26",
+      "sha256": "d4afe0ac87fe7d6f3d812c47872ad6c73909a6af170847c757fcad72f839a364",
       "mode": 420,
       "origin": "kit"
     },
@@ -587,7 +587,7 @@
       "ownerSkill": "setup-workflow",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "c6855a479c030f93be30f6fb65b36b8ca317251f9627fd3f6f0f994d9a8b64fb",
+      "sha256": "3332296c656fc44ac65ddbbe619795bfc18c81478ddf8c621f78cbf8189fd4b5",
       "mode": 420,
       "origin": "kit"
     },
@@ -687,7 +687,7 @@
       "ownerSkill": "setup-workflow",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "29c61411aa42a3f456b3f27fdd15552654b64ef2d72b321bc9c9e11229745626",
+      "sha256": "bb9c0fed0a1b7bfe211cf55f2fd352447e88f9078002ec289f41c2878d1510da",
       "mode": 420,
       "origin": "kit"
     },
@@ -737,7 +737,7 @@
       "ownerSkill": "setup-workflow",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "6ff4ad3980f0802b3b041e051d86fb4df7a65884c7ded98ff878e2cd584d80f1",
+      "sha256": "b6c62eff8a5bada4f322d9b7dc7df2ff5e695b2c509f9e532ee4bc7411de166f",
       "mode": 420,
       "origin": "kit"
     },
@@ -757,7 +757,7 @@
       "ownerSkill": "setup-workflow",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "f9fb7ef6d4f4e1ed603a5a480d8f97508fd6c99def8194c7ba0a95c62fd3c743",
+      "sha256": "3f22e152083353e4adf143044a4ede56563f85968432420ab04260abe98b82f9",
       "mode": 420,
       "origin": "kit"
     },
@@ -857,7 +857,7 @@
       "ownerSkill": "to-issues",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "a675a5140c53b76e785fc105bf71c981b9f3eafefdd220bdb28e01c2f1b6f180",
+      "sha256": "c118e8561a4e47de777a60d1773333e1bff49cddb42ee69504451f57f02e16cc",
       "mode": 420,
       "origin": "kit"
     },
@@ -997,7 +997,7 @@
       "ownerSkill": "wrapup",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "de5d451d23b019498104bd8e0ebcbf3385f37aad822496bdb0c47d7021de8761",
+      "sha256": "da15a597d296e57a1d9d42ab6ebee218d777dc544feb3b7cb9f9a3318925e39e",
       "mode": 420,
       "origin": "kit"
     },
@@ -1469,7 +1469,7 @@
       "ownerSkill": "grill-me-codex",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "19be44dde597b83200fb3622f2643be6e08a50192b380a61838286f8e2bdb241",
+      "sha256": "65c312a2f738897ccafb3a1af23607c0b1bd9b156ba6f7d2cde162fc919fb161",
       "mode": 420,
       "origin": "kit"
     },
@@ -1489,7 +1489,7 @@
       "ownerSkill": "grill-me",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "a63331339ed4e018d770face4e7cfe483225ce758a4a1302f39a50239e8187e1",
+      "sha256": "eed0e4009fadc98b892d2b645cfa7a4b5735dd71795d7b28a2f4ef9c6eff891f",
       "mode": 420,
       "origin": "kit"
     },
@@ -1529,7 +1529,7 @@
       "ownerSkill": "grill-with-docs-codex",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "2b53b723e481c6895fc184b572441cd025b40315f95b079d5e46d7df13951974",
+      "sha256": "d1a85fa5e00c63c78b545d61eb589fa48af11d097a789f23af7d69fa69cd2461",
       "mode": 420,
       "origin": "kit"
     },
@@ -1569,7 +1569,7 @@
       "ownerSkill": "grill-with-docs",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "0cb1b41fc6bde94d3e71f3377cbb15b9d7a9a4089df66f591fc907dc19b6c1b5",
+      "sha256": "eb3527e99f8174d46eead925c1611d43db593596d5758bb335a4af62f9899d31",
       "mode": 420,
       "origin": "kit"
     },
@@ -1699,7 +1699,7 @@
       "ownerSkill": "kit-update",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "15d265be0c2b3b73c32f786644d271fffb4b269cf8e3c624c61296fe838dda9e",
+      "sha256": "4ab23b5ec7df6b89dd0e63ae74956aee282231c0c5b497eef52f142a3ae52a4e",
       "mode": 420,
       "origin": "kit"
     },
@@ -1769,7 +1769,7 @@
       "ownerSkill": "orchestrate-wave",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "fab4fb2f4d6fee820c9b7a737fa955a5ea2cd398987246bd7a04c5fba2c75b26",
+      "sha256": "d4afe0ac87fe7d6f3d812c47872ad6c73909a6af170847c757fcad72f839a364",
       "mode": 420,
       "origin": "kit"
     },
@@ -1929,7 +1929,7 @@
       "ownerSkill": "setup-workflow",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "c6855a479c030f93be30f6fb65b36b8ca317251f9627fd3f6f0f994d9a8b64fb",
+      "sha256": "3332296c656fc44ac65ddbbe619795bfc18c81478ddf8c621f78cbf8189fd4b5",
       "mode": 420,
       "origin": "kit"
     },
@@ -2029,7 +2029,7 @@
       "ownerSkill": "setup-workflow",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "29c61411aa42a3f456b3f27fdd15552654b64ef2d72b321bc9c9e11229745626",
+      "sha256": "bb9c0fed0a1b7bfe211cf55f2fd352447e88f9078002ec289f41c2878d1510da",
       "mode": 420,
       "origin": "kit"
     },
@@ -2079,7 +2079,7 @@
       "ownerSkill": "setup-workflow",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "6ff4ad3980f0802b3b041e051d86fb4df7a65884c7ded98ff878e2cd584d80f1",
+      "sha256": "b6c62eff8a5bada4f322d9b7dc7df2ff5e695b2c509f9e532ee4bc7411de166f",
       "mode": 420,
       "origin": "kit"
     },
@@ -2099,7 +2099,7 @@
       "ownerSkill": "setup-workflow",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "f9fb7ef6d4f4e1ed603a5a480d8f97508fd6c99def8194c7ba0a95c62fd3c743",
+      "sha256": "3f22e152083353e4adf143044a4ede56563f85968432420ab04260abe98b82f9",
       "mode": 420,
       "origin": "kit"
     },
@@ -2207,7 +2207,7 @@
       "ownerSkill": "to-issues",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "7cc957d9883ac205904df9fc3ba2d29e7f13661b6511b355f56115ac992e2a09",
+      "sha256": "d3f191639369dcff02de806427f78b6ec434da15ad697bfa4e026b7510a7488e",
       "mode": 420,
       "origin": "kit"
     },
@@ -2347,7 +2347,7 @@
       "ownerSkill": "wrapup",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "de5d451d23b019498104bd8e0ebcbf3385f37aad822496bdb0c47d7021de8761",
+      "sha256": "da15a597d296e57a1d9d42ab6ebee218d777dc544feb3b7cb9f9a3318925e39e",
       "mode": 420,
       "origin": "kit"
     },
@@ -2587,7 +2587,7 @@
       "path": "scripts/marker_lib.py",
       "kind": "script",
       "installRole": "consumer",
-      "sha256": "015a22041ee7a66609123c1944e915a869f208789914811674c0c350e07a7b11",
+      "sha256": "ca969bb04d307778ad6ee465b6e59df5761d419e5c348c202829fba0c93c5f90",
       "mode": 420,
       "origin": "kit"
     },
@@ -2635,7 +2635,7 @@
       "path": "scripts/profile_globs.py",
       "kind": "script",
       "installRole": "consumer",
-      "sha256": "dd11f6e2513eb43813242ace8f4ea00e10b0fa33f4e13fd125afa4a654d61eff",
+      "sha256": "7eafb59aa5a881194741894031122ea92ba4b7f97561c8f9e81b2f6f625210d7",
       "mode": 493,
       "origin": "kit"
     },
@@ -2699,7 +2699,7 @@
       "path": "scripts/release-delta-guard.mjs",
       "kind": "script",
       "installRole": "maintainer",
-      "sha256": "41d9fd9c86324f1428a3de04f2bfcb630e868525d88a8864d7bdfc2954e00414",
+      "sha256": "486c9d162a97fbfb64d456135916fdaa4551f7226a17cea57b425258e5d224e1",
       "mode": 420,
       "origin": "kit"
     },
@@ -2795,7 +2795,15 @@
       "path": "scripts/worktree-lifecycle/capabilities.json",
       "kind": "doc",
       "installRole": "consumer",
-      "sha256": "689910f11b51a5f2938989a82378332375e614f2684fe4cc48db7a4ce5c12f4b",
+      "sha256": "761512ca2983240ad10c7b7a5e08f41a6316227284056e2b156deeb47109a544",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "scripts/worktree-lifecycle/classify.py",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "1591e0980193c6053aac722466c8325a2167c005ee282dbe806f0072527bdec8",
       "mode": 420,
       "origin": "kit"
     },
@@ -2803,7 +2811,7 @@
       "path": "scripts/worktree-lifecycle/cleanup.py",
       "kind": "script",
       "installRole": "consumer",
-      "sha256": "4671aa6d40590abe103509916abda34e1717b43f7f0f521fc7fe90e1e29be50d",
+      "sha256": "c8b8bbdca98dc215ed87c4b928f7c26ea392d125d6960500a4f30d6a452a42f4",
       "mode": 493,
       "origin": "kit"
     },
@@ -2811,7 +2819,7 @@
       "path": "scripts/worktree-lifecycle/core.py",
       "kind": "script",
       "installRole": "consumer",
-      "sha256": "2c89528a7beb629eb8b61ced26dd68cd8cd19fe2d37a4934badf74cede51e832",
+      "sha256": "2429325f411be1df335f77fa600765821397d6f33fcb99d328d0fe2e5dfefbc7",
       "mode": 420,
       "origin": "kit"
     },
@@ -2819,7 +2827,7 @@
       "path": "scripts/worktree-lifecycle/ignore_seed.py",
       "kind": "script",
       "installRole": "consumer",
-      "sha256": "defd667ed94301cffb0f08e0a910873c246be267cb458adf40f5e7b2109ae4d0",
+      "sha256": "f8792c358fcc6506146aa45c7fc9defb5fc57cfdee7cd7a51c073a6573515dd5",
       "mode": 493,
       "origin": "kit"
     },
@@ -2835,7 +2843,7 @@
       "path": "scripts/worktree-lifecycle/profile.py",
       "kind": "script",
       "installRole": "consumer",
-      "sha256": "4a76462e4a9f7c4c3fd1b199217f8c68b9946c49bc934eef7bc888244bdbd16f",
+      "sha256": "7a5d03985430aa4d3256a045aa9092e13e45cd11f0840342015695b427875260",
       "mode": 420,
       "origin": "kit"
     },
@@ -2843,23 +2851,15 @@
       "path": "scripts/worktree-lifecycle/README.md",
       "kind": "doc",
       "installRole": "consumer",
-      "sha256": "a5e89b57eeb817075214af30e6504f4077434b9f90fb08a19aea028144073448",
+      "sha256": "59049afc06aa71a16a1422e3a6c6a93c21ef85dbaca016b99df15918ac268873",
       "mode": 420,
       "origin": "kit"
     },
-    {
-      "path": "scripts/worktree-lifecycle/session.py",
-      "kind": "script",
-      "installRole": "consumer",
-      "sha256": "18c2794aaf9fef96a15000c515b600345d3bf1715e23b07d0646156e601ea35a",
-      "mode": 493,
-      "origin": "kit"
-    },
     {
       "path": "scripts/worktree-lifecycle/setup.py",
       "kind": "script",
       "installRole": "consumer",
-      "sha256": "fa84d0056b24263389e0d17746abc8dc0afbd0152c323a62a6d7590ca9c62cac",
+      "sha256": "d429343da97ebb12ff0e5ce087c8dca41edb3e2592bf32ddb43321c34c787600",
       "mode": 493,
       "origin": "kit"
     },
@@ -2867,7 +2867,7 @@
       "path": "scripts/wrapup-land.py",
       "kind": "script",
       "installRole": "consumer",
-      "sha256": "de41f6c7bee1f67f3f25db4c7750a3caca422be5749012c6d5402cfeed91b2f7",
+      "sha256": "ae78af54ff292bfb6513be7da0f474727fb14eab3b3aa1a6d8548cb33735550e",
       "mode": 493,
       "origin": "kit"
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikon85/agent-workflow-kit",
-  "version": "0.43.0",
+  "version": "0.44.0",
   "description": "Portable AI-agent workflow skills (plan → execute → land → learn) for Claude Code & Codex — grilling, TDD, diagnosis, two-axis code review, cross-model Codex review, design & domain-modeling, plus a skill router (ask-matt). npx init/update/diff/uninstall.",
   "type": "module",
   "bin": {
@@ -23,17 +23,21 @@
     ".agents/",
     "assets/",
     "scripts/",
-    "docs/",
-    "!docs/agents/issue-tracker.md",
-    "!docs/agents/triage-labels.md",
-    "!docs/agents/domain.md",
-    "!docs/agents/skills/spec-self-critique.md",
-    "!docs/agents/skills/orchestrate-wave.md",
-    "!docs/agents/skills/local-ci.md",
-    "!docs/agents/skills/git-worktree-recover.md",
-    "!docs/agents/skills/audit-skills.md",
-    "!docs/agents/skills/security-audit.md",
-    "!docs/conventions/spec-completeness.md",
+    "!scripts/**/*.test.mjs",
+    "!scripts/test_*.py",
+    "!scripts/codex-exec-scenarios/",
+    "!scripts/lib/",
+    "!scripts/build-kit.mjs",
+    "!scripts/check-kit-staleness.mjs",
+    "!scripts/grill-census-wiring-guard.mjs",
+    "!scripts/portability_profile_scan.py",
+    "docs/index.html",
+    "docs/methodology.html",
+    "docs/methodology.svg",
+    "docs/workflow.html",
+    "docs/workflow.png",
+    "docs/agents/security-audit-runbook-template.md",
+    "docs/agents/wave-anchor-template.md",
     "src/",
     "agent-workflow-kit.package.json",
     "LICENSE",

package/scripts/marker_lib.py

@@ -9,6 +9,9 @@ from collections.abc import Callable
 
 
 MARKER_KINDS = frozenset({
+    # The census refresh tracker: one open issue per repository, so a second
+    # session updates the issue the first one opened.
+    "census-refresh-source",
     "prd-source-id",
     "program-leaf-source",
     "program-stub-source",