@contractspec/example.pocket-family-office 3.7.10 → 3.7.12

package/dist/browser/index.js

@@ -940,6 +940,123 @@ var PocketFamilyOfficeFeature = defineFeature({
     "docs.examples.pocket-family-office.reference"
   ]
 });
+var tech_contracts_vertical_pocket_family_office_DocBlocks = [
+  {
+    id: "docs.tech.contracts.vertical-pocket-family-office",
+    title: "Pocket Family Office Vertical",
+    summary: "Pocket Family Office is a ContractSpec reference vertical that",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/tech/contracts/vertical-pocket-family-office",
+    tags: ["tech", "contracts", "vertical-pocket-family-office"],
+    body: `# Pocket Family Office Vertical
+
+Pocket Family Office is a ContractSpec reference vertical that
+demonstrates finance automation atop the integration and knowledge
+layers. It is optimised for the hackathon stack (Google Cloud, Mistral,
+Qdrant, ElevenLabs) while remaining provider-agnostic.
+
+## Goals
+
+- Ingest household financial documents (uploads + Gmail threads).
+- Generate AI summaries and optionally deliver them as voice notes.
+- Schedule multi-channel reminders for upcoming bills.
+- Showcase spec-first composition of integrations, knowledge spaces, and
+  workflows.
+
+## Blueprint Overview
+
+Source: \`packages/examples/pocket-family-office/blueprint.ts\`
+
+- **Integration slots**
+  - \`primaryLLM\` → Mistral chat/embeddings
+  - \`primaryVectorDb\` → Qdrant
+  - \`primaryStorage\` → Google Cloud Storage
+  - \`primaryOpenBanking\` → Powens BYOK project for account aggregation
+  - \`emailInbound\` / \`emailOutbound\` → Gmail + Postmark
+  - \`calendarScheduling\` → Google Calendar
+  - \`voicePlayback\` → ElevenLabs (optional)
+  - \`smsNotifications\` → Twilio (optional)
+  - \`paymentsProcessing\` → Stripe (optional)
+- **Workflows**
+  - \`process-uploaded-document\`
+  - \`upcoming-payments-reminder\`
+  - \`generate-financial-summary\`
+  - \`ingest-email-threads\`
+  - \`sync-openbanking-accounts\`
+  - \`sync-openbanking-transactions\`
+  - \`refresh-openbanking-balances\`
+  - \`generate-openbanking-overview\`
+- **Policies/Telemetry** – references tenant policy specs and
+  \`pfo.telemetry\` for observability.
+
+## Tenant Sample
+
+\`tenant.sample.ts\` binds each slot to sample connections defined in
+\`connections/samples.ts\`. Key details:
+
+- Uses Google Cloud Secret Manager URIs for all credentials.
+- Enables knowledge spaces \`knowledge.financial-docs\` and
+  \`knowledge.email-threads\`, plus the derived summaries space
+  \`knowledge.financial-overview\` populated by open banking workflows.
+- Keeps \`voicePlayback\` and \`paymentsProcessing\` optional so tenants can
+  enable them incrementally.
+
+## Contracts
+
+\`contracts/index.ts\` defines command/query specs that power the
+workflows:
+
+- \`pfo.documents.upload\` – store object + enqueue ingestion.
+- \`pfo.reminders.schedule-payment\` – send email/SMS/calendar reminders.
+- \`pfo.summary.generate\` – run RAG over knowledge spaces.
+- \`pfo.summary.dispatch\` – deliver summaries via email / voice.
+- \`pfo.email.sync-threads\` – ingest Gmail threads.
+
+## Workflows
+
+- **Process Uploaded Document**
+  1. Upload to storage / queue ingestion.
+  2. Optional human review step.
+- **Upcoming Payments Reminder**
+  1. Human review (confirm due date / channel).
+  2. Automation schedules reminders (email/SMS/calendar).
+- **Generate Financial Summary**
+  1. Run RAG to produce Markdown summary.
+  2. Dispatch summary (email + optional ElevenLabs voice note).
+- **Ingest Email Threads**
+  1. Sync Gmail threads into knowledge space.
+  2. Triage step for operators when nothing new is ingested.
+
+## Knowledge & Jobs
+
+- Knowledge spaces registered via
+  \`registerFinancialDocsKnowledgeSpace\` and
+  \`registerEmailThreadsKnowledgeSpace\`.
+- Ingestion adapters (\`GmailIngestionAdapter\`, \`StorageIngestionAdapter\`)
+  and job handlers (\`createGmailSyncHandler\`,
+  \`createStorageDocumentHandler\`) wire Gmail labels & GCS prefixes into
+  Qdrant.
+- \`KnowledgeQueryService\` provides summarisation + references for the
+  summary generation workflow.
+
+## Tests & Usage
+
+\`tests/pocket-family-office.test.ts\` exercises:
+
+- Blueprint validation + config composition.
+- In-memory ingestion of a sample invoice.
+- Retrieval augmented generation producing a summary with references.
+
+Use these files as scaffolding for new tenants or as a template for the
+hackathon deliverable. Replace the sample connection metadata with
+tenant-specific IDs/secret references before deploying.
+
+
+
+`
+  }
+];
 
 // src/telemetry.ts
 import {
@@ -1643,6 +1760,7 @@ var upcomingPaymentsReminderWorkflow = defineWorkflow8({
 export {
   uploadDocumentContract,
   upcomingPaymentsReminderWorkflow,
+  tech_contracts_vertical_pocket_family_office_DocBlocks,
   syncOpenBankingTransactionsWorkflow,
   syncOpenBankingAccountsWorkflow,
   syncEmailThreadsContract,

package/dist/browser/pocket-family-office.feature.js

@@ -67,6 +67,124 @@ var PocketFamilyOfficeFeature = defineFeature({
     "docs.examples.pocket-family-office.reference"
   ]
 });
+var tech_contracts_vertical_pocket_family_office_DocBlocks = [
+  {
+    id: "docs.tech.contracts.vertical-pocket-family-office",
+    title: "Pocket Family Office Vertical",
+    summary: "Pocket Family Office is a ContractSpec reference vertical that",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/tech/contracts/vertical-pocket-family-office",
+    tags: ["tech", "contracts", "vertical-pocket-family-office"],
+    body: `# Pocket Family Office Vertical
+
+Pocket Family Office is a ContractSpec reference vertical that
+demonstrates finance automation atop the integration and knowledge
+layers. It is optimised for the hackathon stack (Google Cloud, Mistral,
+Qdrant, ElevenLabs) while remaining provider-agnostic.
+
+## Goals
+
+- Ingest household financial documents (uploads + Gmail threads).
+- Generate AI summaries and optionally deliver them as voice notes.
+- Schedule multi-channel reminders for upcoming bills.
+- Showcase spec-first composition of integrations, knowledge spaces, and
+  workflows.
+
+## Blueprint Overview
+
+Source: \`packages/examples/pocket-family-office/blueprint.ts\`
+
+- **Integration slots**
+  - \`primaryLLM\` → Mistral chat/embeddings
+  - \`primaryVectorDb\` → Qdrant
+  - \`primaryStorage\` → Google Cloud Storage
+  - \`primaryOpenBanking\` → Powens BYOK project for account aggregation
+  - \`emailInbound\` / \`emailOutbound\` → Gmail + Postmark
+  - \`calendarScheduling\` → Google Calendar
+  - \`voicePlayback\` → ElevenLabs (optional)
+  - \`smsNotifications\` → Twilio (optional)
+  - \`paymentsProcessing\` → Stripe (optional)
+- **Workflows**
+  - \`process-uploaded-document\`
+  - \`upcoming-payments-reminder\`
+  - \`generate-financial-summary\`
+  - \`ingest-email-threads\`
+  - \`sync-openbanking-accounts\`
+  - \`sync-openbanking-transactions\`
+  - \`refresh-openbanking-balances\`
+  - \`generate-openbanking-overview\`
+- **Policies/Telemetry** – references tenant policy specs and
+  \`pfo.telemetry\` for observability.
+
+## Tenant Sample
+
+\`tenant.sample.ts\` binds each slot to sample connections defined in
+\`connections/samples.ts\`. Key details:
+
+- Uses Google Cloud Secret Manager URIs for all credentials.
+- Enables knowledge spaces \`knowledge.financial-docs\` and
+  \`knowledge.email-threads\`, plus the derived summaries space
+  \`knowledge.financial-overview\` populated by open banking workflows.
+- Keeps \`voicePlayback\` and \`paymentsProcessing\` optional so tenants can
+  enable them incrementally.
+
+## Contracts
+
+\`contracts/index.ts\` defines command/query specs that power the
+workflows:
+
+- \`pfo.documents.upload\` – store object + enqueue ingestion.
+- \`pfo.reminders.schedule-payment\` – send email/SMS/calendar reminders.
+- \`pfo.summary.generate\` – run RAG over knowledge spaces.
+- \`pfo.summary.dispatch\` – deliver summaries via email / voice.
+- \`pfo.email.sync-threads\` – ingest Gmail threads.
+
+## Workflows
+
+- **Process Uploaded Document**
+  1. Upload to storage / queue ingestion.
+  2. Optional human review step.
+- **Upcoming Payments Reminder**
+  1. Human review (confirm due date / channel).
+  2. Automation schedules reminders (email/SMS/calendar).
+- **Generate Financial Summary**
+  1. Run RAG to produce Markdown summary.
+  2. Dispatch summary (email + optional ElevenLabs voice note).
+- **Ingest Email Threads**
+  1. Sync Gmail threads into knowledge space.
+  2. Triage step for operators when nothing new is ingested.
+
+## Knowledge & Jobs
+
+- Knowledge spaces registered via
+  \`registerFinancialDocsKnowledgeSpace\` and
+  \`registerEmailThreadsKnowledgeSpace\`.
+- Ingestion adapters (\`GmailIngestionAdapter\`, \`StorageIngestionAdapter\`)
+  and job handlers (\`createGmailSyncHandler\`,
+  \`createStorageDocumentHandler\`) wire Gmail labels & GCS prefixes into
+  Qdrant.
+- \`KnowledgeQueryService\` provides summarisation + references for the
+  summary generation workflow.
+
+## Tests & Usage
+
+\`tests/pocket-family-office.test.ts\` exercises:
+
+- Blueprint validation + config composition.
+- In-memory ingestion of a sample invoice.
+- Retrieval augmented generation producing a summary with references.
+
+Use these files as scaffolding for new tenants or as a template for the
+hackathon deliverable. Replace the sample connection metadata with
+tenant-specific IDs/secret references before deploying.
+
+
+
+`
+  }
+];
 export {
+  tech_contracts_vertical_pocket_family_office_DocBlocks,
   PocketFamilyOfficeFeature
 };

package/dist/index.js

@@ -941,6 +941,123 @@ var PocketFamilyOfficeFeature = defineFeature({
     "docs.examples.pocket-family-office.reference"
   ]
 });
+var tech_contracts_vertical_pocket_family_office_DocBlocks = [
+  {
+    id: "docs.tech.contracts.vertical-pocket-family-office",
+    title: "Pocket Family Office Vertical",
+    summary: "Pocket Family Office is a ContractSpec reference vertical that",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/tech/contracts/vertical-pocket-family-office",
+    tags: ["tech", "contracts", "vertical-pocket-family-office"],
+    body: `# Pocket Family Office Vertical
+
+Pocket Family Office is a ContractSpec reference vertical that
+demonstrates finance automation atop the integration and knowledge
+layers. It is optimised for the hackathon stack (Google Cloud, Mistral,
+Qdrant, ElevenLabs) while remaining provider-agnostic.
+
+## Goals
+
+- Ingest household financial documents (uploads + Gmail threads).
+- Generate AI summaries and optionally deliver them as voice notes.
+- Schedule multi-channel reminders for upcoming bills.
+- Showcase spec-first composition of integrations, knowledge spaces, and
+  workflows.
+
+## Blueprint Overview
+
+Source: \`packages/examples/pocket-family-office/blueprint.ts\`
+
+- **Integration slots**
+  - \`primaryLLM\` \u2192 Mistral chat/embeddings
+  - \`primaryVectorDb\` \u2192 Qdrant
+  - \`primaryStorage\` \u2192 Google Cloud Storage
+  - \`primaryOpenBanking\` \u2192 Powens BYOK project for account aggregation
+  - \`emailInbound\` / \`emailOutbound\` \u2192 Gmail + Postmark
+  - \`calendarScheduling\` \u2192 Google Calendar
+  - \`voicePlayback\` \u2192 ElevenLabs (optional)
+  - \`smsNotifications\` \u2192 Twilio (optional)
+  - \`paymentsProcessing\` \u2192 Stripe (optional)
+- **Workflows**
+  - \`process-uploaded-document\`
+  - \`upcoming-payments-reminder\`
+  - \`generate-financial-summary\`
+  - \`ingest-email-threads\`
+  - \`sync-openbanking-accounts\`
+  - \`sync-openbanking-transactions\`
+  - \`refresh-openbanking-balances\`
+  - \`generate-openbanking-overview\`
+- **Policies/Telemetry** \u2013 references tenant policy specs and
+  \`pfo.telemetry\` for observability.
+
+## Tenant Sample
+
+\`tenant.sample.ts\` binds each slot to sample connections defined in
+\`connections/samples.ts\`. Key details:
+
+- Uses Google Cloud Secret Manager URIs for all credentials.
+- Enables knowledge spaces \`knowledge.financial-docs\` and
+  \`knowledge.email-threads\`, plus the derived summaries space
+  \`knowledge.financial-overview\` populated by open banking workflows.
+- Keeps \`voicePlayback\` and \`paymentsProcessing\` optional so tenants can
+  enable them incrementally.
+
+## Contracts
+
+\`contracts/index.ts\` defines command/query specs that power the
+workflows:
+
+- \`pfo.documents.upload\` \u2013 store object + enqueue ingestion.
+- \`pfo.reminders.schedule-payment\` \u2013 send email/SMS/calendar reminders.
+- \`pfo.summary.generate\` \u2013 run RAG over knowledge spaces.
+- \`pfo.summary.dispatch\` \u2013 deliver summaries via email / voice.
+- \`pfo.email.sync-threads\` \u2013 ingest Gmail threads.
+
+## Workflows
+
+- **Process Uploaded Document**
+  1. Upload to storage / queue ingestion.
+  2. Optional human review step.
+- **Upcoming Payments Reminder**
+  1. Human review (confirm due date / channel).
+  2. Automation schedules reminders (email/SMS/calendar).
+- **Generate Financial Summary**
+  1. Run RAG to produce Markdown summary.
+  2. Dispatch summary (email + optional ElevenLabs voice note).
+- **Ingest Email Threads**
+  1. Sync Gmail threads into knowledge space.
+  2. Triage step for operators when nothing new is ingested.
+
+## Knowledge & Jobs
+
+- Knowledge spaces registered via
+  \`registerFinancialDocsKnowledgeSpace\` and
+  \`registerEmailThreadsKnowledgeSpace\`.
+- Ingestion adapters (\`GmailIngestionAdapter\`, \`StorageIngestionAdapter\`)
+  and job handlers (\`createGmailSyncHandler\`,
+  \`createStorageDocumentHandler\`) wire Gmail labels & GCS prefixes into
+  Qdrant.
+- \`KnowledgeQueryService\` provides summarisation + references for the
+  summary generation workflow.
+
+## Tests & Usage
+
+\`tests/pocket-family-office.test.ts\` exercises:
+
+- Blueprint validation + config composition.
+- In-memory ingestion of a sample invoice.
+- Retrieval augmented generation producing a summary with references.
+
+Use these files as scaffolding for new tenants or as a template for the
+hackathon deliverable. Replace the sample connection metadata with
+tenant-specific IDs/secret references before deploying.
+
+
+
+`
+  }
+];
 
 // src/telemetry.ts
 import {
@@ -1644,6 +1761,7 @@ var upcomingPaymentsReminderWorkflow = defineWorkflow8({
 export {
   uploadDocumentContract,
   upcomingPaymentsReminderWorkflow,
+  tech_contracts_vertical_pocket_family_office_DocBlocks,
   syncOpenBankingTransactionsWorkflow,
   syncOpenBankingAccountsWorkflow,
   syncEmailThreadsContract,

package/dist/node/index.js

@@ -940,6 +940,123 @@ var PocketFamilyOfficeFeature = defineFeature({
     "docs.examples.pocket-family-office.reference"
   ]
 });
+var tech_contracts_vertical_pocket_family_office_DocBlocks = [
+  {
+    id: "docs.tech.contracts.vertical-pocket-family-office",
+    title: "Pocket Family Office Vertical",
+    summary: "Pocket Family Office is a ContractSpec reference vertical that",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/tech/contracts/vertical-pocket-family-office",
+    tags: ["tech", "contracts", "vertical-pocket-family-office"],
+    body: `# Pocket Family Office Vertical
+
+Pocket Family Office is a ContractSpec reference vertical that
+demonstrates finance automation atop the integration and knowledge
+layers. It is optimised for the hackathon stack (Google Cloud, Mistral,
+Qdrant, ElevenLabs) while remaining provider-agnostic.
+
+## Goals
+
+- Ingest household financial documents (uploads + Gmail threads).
+- Generate AI summaries and optionally deliver them as voice notes.
+- Schedule multi-channel reminders for upcoming bills.
+- Showcase spec-first composition of integrations, knowledge spaces, and
+  workflows.
+
+## Blueprint Overview
+
+Source: \`packages/examples/pocket-family-office/blueprint.ts\`
+
+- **Integration slots**
+  - \`primaryLLM\` → Mistral chat/embeddings
+  - \`primaryVectorDb\` → Qdrant
+  - \`primaryStorage\` → Google Cloud Storage
+  - \`primaryOpenBanking\` → Powens BYOK project for account aggregation
+  - \`emailInbound\` / \`emailOutbound\` → Gmail + Postmark
+  - \`calendarScheduling\` → Google Calendar
+  - \`voicePlayback\` → ElevenLabs (optional)
+  - \`smsNotifications\` → Twilio (optional)
+  - \`paymentsProcessing\` → Stripe (optional)
+- **Workflows**
+  - \`process-uploaded-document\`
+  - \`upcoming-payments-reminder\`
+  - \`generate-financial-summary\`
+  - \`ingest-email-threads\`
+  - \`sync-openbanking-accounts\`
+  - \`sync-openbanking-transactions\`
+  - \`refresh-openbanking-balances\`
+  - \`generate-openbanking-overview\`
+- **Policies/Telemetry** – references tenant policy specs and
+  \`pfo.telemetry\` for observability.
+
+## Tenant Sample
+
+\`tenant.sample.ts\` binds each slot to sample connections defined in
+\`connections/samples.ts\`. Key details:
+
+- Uses Google Cloud Secret Manager URIs for all credentials.
+- Enables knowledge spaces \`knowledge.financial-docs\` and
+  \`knowledge.email-threads\`, plus the derived summaries space
+  \`knowledge.financial-overview\` populated by open banking workflows.
+- Keeps \`voicePlayback\` and \`paymentsProcessing\` optional so tenants can
+  enable them incrementally.
+
+## Contracts
+
+\`contracts/index.ts\` defines command/query specs that power the
+workflows:
+
+- \`pfo.documents.upload\` – store object + enqueue ingestion.
+- \`pfo.reminders.schedule-payment\` – send email/SMS/calendar reminders.
+- \`pfo.summary.generate\` – run RAG over knowledge spaces.
+- \`pfo.summary.dispatch\` – deliver summaries via email / voice.
+- \`pfo.email.sync-threads\` – ingest Gmail threads.
+
+## Workflows
+
+- **Process Uploaded Document**
+  1. Upload to storage / queue ingestion.
+  2. Optional human review step.
+- **Upcoming Payments Reminder**
+  1. Human review (confirm due date / channel).
+  2. Automation schedules reminders (email/SMS/calendar).
+- **Generate Financial Summary**
+  1. Run RAG to produce Markdown summary.
+  2. Dispatch summary (email + optional ElevenLabs voice note).
+- **Ingest Email Threads**
+  1. Sync Gmail threads into knowledge space.
+  2. Triage step for operators when nothing new is ingested.
+
+## Knowledge & Jobs
+
+- Knowledge spaces registered via
+  \`registerFinancialDocsKnowledgeSpace\` and
+  \`registerEmailThreadsKnowledgeSpace\`.
+- Ingestion adapters (\`GmailIngestionAdapter\`, \`StorageIngestionAdapter\`)
+  and job handlers (\`createGmailSyncHandler\`,
+  \`createStorageDocumentHandler\`) wire Gmail labels & GCS prefixes into
+  Qdrant.
+- \`KnowledgeQueryService\` provides summarisation + references for the
+  summary generation workflow.
+
+## Tests & Usage
+
+\`tests/pocket-family-office.test.ts\` exercises:
+
+- Blueprint validation + config composition.
+- In-memory ingestion of a sample invoice.
+- Retrieval augmented generation producing a summary with references.
+
+Use these files as scaffolding for new tenants or as a template for the
+hackathon deliverable. Replace the sample connection metadata with
+tenant-specific IDs/secret references before deploying.
+
+
+
+`
+  }
+];
 
 // src/telemetry.ts
 import {
@@ -1643,6 +1760,7 @@ var upcomingPaymentsReminderWorkflow = defineWorkflow8({
 export {
   uploadDocumentContract,
   upcomingPaymentsReminderWorkflow,
+  tech_contracts_vertical_pocket_family_office_DocBlocks,
   syncOpenBankingTransactionsWorkflow,
   syncOpenBankingAccountsWorkflow,
   syncEmailThreadsContract,

package/dist/node/pocket-family-office.feature.js

@@ -67,6 +67,124 @@ var PocketFamilyOfficeFeature = defineFeature({
     "docs.examples.pocket-family-office.reference"
   ]
 });
+var tech_contracts_vertical_pocket_family_office_DocBlocks = [
+  {
+    id: "docs.tech.contracts.vertical-pocket-family-office",
+    title: "Pocket Family Office Vertical",
+    summary: "Pocket Family Office is a ContractSpec reference vertical that",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/tech/contracts/vertical-pocket-family-office",
+    tags: ["tech", "contracts", "vertical-pocket-family-office"],
+    body: `# Pocket Family Office Vertical
+
+Pocket Family Office is a ContractSpec reference vertical that
+demonstrates finance automation atop the integration and knowledge
+layers. It is optimised for the hackathon stack (Google Cloud, Mistral,
+Qdrant, ElevenLabs) while remaining provider-agnostic.
+
+## Goals
+
+- Ingest household financial documents (uploads + Gmail threads).
+- Generate AI summaries and optionally deliver them as voice notes.
+- Schedule multi-channel reminders for upcoming bills.
+- Showcase spec-first composition of integrations, knowledge spaces, and
+  workflows.
+
+## Blueprint Overview
+
+Source: \`packages/examples/pocket-family-office/blueprint.ts\`
+
+- **Integration slots**
+  - \`primaryLLM\` → Mistral chat/embeddings
+  - \`primaryVectorDb\` → Qdrant
+  - \`primaryStorage\` → Google Cloud Storage
+  - \`primaryOpenBanking\` → Powens BYOK project for account aggregation
+  - \`emailInbound\` / \`emailOutbound\` → Gmail + Postmark
+  - \`calendarScheduling\` → Google Calendar
+  - \`voicePlayback\` → ElevenLabs (optional)
+  - \`smsNotifications\` → Twilio (optional)
+  - \`paymentsProcessing\` → Stripe (optional)
+- **Workflows**
+  - \`process-uploaded-document\`
+  - \`upcoming-payments-reminder\`
+  - \`generate-financial-summary\`
+  - \`ingest-email-threads\`
+  - \`sync-openbanking-accounts\`
+  - \`sync-openbanking-transactions\`
+  - \`refresh-openbanking-balances\`
+  - \`generate-openbanking-overview\`
+- **Policies/Telemetry** – references tenant policy specs and
+  \`pfo.telemetry\` for observability.
+
+## Tenant Sample
+
+\`tenant.sample.ts\` binds each slot to sample connections defined in
+\`connections/samples.ts\`. Key details:
+
+- Uses Google Cloud Secret Manager URIs for all credentials.
+- Enables knowledge spaces \`knowledge.financial-docs\` and
+  \`knowledge.email-threads\`, plus the derived summaries space
+  \`knowledge.financial-overview\` populated by open banking workflows.
+- Keeps \`voicePlayback\` and \`paymentsProcessing\` optional so tenants can
+  enable them incrementally.
+
+## Contracts
+
+\`contracts/index.ts\` defines command/query specs that power the
+workflows:
+
+- \`pfo.documents.upload\` – store object + enqueue ingestion.
+- \`pfo.reminders.schedule-payment\` – send email/SMS/calendar reminders.
+- \`pfo.summary.generate\` – run RAG over knowledge spaces.
+- \`pfo.summary.dispatch\` – deliver summaries via email / voice.
+- \`pfo.email.sync-threads\` – ingest Gmail threads.
+
+## Workflows
+
+- **Process Uploaded Document**
+  1. Upload to storage / queue ingestion.
+  2. Optional human review step.
+- **Upcoming Payments Reminder**
+  1. Human review (confirm due date / channel).
+  2. Automation schedules reminders (email/SMS/calendar).
+- **Generate Financial Summary**
+  1. Run RAG to produce Markdown summary.
+  2. Dispatch summary (email + optional ElevenLabs voice note).
+- **Ingest Email Threads**
+  1. Sync Gmail threads into knowledge space.
+  2. Triage step for operators when nothing new is ingested.
+
+## Knowledge & Jobs
+
+- Knowledge spaces registered via
+  \`registerFinancialDocsKnowledgeSpace\` and
+  \`registerEmailThreadsKnowledgeSpace\`.
+- Ingestion adapters (\`GmailIngestionAdapter\`, \`StorageIngestionAdapter\`)
+  and job handlers (\`createGmailSyncHandler\`,
+  \`createStorageDocumentHandler\`) wire Gmail labels & GCS prefixes into
+  Qdrant.
+- \`KnowledgeQueryService\` provides summarisation + references for the
+  summary generation workflow.
+
+## Tests & Usage
+
+\`tests/pocket-family-office.test.ts\` exercises:
+
+- Blueprint validation + config composition.
+- In-memory ingestion of a sample invoice.
+- Retrieval augmented generation producing a summary with references.
+
+Use these files as scaffolding for new tenants or as a template for the
+hackathon deliverable. Replace the sample connection metadata with
+tenant-specific IDs/secret references before deploying.
+
+
+
+`
+  }
+];
 export {
+  tech_contracts_vertical_pocket_family_office_DocBlocks,
   PocketFamilyOfficeFeature
 };

package/dist/pocket-family-office.feature.d.ts

@@ -1,5 +1,12 @@
+/**
+ * Pocket Family Office Feature Module Specification
+ *
+ * Defines the feature module for personal finance automation.
+ */
 /**
  * Pocket Family Office feature module that bundles financial document
  * management, open banking integration, and automated summaries.
  */
+import type { DocBlock } from '@contractspec/lib.contracts-spec';
 export declare const PocketFamilyOfficeFeature: import("@contractspec/lib.contracts-spec").FeatureModuleSpec;
+export declare const tech_contracts_vertical_pocket_family_office_DocBlocks: DocBlock[];

package/dist/pocket-family-office.feature.js

@@ -68,6 +68,124 @@ var PocketFamilyOfficeFeature = defineFeature({
     "docs.examples.pocket-family-office.reference"
   ]
 });
+var tech_contracts_vertical_pocket_family_office_DocBlocks = [
+  {
+    id: "docs.tech.contracts.vertical-pocket-family-office",
+    title: "Pocket Family Office Vertical",
+    summary: "Pocket Family Office is a ContractSpec reference vertical that",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/tech/contracts/vertical-pocket-family-office",
+    tags: ["tech", "contracts", "vertical-pocket-family-office"],
+    body: `# Pocket Family Office Vertical
+
+Pocket Family Office is a ContractSpec reference vertical that
+demonstrates finance automation atop the integration and knowledge
+layers. It is optimised for the hackathon stack (Google Cloud, Mistral,
+Qdrant, ElevenLabs) while remaining provider-agnostic.
+
+## Goals
+
+- Ingest household financial documents (uploads + Gmail threads).
+- Generate AI summaries and optionally deliver them as voice notes.
+- Schedule multi-channel reminders for upcoming bills.
+- Showcase spec-first composition of integrations, knowledge spaces, and
+  workflows.
+
+## Blueprint Overview
+
+Source: \`packages/examples/pocket-family-office/blueprint.ts\`
+
+- **Integration slots**
+  - \`primaryLLM\` \u2192 Mistral chat/embeddings
+  - \`primaryVectorDb\` \u2192 Qdrant
+  - \`primaryStorage\` \u2192 Google Cloud Storage
+  - \`primaryOpenBanking\` \u2192 Powens BYOK project for account aggregation
+  - \`emailInbound\` / \`emailOutbound\` \u2192 Gmail + Postmark
+  - \`calendarScheduling\` \u2192 Google Calendar
+  - \`voicePlayback\` \u2192 ElevenLabs (optional)
+  - \`smsNotifications\` \u2192 Twilio (optional)
+  - \`paymentsProcessing\` \u2192 Stripe (optional)
+- **Workflows**
+  - \`process-uploaded-document\`
+  - \`upcoming-payments-reminder\`
+  - \`generate-financial-summary\`
+  - \`ingest-email-threads\`
+  - \`sync-openbanking-accounts\`
+  - \`sync-openbanking-transactions\`
+  - \`refresh-openbanking-balances\`
+  - \`generate-openbanking-overview\`
+- **Policies/Telemetry** \u2013 references tenant policy specs and
+  \`pfo.telemetry\` for observability.
+
+## Tenant Sample
+
+\`tenant.sample.ts\` binds each slot to sample connections defined in
+\`connections/samples.ts\`. Key details:
+
+- Uses Google Cloud Secret Manager URIs for all credentials.
+- Enables knowledge spaces \`knowledge.financial-docs\` and
+  \`knowledge.email-threads\`, plus the derived summaries space
+  \`knowledge.financial-overview\` populated by open banking workflows.
+- Keeps \`voicePlayback\` and \`paymentsProcessing\` optional so tenants can
+  enable them incrementally.
+
+## Contracts
+
+\`contracts/index.ts\` defines command/query specs that power the
+workflows:
+
+- \`pfo.documents.upload\` \u2013 store object + enqueue ingestion.
+- \`pfo.reminders.schedule-payment\` \u2013 send email/SMS/calendar reminders.
+- \`pfo.summary.generate\` \u2013 run RAG over knowledge spaces.
+- \`pfo.summary.dispatch\` \u2013 deliver summaries via email / voice.
+- \`pfo.email.sync-threads\` \u2013 ingest Gmail threads.
+
+## Workflows
+
+- **Process Uploaded Document**
+  1. Upload to storage / queue ingestion.
+  2. Optional human review step.
+- **Upcoming Payments Reminder**
+  1. Human review (confirm due date / channel).
+  2. Automation schedules reminders (email/SMS/calendar).
+- **Generate Financial Summary**
+  1. Run RAG to produce Markdown summary.
+  2. Dispatch summary (email + optional ElevenLabs voice note).
+- **Ingest Email Threads**
+  1. Sync Gmail threads into knowledge space.
+  2. Triage step for operators when nothing new is ingested.
+
+## Knowledge & Jobs
+
+- Knowledge spaces registered via
+  \`registerFinancialDocsKnowledgeSpace\` and
+  \`registerEmailThreadsKnowledgeSpace\`.
+- Ingestion adapters (\`GmailIngestionAdapter\`, \`StorageIngestionAdapter\`)
+  and job handlers (\`createGmailSyncHandler\`,
+  \`createStorageDocumentHandler\`) wire Gmail labels & GCS prefixes into
+  Qdrant.
+- \`KnowledgeQueryService\` provides summarisation + references for the
+  summary generation workflow.
+
+## Tests & Usage
+
+\`tests/pocket-family-office.test.ts\` exercises:
+
+- Blueprint validation + config composition.
+- In-memory ingestion of a sample invoice.
+- Retrieval augmented generation producing a summary with references.
+
+Use these files as scaffolding for new tenants or as a template for the
+hackathon deliverable. Replace the sample connection metadata with
+tenant-specific IDs/secret references before deploying.
+
+
+
+`
+  }
+];
 export {
+  tech_contracts_vertical_pocket_family_office_DocBlocks,
   PocketFamilyOfficeFeature
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.pocket-family-office",
-  "version": "3.7.10",
+  "version": "3.7.12",
   "description": "Pocket Family Office example - personal finance automation with open banking",
   "keywords": [
     "contractspec",
@@ -29,15 +29,15 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.knowledge": "3.7.10",
-    "@contractspec/lib.contracts-spec": "4.1.2",
-    "@contractspec/lib.contracts-integrations": "3.8.2",
-    "@contractspec/lib.schema": "3.7.8"
+    "@contractspec/lib.knowledge": "3.7.12",
+    "@contractspec/lib.contracts-spec": "5.0.0",
+    "@contractspec/lib.contracts-integrations": "3.8.4",
+    "@contractspec/lib.schema": "3.7.10"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.8",
+    "@contractspec/tool.typescript": "3.7.9",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.8"
+    "@contractspec/tool.bun": "3.7.9"
   },
   "exports": {
     ".": {