@synap-core/workspace-templates 0.2.1

package/src/foundation.yaml

@@ -0,0 +1,343 @@
+# Foundation workspace template
+# A company's STRATEGIC DNA — the outside-in layer every other workspace
+# inherits. The conceptual replacement for the old single `north_star` entity:
+# a north star is not one entity, it's this whole pack (mission, audience,
+# positioning, principles). Pod-visible provider of the `strategy` domain.
+
+meta:
+  slug: foundation
+  name: Foundation
+  description: The strategic DNA — mission, audience, positioning, and principles — that every workspace inherits.
+  icon: compass
+  color: "#4F46E5"
+  tags: [strategy, mission, positioning, audience]
+  isPublic: true
+
+workspace:
+  name: Foundation
+  description: The company's strategic DNA — mission, vision, audiences, pains, positioning, and operating principles that downstream workspaces inherit.
+  proposalId: foundation-v1
+  subtype: foundation
+  visibility: pod_visible
+  capabilities:
+    - strategy.foundation
+    - strategy.context
+  sourceRoles:
+    strategy: provider
+
+profiles:
+  - slug: mission
+    displayName: Mission
+    icon: target
+    color: indigo
+    description: "What we serve, what we change, and why now."
+    properties:
+      - slug: statement
+        label: Mission statement
+        valueType: string
+        inputType: textarea
+        constraints: { required: true }
+      - slug: time-horizon
+        label: Time horizon
+        valueType: string
+        inputType: text
+        placeholder: e.g. 3 years
+      - slug: status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, active, archived]
+        constraints: { defaultValue: active }
+
+  - slug: vision
+    displayName: Vision
+    icon: telescope
+    color: violet
+    description: "The world as it looks when we win."
+    properties:
+      - slug: statement
+        label: Vision statement
+        valueType: string
+        inputType: textarea
+      - slug: status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, active, archived]
+        constraints: { defaultValue: active }
+
+  - slug: value
+    displayName: Value
+    icon: heart-handshake
+    color: rose
+    description: "A core operating value — how we behave when it's hard."
+    properties:
+      - slug: principle
+        label: Principle
+        valueType: string
+        inputType: textarea
+      - slug: do
+        label: We do
+        valueType: string
+        inputType: textarea
+      - slug: dont
+        label: We don't
+        valueType: string
+        inputType: textarea
+
+  - slug: audience
+    displayName: Audience
+    icon: users
+    color: blue
+    description: "An ideal customer profile — who we are built for."
+    properties:
+      - slug: segment
+        label: Segment
+        valueType: string
+        inputType: text
+      - slug: persona
+        label: Persona
+        valueType: string
+        inputType: textarea
+      - slug: jobs-to-be-done
+        label: Jobs to be done
+        valueType: string
+        inputType: textarea
+      - slug: traits
+        label: Traits
+        valueType: array
+        inputType: text
+
+  - slug: pain-point
+    displayName: Pain Point
+    icon: flame
+    color: orange
+    description: "A specific pain a target audience feels today."
+    properties:
+      - slug: description
+        label: Description
+        valueType: string
+        inputType: textarea
+      - slug: severity
+        label: Severity
+        valueType: string
+        inputType: select
+        enumValues: [low, medium, high, critical]
+        constraints: { defaultValue: medium }
+      - slug: target-audience
+        label: Audience
+        valueType: entity_id
+        targetProfileSlug: audience
+        inputType: entity_select
+      - slug: evidence
+        label: Evidence
+        valueType: string
+        inputType: textarea
+
+  - slug: positioning
+    displayName: Positioning
+    icon: crosshair
+    color: cyan
+    description: "Market category, who we stand against, and why we win."
+    properties:
+      - slug: category
+        label: Category
+        valueType: string
+        inputType: text
+      - slug: against
+        label: Against
+        valueType: string
+        inputType: textarea
+      - slug: because
+        label: Because
+        valueType: string
+        inputType: textarea
+
+  - slug: narrative
+    displayName: Narrative
+    icon: book-open
+    color: amber
+    description: "The origin -> insight -> mission story arc."
+    properties:
+      - slug: arc
+        label: Story arc
+        valueType: string
+        inputType: textarea
+      - slug: status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, active, archived]
+        constraints: { defaultValue: active }
+
+  - slug: differentiator
+    displayName: Differentiator
+    icon: sparkles
+    color: green
+    description: "One thing only we do, believe, or refuse."
+    properties:
+      - slug: statement
+        label: Statement
+        valueType: string
+        inputType: textarea
+      - slug: proof
+        label: Proof
+        valueType: string
+        inputType: textarea
+
+  - slug: non-goal
+    displayName: Non-Goal
+    icon: ban
+    color: red
+    description: "Things we will deliberately NOT do."
+    properties:
+      - slug: statement
+        label: Statement
+        valueType: string
+        inputType: textarea
+      - slug: reason
+        label: Reason
+        valueType: string
+        inputType: textarea
+
+views:
+  - name: Mission & Vision
+    slug: mission-vision
+    type: table
+    scopeProfileSlugs: [mission, vision]
+    description: The mission and vision that anchor everything downstream.
+    defaultView: true
+  - name: Audiences
+    slug: audiences
+    type: table
+    scopeProfileSlug: audience
+    description: Ideal customer profiles and the jobs they hire us for.
+  - name: Pain Points
+    slug: pain-points
+    type: kanban
+    scopeProfileSlug: pain-point
+    groupBy: severity
+    config:
+      groupBy: severity
+      cardFields: [description, audience, evidence]
+    description: Pains grouped by severity.
+  - name: Positioning & Differentiators
+    slug: positioning-differentiators
+    type: table
+    scopeProfileSlug: differentiator
+    description: What only we do, and why it matters.
+  - name: Strategy Map
+    slug: strategy-map
+    type: graph
+    description: The strategic DNA as a connected graph.
+
+# Schema-level relations — give the Strategy Map and the relation picker
+# domain-specific links from day one (not just pod defaults).
+entityLinks:
+  - sourceProfileSlug: pain-point
+    targetProfileSlug: audience
+    type: affects
+    label: Affects
+  - sourceProfileSlug: positioning
+    targetProfileSlug: audience
+    type: targets
+    label: Targets
+  - sourceProfileSlug: differentiator
+    targetProfileSlug: positioning
+    type: supports
+    label: Supports
+
+onboarding:
+  goal: Capture the strategic DNA so every downstream workspace inherits a real company, not a generic template.
+  framing: >
+    THE COFOUNDER: Act as a sharp, skeptical co-founder. Pressure-test why-now, why-you, and
+    why-this. Refuse fuzzy answers; push for specifics and evidence. Be
+    respectful but direct — a vague mission helps no one.
+  collect:
+    - profileSlug: mission
+      what: The one mission that anchors the company — what we serve, what we change, why now.
+      cardinality: one
+      keyFields: [statement, time-horizon]
+    - profileSlug: audience
+      what: The ideal customer profiles the company is built for.
+      cardinality: few
+      keyFields: [segment, jobs-to-be-done]
+    - profileSlug: pain-point
+      what: Specific, evidenced pains those audiences feel today.
+      cardinality: several
+      keyFields: [description, severity]
+    - profileSlug: positioning
+      what: The market category, who we stand against, and why we win.
+      cardinality: one
+      keyFields: [category, against, because]
+    - profileSlug: differentiator
+      what: The few things only we do, believe, or refuse.
+      cardinality: few
+      keyFields: [statement, proof]
+    - profileSlug: non-goal
+      what: The things we will deliberately NOT do.
+      cardinality: few
+      keyFields: [statement, reason]
+  openingQuestions:
+    - "In one sentence — who do you serve and what do you change for them?"
+    - "Why now? What shifted in the world that makes this the moment?"
+    - "Who is this absolutely NOT for?"
+  doneWhen: mission + at least one audience + positioning captured.
+
+app:
+  kind: stored
+  cellKey: entity-detail
+
+layout:
+  defaultView: Mission & Vision
+  defaultApp: null
+  pinnedApps: [dashboard, data, intelligence]
+  sidebarItems:
+    - kind: view
+      viewName: Mission & Vision
+      label: Mission & Vision
+      icon: compass
+    - kind: view
+      viewName: Audiences
+      label: Audiences
+      icon: users
+    - kind: view
+      viewName: Pain Points
+      label: Pain Points
+      icon: flame
+    - kind: view
+      viewName: Positioning & Differentiators
+      label: Positioning
+      icon: crosshair
+    - kind: view
+      viewName: Strategy Map
+      label: Strategy Map
+      icon: share-2
+    - kind: app
+      appId: data
+      label: All Data
+      icon: database
+
+bento:
+  viewName: Foundation Command Center
+  blocks:
+    - kind: view
+      viewName: Mission & Vision
+      pos: { x: 0, y: 0, w: 8, h: 4 }
+    - kind: view
+      viewName: Positioning & Differentiators
+      pos: { x: 8, y: 0, w: 4, h: 4 }
+    - kind: view
+      viewName: Audiences
+      pos: { x: 0, y: 4, w: 6, h: 4 }
+    - kind: view
+      viewName: Pain Points
+      pos: { x: 6, y: 4, w: 6, h: 4 }
+
+seedEntities:
+  - profileSlug: mission
+    title: Example Mission
+    properties:
+      statement: "Example — replace this: we help [audience] [change] so they can [outcome], starting now because [why now]."
+      time-horizon: 3 years
+      status: active

package/src/index.ts

@@ -0,0 +1,62 @@
+/**
+ * @synap-core/workspace-templates
+ *
+ * Canonical workspace template definitions.
+ * ==========================================
+ *
+ * Usage (browser / backend / CLI):
+ *
+ *   import { getWorkspaceTemplate, listPublicTemplates } from '@synap-core/workspace-templates';
+ *
+ *   const template = getWorkspaceTemplate('brand-library');
+ *   // template.workspace.name === 'Brand Library'
+ *   // template.app.kind === 'native'
+ *   // template.layout.defaultApp === 'brandLibrary'
+ *
+ * YAML source files live in src/*.yaml — AI-friendly, commentable, mergeable.
+ * Run `pnpm build` to regenerate src/templates.ts from YAML.
+ */
+
+export type {
+  WorkspaceYaml,
+  TemplateMeta,
+  TemplateAppRef,
+  TemplateAppKind,
+  TemplateProfile,
+  TemplateProperty,
+  TemplateView,
+  TemplateSidebarItem,
+  TemplateSidebarSurface,
+  TemplateLayoutConfig,
+  TemplateBentoBlock,
+  TemplateEntityLink,
+  TemplateSeedEntity,
+  TemplateSuggestedRelation,
+  TemplateDisplayTemplate,
+  TemplateIntegration,
+  TemplateAutomation,
+  TemplateExtendsRef,
+  TemplateProfileEntityBentoTemplates,
+  TemplateDefaultSource,
+  TemplateSourceRole,
+  TemplateOnboarding,
+  TemplateOnboardingCollectTarget,
+  TemplatePlaybook,
+  TemplatePlaybookParam,
+} from './types.js';
+
+export {
+  WORKSPACE_TEMPLATES,
+  getWorkspaceTemplate,
+  listWorkspaceTemplates,
+  listPublicTemplates,
+} from './templates.js';
+
+export type { WorkspaceTemplateSlug } from './templates.js';
+
+export { toWorkspaceDefinition, toPackageDefinition } from './define.js';
+export type {
+  WorkspaceDefinitionInput,
+  ToDefinitionResult,
+  PackageDefinitionOutput,
+} from './define.js';