@synap-core/workspace-templates 0.7.1 → 0.7.3

package/src/blockchain-ecosystem.yaml

@@ -14,6 +14,7 @@
 
 meta:
   slug: blockchain-ecosystem
+  domain: strategy
   name: Blockchain Ecosystem
   description: "Web3 market actors — market-makers, auditors, dev shops, KOLs — and how they connect. Overlays the Ecosystem workspace."
   icon: boxes

package/src/brand-library.yaml

@@ -4,6 +4,7 @@
 
 meta:
   slug: brand-library
+  domain: content
   name: Brand Library
   description: Reusable source of truth for brand identity, colors, typography, assets, tokens, templates, and generation rules.
   icon: palette
@@ -40,7 +41,16 @@ profiles:
         label: Brand type
         valueType: string
         inputType: select
-        enumValues: [product-digital, product-physical, agency, personal-brand, nonprofit, institutional, universal]
+        enumValues:
+          [
+            product-digital,
+            product-physical,
+            agency,
+            personal-brand,
+            nonprofit,
+            institutional,
+            universal,
+          ]
         constraints: { defaultValue: universal }
       - slug: brand-status
         label: Status
@@ -92,7 +102,25 @@ profiles:
         label: Role
         valueType: string
         inputType: select
-        enumValues: [primary, secondary, accent, background, surface, surface-elevated, text, text-muted, border, success, warning, error, info, neutral, campaign, custom]
+        enumValues:
+          [
+            primary,
+            secondary,
+            accent,
+            background,
+            surface,
+            surface-elevated,
+            text,
+            text-muted,
+            border,
+            success,
+            warning,
+            error,
+            info,
+            neutral,
+            campaign,
+            custom,
+          ]
         constraints: { defaultValue: custom }
       - slug: color-group
         label: Group
@@ -160,7 +188,8 @@ profiles:
         label: License
         valueType: string
         inputType: select
-        enumValues: [open-source, google-fonts, adobe-fonts, licensed, custom, system]
+        enumValues:
+          [open-source, google-fonts, adobe-fonts, licensed, custom, system]
         constraints: { defaultValue: google-fonts }
       - slug: font-weights
         label: Weights
@@ -196,12 +225,44 @@ profiles:
         label: Kind
         valueType: string
         inputType: select
-        enumValues: [logo, wordmark, symbol, monogram, pattern, texture, icon-set, illustration, photo, video, document, font, 3d-model, print-ready, reference, other]
+        enumValues:
+          [
+            logo,
+            wordmark,
+            symbol,
+            monogram,
+            pattern,
+            texture,
+            icon-set,
+            illustration,
+            photo,
+            video,
+            document,
+            font,
+            3d-model,
+            print-ready,
+            reference,
+            other,
+          ]
       - slug: asset-variant
         label: Variant
         valueType: string
         inputType: select
-        enumValues: [primary, secondary, horizontal, stacked, mono-dark, mono-light, white, reversed, favicon, social-avatar, og-image, other]
+        enumValues:
+          [
+            primary,
+            secondary,
+            horizontal,
+            stacked,
+            mono-dark,
+            mono-light,
+            white,
+            reversed,
+            favicon,
+            social-avatar,
+            og-image,
+            other,
+          ]
       - slug: asset-status
         label: Status
         valueType: string
@@ -244,7 +305,17 @@ profiles:
         label: Kind
         valueType: string
         inputType: select
-        enumValues: [website, competitor, campaign, moodboard, copy-example, design-example, customer-example, other]
+        enumValues:
+          [
+            website,
+            competitor,
+            campaign,
+            moodboard,
+            copy-example,
+            design-example,
+            customer-example,
+            other,
+          ]
       - slug: reference-url
         label: URL
         valueType: string
@@ -307,7 +378,17 @@ profiles:
         label: Context
         valueType: string
         inputType: select
-        enumValues: [general, marketing, product, support, social, legal, editorial, investor]
+        enumValues:
+          [
+            general,
+            marketing,
+            product,
+            support,
+            social,
+            legal,
+            editorial,
+            investor,
+          ]
         constraints: { defaultValue: general }
       - slug: voice-status
         label: Status
@@ -351,12 +432,38 @@ profiles:
         label: Kind
         valueType: string
         inputType: select
-        enumValues: [visual, voice, legal, accessibility, sizing, clearance, color-usage, typography-usage, do, dont, generation, other]
+        enumValues:
+          [
+            visual,
+            voice,
+            legal,
+            accessibility,
+            sizing,
+            clearance,
+            color-usage,
+            typography-usage,
+            do,
+            dont,
+            generation,
+            other,
+          ]
       - slug: rule-subject
         label: Subject
         valueType: string
         inputType: select
-        enumValues: [logo, color, typography, pattern, asset, voice, general, digital, print, packaging]
+        enumValues:
+          [
+            logo,
+            color,
+            typography,
+            pattern,
+            asset,
+            voice,
+            general,
+            digital,
+            print,
+            packaging,
+          ]
       - slug: rule-severity
         label: Severity
         valueType: string
@@ -387,7 +494,8 @@ profiles:
         label: Kind
         valueType: string
         inputType: select
-        enumValues: [artboard, deck, carousel, banner, document, html, social, other]
+        enumValues:
+          [artboard, deck, carousel, banner, document, html, social, other]
       - slug: template-status
         label: Status
         valueType: string
@@ -419,7 +527,8 @@ profiles:
         label: Kind
         valueType: string
         inputType: select
-        enumValues: [hero, card, cta, quote, banner, section, layout, html, other]
+        enumValues:
+          [hero, card, cta, quote, banner, section, layout, html, other]
       - slug: component-status
         label: Status
         valueType: string
@@ -562,7 +671,13 @@ onboarding:
     - profileSlug: brand-voice-guide
       what: Voice guides — tone, personality traits, vocabulary, and do/don't examples per context.
       cardinality: few
-      keyFields: [voice-personality-traits, voice-tone-descriptors, voice-example-do, voice-example-dont]
+      keyFields:
+        [
+          voice-personality-traits,
+          voice-tone-descriptors,
+          voice-example-do,
+          voice-example-dont,
+        ]
     - profileSlug: brand-rule
       what: Usage rules and constraints (mandatory / important / guideline).
       cardinality: several

package/src/builder.yaml

@@ -4,6 +4,7 @@
 
 meta:
   slug: builder-workspace
+  domain: build
   name: Builder
   description: "Builder workspace — apps, features, services, packages, environments, deployments, recipes, decisions, incidents, plus delegated agent tasks/projects/skills/providers."
   icon: wrench
@@ -120,7 +121,20 @@ profiles:
         label: Agent Status
         valueType: string
         inputType: select
-        enumValues: [idea, gathering_context, dispatched, planning, plan_ready, executing, verifying, debugging, awaiting_review, done, error]
+        enumValues:
+          [
+            idea,
+            gathering_context,
+            dispatched,
+            planning,
+            plan_ready,
+            executing,
+            verifying,
+            debugging,
+            awaiting_review,
+            done,
+            error,
+          ]
         constraints: { defaultValue: idea }
       - slug: agent_phase
         label: Agent Phase (current dispatch)
@@ -205,7 +219,19 @@ profiles:
         label: Agent Status
         valueType: string
         inputType: select
-        enumValues: [idle, gathering_context, planning, awaiting_plan_approval, executing, verifying, awaiting_deploy_approval, deploying, done, blocked]
+        enumValues:
+          [
+            idle,
+            gathering_context,
+            planning,
+            awaiting_plan_approval,
+            executing,
+            verifying,
+            awaiting_deploy_approval,
+            deploying,
+            done,
+            blocked,
+          ]
         constraints: { defaultValue: idle }
       - slug: context_doc_id
         label: Context Doc ID
@@ -794,7 +820,16 @@ profiles:
         label: Category
         valueType: string
         inputType: select
-        enumValues: [architecture, testing, security, performance, style, tooling, workflow]
+        enumValues:
+          [
+            architecture,
+            testing,
+            security,
+            performance,
+            style,
+            tooling,
+            workflow,
+          ]
       - slug: tech_stack
         label: Tech Stack
         valueType: string
@@ -874,7 +909,8 @@ profiles:
         label: Status
         valueType: string
         inputType: select
-        enumValues: [Backlog, Queued, In Progress, Blocked, Completed, Cancelled]
+        enumValues:
+          [Backlog, Queued, In Progress, Blocked, Completed, Cancelled]
       - slug: project-priority
         label: Priority
         valueType: string
@@ -899,7 +935,17 @@ profiles:
         label: Type
         valueType: string
         inputType: select
-        enumValues: [Development, Research, Content, Automation, DevOps, Data, Outreach, Monitoring]
+        enumValues:
+          [
+            Development,
+            Research,
+            Content,
+            Automation,
+            DevOps,
+            Data,
+            Outreach,
+            Monitoring,
+          ]
       - slug: project-goal
         label: Goal
         valueType: string
@@ -933,7 +979,18 @@ profiles:
         label: Type
         valueType: string
         inputType: select
-        enumValues: [Code, Research, Content, Ops, Data, Outreach, Review, Monitor, Custom]
+        enumValues:
+          [
+            Code,
+            Research,
+            Content,
+            Ops,
+            Data,
+            Outreach,
+            Review,
+            Monitor,
+            Custom,
+          ]
       - slug: task-due-date
         label: Due Date
         valueType: date
@@ -969,7 +1026,19 @@ profiles:
         label: Category
         valueType: string
         inputType: select
-        enumValues: [Productivity, Development, Communication, Data, Security, Storage, Browser, Voice, IoT, Custom]
+        enumValues:
+          [
+            Productivity,
+            Development,
+            Communication,
+            Data,
+            Security,
+            Storage,
+            Browser,
+            Voice,
+            IoT,
+            Custom,
+          ]
       - slug: skill-source-url
         label: Source URL
         valueType: string
@@ -1007,7 +1076,8 @@ profiles:
         label: Type
         valueType: string
         inputType: select
-        enumValues: [LLM Cloud, LLM Local, API Gateway, Vector DB, Storage, Custom]
+        enumValues:
+          [LLM Cloud, LLM Local, API Gateway, Vector DB, Storage, Custom]
       - slug: provider-key-health
         label: Key Health
         valueType: string
@@ -1046,7 +1116,20 @@ profiles:
         label: Type
         valueType: string
         inputType: select
-        enumValues: [frontend, backend, database, cache, queue, external-api, cdn, storage, auth, monitoring, other]
+        enumValues:
+          [
+            frontend,
+            backend,
+            database,
+            cache,
+            queue,
+            external-api,
+            cdn,
+            storage,
+            auth,
+            monitoring,
+            other,
+          ]
       - slug: componentStatus
         label: Status
         valueType: string
@@ -1102,7 +1185,16 @@ profiles:
         label: Category
         valueType: string
         inputType: select
-        enumValues: [user-flow, data-pipeline, deploy-pipeline, auth-flow, payment-flow, notification-flow, other]
+        enumValues:
+          [
+            user-flow,
+            data-pipeline,
+            deploy-pipeline,
+            auth-flow,
+            payment-flow,
+            notification-flow,
+            other,
+          ]
       - slug: trigger
         label: Trigger
         valueType: string
@@ -1138,7 +1230,18 @@ profiles:
         label: Type
         valueType: string
         inputType: select
-        enumValues: [rendering, data, auth, ai, infra, ui, workflow, integration, external]
+        enumValues:
+          [
+            rendering,
+            data,
+            auth,
+            ai,
+            infra,
+            ui,
+            workflow,
+            integration,
+            external,
+          ]
       - slug: maturity
         label: Maturity
         valueType: string
@@ -1214,7 +1317,8 @@ views:
   # derives nodes from the loaded entities + edges from the relations table.
   - name: Architecture Graph
     type: flow
-    scopeProfileSlugs: [devplane_workflow, devplane_system_component, devplane_capability]
+    scopeProfileSlugs:
+      [devplane_workflow, devplane_system_component, devplane_capability]
     config:
       render:
         variant: architecture

package/src/business-developer.yaml

@@ -17,6 +17,7 @@
 
 meta:
   slug: business-developer
+  domain: revenue
   name: Business Developer
   description: "A lead-first sales motion for a CRM workspace: qualify leads, work commercial proposals, and hand won clients to the next system."
   icon: target
@@ -50,13 +51,29 @@ profiles:
     description: A person or company actively being qualified or contacted by this CRM workspace.
     scope: WORKSPACE
     profileKind: role
+    # Explicit concept identity: this is the WORKSPACE tier of the `lead`
+    # concept, not a second, unrelated one. Declaring it makes the two-tier
+    # design machine-readable (both tiers are reachable via getBySemanticSlug)
+    # and is what the cross-template concept guard requires alongside its
+    # DECLARED_DIVERGENCES entry — see src/concept-guard.ts.
+    semanticSlug: crm.lead
     applicableKinds: [person, company]
     properties:
       - slug: lifecycleStage
         label: Lifecycle stage
         valueType: string
         inputType: select
-        enumValues: [new, researching, outreach, engaged, qualified, nurturing, disqualified, converted]
+        enumValues:
+          [
+            new,
+            researching,
+            outreach,
+            engaged,
+            qualified,
+            nurturing,
+            disqualified,
+            converted,
+          ]
         constraints: { defaultValue: new }
       - slug: assignedUserId
         label: Assigned user ID
@@ -67,7 +84,18 @@ profiles:
         label: Source
         valueType: string
         inputType: select
-        enumValues: [manual, referral, linkedin, email, event, inbound, partner, import, other]
+        enumValues:
+          [
+            manual,
+            referral,
+            linkedin,
+            email,
+            event,
+            inbound,
+            partner,
+            import,
+            other,
+          ]
       - slug: icpScore
         label: ICP score
         valueType: number
@@ -112,6 +140,8 @@ profiles:
     description: A CRM lead converted by a won commercial proposal and ready for handoff.
     scope: WORKSPACE
     profileKind: role
+    # Workspace tier of the `client` concept — see the note on `crm-lead` above.
+    semanticSlug: crm.client
     applicableKinds: [person, company]
     properties:
       - slug: becameClientAt
@@ -333,8 +363,14 @@ automations:
                 message: This action is only available for a commercial proposal.
               - path: steps.read-deal.output.entity.properties.commercialStage
                 anyOf:
-                  - { path: steps.read-deal.output.entity.properties.commercialStage, equals: won }
-                  - { path: steps.read-deal.output.entity.properties.dealStage, equals: won }
+                  - {
+                      path: steps.read-deal.output.entity.properties.commercialStage,
+                      equals: won,
+                    }
+                  - {
+                      path: steps.read-deal.output.entity.properties.dealStage,
+                      equals: won,
+                    }
                 message: Mark the proposal as won before handing it off.
               - path: steps.read-deal.output.entity.properties.handoffStatus
                 notEquals: handed_off
@@ -586,21 +622,77 @@ automations:
         - { id: party-search-guard, source: find-party, target: guard-party }
         - { id: party-guard-read, source: guard-party, target: read-party }
         - { id: party-read-guard, source: read-party, target: guard-lead }
-        - { id: lead-guard-commission-claim, source: guard-lead, target: claim-commission-entitlement }
-        - { id: commission-claim-guard, source: claim-commission-entitlement, target: guard-commission-claim }
-        - { id: commission-guard-first-claim, source: guard-commission-claim, target: claim-first-client-deal }
-        - { id: first-claim-history, source: claim-first-client-deal, target: prior-won-deals }
-        - { id: history-condition, source: prior-won-deals, target: has-no-prior-won-deals }
-        - { id: first-confirm-bonus, source: is-first-client-deal, target: first-deal-bonus-bps }
-        - { id: first-history-confirm, source: has-no-prior-won-deals, target: is-first-client-deal }
-        - { id: first-confirm-sequence, source: is-first-client-deal, target: commission-sequence }
-        - { id: bonus-rate, source: first-deal-bonus-bps, target: commission-rate-bps }
-        - { id: rate-product, source: commission-rate-bps, target: commission-product }
-        - { id: product-amount, source: commission-product, target: commission-amount }
+        - {
+            id: lead-guard-commission-claim,
+            source: guard-lead,
+            target: claim-commission-entitlement,
+          }
+        - {
+            id: commission-claim-guard,
+            source: claim-commission-entitlement,
+            target: guard-commission-claim,
+          }
+        - {
+            id: commission-guard-first-claim,
+            source: guard-commission-claim,
+            target: claim-first-client-deal,
+          }
+        - {
+            id: first-claim-history,
+            source: claim-first-client-deal,
+            target: prior-won-deals,
+          }
+        - {
+            id: history-condition,
+            source: prior-won-deals,
+            target: has-no-prior-won-deals,
+          }
+        - {
+            id: first-confirm-bonus,
+            source: is-first-client-deal,
+            target: first-deal-bonus-bps,
+          }
+        - {
+            id: first-history-confirm,
+            source: has-no-prior-won-deals,
+            target: is-first-client-deal,
+          }
+        - {
+            id: first-confirm-sequence,
+            source: is-first-client-deal,
+            target: commission-sequence,
+          }
+        - {
+            id: bonus-rate,
+            source: first-deal-bonus-bps,
+            target: commission-rate-bps,
+          }
+        - {
+            id: rate-product,
+            source: commission-rate-bps,
+            target: commission-product,
+          }
+        - {
+            id: product-amount,
+            source: commission-product,
+            target: commission-amount,
+          }
         - { id: amount-time, source: commission-amount, target: handoff-time }
-        - { id: time-commission, source: handoff-time, target: create-commission }
-        - { id: sequence-commission, source: commission-sequence, target: create-commission }
-        - { id: commission-link, source: create-commission, target: link-commission }
+        - {
+            id: time-commission,
+            source: handoff-time,
+            target: create-commission,
+          }
+        - {
+            id: sequence-commission,
+            source: commission-sequence,
+            target: create-commission,
+          }
+        - {
+            id: commission-link,
+            source: create-commission,
+            target: link-commission,
+          }
         - { id: link-deal, source: link-commission, target: mark-deal-won }
         - { id: deal-client, source: mark-deal-won, target: attach-client }
         - { id: client-lead, source: attach-client, target: convert-lead }

package/src/catalog.test.ts

@@ -1,11 +1,11 @@
 /**
- * Unit tests for the mergeCatalog door. Run: `npx tsx --test src/catalog.test.ts`
+ * Unit tests for the mergeCatalog door. Run: `npx vitest run packages/workspace-templates` (from the repo root).
  *
  * These test the SOURCE (`./catalog.js` → catalog.ts), never `dist/`, so no build
  * is required and there is no stale-generated-output trap.
  */
 
-import { test } from "node:test";
+import { test } from "vitest";
 import assert from "node:assert/strict";
 import { mergeCatalog, computeTemplateUpdates, type RemoteEntry } from "./catalog.js";
 import type { WorkspaceYaml } from "./types.js";

package/src/catalog.ts

@@ -58,6 +58,8 @@ export interface RemoteEntry {
   description?: string;
   /** CP package category / type (e.g. `"workspace"`, `"view"`). */
   category?: string;
+  /** Human-facing subject area for display grouping — authored on `meta.domain`. See `./domains.ts`. */
+  domain?: string;
   tags?: string[];
   icon?: string | null;
   /**
@@ -120,6 +122,8 @@ export interface CpPackageRow {
   description?: string | null;
   /** CP package category / type (e.g. `"workspace"`, `"view"`). */
   category?: string;
+  /** Human-facing subject area for display grouping — from the package's `meta.domain`. */
+  domain?: string | null;
   tags?: string[] | null;
   icon?: string | null;
   /** Present only on `/mine` rows. `false` ⇒ private. Browse rows omit it. */
@@ -146,6 +150,7 @@ export function rowToRemoteEntry(
     name: row.displayName,
     description: row.description ?? undefined,
     category: row.category,
+    domain: row.domain ?? undefined,
     tags: row.tags ?? [],
     icon: row.icon ?? null,
     isPrivate,
@@ -164,6 +169,8 @@ interface CatalogEntryBase {
   description?: string;
   /** Package category / type. Bundled templates are always `"workspace"`. */
   category?: string;
+  /** Human-facing subject area for display grouping — authored `meta.domain`. See ./domains. */
+  domain?: string;
   tags: string[];
   icon?: string | null;
   /** `true` ⇒ not publicly listed (internal bundled template, or private CP row). */
@@ -240,10 +247,12 @@ function bundledToEntry(tpl: WorkspaceYaml): BundledCatalogEntry {
     slug: tpl.meta.slug,
     name: tpl.meta.name,
     description: tpl.meta.description,
-    // Every bundled template is a full workspace — the CP calls this category
-    // "workspace" (PACKAGE_TYPES). Finer display grouping is derived from `tags`
-    // by the consumer (browser `categoryFor`), not baked in here.
+    // `category` is the PACKAGE TYPE — every bundled template is a full
+    // workspace (PACKAGE_TYPES). Human display grouping is the SEPARATE
+    // authored `domain` field (see ./domains.ts), read straight from meta —
+    // not re-derived from tags by each consumer, which is what drifted before.
     category: "workspace",
+    domain: tpl.meta.domain,
     tags: tpl.meta.tags ?? [],
     icon: tpl.meta.icon,
     isPrivate: tpl.meta.isPublic === false,
@@ -258,6 +267,7 @@ function remoteToEntry(row: RemoteEntry): RemoteCatalogEntry {
     name: row.name,
     description: row.description,
     category: row.category,
+    domain: row.domain,
     tags: row.tags ?? [],
     icon: row.icon ?? null,
     isPrivate: row.isPrivate ?? false,