@contractspec/example.team-hub 1.44.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# @contractspec/example.team-hub
+
+Website: https://contractspec.io/
+
+
+Team Hub reference example with spaces/projects, tasks, rituals, and announcements for internal teams.
+
+Highlights:
+
+- Spaces/projects with members and roles
+- Tasks with status, priority, assignees, and due dates
+- Rituals (recurring meetings/check-ins) with schedules and attendance
+- Announcements with audience targeting
+- Notifications for rituals/reminders and task assignments
+- Jobs hooks for recurring ritual creation

package/dist/announcement/announcement.operations.d.ts

@@ -0,0 +1,61 @@
+import * as _contractspec_lib_schema107 from "@contractspec/lib.schema";
+import * as _contractspec_lib_contracts11 from "@contractspec/lib.contracts";
+
+//#region src/announcement/announcement.operations.d.ts
+/**
+ * Post an announcement.
+ */
+declare const PostAnnouncementContract: _contractspec_lib_contracts11.OperationSpec<_contractspec_lib_schema107.SchemaModel<{
+  title: {
+    type: _contractspec_lib_schema107.FieldType<string, string>;
+    isOptional: false;
+  };
+  body: {
+    type: _contractspec_lib_schema107.FieldType<string, string>;
+    isOptional: false;
+  };
+  audience: {
+    type: _contractspec_lib_schema107.FieldType<string, string>;
+    isOptional: false;
+  };
+  audienceRole: {
+    type: _contractspec_lib_schema107.FieldType<string, string>;
+    isOptional: true;
+  };
+  spaceId: {
+    type: _contractspec_lib_schema107.FieldType<string, string>;
+    isOptional: true;
+  };
+  expiresAt: {
+    type: _contractspec_lib_schema107.FieldType<Date, string>;
+    isOptional: true;
+  };
+}>, _contractspec_lib_schema107.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema107.FieldType<string, string>;
+    isOptional: false;
+  };
+  title: {
+    type: _contractspec_lib_schema107.FieldType<string, string>;
+    isOptional: false;
+  };
+  body: {
+    type: _contractspec_lib_schema107.FieldType<string, string>;
+    isOptional: false;
+  };
+  audience: {
+    type: _contractspec_lib_schema107.FieldType<string, string>;
+    isOptional: false;
+  };
+  audienceRole: {
+    type: _contractspec_lib_schema107.FieldType<string, string>;
+    isOptional: true;
+  };
+  spaceId: {
+    type: _contractspec_lib_schema107.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, undefined>;
+//#endregion
+export { PostAnnouncementContract };
+//# sourceMappingURL=announcement.operations.d.ts.map

package/dist/announcement/announcement.operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"announcement.operations.d.ts","names":[],"sources":["../../src/announcement/announcement.operations.ts"],"sourcesContent":[],"mappings":";;;;;;;cAWa,wDAAwB,0CAAA;EAAxB,KAAA,EAAA;IAqCX,IAAA,EAAA,2BAAA,CAAA,SAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;IArCmC,IAAA,uCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;IAAA,IAAA,uCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;UAAA,2BAAA,CAAA"}

package/dist/announcement/announcement.operations.js

@@ -0,0 +1,53 @@
+import { AnnouncementModel, PostAnnouncementInputModel } from "./announcement.schema.js";
+import { defineCommand } from "@contractspec/lib.contracts";
+
+//#region src/announcement/announcement.operations.ts
+const OWNERS = ["@examples.team-hub"];
+/**
+* Post an announcement.
+*/
+const PostAnnouncementContract = defineCommand({
+	meta: {
+		key: "team.announcement.post",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"team-hub",
+			"announcement",
+			"post"
+		],
+		description: "Post an announcement.",
+		goal: "Communicate with team.",
+		context: "Communication."
+	},
+	io: {
+		input: PostAnnouncementInputModel,
+		output: AnnouncementModel
+	},
+	policy: { auth: "user" },
+	acceptance: {
+		scenarios: [{
+			key: "post-announcement-happy-path",
+			given: ["User is authenticated"],
+			when: ["User posts an announcement"],
+			then: ["Announcement is posted and distributed"]
+		}],
+		examples: [{
+			key: "post-general",
+			input: {
+				spaceId: "space-123",
+				title: "New Policy",
+				content: "Please read..."
+			},
+			output: {
+				id: "ann-456",
+				status: "posted"
+			}
+		}]
+	}
+});
+
+//#endregion
+export { PostAnnouncementContract };
+//# sourceMappingURL=announcement.operations.js.map

package/dist/announcement/announcement.operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"announcement.operations.js","names":[],"sources":["../../src/announcement/announcement.operations.ts"],"sourcesContent":["import { defineCommand } from '@contractspec/lib.contracts';\nimport {\n  AnnouncementModel,\n  PostAnnouncementInputModel,\n} from './announcement.schema';\n\nconst OWNERS = ['@examples.team-hub'] as const;\n\n/**\n * Post an announcement.\n */\nexport const PostAnnouncementContract = defineCommand({\n  meta: {\n    key: 'team.announcement.post',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['team-hub', 'announcement', 'post'],\n    description: 'Post an announcement.',\n    goal: 'Communicate with team.',\n    context: 'Communication.',\n  },\n  io: {\n    input: PostAnnouncementInputModel,\n    output: AnnouncementModel,\n  },\n  policy: { auth: 'user' },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'post-announcement-happy-path',\n        given: ['User is authenticated'],\n        when: ['User posts an announcement'],\n        then: ['Announcement is posted and distributed'],\n      },\n    ],\n    examples: [\n      {\n        key: 'post-general',\n        input: {\n          spaceId: 'space-123',\n          title: 'New Policy',\n          content: 'Please read...',\n        },\n        output: { id: 'ann-456', status: 'posted' },\n      },\n    ],\n  },\n});\n"],"mappings":";;;;AAMA,MAAM,SAAS,CAAC,qBAAqB;;;;AAKrC,MAAa,2BAA2B,cAAc;CACpD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM;GAAC;GAAY;GAAgB;GAAO;EAC1C,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACT;CACD,QAAQ,EAAE,MAAM,QAAQ;CACxB,YAAY;EACV,WAAW,CACT;GACE,KAAK;GACL,OAAO,CAAC,wBAAwB;GAChC,MAAM,CAAC,6BAA6B;GACpC,MAAM,CAAC,yCAAyC;GACjD,CACF;EACD,UAAU,CACR;GACE,KAAK;GACL,OAAO;IACL,SAAS;IACT,OAAO;IACP,SAAS;IACV;GACD,QAAQ;IAAE,IAAI;IAAW,QAAQ;IAAU;GAC5C,CACF;EACF;CACF,CAAC"}

package/dist/announcement/announcement.schema.d.ts

@@ -0,0 +1,64 @@
+import * as _contractspec_lib_schema93 from "@contractspec/lib.schema";
+
+//#region src/announcement/announcement.schema.d.ts
+/**
+ * Announcement to spaces/org.
+ */
+declare const AnnouncementModel: _contractspec_lib_schema93.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema93.FieldType<string, string>;
+    isOptional: false;
+  };
+  title: {
+    type: _contractspec_lib_schema93.FieldType<string, string>;
+    isOptional: false;
+  };
+  body: {
+    type: _contractspec_lib_schema93.FieldType<string, string>;
+    isOptional: false;
+  };
+  audience: {
+    type: _contractspec_lib_schema93.FieldType<string, string>;
+    isOptional: false;
+  };
+  audienceRole: {
+    type: _contractspec_lib_schema93.FieldType<string, string>;
+    isOptional: true;
+  };
+  spaceId: {
+    type: _contractspec_lib_schema93.FieldType<string, string>;
+    isOptional: true;
+  };
+}>;
+/**
+ * Input for posting an announcement.
+ */
+declare const PostAnnouncementInputModel: _contractspec_lib_schema93.SchemaModel<{
+  title: {
+    type: _contractspec_lib_schema93.FieldType<string, string>;
+    isOptional: false;
+  };
+  body: {
+    type: _contractspec_lib_schema93.FieldType<string, string>;
+    isOptional: false;
+  };
+  audience: {
+    type: _contractspec_lib_schema93.FieldType<string, string>;
+    isOptional: false;
+  };
+  audienceRole: {
+    type: _contractspec_lib_schema93.FieldType<string, string>;
+    isOptional: true;
+  };
+  spaceId: {
+    type: _contractspec_lib_schema93.FieldType<string, string>;
+    isOptional: true;
+  };
+  expiresAt: {
+    type: _contractspec_lib_schema93.FieldType<Date, string>;
+    isOptional: true;
+  };
+}>;
+//#endregion
+export { AnnouncementModel, PostAnnouncementInputModel };
+//# sourceMappingURL=announcement.schema.d.ts.map

package/dist/announcement/announcement.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"announcement.schema.d.ts","names":[],"sources":["../../src/announcement/announcement.schema.ts"],"sourcesContent":[],"mappings":";;;;;;AAKa,cAAA,iBAWX,6BAX4B,WAW5B,CAAA;EAAA,EAAA,EAAA;UAAA,0BAAA,CAAA;;;;;;EAX4B,CAAA;EAgBjB,IAAA,EAAA;IAWX,IAAA,sCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;IAXqC,IAAA,sCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;cAA1B,uDAA0B;;UAWrC,0BAAA,CAAA"}

package/dist/announcement/announcement.schema.js

@@ -0,0 +1,73 @@
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+
+//#region src/announcement/announcement.schema.ts
+/**
+* Announcement to spaces/org.
+*/
+const AnnouncementModel = defineSchemaModel({
+	name: "Announcement",
+	description: "Announcement to spaces/org",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		title: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		body: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		audience: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		audienceRole: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		spaceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+/**
+* Input for posting an announcement.
+*/
+const PostAnnouncementInputModel = defineSchemaModel({
+	name: "PostAnnouncementInput",
+	description: "Post an announcement",
+	fields: {
+		title: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		body: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		audience: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		audienceRole: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		spaceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		expiresAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		}
+	}
+});
+
+//#endregion
+export { AnnouncementModel, PostAnnouncementInputModel };
+//# sourceMappingURL=announcement.schema.js.map

package/dist/announcement/announcement.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"announcement.schema.js","names":[],"sources":["../../src/announcement/announcement.schema.ts"],"sourcesContent":["import { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\n\n/**\n * Announcement to spaces/org.\n */\nexport const AnnouncementModel = defineSchemaModel({\n  name: 'Announcement',\n  description: 'Announcement to spaces/org',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    body: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    audience: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    audienceRole: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    spaceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\n/**\n * Input for posting an announcement.\n */\nexport const PostAnnouncementInputModel = defineSchemaModel({\n  name: 'PostAnnouncementInput',\n  description: 'Post an announcement',\n  fields: {\n    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    body: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    audience: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    audienceRole: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    spaceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    expiresAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n  },\n});\n"],"mappings":";;;;;;AAKA,MAAa,oBAAoB,kBAAkB;CACjD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,IAAI;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACjE,OAAO;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACpE,MAAM;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACnE,UAAU;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACvE,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EAC1E,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EACtE;CACF,CAAC;;;;AAKF,MAAa,6BAA6B,kBAAkB;CAC1D,MAAM;CACN,aAAa;CACb,QAAQ;EACN,OAAO;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACpE,MAAM;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACnE,UAAU;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACvE,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EAC1E,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EACrE,WAAW;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAM;EACjE;CACF,CAAC"}

package/dist/announcement/index.d.ts

@@ -0,0 +1,3 @@
+import { PostAnnouncementContract } from "./announcement.operations.js";
+import { AnnouncementModel, PostAnnouncementInputModel } from "./announcement.schema.js";
+export { AnnouncementModel, PostAnnouncementContract, PostAnnouncementInputModel };

package/dist/announcement/index.js

@@ -0,0 +1,4 @@
+import { AnnouncementModel, PostAnnouncementInputModel } from "./announcement.schema.js";
+import { PostAnnouncementContract } from "./announcement.operations.js";
+
+export { AnnouncementModel, PostAnnouncementContract, PostAnnouncementInputModel };

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./team-hub.docblock.js";

package/dist/docs/team-hub.docblock.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/team-hub.docblock.js

@@ -0,0 +1,106 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/team-hub.docblock.ts
+registerDocBlocks([
+	{
+		id: "docs.examples.team-hub",
+		title: "Team Hub",
+		summary: "Internal collaboration hub with spaces, tasks, rituals, and announcements.",
+		kind: "reference",
+		visibility: "public",
+		route: "/docs/examples/team-hub",
+		tags: [
+			"tasks",
+			"rituals",
+			"announcements",
+			"collaboration"
+		],
+		body: `## Domains
+
+- Spaces/projects with members and roles.
+- Tasks with status, priority, assignees, due dates.
+- Rituals (standups/retros/planning) with cadence and attendance.
+- Announcements targeted by space or role.
+
+## Modules reused
+- Identity/RBAC for roles and membership
+- Notifications for reminders and announcements
+- Jobs for scheduling rituals/reminders
+- Audit trail for state changes
+
+## Presentations
+- Dashboard, space list, task board/detail, ritual calendar, announcement feed.
+`
+	},
+	{
+		id: "docs.examples.team-hub.goal",
+		title: "Team Hub — Goal",
+		summary: "Why this collaboration hub exists and outcomes it targets.",
+		kind: "goal",
+		visibility: "public",
+		route: "/docs/examples/team-hub/goal",
+		tags: ["collaboration", "goal"],
+		body: `## Why it matters
+- Provides a regenerable hub for spaces, tasks, rituals, and announcements.
+- Keeps ceremonies and task flows consistent across UI/API/events.
+
+## Business/Product goal
+- Support team rituals with reminders, visibility, and auditability.
+- Enable staged rollouts of new rituals/boards via feature flags.
+
+## Success criteria
+- Tasks/rituals/announcements regenerate safely from spec updates.
+- Notifications and audit hooks fire for key transitions.`
+	},
+	{
+		id: "docs.examples.team-hub.usage",
+		title: "Team Hub — Usage",
+		summary: "How to set up spaces, tasks, and rituals and regenerate safely.",
+		kind: "usage",
+		visibility: "public",
+		route: "/docs/examples/team-hub/usage",
+		tags: ["collaboration", "usage"],
+		body: `## Setup
+1) Seed (if available) or create a space; add members and tasks; schedule rituals.
+2) Configure Notifications for rituals/reminders and announcements; use Jobs for scheduling.
+
+## Extend & regenerate
+1) Adjust schemas: task priority/status, ritual cadence/attendance, announcement targeting.
+2) Regenerate to update boards/calendars/feeds; mark PII paths as needed.
+3) Use Feature Flags to trial new rituals or task views.
+
+## Guardrails
+- Emit events for task/ritual/announcement changes; log in Audit Trail.
+- Keep ritual cadence declarative; avoid hardcoded schedules.
+- Ensure announcements carry title/description for accessibility.`
+	},
+	{
+		id: "docs.examples.team-hub.constraints",
+		title: "Team Hub — Constraints & Safety",
+		summary: "Internal guardrails for rituals, tasks, and announcements regeneration.",
+		kind: "reference",
+		visibility: "internal",
+		route: "/docs/examples/team-hub/constraints",
+		tags: [
+			"collaboration",
+			"constraints",
+			"internal"
+		],
+		body: `## Constraints
+- Ritual cadence and task states must stay declarative in spec; no hardcoded schedules.
+- Events to emit: task.created/updated/completed, ritual.scheduled/completed, announcement.published.
+- Regeneration should not drop reminders or announcements routing.
+
+## PII & A11y
+- Mark PII (names/emails) for redaction in presentations.
+- Announcements must include title/description; respect accessibility guidance.
+
+## Verification
+- Add fixtures for ritual cadence changes and announcement targeting.
+- Ensure Notifications/Jobs wiring persists after regeneration.
+- Use Feature Flags to trial new boards/rituals with safe defaults.`
+	}
+]);
+
+//#endregion
+//# sourceMappingURL=team-hub.docblock.js.map

package/dist/docs/team-hub.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-hub.docblock.js","names":[],"sources":["../../src/docs/team-hub.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst teamHubDocBlocks: DocBlock[] = [\n  {\n    id: 'docs.examples.team-hub',\n    title: 'Team Hub',\n    summary:\n      'Internal collaboration hub with spaces, tasks, rituals, and announcements.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/team-hub',\n    tags: ['tasks', 'rituals', 'announcements', 'collaboration'],\n    body: `## Domains\n\n- Spaces/projects with members and roles.\n- Tasks with status, priority, assignees, due dates.\n- Rituals (standups/retros/planning) with cadence and attendance.\n- Announcements targeted by space or role.\n\n## Modules reused\n- Identity/RBAC for roles and membership\n- Notifications for reminders and announcements\n- Jobs for scheduling rituals/reminders\n- Audit trail for state changes\n\n## Presentations\n- Dashboard, space list, task board/detail, ritual calendar, announcement feed.\n`,\n  },\n  {\n    id: 'docs.examples.team-hub.goal',\n    title: 'Team Hub — Goal',\n    summary: 'Why this collaboration hub exists and outcomes it targets.',\n    kind: 'goal',\n    visibility: 'public',\n    route: '/docs/examples/team-hub/goal',\n    tags: ['collaboration', 'goal'],\n    body: `## Why it matters\n- Provides a regenerable hub for spaces, tasks, rituals, and announcements.\n- Keeps ceremonies and task flows consistent across UI/API/events.\n\n## Business/Product goal\n- Support team rituals with reminders, visibility, and auditability.\n- Enable staged rollouts of new rituals/boards via feature flags.\n\n## Success criteria\n- Tasks/rituals/announcements regenerate safely from spec updates.\n- Notifications and audit hooks fire for key transitions.`,\n  },\n  {\n    id: 'docs.examples.team-hub.usage',\n    title: 'Team Hub — Usage',\n    summary: 'How to set up spaces, tasks, and rituals and regenerate safely.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/team-hub/usage',\n    tags: ['collaboration', 'usage'],\n    body: `## Setup\n1) Seed (if available) or create a space; add members and tasks; schedule rituals.\n2) Configure Notifications for rituals/reminders and announcements; use Jobs for scheduling.\n\n## Extend & regenerate\n1) Adjust schemas: task priority/status, ritual cadence/attendance, announcement targeting.\n2) Regenerate to update boards/calendars/feeds; mark PII paths as needed.\n3) Use Feature Flags to trial new rituals or task views.\n\n## Guardrails\n- Emit events for task/ritual/announcement changes; log in Audit Trail.\n- Keep ritual cadence declarative; avoid hardcoded schedules.\n- Ensure announcements carry title/description for accessibility.`,\n  },\n  {\n    id: 'docs.examples.team-hub.constraints',\n    title: 'Team Hub — Constraints & Safety',\n    summary:\n      'Internal guardrails for rituals, tasks, and announcements regeneration.',\n    kind: 'reference',\n    visibility: 'internal',\n    route: '/docs/examples/team-hub/constraints',\n    tags: ['collaboration', 'constraints', 'internal'],\n    body: `## Constraints\n- Ritual cadence and task states must stay declarative in spec; no hardcoded schedules.\n- Events to emit: task.created/updated/completed, ritual.scheduled/completed, announcement.published.\n- Regeneration should not drop reminders or announcements routing.\n\n## PII & A11y\n- Mark PII (names/emails) for redaction in presentations.\n- Announcements must include title/description; respect accessibility guidance.\n\n## Verification\n- Add fixtures for ritual cadence changes and announcement targeting.\n- Ensure Notifications/Jobs wiring persists after regeneration.\n- Use Feature Flags to trial new boards/rituals with safe defaults.`,\n  },\n];\n\nregisterDocBlocks(teamHubDocBlocks);\n"],"mappings":";;;AAiGA,kBA9FqC;CACnC;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAS;GAAW;GAAiB;GAAgB;EAC5D,MAAM;;;;;;;;;;;;;;;;EAgBP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,iBAAiB,OAAO;EAC/B,MAAM;;;;;;;;;;;EAWP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,iBAAiB,QAAQ;EAChC,MAAM;;;;;;;;;;;;;EAaP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAiB;GAAe;GAAW;EAClD,MAAM;;;;;;;;;;;;;EAaP;CACF,CAEkC"}

package/dist/entities/index.d.ts

@@ -0,0 +1,150 @@
+import * as _contractspec_lib_schema121 from "@contractspec/lib.schema";
+import { ModuleSchemaContribution } from "@contractspec/lib.schema";
+
+//#region src/entities/index.d.ts
+declare const TaskStatusEnum: _contractspec_lib_schema121.EntityEnumDef;
+declare const TaskPriorityEnum: _contractspec_lib_schema121.EntityEnumDef;
+declare const RitualCadenceEnum: _contractspec_lib_schema121.EntityEnumDef;
+declare const AnnouncementAudienceEnum: _contractspec_lib_schema121.EntityEnumDef;
+declare const SpaceEntity: _contractspec_lib_schema121.EntitySpec<{
+  id: _contractspec_lib_schema121.EntityScalarField;
+  name: _contractspec_lib_schema121.EntityScalarField;
+  description: _contractspec_lib_schema121.EntityScalarField;
+  orgId: _contractspec_lib_schema121.EntityScalarField;
+  ownerId: _contractspec_lib_schema121.EntityScalarField;
+  members: _contractspec_lib_schema121.EntityScalarField;
+  createdAt: _contractspec_lib_schema121.EntityScalarField;
+  updatedAt: _contractspec_lib_schema121.EntityScalarField;
+  tasks: _contractspec_lib_schema121.EntityRelationField;
+  rituals: _contractspec_lib_schema121.EntityRelationField;
+  announcements: _contractspec_lib_schema121.EntityRelationField;
+}>;
+declare const TaskEntity: _contractspec_lib_schema121.EntitySpec<{
+  id: _contractspec_lib_schema121.EntityScalarField;
+  spaceId: _contractspec_lib_schema121.EntityScalarField;
+  title: _contractspec_lib_schema121.EntityScalarField;
+  description: _contractspec_lib_schema121.EntityScalarField;
+  status: _contractspec_lib_schema121.EntityEnumField;
+  priority: _contractspec_lib_schema121.EntityEnumField;
+  assigneeId: _contractspec_lib_schema121.EntityScalarField;
+  dueDate: _contractspec_lib_schema121.EntityScalarField;
+  tags: _contractspec_lib_schema121.EntityScalarField;
+  orgId: _contractspec_lib_schema121.EntityScalarField;
+  createdAt: _contractspec_lib_schema121.EntityScalarField;
+  updatedAt: _contractspec_lib_schema121.EntityScalarField;
+  space: _contractspec_lib_schema121.EntityRelationField;
+}>;
+declare const RitualEntity: _contractspec_lib_schema121.EntitySpec<{
+  id: _contractspec_lib_schema121.EntityScalarField;
+  spaceId: _contractspec_lib_schema121.EntityScalarField;
+  title: _contractspec_lib_schema121.EntityScalarField;
+  cadence: _contractspec_lib_schema121.EntityEnumField;
+  dayOfWeek: _contractspec_lib_schema121.EntityScalarField;
+  time: _contractspec_lib_schema121.EntityScalarField;
+  facilitatorId: _contractspec_lib_schema121.EntityScalarField;
+  participants: _contractspec_lib_schema121.EntityScalarField;
+  location: _contractspec_lib_schema121.EntityScalarField;
+  agendaTemplate: _contractspec_lib_schema121.EntityScalarField;
+  orgId: _contractspec_lib_schema121.EntityScalarField;
+  createdAt: _contractspec_lib_schema121.EntityScalarField;
+  updatedAt: _contractspec_lib_schema121.EntityScalarField;
+  occurrences: _contractspec_lib_schema121.EntityRelationField;
+  space: _contractspec_lib_schema121.EntityRelationField;
+}>;
+declare const RitualOccurrenceEntity: _contractspec_lib_schema121.EntitySpec<{
+  id: _contractspec_lib_schema121.EntityScalarField;
+  ritualId: _contractspec_lib_schema121.EntityScalarField;
+  scheduledFor: _contractspec_lib_schema121.EntityScalarField;
+  status: _contractspec_lib_schema121.EntityScalarField;
+  summary: _contractspec_lib_schema121.EntityScalarField;
+  attendance: _contractspec_lib_schema121.EntityScalarField;
+  recordingUrl: _contractspec_lib_schema121.EntityScalarField;
+  orgId: _contractspec_lib_schema121.EntityScalarField;
+  createdAt: _contractspec_lib_schema121.EntityScalarField;
+  updatedAt: _contractspec_lib_schema121.EntityScalarField;
+  ritual: _contractspec_lib_schema121.EntityRelationField;
+}>;
+declare const AnnouncementEntity: _contractspec_lib_schema121.EntitySpec<{
+  id: _contractspec_lib_schema121.EntityScalarField;
+  spaceId: _contractspec_lib_schema121.EntityScalarField;
+  title: _contractspec_lib_schema121.EntityScalarField;
+  body: _contractspec_lib_schema121.EntityScalarField;
+  audience: _contractspec_lib_schema121.EntityEnumField;
+  audienceRole: _contractspec_lib_schema121.EntityScalarField;
+  pinnedUntil: _contractspec_lib_schema121.EntityScalarField;
+  orgId: _contractspec_lib_schema121.EntityScalarField;
+  createdBy: _contractspec_lib_schema121.EntityScalarField;
+  createdAt: _contractspec_lib_schema121.EntityScalarField;
+  expiresAt: _contractspec_lib_schema121.EntityScalarField;
+}>;
+declare const teamHubEntities: (_contractspec_lib_schema121.EntitySpec<{
+  id: _contractspec_lib_schema121.EntityScalarField;
+  name: _contractspec_lib_schema121.EntityScalarField;
+  description: _contractspec_lib_schema121.EntityScalarField;
+  orgId: _contractspec_lib_schema121.EntityScalarField;
+  ownerId: _contractspec_lib_schema121.EntityScalarField;
+  members: _contractspec_lib_schema121.EntityScalarField;
+  createdAt: _contractspec_lib_schema121.EntityScalarField;
+  updatedAt: _contractspec_lib_schema121.EntityScalarField;
+  tasks: _contractspec_lib_schema121.EntityRelationField;
+  rituals: _contractspec_lib_schema121.EntityRelationField;
+  announcements: _contractspec_lib_schema121.EntityRelationField;
+}> | _contractspec_lib_schema121.EntitySpec<{
+  id: _contractspec_lib_schema121.EntityScalarField;
+  spaceId: _contractspec_lib_schema121.EntityScalarField;
+  title: _contractspec_lib_schema121.EntityScalarField;
+  description: _contractspec_lib_schema121.EntityScalarField;
+  status: _contractspec_lib_schema121.EntityEnumField;
+  priority: _contractspec_lib_schema121.EntityEnumField;
+  assigneeId: _contractspec_lib_schema121.EntityScalarField;
+  dueDate: _contractspec_lib_schema121.EntityScalarField;
+  tags: _contractspec_lib_schema121.EntityScalarField;
+  orgId: _contractspec_lib_schema121.EntityScalarField;
+  createdAt: _contractspec_lib_schema121.EntityScalarField;
+  updatedAt: _contractspec_lib_schema121.EntityScalarField;
+  space: _contractspec_lib_schema121.EntityRelationField;
+}> | _contractspec_lib_schema121.EntitySpec<{
+  id: _contractspec_lib_schema121.EntityScalarField;
+  spaceId: _contractspec_lib_schema121.EntityScalarField;
+  title: _contractspec_lib_schema121.EntityScalarField;
+  cadence: _contractspec_lib_schema121.EntityEnumField;
+  dayOfWeek: _contractspec_lib_schema121.EntityScalarField;
+  time: _contractspec_lib_schema121.EntityScalarField;
+  facilitatorId: _contractspec_lib_schema121.EntityScalarField;
+  participants: _contractspec_lib_schema121.EntityScalarField;
+  location: _contractspec_lib_schema121.EntityScalarField;
+  agendaTemplate: _contractspec_lib_schema121.EntityScalarField;
+  orgId: _contractspec_lib_schema121.EntityScalarField;
+  createdAt: _contractspec_lib_schema121.EntityScalarField;
+  updatedAt: _contractspec_lib_schema121.EntityScalarField;
+  occurrences: _contractspec_lib_schema121.EntityRelationField;
+  space: _contractspec_lib_schema121.EntityRelationField;
+}> | _contractspec_lib_schema121.EntitySpec<{
+  id: _contractspec_lib_schema121.EntityScalarField;
+  ritualId: _contractspec_lib_schema121.EntityScalarField;
+  scheduledFor: _contractspec_lib_schema121.EntityScalarField;
+  status: _contractspec_lib_schema121.EntityScalarField;
+  summary: _contractspec_lib_schema121.EntityScalarField;
+  attendance: _contractspec_lib_schema121.EntityScalarField;
+  recordingUrl: _contractspec_lib_schema121.EntityScalarField;
+  orgId: _contractspec_lib_schema121.EntityScalarField;
+  createdAt: _contractspec_lib_schema121.EntityScalarField;
+  updatedAt: _contractspec_lib_schema121.EntityScalarField;
+  ritual: _contractspec_lib_schema121.EntityRelationField;
+}> | _contractspec_lib_schema121.EntitySpec<{
+  id: _contractspec_lib_schema121.EntityScalarField;
+  spaceId: _contractspec_lib_schema121.EntityScalarField;
+  title: _contractspec_lib_schema121.EntityScalarField;
+  body: _contractspec_lib_schema121.EntityScalarField;
+  audience: _contractspec_lib_schema121.EntityEnumField;
+  audienceRole: _contractspec_lib_schema121.EntityScalarField;
+  pinnedUntil: _contractspec_lib_schema121.EntityScalarField;
+  orgId: _contractspec_lib_schema121.EntityScalarField;
+  createdBy: _contractspec_lib_schema121.EntityScalarField;
+  createdAt: _contractspec_lib_schema121.EntityScalarField;
+  expiresAt: _contractspec_lib_schema121.EntityScalarField;
+}>)[];
+declare const teamHubSchemaContribution: ModuleSchemaContribution;
+//#endregion
+export { AnnouncementAudienceEnum, AnnouncementEntity, RitualCadenceEnum, RitualEntity, RitualOccurrenceEntity, SpaceEntity, TaskEntity, TaskPriorityEnum, TaskStatusEnum, teamHubEntities, teamHubSchemaContribution };
+//# sourceMappingURL=index.d.ts.map

package/dist/entities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/entities/index.ts"],"sourcesContent":[],"mappings":";;;;cAUa,gBAKX,2BAAA,CALyB;cAOd,kBAKX,2BAAA,CAL2B;cAOhB,mBAKX,2BAAA,CAL4B;AAdjB,cAqBA,wBAhBX,EAqBA,2BAAA,CALmC,aAhBnC;AAEW,cAqBA,WAhBX,8BAgBsB,UAhBtB,CAAA;EAEW,EAAA,EAoCX,2BAAA,CAAA,iBA/BA;EAEW,IAAA,+CAKX;EAEW,WAAA,+CAsBX;EAAA,KAAA,+CAAA;;;;;;;;;cAEW,wCAAU;MAyCrB,2BAAA,CAAA;wDAjEsB;EAAA,KAAA,+CAAA;EAwBX,WAAA,+CAyCX;EAAA,MAAA,6CAAA;;;;;;;;;;cAEW,0CAAY;MAmCvB,2BAAA,CAAA;;sDA9EqB;EAAA,OAAA,6CAAA;EA2CV,SAAA,+CAmCX;EAAA,IAAA,+CAAA;;;;;;;;;;;cAEW,oDAAsB;MAkCjC,2BAAA,CAAA;;;uDAvEuB;EAAA,OAAA,+CAAA;EAqCZ,UAAA,+CAkCX;EAAA,YAAA,+CAAA;;;;;;cAEW,gDAAkB;MAgC7B,2BAAA,CAAA;;;;uDApEiC;EAAA,YAAA,+CAAA;EAoCtB,WAAA,+CAgCX;EAAA,KAAA,+CAAA;;;;;cAEW,8CAAe;MAM3B,2BAAA,CAAA;;;;;wDAxC8B;EAAA,SAAA,+CAAA;EAkClB,SAAA,+CAMZ;EAAA,KAAA,iDAAA;;;;MAN2B,2BAAA,CAAA;;;;;;;wDAAA;EAAA,IAAA,+CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAQf,2BAA2B"}