@synap-core/workspace-templates 0.24.1 → 0.25.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synap-core/workspace-templates",
-  "version": "0.24.1",
+  "version": "0.25.0",
   "type": "module",
   "description": "Canonical workspace definitions — YAML source + typed exports for browser, backend, CLI, and marketplace",
   "repository": {

package/src/builder-dev-playbooks.template.test.ts

@@ -0,0 +1,66 @@
+/**
+ * The dev playbooks of the Builder template (decision d05, founder
+ * instruction 2026-11-05): Build a change, Fix a bug, Investigate, Review a
+ * change, Maintain, Fix main red. They ship as DRAFTS with NO activators, so a pod
+ * that installs the template gets them off, and a person turns each on
+ * (a later template update keeps the pod's own draft/active choice).
+ *
+ * "Fix a bug" binds to `issue`, a CORE kind the pod seeds on every pod
+ * (ensure-system-profiles.ts / ensure-system-lifecycles.ts); Builder declares it
+ * to match that seed, so the lifecycle below must not drift from it.
+ */
+import { describe, expect, it } from "vitest";
+import { getWorkspaceTemplate } from "./templates.js";
+
+const DEV_PLAYBOOKS = ["Build a change", "Fix a bug", "Investigate", "Review a change", "Maintain", "Fix main red"] as const;
+
+type Stage = { key: string; subjectStatus?: string };
+type Playbook = {
+  name: string;
+  status?: string;
+  activators?: unknown;
+  stages?: Stage[];
+  subjectProfile?: { profileSlug?: string; statusProperty?: string; activators?: unknown };
+};
+
+const playbooks = (getWorkspaceTemplate("builder-workspace")?.playbooks ?? []) as Playbook[];
+const find = (name: string) => playbooks.find((p) => p.name === name);
+
+describe("builder dev playbooks", () => {
+  it.each(DEV_PLAYBOOKS)("%s is present, a draft, with no activator", (name) => {
+    const pb = find(name);
+    expect(pb, `${name} missing from builder.yaml`).toBeDefined();
+    expect(pb?.status).toBe("draft");
+    expect(pb?.activators).toBeUndefined();
+    expect(pb?.subjectProfile?.activators).toBeUndefined();
+  });
+
+  it.each(DEV_PLAYBOOKS)("%s names a statusProperty wherever a stage moves a status", (name) => {
+    const pb = find(name);
+    const moves = (pb?.stages ?? []).some((s) => s.subjectStatus);
+    if (moves) expect(pb?.subjectProfile?.statusProperty).toBeTruthy();
+  });
+
+  it("Fix a bug works the core `issue` kind through its declared lifecycle", () => {
+    const pb = find("Fix a bug");
+    expect(pb?.subjectProfile?.profileSlug).toBe("issue");
+    expect(pb?.subjectProfile?.statusProperty).toBe("issueStatus");
+    const issue = (getWorkspaceTemplate("builder-workspace")?.profiles ?? []).find((p) => p.slug === "issue") as
+      | { lifecycle?: { property: string; options: { key: string; category: string }[] } }
+      | undefined;
+    expect(issue?.lifecycle?.property).toBe("issueStatus");
+    expect(issue?.lifecycle?.options.map((o) => [o.key, o.category])).toEqual([
+      ["open", "open"],
+      ["investigating", "active"],
+      ["fixed", "done"],
+      ["wont_fix", "lost"],
+    ]);
+    for (const s of pb?.stages ?? []) {
+      if (s.subjectStatus) expect(["open", "investigating", "fixed", "wont_fix"]).toContain(s.subjectStatus);
+    }
+  });
+
+  it("each name is declared once", () => {
+    for (const name of DEV_PLAYBOOKS) expect(playbooks.filter((p) => p.name === name)).toHaveLength(1);
+  });
+});