@ankhorage/devtools 2.8.4 → 2.9.0
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 +1 -1
- package/dist/tools/agents/index.js +26 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
|
|
4
4
|
# Ankhorage Devtools
|
|
5
5
|
|
|
6
|
-
         
|
|
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.
|
|
3
|
+
"version": "2.9.0",
|
|
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",
|