@ankhorage/devtools 2.8.4 → 2.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
 
4
4
  # Ankhorage Devtools
5
5
 
6
- ![license: MIT](././paradox/badges/license.svg) ![npm: v2.8.4](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: configured](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
6
+ ![license: MIT](././paradox/badges/license.svg) ![npm: v2.9.1](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: configured](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
7
7
 
8
8
  Owns shared repository automation, managed development tooling, workflows, and agent standards for Ankhorage TypeScript projects.
9
9
 
@@ -29,6 +29,7 @@ async function renderAgentsFile(targetDirectory) {
29
29
  renderStandaloneRepositoryInstructions(),
30
30
  renderRequiredRepositoryInstructions(),
31
31
  renderDocumentationInstructions(),
32
+ renderGitHubTaskLifecycleInstructions(),
32
33
  renderPullRequestInstructions(),
33
34
  renderSkillScriptInstructions(),
34
35
  ].join('');
@@ -36,10 +37,8 @@ async function renderAgentsFile(targetDirectory) {
36
37
  return `# AGENTS.md
37
38
 
38
39
  <!-- This file is managed by @ankhorage/devtools. -->
39
-
40
40
  ${nextAgentsBlock}
41
- ${repositorySections}
42
- ${sections}`;
41
+ ${repositorySections}${sections}`;
43
42
  }
44
43
  /*** Preserve Next.js's complete managed instruction block when Next owns the target. */
45
44
  async function readNextAgentsBlockAsync(targetDirectory, manifest) {
@@ -131,6 +130,30 @@ Paradox \`/*** ... */\` comments in \`src\` and leading \`@usage\` comments in r
131
130
  generated output. The managed release workflow runs \`bun run docs\` after the package version bump
132
131
  and commits the regenerated artifacts in the release commit.
133
132
 
133
+ `;
134
+ }
135
+ /*** Render the mandatory GitHub task isolation, delivery, and cleanup policy. */
136
+ function renderGitHubTaskLifecycleInstructions() {
137
+ return `## GitHub task lifecycle and workspace cleanup
138
+
139
+ - **Start.** Treat each issue implementation, PR implementation, review, and change request (CR)
140
+ as an independent task. Fetch the current remote default branch and read the applicable issue,
141
+ PR, HEAD, review feedback, and CI state. Use a fresh, uniquely named task checkout or worktree.
142
+ Concurrent tasks must have distinct writable checkout, temporary, build, and cache paths.
143
+ - **CRs.** Fetch and check out the current remote PR branch in the new workspace. Preserve PR
144
+ history and scope. Push corrections to the existing PR branch.
145
+ - **Delivery.** Run applicable checks. Commit and push all intended changes, then verify that
146
+ GitHub has the intended commit on the correct remote branch. Report the exact HEAD, checks, CI,
147
+ findings, and blockers. Report acceptance that was not run as unverified. Read-only reviews hand
148
+ off their findings without creating a commit. Merge requires explicit authorization.
149
+ - **Cleanup.** After handoff, resolve every candidate path and remove only task-owned directories
150
+ whose resolved paths are strictly under the resolved system path for \`/tmp\` (\`/private/tmp\` on
151
+ macOS). Refuse candidates that resolve outside that boundary, including through a symlink. Use
152
+ Git-aware removal for worktrees. Preserve workspaces outside the boundary, shared directories,
153
+ other tasks' directories, uncommitted changes, and unpushed commits. If blocked, persist
154
+ recoverable work first and document what must be retained. Report whether cleanup succeeded, was
155
+ skipped, or was blocked.
156
+
134
157
  `;
135
158
  }
136
159
  /*** Render canonical pull-request validation commands. */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ankhorage/devtools",
3
- "version": "2.8.4",
3
+ "version": "2.9.1",
4
4
  "description": "Shared tooling, repository automation, and agent standards for Ankhorage TypeScript projects",
5
5
  "license": "MIT",
6
6
  "homepage": "https://github.com/ankhorage/devtools#readme",
@@ -527,7 +527,7 @@
527
527
  "dependencies": {
528
528
  "@ankhorage/apm": "^0.8.15",
529
529
  "@ankhorage/capability": "^0.2.3",
530
- "@ankhorage/contracts": "^26.11.1",
530
+ "@ankhorage/contracts": "^26.12.0",
531
531
  "@ankhorage/project-detector": "^0.3.6",
532
532
  "@ankhorage/rules-repository": "^0.5.0",
533
533
  "@ankhorage/utility": "^0.5.5",