@contractspec/example.pocket-family-office 3.7.6 → 3.7.7

package/dist/index.js

@@ -498,75 +498,6 @@ var example = defineExample({
 });
 var example_default = example;
 
-// src/tenant.sample.ts
-var pocketFamilyOfficeTenantSample = {
-  meta: {
-    id: "tenant-pfo-sample",
-    tenantId: "tenant.family-office",
-    appId: "pocket-family-office",
-    blueprintName: "pocket-family-office.app",
-    blueprintVersion: "1.0.0",
-    environment: "production",
-    version: "1.0.0",
-    createdAt: new Date().toISOString(),
-    updatedAt: new Date().toISOString(),
-    status: "published"
-  },
-  featureFlags: [
-    {
-      key: "voice-summaries",
-      enabled: true,
-      description: "Enable spoken ElevenLabs summaries for daily briefings."
-    }
-  ],
-  integrations: [
-    { slotId: "primaryLLM", connectionId: "conn-mistral-primary" },
-    { slotId: "primaryVectorDb", connectionId: "conn-qdrant-finance" },
-    { slotId: "primaryStorage", connectionId: "conn-gcs-documents" },
-    { slotId: "primaryOpenBanking", connectionId: "conn-powens-primary" },
-    { slotId: "emailInbound", connectionId: "conn-gmail-threads" },
-    { slotId: "emailOutbound", connectionId: "conn-postmark-outbound" },
-    { slotId: "calendarScheduling", connectionId: "conn-google-calendar" },
-    { slotId: "voicePlayback", connectionId: "conn-elevenlabs-voice" },
-    { slotId: "smsNotifications", connectionId: "conn-twilio-sms" },
-    { slotId: "paymentsProcessing", connectionId: "conn-stripe-recurring" }
-  ],
-  knowledge: [
-    {
-      spaceKey: "knowledge.financial-docs",
-      scope: {
-        workflows: [
-          "pfo.workflow.process-uploaded-document",
-          "pfo.workflow.generate-financial-summary"
-        ]
-      }
-    },
-    {
-      spaceKey: "knowledge.email-threads",
-      scope: {
-        workflows: ["pfo.workflow.ingest-email-threads"]
-      }
-    },
-    {
-      spaceKey: "knowledge.financial-overview",
-      scope: {
-        workflows: [
-          "pfo.workflow.sync-openbanking-transactions",
-          "pfo.workflow.refresh-openbanking-balances",
-          "pfo.workflow.generate-financial-summary",
-          "pfo.workflow.generate-openbanking-overview"
-        ]
-      },
-      required: false
-    }
-  ],
-  locales: {
-    defaultLocale: "en",
-    enabledLocales: ["en"]
-  },
-  notes: "Sample tenant configuration for hackathon demos. Replace connection IDs with tenant-specific bindings when provisioning."
-};
-
 // src/knowledge/sources.sample.ts
 var now2 = new Date;
 var pocketFamilyOfficeKnowledgeSources = [
@@ -636,11 +567,7 @@ var pocketFamilyOfficeKnowledgeSources = [
 ];
 
 // src/operations/index.ts
-import {
-  defineEnum,
-  defineSchemaModel,
-  ScalarTypeEnum
-} from "@contractspec/lib.schema";
+import { OPENBANKING_TELEMETRY_EVENTS } from "@contractspec/lib.contracts-integrations";
 import {
   defineCommand,
   defineQuery
@@ -650,7 +577,11 @@ import {
   StabilityEnum as StabilityEnum2,
   TagsEnum as TagsEnum2
 } from "@contractspec/lib.contracts-spec/ownership";
-import { OPENBANKING_TELEMETRY_EVENTS } from "@contractspec/lib.contracts-integrations";
+import {
+  defineEnum,
+  defineSchemaModel,
+  ScalarTypeEnum
+} from "@contractspec/lib.schema";
 var SourceEnum = defineEnum("Source", ["upload", "email", "sync"]);
 var ChannelEnum = defineEnum("Channel", ["email", "sms", "both"]);
 var PeriodEnum = defineEnum("Period", ["P7d", "P30d", "P90d"]);
@@ -941,135 +872,335 @@ var pocketFamilyOfficeContracts = {
   "pfo.openbanking.generate-overview": generateOpenBankingOverviewContract
 };
 
-// src/workflows/process-uploaded-document.ts
-import { defineWorkflow } from "@contractspec/lib.contracts-spec/workflow";
+// src/pocket-family-office.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts-spec";
+var PocketFamilyOfficeFeature = defineFeature({
+  meta: {
+    key: "pocket-family-office",
+    version: "1.0.0",
+    title: "Pocket Family Office",
+    description: "Personal finance automation with document ingestion, open banking, and AI summaries",
+    domain: "finance",
+    owners: ["@platform.finance"],
+    tags: [
+      "finance",
+      "open-banking",
+      "documents",
+      "automation",
+      "family-office"
+    ],
+    stability: "experimental"
+  },
+  operations: [
+    { key: "pfo.documents.upload", version: "1.0.0" },
+    { key: "pfo.reminders.schedule-payment", version: "1.0.0" },
+    { key: "pfo.summary.generate", version: "1.0.0" },
+    { key: "pfo.email.sync-threads", version: "1.0.0" },
+    { key: "pfo.summary.dispatch", version: "1.0.0" },
+    { key: "pfo.openbanking.generate-overview", version: "1.0.0" }
+  ],
+  events: [],
+  presentations: [],
+  opToPresentation: [],
+  presentationsTargets: [],
+  capabilities: {
+    provides: [{ key: "pocket-family-office", version: "1.0.0" }],
+    requires: [
+      { key: "identity", version: "1.0.0" },
+      { key: "openbanking", version: "1.0.0" }
+    ]
+  },
+  workflows: [
+    { key: "pfo.workflow.sync-openbanking-accounts", version: "1.0.0" },
+    { key: "pfo.workflow.sync-openbanking-transactions", version: "1.0.0" },
+    { key: "pfo.workflow.refresh-openbanking-balances", version: "1.0.0" },
+    { key: "pfo.workflow.generate-openbanking-overview", version: "1.0.0" },
+    { key: "pfo.workflow.process-uploaded-document", version: "1.0.0" },
+    { key: "pfo.workflow.upcoming-payments-reminder", version: "1.0.0" },
+    { key: "pfo.workflow.generate-financial-summary", version: "1.0.0" },
+    { key: "pfo.workflow.ingest-email-threads", version: "1.0.0" }
+  ],
+  knowledge: [
+    { key: "knowledge.financial-docs", version: "1.0.0" },
+    { key: "knowledge.email-threads", version: "1.0.0" },
+    { key: "knowledge.financial-overview", version: "1.0.0" }
+  ],
+  telemetry: [{ key: "pfo.telemetry", version: "1.0.0" }],
+  policies: [{ key: "pfo.policy.tenancy", version: "1.0.0" }],
+  integrations: [
+    { key: "pfo.integration.openbanking", version: "1.0.0" },
+    { key: "pfo.integration.llm", version: "1.0.0" }
+  ],
+  jobs: [
+    { key: "pfo.job.doc-processing", version: "1.0.0" },
+    { key: "pfo.job.reminder-dispatch", version: "1.0.0" }
+  ],
+  docs: [
+    "docs.examples.pocket-family-office.goal",
+    "docs.examples.pocket-family-office.usage",
+    "docs.examples.pocket-family-office.reference"
+  ]
+});
+
+// src/telemetry.ts
+import {
+  OPENBANKING_PII_FIELDS,
+  OPENBANKING_TELEMETRY_EVENTS as OPENBANKING_TELEMETRY_EVENTS2
+} from "@contractspec/lib.contracts-integrations";
 import {
   OwnersEnum as OwnersEnum3,
   StabilityEnum as StabilityEnum3,
   TagsEnum as TagsEnum3
-} from "@contractspec/lib.contracts-spec";
-var processUploadedDocumentWorkflow = defineWorkflow({
+} from "@contractspec/lib.contracts-spec/ownership";
+var commonProperties = {
+  tenantId: {
+    type: "string",
+    required: true,
+    description: "Tenant identifier for multi-tenant isolation."
+  },
+  appId: {
+    type: "string",
+    required: true,
+    description: "Application identifier associated with the event."
+  },
+  blueprint: {
+    type: "string",
+    required: true,
+    description: "Blueprint name@version emitting the telemetry."
+  },
+  configVersion: {
+    type: "number",
+    required: true,
+    description: "Resolved app config version when the event was generated."
+  },
+  slotId: {
+    type: "string",
+    required: true,
+    description: "Integration slot identifier (e.g., primaryOpenBanking)."
+  },
+  connectionId: {
+    type: "string",
+    required: true,
+    description: "Integration connection ID used for the sync."
+  }
+};
+function piiSafeString(description) {
+  return {
+    type: "string",
+    description,
+    pii: false
+  };
+}
+var pocketFamilyOfficeTelemetry = {
   meta: {
-    key: "pfo.workflow.process-uploaded-document",
+    key: "pfo.telemetry",
     version: "1.0.0",
-    title: "Process Uploaded Document",
-    description: "Stores an uploaded invoice/contract, queues ingestion, and records any follow-up reminders.",
+    title: "Pocket Family Office Telemetry",
+    description: "Operational telemetry for Pocket Family Office workflows, including Powens open banking syncs.",
     domain: "finance",
     owners: [OwnersEnum3.PlatformFinance],
-    tags: ["documents", "ingestion", TagsEnum3.Automation],
+    tags: ["open-banking", TagsEnum3.Automation],
     stability: StabilityEnum3.Experimental
   },
-  definition: {
-    entryStepId: "store",
-    steps: [
-      {
-        id: "store",
-        type: "automation",
-        label: "Store and Queue Ingestion",
-        description: "Persist the document to storage and enqueue the knowledge ingestion pipeline.",
-        action: {
-          operation: { key: "pfo.documents.upload", version: "1.0.0" }
+  config: {
+    defaultRetentionDays: 180,
+    defaultSamplingRate: 1
+  },
+  events: [
+    {
+      key: OPENBANKING_TELEMETRY_EVENTS2.accountsSynced,
+      version: "1.0.0",
+      semantics: {
+        what: "Open banking account synchronisation completed.",
+        why: "Refresh canonical account metadata for reporting and workflows."
+      },
+      privacy: "internal",
+      properties: {
+        ...commonProperties,
+        syncedCount: {
+          type: "number",
+          description: "Number of accounts synced successfully."
         },
-        requiredIntegrations: ["primaryStorage", "primaryVectorDb"],
-        retry: {
-          maxAttempts: 3,
-          backoff: "exponential",
-          delayMs: 500
+        failedCount: {
+          type: "number",
+          description: "Number of accounts that failed to sync."
+        },
+        durationMs: {
+          type: "number",
+          description: "Duration of the sync job in milliseconds."
         }
-      },
-      {
-        id: "review",
-        type: "human",
-        label: "Optional Human Classification",
-        description: "Finance lead can categorise the document while ingestion completes."
       }
-    ],
-    transitions: [
-      {
-        from: "store",
-        to: "review"
+    },
+    {
+      key: OPENBANKING_TELEMETRY_EVENTS2.transactionsSynced,
+      version: "1.0.0",
+      semantics: {
+        what: "Open banking transaction synchronisation completed.",
+        why: "Keep canonical transaction ledger in sync for analytics."
+      },
+      privacy: "internal",
+      properties: {
+        ...commonProperties,
+        accountId: {
+          type: "string",
+          description: "Bank account identifier used during the sync.",
+          pii: false
+        },
+        syncedCount: {
+          type: "number",
+          description: "Number of transactions synced successfully."
+        },
+        failedCount: {
+          type: "number",
+          description: "Number of transactions that failed to sync."
+        },
+        from: {
+          type: "timestamp",
+          description: "Start timestamp for the sync window."
+        },
+        to: {
+          type: "timestamp",
+          description: "End timestamp for the sync window."
+        }
       }
-    ]
-  }
-});
+    },
+    {
+      key: OPENBANKING_TELEMETRY_EVENTS2.balancesRefreshed,
+      version: "1.0.0",
+      semantics: {
+        what: "Open banking balances refreshed.",
+        why: "Provide accurate cash position for dashboards and alerts."
+      },
+      privacy: "internal",
+      properties: {
+        ...commonProperties,
+        accountId: piiSafeString("Bank account identifier."),
+        balanceTypes: {
+          type: "json",
+          description: "Balance types included in the refresh."
+        },
+        refreshedAt: {
+          type: "timestamp",
+          description: "Timestamp when balances were refreshed."
+        }
+      }
+    },
+    {
+      key: OPENBANKING_TELEMETRY_EVENTS2.overviewGenerated,
+      version: "1.0.0",
+      semantics: {
+        what: "Derived financial overview generated.",
+        why: "Persist cashflow and category summaries into knowledge space."
+      },
+      privacy: "internal",
+      properties: {
+        ...commonProperties,
+        knowledgeEntryId: piiSafeString("Identifier of the knowledge document containing the overview."),
+        period: {
+          type: "string",
+          description: "Aggregation period used (week, month, quarter)."
+        },
+        periodStart: {
+          type: "timestamp",
+          description: "Start timestamp for the aggregation window."
+        },
+        periodEnd: {
+          type: "timestamp",
+          description: "End timestamp for the aggregation window."
+        }
+      },
+      tags: ["knowledge", "analytics"]
+    }
+  ]
+};
+var OPENBANKING_SENSITIVE_FIELDS = OPENBANKING_PII_FIELDS;
 
-// src/workflows/upcoming-payments-reminder.ts
-import { defineWorkflow as defineWorkflow2 } from "@contractspec/lib.contracts-spec/workflow";
-import {
-  OwnersEnum as OwnersEnum4,
-  StabilityEnum as StabilityEnum4,
-  TagsEnum as TagsEnum4
-} from "@contractspec/lib.contracts-spec";
-var upcomingPaymentsReminderWorkflow = defineWorkflow2({
+// src/tenant.sample.ts
+var pocketFamilyOfficeTenantSample = {
   meta: {
-    key: "pfo.workflow.upcoming-payments-reminder",
+    id: "tenant-pfo-sample",
+    tenantId: "tenant.family-office",
+    appId: "pocket-family-office",
+    blueprintName: "pocket-family-office.app",
+    blueprintVersion: "1.0.0",
+    environment: "production",
     version: "1.0.0",
-    title: "Schedule Upcoming Payment Reminder",
-    description: "Collects payment metadata and schedules multi-channel reminders for bills that are due soon.",
-    domain: "finance",
-    owners: [OwnersEnum4.PlatformFinance],
-    tags: ["payments", "reminders", TagsEnum4.Automation],
-    stability: StabilityEnum4.Beta
+    createdAt: new Date().toISOString(),
+    updatedAt: new Date().toISOString(),
+    status: "published"
   },
-  definition: {
-    entryStepId: "collect",
-    steps: [
-      {
-        id: "collect",
-        type: "human",
-        label: "Review Upcoming Bill",
-        description: "Confirm amount, due date, and preferred delivery channels before scheduling reminder."
-      },
-      {
-        id: "schedule",
-        type: "automation",
-        label: "Schedule Reminder",
-        action: {
-          operation: {
-            key: "pfo.reminders.schedule-payment",
-            version: "1.0.0"
-          }
-        },
-        requiredIntegrations: [
-          "emailOutbound",
-          "smsNotifications",
-          "calendarScheduling"
-        ],
-        retry: {
-          maxAttempts: 2,
-          backoff: "linear",
-          delayMs: 1000
-        }
+  featureFlags: [
+    {
+      key: "voice-summaries",
+      enabled: true,
+      description: "Enable spoken ElevenLabs summaries for daily briefings."
+    }
+  ],
+  integrations: [
+    { slotId: "primaryLLM", connectionId: "conn-mistral-primary" },
+    { slotId: "primaryVectorDb", connectionId: "conn-qdrant-finance" },
+    { slotId: "primaryStorage", connectionId: "conn-gcs-documents" },
+    { slotId: "primaryOpenBanking", connectionId: "conn-powens-primary" },
+    { slotId: "emailInbound", connectionId: "conn-gmail-threads" },
+    { slotId: "emailOutbound", connectionId: "conn-postmark-outbound" },
+    { slotId: "calendarScheduling", connectionId: "conn-google-calendar" },
+    { slotId: "voicePlayback", connectionId: "conn-elevenlabs-voice" },
+    { slotId: "smsNotifications", connectionId: "conn-twilio-sms" },
+    { slotId: "paymentsProcessing", connectionId: "conn-stripe-recurring" }
+  ],
+  knowledge: [
+    {
+      spaceKey: "knowledge.financial-docs",
+      scope: {
+        workflows: [
+          "pfo.workflow.process-uploaded-document",
+          "pfo.workflow.generate-financial-summary"
+        ]
       }
-    ],
-    transitions: [
-      {
-        from: "collect",
-        to: "schedule",
-        condition: "output?.confirmed === true",
-        label: "Reminder confirmed"
+    },
+    {
+      spaceKey: "knowledge.email-threads",
+      scope: {
+        workflows: ["pfo.workflow.ingest-email-threads"]
       }
-    ]
-  }
-});
+    },
+    {
+      spaceKey: "knowledge.financial-overview",
+      scope: {
+        workflows: [
+          "pfo.workflow.sync-openbanking-transactions",
+          "pfo.workflow.refresh-openbanking-balances",
+          "pfo.workflow.generate-financial-summary",
+          "pfo.workflow.generate-openbanking-overview"
+        ]
+      },
+      required: false
+    }
+  ],
+  locales: {
+    defaultLocale: "en",
+    enabledLocales: ["en"]
+  },
+  notes: "Sample tenant configuration for hackathon demos. Replace connection IDs with tenant-specific bindings when provisioning."
+};
 
 // src/workflows/generate-financial-summary.ts
-import { defineWorkflow as defineWorkflow3 } from "@contractspec/lib.contracts-spec/workflow";
 import {
-  OwnersEnum as OwnersEnum5,
-  StabilityEnum as StabilityEnum5,
-  TagsEnum as TagsEnum5
+  OwnersEnum as OwnersEnum4,
+  StabilityEnum as StabilityEnum4,
+  TagsEnum as TagsEnum4
 } from "@contractspec/lib.contracts-spec";
-var generateFinancialSummaryWorkflow = defineWorkflow3({
+import { defineWorkflow } from "@contractspec/lib.contracts-spec/workflow";
+var generateFinancialSummaryWorkflow = defineWorkflow({
   meta: {
     key: "pfo.workflow.generate-financial-summary",
     version: "1.0.0",
     title: "Generate Financial Summary",
     description: "Retrieves the latest financial signals, generates an AI summary, and optionally distributes it by voice or email.",
     domain: "finance",
-    owners: [OwnersEnum5.PlatformFinance],
-    tags: ["summary", "ai", TagsEnum5.Automation],
-    stability: StabilityEnum5.Beta
+    owners: [OwnersEnum4.PlatformFinance],
+    tags: ["summary", "ai", TagsEnum4.Automation],
+    stability: StabilityEnum4.Beta
   },
   definition: {
     entryStepId: "summarise",
@@ -1109,36 +1240,86 @@ var generateFinancialSummaryWorkflow = defineWorkflow3({
   }
 });
 
-// src/workflows/ingest-email-threads.ts
-import { defineWorkflow as defineWorkflow4 } from "@contractspec/lib.contracts-spec/workflow";
+// src/workflows/generate-openbanking-overview.ts
 import {
-  OwnersEnum as OwnersEnum6,
-  StabilityEnum as StabilityEnum6,
-  TagsEnum as TagsEnum6
+  OwnersEnum as OwnersEnum5,
+  StabilityEnum as StabilityEnum5,
+  TagsEnum as TagsEnum5
 } from "@contractspec/lib.contracts-spec";
-var ingestEmailThreadsWorkflow = defineWorkflow4({
+import { defineWorkflow as defineWorkflow2 } from "@contractspec/lib.contracts-spec/workflow";
+var OPEN_BANKING_CAPABILITIES = [
+  { key: "openbanking.accounts.read", version: "1.0.0" },
+  { key: "openbanking.transactions.read", version: "1.0.0" },
+  { key: "openbanking.balances.read", version: "1.0.0" }
+];
+var generateOpenBankingOverviewWorkflow = defineWorkflow2({
   meta: {
-    key: "pfo.workflow.ingest-email-threads",
+    key: "pfo.workflow.generate-openbanking-overview",
     version: "1.0.0",
-    title: "Ingest Email Threads",
-    description: "Synchronises Gmail threads tagged with finance labels and indexes them into operational knowledge spaces.",
-    domain: "communications",
-    owners: [OwnersEnum6.PlatformMessaging],
-    tags: ["gmail", "knowledge", TagsEnum6.Automation],
-    stability: StabilityEnum6.Experimental
+    title: "Generate Open Banking Overview",
+    description: "Produces a derived financial overview and stores it in the operational knowledge space.",
+    domain: "finance",
+    owners: [OwnersEnum5.PlatformFinance],
+    tags: ["open-banking", "summary", TagsEnum5.Automation],
+    stability: StabilityEnum5.Experimental
   },
   definition: {
-    entryStepId: "sync",
+    entryStepId: "generate-overview",
     steps: [
       {
-        id: "sync",
+        id: "generate-overview",
         type: "automation",
-        label: "Sync Gmail Threads",
-        description: "Fetches Gmail threads and transforms them into knowledge fragments before vector indexing.",
+        label: "Generate Overview",
+        description: "Aggregate balances, cashflow, and category breakdowns into a knowledge entry.",
         action: {
-          operation: { key: "pfo.email.sync-threads", version: "1.0.0" }
+          operation: {
+            key: "pfo.openbanking.generate-overview",
+            version: "1.0.0"
+          }
         },
-        requiredIntegrations: ["emailInbound", "primaryVectorDb"],
+        requiredIntegrations: ["primaryOpenBanking"],
+        requiredCapabilities: OPEN_BANKING_CAPABILITIES,
+        retry: {
+          maxAttempts: 3,
+          backoff: "exponential",
+          delayMs: 1500
+        }
+      }
+    ],
+    transitions: []
+  }
+});
+
+// src/workflows/ingest-email-threads.ts
+import {
+  OwnersEnum as OwnersEnum6,
+  StabilityEnum as StabilityEnum6,
+  TagsEnum as TagsEnum6
+} from "@contractspec/lib.contracts-spec";
+import { defineWorkflow as defineWorkflow3 } from "@contractspec/lib.contracts-spec/workflow";
+var ingestEmailThreadsWorkflow = defineWorkflow3({
+  meta: {
+    key: "pfo.workflow.ingest-email-threads",
+    version: "1.0.0",
+    title: "Ingest Email Threads",
+    description: "Synchronises Gmail threads tagged with finance labels and indexes them into operational knowledge spaces.",
+    domain: "communications",
+    owners: [OwnersEnum6.PlatformMessaging],
+    tags: ["gmail", "knowledge", TagsEnum6.Automation],
+    stability: StabilityEnum6.Experimental
+  },
+  definition: {
+    entryStepId: "sync",
+    steps: [
+      {
+        id: "sync",
+        type: "automation",
+        label: "Sync Gmail Threads",
+        description: "Fetches Gmail threads and transforms them into knowledge fragments before vector indexing.",
+        action: {
+          operation: { key: "pfo.email.sync-threads", version: "1.0.0" }
+        },
+        requiredIntegrations: ["emailInbound", "primaryVectorDb"],
         retry: {
           maxAttempts: 3,
           backoff: "exponential",
@@ -1163,165 +1344,155 @@ var ingestEmailThreadsWorkflow = defineWorkflow4({
   }
 });
 
-// src/workflows/sync-openbanking-accounts.ts
-import { defineWorkflow as defineWorkflow5 } from "@contractspec/lib.contracts-spec/workflow";
+// src/workflows/process-uploaded-document.ts
 import {
   OwnersEnum as OwnersEnum7,
   StabilityEnum as StabilityEnum7,
   TagsEnum as TagsEnum7
 } from "@contractspec/lib.contracts-spec";
-var ACCOUNT_CAPABILITY = {
-  key: "openbanking.accounts.read",
-  version: "1.0.0"
-};
-var syncOpenBankingAccountsWorkflow = defineWorkflow5({
+import { defineWorkflow as defineWorkflow4 } from "@contractspec/lib.contracts-spec/workflow";
+var processUploadedDocumentWorkflow = defineWorkflow4({
   meta: {
-    key: "pfo.workflow.sync-openbanking-accounts",
+    key: "pfo.workflow.process-uploaded-document",
     version: "1.0.0",
-    title: "Synchronise Open Banking Accounts",
-    description: "Validates Powens connectivity and synchronises bank account metadata into the canonical ledger.",
+    title: "Process Uploaded Document",
+    description: "Stores an uploaded invoice/contract, queues ingestion, and records any follow-up reminders.",
     domain: "finance",
     owners: [OwnersEnum7.PlatformFinance],
-    tags: ["open-banking", "powens", TagsEnum7.Automation],
+    tags: ["documents", "ingestion", TagsEnum7.Automation],
     stability: StabilityEnum7.Experimental
   },
   definition: {
-    entryStepId: "sync-accounts",
+    entryStepId: "store",
     steps: [
       {
-        id: "sync-accounts",
+        id: "store",
         type: "automation",
-        label: "Sync Accounts",
-        description: "Refresh linked bank accounts via Powens and upsert canonical BankAccount records.",
+        label: "Store and Queue Ingestion",
+        description: "Persist the document to storage and enqueue the knowledge ingestion pipeline.",
         action: {
-          operation: { key: "openbanking.accounts.sync", version: "1.0.0" }
+          operation: { key: "pfo.documents.upload", version: "1.0.0" }
         },
-        requiredIntegrations: ["primaryOpenBanking"],
-        requiredCapabilities: [ACCOUNT_CAPABILITY],
+        requiredIntegrations: ["primaryStorage", "primaryVectorDb"],
         retry: {
           maxAttempts: 3,
           backoff: "exponential",
-          delayMs: 1000
+          delayMs: 500
         }
       },
       {
-        id: "fetch-accounts",
-        type: "automation",
-        label: "Fetch Accounts",
-        description: "Retrieve the latest canonical account snapshot for downstream consumers.",
-        action: {
-          operation: { key: "openbanking.accounts.list", version: "1.0.0" }
-        },
-        requiredIntegrations: ["primaryOpenBanking"],
-        requiredCapabilities: [ACCOUNT_CAPABILITY],
-        retry: {
-          maxAttempts: 2,
-          backoff: "linear",
-          delayMs: 750
-        }
+        id: "review",
+        type: "human",
+        label: "Optional Human Classification",
+        description: "Finance lead can categorise the document while ingestion completes."
       }
     ],
-    transitions: [{ from: "sync-accounts", to: "fetch-accounts" }]
+    transitions: [
+      {
+        from: "store",
+        to: "review"
+      }
+    ]
   }
 });
 
-// src/workflows/sync-openbanking-transactions.ts
-import { defineWorkflow as defineWorkflow6 } from "@contractspec/lib.contracts-spec/workflow";
+// src/workflows/refresh-openbanking-balances.ts
 import {
   OwnersEnum as OwnersEnum8,
   StabilityEnum as StabilityEnum8,
   TagsEnum as TagsEnum8
 } from "@contractspec/lib.contracts-spec";
-var TRANSACTION_CAPABILITY = {
-  key: "openbanking.transactions.read",
+import { defineWorkflow as defineWorkflow5 } from "@contractspec/lib.contracts-spec/workflow";
+var BALANCE_CAPABILITY = {
+  key: "openbanking.balances.read",
   version: "1.0.0"
 };
-var syncOpenBankingTransactionsWorkflow = defineWorkflow6({
+var refreshOpenBankingBalancesWorkflow = defineWorkflow5({
   meta: {
-    key: "pfo.workflow.sync-openbanking-transactions",
+    key: "pfo.workflow.refresh-openbanking-balances",
     version: "1.0.0",
-    title: "Synchronise Open Banking Transactions",
-    description: "Fetches recent transactions from Powens for each linked account and stores them in the canonical ledger.",
+    title: "Refresh Open Banking Balances",
+    description: "Refreshes balances for synced accounts to surface the latest cash positions in dashboards.",
     domain: "finance",
     owners: [OwnersEnum8.PlatformFinance],
     tags: ["open-banking", "powens", TagsEnum8.Automation],
     stability: StabilityEnum8.Experimental
   },
   definition: {
-    entryStepId: "sync-transactions",
+    entryStepId: "refresh-balances",
     steps: [
       {
-        id: "sync-transactions",
+        id: "refresh-balances",
         type: "automation",
-        label: "Sync Transactions",
-        description: "Call the Powens provider to pull incremental transactions for active accounts.",
+        label: "Refresh Balances",
+        description: "Trigger the Powens provider to obtain current and available balances.",
         action: {
-          operation: { key: "openbanking.transactions.sync", version: "1.0.0" }
+          operation: { key: "openbanking.balances.refresh", version: "1.0.0" }
         },
         requiredIntegrations: ["primaryOpenBanking"],
-        requiredCapabilities: [TRANSACTION_CAPABILITY],
+        requiredCapabilities: [BALANCE_CAPABILITY],
         retry: {
-          maxAttempts: 4,
+          maxAttempts: 3,
           backoff: "exponential",
-          delayMs: 1500
+          delayMs: 1000
         }
       },
       {
-        id: "list-transactions",
+        id: "fetch-balances",
         type: "automation",
-        label: "List Transactions",
-        description: "Retrieve the canonical transaction list for reporting and downstream analytics.",
+        label: "Fetch Balances",
+        description: "Load the canonical balance snapshots for downstream workflows and dashboards.",
         action: {
-          operation: { key: "openbanking.transactions.list", version: "1.0.0" }
+          operation: { key: "openbanking.balances.get", version: "1.0.0" }
         },
         requiredIntegrations: ["primaryOpenBanking"],
-        requiredCapabilities: [TRANSACTION_CAPABILITY],
+        requiredCapabilities: [BALANCE_CAPABILITY],
         retry: {
           maxAttempts: 2,
           backoff: "linear",
-          delayMs: 1000
+          delayMs: 750
         }
       }
     ],
-    transitions: [{ from: "sync-transactions", to: "list-transactions" }]
+    transitions: [{ from: "refresh-balances", to: "fetch-balances" }]
   }
 });
 
-// src/workflows/refresh-openbanking-balances.ts
-import { defineWorkflow as defineWorkflow7 } from "@contractspec/lib.contracts-spec/workflow";
+// src/workflows/sync-openbanking-accounts.ts
 import {
   OwnersEnum as OwnersEnum9,
   StabilityEnum as StabilityEnum9,
   TagsEnum as TagsEnum9
 } from "@contractspec/lib.contracts-spec";
-var BALANCE_CAPABILITY = {
-  key: "openbanking.balances.read",
+import { defineWorkflow as defineWorkflow6 } from "@contractspec/lib.contracts-spec/workflow";
+var ACCOUNT_CAPABILITY = {
+  key: "openbanking.accounts.read",
   version: "1.0.0"
 };
-var refreshOpenBankingBalancesWorkflow = defineWorkflow7({
+var syncOpenBankingAccountsWorkflow = defineWorkflow6({
   meta: {
-    key: "pfo.workflow.refresh-openbanking-balances",
+    key: "pfo.workflow.sync-openbanking-accounts",
     version: "1.0.0",
-    title: "Refresh Open Banking Balances",
-    description: "Refreshes balances for synced accounts to surface the latest cash positions in dashboards.",
+    title: "Synchronise Open Banking Accounts",
+    description: "Validates Powens connectivity and synchronises bank account metadata into the canonical ledger.",
     domain: "finance",
     owners: [OwnersEnum9.PlatformFinance],
     tags: ["open-banking", "powens", TagsEnum9.Automation],
     stability: StabilityEnum9.Experimental
   },
   definition: {
-    entryStepId: "refresh-balances",
+    entryStepId: "sync-accounts",
     steps: [
       {
-        id: "refresh-balances",
+        id: "sync-accounts",
         type: "automation",
-        label: "Refresh Balances",
-        description: "Trigger the Powens provider to obtain current and available balances.",
+        label: "Sync Accounts",
+        description: "Refresh linked bank accounts via Powens and upsert canonical BankAccount records.",
         action: {
-          operation: { key: "openbanking.balances.refresh", version: "1.0.0" }
+          operation: { key: "openbanking.accounts.sync", version: "1.0.0" }
         },
         requiredIntegrations: ["primaryOpenBanking"],
-        requiredCapabilities: [BALANCE_CAPABILITY],
+        requiredCapabilities: [ACCOUNT_CAPABILITY],
         retry: {
           maxAttempts: 3,
           backoff: "exponential",
@@ -1329,15 +1500,15 @@ var refreshOpenBankingBalancesWorkflow = defineWorkflow7({
         }
       },
       {
-        id: "fetch-balances",
+        id: "fetch-accounts",
         type: "automation",
-        label: "Fetch Balances",
-        description: "Load the canonical balance snapshots for downstream workflows and dashboards.",
+        label: "Fetch Accounts",
+        description: "Retrieve the latest canonical account snapshot for downstream consumers.",
         action: {
-          operation: { key: "openbanking.balances.get", version: "1.0.0" }
+          operation: { key: "openbanking.accounts.list", version: "1.0.0" }
         },
         requiredIntegrations: ["primaryOpenBanking"],
-        requiredCapabilities: [BALANCE_CAPABILITY],
+        requiredCapabilities: [ACCOUNT_CAPABILITY],
         retry: {
           maxAttempts: 2,
           backoff: "linear",
@@ -1345,300 +1516,130 @@ var refreshOpenBankingBalancesWorkflow = defineWorkflow7({
         }
       }
     ],
-    transitions: [{ from: "refresh-balances", to: "fetch-balances" }]
+    transitions: [{ from: "sync-accounts", to: "fetch-accounts" }]
   }
 });
 
-// src/workflows/generate-openbanking-overview.ts
-import { defineWorkflow as defineWorkflow8 } from "@contractspec/lib.contracts-spec/workflow";
+// src/workflows/sync-openbanking-transactions.ts
 import {
   OwnersEnum as OwnersEnum10,
   StabilityEnum as StabilityEnum10,
   TagsEnum as TagsEnum10
 } from "@contractspec/lib.contracts-spec";
-var OPEN_BANKING_CAPABILITIES = [
-  { key: "openbanking.accounts.read", version: "1.0.0" },
-  { key: "openbanking.transactions.read", version: "1.0.0" },
-  { key: "openbanking.balances.read", version: "1.0.0" }
-];
-var generateOpenBankingOverviewWorkflow = defineWorkflow8({
+import { defineWorkflow as defineWorkflow7 } from "@contractspec/lib.contracts-spec/workflow";
+var TRANSACTION_CAPABILITY = {
+  key: "openbanking.transactions.read",
+  version: "1.0.0"
+};
+var syncOpenBankingTransactionsWorkflow = defineWorkflow7({
   meta: {
-    key: "pfo.workflow.generate-openbanking-overview",
+    key: "pfo.workflow.sync-openbanking-transactions",
     version: "1.0.0",
-    title: "Generate Open Banking Overview",
-    description: "Produces a derived financial overview and stores it in the operational knowledge space.",
+    title: "Synchronise Open Banking Transactions",
+    description: "Fetches recent transactions from Powens for each linked account and stores them in the canonical ledger.",
     domain: "finance",
     owners: [OwnersEnum10.PlatformFinance],
-    tags: ["open-banking", "summary", TagsEnum10.Automation],
+    tags: ["open-banking", "powens", TagsEnum10.Automation],
     stability: StabilityEnum10.Experimental
   },
   definition: {
-    entryStepId: "generate-overview",
+    entryStepId: "sync-transactions",
     steps: [
       {
-        id: "generate-overview",
+        id: "sync-transactions",
         type: "automation",
-        label: "Generate Overview",
-        description: "Aggregate balances, cashflow, and category breakdowns into a knowledge entry.",
+        label: "Sync Transactions",
+        description: "Call the Powens provider to pull incremental transactions for active accounts.",
         action: {
-          operation: {
-            key: "pfo.openbanking.generate-overview",
-            version: "1.0.0"
-          }
+          operation: { key: "openbanking.transactions.sync", version: "1.0.0" }
         },
         requiredIntegrations: ["primaryOpenBanking"],
-        requiredCapabilities: OPEN_BANKING_CAPABILITIES,
+        requiredCapabilities: [TRANSACTION_CAPABILITY],
         retry: {
-          maxAttempts: 3,
+          maxAttempts: 4,
           backoff: "exponential",
           delayMs: 1500
         }
+      },
+      {
+        id: "list-transactions",
+        type: "automation",
+        label: "List Transactions",
+        description: "Retrieve the canonical transaction list for reporting and downstream analytics.",
+        action: {
+          operation: { key: "openbanking.transactions.list", version: "1.0.0" }
+        },
+        requiredIntegrations: ["primaryOpenBanking"],
+        requiredCapabilities: [TRANSACTION_CAPABILITY],
+        retry: {
+          maxAttempts: 2,
+          backoff: "linear",
+          delayMs: 1000
+        }
       }
     ],
-    transitions: []
+    transitions: [{ from: "sync-transactions", to: "list-transactions" }]
   }
 });
-// src/telemetry.ts
+
+// src/workflows/upcoming-payments-reminder.ts
 import {
   OwnersEnum as OwnersEnum11,
   StabilityEnum as StabilityEnum11,
   TagsEnum as TagsEnum11
-} from "@contractspec/lib.contracts-spec/ownership";
-import {
-  OPENBANKING_PII_FIELDS,
-  OPENBANKING_TELEMETRY_EVENTS as OPENBANKING_TELEMETRY_EVENTS2
-} from "@contractspec/lib.contracts-integrations";
-var commonProperties = {
-  tenantId: {
-    type: "string",
-    required: true,
-    description: "Tenant identifier for multi-tenant isolation."
-  },
-  appId: {
-    type: "string",
-    required: true,
-    description: "Application identifier associated with the event."
-  },
-  blueprint: {
-    type: "string",
-    required: true,
-    description: "Blueprint name@version emitting the telemetry."
-  },
-  configVersion: {
-    type: "number",
-    required: true,
-    description: "Resolved app config version when the event was generated."
-  },
-  slotId: {
-    type: "string",
-    required: true,
-    description: "Integration slot identifier (e.g., primaryOpenBanking)."
-  },
-  connectionId: {
-    type: "string",
-    required: true,
-    description: "Integration connection ID used for the sync."
-  }
-};
-function piiSafeString(description) {
-  return {
-    type: "string",
-    description,
-    pii: false
-  };
-}
-var pocketFamilyOfficeTelemetry = {
+} from "@contractspec/lib.contracts-spec";
+import { defineWorkflow as defineWorkflow8 } from "@contractspec/lib.contracts-spec/workflow";
+var upcomingPaymentsReminderWorkflow = defineWorkflow8({
   meta: {
-    key: "pfo.telemetry",
+    key: "pfo.workflow.upcoming-payments-reminder",
     version: "1.0.0",
-    title: "Pocket Family Office Telemetry",
-    description: "Operational telemetry for Pocket Family Office workflows, including Powens open banking syncs.",
+    title: "Schedule Upcoming Payment Reminder",
+    description: "Collects payment metadata and schedules multi-channel reminders for bills that are due soon.",
     domain: "finance",
     owners: [OwnersEnum11.PlatformFinance],
-    tags: ["open-banking", TagsEnum11.Automation],
-    stability: StabilityEnum11.Experimental
-  },
-  config: {
-    defaultRetentionDays: 180,
-    defaultSamplingRate: 1
+    tags: ["payments", "reminders", TagsEnum11.Automation],
+    stability: StabilityEnum11.Beta
   },
-  events: [
-    {
-      key: OPENBANKING_TELEMETRY_EVENTS2.accountsSynced,
-      version: "1.0.0",
-      semantics: {
-        what: "Open banking account synchronisation completed.",
-        why: "Refresh canonical account metadata for reporting and workflows."
-      },
-      privacy: "internal",
-      properties: {
-        ...commonProperties,
-        syncedCount: {
-          type: "number",
-          description: "Number of accounts synced successfully."
-        },
-        failedCount: {
-          type: "number",
-          description: "Number of accounts that failed to sync."
-        },
-        durationMs: {
-          type: "number",
-          description: "Duration of the sync job in milliseconds."
-        }
-      }
-    },
-    {
-      key: OPENBANKING_TELEMETRY_EVENTS2.transactionsSynced,
-      version: "1.0.0",
-      semantics: {
-        what: "Open banking transaction synchronisation completed.",
-        why: "Keep canonical transaction ledger in sync for analytics."
-      },
-      privacy: "internal",
-      properties: {
-        ...commonProperties,
-        accountId: {
-          type: "string",
-          description: "Bank account identifier used during the sync.",
-          pii: false
-        },
-        syncedCount: {
-          type: "number",
-          description: "Number of transactions synced successfully."
-        },
-        failedCount: {
-          type: "number",
-          description: "Number of transactions that failed to sync."
-        },
-        from: {
-          type: "timestamp",
-          description: "Start timestamp for the sync window."
-        },
-        to: {
-          type: "timestamp",
-          description: "End timestamp for the sync window."
-        }
-      }
-    },
-    {
-      key: OPENBANKING_TELEMETRY_EVENTS2.balancesRefreshed,
-      version: "1.0.0",
-      semantics: {
-        what: "Open banking balances refreshed.",
-        why: "Provide accurate cash position for dashboards and alerts."
+  definition: {
+    entryStepId: "collect",
+    steps: [
+      {
+        id: "collect",
+        type: "human",
+        label: "Review Upcoming Bill",
+        description: "Confirm amount, due date, and preferred delivery channels before scheduling reminder."
       },
-      privacy: "internal",
-      properties: {
-        ...commonProperties,
-        accountId: piiSafeString("Bank account identifier."),
-        balanceTypes: {
-          type: "json",
-          description: "Balance types included in the refresh."
+      {
+        id: "schedule",
+        type: "automation",
+        label: "Schedule Reminder",
+        action: {
+          operation: {
+            key: "pfo.reminders.schedule-payment",
+            version: "1.0.0"
+          }
         },
-        refreshedAt: {
-          type: "timestamp",
-          description: "Timestamp when balances were refreshed."
+        requiredIntegrations: [
+          "emailOutbound",
+          "smsNotifications",
+          "calendarScheduling"
+        ],
+        retry: {
+          maxAttempts: 2,
+          backoff: "linear",
+          delayMs: 1000
         }
       }
-    },
-    {
-      key: OPENBANKING_TELEMETRY_EVENTS2.overviewGenerated,
-      version: "1.0.0",
-      semantics: {
-        what: "Derived financial overview generated.",
-        why: "Persist cashflow and category summaries into knowledge space."
-      },
-      privacy: "internal",
-      properties: {
-        ...commonProperties,
-        knowledgeEntryId: piiSafeString("Identifier of the knowledge document containing the overview."),
-        period: {
-          type: "string",
-          description: "Aggregation period used (week, month, quarter)."
-        },
-        periodStart: {
-          type: "timestamp",
-          description: "Start timestamp for the aggregation window."
-        },
-        periodEnd: {
-          type: "timestamp",
-          description: "End timestamp for the aggregation window."
-        }
-      },
-      tags: ["knowledge", "analytics"]
-    }
-  ]
-};
-var OPENBANKING_SENSITIVE_FIELDS = OPENBANKING_PII_FIELDS;
-
-// src/pocket-family-office.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var PocketFamilyOfficeFeature = defineFeature({
-  meta: {
-    key: "pocket-family-office",
-    version: "1.0.0",
-    title: "Pocket Family Office",
-    description: "Personal finance automation with document ingestion, open banking, and AI summaries",
-    domain: "finance",
-    owners: ["@platform.finance"],
-    tags: [
-      "finance",
-      "open-banking",
-      "documents",
-      "automation",
-      "family-office"
     ],
-    stability: "experimental"
-  },
-  operations: [
-    { key: "pfo.documents.upload", version: "1.0.0" },
-    { key: "pfo.reminders.schedule-payment", version: "1.0.0" },
-    { key: "pfo.summary.generate", version: "1.0.0" },
-    { key: "pfo.email.sync-threads", version: "1.0.0" },
-    { key: "pfo.summary.dispatch", version: "1.0.0" },
-    { key: "pfo.openbanking.generate-overview", version: "1.0.0" }
-  ],
-  events: [],
-  presentations: [],
-  opToPresentation: [],
-  presentationsTargets: [],
-  capabilities: {
-    provides: [{ key: "pocket-family-office", version: "1.0.0" }],
-    requires: [
-      { key: "identity", version: "1.0.0" },
-      { key: "openbanking", version: "1.0.0" }
+    transitions: [
+      {
+        from: "collect",
+        to: "schedule",
+        condition: "output?.confirmed === true",
+        label: "Reminder confirmed"
+      }
     ]
-  },
-  workflows: [
-    { key: "pfo.workflow.sync-openbanking-accounts", version: "1.0.0" },
-    { key: "pfo.workflow.sync-openbanking-transactions", version: "1.0.0" },
-    { key: "pfo.workflow.refresh-openbanking-balances", version: "1.0.0" },
-    { key: "pfo.workflow.generate-openbanking-overview", version: "1.0.0" },
-    { key: "pfo.workflow.process-uploaded-document", version: "1.0.0" },
-    { key: "pfo.workflow.upcoming-payments-reminder", version: "1.0.0" },
-    { key: "pfo.workflow.generate-financial-summary", version: "1.0.0" },
-    { key: "pfo.workflow.ingest-email-threads", version: "1.0.0" }
-  ],
-  knowledge: [
-    { key: "knowledge.financial-docs", version: "1.0.0" },
-    { key: "knowledge.email-threads", version: "1.0.0" },
-    { key: "knowledge.financial-overview", version: "1.0.0" }
-  ],
-  telemetry: [{ key: "pfo.telemetry", version: "1.0.0" }],
-  policies: [{ key: "pfo.policy.tenancy", version: "1.0.0" }],
-  integrations: [
-    { key: "pfo.integration.openbanking", version: "1.0.0" },
-    { key: "pfo.integration.llm", version: "1.0.0" }
-  ],
-  jobs: [
-    { key: "pfo.job.doc-processing", version: "1.0.0" },
-    { key: "pfo.job.reminder-dispatch", version: "1.0.0" }
-  ],
-  docs: [
-    "docs.examples.pocket-family-office.goal",
-    "docs.examples.pocket-family-office.usage",
-    "docs.examples.pocket-family-office.reference"
-  ]
+  }
 });
 export {
   uploadDocumentContract,