@ottochain/sdk 1.6.0 → 1.7.0-beta.2

package/dist/types/apps/corporate/index.d.ts

@@ -9,19 +9,4027 @@
  *   EntityType,
  *   EntityState,
  *   CorporateEntity,
- *   getCorporateDefinition
+ *   getCorporateDefinition,
+ *   CORPORATE_DEFINITIONS
  * } from '@ottochain/sdk/apps/corporate';
  *
- * const entityDef = getCorporateDefinition('Entity');
- * const boardDef = getCorporateDefinition('Board');
+ * const entityDef = getCorporateDefinition('entity');
+ * const boardDef = getCorporateDefinition('board');
  * ```
  *
  * @packageDocumentation
  */
 export { EntityType, EntityState, DirectorStatus, OfficerStatus, BoardMeetingType, ResolutionStatus, Jurisdiction, ShareClass, CorporateEntity, RegisteredAgent, Incorporator, ShareStructure, CorporateBoard, Director, SeatInfo, QuorumRules, BoardMeeting, MeetingAttendee, CorporateOfficers, Officer, OfficerAction, CorporateShareholders, Shareholder, ShareHolding, CorporateResolution, ResolutionVote, CorporateSecurities, SecurityIssuance, SecurityTransfer, CorporateCompliance, FilingRecord, ComplianceRequirement, CreateEntityRequest, AppointDirectorRequest, IssueSharesRequest, ProposeResolutionRequest, entityTypeFromJSON, entityTypeToJSON, entityStateFromJSON, entityStateToJSON, directorStatusFromJSON, directorStatusToJSON, officerStatusFromJSON, officerStatusToJSON, boardMeetingTypeFromJSON, boardMeetingTypeToJSON, resolutionStatusFromJSON, resolutionStatusToJSON, } from '../../generated/ottochain/apps/corporate/v1/corporate.js';
-export type CorporateDefinitionType = 'Entity' | 'Board' | 'Shareholders' | 'Officers' | 'Securities' | 'Compliance' | 'Bylaws' | 'Committee' | 'Proxy' | 'Resolution';
-export declare const CORPORATE_DEFINITIONS: Record<CorporateDefinitionType, unknown>;
+import { corpEntityDef, corpBoardDef, corpShareholdersDef, corpSecuritiesDef } from './state-machines/index.js';
+export { corpEntityDef, corpBoardDef, corpShareholdersDef, corpSecuritiesDef, };
+/** All corporate state machine definitions */
+export declare const CORPORATE_DEFINITIONS: {
+    readonly entity: {
+        readonly $schema: "https://ottochain.dev/schemas/state-machine-v1.json";
+        readonly name: "CorpEntity";
+        readonly version: "1.0.0";
+        readonly category: "corporate-governance";
+        readonly description: "Master corporate record tracking the lifecycle of a business entity from incorporation through dissolution. Manages legal identity, share structure, and corporate status.";
+        readonly context: {
+            readonly entityId: {
+                readonly type: "string";
+                readonly description: "Unique identifier for this corporate entity";
+            };
+            readonly legalName: {
+                readonly type: "string";
+                readonly description: "Full legal name of the corporation";
+            };
+            readonly tradeName: {
+                readonly type: "string";
+                readonly nullable: true;
+                readonly description: "DBA or trade name if different";
+            };
+            readonly entityType: {
+                readonly type: "string";
+                readonly enum: readonly ["C_CORP", "S_CORP", "B_CORP", "LLC", "LP", "LLP"];
+                readonly description: "Legal entity type";
+            };
+            readonly jurisdiction: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly state: {
+                        readonly type: "string";
+                        readonly description: "State of incorporation (e.g., DE, NV, WY)";
+                    };
+                    readonly country: {
+                        readonly type: "string";
+                        readonly default: "USA";
+                    };
+                    readonly foreignQualifications: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "States where foreign qualified to do business";
+                    };
+                };
+            };
+            readonly formationDate: {
+                readonly type: "string";
+                readonly format: "date";
+                readonly description: "Date of incorporation";
+            };
+            readonly fiscalYearEnd: {
+                readonly type: "string";
+                readonly description: "Fiscal year end (MM-DD format)";
+            };
+            readonly registeredAgent: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly name: {
+                        readonly type: "string";
+                    };
+                    readonly address: {
+                        readonly type: "object";
+                    };
+                    readonly phone: {
+                        readonly type: "string";
+                    };
+                    readonly email: {
+                        readonly type: "string";
+                    };
+                    readonly effectiveDate: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                };
+            };
+            readonly principalOffice: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly street: {
+                        readonly type: "string";
+                    };
+                    readonly city: {
+                        readonly type: "string";
+                    };
+                    readonly state: {
+                        readonly type: "string";
+                    };
+                    readonly zip: {
+                        readonly type: "string";
+                    };
+                    readonly country: {
+                        readonly type: "string";
+                        readonly default: "USA";
+                    };
+                };
+            };
+            readonly shareStructure: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly classes: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly className: {
+                                    readonly type: "string";
+                                    readonly description: "e.g., Common, Series A Preferred";
+                                };
+                                readonly classId: {
+                                    readonly type: "string";
+                                };
+                                readonly authorized: {
+                                    readonly type: "integer";
+                                    readonly description: "Total shares authorized";
+                                };
+                                readonly issued: {
+                                    readonly type: "integer";
+                                    readonly description: "Shares currently issued";
+                                };
+                                readonly outstanding: {
+                                    readonly type: "integer";
+                                    readonly description: "Issued minus treasury";
+                                };
+                                readonly treasury: {
+                                    readonly type: "integer";
+                                    readonly description: "Shares held by company";
+                                };
+                                readonly parValue: {
+                                    readonly type: "number";
+                                    readonly description: "Par value per share";
+                                };
+                                readonly votingRights: {
+                                    readonly type: "boolean";
+                                    readonly description: "Whether class has voting rights";
+                                };
+                                readonly votesPerShare: {
+                                    readonly type: "number";
+                                    readonly default: 1;
+                                };
+                                readonly liquidationPreference: {
+                                    readonly type: "number";
+                                    readonly nullable: true;
+                                    readonly description: "Liquidation preference multiple";
+                                };
+                                readonly dividendRate: {
+                                    readonly type: "number";
+                                    readonly nullable: true;
+                                    readonly description: "Annual dividend rate %";
+                                };
+                                readonly convertible: {
+                                    readonly type: "boolean";
+                                    readonly default: false;
+                                };
+                                readonly conversionRatio: {
+                                    readonly type: "number";
+                                    readonly nullable: true;
+                                };
+                                readonly antidilution: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["NONE", "BROAD_BASED", "NARROW_BASED", "FULL_RATCHET"];
+                                    readonly nullable: true;
+                                };
+                            };
+                        };
+                    };
+                    readonly totalAuthorized: {
+                        readonly type: "integer";
+                        readonly description: "Sum of all authorized shares";
+                    };
+                    readonly totalIssued: {
+                        readonly type: "integer";
+                    };
+                    readonly totalOutstanding: {
+                        readonly type: "integer";
+                    };
+                };
+            };
+            readonly incorporators: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly name: {
+                            readonly type: "string";
+                        };
+                        readonly address: {
+                            readonly type: "object";
+                        };
+                        readonly signatureDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                        };
+                    };
+                };
+            };
+            readonly ein: {
+                readonly type: "string";
+                readonly nullable: true;
+                readonly description: "Federal EIN";
+            };
+            readonly stateIds: {
+                readonly type: "object";
+                readonly additionalProperties: {
+                    readonly type: "string";
+                };
+                readonly description: "State-specific entity IDs keyed by state code";
+            };
+            readonly suspensionReason: {
+                readonly type: "string";
+                readonly nullable: true;
+            };
+            readonly suspensionDate: {
+                readonly type: "string";
+                readonly format: "date";
+                readonly nullable: true;
+            };
+            readonly dissolutionDate: {
+                readonly type: "string";
+                readonly format: "date";
+                readonly nullable: true;
+            };
+            readonly dissolutionReason: {
+                readonly type: "string";
+                readonly nullable: true;
+            };
+            readonly charterAmendments: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly amendmentId: {
+                            readonly type: "string";
+                        };
+                        readonly description: {
+                            readonly type: "string";
+                        };
+                        readonly effectiveDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                        };
+                        readonly resolutionRef: {
+                            readonly type: "string";
+                            readonly description: "Reference to approving resolution";
+                        };
+                        readonly filedDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                        };
+                    };
+                };
+            };
+            readonly createdAt: {
+                readonly type: "string";
+                readonly format: "date-time";
+            };
+            readonly updatedAt: {
+                readonly type: "string";
+                readonly format: "date-time";
+            };
+        };
+        readonly states: {
+            readonly INCORPORATING: {
+                readonly description: "Initial state during formation process. Articles filed but not yet approved by state.";
+                readonly metadata: null;
+            };
+            readonly ACTIVE: {
+                readonly description: "Corporation is in good standing and authorized to conduct business.";
+                readonly metadata: null;
+            };
+            readonly SUSPENDED: {
+                readonly description: "Corporate powers suspended due to compliance failure (tax, filings, etc). Can be reinstated.";
+                readonly metadata: null;
+            };
+            readonly DISSOLVED: {
+                readonly description: "Corporation has been legally dissolved. Terminal state.";
+                readonly metadata: null;
+                readonly terminal: true;
+            };
+        };
+        readonly initialState: "INCORPORATING";
+        readonly transitions: {
+            readonly incorporate: {
+                readonly from: "INCORPORATING";
+                readonly to: "ACTIVE";
+                readonly description: "State approves articles of incorporation, corporation comes into existence";
+                readonly event: {
+                    readonly name: "incorporate";
+                    readonly payload: {
+                        readonly approvalDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly stateFileNumber: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly certificateOfIncorporation: {
+                            readonly type: "string";
+                            readonly description: "Document reference";
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "hasRequiredFormationDocs";
+                    readonly description: "Articles of incorporation filed, incorporators signed, registered agent designated";
+                    readonly expression: "context.legalName != null && context.jurisdiction.state != null && context.registeredAgent != null && context.incorporators.length > 0";
+                }, {
+                    readonly name: "hasAuthorizedShares";
+                    readonly description: "At least one share class authorized";
+                    readonly expression: "context.shareStructure.classes.length > 0 && context.shareStructure.totalAuthorized > 0";
+                }];
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "formationDate";
+                    readonly value: "{{ event.approvalDate }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "stateIds.{{ context.jurisdiction.state }}";
+                    readonly value: "{{ event.stateFileNumber }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "updatedAt";
+                    readonly value: "{{ now() }}";
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "CORPORATION_FORMED";
+                    readonly payload: {
+                        readonly entityId: "{{ context.entityId }}";
+                        readonly legalName: "{{ context.legalName }}";
+                        readonly jurisdiction: "{{ context.jurisdiction.state }}";
+                        readonly formationDate: "{{ event.approvalDate }}";
+                    };
+                }];
+            };
+            readonly amend_charter: {
+                readonly from: "ACTIVE";
+                readonly to: "ACTIVE";
+                readonly description: "Amend the certificate/articles of incorporation (requires shareholder approval for most amendments)";
+                readonly event: {
+                    readonly name: "amend_charter";
+                    readonly payload: {
+                        readonly amendmentId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly description: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly amendmentType: {
+                            readonly type: "string";
+                            readonly enum: readonly ["NAME_CHANGE", "SHARE_AUTHORIZATION", "PURPOSE_CHANGE", "OTHER"];
+                            readonly required: true;
+                        };
+                        readonly resolutionRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                            readonly description: "Reference to board/shareholder resolution";
+                        };
+                        readonly effectiveDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly filedDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly newShareAuthorization: {
+                            readonly type: "object";
+                            readonly nullable: true;
+                            readonly description: "If increasing/changing authorized shares";
+                        };
+                        readonly newLegalName: {
+                            readonly type: "string";
+                            readonly nullable: true;
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "hasApprovedResolution";
+                    readonly description: "Charter amendment must be backed by an executed resolution";
+                    readonly expression: "event.resolutionRef != null";
+                    readonly crossMachine: {
+                        readonly machine: "corporate-resolution";
+                        readonly instanceRef: "{{ event.resolutionRef }}";
+                        readonly requiredState: "EXECUTED";
+                    };
+                }];
+                readonly effects: readonly [{
+                    readonly type: "APPEND_ARRAY";
+                    readonly path: "charterAmendments";
+                    readonly value: {
+                        readonly amendmentId: "{{ event.amendmentId }}";
+                        readonly description: "{{ event.description }}";
+                        readonly effectiveDate: "{{ event.effectiveDate }}";
+                        readonly resolutionRef: "{{ event.resolutionRef }}";
+                        readonly filedDate: "{{ event.filedDate }}";
+                    };
+                }, {
+                    readonly type: "CONDITIONAL";
+                    readonly condition: "event.newLegalName != null";
+                    readonly then: {
+                        readonly type: "SET_CONTEXT";
+                        readonly path: "legalName";
+                        readonly value: "{{ event.newLegalName }}";
+                    };
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "updatedAt";
+                    readonly value: "{{ now() }}";
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "CHARTER_AMENDED";
+                    readonly payload: {
+                        readonly entityId: "{{ context.entityId }}";
+                        readonly amendmentId: "{{ event.amendmentId }}";
+                        readonly amendmentType: "{{ event.amendmentType }}";
+                    };
+                }];
+            };
+            readonly update_share_class: {
+                readonly from: "ACTIVE";
+                readonly to: "ACTIVE";
+                readonly description: "Update authorized shares for an existing class or add new class (requires charter amendment)";
+                readonly event: {
+                    readonly name: "update_share_class";
+                    readonly payload: {
+                        readonly classId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly className: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly authorized: {
+                            readonly type: "integer";
+                            readonly required: true;
+                        };
+                        readonly parValue: {
+                            readonly type: "number";
+                            readonly required: true;
+                        };
+                        readonly votingRights: {
+                            readonly type: "boolean";
+                            readonly required: true;
+                        };
+                        readonly votesPerShare: {
+                            readonly type: "number";
+                            readonly default: 1;
+                        };
+                        readonly liquidationPreference: {
+                            readonly type: "number";
+                            readonly nullable: true;
+                        };
+                        readonly dividendRate: {
+                            readonly type: "number";
+                            readonly nullable: true;
+                        };
+                        readonly convertible: {
+                            readonly type: "boolean";
+                            readonly default: false;
+                        };
+                        readonly charterAmendmentRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "charterAmended";
+                    readonly description: "Share class changes require charter amendment to be filed";
+                    readonly expression: "context.charterAmendments.some(a => a.amendmentId === event.charterAmendmentRef)";
+                }];
+                readonly effects: readonly [{
+                    readonly type: "UPSERT_ARRAY";
+                    readonly path: "shareStructure.classes";
+                    readonly matchKey: "classId";
+                    readonly matchValue: "{{ event.classId }}";
+                    readonly value: {
+                        readonly classId: "{{ event.classId }}";
+                        readonly className: "{{ event.className }}";
+                        readonly authorized: "{{ event.authorized }}";
+                        readonly issued: 0;
+                        readonly outstanding: 0;
+                        readonly treasury: 0;
+                        readonly parValue: "{{ event.parValue }}";
+                        readonly votingRights: "{{ event.votingRights }}";
+                        readonly votesPerShare: "{{ event.votesPerShare }}";
+                        readonly liquidationPreference: "{{ event.liquidationPreference }}";
+                        readonly dividendRate: "{{ event.dividendRate }}";
+                        readonly convertible: "{{ event.convertible }}";
+                    };
+                }, {
+                    readonly type: "COMPUTE";
+                    readonly path: "shareStructure.totalAuthorized";
+                    readonly expression: "context.shareStructure.classes.reduce((sum, c) => sum + c.authorized, 0)";
+                }];
+            };
+            readonly update_registered_agent: {
+                readonly from: "ACTIVE";
+                readonly to: "ACTIVE";
+                readonly description: "Change the registered agent on file with the state";
+                readonly event: {
+                    readonly name: "update_registered_agent";
+                    readonly payload: {
+                        readonly name: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly address: {
+                            readonly type: "object";
+                            readonly required: true;
+                        };
+                        readonly phone: {
+                            readonly type: "string";
+                        };
+                        readonly email: {
+                            readonly type: "string";
+                        };
+                        readonly effectiveDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly filingConfirmation: {
+                            readonly type: "string";
+                            readonly description: "State filing confirmation number";
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "registeredAgent";
+                    readonly value: {
+                        readonly name: "{{ event.name }}";
+                        readonly address: "{{ event.address }}";
+                        readonly phone: "{{ event.phone }}";
+                        readonly email: "{{ event.email }}";
+                        readonly effectiveDate: "{{ event.effectiveDate }}";
+                    };
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "REGISTERED_AGENT_CHANGED";
+                    readonly payload: {
+                        readonly entityId: "{{ context.entityId }}";
+                        readonly newAgent: "{{ event.name }}";
+                        readonly effectiveDate: "{{ event.effectiveDate }}";
+                    };
+                }];
+            };
+            readonly suspend: {
+                readonly from: "ACTIVE";
+                readonly to: "SUSPENDED";
+                readonly description: "State suspends corporate powers (typically for tax/filing noncompliance)";
+                readonly event: {
+                    readonly name: "suspend";
+                    readonly payload: {
+                        readonly reason: {
+                            readonly type: "string";
+                            readonly enum: readonly ["FRANCHISE_TAX_DELINQUENT", "ANNUAL_REPORT_MISSING", "REGISTERED_AGENT_LAPSE", "ADMINISTRATIVE", "OTHER"];
+                            readonly required: true;
+                        };
+                        readonly suspensionDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly stateNotice: {
+                            readonly type: "string";
+                            readonly description: "Reference to state notice";
+                        };
+                        readonly cureDeadline: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly nullable: true;
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "suspensionReason";
+                    readonly value: "{{ event.reason }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "suspensionDate";
+                    readonly value: "{{ event.suspensionDate }}";
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "CORPORATION_SUSPENDED";
+                    readonly payload: {
+                        readonly entityId: "{{ context.entityId }}";
+                        readonly reason: "{{ event.reason }}";
+                        readonly cureDeadline: "{{ event.cureDeadline }}";
+                    };
+                }];
+            };
+            readonly reinstate: {
+                readonly from: "SUSPENDED";
+                readonly to: "ACTIVE";
+                readonly description: "Cure deficiencies and reinstate corporate powers";
+                readonly event: {
+                    readonly name: "reinstate";
+                    readonly payload: {
+                        readonly reinstatementDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly curativeActions: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                            readonly description: "List of actions taken to cure";
+                            readonly required: true;
+                        };
+                        readonly stateConfirmation: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly penaltiesPaid: {
+                            readonly type: "number";
+                            readonly nullable: true;
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "suspensionReason";
+                    readonly value: null;
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "suspensionDate";
+                    readonly value: null;
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "CORPORATION_REINSTATED";
+                    readonly payload: {
+                        readonly entityId: "{{ context.entityId }}";
+                        readonly reinstatementDate: "{{ event.reinstatementDate }}";
+                    };
+                }];
+            };
+            readonly dissolve_voluntary: {
+                readonly from: "ACTIVE";
+                readonly to: "DISSOLVED";
+                readonly description: "Voluntary dissolution approved by board and shareholders";
+                readonly event: {
+                    readonly name: "dissolve_voluntary";
+                    readonly payload: {
+                        readonly dissolutionDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly boardResolutionRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly shareholderResolutionRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly windingUpPlan: {
+                            readonly type: "string";
+                            readonly description: "Reference to winding up plan";
+                        };
+                        readonly certificateOfDissolution: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "boardApproved";
+                    readonly description: "Board must approve dissolution";
+                    readonly crossMachine: {
+                        readonly machine: "corporate-resolution";
+                        readonly instanceRef: "{{ event.boardResolutionRef }}";
+                        readonly requiredState: "EXECUTED";
+                    };
+                }, {
+                    readonly name: "shareholdersApproved";
+                    readonly description: "Shareholders must approve dissolution (typically majority or supermajority)";
+                    readonly crossMachine: {
+                        readonly machine: "corporate-resolution";
+                        readonly instanceRef: "{{ event.shareholderResolutionRef }}";
+                        readonly requiredState: "EXECUTED";
+                    };
+                }];
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "dissolutionDate";
+                    readonly value: "{{ event.dissolutionDate }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "dissolutionReason";
+                    readonly value: "VOLUNTARY";
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "CORPORATION_DISSOLVED";
+                    readonly payload: {
+                        readonly entityId: "{{ context.entityId }}";
+                        readonly dissolutionType: "VOLUNTARY";
+                        readonly dissolutionDate: "{{ event.dissolutionDate }}";
+                    };
+                }];
+            };
+            readonly dissolve_administrative: {
+                readonly from: "SUSPENDED";
+                readonly to: "DISSOLVED";
+                readonly description: "Administrative dissolution by state after prolonged suspension";
+                readonly event: {
+                    readonly name: "dissolve_administrative";
+                    readonly payload: {
+                        readonly dissolutionDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly stateOrder: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly reason: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "dissolutionDate";
+                    readonly value: "{{ event.dissolutionDate }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "dissolutionReason";
+                    readonly value: "ADMINISTRATIVE: {{ event.reason }}";
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "CORPORATION_DISSOLVED";
+                    readonly payload: {
+                        readonly entityId: "{{ context.entityId }}";
+                        readonly dissolutionType: "ADMINISTRATIVE";
+                        readonly dissolutionDate: "{{ event.dissolutionDate }}";
+                    };
+                }];
+            };
+        };
+        readonly crossMachineRefs: {
+            readonly board: {
+                readonly machine: "corporate-board";
+                readonly description: "Board of directors for this entity";
+                readonly foreignKey: "entityId";
+            };
+            readonly officers: {
+                readonly machine: "corporate-officers";
+                readonly description: "Executive officers for this entity";
+                readonly foreignKey: "entityId";
+            };
+            readonly bylaws: {
+                readonly machine: "corporate-bylaws";
+                readonly description: "Governing bylaws for this entity";
+                readonly foreignKey: "entityId";
+            };
+            readonly shareholders: {
+                readonly machine: "corporate-shareholders";
+                readonly description: "Shareholder meeting instances";
+                readonly foreignKey: "entityId";
+            };
+            readonly securities: {
+                readonly machine: "corporate-securities";
+                readonly description: "Stock issuance records";
+                readonly foreignKey: "entityId";
+            };
+            readonly compliance: {
+                readonly machine: "corporate-compliance";
+                readonly description: "Regulatory compliance tracking";
+                readonly foreignKey: "entityId";
+            };
+        };
+        readonly metadata: {
+            readonly author: "OttoChain";
+            readonly license: "MIT";
+            readonly tags: readonly ["corporate", "governance", "entity", "formation"];
+            readonly documentation: "https://ottochain.dev/docs/corporate/entity";
+        };
+    };
+    readonly board: {
+        readonly $schema: "https://ottochain.dev/schemas/state-machine-v1.json";
+        readonly name: "CorpBoard";
+        readonly version: "1.0.0";
+        readonly category: "corporate-governance";
+        readonly description: "Board of directors state machine managing director seats, meetings, quorum, and formal board actions. Supports staggered boards with classified directors.";
+        readonly context: {
+            readonly boardId: {
+                readonly type: "string";
+                readonly description: "Unique identifier for this board instance";
+            };
+            readonly entityId: {
+                readonly type: "string";
+                readonly description: "Reference to parent corporate-entity";
+            };
+            readonly directors: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly directorId: {
+                            readonly type: "string";
+                        };
+                        readonly name: {
+                            readonly type: "string";
+                        };
+                        readonly email: {
+                            readonly type: "string";
+                        };
+                        readonly termStart: {
+                            readonly type: "string";
+                            readonly format: "date";
+                        };
+                        readonly termEnd: {
+                            readonly type: "string";
+                            readonly format: "date";
+                        };
+                        readonly class: {
+                            readonly type: "string";
+                            readonly enum: readonly ["CLASS_I", "CLASS_II", "CLASS_III", "UNCLASSIFIED"];
+                            readonly description: "For staggered boards";
+                        };
+                        readonly status: {
+                            readonly type: "string";
+                            readonly enum: readonly ["ACTIVE", "RESIGNED", "REMOVED", "TERM_EXPIRED"];
+                        };
+                        readonly isIndependent: {
+                            readonly type: "boolean";
+                            readonly description: "Independence under applicable rules";
+                        };
+                        readonly isChair: {
+                            readonly type: "boolean";
+                            readonly default: false;
+                        };
+                        readonly isLeadIndependent: {
+                            readonly type: "boolean";
+                            readonly default: false;
+                        };
+                        readonly committees: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                            readonly description: "Committee memberships by committee ID";
+                        };
+                        readonly electedBy: {
+                            readonly type: "string";
+                            readonly description: "Resolution reference for election";
+                        };
+                        readonly compensationAgreementRef: {
+                            readonly type: "string";
+                            readonly nullable: true;
+                        };
+                    };
+                };
+            };
+            readonly seats: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly authorized: {
+                        readonly type: "integer";
+                        readonly description: "Number of board seats authorized by bylaws";
+                    };
+                    readonly filled: {
+                        readonly type: "integer";
+                    };
+                    readonly vacant: {
+                        readonly type: "integer";
+                    };
+                };
+            };
+            readonly boardStructure: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly isClassified: {
+                        readonly type: "boolean";
+                        readonly description: "Whether board has staggered terms";
+                    };
+                    readonly termYears: {
+                        readonly type: "integer";
+                        readonly default: 1;
+                        readonly description: "Director term length";
+                    };
+                    readonly classTerms: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly CLASS_I: {
+                                readonly type: "integer";
+                            };
+                            readonly CLASS_II: {
+                                readonly type: "integer";
+                            };
+                            readonly CLASS_III: {
+                                readonly type: "integer";
+                            };
+                        };
+                    };
+                };
+            };
+            readonly quorumRules: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["MAJORITY", "SUPERMAJORITY", "FIXED_NUMBER"];
+                        readonly default: "MAJORITY";
+                    };
+                    readonly threshold: {
+                        readonly type: "number";
+                        readonly description: "Fraction for majority/super, or count for fixed";
+                    };
+                    readonly minimumRequired: {
+                        readonly type: "integer";
+                        readonly description: "Absolute minimum regardless of formula";
+                    };
+                };
+            };
+            readonly votingRules: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly standardApproval: {
+                        readonly type: "string";
+                        readonly enum: readonly ["MAJORITY_PRESENT", "MAJORITY_FULL_BOARD"];
+                        readonly default: "MAJORITY_PRESENT";
+                    };
+                    readonly supermajorityMatters: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "Action types requiring supermajority";
+                    };
+                    readonly supermajorityThreshold: {
+                        readonly type: "number";
+                        readonly default: 0.6667;
+                    };
+                };
+            };
+            readonly currentMeeting: {
+                readonly type: "object";
+                readonly nullable: true;
+                readonly properties: {
+                    readonly meetingId: {
+                        readonly type: "string";
+                    };
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["REGULAR", "SPECIAL", "ANNUAL", "ORGANIZATIONAL"];
+                    };
+                    readonly scheduledDate: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly location: {
+                        readonly type: "string";
+                    };
+                    readonly isVirtual: {
+                        readonly type: "boolean";
+                    };
+                    readonly calledBy: {
+                        readonly type: "string";
+                    };
+                    readonly noticeDate: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly agenda: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly attendees: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly directorId: {
+                                    readonly type: "string";
+                                };
+                                readonly present: {
+                                    readonly type: "boolean";
+                                };
+                                readonly arrivedAt: {
+                                    readonly type: "string";
+                                    readonly format: "date-time";
+                                    readonly nullable: true;
+                                };
+                                readonly departedAt: {
+                                    readonly type: "string";
+                                    readonly format: "date-time";
+                                    readonly nullable: true;
+                                };
+                                readonly viaProxy: {
+                                    readonly type: "boolean";
+                                    readonly default: false;
+                                };
+                            };
+                        };
+                    };
+                    readonly quorumPresent: {
+                        readonly type: "boolean";
+                    };
+                    readonly quorumCount: {
+                        readonly type: "integer";
+                    };
+                    readonly openedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly nullable: true;
+                    };
+                    readonly closedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly nullable: true;
+                    };
+                    readonly minutesRef: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                };
+            };
+            readonly meetingHistory: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly meetingId: {
+                            readonly type: "string";
+                        };
+                        readonly type: {
+                            readonly type: "string";
+                        };
+                        readonly date: {
+                            readonly type: "string";
+                            readonly format: "date";
+                        };
+                        readonly quorumAchieved: {
+                            readonly type: "boolean";
+                        };
+                        readonly attendeeCount: {
+                            readonly type: "integer";
+                        };
+                        readonly resolutionsPassed: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly minutesRef: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+            };
+            readonly createdAt: {
+                readonly type: "string";
+                readonly format: "date-time";
+            };
+            readonly updatedAt: {
+                readonly type: "string";
+                readonly format: "date-time";
+            };
+        };
+        readonly states: {
+            readonly ACTIVE: {
+                readonly description: "Board is constituted and able to conduct business. Default state between meetings.";
+                readonly metadata: null;
+            };
+            readonly IN_MEETING: {
+                readonly description: "Board meeting is in session with quorum present. Can take formal actions.";
+                readonly metadata: null;
+            };
+            readonly QUORUM_LOST: {
+                readonly description: "Meeting in progress but quorum lost due to departures. No further action until quorum restored or adjourned.";
+                readonly metadata: null;
+            };
+        };
+        readonly initialState: "ACTIVE";
+        readonly transitions: {
+            readonly elect_director: {
+                readonly from: "ACTIVE";
+                readonly to: "ACTIVE";
+                readonly description: "Add a new director to the board (election typically done at shareholder meeting or by board to fill vacancy)";
+                readonly event: {
+                    readonly name: "elect_director";
+                    readonly payload: {
+                        readonly directorId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly name: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly email: {
+                            readonly type: "string";
+                        };
+                        readonly termStart: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly termEnd: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly class: {
+                            readonly type: "string";
+                            readonly enum: readonly ["CLASS_I", "CLASS_II", "CLASS_III", "UNCLASSIFIED"];
+                        };
+                        readonly isIndependent: {
+                            readonly type: "boolean";
+                            readonly required: true;
+                        };
+                        readonly electionResolutionRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                            readonly description: "Shareholder or board resolution";
+                        };
+                        readonly isFillingVacancy: {
+                            readonly type: "boolean";
+                            readonly default: false;
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "hasAvailableSeat";
+                    readonly description: "Must have vacant seat or be filling expired term";
+                    readonly expression: "context.seats.vacant > 0 || event.isFillingVacancy";
+                }, {
+                    readonly name: "hasElectionResolution";
+                    readonly description: "Must have valid election resolution (shareholder for annual, board for vacancy fill)";
+                    readonly expression: "event.electionResolutionRef != null";
+                }, {
+                    readonly name: "notAlreadyDirector";
+                    readonly description: "Person not already serving on board";
+                    readonly expression: "!context.directors.some(d => d.directorId === event.directorId && d.status === 'ACTIVE')";
+                }];
+                readonly effects: readonly [{
+                    readonly type: "APPEND_ARRAY";
+                    readonly path: "directors";
+                    readonly value: {
+                        readonly directorId: "{{ event.directorId }}";
+                        readonly name: "{{ event.name }}";
+                        readonly email: "{{ event.email }}";
+                        readonly termStart: "{{ event.termStart }}";
+                        readonly termEnd: "{{ event.termEnd }}";
+                        readonly class: "{{ event.class }}";
+                        readonly status: "ACTIVE";
+                        readonly isIndependent: "{{ event.isIndependent }}";
+                        readonly isChair: false;
+                        readonly isLeadIndependent: false;
+                        readonly committees: readonly [];
+                        readonly electedBy: "{{ event.electionResolutionRef }}";
+                    };
+                }, {
+                    readonly type: "INCREMENT";
+                    readonly path: "seats.filled";
+                    readonly amount: 1;
+                }, {
+                    readonly type: "DECREMENT";
+                    readonly path: "seats.vacant";
+                    readonly amount: 1;
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "DIRECTOR_ELECTED";
+                    readonly payload: {
+                        readonly boardId: "{{ context.boardId }}";
+                        readonly directorId: "{{ event.directorId }}";
+                        readonly name: "{{ event.name }}";
+                        readonly termEnd: "{{ event.termEnd }}";
+                    };
+                }];
+            };
+            readonly resign_director: {
+                readonly from: readonly ["ACTIVE", "IN_MEETING"];
+                readonly to: "ACTIVE";
+                readonly description: "Director resigns from the board";
+                readonly event: {
+                    readonly name: "resign_director";
+                    readonly payload: {
+                        readonly directorId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly effectiveDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly reason: {
+                            readonly type: "string";
+                        };
+                        readonly resignationLetter: {
+                            readonly type: "string";
+                            readonly description: "Document reference";
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "isActiveDirector";
+                    readonly expression: "context.directors.some(d => d.directorId === event.directorId && d.status === 'ACTIVE')";
+                }];
+                readonly effects: readonly [{
+                    readonly type: "UPDATE_ARRAY_ITEM";
+                    readonly path: "directors";
+                    readonly matchKey: "directorId";
+                    readonly matchValue: "{{ event.directorId }}";
+                    readonly updates: {
+                        readonly status: "RESIGNED";
+                        readonly termEnd: "{{ event.effectiveDate }}";
+                    };
+                }, {
+                    readonly type: "DECREMENT";
+                    readonly path: "seats.filled";
+                    readonly amount: 1;
+                }, {
+                    readonly type: "INCREMENT";
+                    readonly path: "seats.vacant";
+                    readonly amount: 1;
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "DIRECTOR_RESIGNED";
+                    readonly payload: {
+                        readonly boardId: "{{ context.boardId }}";
+                        readonly directorId: "{{ event.directorId }}";
+                        readonly effectiveDate: "{{ event.effectiveDate }}";
+                    };
+                }];
+            };
+            readonly remove_for_cause: {
+                readonly from: "ACTIVE";
+                readonly to: "ACTIVE";
+                readonly description: "Remove a director for cause (requires board or shareholder action depending on bylaws)";
+                readonly event: {
+                    readonly name: "remove_for_cause";
+                    readonly payload: {
+                        readonly directorId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly cause: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly removalResolutionRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly effectiveDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "isActiveDirector";
+                    readonly expression: "context.directors.some(d => d.directorId === event.directorId && d.status === 'ACTIVE')";
+                }, {
+                    readonly name: "hasRemovalResolution";
+                    readonly crossMachine: {
+                        readonly machine: "corporate-resolution";
+                        readonly instanceRef: "{{ event.removalResolutionRef }}";
+                        readonly requiredState: "EXECUTED";
+                    };
+                }];
+                readonly effects: readonly [{
+                    readonly type: "UPDATE_ARRAY_ITEM";
+                    readonly path: "directors";
+                    readonly matchKey: "directorId";
+                    readonly matchValue: "{{ event.directorId }}";
+                    readonly updates: {
+                        readonly status: "REMOVED";
+                        readonly termEnd: "{{ event.effectiveDate }}";
+                    };
+                }, {
+                    readonly type: "DECREMENT";
+                    readonly path: "seats.filled";
+                    readonly amount: 1;
+                }, {
+                    readonly type: "INCREMENT";
+                    readonly path: "seats.vacant";
+                    readonly amount: 1;
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "DIRECTOR_REMOVED";
+                    readonly payload: {
+                        readonly boardId: "{{ context.boardId }}";
+                        readonly directorId: "{{ event.directorId }}";
+                        readonly cause: "{{ event.cause }}";
+                    };
+                }];
+            };
+            readonly designate_chair: {
+                readonly from: "ACTIVE";
+                readonly to: "ACTIVE";
+                readonly description: "Designate a director as board chair";
+                readonly event: {
+                    readonly name: "designate_chair";
+                    readonly payload: {
+                        readonly directorId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly resolutionRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "isActiveDirector";
+                    readonly expression: "context.directors.some(d => d.directorId === event.directorId && d.status === 'ACTIVE')";
+                }];
+                readonly effects: readonly [{
+                    readonly type: "UPDATE_ARRAY_ALL";
+                    readonly path: "directors";
+                    readonly updates: {
+                        readonly isChair: false;
+                    };
+                }, {
+                    readonly type: "UPDATE_ARRAY_ITEM";
+                    readonly path: "directors";
+                    readonly matchKey: "directorId";
+                    readonly matchValue: "{{ event.directorId }}";
+                    readonly updates: {
+                        readonly isChair: true;
+                    };
+                }];
+            };
+            readonly call_meeting: {
+                readonly from: "ACTIVE";
+                readonly to: "ACTIVE";
+                readonly description: "Schedule a board meeting (can be called by chair, CEO, or directors per bylaws)";
+                readonly event: {
+                    readonly name: "call_meeting";
+                    readonly payload: {
+                        readonly meetingId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly type: {
+                            readonly type: "string";
+                            readonly enum: readonly ["REGULAR", "SPECIAL", "ANNUAL", "ORGANIZATIONAL"];
+                            readonly required: true;
+                        };
+                        readonly scheduledDate: {
+                            readonly type: "string";
+                            readonly format: "date-time";
+                            readonly required: true;
+                        };
+                        readonly location: {
+                            readonly type: "string";
+                        };
+                        readonly isVirtual: {
+                            readonly type: "boolean";
+                            readonly default: false;
+                        };
+                        readonly calledBy: {
+                            readonly type: "string";
+                            readonly required: true;
+                            readonly description: "Director ID or officer title";
+                        };
+                        readonly noticeDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly agenda: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly waiverOfNotice: {
+                            readonly type: "boolean";
+                            readonly default: false;
+                            readonly description: "If all directors waive notice";
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "sufficientNotice";
+                    readonly description: "Must provide notice per bylaws (typically 2-10 days for special, less for regular)";
+                    readonly expression: "event.waiverOfNotice || (new Date(event.scheduledDate) - new Date(event.noticeDate)) >= 2 * 24 * 60 * 60 * 1000";
+                }, {
+                    readonly name: "noConflictingMeeting";
+                    readonly description: "No other meeting currently scheduled/in progress";
+                    readonly expression: "context.currentMeeting == null || context.currentMeeting.closedAt != null";
+                }];
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "currentMeeting";
+                    readonly value: {
+                        readonly meetingId: "{{ event.meetingId }}";
+                        readonly type: "{{ event.type }}";
+                        readonly scheduledDate: "{{ event.scheduledDate }}";
+                        readonly location: "{{ event.location }}";
+                        readonly isVirtual: "{{ event.isVirtual }}";
+                        readonly calledBy: "{{ event.calledBy }}";
+                        readonly noticeDate: "{{ event.noticeDate }}";
+                        readonly agenda: "{{ event.agenda }}";
+                        readonly attendees: readonly [];
+                        readonly quorumPresent: false;
+                        readonly quorumCount: 0;
+                    };
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "BOARD_MEETING_SCHEDULED";
+                    readonly payload: {
+                        readonly boardId: "{{ context.boardId }}";
+                        readonly meetingId: "{{ event.meetingId }}";
+                        readonly scheduledDate: "{{ event.scheduledDate }}";
+                    };
+                }];
+            };
+            readonly record_attendance: {
+                readonly from: "ACTIVE";
+                readonly to: "ACTIVE";
+                readonly description: "Record a director's attendance before meeting opens";
+                readonly event: {
+                    readonly name: "record_attendance";
+                    readonly payload: {
+                        readonly directorId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly present: {
+                            readonly type: "boolean";
+                            readonly required: true;
+                        };
+                        readonly arrivedAt: {
+                            readonly type: "string";
+                            readonly format: "date-time";
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "hasPendingMeeting";
+                    readonly expression: "context.currentMeeting != null && context.currentMeeting.openedAt == null";
+                }, {
+                    readonly name: "isActiveDirector";
+                    readonly expression: "context.directors.some(d => d.directorId === event.directorId && d.status === 'ACTIVE')";
+                }];
+                readonly effects: readonly [{
+                    readonly type: "APPEND_ARRAY";
+                    readonly path: "currentMeeting.attendees";
+                    readonly value: {
+                        readonly directorId: "{{ event.directorId }}";
+                        readonly present: "{{ event.present }}";
+                        readonly arrivedAt: "{{ event.arrivedAt }}";
+                        readonly viaProxy: false;
+                    };
+                }, {
+                    readonly type: "COMPUTE";
+                    readonly path: "currentMeeting.quorumCount";
+                    readonly expression: "context.currentMeeting.attendees.filter(a => a.present).length";
+                }, {
+                    readonly type: "COMPUTE";
+                    readonly path: "currentMeeting.quorumPresent";
+                    readonly expression: "context.currentMeeting.attendees.filter(a => a.present).length >= Math.ceil(context.seats.filled * 0.5)";
+                }];
+            };
+            readonly open_meeting: {
+                readonly from: "ACTIVE";
+                readonly to: "IN_MEETING";
+                readonly description: "Officially open the board meeting once quorum is established";
+                readonly event: {
+                    readonly name: "open_meeting";
+                    readonly payload: {
+                        readonly openedAt: {
+                            readonly type: "string";
+                            readonly format: "date-time";
+                            readonly required: true;
+                        };
+                        readonly chairPresiding: {
+                            readonly type: "string";
+                            readonly description: "Director ID presiding";
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "hasPendingMeeting";
+                    readonly expression: "context.currentMeeting != null && context.currentMeeting.openedAt == null";
+                }, {
+                    readonly name: "quorumPresent";
+                    readonly description: "Cannot open meeting without quorum";
+                    readonly expression: "context.currentMeeting.quorumPresent === true";
+                }];
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "currentMeeting.openedAt";
+                    readonly value: "{{ event.openedAt }}";
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "BOARD_MEETING_OPENED";
+                    readonly payload: {
+                        readonly boardId: "{{ context.boardId }}";
+                        readonly meetingId: "{{ context.currentMeeting.meetingId }}";
+                        readonly quorumCount: "{{ context.currentMeeting.quorumCount }}";
+                    };
+                }];
+            };
+            readonly director_departs: {
+                readonly from: "IN_MEETING";
+                readonly to: "IN_MEETING";
+                readonly description: "Record a director leaving the meeting (may affect quorum)";
+                readonly event: {
+                    readonly name: "director_departs";
+                    readonly payload: {
+                        readonly directorId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly departedAt: {
+                            readonly type: "string";
+                            readonly format: "date-time";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "UPDATE_ARRAY_ITEM";
+                    readonly path: "currentMeeting.attendees";
+                    readonly matchKey: "directorId";
+                    readonly matchValue: "{{ event.directorId }}";
+                    readonly updates: {
+                        readonly present: false;
+                        readonly departedAt: "{{ event.departedAt }}";
+                    };
+                }, {
+                    readonly type: "COMPUTE";
+                    readonly path: "currentMeeting.quorumCount";
+                    readonly expression: "context.currentMeeting.attendees.filter(a => a.present).length";
+                }, {
+                    readonly type: "COMPUTE";
+                    readonly path: "currentMeeting.quorumPresent";
+                    readonly expression: "context.currentMeeting.attendees.filter(a => a.present).length >= Math.ceil(context.seats.filled * 0.5)";
+                }];
+            };
+            readonly quorum_lost: {
+                readonly from: "IN_MEETING";
+                readonly to: "QUORUM_LOST";
+                readonly description: "Automatic transition when quorum is lost during meeting";
+                readonly event: {
+                    readonly name: "quorum_lost";
+                    readonly payload: {
+                        readonly lostAt: {
+                            readonly type: "string";
+                            readonly format: "date-time";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "noLongerQuorate";
+                    readonly expression: "context.currentMeeting.quorumPresent === false";
+                }];
+                readonly effects: readonly [{
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "BOARD_QUORUM_LOST";
+                    readonly payload: {
+                        readonly boardId: "{{ context.boardId }}";
+                        readonly meetingId: "{{ context.currentMeeting.meetingId }}";
+                        readonly remainingDirectors: "{{ context.currentMeeting.quorumCount }}";
+                    };
+                }];
+            };
+            readonly quorum_restored: {
+                readonly from: "QUORUM_LOST";
+                readonly to: "IN_MEETING";
+                readonly description: "Quorum restored after additional director(s) join";
+                readonly event: {
+                    readonly name: "quorum_restored";
+                    readonly payload: {
+                        readonly restoredAt: {
+                            readonly type: "string";
+                            readonly format: "date-time";
+                            readonly required: true;
+                        };
+                        readonly directorId: {
+                            readonly type: "string";
+                            readonly required: true;
+                            readonly description: "Joining director";
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "nowQuorate";
+                    readonly expression: "context.currentMeeting.quorumPresent === true";
+                }];
+                readonly effects: readonly [{
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "BOARD_QUORUM_RESTORED";
+                    readonly payload: {
+                        readonly boardId: "{{ context.boardId }}";
+                        readonly meetingId: "{{ context.currentMeeting.meetingId }}";
+                    };
+                }];
+            };
+            readonly adjourn: {
+                readonly from: readonly ["IN_MEETING", "QUORUM_LOST"];
+                readonly to: "ACTIVE";
+                readonly description: "Adjourn the board meeting";
+                readonly event: {
+                    readonly name: "adjourn";
+                    readonly payload: {
+                        readonly closedAt: {
+                            readonly type: "string";
+                            readonly format: "date-time";
+                            readonly required: true;
+                        };
+                        readonly minutesRef: {
+                            readonly type: "string";
+                            readonly description: "Reference to meeting minutes document";
+                        };
+                        readonly resolutionsPassed: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly adjournedTo: {
+                            readonly type: "string";
+                            readonly format: "date-time";
+                            readonly nullable: true;
+                            readonly description: "If adjourning to later date";
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "currentMeeting.closedAt";
+                    readonly value: "{{ event.closedAt }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "currentMeeting.minutesRef";
+                    readonly value: "{{ event.minutesRef }}";
+                }, {
+                    readonly type: "APPEND_ARRAY";
+                    readonly path: "meetingHistory";
+                    readonly value: {
+                        readonly meetingId: "{{ context.currentMeeting.meetingId }}";
+                        readonly type: "{{ context.currentMeeting.type }}";
+                        readonly date: "{{ context.currentMeeting.scheduledDate }}";
+                        readonly quorumAchieved: "{{ context.currentMeeting.quorumPresent }}";
+                        readonly attendeeCount: "{{ context.currentMeeting.attendees.filter(a => a.present).length }}";
+                        readonly resolutionsPassed: "{{ event.resolutionsPassed }}";
+                        readonly minutesRef: "{{ event.minutesRef }}";
+                    };
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "currentMeeting";
+                    readonly value: null;
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "BOARD_MEETING_ADJOURNED";
+                    readonly payload: {
+                        readonly boardId: "{{ context.boardId }}";
+                        readonly meetingId: "{{ context.currentMeeting.meetingId }}";
+                        readonly resolutionsPassed: "{{ event.resolutionsPassed }}";
+                    };
+                }];
+            };
+            readonly update_seats: {
+                readonly from: "ACTIVE";
+                readonly to: "ACTIVE";
+                readonly description: "Change the number of authorized board seats (requires bylaw amendment)";
+                readonly event: {
+                    readonly name: "update_seats";
+                    readonly payload: {
+                        readonly newAuthorizedSeats: {
+                            readonly type: "integer";
+                            readonly required: true;
+                        };
+                        readonly bylawAmendmentRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "seatsNotLessThanFilled";
+                    readonly description: "Cannot reduce below current filled seats";
+                    readonly expression: "event.newAuthorizedSeats >= context.seats.filled";
+                }];
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "seats.authorized";
+                    readonly value: "{{ event.newAuthorizedSeats }}";
+                }, {
+                    readonly type: "COMPUTE";
+                    readonly path: "seats.vacant";
+                    readonly expression: "event.newAuthorizedSeats - context.seats.filled";
+                }];
+            };
+        };
+        readonly crossMachineRefs: {
+            readonly entity: {
+                readonly machine: "corporate-entity";
+                readonly description: "Parent corporate entity";
+                readonly foreignKey: "entityId";
+            };
+            readonly resolutions: {
+                readonly machine: "corporate-resolution";
+                readonly description: "Board resolutions";
+                readonly foreignKey: "boardId";
+            };
+            readonly committees: {
+                readonly machine: "corporate-committee";
+                readonly description: "Board committees";
+                readonly foreignKey: "boardId";
+            };
+            readonly officers: {
+                readonly machine: "corporate-officers";
+                readonly description: "Officers appointed by board";
+                readonly foreignKey: "entityId";
+            };
+        };
+        readonly metadata: {
+            readonly author: "OttoChain";
+            readonly license: "MIT";
+            readonly tags: readonly ["corporate", "governance", "board", "directors", "meetings"];
+            readonly documentation: "https://ottochain.dev/docs/corporate/board";
+        };
+    };
+    readonly shareholders: {
+        readonly $schema: "https://ottochain.dev/schemas/state-machine-v1.json";
+        readonly name: "CorpShareholders";
+        readonly version: "1.0.0";
+        readonly category: "corporate-governance";
+        readonly description: "Shareholder meeting state machine managing annual/special meetings, record dates, proxy periods, voting, and certification of results. Supports multiple share classes and cumulative voting.";
+        readonly context: {
+            readonly meetingId: {
+                readonly type: "string";
+                readonly description: "Unique identifier for this shareholder meeting";
+            };
+            readonly entityId: {
+                readonly type: "string";
+                readonly description: "Reference to parent corporate-entity";
+            };
+            readonly meetingType: {
+                readonly type: "string";
+                readonly enum: readonly ["ANNUAL", "SPECIAL"];
+                readonly description: "Annual meetings are required; special meetings called for specific purposes";
+            };
+            readonly fiscalYear: {
+                readonly type: "integer";
+                readonly description: "Fiscal year for annual meetings";
+            };
+            readonly scheduledDate: {
+                readonly type: "string";
+                readonly format: "date-time";
+            };
+            readonly location: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly physical: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly virtualUrl: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly isHybrid: {
+                        readonly type: "boolean";
+                        readonly default: false;
+                    };
+                };
+            };
+            readonly calledBy: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["BOARD", "SHAREHOLDERS", "COURT"];
+                    };
+                    readonly resolutionRef: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly shareholderPetitionRef: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly courtOrderRef: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                };
+            };
+            readonly noticeInfo: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly noticeSentDate: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly noticeMethod: {
+                        readonly type: "string";
+                        readonly enum: readonly ["MAIL", "EMAIL", "ELECTRONIC_ACCESS"];
+                    };
+                    readonly minimumNoticeDays: {
+                        readonly type: "integer";
+                        readonly default: 10;
+                    };
+                    readonly maximumNoticeDays: {
+                        readonly type: "integer";
+                        readonly default: 60;
+                    };
+                };
+            };
+            readonly recordDate: {
+                readonly type: "object";
+                readonly nullable: true;
+                readonly properties: {
+                    readonly date: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly setByBoardOn: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly resolutionRef: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            readonly eligibleVoters: {
+                readonly type: "array";
+                readonly description: "Shareholders as of record date with their share counts";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly shareholderId: {
+                            readonly type: "string";
+                        };
+                        readonly name: {
+                            readonly type: "string";
+                        };
+                        readonly shareholdings: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                                readonly properties: {
+                                    readonly shareClass: {
+                                        readonly type: "string";
+                                    };
+                                    readonly shares: {
+                                        readonly type: "integer";
+                                    };
+                                    readonly votes: {
+                                        readonly type: "integer";
+                                        readonly description: "Votes this holding represents";
+                                    };
+                                };
+                            };
+                        };
+                        readonly totalVotes: {
+                            readonly type: "integer";
+                        };
+                        readonly proxyGrantedTo: {
+                            readonly type: "string";
+                            readonly nullable: true;
+                            readonly description: "Proxy holder ID if proxied";
+                        };
+                        readonly hasVoted: {
+                            readonly type: "boolean";
+                            readonly default: false;
+                        };
+                    };
+                };
+            };
+            readonly quorumRequirements: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["SHARES_REPRESENTED", "SHARES_OUTSTANDING"];
+                    };
+                    readonly threshold: {
+                        readonly type: "number";
+                        readonly default: 0.5;
+                        readonly description: "Fraction required for quorum";
+                    };
+                    readonly sharesRequired: {
+                        readonly type: "integer";
+                    };
+                    readonly sharesRepresented: {
+                        readonly type: "integer";
+                        readonly default: 0;
+                    };
+                    readonly quorumMet: {
+                        readonly type: "boolean";
+                        readonly default: false;
+                    };
+                };
+            };
+            readonly agenda: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly itemId: {
+                            readonly type: "string";
+                        };
+                        readonly itemNumber: {
+                            readonly type: "integer";
+                        };
+                        readonly title: {
+                            readonly type: "string";
+                        };
+                        readonly description: {
+                            readonly type: "string";
+                        };
+                        readonly type: {
+                            readonly type: "string";
+                            readonly enum: readonly ["DIRECTOR_ELECTION", "AUDITOR_RATIFICATION", "SAY_ON_PAY", "CHARTER_AMENDMENT", "MERGER", "STOCK_PLAN", "SHAREHOLDER_PROPOSAL", "OTHER"];
+                        };
+                        readonly voteRequired: {
+                            readonly type: "string";
+                            readonly enum: readonly ["PLURALITY", "MAJORITY_CAST", "MAJORITY_OUTSTANDING", "SUPERMAJORITY", "UNANIMOUS"];
+                            readonly description: "Vote threshold for approval";
+                        };
+                        readonly supermajorityThreshold: {
+                            readonly type: "number";
+                            readonly nullable: true;
+                        };
+                        readonly eligibleClasses: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                            readonly description: "Share classes that can vote on this item";
+                        };
+                        readonly allowCumulativeVoting: {
+                            readonly type: "boolean";
+                            readonly default: false;
+                            readonly description: "For director elections";
+                        };
+                        readonly status: {
+                            readonly type: "string";
+                            readonly enum: readonly ["PENDING", "VOTING", "CLOSED", "APPROVED", "REJECTED"];
+                        };
+                    };
+                };
+            };
+            readonly proxyPeriod: {
+                readonly type: "object";
+                readonly nullable: true;
+                readonly properties: {
+                    readonly startDate: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly endDate: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "Usually meeting start time";
+                    };
+                    readonly proxyMaterials: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly proxyStatementRef: {
+                                readonly type: "string";
+                            };
+                            readonly formOfProxyRef: {
+                                readonly type: "string";
+                            };
+                            readonly annualReportRef: {
+                                readonly type: "string";
+                                readonly nullable: true;
+                            };
+                        };
+                    };
+                };
+            };
+            readonly votes: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly voteId: {
+                            readonly type: "string";
+                        };
+                        readonly agendaItemId: {
+                            readonly type: "string";
+                        };
+                        readonly voterId: {
+                            readonly type: "string";
+                            readonly description: "Shareholder or proxy holder ID";
+                        };
+                        readonly shareholderId: {
+                            readonly type: "string";
+                            readonly description: "Beneficial owner";
+                        };
+                        readonly shareClass: {
+                            readonly type: "string";
+                        };
+                        readonly votesFor: {
+                            readonly type: "integer";
+                            readonly default: 0;
+                        };
+                        readonly votesAgainst: {
+                            readonly type: "integer";
+                            readonly default: 0;
+                        };
+                        readonly votesAbstain: {
+                            readonly type: "integer";
+                            readonly default: 0;
+                        };
+                        readonly votesWithhold: {
+                            readonly type: "integer";
+                            readonly default: 0;
+                            readonly description: "For director elections";
+                        };
+                        readonly cumulativeVoteAllocation: {
+                            readonly type: "object";
+                            readonly additionalProperties: {
+                                readonly type: "integer";
+                            };
+                            readonly nullable: true;
+                            readonly description: "For cumulative voting: candidate ID -> votes allocated";
+                        };
+                        readonly viaProxy: {
+                            readonly type: "boolean";
+                            readonly default: false;
+                        };
+                        readonly timestamp: {
+                            readonly type: "string";
+                            readonly format: "date-time";
+                        };
+                    };
+                };
+            };
+            readonly voteTallies: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly agendaItemId: {
+                            readonly type: "string";
+                        };
+                        readonly forVotes: {
+                            readonly type: "integer";
+                            readonly default: 0;
+                        };
+                        readonly againstVotes: {
+                            readonly type: "integer";
+                            readonly default: 0;
+                        };
+                        readonly abstainVotes: {
+                            readonly type: "integer";
+                            readonly default: 0;
+                        };
+                        readonly withholdVotes: {
+                            readonly type: "integer";
+                            readonly default: 0;
+                        };
+                        readonly brokerNonVotes: {
+                            readonly type: "integer";
+                            readonly default: 0;
+                        };
+                        readonly candidateVotes: {
+                            readonly type: "object";
+                            readonly additionalProperties: {
+                                readonly type: "integer";
+                            };
+                            readonly nullable: true;
+                            readonly description: "For director elections: candidate ID -> total votes";
+                        };
+                        readonly result: {
+                            readonly type: "string";
+                            readonly enum: readonly ["APPROVED", "REJECTED", "PENDING"];
+                        };
+                        readonly certified: {
+                            readonly type: "boolean";
+                            readonly default: false;
+                        };
+                    };
+                };
+            };
+            readonly inspectorOfElections: {
+                readonly type: "object";
+                readonly nullable: true;
+                readonly properties: {
+                    readonly name: {
+                        readonly type: "string";
+                    };
+                    readonly company: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly appointedBy: {
+                        readonly type: "string";
+                    };
+                    readonly appointmentDate: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                };
+            };
+            readonly sessionInfo: {
+                readonly type: "object";
+                readonly nullable: true;
+                readonly properties: {
+                    readonly openedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly chairPerson: {
+                        readonly type: "string";
+                    };
+                    readonly secretaryPresent: {
+                        readonly type: "string";
+                    };
+                    readonly pollsOpenedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly nullable: true;
+                    };
+                    readonly pollsClosedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly nullable: true;
+                    };
+                    readonly adjournedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly nullable: true;
+                    };
+                    readonly minutesRef: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                };
+            };
+            readonly certification: {
+                readonly type: "object";
+                readonly nullable: true;
+                readonly properties: {
+                    readonly certifiedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly certifiedBy: {
+                        readonly type: "string";
+                    };
+                    readonly certificateRef: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            readonly createdAt: {
+                readonly type: "string";
+                readonly format: "date-time";
+            };
+            readonly updatedAt: {
+                readonly type: "string";
+                readonly format: "date-time";
+            };
+        };
+        readonly states: {
+            readonly SCHEDULED: {
+                readonly description: "Meeting has been scheduled but record date not yet set";
+                readonly metadata: null;
+            };
+            readonly RECORD_DATE_SET: {
+                readonly description: "Record date established; eligible shareholders determined";
+                readonly metadata: null;
+            };
+            readonly PROXY_PERIOD: {
+                readonly description: "Proxy materials distributed; shareholders may submit proxies";
+                readonly metadata: null;
+            };
+            readonly IN_SESSION: {
+                readonly description: "Meeting is convened and in progress";
+                readonly metadata: null;
+            };
+            readonly VOTING: {
+                readonly description: "Polls are open for voting on agenda items";
+                readonly metadata: null;
+            };
+            readonly CLOSED: {
+                readonly description: "Meeting concluded; results certified";
+                readonly metadata: null;
+                readonly terminal: true;
+            };
+        };
+        readonly initialState: "SCHEDULED";
+        readonly transitions: {
+            readonly schedule_annual: {
+                readonly from: null;
+                readonly to: "SCHEDULED";
+                readonly description: "Schedule an annual shareholder meeting";
+                readonly event: {
+                    readonly name: "schedule_annual";
+                    readonly payload: {
+                        readonly meetingId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly entityId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly fiscalYear: {
+                            readonly type: "integer";
+                            readonly required: true;
+                        };
+                        readonly scheduledDate: {
+                            readonly type: "string";
+                            readonly format: "date-time";
+                            readonly required: true;
+                        };
+                        readonly location: {
+                            readonly type: "object";
+                        };
+                        readonly boardResolutionRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "boardApproved";
+                    readonly crossMachine: {
+                        readonly machine: "corporate-resolution";
+                        readonly instanceRef: "{{ event.boardResolutionRef }}";
+                        readonly requiredState: "EXECUTED";
+                    };
+                }];
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "meetingId";
+                    readonly value: "{{ event.meetingId }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "entityId";
+                    readonly value: "{{ event.entityId }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "meetingType";
+                    readonly value: "ANNUAL";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "fiscalYear";
+                    readonly value: "{{ event.fiscalYear }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "scheduledDate";
+                    readonly value: "{{ event.scheduledDate }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "location";
+                    readonly value: "{{ event.location }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "calledBy";
+                    readonly value: {
+                        readonly type: "BOARD";
+                        readonly resolutionRef: "{{ event.boardResolutionRef }}";
+                    };
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "SHAREHOLDER_MEETING_SCHEDULED";
+                    readonly payload: {
+                        readonly meetingId: "{{ event.meetingId }}";
+                        readonly type: "ANNUAL";
+                        readonly scheduledDate: "{{ event.scheduledDate }}";
+                    };
+                }];
+            };
+            readonly schedule_special: {
+                readonly from: null;
+                readonly to: "SCHEDULED";
+                readonly description: "Schedule a special shareholder meeting";
+                readonly event: {
+                    readonly name: "schedule_special";
+                    readonly payload: {
+                        readonly meetingId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly entityId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly scheduledDate: {
+                            readonly type: "string";
+                            readonly format: "date-time";
+                            readonly required: true;
+                        };
+                        readonly location: {
+                            readonly type: "object";
+                        };
+                        readonly purpose: {
+                            readonly type: "string";
+                            readonly required: true;
+                            readonly description: "Specific purpose for special meeting";
+                        };
+                        readonly calledByType: {
+                            readonly type: "string";
+                            readonly enum: readonly ["BOARD", "SHAREHOLDERS", "COURT"];
+                            readonly required: true;
+                        };
+                        readonly resolutionRef: {
+                            readonly type: "string";
+                        };
+                        readonly petitionRef: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "meetingId";
+                    readonly value: "{{ event.meetingId }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "entityId";
+                    readonly value: "{{ event.entityId }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "meetingType";
+                    readonly value: "SPECIAL";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "scheduledDate";
+                    readonly value: "{{ event.scheduledDate }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "calledBy.type";
+                    readonly value: "{{ event.calledByType }}";
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "SPECIAL_MEETING_SCHEDULED";
+                    readonly payload: {
+                        readonly meetingId: "{{ event.meetingId }}";
+                        readonly purpose: "{{ event.purpose }}";
+                    };
+                }];
+            };
+            readonly set_record_date: {
+                readonly from: "SCHEDULED";
+                readonly to: "RECORD_DATE_SET";
+                readonly description: "Board sets the record date for determining eligible shareholders";
+                readonly event: {
+                    readonly name: "set_record_date";
+                    readonly payload: {
+                        readonly recordDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly resolutionRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "validRecordDateTiming";
+                    readonly description: "Record date must be 10-60 days before meeting (per most state laws)";
+                    readonly expression: "true";
+                }];
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "recordDate";
+                    readonly value: {
+                        readonly date: "{{ event.recordDate }}";
+                        readonly setByBoardOn: "{{ today() }}";
+                        readonly resolutionRef: "{{ event.resolutionRef }}";
+                    };
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "RECORD_DATE_SET";
+                    readonly payload: {
+                        readonly meetingId: "{{ context.meetingId }}";
+                        readonly recordDate: "{{ event.recordDate }}";
+                    };
+                }];
+            };
+            readonly register_eligible_shareholders: {
+                readonly from: "RECORD_DATE_SET";
+                readonly to: "RECORD_DATE_SET";
+                readonly description: "Register shareholders of record as of record date";
+                readonly event: {
+                    readonly name: "register_eligible_shareholders";
+                    readonly payload: {
+                        readonly shareholders: {
+                            readonly type: "array";
+                            readonly required: true;
+                            readonly items: {
+                                readonly type: "object";
+                                readonly properties: {
+                                    readonly shareholderId: {
+                                        readonly type: "string";
+                                    };
+                                    readonly name: {
+                                        readonly type: "string";
+                                    };
+                                    readonly shareholdings: {
+                                        readonly type: "array";
+                                    };
+                                };
+                            };
+                        };
+                        readonly totalSharesOutstanding: {
+                            readonly type: "integer";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "eligibleVoters";
+                    readonly value: "{{ event.shareholders }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "quorumRequirements.sharesRequired";
+                    readonly value: "{{ Math.ceil(event.totalSharesOutstanding * 0.5) }}";
+                }];
+            };
+            readonly open_proxy_period: {
+                readonly from: "RECORD_DATE_SET";
+                readonly to: "PROXY_PERIOD";
+                readonly description: "Distribute proxy materials and open proxy solicitation period";
+                readonly event: {
+                    readonly name: "open_proxy_period";
+                    readonly payload: {
+                        readonly startDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly proxyStatementRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly formOfProxyRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly annualReportRef: {
+                            readonly type: "string";
+                        };
+                        readonly agenda: {
+                            readonly type: "array";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "proxyPeriod";
+                    readonly value: {
+                        readonly startDate: "{{ event.startDate }}";
+                        readonly endDate: "{{ context.scheduledDate }}";
+                        readonly proxyMaterials: {
+                            readonly proxyStatementRef: "{{ event.proxyStatementRef }}";
+                            readonly formOfProxyRef: "{{ event.formOfProxyRef }}";
+                            readonly annualReportRef: "{{ event.annualReportRef }}";
+                        };
+                    };
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "agenda";
+                    readonly value: "{{ event.agenda }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "noticeInfo.noticeSentDate";
+                    readonly value: "{{ event.startDate }}";
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "PROXY_PERIOD_OPENED";
+                    readonly payload: {
+                        readonly meetingId: "{{ context.meetingId }}";
+                        readonly proxyStatementRef: "{{ event.proxyStatementRef }}";
+                    };
+                }];
+            };
+            readonly add_agenda_item: {
+                readonly from: readonly ["SCHEDULED", "RECORD_DATE_SET", "PROXY_PERIOD"];
+                readonly to: null;
+                readonly description: "Add an item to the meeting agenda (e.g., shareholder proposal)";
+                readonly event: {
+                    readonly name: "add_agenda_item";
+                    readonly payload: {
+                        readonly itemId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly title: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly description: {
+                            readonly type: "string";
+                        };
+                        readonly type: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly voteRequired: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly eligibleClasses: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly allowCumulativeVoting: {
+                            readonly type: "boolean";
+                            readonly default: false;
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "APPEND_ARRAY";
+                    readonly path: "agenda";
+                    readonly value: {
+                        readonly itemId: "{{ event.itemId }}";
+                        readonly itemNumber: "{{ context.agenda.length + 1 }}";
+                        readonly title: "{{ event.title }}";
+                        readonly description: "{{ event.description }}";
+                        readonly type: "{{ event.type }}";
+                        readonly voteRequired: "{{ event.voteRequired }}";
+                        readonly eligibleClasses: "{{ event.eligibleClasses }}";
+                        readonly allowCumulativeVoting: "{{ event.allowCumulativeVoting }}";
+                        readonly status: "PENDING";
+                    };
+                }];
+            };
+            readonly open_meeting: {
+                readonly from: "PROXY_PERIOD";
+                readonly to: "IN_SESSION";
+                readonly description: "Convene the shareholder meeting";
+                readonly event: {
+                    readonly name: "open_meeting";
+                    readonly payload: {
+                        readonly openedAt: {
+                            readonly type: "string";
+                            readonly format: "date-time";
+                            readonly required: true;
+                        };
+                        readonly chairPerson: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly secretaryPresent: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly inspectorOfElections: {
+                            readonly type: "object";
+                        };
+                        readonly initialQuorumCount: {
+                            readonly type: "integer";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "quorumPresentOrRepresented";
+                    readonly description: "Must have quorum to proceed";
+                    readonly expression: "event.initialQuorumCount >= context.quorumRequirements.sharesRequired";
+                }];
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "sessionInfo";
+                    readonly value: {
+                        readonly openedAt: "{{ event.openedAt }}";
+                        readonly chairPerson: "{{ event.chairPerson }}";
+                        readonly secretaryPresent: "{{ event.secretaryPresent }}";
+                    };
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "inspectorOfElections";
+                    readonly value: "{{ event.inspectorOfElections }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "quorumRequirements.sharesRepresented";
+                    readonly value: "{{ event.initialQuorumCount }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "quorumRequirements.quorumMet";
+                    readonly value: true;
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "SHAREHOLDER_MEETING_OPENED";
+                    readonly payload: {
+                        readonly meetingId: "{{ context.meetingId }}";
+                        readonly sharesRepresented: "{{ event.initialQuorumCount }}";
+                    };
+                }];
+            };
+            readonly open_polls: {
+                readonly from: "IN_SESSION";
+                readonly to: "VOTING";
+                readonly description: "Open polls for voting on agenda items";
+                readonly event: {
+                    readonly name: "open_polls";
+                    readonly payload: {
+                        readonly pollsOpenedAt: {
+                            readonly type: "string";
+                            readonly format: "date-time";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "sessionInfo.pollsOpenedAt";
+                    readonly value: "{{ event.pollsOpenedAt }}";
+                }, {
+                    readonly type: "UPDATE_ARRAY_ALL";
+                    readonly path: "agenda";
+                    readonly updates: {
+                        readonly status: "VOTING";
+                    };
+                }];
+            };
+            readonly cast_vote: {
+                readonly from: "VOTING";
+                readonly to: "VOTING";
+                readonly description: "Record a vote from a shareholder or proxy holder";
+                readonly event: {
+                    readonly name: "cast_vote";
+                    readonly payload: {
+                        readonly voteId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly agendaItemId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly voterId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly shareholderId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly shareClass: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly votesFor: {
+                            readonly type: "integer";
+                            readonly default: 0;
+                        };
+                        readonly votesAgainst: {
+                            readonly type: "integer";
+                            readonly default: 0;
+                        };
+                        readonly votesAbstain: {
+                            readonly type: "integer";
+                            readonly default: 0;
+                        };
+                        readonly votesWithhold: {
+                            readonly type: "integer";
+                            readonly default: 0;
+                        };
+                        readonly cumulativeVoteAllocation: {
+                            readonly type: "object";
+                            readonly nullable: true;
+                        };
+                        readonly viaProxy: {
+                            readonly type: "boolean";
+                            readonly default: false;
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "isEligibleVoter";
+                    readonly expression: "context.eligibleVoters.some(v => v.shareholderId === event.shareholderId)";
+                }, {
+                    readonly name: "hasNotAlreadyVoted";
+                    readonly description: "Shareholder cannot vote twice on same item";
+                    readonly expression: "!context.votes.some(v => v.shareholderId === event.shareholderId && v.agendaItemId === event.agendaItemId)";
+                }, {
+                    readonly name: "validProxyIfApplicable";
+                    readonly description: "If voting via proxy, proxy must be valid";
+                    readonly expression: "!event.viaProxy || true";
+                    readonly crossMachine: {
+                        readonly machine: "corporate-proxy";
+                        readonly condition: "event.viaProxy";
+                        readonly query: "findByGrantor(event.shareholderId)";
+                        readonly requiredState: "ACTIVE";
+                    };
+                }];
+                readonly effects: readonly [{
+                    readonly type: "APPEND_ARRAY";
+                    readonly path: "votes";
+                    readonly value: {
+                        readonly voteId: "{{ event.voteId }}";
+                        readonly agendaItemId: "{{ event.agendaItemId }}";
+                        readonly voterId: "{{ event.voterId }}";
+                        readonly shareholderId: "{{ event.shareholderId }}";
+                        readonly shareClass: "{{ event.shareClass }}";
+                        readonly votesFor: "{{ event.votesFor }}";
+                        readonly votesAgainst: "{{ event.votesAgainst }}";
+                        readonly votesAbstain: "{{ event.votesAbstain }}";
+                        readonly votesWithhold: "{{ event.votesWithhold }}";
+                        readonly cumulativeVoteAllocation: "{{ event.cumulativeVoteAllocation }}";
+                        readonly viaProxy: "{{ event.viaProxy }}";
+                        readonly timestamp: "{{ now() }}";
+                    };
+                }, {
+                    readonly type: "UPDATE_ARRAY_ITEM";
+                    readonly path: "eligibleVoters";
+                    readonly matchKey: "shareholderId";
+                    readonly matchValue: "{{ event.shareholderId }}";
+                    readonly updates: {
+                        readonly hasVoted: true;
+                    };
+                }];
+            };
+            readonly close_polls: {
+                readonly from: "VOTING";
+                readonly to: "IN_SESSION";
+                readonly description: "Close polls and begin vote tabulation";
+                readonly event: {
+                    readonly name: "close_polls";
+                    readonly payload: {
+                        readonly pollsClosedAt: {
+                            readonly type: "string";
+                            readonly format: "date-time";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "sessionInfo.pollsClosedAt";
+                    readonly value: "{{ event.pollsClosedAt }}";
+                }, {
+                    readonly type: "UPDATE_ARRAY_ALL";
+                    readonly path: "agenda";
+                    readonly updates: {
+                        readonly status: "CLOSED";
+                    };
+                }, {
+                    readonly type: "COMPUTE_TALLIES";
+                    readonly description: "Aggregate votes by agenda item";
+                    readonly targetPath: "voteTallies";
+                }];
+            };
+            readonly certify_results: {
+                readonly from: "IN_SESSION";
+                readonly to: "CLOSED";
+                readonly description: "Inspector of elections certifies vote results";
+                readonly event: {
+                    readonly name: "certify_results";
+                    readonly payload: {
+                        readonly certifiedAt: {
+                            readonly type: "string";
+                            readonly format: "date-time";
+                            readonly required: true;
+                        };
+                        readonly certifiedBy: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly certificateRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly results: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                                readonly properties: {
+                                    readonly agendaItemId: {
+                                        readonly type: "string";
+                                    };
+                                    readonly result: {
+                                        readonly type: "string";
+                                        readonly enum: readonly ["APPROVED", "REJECTED"];
+                                    };
+                                };
+                            };
+                        };
+                        readonly minutesRef: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "certification";
+                    readonly value: {
+                        readonly certifiedAt: "{{ event.certifiedAt }}";
+                        readonly certifiedBy: "{{ event.certifiedBy }}";
+                        readonly certificateRef: "{{ event.certificateRef }}";
+                    };
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "sessionInfo.adjournedAt";
+                    readonly value: "{{ event.certifiedAt }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "sessionInfo.minutesRef";
+                    readonly value: "{{ event.minutesRef }}";
+                }, {
+                    readonly type: "FOR_EACH";
+                    readonly array: "{{ event.results }}";
+                    readonly do: {
+                        readonly type: "UPDATE_ARRAY_ITEM";
+                        readonly path: "voteTallies";
+                        readonly matchKey: "agendaItemId";
+                        readonly matchValue: "{{ item.agendaItemId }}";
+                        readonly updates: {
+                            readonly result: "{{ item.result }}";
+                            readonly certified: true;
+                        };
+                    };
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "MEETING_RESULTS_CERTIFIED";
+                    readonly payload: {
+                        readonly meetingId: "{{ context.meetingId }}";
+                        readonly results: "{{ event.results }}";
+                    };
+                }];
+            };
+            readonly adjourn_without_action: {
+                readonly from: readonly ["IN_SESSION", "VOTING"];
+                readonly to: "CLOSED";
+                readonly description: "Adjourn meeting without completing agenda (e.g., quorum lost)";
+                readonly event: {
+                    readonly name: "adjourn_without_action";
+                    readonly payload: {
+                        readonly adjournedAt: {
+                            readonly type: "string";
+                            readonly format: "date-time";
+                            readonly required: true;
+                        };
+                        readonly reason: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly adjournedTo: {
+                            readonly type: "string";
+                            readonly format: "date-time";
+                            readonly nullable: true;
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "sessionInfo.adjournedAt";
+                    readonly value: "{{ event.adjournedAt }}";
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "MEETING_ADJOURNED";
+                    readonly payload: {
+                        readonly meetingId: "{{ context.meetingId }}";
+                        readonly reason: "{{ event.reason }}";
+                        readonly adjournedTo: "{{ event.adjournedTo }}";
+                    };
+                }];
+            };
+        };
+        readonly crossMachineRefs: {
+            readonly entity: {
+                readonly machine: "corporate-entity";
+                readonly description: "Parent corporate entity";
+                readonly foreignKey: "entityId";
+            };
+            readonly proxies: {
+                readonly machine: "corporate-proxy";
+                readonly description: "Proxy grants for this meeting";
+                readonly foreignKey: "meetingId";
+            };
+            readonly resolutions: {
+                readonly machine: "corporate-resolution";
+                readonly description: "Resolutions resulting from meeting votes";
+                readonly foreignKey: "meetingId";
+            };
+            readonly securities: {
+                readonly machine: "corporate-securities";
+                readonly description: "Share records for determining voting rights";
+                readonly foreignKey: "entityId";
+            };
+        };
+        readonly metadata: {
+            readonly author: "OttoChain";
+            readonly license: "MIT";
+            readonly tags: readonly ["corporate", "governance", "shareholders", "voting", "meetings", "proxy"];
+            readonly documentation: "https://ottochain.dev/docs/corporate/shareholders";
+        };
+    };
+    readonly securities: {
+        readonly $schema: "https://ottochain.dev/schemas/state-machine-v1.json";
+        readonly name: "CorpSecurities";
+        readonly version: "1.0.0";
+        readonly category: "corporate-governance";
+        readonly description: "Securities state machine tracking the lifecycle of equity from authorization through issuance, transfer, and retirement. Manages stock certificates, book entry positions, and restricted securities.";
+        readonly context: {
+            readonly securityId: {
+                readonly type: "string";
+                readonly description: "Unique identifier for this security lot/certificate";
+            };
+            readonly entityId: {
+                readonly type: "string";
+                readonly description: "Reference to parent corporate-entity";
+            };
+            readonly shareClass: {
+                readonly type: "string";
+                readonly description: "Share class ID from corporate-entity";
+            };
+            readonly shareClassName: {
+                readonly type: "string";
+                readonly description: "Human-readable class name";
+            };
+            readonly certificateNumber: {
+                readonly type: "string";
+                readonly nullable: true;
+                readonly description: "For certificated shares";
+            };
+            readonly cusip: {
+                readonly type: "string";
+                readonly nullable: true;
+                readonly description: "CUSIP number if assigned";
+            };
+            readonly shareCount: {
+                readonly type: "integer";
+                readonly description: "Number of shares in this lot";
+            };
+            readonly parValue: {
+                readonly type: "number";
+                readonly description: "Par value per share";
+            };
+            readonly issuancePrice: {
+                readonly type: "number";
+                readonly nullable: true;
+                readonly description: "Price per share at issuance";
+            };
+            readonly issuanceDate: {
+                readonly type: "string";
+                readonly format: "date";
+                readonly nullable: true;
+            };
+            readonly form: {
+                readonly type: "string";
+                readonly enum: readonly ["CERTIFICATED", "BOOK_ENTRY", "DRS"];
+                readonly description: "Physical certificate, book entry, or Direct Registration System";
+            };
+            readonly holder: {
+                readonly type: "object";
+                readonly nullable: true;
+                readonly properties: {
+                    readonly holderId: {
+                        readonly type: "string";
+                    };
+                    readonly holderType: {
+                        readonly type: "string";
+                        readonly enum: readonly ["INDIVIDUAL", "ENTITY", "TRUST", "TREASURY"];
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                    };
+                    readonly taxId: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly address: {
+                        readonly type: "object";
+                        readonly nullable: true;
+                    };
+                    readonly acquisitionDate: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly acquisitionMethod: {
+                        readonly type: "string";
+                        readonly enum: readonly ["ORIGINAL_ISSUANCE", "PURCHASE", "GIFT", "INHERITANCE", "STOCK_SPLIT", "CONVERSION", "EXERCISE"];
+                    };
+                    readonly costBasis: {
+                        readonly type: "number";
+                        readonly nullable: true;
+                    };
+                };
+            };
+            readonly restrictions: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly isRestricted: {
+                        readonly type: "boolean";
+                        readonly default: false;
+                    };
+                    readonly restrictionType: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly enum: readonly ["RULE_144", "SECTION_4(a)(2)", "REG_D", "REG_S", "LOCK_UP", "VESTING", "RIGHT_OF_FIRST_REFUSAL"];
+                        };
+                    };
+                    readonly restrictionEndDate: {
+                        readonly type: "string";
+                        readonly format: "date";
+                        readonly nullable: true;
+                    };
+                    readonly legends: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "Legend text on certificates";
+                    };
+                    readonly vestingSchedule: {
+                        readonly type: "object";
+                        readonly nullable: true;
+                        readonly properties: {
+                            readonly vestingStartDate: {
+                                readonly type: "string";
+                                readonly format: "date";
+                            };
+                            readonly totalShares: {
+                                readonly type: "integer";
+                            };
+                            readonly vestedShares: {
+                                readonly type: "integer";
+                            };
+                            readonly vestingScheduleRef: {
+                                readonly type: "string";
+                            };
+                        };
+                    };
+                    readonly lockUpExpiration: {
+                        readonly type: "string";
+                        readonly format: "date";
+                        readonly nullable: true;
+                    };
+                    readonly rofr: {
+                        readonly type: "object";
+                        readonly nullable: true;
+                        readonly description: "Right of First Refusal";
+                        readonly properties: {
+                            readonly holderIds: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                            };
+                            readonly noticePeriodDays: {
+                                readonly type: "integer";
+                            };
+                        };
+                    };
+                };
+            };
+            readonly authorization: {
+                readonly type: "object";
+                readonly nullable: true;
+                readonly description: "For shares in AUTHORIZED state";
+                readonly properties: {
+                    readonly authorizedDate: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly charterProvision: {
+                        readonly type: "string";
+                    };
+                    readonly authorizedShares: {
+                        readonly type: "integer";
+                    };
+                };
+            };
+            readonly issuanceDetails: {
+                readonly type: "object";
+                readonly nullable: true;
+                readonly properties: {
+                    readonly boardResolutionRef: {
+                        readonly type: "string";
+                    };
+                    readonly issuanceAgreementRef: {
+                        readonly type: "string";
+                    };
+                    readonly consideration: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly type: {
+                                readonly type: "string";
+                                readonly enum: readonly ["CASH", "PROPERTY", "SERVICES", "DEBT_CONVERSION", "STOCK_CONVERSION"];
+                            };
+                            readonly value: {
+                                readonly type: "number";
+                            };
+                            readonly description: {
+                                readonly type: "string";
+                            };
+                        };
+                    };
+                    readonly exemptionUsed: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly accreditedInvestor: {
+                        readonly type: "boolean";
+                        readonly nullable: true;
+                    };
+                };
+            };
+            readonly transferHistory: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly transferId: {
+                            readonly type: "string";
+                        };
+                        readonly transferDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                        };
+                        readonly fromHolderId: {
+                            readonly type: "string";
+                        };
+                        readonly toHolderId: {
+                            readonly type: "string";
+                        };
+                        readonly shares: {
+                            readonly type: "integer";
+                        };
+                        readonly transferType: {
+                            readonly type: "string";
+                            readonly enum: readonly ["SALE", "GIFT", "INHERITANCE", "INTERNAL"];
+                        };
+                        readonly pricePerShare: {
+                            readonly type: "number";
+                            readonly nullable: true;
+                        };
+                        readonly transferAgentConfirmation: {
+                            readonly type: "string";
+                            readonly nullable: true;
+                        };
+                    };
+                };
+            };
+            readonly corporateActions: {
+                readonly type: "array";
+                readonly description: "Stock splits, dividends, etc. affecting this lot";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly actionId: {
+                            readonly type: "string";
+                        };
+                        readonly actionType: {
+                            readonly type: "string";
+                            readonly enum: readonly ["STOCK_SPLIT", "REVERSE_SPLIT", "STOCK_DIVIDEND", "CONVERSION", "RECLASSIFICATION"];
+                        };
+                        readonly actionDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                        };
+                        readonly ratio: {
+                            readonly type: "string";
+                            readonly nullable: true;
+                            readonly description: "e.g., 2:1 for split";
+                        };
+                        readonly sharesBeforeAction: {
+                            readonly type: "integer";
+                        };
+                        readonly sharesAfterAction: {
+                            readonly type: "integer";
+                        };
+                        readonly resolutionRef: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+            };
+            readonly retirementDetails: {
+                readonly type: "object";
+                readonly nullable: true;
+                readonly properties: {
+                    readonly retiredDate: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly retirementMethod: {
+                        readonly type: "string";
+                        readonly enum: readonly ["REPURCHASE", "REDEMPTION", "CANCELLATION", "CONVERSION"];
+                    };
+                    readonly repurchasePrice: {
+                        readonly type: "number";
+                        readonly nullable: true;
+                    };
+                    readonly boardResolutionRef: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            readonly createdAt: {
+                readonly type: "string";
+                readonly format: "date-time";
+            };
+            readonly updatedAt: {
+                readonly type: "string";
+                readonly format: "date-time";
+            };
+        };
+        readonly states: {
+            readonly AUTHORIZED: {
+                readonly description: "Shares authorized by charter but not yet issued";
+                readonly metadata: null;
+            };
+            readonly ISSUED: {
+                readonly description: "Shares issued and held by a shareholder";
+                readonly metadata: null;
+            };
+            readonly TREASURY: {
+                readonly description: "Shares repurchased and held by the company";
+                readonly metadata: null;
+            };
+            readonly TRANSFERRED: {
+                readonly description: "Transitional state during transfer between holders";
+                readonly metadata: null;
+            };
+            readonly RETIRED: {
+                readonly description: "Shares cancelled and returned to authorized but unissued";
+                readonly metadata: null;
+                readonly terminal: true;
+            };
+        };
+        readonly initialState: "AUTHORIZED";
+        readonly transitions: {
+            readonly authorize_shares: {
+                readonly from: null;
+                readonly to: "AUTHORIZED";
+                readonly description: "Record shares as authorized per charter/amendment";
+                readonly event: {
+                    readonly name: "authorize_shares";
+                    readonly payload: {
+                        readonly securityId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly entityId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly shareClass: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly shareClassName: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly shareCount: {
+                            readonly type: "integer";
+                            readonly required: true;
+                        };
+                        readonly parValue: {
+                            readonly type: "number";
+                            readonly required: true;
+                        };
+                        readonly authorizedDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly charterProvision: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "securityId";
+                    readonly value: "{{ event.securityId }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "entityId";
+                    readonly value: "{{ event.entityId }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "shareClass";
+                    readonly value: "{{ event.shareClass }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "shareClassName";
+                    readonly value: "{{ event.shareClassName }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "shareCount";
+                    readonly value: "{{ event.shareCount }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "parValue";
+                    readonly value: "{{ event.parValue }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "authorization";
+                    readonly value: {
+                        readonly authorizedDate: "{{ event.authorizedDate }}";
+                        readonly charterProvision: "{{ event.charterProvision }}";
+                        readonly authorizedShares: "{{ event.shareCount }}";
+                    };
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "transferHistory";
+                    readonly value: readonly [];
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "corporateActions";
+                    readonly value: readonly [];
+                }];
+            };
+            readonly issue_shares: {
+                readonly from: "AUTHORIZED";
+                readonly to: "ISSUED";
+                readonly description: "Issue shares to a holder";
+                readonly event: {
+                    readonly name: "issue_shares";
+                    readonly payload: {
+                        readonly holderId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly holderType: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly holderName: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly address: {
+                            readonly type: "object";
+                        };
+                        readonly issuanceDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly issuancePrice: {
+                            readonly type: "number";
+                        };
+                        readonly form: {
+                            readonly type: "string";
+                            readonly enum: readonly ["CERTIFICATED", "BOOK_ENTRY", "DRS"];
+                            readonly required: true;
+                        };
+                        readonly certificateNumber: {
+                            readonly type: "string";
+                        };
+                        readonly boardResolutionRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly consideration: {
+                            readonly type: "object";
+                            readonly required: true;
+                        };
+                        readonly isRestricted: {
+                            readonly type: "boolean";
+                            readonly default: false;
+                        };
+                        readonly restrictionType: {
+                            readonly type: "array";
+                        };
+                        readonly legends: {
+                            readonly type: "array";
+                        };
+                        readonly exemptionUsed: {
+                            readonly type: "string";
+                        };
+                        readonly accreditedInvestor: {
+                            readonly type: "boolean";
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "hasIssuanceResolution";
+                    readonly description: "Board must have approved stock issuance";
+                    readonly crossMachine: {
+                        readonly machine: "corporate-resolution";
+                        readonly instanceRef: "{{ event.boardResolutionRef }}";
+                        readonly requiredState: "EXECUTED";
+                    };
+                }, {
+                    readonly name: "entityIsActive";
+                    readonly description: "Cannot issue stock if corporation is suspended or dissolved";
+                    readonly crossMachine: {
+                        readonly machine: "corporate-entity";
+                        readonly instanceRef: "{{ context.entityId }}";
+                        readonly requiredState: "ACTIVE";
+                    };
+                }];
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "form";
+                    readonly value: "{{ event.form }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "certificateNumber";
+                    readonly value: "{{ event.certificateNumber }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "issuanceDate";
+                    readonly value: "{{ event.issuanceDate }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "issuancePrice";
+                    readonly value: "{{ event.issuancePrice }}";
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "holder";
+                    readonly value: {
+                        readonly holderId: "{{ event.holderId }}";
+                        readonly holderType: "{{ event.holderType }}";
+                        readonly name: "{{ event.holderName }}";
+                        readonly address: "{{ event.address }}";
+                        readonly acquisitionDate: "{{ event.issuanceDate }}";
+                        readonly acquisitionMethod: "ORIGINAL_ISSUANCE";
+                        readonly costBasis: "{{ event.issuancePrice * context.shareCount }}";
+                    };
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "restrictions";
+                    readonly value: {
+                        readonly isRestricted: "{{ event.isRestricted }}";
+                        readonly restrictionType: "{{ event.restrictionType }}";
+                        readonly legends: "{{ event.legends }}";
+                    };
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "issuanceDetails";
+                    readonly value: {
+                        readonly boardResolutionRef: "{{ event.boardResolutionRef }}";
+                        readonly consideration: "{{ event.consideration }}";
+                        readonly exemptionUsed: "{{ event.exemptionUsed }}";
+                        readonly accreditedInvestor: "{{ event.accreditedInvestor }}";
+                    };
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "SHARES_ISSUED";
+                    readonly payload: {
+                        readonly securityId: "{{ context.securityId }}";
+                        readonly entityId: "{{ context.entityId }}";
+                        readonly shareClass: "{{ context.shareClassName }}";
+                        readonly shares: "{{ context.shareCount }}";
+                        readonly holderId: "{{ event.holderId }}";
+                        readonly holderName: "{{ event.holderName }}";
+                    };
+                }];
+            };
+            readonly initiate_transfer: {
+                readonly from: "ISSUED";
+                readonly to: "TRANSFERRED";
+                readonly description: "Begin transfer of shares to new holder";
+                readonly event: {
+                    readonly name: "initiate_transfer";
+                    readonly payload: {
+                        readonly transferId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly toHolderId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly toHolderName: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly toHolderType: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly toAddress: {
+                            readonly type: "object";
+                        };
+                        readonly transferType: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly pricePerShare: {
+                            readonly type: "number";
+                        };
+                        readonly transferDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "restrictionsCleared";
+                    readonly description: "Must clear any transfer restrictions";
+                    readonly expression: "!context.restrictions.isRestricted || context.restrictions.restrictionEndDate == null || new Date() >= new Date(context.restrictions.restrictionEndDate)";
+                }, {
+                    readonly name: "rofrSatisfied";
+                    readonly description: "Right of first refusal must be waived or expired";
+                    readonly expression: "context.restrictions.rofr == null";
+                }];
+                readonly effects: readonly [{
+                    readonly type: "APPEND_ARRAY";
+                    readonly path: "transferHistory";
+                    readonly value: {
+                        readonly transferId: "{{ event.transferId }}";
+                        readonly transferDate: "{{ event.transferDate }}";
+                        readonly fromHolderId: "{{ context.holder.holderId }}";
+                        readonly toHolderId: "{{ event.toHolderId }}";
+                        readonly shares: "{{ context.shareCount }}";
+                        readonly transferType: "{{ event.transferType }}";
+                        readonly pricePerShare: "{{ event.pricePerShare }}";
+                    };
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "TRANSFER_INITIATED";
+                    readonly payload: {
+                        readonly securityId: "{{ context.securityId }}";
+                        readonly transferId: "{{ event.transferId }}";
+                        readonly fromHolderId: "{{ context.holder.holderId }}";
+                        readonly toHolderId: "{{ event.toHolderId }}";
+                    };
+                }];
+            };
+            readonly complete_transfer: {
+                readonly from: "TRANSFERRED";
+                readonly to: "ISSUED";
+                readonly description: "Complete the transfer, update holder";
+                readonly event: {
+                    readonly name: "complete_transfer";
+                    readonly payload: {
+                        readonly transferAgentConfirmation: {
+                            readonly type: "string";
+                        };
+                        readonly newCertificateNumber: {
+                            readonly type: "string";
+                        };
+                        readonly toHolderId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly toHolderName: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly toHolderType: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly toAddress: {
+                            readonly type: "object";
+                        };
+                        readonly completedDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly costBasis: {
+                            readonly type: "number";
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "holder";
+                    readonly value: {
+                        readonly holderId: "{{ event.toHolderId }}";
+                        readonly holderType: "{{ event.toHolderType }}";
+                        readonly name: "{{ event.toHolderName }}";
+                        readonly address: "{{ event.toAddress }}";
+                        readonly acquisitionDate: "{{ event.completedDate }}";
+                        readonly acquisitionMethod: "PURCHASE";
+                        readonly costBasis: "{{ event.costBasis }}";
+                    };
+                }, {
+                    readonly type: "CONDITIONAL";
+                    readonly condition: "event.newCertificateNumber != null";
+                    readonly then: {
+                        readonly type: "SET_CONTEXT";
+                        readonly path: "certificateNumber";
+                        readonly value: "{{ event.newCertificateNumber }}";
+                    };
+                }, {
+                    readonly type: "UPDATE_ARRAY_ITEM";
+                    readonly path: "transferHistory";
+                    readonly matchKey: "toHolderId";
+                    readonly matchValue: "{{ event.toHolderId }}";
+                    readonly updates: {
+                        readonly transferAgentConfirmation: "{{ event.transferAgentConfirmation }}";
+                    };
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "TRANSFER_COMPLETED";
+                    readonly payload: {
+                        readonly securityId: "{{ context.securityId }}";
+                        readonly newHolderId: "{{ event.toHolderId }}";
+                    };
+                }];
+            };
+            readonly repurchase: {
+                readonly from: "ISSUED";
+                readonly to: "TREASURY";
+                readonly description: "Company repurchases shares from holder";
+                readonly event: {
+                    readonly name: "repurchase";
+                    readonly payload: {
+                        readonly repurchaseDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly pricePerShare: {
+                            readonly type: "number";
+                            readonly required: true;
+                        };
+                        readonly boardResolutionRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly repurchaseAgreementRef: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "hasRepurchaseResolution";
+                    readonly crossMachine: {
+                        readonly machine: "corporate-resolution";
+                        readonly instanceRef: "{{ event.boardResolutionRef }}";
+                        readonly requiredState: "EXECUTED";
+                    };
+                }];
+                readonly effects: readonly [{
+                    readonly type: "APPEND_ARRAY";
+                    readonly path: "transferHistory";
+                    readonly value: {
+                        readonly transferId: "REPURCHASE-{{ event.repurchaseDate }}";
+                        readonly transferDate: "{{ event.repurchaseDate }}";
+                        readonly fromHolderId: "{{ context.holder.holderId }}";
+                        readonly toHolderId: "TREASURY";
+                        readonly shares: "{{ context.shareCount }}";
+                        readonly transferType: "INTERNAL";
+                        readonly pricePerShare: "{{ event.pricePerShare }}";
+                    };
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "holder";
+                    readonly value: {
+                        readonly holderId: "TREASURY";
+                        readonly holderType: "TREASURY";
+                        readonly name: "Treasury Stock";
+                        readonly acquisitionDate: "{{ event.repurchaseDate }}";
+                        readonly acquisitionMethod: "PURCHASE";
+                        readonly costBasis: "{{ event.pricePerShare * context.shareCount }}";
+                    };
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "SHARES_REPURCHASED";
+                    readonly payload: {
+                        readonly securityId: "{{ context.securityId }}";
+                        readonly shares: "{{ context.shareCount }}";
+                        readonly pricePerShare: "{{ event.pricePerShare }}";
+                    };
+                }];
+            };
+            readonly reissue_from_treasury: {
+                readonly from: "TREASURY";
+                readonly to: "ISSUED";
+                readonly description: "Reissue treasury shares to a new holder";
+                readonly event: {
+                    readonly name: "reissue_from_treasury";
+                    readonly payload: {
+                        readonly holderId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly holderName: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly holderType: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly address: {
+                            readonly type: "object";
+                        };
+                        readonly reissueDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly issuancePrice: {
+                            readonly type: "number";
+                        };
+                        readonly boardResolutionRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "hasReissueResolution";
+                    readonly crossMachine: {
+                        readonly machine: "corporate-resolution";
+                        readonly instanceRef: "{{ event.boardResolutionRef }}";
+                        readonly requiredState: "EXECUTED";
+                    };
+                }];
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "holder";
+                    readonly value: {
+                        readonly holderId: "{{ event.holderId }}";
+                        readonly holderType: "{{ event.holderType }}";
+                        readonly name: "{{ event.holderName }}";
+                        readonly address: "{{ event.address }}";
+                        readonly acquisitionDate: "{{ event.reissueDate }}";
+                        readonly acquisitionMethod: "PURCHASE";
+                        readonly costBasis: "{{ event.issuancePrice * context.shareCount }}";
+                    };
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "TREASURY_SHARES_REISSUED";
+                    readonly payload: {
+                        readonly securityId: "{{ context.securityId }}";
+                        readonly holderId: "{{ event.holderId }}";
+                    };
+                }];
+            };
+            readonly retire: {
+                readonly from: readonly ["ISSUED", "TREASURY"];
+                readonly to: "RETIRED";
+                readonly description: "Retire shares (cancel them)";
+                readonly event: {
+                    readonly name: "retire";
+                    readonly payload: {
+                        readonly retiredDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly retirementMethod: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly boardResolutionRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly repurchasePrice: {
+                            readonly type: "number";
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "hasRetirementResolution";
+                    readonly crossMachine: {
+                        readonly machine: "corporate-resolution";
+                        readonly instanceRef: "{{ event.boardResolutionRef }}";
+                        readonly requiredState: "EXECUTED";
+                    };
+                }];
+                readonly effects: readonly [{
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "retirementDetails";
+                    readonly value: {
+                        readonly retiredDate: "{{ event.retiredDate }}";
+                        readonly retirementMethod: "{{ event.retirementMethod }}";
+                        readonly repurchasePrice: "{{ event.repurchasePrice }}";
+                        readonly boardResolutionRef: "{{ event.boardResolutionRef }}";
+                    };
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "holder";
+                    readonly value: null;
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "SHARES_RETIRED";
+                    readonly payload: {
+                        readonly securityId: "{{ context.securityId }}";
+                        readonly shareClass: "{{ context.shareClassName }}";
+                        readonly shares: "{{ context.shareCount }}";
+                    };
+                }];
+            };
+            readonly stock_split: {
+                readonly from: "ISSUED";
+                readonly to: "ISSUED";
+                readonly description: "Apply stock split to this lot";
+                readonly event: {
+                    readonly name: "stock_split";
+                    readonly payload: {
+                        readonly actionId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly splitRatio: {
+                            readonly type: "string";
+                            readonly required: true;
+                            readonly description: "e.g., '2:1' for 2-for-1 split";
+                        };
+                        readonly effectiveDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly resolutionRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly newShareCount: {
+                            readonly type: "integer";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "APPEND_ARRAY";
+                    readonly path: "corporateActions";
+                    readonly value: {
+                        readonly actionId: "{{ event.actionId }}";
+                        readonly actionType: "STOCK_SPLIT";
+                        readonly actionDate: "{{ event.effectiveDate }}";
+                        readonly ratio: "{{ event.splitRatio }}";
+                        readonly sharesBeforeAction: "{{ context.shareCount }}";
+                        readonly sharesAfterAction: "{{ event.newShareCount }}";
+                        readonly resolutionRef: "{{ event.resolutionRef }}";
+                    };
+                }, {
+                    readonly type: "SET_CONTEXT";
+                    readonly path: "shareCount";
+                    readonly value: "{{ event.newShareCount }}";
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "STOCK_SPLIT_APPLIED";
+                    readonly payload: {
+                        readonly securityId: "{{ context.securityId }}";
+                        readonly ratio: "{{ event.splitRatio }}";
+                        readonly newShareCount: "{{ event.newShareCount }}";
+                    };
+                }];
+            };
+            readonly declare_dividend: {
+                readonly from: "ISSUED";
+                readonly to: "ISSUED";
+                readonly description: "Record dividend declaration affecting this lot (for stock dividends)";
+                readonly event: {
+                    readonly name: "declare_dividend";
+                    readonly payload: {
+                        readonly actionId: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly dividendType: {
+                            readonly type: "string";
+                            readonly enum: readonly ["CASH", "STOCK"];
+                            readonly required: true;
+                        };
+                        readonly recordDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly paymentDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly cashAmount: {
+                            readonly type: "number";
+                        };
+                        readonly stockShares: {
+                            readonly type: "integer";
+                        };
+                        readonly resolutionRef: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                    };
+                };
+                readonly guards: readonly [{
+                    readonly name: "hasDividendResolution";
+                    readonly crossMachine: {
+                        readonly machine: "corporate-resolution";
+                        readonly instanceRef: "{{ event.resolutionRef }}";
+                        readonly requiredState: "EXECUTED";
+                    };
+                }];
+                readonly effects: readonly [{
+                    readonly type: "CONDITIONAL";
+                    readonly condition: "event.dividendType === 'STOCK'";
+                    readonly then: {
+                        readonly type: "APPEND_ARRAY";
+                        readonly path: "corporateActions";
+                        readonly value: {
+                            readonly actionId: "{{ event.actionId }}";
+                            readonly actionType: "STOCK_DIVIDEND";
+                            readonly actionDate: "{{ event.paymentDate }}";
+                            readonly sharesBeforeAction: "{{ context.shareCount }}";
+                            readonly sharesAfterAction: "{{ context.shareCount + event.stockShares }}";
+                            readonly resolutionRef: "{{ event.resolutionRef }}";
+                        };
+                    };
+                }, {
+                    readonly type: "CONDITIONAL";
+                    readonly condition: "event.dividendType === 'STOCK'";
+                    readonly then: {
+                        readonly type: "INCREMENT";
+                        readonly path: "shareCount";
+                        readonly amount: "{{ event.stockShares }}";
+                    };
+                }];
+            };
+            readonly remove_restriction: {
+                readonly from: "ISSUED";
+                readonly to: "ISSUED";
+                readonly description: "Remove or update restrictions on the shares";
+                readonly event: {
+                    readonly name: "remove_restriction";
+                    readonly payload: {
+                        readonly restrictionType: {
+                            readonly type: "string";
+                            readonly required: true;
+                        };
+                        readonly removedDate: {
+                            readonly type: "string";
+                            readonly format: "date";
+                            readonly required: true;
+                        };
+                        readonly reason: {
+                            readonly type: "string";
+                        };
+                        readonly legalOpinionRef: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+                readonly effects: readonly [{
+                    readonly type: "UPDATE_ARRAY";
+                    readonly path: "restrictions.restrictionType";
+                    readonly operation: "REMOVE";
+                    readonly value: "{{ event.restrictionType }}";
+                }, {
+                    readonly type: "COMPUTE";
+                    readonly path: "restrictions.isRestricted";
+                    readonly expression: "context.restrictions.restrictionType.length > 0";
+                }, {
+                    readonly type: "EMIT_EVENT";
+                    readonly eventType: "RESTRICTION_REMOVED";
+                    readonly payload: {
+                        readonly securityId: "{{ context.securityId }}";
+                        readonly restrictionType: "{{ event.restrictionType }}";
+                    };
+                }];
+            };
+        };
+        readonly crossMachineRefs: {
+            readonly entity: {
+                readonly machine: "corporate-entity";
+                readonly description: "Parent corporate entity with share class definitions";
+                readonly foreignKey: "entityId";
+            };
+            readonly resolutions: {
+                readonly machine: "corporate-resolution";
+                readonly description: "Board resolutions authorizing securities actions";
+                readonly foreignKey: "entityId";
+            };
+            readonly shareholders: {
+                readonly machine: "corporate-shareholders";
+                readonly description: "Shareholder meetings for determining voting rights";
+                readonly foreignKey: "entityId";
+            };
+        };
+        readonly metadata: {
+            readonly author: "OttoChain";
+            readonly license: "MIT";
+            readonly tags: readonly ["corporate", "governance", "securities", "stock", "equity", "certificates"];
+            readonly documentation: "https://ottochain.dev/docs/corporate/securities";
+        };
+    };
+};
+export type CorporateType = keyof typeof CORPORATE_DEFINITIONS;
 /**
- * Get the state machine definition for a corporate type.
+ * Get a corporate state machine definition by type.
+ * @param type - 'entity' | 'board' | 'shareholders' | 'securities'
  */
-export declare function getCorporateDefinition(type: CorporateDefinitionType): unknown;
+export declare function getCorporateDefinition(type: CorporateType): unknown;