@synap-core/workspace-templates 0.28.0 → 0.30.0

package/package.json

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

package/src/builder.yaml

@@ -1062,6 +1062,77 @@ profiles:
         inputType: textarea
         constraints: { maxLength: 5000 }
 
+  # A problem with our own product or process, worked by "Fix a finding" below.
+  # Declared as the founder's pod holds it (pod-local profile 0f1eb707, founder
+  # decision on card catalog-home, session 7416a988, 7 Nov 2026): pod-wide rows,
+  # so a finding filed from any space is one list. Property slugs are the live
+  # ones (`supersededby` included) so a reconcile onto that pod adds nothing. Two
+  # differences, both from the catalog's coverage rules: `wont_fix` and
+  # `superseded` are humanOnly (an agent's move into a lost option proposes
+  # anyway), and the unlabelled legacy `ek-claim` is left out. Not research-base's `finding` (a validated fact with a claim and a
+  # confidence): that slug clash is plan b38e5e64 decision 5, a rename of the
+  # Research kind that waits on a data conversion.
+  - slug: finding
+    displayName: Finding
+    icon: bug
+    color: "#F97316"
+    description: A problem report or feedback item, with a severity, raised against our own product or process. Moves open → fixing → fixed → verified, or won't fix / superseded.
+    scope: shared
+    entityScope: pod
+    profileKind: kind
+    lifecycle:
+      property: status
+      options:
+        - { key: open, category: open }
+        - { key: fixing, category: active }
+        - { key: fixed, category: done }
+        - { key: verified, category: done }
+        - { key: wont_fix, category: lost, humanOnly: true }
+        - { key: superseded, category: lost, humanOnly: true }
+    properties:
+      - slug: status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [open, fixing, fixed, verified, wont_fix, superseded]
+        constraints: { defaultValue: open }
+      - slug: severity
+        label: Severity
+        valueType: string
+        inputType: select
+        enumValues: [low, medium, high, critical]
+      - slug: area
+        label: Product area
+        valueType: string
+        inputType: text
+        description: "Where it hurts: pod, mcp, bridge, cli, relay, browser, pod-admin, control-plane, governance, infra, process."
+      - slug: evidence
+        label: Evidence
+        valueType: string
+        inputType: textarea
+        constraints: { maxLength: 2000 }
+        description: Proposal, session, file:line, log line or URL that shows it.
+      - slug: summary
+        label: Summary
+        valueType: string
+        inputType: text
+        constraints: { maxLength: 500 }
+      - slug: description
+        label: Description
+        valueType: string
+        inputType: textarea
+        constraints: { maxLength: 5000 }
+      - slug: content
+        label: Content
+        valueType: string
+        inputType: textarea
+        constraints: { maxLength: 50000 }
+      - slug: supersededby
+        label: Superseded by
+        valueType: entity_id
+        inputType: entity_select
+        description: "The record that replaced this finding: the canonical finding it duplicates, or the correct diagnosis when this one was wrong. Recall leaves a superseded finding out."
+
   - slug: skill
     displayName: Skill
     icon: zap
@@ -2853,6 +2924,47 @@ playbooks:
         statement: Every criterion of the session is graded with its evidence, and nothing unverified is reported as verified.
       description: 'Shared land stage. Never report unverified work as verified. File the lesson, decision or finding the work produced (engineering-memory skill, rule dogfood-journal). Close what you opened: asks answered or withdrawn, worktree removed once merged, then synap_complete_session. Tools: synap_update_session, synap_capture, synap_complete_session. Gate: none. Model tier: quick (advisory until a tier field exists).'
 
+  # Founder's pod playbook 18abd1ea, as it runs since 6 Nov 2026: no onEnd
+  # (decision f06dc507: a cancelled or failed session leaves its finding where it
+  # is) and no statusProperty (it follows the kind's lifecycle, backend#853).
+  # The two pod automations that move it (PR merged → merged, deployed →
+  # verified) are not shipped: their session_update step scopes on
+  # `whenPlaybookId`, a pod uuid, and there is no catalog-stable reference yet.
+  - name: Fix a finding
+    description: "Work one finding (a problem with Synap itself) until its fix is live. The session's stages move the finding: fixing while the work runs, fixed when the fix is merged, verified once it runs on the pod. A cancelled or failed session leaves the finding where it is."
+    goalTemplate: Fix the finding and see the fix live
+    scope: session
+    subjectProfile:
+      profileSlug: finding
+      statusProperty: status
+    # The options no stage owns (catalog lifecycle coverage): `open` is where a
+    # finding starts, `wont_fix` and `superseded` are a call made outside the fix.
+    # With no onEnd nothing moves a finding into them, and a finding in them has
+    # no stage to bind a session to anyway.
+    humanOnlyStatuses:
+      - open
+      - wont_fix
+      - superseded
+    params: []
+    executor: is-agent
+    status: active
+    stages:
+    - key: fix
+      name: Fix it
+      goal: Find the root cause and ship the fix as a gated PR or commit
+      category: started
+      subjectStatus: fixing
+    - key: merged
+      name: Fix merged
+      goal: The fix is on main (a merged PR or a gated commit)
+      category: started
+      subjectStatus: fixed
+    - key: verified
+      name: Live and verified
+      goal: The fix runs on the pod (its build contains the fix) and the finding no longer happens
+      category: completed
+      subjectStatus: verified
+
 onboarding:
   goal: Capture the real engineering surface — the apps that are shipped, where their code lives, what runs behind them, where they deploy, and what's in flight — so the workspace mirrors what the team actually builds and runs, not a generic template.
   framing: >

package/src/intent.test.ts

@@ -147,7 +147,7 @@ describe("meta.intent — the catalog", () => {
     expect(table["operations"]).toEqual(["Delivery", "engagement", "deliverable"]);
     expect(table["content-os"]).toEqual(["Content", "post", "newsletter", "campaign"]);
     expect(table["finance"]).toEqual(["Finance", "invoice", "expense"]);
-    expect(table["research-base"]).toEqual(["Research", "hypothesis", "finding"]);
+    expect(table["research-base"]).toEqual(["Research", "hypothesis", "research-finding"]);
   });
 
   it("libraries carry a label only; overlays and packs carry none", () => {

package/src/research-base.yaml

@@ -31,7 +31,7 @@ meta:
     label: Research
     produces:
       - profile: hypothesis
-      - profile: finding
+      - profile: research-finding
 
 workspace:
   name: Research
@@ -214,7 +214,7 @@ profiles:
         valueType: string
         inputType: textarea
 
-  - slug: finding
+  - slug: research-finding
     displayName: Finding
     icon: check-circle
     color: "#10B981"
@@ -253,7 +253,7 @@ views:
   - name: Knowledge Map
     slug: research-knowledge-map
     type: graph
-    scopeProfileSlugs: [field, concept, finding]
+    scopeProfileSlugs: [field, concept, research-finding]
     description: The cartography — fields and concepts, their overlaps and prerequisites, and the findings attached to them.
     defaultView: true
     config:
@@ -287,7 +287,7 @@ views:
   - name: Findings
     slug: research-findings
     type: table
-    scopeProfileSlug: finding
+    scopeProfileSlug: research-finding
     description: What's been established, with its confidence.
     config:
       columns: [title, confidence, status]
@@ -349,7 +349,7 @@ entityLinks:
     }
   - {
       sourceProfileSlug: research,
-      targetProfileSlug: finding,
+      targetProfileSlug: research-finding,
       type: concluded,
       label: Concluded,
     }
@@ -373,19 +373,19 @@ entityLinks:
       label: Cites,
     }
   - {
-      sourceProfileSlug: finding,
+      sourceProfileSlug: research-finding,
       targetProfileSlug: research,
       type: derived_from,
       label: Derived from,
     }
   - {
-      sourceProfileSlug: finding,
+      sourceProfileSlug: research-finding,
       targetProfileSlug: source,
       type: supported_by,
       label: Supported by,
     }
   - {
-      sourceProfileSlug: finding,
+      sourceProfileSlug: research-finding,
       targetProfileSlug: concept,
       type: about,
       label: About,
@@ -410,7 +410,7 @@ playbooks:
       rejected with a reason (never silently drop a source). WEIGH: form the
       candidate answers as `hypothesis` entities that answer the question; link
       every source that bears on a hypothesis with `supports` or
-      `contradicts`; use the evidence-synthesis skill to emit `finding`
+      `contradicts`; use the evidence-synthesis skill to emit `research-finding`
       entities with honestly calibrated confidence, each `supported_by` its
       sources and `derived_from` this research; use the concept-cartography
       skill to place the findings onto the knowledge map. ANSWER: create the
@@ -486,7 +486,7 @@ playbooks:
       and link each one derived_from the finding. Quote only what the sources
       support.
     subjectProfile:
-      profileSlug: finding
+      profileSlug: research-finding
       statusProperty: status
     activators:
       - { on: enters_status, status: validated, mode: propose }

package/src/templates.ts

@@ -5212,6 +5212,129 @@ const DATA = {
           }
         ]
       },
+      {
+        "slug": "finding",
+        "displayName": "Finding",
+        "icon": "bug",
+        "color": "#F97316",
+        "description": "A problem report or feedback item, with a severity, raised against our own product or process. Moves open → fixing → fixed → verified, or won't fix / superseded.",
+        "scope": "shared",
+        "entityScope": "pod",
+        "profileKind": "kind",
+        "lifecycle": {
+          "property": "status",
+          "options": [
+            {
+              "key": "open",
+              "category": "open"
+            },
+            {
+              "key": "fixing",
+              "category": "active"
+            },
+            {
+              "key": "fixed",
+              "category": "done"
+            },
+            {
+              "key": "verified",
+              "category": "done"
+            },
+            {
+              "key": "wont_fix",
+              "category": "lost",
+              "humanOnly": true
+            },
+            {
+              "key": "superseded",
+              "category": "lost",
+              "humanOnly": true
+            }
+          ]
+        },
+        "properties": [
+          {
+            "slug": "status",
+            "label": "Status",
+            "valueType": "string",
+            "inputType": "select",
+            "enumValues": [
+              "open",
+              "fixing",
+              "fixed",
+              "verified",
+              "wont_fix",
+              "superseded"
+            ],
+            "constraints": {
+              "defaultValue": "open"
+            }
+          },
+          {
+            "slug": "severity",
+            "label": "Severity",
+            "valueType": "string",
+            "inputType": "select",
+            "enumValues": [
+              "low",
+              "medium",
+              "high",
+              "critical"
+            ]
+          },
+          {
+            "slug": "area",
+            "label": "Product area",
+            "valueType": "string",
+            "inputType": "text",
+            "description": "Where it hurts: pod, mcp, bridge, cli, relay, browser, pod-admin, control-plane, governance, infra, process."
+          },
+          {
+            "slug": "evidence",
+            "label": "Evidence",
+            "valueType": "string",
+            "inputType": "textarea",
+            "constraints": {
+              "maxLength": 2000
+            },
+            "description": "Proposal, session, file:line, log line or URL that shows it."
+          },
+          {
+            "slug": "summary",
+            "label": "Summary",
+            "valueType": "string",
+            "inputType": "text",
+            "constraints": {
+              "maxLength": 500
+            }
+          },
+          {
+            "slug": "description",
+            "label": "Description",
+            "valueType": "string",
+            "inputType": "textarea",
+            "constraints": {
+              "maxLength": 5000
+            }
+          },
+          {
+            "slug": "content",
+            "label": "Content",
+            "valueType": "string",
+            "inputType": "textarea",
+            "constraints": {
+              "maxLength": 50000
+            }
+          },
+          {
+            "slug": "supersededby",
+            "label": "Superseded by",
+            "valueType": "entity_id",
+            "inputType": "entity_select",
+            "description": "The record that replaced this finding: the canonical finding it duplicates, or the correct diagnosis when this one was wrong. Recall leaves a superseded finding out."
+          }
+        ]
+      },
       {
         "slug": "skill",
         "displayName": "Skill",
@@ -7890,6 +8013,47 @@ const DATA = {
             "description": "Shared land stage. Never report unverified work as verified. File the lesson, decision or finding the work produced (engineering-memory skill, rule dogfood-journal). Close what you opened: asks answered or withdrawn, worktree removed once merged, then synap_complete_session. Tools: synap_update_session, synap_capture, synap_complete_session. Gate: none. Model tier: quick (advisory until a tier field exists)."
           }
         ]
+      },
+      {
+        "name": "Fix a finding",
+        "description": "Work one finding (a problem with Synap itself) until its fix is live. The session's stages move the finding: fixing while the work runs, fixed when the fix is merged, verified once it runs on the pod. A cancelled or failed session leaves the finding where it is.",
+        "goalTemplate": "Fix the finding and see the fix live",
+        "scope": "session",
+        "subjectProfile": {
+          "profileSlug": "finding",
+          "statusProperty": "status"
+        },
+        "humanOnlyStatuses": [
+          "open",
+          "wont_fix",
+          "superseded"
+        ],
+        "params": [],
+        "executor": "is-agent",
+        "status": "active",
+        "stages": [
+          {
+            "key": "fix",
+            "name": "Fix it",
+            "goal": "Find the root cause and ship the fix as a gated PR or commit",
+            "category": "started",
+            "subjectStatus": "fixing"
+          },
+          {
+            "key": "merged",
+            "name": "Fix merged",
+            "goal": "The fix is on main (a merged PR or a gated commit)",
+            "category": "started",
+            "subjectStatus": "fixed"
+          },
+          {
+            "key": "verified",
+            "name": "Live and verified",
+            "goal": "The fix runs on the pod (its build contains the fix) and the finding no longer happens",
+            "category": "completed",
+            "subjectStatus": "verified"
+          }
+        ]
       }
     ],
     "onboarding": {
@@ -30073,7 +30237,7 @@ const DATA = {
             "profile": "hypothesis"
           },
           {
-            "profile": "finding"
+            "profile": "research-finding"
           }
         ]
       }
@@ -30369,7 +30533,7 @@ const DATA = {
         ]
       },
       {
-        "slug": "finding",
+        "slug": "research-finding",
         "displayName": "Finding",
         "icon": "check-circle",
         "color": "#10B981",
@@ -30439,7 +30603,7 @@ const DATA = {
         "scopeProfileSlugs": [
           "field",
           "concept",
-          "finding"
+          "research-finding"
         ],
         "description": "The cartography — fields and concepts, their overlaps and prerequisites, and the findings attached to them.",
         "defaultView": true,
@@ -30493,7 +30657,7 @@ const DATA = {
         "name": "Findings",
         "slug": "research-findings",
         "type": "table",
-        "scopeProfileSlug": "finding",
+        "scopeProfileSlug": "research-finding",
         "description": "What's been established, with its confidence.",
         "config": {
           "columns": [
@@ -30563,7 +30727,7 @@ const DATA = {
       },
       {
         "sourceProfileSlug": "research",
-        "targetProfileSlug": "finding",
+        "targetProfileSlug": "research-finding",
         "type": "concluded",
         "label": "Concluded"
       },
@@ -30586,19 +30750,19 @@ const DATA = {
         "label": "Cites"
       },
       {
-        "sourceProfileSlug": "finding",
+        "sourceProfileSlug": "research-finding",
         "targetProfileSlug": "research",
         "type": "derived_from",
         "label": "Derived from"
       },
       {
-        "sourceProfileSlug": "finding",
+        "sourceProfileSlug": "research-finding",
         "targetProfileSlug": "source",
         "type": "supported_by",
         "label": "Supported by"
       },
       {
-        "sourceProfileSlug": "finding",
+        "sourceProfileSlug": "research-finding",
         "targetProfileSlug": "concept",
         "type": "about",
         "label": "About"
@@ -30608,7 +30772,7 @@ const DATA = {
       {
         "name": "Research a Question",
         "description": "Investigate a question end-to-end — gather and rank sources (keeping the rejected ones), weigh hypotheses, emit findings with calibrated confidence, and map them onto the knowledge graph.",
-        "goalTemplate": "Investigate the question {question} and record the WHOLE investigation, not just the answer; each stage moves the question's status. FRAME: restate the question so it can be answered, and say what evidence would answer it. GATHER: use the source-triage skill to gather sources widely via web search, classify each by type and credibility, and create a `source` entity for every one — including the ones you rejected, marked rejected with a reason (never silently drop a source). WEIGH: form the candidate answers as `hypothesis` entities that answer the question; link every source that bears on a hypothesis with `supports` or `contradicts`; use the evidence-synthesis skill to emit `finding` entities with honestly calibrated confidence, each `supported_by` its sources and `derived_from` this research; use the concept-cartography skill to place the findings onto the knowledge map. ANSWER: create the `research` entity that `investigates` the question and `explored` the sources, write its conclusion and confidence, and set the question to answered. Abandoning a question is a person's call. Every write is proposal-gated and reviewable.",
+        "goalTemplate": "Investigate the question {question} and record the WHOLE investigation, not just the answer; each stage moves the question's status. FRAME: restate the question so it can be answered, and say what evidence would answer it. GATHER: use the source-triage skill to gather sources widely via web search, classify each by type and credibility, and create a `source` entity for every one — including the ones you rejected, marked rejected with a reason (never silently drop a source). WEIGH: form the candidate answers as `hypothesis` entities that answer the question; link every source that bears on a hypothesis with `supports` or `contradicts`; use the evidence-synthesis skill to emit `research-finding` entities with honestly calibrated confidence, each `supported_by` its sources and `derived_from` this research; use the concept-cartography skill to place the findings onto the knowledge map. ANSWER: create the `research` entity that `investigates` the question and `explored` the sources, write its conclusion and confidence, and set the question to answered. Abandoning a question is a person's call. Every write is proposal-gated and reviewable.",
         "subjectProfile": {
           "profileSlug": "question",
           "statusProperty": "questionStatus"
@@ -30729,7 +30893,7 @@ const DATA = {
         "description": "When a finding is validated, propose the posts that would share it, each linked to the finding.",
         "goalTemplate": "Turn this validated finding ({finding}) into content. Read the finding, its sources and the research it came from. Propose one to three posts that share it with the audience — each created at the Idea status, on the pillar it fits, with its hook and the reason it is worth making — and link each one derived_from the finding. Quote only what the sources support.",
         "subjectProfile": {
-          "profileSlug": "finding",
+          "profileSlug": "research-finding",
           "statusProperty": "status"
         },
         "activators": [