@plainconceptsplatform/workflows 0.4.32 → 0.4.33

package/dist/catalog-installation.js

@@ -299,11 +299,12 @@ function catalogTemplateMeta(template) {
     const entry = catalogTemplates.find((item) => item.name === template);
     if (entry === undefined)
         throw new Error(`Unknown template: ${template}`);
-    const directory = template.startsWith("opencode") ? "opencode" : template.startsWith("app-ci-") ? "ci" : template === "github-release" ? "release" : template === "visual-evidence" ? "visual-evidence" : "agentics";
+    const directory = template.startsWith("opencode") ? "opencode" : template.startsWith("app-ci-") ? "ci" : template === "github-release" ? "release" : template === "visual-evidence" ? "visual-evidence" : template === "bug-report" || template === "feature-request" ? "issues" : "agentics";
     const isWorkflow = entry.file.endsWith(".yml");
-    const target = template === "app-ci-dotnet-next"
+    const inferredTarget = template === "app-ci-dotnet-next"
         ? ".github/workflows/app-ci.yml"
         : isWorkflow ? `.github/workflows/${entry.file}` : entry.file;
+    const target = entry.target ?? inferredTarget;
     return { directory, file: entry.file, target };
 }
 async function catalogFiles(sourcePath) {

package/dist/catalog-installation.test.js

@@ -384,6 +384,23 @@ describe("catalog installation", () => {
             installed: [".github/workflows/agentics-checks.yml"],
         });
     });
+    it("installs issue templates to .github/ISSUE_TEMPLATE/", async () => {
+        const sourcePath = await createDirectory({
+            "templates/issues/bug_report.yml": "name: Bug report\n",
+            "templates/issues/feature_request.yml": "name: Feature request\n",
+        });
+        const repositoryPath = await createDirectory({});
+        await expect(installTemplate(repositoryPath, "bug-report", { sourcePath })).resolves.toEqual({
+            installed: [".github/ISSUE_TEMPLATE/bug_report.yml"],
+            conflicts: [],
+        });
+        await expect(installTemplate(repositoryPath, "feature-request", { sourcePath })).resolves.toEqual({
+            installed: [".github/ISSUE_TEMPLATE/feature_request.yml"],
+            conflicts: [],
+        });
+        await expect(readFile(join(repositoryPath, ".github/ISSUE_TEMPLATE/bug_report.yml"), "utf8")).resolves.toBe("name: Bug report\n");
+        await expect(readFile(join(repositoryPath, ".github/ISSUE_TEMPLATE/feature_request.yml"), "utf8")).resolves.toBe("name: Feature request\n");
+    });
 });
 describe("route lifecycle", () => {
     it("detects installed route workers in workflowRoutes order", async () => {

package/dist/catalog-listing.js

@@ -15,7 +15,7 @@ export async function listCatalog(options = {}) {
         name: template.name,
         description: template.description,
         file: template.file,
-        installed: await isFileInstalled(basePath, template.file),
+        installed: await isFileInstalled(basePath, template.file, template.target),
     })));
     return [...routes, ...templates];
 }
@@ -52,8 +52,8 @@ function formatEntry(entry) {
     const mark = entry.installed ? "[x]" : "[ ]";
     return `  ${mark} ${entry.name} — ${entry.description}`;
 }
-async function isFileInstalled(basePath, workerOrTemplateFile) {
-    const installedPath = templateInstallPath(basePath, workerOrTemplateFile);
+async function isFileInstalled(basePath, workerOrTemplateFile, explicitTarget) {
+    const installedPath = templateInstallPath(basePath, workerOrTemplateFile, explicitTarget);
     try {
         await access(installedPath, constants.F_OK);
         return true;
@@ -62,7 +62,9 @@ async function isFileInstalled(basePath, workerOrTemplateFile) {
         return false;
     }
 }
-function templateInstallPath(basePath, file) {
+function templateInstallPath(basePath, file, explicitTarget) {
+    if (explicitTarget !== undefined)
+        return join(basePath, ...explicitTarget.split("/"));
     const isRootTemplate = file.endsWith(".json");
     return isRootTemplate ? join(basePath, file) : join(basePath, ".github", "workflows", file);
 }

package/dist/catalog-listing.test.js

@@ -16,7 +16,7 @@ describe("catalog listing", () => {
         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", "apply-review", "merge-gate", "audit", "propose"]);
-        expect(templateNames).toEqual(["agentics-checks", "agentics-maintenance", "app-ci-dotnet-next", "app-ci-node-monorepo", "github-release", "opencode.ci.json", "visual-evidence"]);
+        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 () => {
         const repositoryPath = await createRepository({});
@@ -41,6 +41,19 @@ describe("catalog listing", () => {
         expect(checksEntry).toBeDefined();
         expect(checksEntry.installed).toBe(true);
     });
+    it("marks an issue template as installed when its file exists in .github/ISSUE_TEMPLATE/", async () => {
+        const repositoryPath = await createRepository({
+            ".github/ISSUE_TEMPLATE/bug_report.yml": "name: Bug report",
+            ".github/ISSUE_TEMPLATE/feature_request.yml": "name: Feature request",
+        });
+        const entries = await listCatalog({ installedPath: repositoryPath });
+        const bugEntry = entries.find((entry) => entry.name === "bug-report");
+        const featureEntry = entries.find((entry) => entry.name === "feature-request");
+        expect(bugEntry).toBeDefined();
+        expect(bugEntry.installed).toBe(true);
+        expect(featureEntry).toBeDefined();
+        expect(featureEntry.installed).toBe(true);
+    });
     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\" }",

package/dist/index.js

@@ -48,6 +48,7 @@ Options:
   --template <name>                           Install a standalone template alongside or instead of routes.
                                               Templates: agentics-checks, agentics-maintenance,
                                               app-ci-dotnet-next, app-ci-node-monorepo,
+                                              bug-report, feature-request, github-release,
                                               opencode.ci.json.
   --force                                     Overwrite managed files that differ from the package source.
   -h, --help                                  Show this help text.

package/dist/index.test.js

@@ -34,7 +34,7 @@ describe("workflows CLI", () => {
     it("rejects an unsupported template name", async () => {
         const error = vi.spyOn(console, "error").mockImplementation(() => undefined);
         await expect(run(["add", "--template", "unknown"])).resolves.toBe(1);
-        expect(error).toHaveBeenCalledWith("--template must be one of: agentics-checks|agentics-maintenance|app-ci-dotnet-next|app-ci-node-monorepo|github-release|opencode.ci.json|visual-evidence.");
+        expect(error).toHaveBeenCalledWith("--template must be one of: agentics-checks|agentics-maintenance|app-ci-dotnet-next|app-ci-node-monorepo|bug-report|feature-request|github-release|opencode.ci.json|visual-evidence.");
         error.mockRestore();
     });
     it("rejects an unknown route passed to add", async () => {
@@ -65,9 +65,9 @@ describe("workflows CLI", () => {
         // None installed: all [ ]
         const installedCount = (output.match(/\[x\]/g) ?? []).length;
         expect(installedCount).toBe(0);
-        // 7 routes + 7 templates = 14 entries
+        // 7 routes + 9 templates = 16 entries
         const uninstalledCount = (output.match(/\[ \]/g) ?? []).length;
-        expect(uninstalledCount).toBe(14);
+        expect(uninstalledCount).toBe(16);
         log.mockRestore();
     });
     it("marks installed workflows with [x]", async () => {

package/dist/workflow-catalog.d.ts

@@ -14,11 +14,12 @@ export interface MandatoryFile {
 }
 export declare const mandatoryFiles: readonly MandatoryFile[];
 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", "github-release", "opencode.ci.json", "visual-evidence"];
+export declare const templateNames: readonly ["agentics-checks", "agentics-maintenance", "app-ci-dotnet-next", "app-ci-node-monorepo", "bug-report", "feature-request", "github-release", "opencode.ci.json", "visual-evidence"];
 export type TemplateName = (typeof templateNames)[number];
 export interface CatalogTemplate {
     readonly name: TemplateName;
     readonly file: string;
     readonly description: string;
+    readonly target?: string;
 }
 export declare const catalogTemplates: readonly CatalogTemplate[];

package/dist/workflow-catalog.js

@@ -38,6 +38,8 @@ export const templateNames = [
     "agentics-maintenance",
     "app-ci-dotnet-next",
     "app-ci-node-monorepo",
+    "bug-report",
+    "feature-request",
     "github-release",
     "opencode.ci.json",
     "visual-evidence",
@@ -47,6 +49,8 @@ export const catalogTemplates = [
     { 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: "bug-report", file: "bug_report.yml", description: "Bug report issue template: what happened, repro steps, expected behavior, acceptance criteria, environment, logs.", target: ".github/ISSUE_TEMPLATE/bug_report.yml" },
+    { name: "feature-request", file: "feature_request.yml", description: "Feature request issue template scoped to small, well-scoped improvements (Small/Medium only; large work belongs in a planning issue).", target: ".github/ISSUE_TEMPLATE/feature_request.yml" },
     { name: "github-release", file: "github-release.yml", description: "Publishes or updates a GitHub Release with generated notes whenever a v* tag is pushed." },
     { 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." },
     { name: "visual-evidence", file: "visual-evidence.yml", description: "Visual evidence: captures screenshots of UI changes on bot-authored PRs by reading the capturePlan left by the agent in evidence.json and executing it on a runner with Docker and Chrome access." },

package/dist/workflow-catalog.test.js

@@ -17,7 +17,7 @@ describe("workflow catalog", () => {
         }
     });
     it("lists supported optional templates", () => {
-        expect(templateNames).toEqual(["agentics-checks", "agentics-maintenance", "app-ci-dotnet-next", "app-ci-node-monorepo", "github-release", "opencode.ci.json", "visual-evidence"]);
+        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("gives every catalog template a non-empty description and file", () => {
         expect(catalogTemplates.map((template) => template.name)).toEqual([...templateNames]);

package/loops/templates/issues/bug_report.yml

@@ -0,0 +1,109 @@
+name: Bug report
+description: Report a defect
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting. Do **not** include real secrets or production data — use placeholders.
+
+        For security vulnerabilities, contact the team directly instead of filing a public issue.
+  - type: dropdown
+    id: severity
+    attributes:
+      label: Severity
+      options:
+        - Production-down / data loss
+        - Major — broken core flow
+        - Minor — broken edge case
+        - Cosmetic / polish
+    validations:
+      required: true
+  - type: dropdown
+    id: frequency
+    attributes:
+      label: Frequency
+      description: How often does this happen?
+      options:
+        - Always
+        - Intermittent
+        - Only once
+    validations:
+      required: true
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: A clear description of the bug and its impact.
+    validations:
+      required: true
+  - type: textarea
+    id: repro
+    attributes:
+      label: Steps to reproduce
+      description: How can a maintainer reproduce it?
+      placeholder: |
+        1. Go to ...
+        2. Do ...
+        3. See error
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+  - type: dropdown
+    id: area
+    attributes:
+      label: Where does it occur?
+      options:
+        - Backend
+        - Frontend
+        - Both
+        - CLI / tooling
+        - Configuration / deployment
+        - Documentation
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance criteria
+      description: How will we know it's fixed? A checklist a reviewer can verify (include the test that should turn green).
+      placeholder: |
+        - [ ] ...
+        - [ ] A test that fails before the fix and passes after
+    validations:
+      required: false
+  - type: textarea
+    id: open-questions
+    attributes:
+      label: Open questions
+      description: Decisions a maintainer must make before this can be planned. Leave blank if none.
+    validations:
+      required: false
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Local vs deployed, branch/commit, OS, runtime versions if relevant.
+    validations:
+      required: false
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs / screenshots
+      description: Paste relevant logs or screenshots. Redact secrets and PII.
+      render: shell
+    validations:
+      required: false
+  - type: textarea
+    id: related
+    attributes:
+      label: Related links
+      description: Links to related issues, PRs, discussions, or docs. Leave blank if none.
+    validations:
+      required: false

package/loops/templates/issues/feature_request.yml

@@ -0,0 +1,75 @@
+name: Feature request
+description: Propose a small improvement or new capability
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        This template is for small, well-scoped improvements — a focused
+        enhancement, a missing convenience, a quality-of-life fix.
+
+        For large features, architecture changes, or cross-cutting work,
+        open a planning issue or an ADR instead.
+
+        Do **not** include real secrets or production data — use placeholders.
+  - type: dropdown
+    id: scope
+    attributes:
+      label: Scope
+      description: How big is this change? If it doesn't fit Small or Medium, use a planning issue instead.
+      options:
+        - Small — a single file or component, no refactoring
+        - Medium — touches a few files or a feature area, may need minor refactoring
+    validations:
+      required: true
+  - type: textarea
+    id: current-behavior
+    attributes:
+      label: Current behavior
+      description: How does it work today? Describe the existing behavior or limitation.
+    validations:
+      required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem / motivation
+      description: What user or business need does this address? Why is the current behavior a problem?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: What would you like to happen?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+    validations:
+      required: false
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance criteria
+      description: A checklist a reviewer can verify when this is done (include the tests).
+      placeholder: |
+        - [ ] ...
+        - [ ] Tests
+    validations:
+      required: false
+  - type: textarea
+    id: open-questions
+    attributes:
+      label: Open questions
+      description: Decisions a maintainer must make before this can be planned. Leave blank if none.
+    validations:
+      required: false
+  - type: textarea
+    id: related
+    attributes:
+      label: Related links
+      description: Links to related issues, PRs, discussions, or docs. Leave blank if none.
+    validations:
+      required: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plainconceptsplatform/workflows",
-  "version": "0.4.32",
+  "version": "0.4.33",
   "description": "Install and update Platform GitHub agentic workflows.",
   "keywords": [
     "github-actions",
@@ -40,4 +40,4 @@
     "typescript": "^5.8.0",
     "vitest": "^3.0.0"
   }
-}
+}