@plainconceptsplatform/workflows 0.1.2 → 0.1.5

package/dist/index.test.js

@@ -0,0 +1,112 @@
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { run } from "./index.js";
+const temporaryDirectories = [];
+afterEach(async () => {
+    await Promise.all(temporaryDirectories.splice(0).map((directory) => rm(directory, { force: true, recursive: true })));
+});
+describe("workflows CLI", () => {
+    it("prints template names in help", async () => {
+        const log = vi.spyOn(console, "log").mockImplementation(() => undefined);
+        await expect(run(["--help"])).resolves.toBe(0);
+        expect(log).toHaveBeenCalledWith(expect.stringContaining("agentics-checks"));
+        expect(log).toHaveBeenCalledWith(expect.stringContaining("app-ci-dotnet-next"));
+        expect(log).toHaveBeenCalledWith(expect.stringContaining("opencode.ci.json"));
+        log.mockRestore();
+    });
+    it("rejects an unsupported template", async () => {
+        const error = vi.spyOn(console, "error").mockImplementation(() => undefined);
+        await expect(run(["add", "--template", "unknown"])).resolves.toBe(1);
+        expect(error).toHaveBeenCalledWith("add accepts only --force or --template agentics-checks|agentics-maintenance|app-ci-dotnet-next|app-ci-node-monorepo|opencode.ci.json.");
+        error.mockRestore();
+    });
+    it("lists all workflows and templates with install status [ ] when none installed", async () => {
+        const repositoryPath = await createRepository({});
+        const log = vi.spyOn(console, "log").mockImplementation(() => undefined);
+        await expect(run(["list"], repositoryPath)).resolves.toBe(0);
+        expect(log).toHaveBeenCalledTimes(1);
+        const output = log.mock.calls[0][0];
+        expect(output).toContain("Workflows:");
+        expect(output).toContain("Templates:");
+        expect(output).toContain("refine");
+        expect(output).toContain("implement");
+        expect(output).toContain("agentics-checks");
+        expect(output).toContain("app-ci-dotnet-next");
+        // None installed: all [ ]
+        const installedCount = (output.match(/\[x\]/g) ?? []).length;
+        expect(installedCount).toBe(0);
+        // 7 routes + 5 templates = 12 entries
+        const uninstalledCount = (output.match(/\[ \]/g) ?? []).length;
+        expect(uninstalledCount).toBe(12);
+        log.mockRestore();
+    });
+    it("marks installed workflows with [x]", async () => {
+        const repositoryPath = await createRepository({
+            ".github/workflows/agent-refine.md": "# Refine",
+            ".github/workflows/agentics-checks.yml": "name: Agentics checks",
+        });
+        const log = vi.spyOn(console, "log").mockImplementation(() => undefined);
+        await expect(run(["list"], repositoryPath)).resolves.toBe(0);
+        const output = log.mock.calls[0][0];
+        const installed = output.match(/(\[x\])/g) ?? [];
+        expect(installed.length).toBe(2);
+        // refine and agentics-checks should be [x]
+        const refineLines = output.split("\n").filter((line) => line.includes("refine") || line.includes("agentics-checks"));
+        expect(refineLines.filter((line) => line.includes("[x]"))).toHaveLength(2);
+        log.mockRestore();
+    });
+    it("search filters by name", async () => {
+        const log = vi.spyOn(console, "log").mockImplementation(() => undefined);
+        await expect(run(["search", "audit"])).resolves.toBe(0);
+        const output = log.mock.calls[0][0];
+        expect(output).toContain("audit");
+        expect(output).not.toContain("Templates:");
+        // Only the audit route should be returned — no other route name should appear.
+        const visibleRoutes = ["refine", "implement", "direct", "apply-review", "merge-gate", "propose"];
+        for (const route of visibleRoutes) {
+            expect(output).not.toContain(`${route} —`);
+        }
+        log.mockRestore();
+    });
+    it("search filters by description keyword", async () => {
+        const log = vi.spyOn(console, "log").mockImplementation(() => undefined);
+        await expect(run(["search", "CI"])).resolves.toBe(0);
+        const output = log.mock.calls[0][0];
+        expect(output).toContain("dotnet-next");
+        expect(output).toContain("node-monorepo");
+        expect(output).not.toContain("refine");
+        log.mockRestore();
+    });
+    it("search with no matches prints a no-match message", async () => {
+        const log = vi.spyOn(console, "log").mockImplementation(() => undefined);
+        await expect(run(["search", "nonexistent"])).resolves.toBe(0);
+        const output = log.mock.calls[0][0];
+        expect(output).toBe("No workflows matched the search query.");
+        log.mockRestore();
+    });
+    it("search with no query fails", async () => {
+        const error = vi.spyOn(console, "error").mockImplementation(() => undefined);
+        await expect(run(["search"])).resolves.toBe(1);
+        expect(error).toHaveBeenCalledWith("search requires exactly one query argument.");
+        error.mockRestore();
+    });
+    it("search with too many arguments fails", async () => {
+        const error = vi.spyOn(console, "error").mockImplementation(() => undefined);
+        await expect(run(["search", "a", "b"])).resolves.toBe(1);
+        expect(error).toHaveBeenCalledWith("search requires exactly one query argument.");
+        error.mockRestore();
+    });
+});
+async function createRepository(files) {
+    const repositoryPath = await mkdtemp(join(tmpdir(), "workflows-"));
+    temporaryDirectories.push(repositoryPath);
+    await Promise.all(Object.entries(files).map(async ([relativePath, content]) => {
+        const path = join(repositoryPath, relativePath);
+        const { mkdir } = await import("node:fs/promises");
+        await mkdir(join(path, ".."), { recursive: true });
+        await writeFile(path, content, "utf8");
+    }));
+    return repositoryPath;
+}

package/dist/repository-inspection.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/repository-inspection.test.js

@@ -0,0 +1,77 @@
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { inspectRepository, resolveVisibility } from "./repository-inspection.js";
+import { run } from "./index.js";
+const temporaryDirectories = [];
+afterEach(async () => {
+    await Promise.all(temporaryDirectories.splice(0).map((directory) => rm(directory, { force: true, recursive: true })));
+});
+describe("repository inspection", () => {
+    it("finds agent workflows and supported stack markers", async () => {
+        const repositoryPath = await createRepository({
+            ".github/workflows/agent-refine.md": "# Refine",
+            ".github/workflows/agent-custom.md": "# Custom",
+            ".github/workflows/other.md": "# Other",
+            "package.json": "{}",
+            "pnpm-lock.yaml": "lockfileVersion: '9.0'",
+            "apps/api/Numa.slnx": "<Solution />",
+            "openspec/changes/.gitkeep": "",
+        });
+        await expect(inspectRepository(repositoryPath)).resolves.toMatchObject({
+            existingAgentWorkflows: ["agent-custom.md", "agent-refine.md"],
+            stackHints: {
+                packageJson: true,
+                pnpmLockfile: true,
+                solutionFiles: [join(repositoryPath, "apps", "api", "Numa.slnx")],
+                openSpec: true,
+            },
+        });
+    });
+    it("uses an explicit visibility before environment or GitHub", async () => {
+        const runner = { run: async () => '{"visibility":"public"}' };
+        await expect(resolveVisibility("repo", "private", { PLATFORM_WORKFLOWS_VISIBILITY: "public" }, runner)).resolves.toEqual({
+            value: "private",
+            source: "argument",
+        });
+    });
+    it("falls back to private when GitHub CLI is unavailable", async () => {
+        const runner = { run: async () => Promise.reject(new Error("missing gh")) };
+        await expect(resolveVisibility("repo", undefined, {}, runner)).resolves.toEqual({ value: "private", source: "fallback" });
+    });
+});
+describe("CLI commands", () => {
+    it("keeps init available without writing configuration", async () => {
+        const repositoryPath = await createRepository({ "package.json": "{}" });
+        const output = captureConsole("log");
+        await expect(run(["init", "--visibility", "public"], repositoryPath)).resolves.toBe(0);
+        expect(output.calls).toHaveLength(1);
+        await expect(import("node:fs/promises").then(({ access }) => access(join(repositoryPath, ".github/workflows/shared/repo-config.md")))).rejects.toThrow();
+        output.restore();
+    });
+    it("accepts update as an add alias", async () => {
+        const repositoryPath = await createRepository({});
+        const error = captureConsole("error");
+        await expect(run(["update", "--invalid"], repositoryPath)).resolves.toBe(1);
+        expect(error.calls).toEqual(["update accepts only --force or --template agentics-checks|agentics-maintenance|app-ci-dotnet-next|app-ci-node-monorepo|opencode.ci.json."]);
+        error.restore();
+    });
+});
+function captureConsole(method) {
+    const original = console[method];
+    const calls = [];
+    console[method] = (message) => calls.push(message);
+    return { calls, restore: () => { console[method] = original; } };
+}
+async function createRepository(files) {
+    const repositoryPath = await mkdtemp(join(tmpdir(), "workflows-"));
+    temporaryDirectories.push(repositoryPath);
+    await Promise.all(Object.entries(files).map(async ([relativePath, content]) => {
+        const path = join(repositoryPath, relativePath);
+        const { mkdir } = await import("node:fs/promises");
+        await mkdir(join(path, ".."), { recursive: true });
+        await writeFile(path, content, "utf8");
+    }));
+    return repositoryPath;
+}

package/dist/workflow-catalog.d.ts

@@ -3,15 +3,17 @@ export type RouteName = (typeof routeNames)[number];
 export interface WorkflowRoute {
     readonly name: RouteName;
     readonly worker: string;
+    readonly description: string;
     readonly defaultEnabled: boolean;
 }
 export declare const workflowRoutes: readonly WorkflowRoute[];
 export declare const packageOwnedTargets: readonly [".github/actions", ".github/workflows/agent-*.md", ".github/workflows/shared/platform-defaults.md", ".github/workflows/shared/opencode-ci.md", ".github/workflows/work-router.yml", "scripts/compile-agent-workflows.mjs"];
-export declare const consumerOwnedTargets: readonly [".github/workflows/shared/repo-config.md"];
-export declare const generatedConsumerTargets: readonly [".github/workflows/agent-*.lock.yml", ".github/workflows/agentics-maintenance.yml", ".github/aw/actions-lock.json"];
-export interface RepositoryConfigTemplate {
-    readonly repositoryVisibility: "private" | "public";
-    readonly verificationCommands: readonly string[];
-    readonly repositoryRules: readonly string[];
+export declare const generatedConsumerTargets: readonly [".github/workflows/agent-*.lock.yml", ".github/aw/actions-lock.json"];
+export declare const templateNames: readonly ["agentics-checks", "agentics-maintenance", "app-ci-dotnet-next", "app-ci-node-monorepo", "opencode.ci.json"];
+export type TemplateName = (typeof templateNames)[number];
+export interface CatalogTemplate {
+    readonly name: TemplateName;
+    readonly file: string;
+    readonly description: string;
 }
-export declare const defaultRepositoryConfig: RepositoryConfigTemplate;
+export declare const catalogTemplates: readonly CatalogTemplate[];

package/dist/workflow-catalog.js

@@ -8,13 +8,13 @@ export const routeNames = [
     "propose",
 ];
 export const workflowRoutes = [
-    { name: "refine", worker: "agent-refine.md", defaultEnabled: true },
-    { name: "implement", worker: "agent-implement.md", defaultEnabled: true },
-    { name: "direct", worker: "agent-direct.md", defaultEnabled: true },
-    { name: "apply-review", worker: "agent-apply-review.md", defaultEnabled: true },
-    { name: "merge-gate", worker: "agent-merge-gate.md", defaultEnabled: true },
-    { name: "audit", worker: "agent-audit.md", defaultEnabled: true },
-    { name: "propose", worker: "agent-propose.md", defaultEnabled: false },
+    { name: "refine", worker: "agent-refine.md", description: "Refines an issue into a user story, on a first pass or after the author has answered the bot's questions.", defaultEnabled: true },
+    { name: "implement", worker: "agent-implement.md", description: "Implements an issue and opens a pull request. Stops there: the merge decision belongs to the merge gate.", defaultEnabled: true },
+    { name: "direct", worker: "agent-direct.md", description: "Executes a free-form instruction from an issue body and posts the results back on the same issue.", defaultEnabled: true },
+    { name: "apply-review", worker: "agent-apply-review.md", description: "Applies reviewer feedback to an open pull request the bot authored, then pushes the fixes to the same branch.", defaultEnabled: true },
+    { name: "merge-gate", worker: "agent-merge-gate.md", description: "Decides what happens to a bot-authored pull request once CI has reported: merge, hand to a human, or fix CI.", defaultEnabled: true },
+    { name: "audit", worker: "agent-audit.md", description: "Read-only repository audit. Finds 5-7 problems, scores each 1-10, files a single issue with the top 3 refined as actionable user stories.", defaultEnabled: true },
+    { name: "propose", worker: "agent-propose.md", description: "Proposes the next feature. Reads the manifesto, recent history, and comparable tools, scores candidates, and files the winner as a single issue.", defaultEnabled: false },
 ];
 export const packageOwnedTargets = [
     ".github/actions",
@@ -24,16 +24,21 @@ export const packageOwnedTargets = [
     ".github/workflows/work-router.yml",
     "scripts/compile-agent-workflows.mjs",
 ];
-export const consumerOwnedTargets = [
-    ".github/workflows/shared/repo-config.md",
-];
 export const generatedConsumerTargets = [
     ".github/workflows/agent-*.lock.yml",
-    ".github/workflows/agentics-maintenance.yml",
     ".github/aw/actions-lock.json",
 ];
-export const defaultRepositoryConfig = {
-    repositoryVisibility: "private",
-    verificationCommands: [],
-    repositoryRules: [],
-};
+export const templateNames = [
+    "agentics-checks",
+    "agentics-maintenance",
+    "app-ci-dotnet-next",
+    "app-ci-node-monorepo",
+    "opencode.ci.json",
+];
+export const catalogTemplates = [
+    { name: "agentics-checks", file: "agentics-checks.yml", description: "Agentics checks: verifies generated agent lockfiles, actionlint, and compile on PRs touching workflow files." },
+    { name: "agentics-maintenance", file: "agentics-maintenance.yml", description: "Agentic maintenance: scheduled daily maintenance workflow for keeping workflows and actions up to date." },
+    { name: "app-ci-dotnet-next", file: "app-ci-dotnet-next.yml", description: "App CI pipeline for a .NET + Next.js monorepo: build, test, and lint on PRs and schedule." },
+    { name: "app-ci-node-monorepo", file: "app-ci-node-monorepo.yml", description: "App CI pipeline for a Node monorepo: build, test, and lint on PRs and schedule." },
+    { name: "opencode.ci.json", file: "opencode.ci.json", description: "Standalone OpenCode CI config: plainconcepts provider, GLM model registration, ci-workflow-agent, and LSP defaults for consumer repositories." },
+];

package/dist/workflow-catalog.test.js

@@ -1,14 +1,29 @@
 import { describe, expect, it } from "vitest";
-import { consumerOwnedTargets, generatedConsumerTargets, packageOwnedTargets, routeNames, workflowRoutes, } from "./workflow-catalog.js";
+import { catalogTemplates, generatedConsumerTargets, packageOwnedTargets, routeNames, templateNames, workflowRoutes, } from "./workflow-catalog.js";
 describe("workflow catalog", () => {
     it("assigns one worker to each route", () => {
         expect(workflowRoutes.map((route) => route.name)).toEqual(routeNames);
         expect(new Set(workflowRoutes.map((route) => route.worker)).size).toBe(workflowRoutes.length);
     });
-    it("keeps generated and consumer-owned files outside package ownership", () => {
+    it("gives every route a non-empty description", () => {
+        for (const route of workflowRoutes) {
+            expect(route.description.length).toBeGreaterThan(0);
+        }
+    });
+    it("keeps generated files outside package ownership", () => {
         const packageTargets = new Set(packageOwnedTargets);
-        for (const target of [...consumerOwnedTargets, ...generatedConsumerTargets]) {
+        for (const target of generatedConsumerTargets) {
             expect(packageTargets.has(target)).toBe(false);
         }
     });
+    it("lists supported optional templates", () => {
+        expect(templateNames).toEqual(["agentics-checks", "agentics-maintenance", "app-ci-dotnet-next", "app-ci-node-monorepo", "opencode.ci.json"]);
+    });
+    it("gives every catalog template a non-empty description and file", () => {
+        expect(catalogTemplates.map((template) => template.name)).toEqual([...templateNames]);
+        expect(new Set(catalogTemplates.map((template) => template.file)).size).toBe(catalogTemplates.length);
+        for (const template of catalogTemplates) {
+            expect(template.description.length).toBeGreaterThan(0);
+        }
+    });
 });

package/loops/actions/add-issue-labels/action.yml

@@ -1,29 +1,30 @@
-name: Add issue labels
-description: Add one or more labels to an issue or pull request.
-inputs:
-  token:
-    description: GitHub token used by github-script.
-    required: true
-  issue-number:
-    description: Issue or pull request number.
-    required: true
-  labels:
-    description: Newline-delimited labels to add.
-    required: true
-runs:
-  using: composite
-  steps:
-    - name: Add labels
-      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
-      env:
-        ISSUE_NUMBER: ${{ inputs.issue-number }}
-        LABELS: ${{ inputs.labels }}
-      with:
-        github-token: ${{ inputs.token }}
-        script: |
-          const labels = process.env.LABELS.split(/\r?\n/).filter(Boolean);
-          await github.rest.issues.addLabels({
-            ...context.repo,
-            issue_number: Number(process.env.ISSUE_NUMBER),
-            labels,
-          });
+# Managed by @plainconceptsplatform/workflows. Source: loops/actions/add-issue-labels/action.yml. Update with workflows update --force; consumer edits may be overwritten.
+name: Add issue labels
+description: Add one or more labels to an issue or pull request.
+inputs:
+  token:
+    description: GitHub token used by github-script.
+    required: true
+  issue-number:
+    description: Issue or pull request number.
+    required: true
+  labels:
+    description: Newline-delimited labels to add.
+    required: true
+runs:
+  using: composite
+  steps:
+    - name: Add labels
+      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+      env:
+        ISSUE_NUMBER: ${{ inputs.issue-number }}
+        LABELS: ${{ inputs.labels }}
+      with:
+        github-token: ${{ inputs.token }}
+        script: |
+          const labels = process.env.LABELS.split(/\r?\n/).filter(Boolean);
+          await github.rest.issues.addLabels({
+            ...context.repo,
+            issue_number: Number(process.env.ISSUE_NUMBER),
+            labels,
+          });

package/loops/actions/agent-output.cjs

@@ -1,3 +1,4 @@
+// Managed by @plainconceptsplatform/workflows. Source: loops/actions/agent-output.cjs. Update with `workflows update --force`; consumer edits may be overwritten.
 const fs = require('fs');
 
 // Every apply-agent-* action reads the same artifact the same way: a missing file means the

package/loops/actions/apply-agent-bundle/action.yml

@@ -1,23 +1,24 @@
-name: Apply agent bundle
-description: Fast-forward an intended branch to the single commit exported by a verified git bundle.
-inputs:
-  bundle-file:
-    description: Path to the git bundle from the agent artifact.
-    required: true
-  target-branch:
-    description: Branch that must fast-forward to the bundle commit.
-    required: true
-  base-branch:
-    description: Existing branch used only when target-branch does not exist.
-    required: false
-    default: ''
-runs:
-  using: composite
-  steps:
-    - name: Fast-forward branch from bundle
-      shell: bash
-      env:
-        BUNDLE_FILE: ${{ inputs.bundle-file }}
-        TARGET_BRANCH: ${{ inputs.target-branch }}
-        BASE_BRANCH: ${{ inputs.base-branch }}
-      run: bash "$GITHUB_ACTION_PATH/apply-bundle.sh" "$BUNDLE_FILE" "$TARGET_BRANCH" "$BASE_BRANCH"
+# Managed by @plainconceptsplatform/workflows. Source: loops/actions/apply-agent-bundle/action.yml. Update with workflows update --force; consumer edits may be overwritten.
+name: Apply agent bundle
+description: Fast-forward an intended branch to the single commit exported by a verified git bundle.
+inputs:
+  bundle-file:
+    description: Path to the git bundle from the agent artifact.
+    required: true
+  target-branch:
+    description: Branch that must fast-forward to the bundle commit.
+    required: true
+  base-branch:
+    description: Existing branch used only when target-branch does not exist.
+    required: false
+    default: ''
+runs:
+  using: composite
+  steps:
+    - name: Fast-forward branch from bundle
+      shell: bash
+      env:
+        BUNDLE_FILE: ${{ inputs.bundle-file }}
+        TARGET_BRANCH: ${{ inputs.target-branch }}
+        BASE_BRANCH: ${{ inputs.base-branch }}
+      run: bash "$GITHUB_ACTION_PATH/apply-bundle.sh" "$BUNDLE_FILE" "$TARGET_BRANCH" "$BASE_BRANCH"

package/loops/actions/apply-agent-bundle/apply-bundle.sh

@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# Managed by @plainconceptsplatform/workflows. Source: loops/actions/apply-agent-bundle/apply-bundle.sh. Update with `workflows update --force`; consumer edits may be overwritten.
 set -euo pipefail
 
 BUNDLE_FILE=$1

package/loops/actions/apply-agent-comments/action.yml

@@ -1,41 +1,42 @@
-name: Apply agent comments
-description: Post every add_comment item from agent_output.json.
-inputs:
-  output-file:
-    description: Path to agent_output.json.
-    required: true
-  token:
-    description: GitHub token with issues:write and pull-requests:write.
-    required: true
-runs:
-  using: composite
-  steps:
-    - name: Post comments
-      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
-      env:
-        AGENT_OUTPUT_LIB: ${{ github.action_path }}/../agent-output.cjs
-        OUTPUT_FILE: ${{ inputs.output-file }}
-      with:
-        github-token: ${{ inputs.token }}
-        script: |
-          const { readAgentItems } = require(process.env.AGENT_OUTPUT_LIB);
-          const items = readAgentItems(process.env.OUTPUT_FILE, 'add_comment');
-
-          let posted = 0;
-
-          for (const item of items) {
-            if (!item.item_number) {
-              core.warning(`add_comment item has no item_number, skipping: ${JSON.stringify(item)}`);
-              continue;
-            }
-
-            await github.rest.issues.createComment({
-              ...context.repo,
-              issue_number: Number(item.item_number),
-              body: item.body,
-            });
-
-            posted += 1;
-          }
-
-          core.info(`Posted ${posted} comment(s).`);
+# Managed by @plainconceptsplatform/workflows. Source: loops/actions/apply-agent-comments/action.yml. Update with workflows update --force; consumer edits may be overwritten.
+name: Apply agent comments
+description: Post every add_comment item from agent_output.json.
+inputs:
+  output-file:
+    description: Path to agent_output.json.
+    required: true
+  token:
+    description: GitHub token with issues:write and pull-requests:write.
+    required: true
+runs:
+  using: composite
+  steps:
+    - name: Post comments
+      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+      env:
+        AGENT_OUTPUT_LIB: ${{ github.action_path }}/../agent-output.cjs
+        OUTPUT_FILE: ${{ inputs.output-file }}
+      with:
+        github-token: ${{ inputs.token }}
+        script: |
+          const { readAgentItems } = require(process.env.AGENT_OUTPUT_LIB);
+          const items = readAgentItems(process.env.OUTPUT_FILE, 'add_comment');
+
+          let posted = 0;
+
+          for (const item of items) {
+            if (!item.item_number) {
+              core.warning(`add_comment item has no item_number, skipping: ${JSON.stringify(item)}`);
+              continue;
+            }
+
+            await github.rest.issues.createComment({
+              ...context.repo,
+              issue_number: Number(item.item_number),
+              body: item.body,
+            });
+
+            posted += 1;
+          }
+
+          core.info(`Posted ${posted} comment(s).`);

package/loops/actions/apply-agent-labels/action.yml

@@ -1,54 +1,55 @@
-name: Apply agent labels
-description: Apply every add_labels and remove_labels item from agent_output.json.
-inputs:
-  output-file:
-    description: Path to agent_output.json.
-    required: true
-  token:
-    description: GitHub token with issues:write.
-    required: true
-runs:
-  using: composite
-  steps:
-    - name: Apply label changes
-      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
-      env:
-        AGENT_OUTPUT_LIB: ${{ github.action_path }}/../agent-output.cjs
-        OUTPUT_FILE: ${{ inputs.output-file }}
-      with:
-        github-token: ${{ inputs.token }}
-        script: |
-          const { readAgentItems } = require(process.env.AGENT_OUTPUT_LIB);
-          const items = readAgentItems(process.env.OUTPUT_FILE)
-            .filter((item) => item.type === 'add_labels' || item.type === 'remove_labels');
-
-          let added = 0;
-          let removed = 0;
-
-          for (const item of items) {
-            const labels = (item.labels ?? []).map((label) => label.name).filter(Boolean);
-
-            if (!item.item_number || labels.length === 0) {
-              core.warning(`${item.type} item is not actionable, skipping: ${JSON.stringify(item)}`);
-              continue;
-            }
-
-            const issue_number = Number(item.item_number);
-
-            if (item.type === 'add_labels') {
-              await github.rest.issues.addLabels({ ...context.repo, issue_number, labels });
-              added += labels.length;
-              continue;
-            }
-
-            for (const name of labels) {
-              try {
-                await github.rest.issues.removeLabel({ ...context.repo, issue_number, name });
-                removed += 1;
-              } catch (error) {
-                if (error.status !== 404) throw error;
-              }
-            }
-          }
-
-          core.info(`Added ${added} label(s), removed ${removed}.`);
+# Managed by @plainconceptsplatform/workflows. Source: loops/actions/apply-agent-labels/action.yml. Update with workflows update --force; consumer edits may be overwritten.
+name: Apply agent labels
+description: Apply every add_labels and remove_labels item from agent_output.json.
+inputs:
+  output-file:
+    description: Path to agent_output.json.
+    required: true
+  token:
+    description: GitHub token with issues:write.
+    required: true
+runs:
+  using: composite
+  steps:
+    - name: Apply label changes
+      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+      env:
+        AGENT_OUTPUT_LIB: ${{ github.action_path }}/../agent-output.cjs
+        OUTPUT_FILE: ${{ inputs.output-file }}
+      with:
+        github-token: ${{ inputs.token }}
+        script: |
+          const { readAgentItems } = require(process.env.AGENT_OUTPUT_LIB);
+          const items = readAgentItems(process.env.OUTPUT_FILE)
+            .filter((item) => item.type === 'add_labels' || item.type === 'remove_labels');
+
+          let added = 0;
+          let removed = 0;
+
+          for (const item of items) {
+            const labels = (item.labels ?? []).map((label) => label.name).filter(Boolean);
+
+            if (!item.item_number || labels.length === 0) {
+              core.warning(`${item.type} item is not actionable, skipping: ${JSON.stringify(item)}`);
+              continue;
+            }
+
+            const issue_number = Number(item.item_number);
+
+            if (item.type === 'add_labels') {
+              await github.rest.issues.addLabels({ ...context.repo, issue_number, labels });
+              added += labels.length;
+              continue;
+            }
+
+            for (const name of labels) {
+              try {
+                await github.rest.issues.removeLabel({ ...context.repo, issue_number, name });
+                removed += 1;
+              } catch (error) {
+                if (error.status !== 404) throw error;
+              }
+            }
+          }
+
+          core.info(`Added ${added} label(s), removed ${removed}.`);