@synap-core/workspace-templates 0.12.0 → 0.24.0

package/src/life-os.yaml

@@ -13,6 +13,9 @@ meta:
   color: "#8B5CF6"
   tags: [pkm, second-brain, knowledge, reading, life-os, notes]
   isPublic: true
+  # A LIBRARY: it produces nothing a home counts (homes).
+  intent:
+    label: Knowledge
 
 workspace:
   name: Second Brain — Knowledge OS
@@ -145,6 +148,12 @@ profiles:
     color: "#F59E0B"
     description: Your reading library — track books, progress and insights.
     scope: WORKSPACE
+    # How it renders (entity rendering, decision 8): @synap-core/types/presentation.
+    presentation:
+      family: record
+      media:
+        source: { property: cover-url }
+        kind: image
     properties:
       - slug: title
         label: Title
@@ -213,6 +222,12 @@ profiles:
     # system row and these life-os props land as this workspace's OVERLAY.
     # (Was `scope: WORKSPACE`, which contradicted the pod-wide model.)
     entityScope: pod
+    # How it renders (entity rendering, decision 8): @synap-core/types/presentation.
+    presentation:
+      family: record
+      media:
+        source: { property: avatar-url }
+        kind: image
     properties:
       - slug: name
         label: Name
@@ -258,41 +273,6 @@ profiles:
         valueType: string
         inputType: url
 
-  - slug: project
-    displayName: Project
-    icon: FolderOpen
-    color: "#F97316"
-    description: Bounded efforts with a defined outcome and timeline.
-    scope: WORKSPACE
-    properties:
-      - slug: title
-        label: Title
-        valueType: string
-        inputType: text
-        required: true
-      - slug: status
-        label: Status
-        valueType: string
-        inputType: select
-        enumValues: [idea, planning, active, on-hold, completed, archived]
-      - slug: outcome
-        label: Outcome
-        valueType: string
-        inputType: textarea
-      - slug: due-date
-        label: Due Date
-        valueType: date
-        inputType: date
-      - slug: progress
-        label: Progress
-        valueType: number
-        inputType: number
-        constraints: { min: 0, max: 100 }
-      - slug: area
-        label: Area
-        valueType: string
-        inputType: text
-
   - slug: area
     displayName: Area
     icon: Compass
@@ -325,6 +305,11 @@ profiles:
     color: "#10B981"
     description: Web articles and blog posts worth saving and processing.
     scope: WORKSPACE
+    # How it renders (entity rendering, decision 8): @synap-core/types/presentation.
+    presentation:
+      family: link
+      media:
+        source: { property: url }
     properties:
       - slug: title
         label: Title
@@ -362,6 +347,11 @@ profiles:
     color: "#3B82F6"
     description: Quick links to valuable resources and pages.
     scope: WORKSPACE
+    # How it renders (entity rendering, decision 8): @synap-core/types/presentation.
+    presentation:
+      family: link
+      media:
+        source: { property: url }
     properties:
       - slug: title
         label: Title
@@ -392,6 +382,14 @@ profiles:
     color: "#EF4444"
     description: Raw sparks and early-stage thinking.
     scope: WORKSPACE
+    # The ONE lifecycle (work model L1): every option's category.
+    lifecycle:
+      property: status
+      options:
+        - { key: raw, category: open }
+        - { key: exploring, category: active }
+        - { key: validated, category: done }
+        - { key: shelved, category: paused }
     properties:
       - slug: title
         label: Title
@@ -416,47 +414,17 @@ profiles:
         inputType: number
         constraints: { min: 1, max: 5 }
 
-  - slug: goal
-    displayName: Goal
-    icon: Target
-    color: "#14B8A6"
-    description: Intentions with a target state and measurable progress.
-    scope: WORKSPACE
-    properties:
-      - slug: title
-        label: Title
-        valueType: string
-        inputType: text
-        required: true
-      - slug: description
-        label: Description
-        valueType: string
-        inputType: textarea
-      - slug: status
-        label: Status
-        valueType: string
-        inputType: select
-        enumValues: [active, achieved, abandoned]
-      - slug: target-date
-        label: Target Date
-        valueType: date
-        inputType: date
-      - slug: progress
-        label: Progress
-        valueType: number
-        inputType: number
-        constraints: { min: 0, max: 100 }
-      - slug: area
-        label: Area
-        valueType: string
-        inputType: text
-
   - slug: video
     displayName: Video
     icon: Video
     color: "#8B5CF6"
     description: Video content from YouTube, courses, and other platforms.
     scope: WORKSPACE
+    # How it renders (entity rendering, decision 8): @synap-core/types/presentation.
+    presentation:
+      family: link
+      media:
+        source: { property: url }
     properties:
       - slug: title
         label: Title
@@ -490,6 +458,11 @@ profiles:
     color: "#EC4899"
     description: Episodes and shows worth listening to or already consumed.
     scope: WORKSPACE
+    # How it renders (entity rendering, decision 8): @synap-core/types/presentation.
+    presentation:
+      family: link
+      media:
+        source: { property: url }
     properties:
       - slug: title
         label: Title
@@ -609,6 +582,11 @@ profiles:
     color: "#6366F1"
     description: Educational courses you're taking or have completed.
     scope: WORKSPACE
+    # How it renders (entity rendering, decision 8): @synap-core/types/presentation.
+    presentation:
+      family: link
+      media:
+        source: { property: url }
     properties:
       - slug: title
         label: Title
@@ -779,14 +757,6 @@ views:
   - name: People Network
     type: table
     scopeProfileSlug: person
-  - name: Active Projects
-    type: kanban
-    scopeProfileSlug: project
-    config:
-      groupByField: status
-  - name: All Projects
-    type: table
-    scopeProfileSlug: project
   - name: All Areas
     type: table
     scopeProfileSlug: area
@@ -809,9 +779,6 @@ views:
     scopeProfileSlug: idea
     config:
       groupByField: status
-  - name: All Goals
-    type: table
-    scopeProfileSlug: goal
   - name: Notes Dashboard
     type: bento
     scopeProfileSlug: note
@@ -1027,68 +994,6 @@ views:
           kind: view
           viewName: People Network
           pos: { x: 0, y: 4, w: 12, h: 6 }
-  - name: Projects Dashboard
-    type: bento
-    scopeProfileSlug: project
-    config:
-      blocks:
-        - id: prd-b1
-          kind: widget
-          widgetType: welcome-header
-          pos: { x: 0, y: 0, w: 12, h: 2 }
-          config: { title: Projects, subtitle: Your active initiatives }
-        - id: prd-b2
-          kind: widget
-          widgetType: entity-count
-          pos: { x: 0, y: 2, w: 3, h: 2 }
-          config:
-            {
-              profileSlug: project,
-              label: Active,
-              icon: Play,
-              filter: { status: active },
-              color: green,
-            }
-        - id: prd-b3
-          kind: widget
-          widgetType: entity-count
-          pos: { x: 3, y: 2, w: 3, h: 2 }
-          config:
-            {
-              profileSlug: project,
-              label: Planning,
-              icon: Map,
-              filter: { status: planning },
-              color: blue,
-            }
-        - id: prd-b4
-          kind: widget
-          widgetType: entity-count
-          pos: { x: 6, y: 2, w: 3, h: 2 }
-          config:
-            {
-              profileSlug: project,
-              label: On Hold,
-              icon: PauseCircle,
-              filter: { status: on-hold },
-              color: amber,
-            }
-        - id: prd-b5
-          kind: widget
-          widgetType: entity-count
-          pos: { x: 9, y: 2, w: 3, h: 2 }
-          config:
-            {
-              profileSlug: project,
-              label: Completed,
-              icon: CheckCircle,
-              filter: { status: completed },
-              color: purple,
-            }
-        - id: prd-b6
-          kind: view
-          viewName: Active Projects
-          pos: { x: 0, y: 4, w: 12, h: 6 }
   - name: Quotes Dashboard
     type: bento
     scopeProfileSlug: quote
@@ -1146,12 +1051,6 @@ views:
               icon: Compass,
               filter: { status: active },
             }
-        - id: ad-b3
-          kind: widget
-          widgetType: entity-count
-          pos: { x: 6, y: 2, w: 6, h: 2 }
-          config:
-            { profileSlug: project, label: Total Projects, icon: FolderOpen }
         - id: ad-b4
           kind: view
           viewName: All Areas
@@ -1206,10 +1105,6 @@ layout:
       profileSlug: person
       label: People
       icon: Users
-    - kind: profile
-      profileSlug: project
-      label: Projects
-      icon: FolderOpen
     - kind: profile
       profileSlug: area
       label: Areas
@@ -1232,10 +1127,6 @@ entityLinks:
     targetProfileSlug: book
     type: references
     label: References
-  - sourceProfileSlug: note
-    targetProfileSlug: project
-    type: feeds-into
-    label: Feeds into
   - sourceProfileSlug: highlight
     targetProfileSlug: book
     type: from
@@ -1252,18 +1143,6 @@ entityLinks:
     targetProfileSlug: person
     type: written-by
     label: Written by
-  - sourceProfileSlug: idea
-    targetProfileSlug: project
-    type: feeds-into
-    label: Feeds into
-  - sourceProfileSlug: project
-    targetProfileSlug: area
-    type: belongs-to
-    label: Belongs to
-  - sourceProfileSlug: goal
-    targetProfileSlug: area
-    type: in-area
-    label: In area
   - sourceProfileSlug: concept
     targetProfileSlug: concept
     type: related-to
@@ -1318,7 +1197,6 @@ bento:
           - { label: Add Book, icon: BookOpen, profileSlug: book }
           - { label: Capture Idea, icon: Zap, profileSlug: idea }
           - { label: Concepts, icon: Lightbulb, profileSlug: concept }
-          - { label: Projects, icon: FolderOpen, profileSlug: project }
           - { label: People, icon: Users, profileSlug: person }
     - kind: widget
       widgetType: calendar
@@ -1437,28 +1315,6 @@ profileEntityBentoTemplates:
         widgetType: entity-list
         pos: { x: 6, y: 3, w: 6, h: 4 }
         config: { profileSlug: article, title: Articles by, limit: 8 }
-  project:
-    blocks:
-      - id: project-eb-b1
-        kind: widget
-        widgetType: entity-spotlight
-        pos: { x: 0, y: 0, w: 8, h: 3 }
-        config: { seed: pinned, layout: detail }
-      - id: project-eb-b2
-        kind: widget
-        widgetType: entity-count
-        pos: { x: 8, y: 0, w: 4, h: 3 }
-        config: { profileSlug: idea, label: Ideas, icon: Zap }
-      - id: project-eb-b3
-        kind: widget
-        widgetType: entity-list
-        pos: { x: 0, y: 3, w: 6, h: 4 }
-        config: { profileSlug: note, title: Project Notes, limit: 8 }
-      - id: project-eb-b4
-        kind: widget
-        widgetType: entity-list
-        pos: { x: 6, y: 3, w: 6, h: 4 }
-        config: { profileSlug: idea, title: Ideas, limit: 8 }
   area:
     blocks:
       - id: area-eb-b1
@@ -1466,50 +1322,11 @@ profileEntityBentoTemplates:
         widgetType: entity-spotlight
         pos: { x: 0, y: 0, w: 8, h: 3 }
         config: { seed: pinned, layout: detail }
-      - id: area-eb-b2
-        kind: widget
-        widgetType: entity-count
-        pos: { x: 8, y: 0, w: 4, h: 3 }
-        config:
-          {
-            profileSlug: project,
-            label: Projects,
-            icon: FolderOpen,
-            color: green,
-          }
-      - id: area-eb-b3
-        kind: widget
-        widgetType: entity-list
-        pos: { x: 0, y: 3, w: 12, h: 4 }
-        config: { profileSlug: project, title: Projects, limit: 10 }
-  goal:
-    blocks:
-      - id: goal-eb-b1
-        kind: widget
-        widgetType: entity-spotlight
-        pos: { x: 0, y: 0, w: 8, h: 3 }
-        config: { seed: pinned, layout: detail }
-      - id: goal-eb-b2
-        kind: widget
-        widgetType: metrics-summary
-        pos: { x: 8, y: 0, w: 4, h: 3 }
-        config:
-          {
-            profileSlug: project,
-            property: progress,
-            aggregation: average,
-            title: Avg Project Progress,
-          }
-      - id: goal-eb-b3
-        kind: widget
-        widgetType: entity-list
-        pos: { x: 0, y: 3, w: 12, h: 4 }
-        config: { profileSlug: project, title: Related Projects, limit: 8 }
 
 # Per-workspace adaptive onboarding context (from synap-backend life-os.package.json)
 onboarding:
   goal: Capture the shape of the user's life — their areas of focus, current goals, active projects, key people, and what they're reading or learning — so the second brain starts grounded in who they actually are.
-  framing: Act as a thoughtful personal-knowledge coach. Gently tease out the domains they care about, what they're working toward, what's in motion, who matters to them, and what they're consuming. Translate that into areas, goals, projects, people, and books.
+  framing: Act as a thoughtful personal-knowledge coach. Gently tease out the domains they care about, what they're working toward, what's in motion, who matters to them, and what they're consuming. Translate that into areas, projects, people, and books. Goals are the pod's own goals (tracks), not an entity kind in this space; start each as a track (a goal) and file its notes into its project. Projects are the pod's own projects, not an entity kind; create each through the project door and file its notes into it.
   expertise:
     starters:
       - >
@@ -1550,22 +1367,16 @@ onboarding:
       a next action, and a review habit named so the system gets revisited, not just fed.
   collect:
     - profileSlug: area
+      min: 1
       what: The ongoing areas of life / responsibility they want to keep standards in
       cardinality: few
       keyFields: [title, description, standard]
-    - profileSlug: goal
-      what: The goals they're currently working toward
-      cardinality: few
-      keyFields: [title, target-date, area, progress]
-    - profileSlug: project
-      what: The active projects in motion (the concrete efforts that advance their goals)
-      cardinality: few
-      keyFields: [title, status]
     - profileSlug: person
       what: The key people in their world
       cardinality: several
       keyFields: [name, relationship, company]
     - profileSlug: book
+      min: 1
       what: What they're currently reading or learning from
       cardinality: few
       keyFields: [title, author, status]

package/src/lifecycle-coverage.test.ts

@@ -0,0 +1,124 @@
+/**
+ * Lifecycle coverage — kinds with a lifecycle should have a process that moves it.
+ *
+ * A kind with a lifecycle select (`post-status`, `deal-stage`, …) is a process
+ * waiting to be declared: the engine can bind a playbook's stages to it
+ * (`subjectProfile.statusProperty` + `stages[].subjectStatus`), but only if a
+ * playbook binds the kind at all. This file holds two guards.
+ *
+ * (1) RATCHET. Count the kinds across the WHOLE corpus that have a lifecycle and
+ *     that NO playbook binds through `subjectProfile`. It may only go DOWN:
+ *     `count <= BASELINE`. Lower BASELINE when you bind a kind; never raise it to
+ *     bank a new unbound lifecycle kind — bind it, or don't give it a lifecycle.
+ *
+ *     "Has a lifecycle" = a `select` property whose slug contains "status" or
+ *     "stage", CASE-INSENSITIVE. EXCLUDED: agent/runtime machine state, which
+ *     the system writes and no person or process moves through —
+ *     `agent_status`, `runStatus`, `lastRunStatus`, `run_status`, `job-status`
+ *     (RUNTIME_STATUS below). Kind identity is the profile slug, deduplicated
+ *     across templates (a shared kind re-declared in two templates counts once).
+ *
+ * (2) COVERAGE. For every playbook whose stages bind the lifecycle (it declares
+ *     `subjectProfile.statusProperty` AND at least one stage `subjectStatus`),
+ *     every enum value of that property must be some stage's `subjectStatus` or
+ *     listed in `humanOnlyStatuses`. A value in neither is a state the process
+ *     silently cannot reach or leave.
+ *
+ *     NOT covered: a playbook that declares `statusProperty` only to READ the
+ *     lifecycle (an activator, e.g. Content OS "Repurpose" fires on Published
+ *     and creates NEW posts) and binds no stage. It owns no status, so asking it
+ *     to cover the enum would force it to list every value as human-only.
+ *
+ * The functions + BASELINE live in scripts/catalog-lib.mjs (validateCatalog
+ * enforces them at publish). Both scans derive their set by globbing `src/*.yaml` (readYamlTemplates);
+ * nothing is hand-listed. Negative controls (run 2026-10-08): baseline 94 →
+ * red "expected 95 to be less than or equal to 94"; removing "Archived" from
+ * Produce Content's humanOnlyStatuses → red, naming `post-status = Archived`.
+ */
+
+import { describe, expect, it } from "vitest";
+import { readYamlTemplates } from "./generate.mjs";
+import type { WorkspaceYaml } from "./types.js";
+// The rule lives in the ONE catalog lib (validateCatalog runs it on every
+// publish); this file pins it against the real corpus.
+import {
+  LIFECYCLE_BASELINE as BASELINE,
+  LIFECYCLE_PATTERNS,
+  boundKinds,
+  lifecycleKinds,
+  unboundLifecycleKinds,
+  uncoveredStatuses,
+} from "../scripts/catalog-lib.mjs";
+
+const { RUNTIME_STATUS, LIFECYCLE } = LIFECYCLE_PATTERNS;
+
+const corpus = readYamlTemplates().map((t) => t.data as WorkspaceYaml);
+
+describe("lifecycle coverage — ratchet", () => {
+  it("non-vacuity: the scan sees the corpus and a literal lifecycle kind", () => {
+    expect(corpus.length).toBeGreaterThanOrEqual(25);
+    const kinds = lifecycleKinds(corpus);
+    expect(kinds.size).toBeGreaterThanOrEqual(80);
+    expect(kinds.get("post")?.has("post-status")).toBe(true);
+    // Case-insensitive: a camelCase lifecycle field is seen.
+    expect(LIFECYCLE.test("dealStage")).toBe(true);
+    // The runtime exclusion sees what it excludes, and only that.
+    for (const s of ["agent_status", "runStatus", "lastRunStatus", "run_status", "job-status"])
+      expect(RUNTIME_STATUS.test(s)).toBe(true);
+    expect(RUNTIME_STATUS.test("post-status")).toBe(false);
+    expect(boundKinds(corpus).has("post")).toBe(true);
+  });
+
+  it(`unbound lifecycle kinds never grow past the baseline (${BASELINE})`, () => {
+    const unbound = unboundLifecycleKinds(corpus);
+    expect(unbound.length, unbound.join(", ")).toBeLessThanOrEqual(BASELINE);
+  });
+});
+
+describe("lifecycle coverage — every status of a stage-bound lifecycle is owned", () => {
+  it("non-vacuity: at least two playbooks bind stages to a lifecycle", () => {
+    const binders = corpus.flatMap((t) =>
+      (t.playbooks ?? []).filter(
+        (pb) => pb.subjectProfile?.statusProperty && (pb.stages ?? []).some((s) => s.subjectStatus)
+      )
+    );
+    expect(binders.length).toBeGreaterThanOrEqual(2);
+  });
+
+  it("self-check: an un-owned status is reported", () => {
+    const clone = structuredClone(corpus);
+    const produce = clone
+      .find((t) => t.meta.slug === "content-os")!
+      .playbooks!.find((p) => p.name === "Produce Content")!;
+    produce.humanOnlyStatuses = ["Idea"];
+    expect(uncoveredStatuses(clone)).toContain("content-os › Produce Content: post-status = Archived");
+  });
+
+  it("every enum value is a stage's subjectStatus or a humanOnlyStatus", () => {
+    expect(uncoveredStatuses(corpus)).toEqual([]);
+  });
+});
+
+// ONE LIFECYCLE PER KIND OR ROLE (work model, founder rule 2026-10-11). A
+// second lifecycle select on the same kind is two truths about where the thing
+// stands (deal once carried `dealStage` AND `commercialStage`; the lead role
+// `leadStage` AND an overlay `lifecycleStage`). RATCHET on the EXCESS — the sum
+// over kinds of (lifecycle-named selects − 1) — so re-adding a second stage to a
+// kind that is already counted still turns this red. It counts by NAME, so side
+// statuses (`handoffStatus`, `commissionStatus`) are counted too: that is the
+// limit of a name scan, and why this is a ratchet, not a zero assertion.
+// Lower EXCESS_BASELINE when you fold one; never raise it.
+const EXCESS_BASELINE = 9;
+describe("one lifecycle per kind or role — ratchet", () => {
+  it(`excess lifecycle-named selects never grow past ${EXCESS_BASELINE}`, () => {
+    const kinds = lifecycleKinds(corpus);
+    const multi = [...kinds].filter(([, set]) => set.size > 1);
+    const excess = multi.reduce((n, [, set]) => n + set.size - 1, 0);
+    expect(kinds.get("deal")?.has("commercialStage")).toBe(true); // non-vacuity
+    expect(kinds.get("deal")?.has("dealStage"), "deal's retired dealStage is back").toBe(false);
+    expect(kinds.get("lead")?.has("lifecycleStage"), "lead's retired lifecycleStage is back").toBe(false);
+    expect(excess, multi.map(([k, s]) => `${k}: ${[...s].join(",")}`).join("; ")).toBeLessThanOrEqual(
+      EXCESS_BASELINE
+    );
+  });
+});