@plainconceptsplatform/workflows 0.4.34 → 0.6.1

package/README.md

@@ -1,88 +1,88 @@
-# Workflows CLI
-
-Install and update shared GitHub Agentic Workflows for Plain Concepts Platform repositories.
-
-## Quick start
-
-The primary entrypoint is the interactive TUI. Run it with no arguments:
-
-```bash
-npx @plainconceptsplatform/workflows
-```
-
-The TUI lists all routes and templates with install status. Arrow keys navigate, space toggles, Enter installs. Selecting routes installs only those route workers plus mandatory files (opencode.ci.json, compile script, shared imports, actions, router, classifier, route matrix). Selecting only templates installs just those templates.
-
-## Install
-
-Before installing workflows, install and configure [`PlainConceptsPlatform/agent-harness`](https://github.com/PlainConceptsPlatform/agent-harness) in the consumer repository. Loop workers invoke the skills and commands it provides. Verify the required skills and commands are available before compiling workflows.
-
-For non-interactive use (advanced):
-
-```bash
-npx @plainconceptsplatform/workflows@latest init
-npx @plainconceptsplatform/workflows@latest add
-npx @plainconceptsplatform/workflows@latest update
-```
-
-For a project-local development dependency:
-
-```bash
-pnpm add -D @plainconceptsplatform/workflows
-pnpm exec workflows              # launch interactive TUI
-pnpm exec workflows init
-pnpm exec workflows add
-```
-
-`init` inspects the repository and reports its stack and visibility. It does not create or manage repository configuration or a manifest.
-
-`add` installs mandatory files (opencode.ci.json, compile script, shared imports, actions, router, classifier, route matrix) when called with no route arguments. Pass route names as positional arguments to install specific route workers alongside the mandatory files:
-
-```bash
-workflows add                        # mandatory files only, no worker .md files
-workflows add implement refine direct  # those route workers plus mandatory files
-workflows add --template agentics-checks  # named template only (no mandatory files)
-workflows add refine --template agentics-checks --force  # routes + template + mandatory, overwriting conflicts
-```
-
-Route names: refine, implement, direct, apply-review, merge-gate, audit, propose. Unknown arguments produce an error.
-
-Use `workflows update --force` to force-overwrite managed files that differ from the package source.
-
-Install optional standalone templates with `add --template`. Available templates are `agentics-checks`, `agentics-maintenance`, `app-ci-dotnet-next`, `app-ci-node-monorepo`, and `github-release`. CI templates are stack-specific copies, not a combined template. `github-release` publishes generated release notes when a `v*` tag is pushed. Edit their top-level `env:` values for repository paths, package names, and commands.
-
-## List and search
-
-List all available workflows, routes, and templates with install status:
-
-```bash
-npx --yes --package @plainconceptsplatform/workflows@latest workflows list
-```
-
-Each entry is marked `[x]` when the corresponding `.github/workflows/agent-*.md` file already exists in the current directory, or `[ ]` when it is not yet installed.
-
-Search by name or description:
-
-```bash
-npx --yes --package @plainconceptsplatform/workflows@latest workflows search "ci"
-```
-
-## Manual installation
-
-The package includes `loops/`, a copyable equivalent of `.github/`:
-
-- `loops/actions/` maps to `.github/actions/`
-- `loops/workflows/` maps to `.github/workflows/`
-- `loops/scripts/` maps to `scripts/`
-
-Copy these files manually if you do not use the CLI. Each worker is self-contained. Edit its
-top-level `env:` defaults directly for consumer-specific endpoint, model, labels, paths, and checks.
-
-## Compile
-
-Consumer repositories generate and commit `*.lock.yml` files:
-
-```bash
-node scripts/compile-agent-workflows.mjs --force
-```
-
-Do not commit generated locks to this package source repository.
+# Workflows CLI
+
+Install and update shared GitHub Agentic Workflows for Plain Concepts Platform repositories.
+
+## Quick start
+
+The primary entrypoint is the interactive TUI. Run it with no arguments:
+
+```bash
+npx @plainconceptsplatform/workflows
+```
+
+The TUI lists all routes and templates with install status. Arrow keys navigate, space toggles, Enter installs. Selecting routes installs only those route workers plus mandatory files (opencode.ci.json, compile script, shared imports, actions, router, classifier, route matrix). Selecting only templates installs just those templates.
+
+## Install
+
+Before installing workflows, install and configure [`PlainConceptsPlatform/agent-harness`](https://github.com/PlainConceptsPlatform/agent-harness) in the consumer repository. Loop workers invoke the skills and commands it provides. Verify the required skills and commands are available before compiling workflows.
+
+For non-interactive use (advanced):
+
+```bash
+npx @plainconceptsplatform/workflows@latest init
+npx @plainconceptsplatform/workflows@latest add
+npx @plainconceptsplatform/workflows@latest update
+```
+
+For a project-local development dependency:
+
+```bash
+pnpm add -D @plainconceptsplatform/workflows
+pnpm exec workflows              # launch interactive TUI
+pnpm exec workflows init
+pnpm exec workflows add
+```
+
+`init` inspects the repository and reports its stack and visibility. It does not create or manage repository configuration or a manifest.
+
+`add` installs mandatory files (opencode.ci.json, compile script, shared imports, actions, router, classifier, route matrix) when called with no route arguments. Pass route names as positional arguments to install specific route workers alongside the mandatory files:
+
+```bash
+workflows add                        # mandatory files only, no worker .md files
+workflows add implement refine direct  # those route workers plus mandatory files
+workflows add --template agentics-checks  # named template only (no mandatory files)
+workflows add refine --template agentics-checks --force  # routes + template + mandatory, overwriting conflicts
+```
+
+Route names: refine, implement, direct, apply-review, merge-gate, audit, propose. Unknown arguments produce an error.
+
+Use `workflows update --force` to force-overwrite managed files that differ from the package source.
+
+Install optional standalone templates with `add --template`. Available templates are `agentics-checks`, `agentics-maintenance`, `app-ci-dotnet-next`, `app-ci-node-monorepo`, and `github-release`. CI templates are stack-specific copies, not a combined template. `github-release` publishes generated release notes when a `v*` tag is pushed. Edit their top-level `env:` values for repository paths, package names, and commands.
+
+## List and search
+
+List all available workflows, routes, and templates with install status:
+
+```bash
+npx --yes --package @plainconceptsplatform/workflows@latest workflows list
+```
+
+Each entry is marked `[x]` when the corresponding `.github/workflows/agent-*.md` file already exists in the current directory, or `[ ]` when it is not yet installed.
+
+Search by name or description:
+
+```bash
+npx --yes --package @plainconceptsplatform/workflows@latest workflows search "ci"
+```
+
+## Manual installation
+
+The package includes `loops/`, a copyable equivalent of `.github/`:
+
+- `loops/actions/` maps to `.github/actions/`
+- `loops/workflows/` maps to `.github/workflows/`
+- `loops/scripts/` maps to `scripts/`
+
+Copy these files manually if you do not use the CLI. Each worker is self-contained. Edit its
+top-level `env:` defaults directly for consumer-specific endpoint, model, labels, paths, and checks.
+
+## Compile
+
+Consumer repositories generate and commit `*.lock.yml` files:
+
+```bash
+node scripts/compile-agent-workflows.mjs --force
+```
+
+Do not commit generated locks to this package source repository.

package/dist/action-validation.test.js

@@ -1,8 +1,8 @@
 import { readFile, readdir } from "node:fs/promises";
 import { join } from "node:path";
+import { fileURLToPath } from "node:url";
 import { describe, expect, it } from "vitest";
 import { parse } from "yaml";
-import { catalogSourcePath } from "./catalog-installation.js";
 async function collectActionYmlFiles(actionsDir) {
     const entries = await readdir(actionsDir, { withFileTypes: true });
     const results = [];
@@ -18,7 +18,10 @@ async function collectActionYmlFiles(actionsDir) {
     return results;
 }
 async function loadManifests() {
-    const actionsDir = join(catalogSourcePath(), "actions");
+    // catalogSourcePath() resolves against the published package layout, where loops/ ships
+    // next to the compiled module. In this repository loops/ lives at the root, two levels
+    // above this test, so resolve it from the source tree instead.
+    const actionsDir = join(fileURLToPath(new URL("../../loops", import.meta.url)), "actions");
     const files = await collectActionYmlFiles(actionsDir);
     return Promise.all(files.map(async (file) => {
         const content = await readFile(file, "utf8");

package/dist/catalog-installation.js

@@ -83,7 +83,29 @@ function mergeWorkerEnv(packageContent, consumerContent) {
     if (endpoint !== undefined) {
         result = result.replace(/^    OPENAI_BASE_URL: .+$/m, `    OPENAI_BASE_URL: ${endpoint}`);
     }
-    return result;
+    return preserveRunnerPool(result, consumerContent);
+}
+// Which self-hosted pool a worker's agent jobs run on. gh-aw cannot share runs-on through
+// an import, so every worker names it, and it belongs with the env values rather than with
+// the prompt: a forced update that rewrote it would move a repository's agents onto another
+// pool, and one of ours has two machines in it. ubuntu-latest is excluded, being GitHub's
+// own runner, used by the deterministic jobs everywhere and chosen by nobody.
+function runnerPools(content) {
+    const found = new Set();
+    for (const match of content.matchAll(/^\s*runs-on(?:-slim)?: (\S+)\s*$/gm)) {
+        if (match[1] !== "ubuntu-latest")
+            found.add(match[1]);
+    }
+    return [...found];
+}
+function preserveRunnerPool(packageContent, consumerContent) {
+    const mine = runnerPools(consumerContent);
+    const theirs = runnerPools(packageContent);
+    // Only an unambiguous swap. A consumer naming several pools has drifted rather than
+    // decided, and guessing which it meant is worse than leaving the package's.
+    if (mine.length !== 1 || theirs.length !== 1 || mine[0] === theirs[0])
+        return packageContent;
+    return packageContent.replace(/^(\s*runs-on(?:-slim)?: )(\S+)(\s*)$/gm, (line, prefix, pool, tail) => pool === "ubuntu-latest" ? line : `${prefix}${mine[0]}${tail}`);
 }
 function workerEnvValues(content) {
     const frontmatter = /^---\r?\n([\s\S]*?)\r?\n---/m.exec(content)?.[1];
@@ -113,21 +135,42 @@ function transformOpencodeFiles(files, inspection) {
     }
     return result;
 }
+// Templates that need a companion config beside the workflow file. actionlint only
+// knows GitHub-hosted runner labels, so every workflow naming a self-hosted label is an
+// error without this file; it belongs wherever the lint workflow that reads it lives.
+const templateCompanions = {
+    "agentics-checks": [{ source: "templates/agentics/actionlint.yaml", target: ".github/actionlint.yaml" }],
+};
 export async function installTemplate(repositoryPath, template, options = {}) {
     const sourcePath = options.sourcePath ?? catalogSourcePath();
     const meta = catalogTemplateMeta(template);
     const source = join(sourcePath, "templates", meta.directory, meta.file);
     const target = meta.target;
-    const destination = join(repositoryPath, target);
-    const conflicts = await exists(destination) && !(await filesMatch(source, destination)) ? [target] : [];
+    const companions = templateCompanions[template] ?? [];
+    const destinations = [
+        { source, target, companion: false },
+        ...companions.map((companion) => ({
+            source: join(sourcePath, companion.source),
+            target: companion.target,
+            companion: true,
+        })),
+    ];
+    const conflicts = (await Promise.all(destinations.map(async (entry) => await exists(join(repositoryPath, entry.target)) && await exists(entry.source) && !(await filesMatch(entry.source, join(repositoryPath, entry.target)))
+        ? entry.target
+        : undefined))).filter((file) => file !== undefined);
     if (conflicts.length > 0 && !options.force)
         return { installed: [], conflicts };
-    await mkdir(dirname(destination), { recursive: true });
-    await copyFile(source, destination);
+    for (const entry of destinations) {
+        if (!(await exists(entry.source)))
+            continue; // companion files may not exist for every template version
+        const destination = join(repositoryPath, entry.target);
+        await mkdir(dirname(destination), { recursive: true });
+        await copyFile(entry.source, destination);
+    }
     if (options.inspection !== undefined && template === "opencode.ci.json") {
         const baseContent = await readFile(source, "utf8");
         const transformed = generateOpencodeConfig(baseContent, options.inspection);
-        await writeFile(destination, transformed, "utf8");
+        await writeFile(join(repositoryPath, target), transformed, "utf8");
     }
     try {
         await runCompileIfAvailable(repositoryPath);
@@ -135,7 +178,7 @@ export async function installTemplate(repositoryPath, template, options = {}) {
     catch {
         // compile failure is non-fatal
     }
-    return { installed: [target], conflicts };
+    return { installed: (await Promise.all(destinations.map(async (entry) => await exists(entry.source) ? entry.target : undefined))).filter((file) => file !== undefined), conflicts };
 }
 export async function installMandatoryFiles(repositoryPath, options = {}) {
     const sourcePath = options.sourcePath ?? catalogSourcePath();

package/dist/catalog-installation.test.js

@@ -29,7 +29,7 @@ describe("catalog installation", () => {
             "workflows/shared/defaults.md": "defaults\n",
             "workflows/work-router.yml": "name: Router\n",
             "scripts/compile-agent-workflows.mjs": "compile\n",
-            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-2\" }\n",
+            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-3\" }\n",
         });
         const repositoryPath = await createDirectory({});
         const result = await installCatalog(repositoryPath, { sourcePath, selectedRoutes: [] });
@@ -42,7 +42,6 @@ describe("catalog installation", () => {
         expect(result.installed).not.toContain(".github/workflows/agent-refine.md");
         expect(result.installed).not.toContain(".github/workflows/agent-implement.md");
         expect(result.installed).not.toContain(".github/workflows/agent-audit.md");
-        expect(result.installed).not.toContain(".github/workflows/agent-propose.md");
     });
     it("installs package-owned loops files including mandatory opencode.ci.json and compile script", async () => {
         const sourcePath = await createDirectory({
@@ -51,7 +50,7 @@ describe("catalog installation", () => {
             "workflows/shared/defaults.md": "defaults\n",
             "scripts/compile-agent-workflows.mjs": "console.log('compile');\n",
             "scripts/compile.mjs": "console.log('old compile');\n",
-            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-2\" }\n",
+            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-3\" }\n",
             "workflows/agent-check.lock.yml": "generated\n",
             "actions/actions-lock.json": "generated\n",
         });
@@ -75,7 +74,7 @@ describe("catalog installation", () => {
             "actions/check/action.yml": "# Managed by @plainconceptsplatform/workflows. Source: loops/actions/check/action.yml. Update with `workflows update --force`; consumer edits may be overwritten.\nname: Check\n",
             "workflows/agent-check.md": `---\n${header}# Check\n`,
             "scripts/compile-agent-workflows.mjs": "// Managed by @plainconceptsplatform/workflows. Source: loops/scripts/compile-agent-workflows.mjs. Update with `workflows update --force`; consumer edits may be overwritten.\n",
-            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-2\" }\n",
+            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-3\" }\n",
             "templates/agentics/agentics-checks.yml": `${templateHeader}name: Agentics checks\n`,
         });
         const repositoryPath = await createDirectory({});
@@ -89,7 +88,7 @@ describe("catalog installation", () => {
             "actions/check/action.yml": "name: Check\n",
             "workflows/agent-check.md": "# Check\n",
             "scripts/compile-agent-workflows.mjs": "compile\n",
-            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-2\" }\n",
+            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-3\" }\n",
         });
         const repositoryPath = await createDirectory({ ".github/workflows/agent-check.md": "# Check\n" });
         await expect(installCatalog(repositoryPath, { sourcePath })).resolves.toMatchObject({ conflicts: [] });
@@ -99,7 +98,7 @@ describe("catalog installation", () => {
             "actions/check/action.yml": "name: Check\n",
             "workflows/agent-check.md": "# Check\n",
             "scripts/compile-agent-workflows.mjs": "compile\n",
-            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-2\" }\n",
+            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-3\" }\n",
         });
         const repositoryPath = await createDirectory({
             ".github/workflows/shared/repo-config.md": "legacy consumer config\n",
@@ -120,7 +119,7 @@ describe("catalog installation", () => {
             "actions/check/action.yml": "package action\n",
             "workflows/agent-check.md": "package workflow\n",
             "scripts/compile-agent-workflows.mjs": "package script\n",
-            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-2\" }\n",
+            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-3\" }\n",
         });
         const repositoryPath = await createDirectory({
             ".github/actions/check/action.yml": "consumer action\n",
@@ -152,7 +151,7 @@ describe("catalog installation", () => {
             "actions/check/action.yml": "name: Check\n",
             "workflows/agent-check.md": "# Check\n",
             "scripts/compile-agent-workflows.mjs": "compile\n",
-            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-2\" }\n",
+            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-3\" }\n",
             "templates/agentics/agentics-checks.yml": "name: Agentics checks\n",
             "templates/ci/app-ci-node-monorepo.yml": "name: Node CI\n",
             "templates/release/github-release.yml": "name: Publish GitHub release\n",
@@ -178,30 +177,30 @@ describe("catalog installation", () => {
             "actions/check/action.yml": "name: Check\n",
             "workflows/agent-check.md": "# Check\n",
             "scripts/compile-agent-workflows.mjs": "compile\n",
-            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-2\" }\n",
+            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-3\" }\n",
         });
         const repositoryPath = await createDirectory({});
         const result = await installCatalog(repositoryPath, { sourcePath });
         expect(result.installed).toContain("opencode.ci.json");
         expect(result.installed).toContain("scripts/compile-agent-workflows.mjs");
-        await expect(readFile(join(repositoryPath, "opencode.ci.json"), "utf8")).resolves.toBe("{ \"model\": \"plainconcepts/glm-5-2\" }\n");
+        await expect(readFile(join(repositoryPath, "opencode.ci.json"), "utf8")).resolves.toBe("{ \"model\": \"plainconcepts/glm-5-3\" }\n");
         await expect(readFile(join(repositoryPath, "scripts/compile-agent-workflows.mjs"), "utf8")).resolves.toBe("compile\n");
     });
     it("installMandatoryFiles installs opencode.ci.json and compile script without catalog files", async () => {
         const sourcePath = await createDirectory({
             "scripts/compile-agent-workflows.mjs": "compile\n",
-            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-2\" }\n",
+            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-3\" }\n",
         });
         const repositoryPath = await createDirectory({});
         const result = await installMandatoryFiles(repositoryPath, { sourcePath });
         expect(result.installed).toEqual(["opencode.ci.json", "scripts/compile-agent-workflows.mjs"]);
-        await expect(readFile(join(repositoryPath, "opencode.ci.json"), "utf8")).resolves.toBe("{ \"model\": \"plainconcepts/glm-5-2\" }\n");
+        await expect(readFile(join(repositoryPath, "opencode.ci.json"), "utf8")).resolves.toBe("{ \"model\": \"plainconcepts/glm-5-3\" }\n");
         await expect(readFile(join(repositoryPath, "scripts/compile-agent-workflows.mjs"), "utf8")).resolves.toBe("compile\n");
     });
     it("installMandatoryFiles reports conflicts on differing files", async () => {
         const sourcePath = await createDirectory({
             "scripts/compile-agent-workflows.mjs": "package script\n",
-            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-2\" }\n",
+            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-3\" }\n",
         });
         const repositoryPath = await createDirectory({
             "opencode.ci.json": "{ \"model\": \"consumer\" }\n",
@@ -215,7 +214,7 @@ describe("catalog installation", () => {
     it("installMandatoryFiles overwrites with force", async () => {
         const sourcePath = await createDirectory({
             "scripts/compile-agent-workflows.mjs": "package script\n",
-            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-2\" }\n",
+            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-3\" }\n",
         });
         const repositoryPath = await createDirectory({
             "opencode.ci.json": "{ \"model\": \"consumer\" }\n",
@@ -224,14 +223,14 @@ describe("catalog installation", () => {
         await expect(installMandatoryFiles(repositoryPath, { force: true, sourcePath })).resolves.toMatchObject({
             installed: ["opencode.ci.json", "scripts/compile-agent-workflows.mjs"],
         });
-        await expect(readFile(join(repositoryPath, "opencode.ci.json"), "utf8")).resolves.toBe("{ \"model\": \"plainconcepts/glm-5-2\" }\n");
+        await expect(readFile(join(repositoryPath, "opencode.ci.json"), "utf8")).resolves.toBe("{ \"model\": \"plainconcepts/glm-5-3\" }\n");
     });
     it("installMandatoryFiles does not install catalog workflow files", async () => {
         const sourcePath = await createDirectory({
             "actions/check/action.yml": "name: Check\n",
             "workflows/agent-check.md": "# Check\n",
             "scripts/compile-agent-workflows.mjs": "compile\n",
-            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-2\" }\n",
+            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-3\" }\n",
         });
         const repositoryPath = await createDirectory({});
         await installMandatoryFiles(repositoryPath, { sourcePath });
@@ -242,7 +241,7 @@ describe("catalog installation", () => {
             "actions/check/action.yml": "name: Check\n",
             "workflows/agent-check.md": "# Check\n",
             "scripts/compile-agent-workflows.mjs": "same compile script\n",
-            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-2\" }\n",
+            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-3\" }\n",
         });
         const repositoryPath = await createDirectory({});
         const result = await installCatalog(repositoryPath, { sourcePath });
@@ -313,6 +312,44 @@ describe("catalog installation", () => {
         await installCatalog(repositoryPath, { force: true, sourcePath });
         await expect(readFile(join(repositoryPath, ".github/workflows/agent-check.md"), "utf8")).resolves.toContain("  REPO_RULES: \"consumer rules\"\n---\nengine:\n  env:\n    OPENAI_BASE_URL: https://consumer.example/v1\n");
     });
+    // gh-aw cannot share runs-on through an import, so each worker names its own pool and a
+    // forced update must leave it alone. Rewriting it moves a repository's agents onto another
+    // pool, and one of ours has two machines in it.
+    it("keeps the consumer's runner pool through a forced update", async () => {
+        const sourcePath = await createDirectory({
+            "actions/check/action.yml": "name: Check\n",
+            "workflows/agent-check.md": "---\nenv:\n  VERIFY_COMMANDS: \"package verify\"\n---\njobs:\n  agent:\n    runs-on: agents-arc\n  deterministic:\n    runs-on: ubuntu-latest\nruns-on: agents-arc\nruns-on-slim: agents-arc\n",
+            "scripts/compile-agent-workflows.mjs": "compile\n",
+            "templates/opencode/opencode.ci.json": "{}\n",
+        });
+        const repositoryPath = await createDirectory({
+            ".github/workflows/agent-check.md": "---\nenv:\n  VERIFY_COMMANDS: \"consumer verify\"\n---\njobs:\n  agent:\n    runs-on: OwnPool\n  deterministic:\n    runs-on: ubuntu-latest\nruns-on: OwnPool\nruns-on-slim: OwnPool\n",
+        });
+        await installCatalog(repositoryPath, { force: true, sourcePath });
+        const written = await readFile(join(repositoryPath, ".github/workflows/agent-check.md"), "utf8");
+        expect(written).toContain("runs-on: OwnPool");
+        expect(written).not.toContain("agents-arc");
+        // GitHub's own runner is not a per-repository choice and stays as the package has it.
+        expect(written).toContain("runs-on: ubuntu-latest");
+        // And the env value is still preserved, which this shares a code path with.
+        expect(written).toContain('VERIFY_COMMANDS: "consumer verify"');
+    });
+    // A consumer naming two pools has drifted rather than decided. Guessing which it meant
+    // would be worse than leaving the package's, so it is left.
+    it("leaves the package pool when the consumer names more than one", async () => {
+        const sourcePath = await createDirectory({
+            "actions/check/action.yml": "name: Check\n",
+            "workflows/agent-check.md": "---\nenv:\n  VERIFY_COMMANDS: \"package verify\"\n---\njobs:\n  agent:\n    runs-on: agents-arc\n  deterministic:\n    runs-on: ubuntu-latest\nruns-on: agents-arc\nruns-on-slim: agents-arc\n",
+            "scripts/compile-agent-workflows.mjs": "compile\n",
+            "templates/opencode/opencode.ci.json": "{}\n",
+        });
+        const repositoryPath = await createDirectory({
+            ".github/workflows/agent-check.md": "---\nenv:\n  VERIFY_COMMANDS: \"consumer verify\"\n---\njobs:\n  agent:\n    runs-on: OwnPool\n  other:\n    runs-on: SomethingElse\n",
+        });
+        await installCatalog(repositoryPath, { force: true, sourcePath });
+        const written = await readFile(join(repositoryPath, ".github/workflows/agent-check.md"), "utf8");
+        expect(written).toContain("runs-on: agents-arc");
+    });
     it("applies staged generated locks with managed sources", async () => {
         const sourcePath = await createDirectory({
             "actions/check/action.yml": "package action\n",
@@ -333,14 +370,14 @@ describe("catalog installation", () => {
     });
     it("installs the opencode.ci.json template to the repository root", async () => {
         const sourcePath = await createDirectory({
-            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-2\" }\n",
+            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-3\" }\n",
         });
         const repositoryPath = await createDirectory({});
         await expect(installTemplate(repositoryPath, "opencode.ci.json", { sourcePath })).resolves.toEqual({
             installed: ["opencode.ci.json"],
             conflicts: [],
         });
-        await expect(readFile(join(repositoryPath, "opencode.ci.json"), "utf8")).resolves.toBe("{ \"model\": \"plainconcepts/glm-5-2\" }\n");
+        await expect(readFile(join(repositoryPath, "opencode.ci.json"), "utf8")).resolves.toBe("{ \"model\": \"plainconcepts/glm-5-3\" }\n");
     });
     it("installs the .NET and Next.js CI template as app-ci.yml", async () => {
         const sourcePath = await createDirectory({
@@ -355,7 +392,7 @@ describe("catalog installation", () => {
     });
     it("requires force to replace the opencode.ci.json template", async () => {
         const sourcePath = await createDirectory({
-            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-2\" }\n",
+            "templates/opencode/opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-3\" }\n",
         });
         const repositoryPath = await createDirectory({
             "opencode.ci.json": "{ \"model\": \"consumer-model\" }\n",
@@ -367,7 +404,7 @@ describe("catalog installation", () => {
         await expect(installTemplate(repositoryPath, "opencode.ci.json", { force: true, sourcePath })).resolves.toMatchObject({
             installed: ["opencode.ci.json"],
         });
-        await expect(readFile(join(repositoryPath, "opencode.ci.json"), "utf8")).resolves.toBe("{ \"model\": \"plainconcepts/glm-5-2\" }\n");
+        await expect(readFile(join(repositoryPath, "opencode.ci.json"), "utf8")).resolves.toBe("{ \"model\": \"plainconcepts/glm-5-3\" }\n");
     });
     it("requires force to replace a selected template", async () => {
         const sourcePath = await createDirectory({
@@ -429,7 +466,7 @@ describe("route lifecycle", () => {
     });
     it("ignores routes that are not installed", async () => {
         const repositoryPath = await createDirectory({});
-        await expect(removeRouteFiles(repositoryPath, ["propose"])).resolves.toEqual([]);
+        await expect(removeRouteFiles(repositoryPath, ["audit"])).resolves.toEqual([]);
     });
 });
 async function createDirectory(files) {

package/dist/catalog-listing.test.js

@@ -15,7 +15,7 @@ describe("catalog listing", () => {
         expect(entries).toHaveLength(workflowRoutes.length + catalogTemplates.length);
         const routeNames = entries.filter((entry) => entry.kind === "route").map((entry) => entry.name);
         const templateNames = entries.filter((entry) => entry.kind === "template").map((entry) => entry.name);
-        expect(routeNames).toEqual(["refine", "implement", "direct", "triage", "apply-review", "merge-gate", "audit", "propose"]);
+        expect(routeNames).toEqual(["refine", "implement", "triage", "apply-review", "merge-gate", "audit"]);
         expect(templateNames).toEqual(["agentics-checks", "agentics-maintenance", "app-ci-dotnet-next", "app-ci-node-monorepo", "bug-report", "feature-request", "github-release", "opencode.ci.json", "visual-evidence"]);
     });
     it("reports all entries as not installed in an empty repository", async () => {
@@ -56,7 +56,7 @@ describe("catalog listing", () => {
     });
     it("marks the opencode.ci.json template as installed when the file exists at repository root", async () => {
         const repositoryPath = await createRepository({
-            "opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-2\" }",
+            "opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-3\" }",
         });
         const entries = await listCatalog({ installedPath: repositoryPath });
         const opencodeEntry = entries.find((entry) => entry.name === "opencode.ci.json");
@@ -68,7 +68,7 @@ describe("catalog listing", () => {
             ".github/workflows/agent-refine.md": "# Refine",
             ".github/workflows/agent-audit.md": "# Audit",
             ".github/workflows/app-ci-dotnet-next.yml": "name: CI",
-            "opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-2\" }",
+            "opencode.ci.json": "{ \"model\": \"plainconcepts/glm-5-3\" }",
         });
         const entries = await listCatalog({ installedPath: repositoryPath });
         expect(entries.filter((entry) => entry.installed).map((entry) => entry.name))
@@ -106,7 +106,7 @@ describe("searchCatalog", () => {
     });
     it("returns both routes and templates when the query matches both kinds", () => {
         const entries = [
-            { kind: "route", name: "direct", description: "Executes a CI instruction.", file: "agent-direct.md", installed: false },
+            { kind: "route", name: "audit", description: "Executes a CI instruction.", file: "agent-audit.md", installed: false },
             { kind: "template", name: "app-ci-dotnet-next", description: "App CI pipeline.", file: "app-ci-dotnet-next.yml", installed: true },
         ];
         const results = searchCatalog(entries, "CI");