@synap-core/workspace-templates 0.9.2 → 0.9.3

package/src/templates.ts

@@ -6833,14 +6833,13 @@ const DATA = {
             "valueType": "string",
             "inputType": "select",
             "enumValues": [
-              "manual",
-              "referral",
+              "cold-outreach",
               "linkedin",
-              "email",
+              "twitter",
+              "landing-page",
+              "inbound-call",
+              "referral",
               "event",
-              "inbound",
-              "partner",
-              "import",
               "other"
             ]
           },
@@ -7210,6 +7209,37 @@ const DATA = {
             "label": "Notes",
             "valueType": "string",
             "inputType": "textarea"
+          },
+          {
+            "slug": "campaign-type",
+            "label": "Type",
+            "valueType": "string",
+            "inputType": "select",
+            "enumValues": [
+              "scoping",
+              "outreach",
+              "live",
+              "partnership",
+              "event",
+              "other"
+            ],
+            "constraints": {
+              "defaultValue": "outreach"
+            }
+          },
+          {
+            "slug": "campaign-color",
+            "label": "Color",
+            "valueType": "string",
+            "inputType": "select",
+            "enumValues": [
+              "indigo",
+              "violet",
+              "amber",
+              "cyan",
+              "pink",
+              "teal"
+            ]
           }
         ]
       }
@@ -8909,6 +8939,37 @@ const DATA = {
             "label": "Notes",
             "valueType": "string",
             "inputType": "textarea"
+          },
+          {
+            "slug": "campaign-type",
+            "label": "Type",
+            "valueType": "string",
+            "inputType": "select",
+            "enumValues": [
+              "scoping",
+              "outreach",
+              "live",
+              "partnership",
+              "event",
+              "other"
+            ],
+            "constraints": {
+              "defaultValue": "outreach"
+            }
+          },
+          {
+            "slug": "campaign-color",
+            "label": "Color",
+            "valueType": "string",
+            "inputType": "select",
+            "enumValues": [
+              "indigo",
+              "violet",
+              "amber",
+              "cyan",
+              "pink",
+              "teal"
+            ]
           }
         ]
       },
@@ -10009,6 +10070,12 @@ const DATA = {
       ],
       "isPublic": true
     },
+    "app": {
+      "kind": "url",
+      "appId": "crm",
+      "url": "https://crm.synap.live",
+      "title": "CRM"
+    },
     "dependencies": [
       {
         "slug": "foundation",
@@ -10079,7 +10146,17 @@ const DATA = {
             "slug": "source",
             "label": "Source",
             "valueType": "string",
-            "inputType": "text"
+            "inputType": "select",
+            "enumValues": [
+              "cold-outreach",
+              "linkedin",
+              "twitter",
+              "landing-page",
+              "inbound-call",
+              "referral",
+              "event",
+              "other"
+            ]
           },
           {
             "slug": "icpScore",
@@ -10168,7 +10245,17 @@ const DATA = {
             "slug": "source",
             "label": "Source",
             "valueType": "string",
-            "inputType": "text"
+            "inputType": "select",
+            "enumValues": [
+              "cold-outreach",
+              "linkedin",
+              "twitter",
+              "landing-page",
+              "inbound-call",
+              "referral",
+              "event",
+              "other"
+            ]
           },
           {
             "slug": "icpScore",
@@ -22004,6 +22091,37 @@ const DATA = {
             "label": "Notes",
             "valueType": "string",
             "inputType": "textarea"
+          },
+          {
+            "slug": "campaign-type",
+            "label": "Type",
+            "valueType": "string",
+            "inputType": "select",
+            "enumValues": [
+              "scoping",
+              "outreach",
+              "live",
+              "partnership",
+              "event",
+              "other"
+            ],
+            "constraints": {
+              "defaultValue": "outreach"
+            }
+          },
+          {
+            "slug": "campaign-color",
+            "label": "Color",
+            "valueType": "string",
+            "inputType": "select",
+            "enumValues": [
+              "indigo",
+              "violet",
+              "amber",
+              "cyan",
+              "pink",
+              "teal"
+            ]
           }
         ]
       },

package/src/types.ts

@@ -21,13 +21,76 @@ export interface TemplateAppRef {
   /** For kind='stored': the cell key registered in the cell registry */
   cellKey?: string;
   /** For kind='stored': default props passed to the cell */
-  props?: Record<string, unknown>;
+  props?: Record<string, WorkspaceJsonValue>;
   /** For kind='url': external URL to open */
   url?: string;
   /** Human label */
   title?: string;
 }
 
+// ============================================================================
+// Workspace primary surface — JSON-safe persisted subset of SurfaceDescriptor
+// ============================================================================
+
+export type WorkspaceJsonValue =
+  | string
+  | number
+  | boolean
+  | null
+  | WorkspaceJsonValue[]
+  | { [key: string]: WorkspaceJsonValue };
+
+export type WorkspacePrimarySurface =
+  | {
+      kind: 'app';
+      appId: string;
+      rendererType: 'native';
+      title?: string;
+      props?: Record<string, WorkspaceJsonValue>;
+    }
+  | {
+      kind: 'app';
+      appId: string;
+      rendererType: 'external';
+      url: string;
+      title?: string;
+      props?: Record<string, WorkspaceJsonValue>;
+    }
+  | {
+      kind: 'cell';
+      cellKey: string;
+      title?: string;
+      props?: Record<string, WorkspaceJsonValue>;
+    }
+  | {
+      kind: 'view';
+      viewId: string;
+      title?: string;
+    };
+
+/**
+ * Authoring-time view reference. View IDs do not exist until provisioning, so
+ * templates and packages address a view by its stable authored name and/or
+ * slug. The pod resolves this to `WorkspacePrimarySurface` before persistence.
+ */
+export type WorkspacePrimarySurfaceViewReference =
+  | {
+      kind: 'view';
+      viewName: string;
+      viewSlug?: string;
+      title?: string;
+    }
+  | {
+      kind: 'view';
+      viewName?: string;
+      viewSlug: string;
+      title?: string;
+    };
+
+export type TemplatePrimarySurface =
+  | WorkspacePrimarySurface
+  | WorkspacePrimarySurfaceViewReference;
+
 // ============================================================================
 // Property / Profile / View (mirrors WorkspaceProposal from onboarding)
 // ============================================================================
@@ -53,8 +116,7 @@ export interface TemplateProfile {
    * Visibility of the profile DEFINITION — who can USE this vocabulary.
    * `system` = pod-wide; `shared` = ONE row reachable from other workspaces via
    * a `profile_workspace_access` grant; omit or `workspace` = this workspace
-   * only. Orthogonal to `entityScope` below — do not conflate the two axes.
-   */
+   * only. Orthogonal to `entityScope` below — do not conflate the two axes. */
   scope?: string;
   /**
    * Placement of the profile's ENTITY ROWS — where the data LANDS.
@@ -76,7 +138,7 @@ export interface TemplateProfile {
   /** Semantic slug for system profiles. */
   semanticSlug?: string;
   /** Kind vs role profile. Omit for default ('kind'). */
-  profileKind?: "kind" | "role";
+  profileKind?: 'kind' | 'role';
   /** For profileKind='role': which base-kind profile slugs this role can attach to. */
   applicableKinds?: string[];
   properties: TemplateProperty[];
@@ -173,7 +235,14 @@ export interface TemplateSidebarItem {
 export interface TemplateLayoutConfig {
   pinnedApps?: string[];
   defaultView?: string;
-  /** The first-screen app — auto-opened on workspace switch */
+  /**
+   * Canonical first screen for this workspace.
+   *
+   * `undefined` means the template has no opinion during reconciliation,
+   * `null` explicitly returns the workspace to its home surface, and a
+   * descriptor replaces the current primary surface. */
+  primarySurface?: TemplatePrimarySurface | null;
+  /** Compatibility input only. New templates should use `app:` or `primarySurface`. */
   defaultApp?: string | null;
   theme?: string;
   sidebarItems?: TemplateSidebarItem[];

package/src/validate-flow.drift.test.ts

@@ -0,0 +1,83 @@
+/**
+ * Drift guard for the TEMPORARY flow-validator duplication.
+ *
+ * `validate-flow.ts` in this package is a pure copy of synap-backend's
+ * `packages/api/src/services/automations/validate-flow.ts` (the runtime SSOT that
+ * carries the `@synap/database` compile-time guard). The copy exists only because
+ * backend/CP consume this package over a FROZEN published npm boundary, so backend
+ * cannot yet re-export from here (see both files' headers for the cutover plan).
+ *
+ * While two copies exist, this test BINDS them: it reads BOTH files and asserts
+ * their validator LOGIC is byte-identical — modulo the backend-only bits that
+ * legitimately exist only there (the `import type ... @synap/database` line and
+ * the `AssertExact` drift-guard block) and all comments. If a future edit changes
+ * one copy and not the other, this fails and points at the cutover.
+ *
+ * It self-retires: once backend's file becomes a re-export (cutover done, no
+ * `function validateFlowDefinition` body left), the duplication is gone and the
+ * test skips. It also skips in an isolated checkout where synap-backend is absent.
+ */
+
+import { describe, expect, it } from "vitest";
+import { readFileSync, existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const OWN_COPY = join(HERE, "validate-flow.ts");
+// src → workspace-templates → packages → synap-app → <repo root>
+const BACKEND_COPY = join(
+  HERE,
+  "../../../../synap-backend/packages/api/src/services/automations/validate-flow.ts"
+);
+
+/**
+ * Reduce a validate-flow source file to just its comparable LOGIC:
+ *   - drop the backend-only `@synap/database` type import,
+ *   - drop the backend-only compile-time drift guard (`AssertExact` + the two
+ *     `_*InSync` bindings + their `void` uses),
+ *   - strip all comments (the file headers differ by design), blank lines, and
+ *     normalize whitespace.
+ */
+function normalizeFlowValidatorSource(src: string): string {
+  return src
+    .replace(/import type \{[^}]*\} from ["']@synap\/database["'];/g, "")
+    .replace(/type AssertExact<[\s\S]*?void _outputTypesInSync;/g, "")
+    .replace(/\/\*[\s\S]*?\*\//g, "") // block comments (incl. JSDoc)
+    .replace(/\/\/.*$/gm, "") // line + trailing comments
+    .split("\n")
+    .map((l) => l.replace(/\s+/g, " ").trim())
+    .filter((l) => l.length > 0)
+    .join("\n");
+}
+
+describe("validate-flow.ts — no drift between the two temporary copies", () => {
+  it("workspace-templates copy is logic-identical to synap-backend's SSOT", () => {
+    if (!existsSync(BACKEND_COPY)) {
+      // Isolated checkout (synap-backend not a sibling). Nothing to bind against.
+      console.warn(
+        `[drift] synap-backend copy not found at ${BACKEND_COPY} — skipping cross-repo drift check.`
+      );
+      return;
+    }
+
+    const backendSrc = readFileSync(BACKEND_COPY, "utf-8");
+    if (!/function validateFlowDefinition/.test(backendSrc)) {
+      // Cutover done: backend re-exports from this package, duplication resolved.
+      console.warn(
+        "[drift] synap-backend validate-flow.ts has no validateFlowDefinition body — appears to re-export (cutover complete); drift check retired."
+      );
+      return;
+    }
+
+    const own = normalizeFlowValidatorSource(readFileSync(OWN_COPY, "utf-8"));
+    const backend = normalizeFlowValidatorSource(backendSrc);
+
+    expect(
+      own,
+      "workspace-templates/src/validate-flow.ts has drifted from synap-backend's " +
+        "validate-flow.ts. Re-sync the two copies (or perform the cutover to a single " +
+        "re-export — see the file headers)."
+    ).toBe(backend);
+  });
+});