@synap-core/workspace-templates 0.7.2 → 0.7.3

package/src/communication.yaml

@@ -8,6 +8,7 @@
 
 meta:
   slug: communication
+  domain: content
   name: Communication
   description: "Owns brand identity, voice, and narrative/positioning — the on-brand source of truth every downstream domain (Content, Marketing, Social) reads from so everything ships on-brand and on-message."
   icon: messages-square
@@ -15,469 +16,32 @@ meta:
   tags: [communication, brand, narrative, voice, positioning]
   isPublic: true
 
+# Compose onto Brand Library — the canonical brand SSOT owns the brand-* profiles
+# (identity, colors, fonts, assets, voice guide, rules, templates, components).
+# This overlay adds the STRATEGIC MESSAGING layer (positioning, narrative,
+# audience, differentiator) on top, so there is ONE brand vocabulary, not two.
+dependencies:
+  - slug: brand-library
+    kind: workspace
+    relation: compose
+    reason: "Layers positioning, narrative, and audience onto your Brand Library."
+
 workspace:
-  name: Communication
-  description: "Owns brand identity, voice, and narrative/positioning — the on-brand source of truth every downstream domain reads from."
-  subtype: communication
-  visibility: pod_visible
+  # Composes onto Brand Library: name + subtype MATCH the base (overlay contract),
+  # visibility OMITTED (the additive reconcile would clobber the base's).
+  name: Brand Library
+  description: "The strategic messaging layer — positioning, narrative, audience, and differentiators — layered onto your Brand Library."
+  subtype: brand-library
   capabilities:
-    - brand.library
-    - brand.identity
     - brand.voice
-    - brand.assets
-    - brand.templates
-    - brand.components
     - narrative.positioning
-  # Communication CONSUMES brand and PROVIDES narrative.
-  #
-  # `brand: provider` here was a LIVE bug, not dead metadata. brand-library.yaml
-  # also declares `brand: provider`, and the IS reads this to pick which
-  # workspace supplies brand for EVERY agent's system prompt
-  # (`resolveWorkspaceForCapability` in agents/utils/context-manager.ts): it
-  # filters candidates by the `brand.library` capability, then takes the FIRST
-  # workspace whose sourceRoles.brand is a provider. With both installed, "first"
-  # is whatever order listWorkspaces returned — an arbitrary, non-deterministic
-  # brand voice across turns. brand-library is the canonical brand source (this
-  # file's brand profiles are, by its own admission below, verbatim from it);
-  # Communication is the narrative/voice layer that reads from it.
-  #
-  # Every other domain in this template set has exactly ONE provider and names
-  # its consumers (content-studio: `brand: consumer`; marketing: `brand: consumer`).
-  # `brand` was the only domain with two. This restores that invariant.
-  #
-  # Expressed as a source ROLE, not `defaultSources.brand`, because a
-  # TemplateDefaultSource requires a concrete `workspaceId` (types.ts) that does
-  # not exist until provisioning — a template cannot know it. finance.yaml makes
-  # the same call for `strategy` and says so. `defaultSources` remains the
-  # correct RUNTIME override (`synap_declare_workspace_source`).
-  #
-  # The `brand.library` capability above is deliberately KEPT: it is what the
-  # resolver filters candidates on, and it makes this workspace a graceful
-  # fallback (step 3) when brand-library is not installed — in which case the
-  # local brand profiles below are exactly what the agent should read.
   sourceRoles:
-    brand: consumer
     narrative: provider
 
 profiles:
   # ═══════════════════════════════════════════════════════════════════════════
   # BRAND KINDS — verbatim from brand-library.yaml
   # ═══════════════════════════════════════════════════════════════════════════
-  - slug: brand-identity
-    displayName: Brand Identity
-    icon: fingerprint
-    color: amber
-    description: "Root brand context: positioning, audience, website, voice summary, and generation intent."
-    semanticSlug: brand.identity
-    properties:
-      - slug: brand-type
-        label: Brand type
-        valueType: string
-        inputType: select
-        enumValues: [product-digital, product-physical, agency, personal-brand, nonprofit, institutional, universal]
-        constraints: { defaultValue: universal }
-      - slug: brand-status
-        label: Status
-        valueType: string
-        inputType: select
-        enumValues: [draft, active, archived]
-        constraints: { defaultValue: active }
-      - slug: brand-tagline
-        label: Tagline
-        valueType: string
-        inputType: text
-      - slug: brand-website
-        label: Website
-        valueType: string
-        inputType: url
-      - slug: brand-industry
-        label: Industry
-        valueType: string
-        inputType: text
-      - slug: brand-positioning
-        label: Positioning
-        valueType: string
-        inputType: textarea
-      - slug: brand-audience-primary
-        label: Primary audience
-        valueType: string
-        inputType: textarea
-      - slug: brand-audience-secondary
-        label: Secondary audience
-        valueType: string
-        inputType: textarea
-      - slug: brand-voice-summary
-        label: Voice summary
-        valueType: string
-        inputType: textarea
-      - slug: brand-notes
-        label: Notes
-        valueType: string
-        inputType: textarea
-
-  - slug: brand-color
-    displayName: Brand Color
-    icon: swatch-book
-    color: violet
-    description: Approved palette entry with semantic role, usage notes, and print references.
-    semanticSlug: brand.color
-    properties:
-      - slug: color-role
-        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]
-        constraints: { defaultValue: custom }
-      - slug: color-group
-        label: Group
-        valueType: string
-        inputType: select
-        enumValues: [core, extended, semantic, neutral, seasonal, campaign]
-        constraints: { defaultValue: core }
-      - slug: color-hex
-        label: Hex
-        valueType: string
-        inputType: color
-      - slug: color-rgb
-        label: RGB
-        valueType: string
-        inputType: text
-      - slug: color-cmyk
-        label: CMYK
-        valueType: string
-        inputType: text
-      - slug: color-pantone
-        label: Pantone
-        valueType: string
-        inputType: text
-      - slug: color-ral
-        label: RAL
-        valueType: string
-        inputType: text
-      - slug: color-token-name
-        label: Token name
-        valueType: string
-        inputType: text
-      - slug: color-usage
-        label: Usage note
-        valueType: string
-        inputType: textarea
-      - slug: color-status
-        label: Status
-        valueType: string
-        inputType: select
-        enumValues: [draft, approved, deprecated]
-        constraints: { defaultValue: approved }
-
-  - slug: brand-font
-    displayName: Brand Typeface
-    icon: type
-    color: blue
-    description: Typeface with role, family, licensing, import URL, weights, and fallback stack.
-    semanticSlug: brand.font
-    properties:
-      - slug: font-role
-        label: Role
-        valueType: string
-        inputType: select
-        enumValues: [heading, body, display, mono, accent, ui, caption]
-        constraints: { defaultValue: body }
-      - slug: font-family
-        label: Family
-        valueType: string
-        inputType: text
-      - slug: font-foundry
-        label: Foundry
-        valueType: string
-        inputType: text
-      - slug: font-license
-        label: License
-        valueType: string
-        inputType: select
-        enumValues: [open-source, google-fonts, adobe-fonts, licensed, custom, system]
-        constraints: { defaultValue: google-fonts }
-      - slug: font-weights
-        label: Weights
-        valueType: string
-        inputType: text
-      - slug: font-fallback
-        label: Fallback stack
-        valueType: string
-        inputType: text
-      - slug: font-url
-        label: Import URL
-        valueType: string
-        inputType: url
-      - slug: font-document-id
-        label: Font document ID
-        valueType: string
-        inputType: text
-      - slug: font-status
-        label: Status
-        valueType: string
-        inputType: select
-        enumValues: [active, draft, deprecated]
-        constraints: { defaultValue: active }
-
-  - slug: brand-asset
-    displayName: Brand Asset
-    icon: image
-    color: green
-    description: "Document-backed or URL-backed reusable media: logos, imagery, icons, fonts, video, references, and documents."
-    semanticSlug: brand.asset
-    properties:
-      - slug: asset-kind
-        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]
-      - 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]
-      - slug: asset-status
-        label: Status
-        valueType: string
-        inputType: select
-        enumValues: [draft, approved, deprecated]
-        constraints: { defaultValue: approved }
-      - slug: asset-usage
-        label: Usage notes
-        valueType: string
-        inputType: textarea
-      - slug: asset-tags
-        label: Tags
-        valueType: string
-        inputType: text
-      - slug: asset-url
-        label: External URL
-        valueType: string
-        inputType: url
-      - slug: asset-document-id
-        label: Document ID
-        valueType: string
-        inputType: text
-      - slug: asset-file-id
-        label: Legacy file ID
-        valueType: string
-        inputType: text
-      - slug: asset-alt-text
-        label: Alt text
-        valueType: string
-        inputType: textarea
-
-  - slug: brand-reference
-    displayName: Brand Reference
-    icon: bookmark
-    color: teal
-    description: Website, competitor, campaign, moodboard, or example used as source context for generation.
-    semanticSlug: brand.reference
-    properties:
-      - slug: reference-kind
-        label: Kind
-        valueType: string
-        inputType: select
-        enumValues: [website, competitor, campaign, moodboard, copy-example, design-example, customer-example, other]
-      - slug: reference-url
-        label: URL
-        valueType: string
-        inputType: url
-      - slug: reference-notes
-        label: Notes
-        valueType: string
-        inputType: textarea
-      - slug: reference-status
-        label: Status
-        valueType: string
-        inputType: select
-        enumValues: [draft, approved, archived]
-        constraints: { defaultValue: approved }
-
-  - slug: brand-token-set
-    displayName: Token Set
-    icon: code-2
-    color: violet
-    description: Generated or curated design tokens for color, typography, spacing, radii, and exported CSS variables.
-    semanticSlug: brand.tokens
-    properties:
-      - slug: token-status
-        label: Status
-        valueType: string
-        inputType: select
-        enumValues: [draft, active, archived]
-        constraints: { defaultValue: active }
-      - slug: token-mode
-        label: Mode
-        valueType: string
-        inputType: select
-        enumValues: [base, light, dark, high-contrast, campaign, experimental]
-        constraints: { defaultValue: base }
-      - slug: token-source-ids
-        label: Source IDs
-        valueType: string
-        inputType: textarea
-      - slug: token-json
-        label: Tokens JSON
-        valueType: string
-        inputType: textarea
-      - slug: token-css
-        label: CSS variables
-        valueType: string
-        inputType: textarea
-      - slug: token-notes
-        label: Notes
-        valueType: string
-        inputType: textarea
-
-  - slug: brand-voice-guide
-    displayName: Voice Guide
-    icon: message-circle
-    color: orange
-    description: "Generated or curated voice guidance by context: traits, tone, vocabulary, and copy examples."
-    semanticSlug: brand.voice
-    properties:
-      - slug: voice-context
-        label: Context
-        valueType: string
-        inputType: select
-        enumValues: [general, marketing, product, support, social, legal, editorial, investor]
-        constraints: { defaultValue: general }
-      - slug: voice-status
-        label: Status
-        valueType: string
-        inputType: select
-        enumValues: [draft, approved, deprecated]
-        constraints: { defaultValue: approved }
-      - slug: voice-personality-traits
-        label: Personality
-        valueType: string
-        inputType: textarea
-      - slug: voice-tone-descriptors
-        label: Tone
-        valueType: string
-        inputType: text
-      - slug: voice-vocabulary
-        label: Vocabulary
-        valueType: string
-        inputType: textarea
-      - slug: voice-example-do
-        label: Do
-        valueType: string
-        inputType: textarea
-      - slug: voice-example-dont
-        label: Don't
-        valueType: string
-        inputType: textarea
-      - slug: voice-source-ids
-        label: Source IDs
-        valueType: string
-        inputType: textarea
-
-  - slug: brand-rule
-    displayName: Brand Rule
-    icon: shield-check
-    color: red
-    description: Usage constraints, accessibility requirements, do/don't examples, and generation guidance.
-    semanticSlug: brand.rule
-    properties:
-      - slug: rule-kind
-        label: Kind
-        valueType: string
-        inputType: select
-        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]
-      - slug: rule-severity
-        label: Severity
-        valueType: string
-        inputType: select
-        enumValues: [guideline, important, mandatory]
-        constraints: { defaultValue: important }
-      - slug: rule-content
-        label: Rule
-        valueType: string
-        inputType: textarea
-      - slug: rule-example
-        label: Example
-        valueType: string
-        inputType: textarea
-      - slug: rule-source-ids
-        label: Source IDs
-        valueType: string
-        inputType: textarea
-
-  - slug: brand-template
-    displayName: Brand Template
-    icon: layout-template
-    color: pink
-    description: Reusable output template for artboards, decks, carousels, banners, documents, or generated HTML.
-    semanticSlug: brand.template
-    properties:
-      - slug: template-kind
-        label: Kind
-        valueType: string
-        inputType: select
-        enumValues: [artboard, deck, carousel, banner, document, html, social, other]
-      - slug: template-status
-        label: Status
-        valueType: string
-        inputType: select
-        enumValues: [draft, approved, deprecated]
-        constraints: { defaultValue: approved }
-      - slug: template-format
-        label: Format
-        valueType: string
-        inputType: select
-        enumValues: [tldraw, html, json, markdown, image, mixed]
-      - slug: template-config
-        label: Config JSON
-        valueType: string
-        inputType: textarea
-      - slug: template-usage
-        label: Usage notes
-        valueType: string
-        inputType: textarea
-
-  - slug: brand-component
-    displayName: Brand Component
-    icon: component
-    color: green
-    description: "Reusable branded UI or content component: hero, CTA, card, quote, banner, section, or HTML snippet."
-    semanticSlug: brand.component
-    properties:
-      - slug: component-kind
-        label: Kind
-        valueType: string
-        inputType: select
-        enumValues: [hero, card, cta, quote, banner, section, layout, html, other]
-      - slug: component-status
-        label: Status
-        valueType: string
-        inputType: select
-        enumValues: [draft, approved, deprecated]
-        constraints: { defaultValue: approved }
-      - slug: component-html
-        label: HTML
-        valueType: string
-        inputType: textarea
-      - slug: component-props
-        label: Props JSON
-        valueType: string
-        inputType: textarea
-      - slug: component-usage
-        label: Usage notes
-        valueType: string
-        inputType: textarea
-
-  # ═══════════════════════════════════════════════════════════════════════════
-  # NARRATIVE KINDS — verbatim from foundation.yaml
-  # (Communication owns the narrative ARTIFACTS: positioning, story arc,
-  #  audiences, and differentiators — NOT mission/vision/values.)
-  # ═══════════════════════════════════════════════════════════════════════════
   - slug: positioning
     displayName: Positioning
     icon: crosshair
@@ -630,7 +194,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 and voice rules (mandatory / important / guideline).
       cardinality: several

package/src/composition-graph.test.ts

@@ -11,6 +11,7 @@ import { test } from "vitest";
 import assert from "node:assert/strict";
 import { layerTemplateGraph, type CompositionGraph } from "./composition-graph.js";
 import type { TemplateDependency } from "./types.js";
+import { readYamlTemplates } from "./generate.mjs";
 
 /** Build a small `edgesOf` from a plain adjacency map, for test fixtures. */
 function edgesFrom(map: Record<string, TemplateDependency[]>) {
@@ -120,6 +121,31 @@ test("cycle: A→B→A terminates and reports the broken edge in cycles[]", () =
   assert.equal(graph.nodes.get("A")!.layer, 0);
 });
 
+// ── Corpus invariant: the SHIPPED template graph is acyclic ───────────────────
+// `build.mjs` catches dangling deps at authoring time, but a `compose`/`require`
+// CYCLE among real templates would sink each node to layer 0 and (at install)
+// have the resolver chase its own tail. The engine already surfaces broken
+// back-edges in `cycles[]` — assert the real corpus has none, reading YAML
+// straight off disk (not the committed templates.ts) so a stale snapshot can't
+// hide a freshly-introduced loop.
+test("corpus: the shipped template dependency graph has no cycles", () => {
+  const templates = readYamlTemplates() as Array<{
+    slug: string;
+    data: { dependencies?: TemplateDependency[] };
+  }>;
+  const bySlug = new Map(templates.map((t) => [t.slug, t.data]));
+  const roots = templates.map((t) => t.slug);
+  const edgesOf = (slug: string): readonly TemplateDependency[] =>
+    bySlug.get(slug)?.dependencies ?? [];
+
+  const graph = layerTemplateGraph({ roots, edgesOf });
+  assert.deepEqual(
+    graph.cycles,
+    [],
+    `template dependency graph must be acyclic — broken back-edges: ${JSON.stringify(graph.cycles)}`,
+  );
+});
+
 // ── edgesOf injection ─────────────────────────────────────────────────────────
 test("edgesOf injection: deps supplied for a slug NOT in the bundled map are still walked", () => {
   // "private-remote-pkg" does not exist in the bundled WORKSPACE_TEMPLATES map