@happyvertical/smrt-projects 0.57.18 → 0.57.20

package/dist/smrt-knowledge.json

@@ -3,13 +3,13 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-projects",
-  "packageVersion": "0.57.18",
+  "packageVersion": "0.57.20",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "ed54dfcc4f478d14ef4e588174a145b2cf21d283bf3047ddbd2ae55813a5133c",
-    "packageJson": "26b49102140a468173da8a702a8056732f2b07fb0e72d561b062794f8bdc93b1",
-    "agents": "014098eac2bb1699b653ccd3029e062a2312a521862e39225dd8ca73b6ae8206"
+    "manifest": "bd228c7fb50de4a0cad46486ab8d743676edd269f9d1192df6de113f9e303ca4",
+    "packageJson": "b277c7069fbbc73e8db9d8b2dcd2951110358bd80c613a521b2d92ea5ab95950",
+    "agents": "2879830c12902195bd4f887cf00bdabbe8e7216ebafe2a9b2d007a00d137435c"
   },
   "exports": [
     ".",
@@ -79,6 +79,7 @@
     "smrt"
   ],
   "risks": [
+    "polymorphic-associations:4",
     "sensitive-fields-excluded",
     "sti-inheritance"
   ],
@@ -460,6 +461,101 @@
       "tags": [],
       "risks": []
     },
+    {
+      "name": "ProjectDecisionCollection",
+      "qualifiedName": "@happyvertical/smrt-projects:ProjectDecisionCollection",
+      "collection": "projectdecisions",
+      "tableName": "project_decisions",
+      "packageName": "@happyvertical/smrt-projects",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "getForProject",
+        "listForProject"
+      ],
+      "methodSignatures": [
+        {
+          "name": "getForProject",
+          "async": true,
+          "params": [
+            "scope: ProjectGovernanceScope",
+            "id: string"
+          ],
+          "returns": "Promise<ProjectDecision | null>"
+        },
+        {
+          "name": "listForProject",
+          "async": true,
+          "params": [
+            "scope: ProjectGovernanceScope",
+            "status?: ProjectDecisionStatus",
+            "visibility?: ProjectGovernanceVisibility"
+          ],
+          "returns": "Promise<ProjectDecision[]>"
+        }
+      ],
+      "surfaces": [],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "getForProject",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectDecisionCollection"
+        },
+        {
+          "kind": "api",
+          "operation": "listForProject",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectDecisionCollection"
+        }
+      ],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ProjectGovernanceEventCollection",
+      "qualifiedName": "@happyvertical/smrt-projects:ProjectGovernanceEventCollection",
+      "collection": "projectgovernanceevents",
+      "tableName": "project_governance_events",
+      "packageName": "@happyvertical/smrt-projects",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "listForRecord"
+      ],
+      "methodSignatures": [
+        {
+          "name": "listForRecord",
+          "async": true,
+          "params": [
+            "input: object"
+          ],
+          "returns": "Promise<ProjectGovernanceEvent[]>"
+        }
+      ],
+      "surfaces": [],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "listForRecord",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectGovernanceEventCollection"
+        }
+      ],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
     {
       "name": "ProjectIntegrationAuditCollection",
       "qualifiedName": "@happyvertical/smrt-projects:ProjectIntegrationAuditCollection",
@@ -621,6 +717,101 @@
       "tags": [],
       "risks": []
     },
+    {
+      "name": "ProjectQuestionCollection",
+      "qualifiedName": "@happyvertical/smrt-projects:ProjectQuestionCollection",
+      "collection": "projectquestions",
+      "tableName": "project_questions",
+      "packageName": "@happyvertical/smrt-projects",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "getForProject",
+        "listForProject"
+      ],
+      "methodSignatures": [
+        {
+          "name": "getForProject",
+          "async": true,
+          "params": [
+            "scope: ProjectGovernanceScope",
+            "id: string"
+          ],
+          "returns": "Promise<ProjectQuestion | null>"
+        },
+        {
+          "name": "listForProject",
+          "async": true,
+          "params": [
+            "scope: ProjectGovernanceScope",
+            "status?: ProjectQuestionStatus",
+            "visibility?: ProjectGovernanceVisibility"
+          ],
+          "returns": "Promise<ProjectQuestion[]>"
+        }
+      ],
+      "surfaces": [],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "getForProject",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectQuestionCollection"
+        },
+        {
+          "kind": "api",
+          "operation": "listForProject",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectQuestionCollection"
+        }
+      ],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ProjectSpecificationCollection",
+      "qualifiedName": "@happyvertical/smrt-projects:ProjectSpecificationCollection",
+      "collection": "projectspecifications",
+      "tableName": "project_specifications",
+      "packageName": "@happyvertical/smrt-projects",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "getForProject"
+      ],
+      "methodSignatures": [
+        {
+          "name": "getForProject",
+          "async": true,
+          "params": [
+            "scope: ProjectGovernanceScope"
+          ],
+          "returns": "Promise<ProjectSpecification | null>"
+        }
+      ],
+      "surfaces": [],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "getForProject",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectSpecificationCollection"
+        }
+      ],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
     {
       "name": "ProjectCollection",
       "qualifiedName": "@happyvertical/smrt-projects:ProjectCollection",
@@ -1436,7 +1627,7 @@
         {
           "name": "integrationId",
           "type": "foreignKey",
-          "required": true,
+          "required": false,
           "related": "ProjectIntegration",
           "columnType": "UUID"
         },
@@ -1508,7 +1699,7 @@
         {
           "name": "integrationId",
           "type": "foreignKey",
-          "required": true,
+          "required": false,
           "related": "ProjectIntegration",
           "columnType": "UUID"
         }
@@ -2904,14 +3095,38 @@
       "risks": []
     },
     {
-      "name": "ProjectIntegration",
-      "qualifiedName": "@happyvertical/smrt-projects:ProjectIntegration",
-      "displayLabelField": "name",
-      "collection": "projectintegrations",
-      "tableName": "project_integrations",
+      "name": "ProjectDecision",
+      "qualifiedName": "@happyvertical/smrt-projects:ProjectDecision",
+      "collection": "projectdecisions",
+      "tableName": "project_decisions",
       "packageName": "@happyvertical/smrt-projects",
-      "extends": "SmrtObject",
+      "extends": "SmrtPolymorphicAssociation",
       "fields": [
+        {
+          "name": "metaType",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "metaId",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "role",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "sortOrder",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER",
+          "default": 0
+        },
         {
           "name": "tenantId",
           "type": "text",
@@ -2919,35 +3134,71 @@
           "columnType": "UUID"
         },
         {
-          "name": "projectId",
+          "name": "question",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "decisionOptions",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "outcome",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "rationale",
           "type": "text",
           "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "status",
+          "type": "text",
+          "required": true,
           "columnType": "TEXT",
-          "default": ""
+          "default": "open"
         },
         {
-          "name": "name",
+          "name": "ownerType",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
           "default": ""
         },
         {
-          "name": "capabilities",
-          "type": "json",
+          "name": "ownerId",
+          "type": "text",
           "required": false,
-          "columnType": "JSON",
-          "default": []
+          "columnType": "TEXT"
         },
         {
-          "name": "status",
+          "name": "visibility",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "active"
+          "default": "internal"
         },
         {
-          "name": "revokedAt",
+          "name": "contextReferences",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "revision",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER",
+          "default": 1
+        },
+        {
+          "name": "decidedAt",
           "type": "datetime",
           "required": false,
           "columnType": "TIMESTAMP"
@@ -2955,20 +3206,39 @@
       ],
       "relationships": [],
       "methods": [
-        "hasCapability",
-        "isActive"
+        "getContextReferences",
+        "getOptions",
+        "hydrate",
+        "setContextReferences",
+        "setOptions"
       ],
       "methodSignatures": [
         {
-          "name": "hasCapability",
+          "name": "getContextReferences",
+          "returns": "ProjectContextReference[]"
+        },
+        {
+          "name": "getOptions",
+          "returns": "ProjectDecisionOption[]"
+        },
+        {
+          "name": "hydrate",
+          "async": true,
+          "returns": "Promise<T | null>"
+        },
+        {
+          "name": "setContextReferences",
           "params": [
-            "capability: ProjectIntegrationCapability"
+            "value: ProjectContextReference[]"
           ],
-          "returns": "boolean"
+          "returns": "void"
         },
         {
-          "name": "isActive",
-          "returns": "boolean"
+          "name": "setOptions",
+          "params": [
+            "value: ProjectDecisionOption[]"
+          ],
+          "returns": "void"
         }
       ],
       "tenant": {
@@ -2978,31 +3248,335 @@
       },
       "conflictColumns": [
         "tenant_id",
-        "project_id",
-        "name"
+        "slug",
+        "context"
       ],
-      "surfaces": [
+      "surfaces": [],
+      "withheldSurfaces": [
         {
           "kind": "api",
-          "name": "projectintegrations.list",
-          "operation": "list",
-          "objectName": "@happyvertical/smrt-projects:ProjectIntegration",
-          "path": "/projectintegrations",
-          "method": "GET"
+          "operation": "getContextReferences",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectDecision"
         },
         {
           "kind": "api",
-          "name": "projectintegrations.get",
-          "operation": "get",
-          "objectName": "@happyvertical/smrt-projects:ProjectIntegration",
-          "path": "/projectintegrations/[id]",
-          "method": "GET"
+          "operation": "getOptions",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectDecision"
         },
         {
-          "kind": "cli",
-          "name": "projectintegration_list",
-          "operation": "list",
-          "objectName": "@happyvertical/smrt-projects:ProjectIntegration"
+          "kind": "api",
+          "operation": "hydrate",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectDecision"
+        },
+        {
+          "kind": "api",
+          "operation": "setContextReferences",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectDecision"
+        },
+        {
+          "kind": "api",
+          "operation": "setOptions",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectDecision"
+        }
+      ],
+      "relationshipFeatures": [
+        "SmrtPolymorphicAssociation",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ProjectGovernanceEvent",
+      "qualifiedName": "@happyvertical/smrt-projects:ProjectGovernanceEvent",
+      "collection": "projectgovernanceevents",
+      "tableName": "project_governance_events",
+      "packageName": "@happyvertical/smrt-projects",
+      "extends": "SmrtPolymorphicAssociation",
+      "fields": [
+        {
+          "name": "metaType",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "metaId",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "role",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "sortOrder",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER",
+          "default": 0
+        },
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": true,
+          "columnType": "UUID"
+        },
+        {
+          "name": "recordKind",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT",
+          "default": "question"
+        },
+        {
+          "name": "action",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT",
+          "default": "created"
+        },
+        {
+          "name": "actorType",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT",
+          "default": "system"
+        },
+        {
+          "name": "actorId",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "fromStatus",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "toStatus",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "note",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "value",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "rationale",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "revision",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER",
+          "default": 1
+        },
+        {
+          "name": "fromOwnerType",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "fromOwnerId",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "toOwnerType",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "toOwnerId",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        }
+      ],
+      "relationships": [],
+      "methods": [
+        "beforeDelete",
+        "hydrate"
+      ],
+      "methodSignatures": [
+        {
+          "name": "beforeDelete",
+          "async": true,
+          "returns": "Promise<void>"
+        },
+        {
+          "name": "hydrate",
+          "async": true,
+          "returns": "Promise<T | null>"
+        }
+      ],
+      "tenant": {
+        "scoped": true,
+        "mode": "required",
+        "field": "tenantId"
+      },
+      "conflictColumns": [
+        "tenant_id",
+        "slug",
+        "context"
+      ],
+      "surfaces": [],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "beforeDelete",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectGovernanceEvent"
+        },
+        {
+          "kind": "api",
+          "operation": "hydrate",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectGovernanceEvent"
+        }
+      ],
+      "relationshipFeatures": [
+        "SmrtPolymorphicAssociation",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ProjectIntegration",
+      "qualifiedName": "@happyvertical/smrt-projects:ProjectIntegration",
+      "displayLabelField": "name",
+      "collection": "projectintegrations",
+      "tableName": "project_integrations",
+      "packageName": "@happyvertical/smrt-projects",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": true,
+          "columnType": "UUID"
+        },
+        {
+          "name": "projectId",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "name",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "capabilities",
+          "type": "json",
+          "required": false,
+          "columnType": "JSON",
+          "default": []
+        },
+        {
+          "name": "status",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": "active"
+        },
+        {
+          "name": "revokedAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        }
+      ],
+      "relationships": [],
+      "methods": [
+        "hasCapability",
+        "isActive"
+      ],
+      "methodSignatures": [
+        {
+          "name": "hasCapability",
+          "params": [
+            "capability: ProjectIntegrationCapability"
+          ],
+          "returns": "boolean"
+        },
+        {
+          "name": "isActive",
+          "returns": "boolean"
+        }
+      ],
+      "tenant": {
+        "scoped": true,
+        "mode": "required",
+        "field": "tenantId"
+      },
+      "conflictColumns": [
+        "tenant_id",
+        "project_id",
+        "name"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "projectintegrations.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-projects:ProjectIntegration",
+          "path": "/projectintegrations",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "projectintegrations.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-projects:ProjectIntegration",
+          "path": "/projectintegrations/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "projectintegration_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-projects:ProjectIntegration"
         },
         {
           "kind": "cli",
@@ -3108,6 +3682,298 @@
       "tags": [],
       "risks": []
     },
+    {
+      "name": "ProjectQuestion",
+      "qualifiedName": "@happyvertical/smrt-projects:ProjectQuestion",
+      "collection": "projectquestions",
+      "tableName": "project_questions",
+      "packageName": "@happyvertical/smrt-projects",
+      "extends": "SmrtPolymorphicAssociation",
+      "fields": [
+        {
+          "name": "metaType",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "metaId",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "role",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "sortOrder",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER",
+          "default": 0
+        },
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": true,
+          "columnType": "UUID"
+        },
+        {
+          "name": "prompt",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "answer",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "status",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT",
+          "default": "open"
+        },
+        {
+          "name": "ownerType",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "ownerId",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "visibility",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": "internal"
+        },
+        {
+          "name": "contextReferences",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "revision",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER",
+          "default": 1
+        },
+        {
+          "name": "answeredAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        }
+      ],
+      "relationships": [],
+      "methods": [
+        "getContextReferences",
+        "hydrate",
+        "setContextReferences"
+      ],
+      "methodSignatures": [
+        {
+          "name": "getContextReferences",
+          "returns": "ProjectContextReference[]"
+        },
+        {
+          "name": "hydrate",
+          "async": true,
+          "returns": "Promise<T | null>"
+        },
+        {
+          "name": "setContextReferences",
+          "params": [
+            "value: ProjectContextReference[]"
+          ],
+          "returns": "void"
+        }
+      ],
+      "tenant": {
+        "scoped": true,
+        "mode": "required",
+        "field": "tenantId"
+      },
+      "conflictColumns": [
+        "tenant_id",
+        "slug",
+        "context"
+      ],
+      "surfaces": [],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "getContextReferences",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectQuestion"
+        },
+        {
+          "kind": "api",
+          "operation": "hydrate",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectQuestion"
+        },
+        {
+          "kind": "api",
+          "operation": "setContextReferences",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectQuestion"
+        }
+      ],
+      "relationshipFeatures": [
+        "SmrtPolymorphicAssociation",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ProjectSpecification",
+      "qualifiedName": "@happyvertical/smrt-projects:ProjectSpecification",
+      "displayLabelField": "title",
+      "collection": "projectspecifications",
+      "description": "Canonical project requirements and their portable application cookbook.",
+      "tableName": "project_specifications",
+      "packageName": "@happyvertical/smrt-projects",
+      "extends": "SmrtPolymorphicAssociation",
+      "fields": [
+        {
+          "name": "metaType",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "metaId",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "role",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "sortOrder",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER",
+          "default": 0
+        },
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": true,
+          "columnType": "UUID"
+        },
+        {
+          "name": "title",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "summary",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "cookbook",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "revision",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER",
+          "default": 1
+        },
+        {
+          "name": "actorType",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "actorId",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        }
+      ],
+      "relationships": [],
+      "methods": [
+        "getCookbook",
+        "hydrate"
+      ],
+      "methodSignatures": [
+        {
+          "name": "getCookbook",
+          "returns": "Cookbook"
+        },
+        {
+          "name": "hydrate",
+          "async": true,
+          "returns": "Promise<T | null>"
+        }
+      ],
+      "tenant": {
+        "scoped": true,
+        "mode": "required",
+        "field": "tenantId"
+      },
+      "conflictColumns": [
+        "tenant_id",
+        "meta_type",
+        "meta_id"
+      ],
+      "surfaces": [],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "getCookbook",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectSpecification"
+        },
+        {
+          "kind": "api",
+          "operation": "hydrate",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-projects:ProjectSpecification"
+        }
+      ],
+      "relationshipFeatures": [
+        "SmrtPolymorphicAssociation",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
     {
       "name": "PullRequest",
       "qualifiedName": "@happyvertical/smrt-projects:PullRequest",
@@ -5267,10 +6133,10 @@
     "crossPackageRefFields": 0,
     "junctionCollections": 0,
     "hierarchicalObjects": 0,
-    "polymorphicAssociations": 0,
-    "uuidColumns": 87
+    "polymorphicAssociations": 4,
+    "uuidColumns": 103
   },
-  "agentDoc": "# @happyvertical/smrt-projects\n\nProvider-agnostic project management plus the managed-application delivery\ncontrol plane. Repository and board providers remain canonical; managed apps\nonly receive scoped Project Integration credentials and provider-neutral\nrequest/delivery projections.\n\n## Managed application delivery (#1949)\n\n- `ProjectIntegration` stores capability grants and a sensitive credential\n  hash; the raw credential is returned once by\n  `ProjectIntegrationCollection.provision()`/`rotate()` and is never persisted.\n  Provisioning, rotation, and revocation are append-only audited.\n- The stable requester identity is supplied when authenticating\n  `ManagedProjectClient`; request reads are always restricted to that requester\n  and integration.\n- `DevelopmentRequest` preserves evidence, origin, discussion, visibility, and\n  lifecycle history. `ManagedProjectClient` owns managed intake and\n  `DevelopmentRequestService` adds internal triage and work projection.\n- `DevelopmentRequestWorkLink` connects zero-to-many provider-neutral work\n  items. Canonical status stays on the link and drives request lifecycle\n  projection without granting the managed app provider credentials.\n- `ProjectDeliveryEvent` is idempotent per integration key and sequenced for\n  replay. Preview decisions flow through the control-plane adapter, never\n  directly to repository providers.\n- `AssistanceRequest` preserves conversational intake before lossless routing\n  to Support, Development, or both. `smrt-support` supplies the concrete\n  `ProjectAssistanceSupportAdapter`.\n- `ManagedProjectClient` deliberately exposes no repository or board client;\n  delivery and assistance use separate capability-gated service facades.\n\n## Shared Professional Service evidence (#1955, #3288)\n\n`ServiceTimeEntry`, `ServiceChargeSnapshot`, `ServiceCompensationSnapshot`,\ntheir collections, and `ServiceEvidenceService` are owned by\n`@happyvertical/smrt-timesheets` (#3288) and **re-exported** here unchanged,\non the unchanged `service_time_entries` / snapshot tables. Do not reintroduce\na projects subclass: a third same-named class on the table breaks the\nsingle-table-family resolution (see `packages/timesheets/AGENTS.md`).\n`caseId` / `specialistId` exist only on smrt-support's subtype;\n`SubscriptionServiceCommercialResolver` reads them duck-typed when a support\nentry is priced. It prices client work through `smrt-subscriptions` (#1925);\nprovider compensation remains a separate resolver and snapshot. The\ntime-entry Svelte components are re-exported from smrt-timesheets too. See\n`SERVICE_TIME_MIGRATION.md`.\n\n## Models\n\n| Model | Key Fields | Notes |\n|-------|-----------|-------|\n| **Repository** | `owner`, `name`, `providerType`, `tokenConfigKey` | `sync()`, `getIssues()`, `getPullRequests()` |\n| **Issue** | `repositoryId` (optional FK), `projectId` (optional FK), `number`, `title`, `body`, `state`, `labels[]` | `incorporateFeedback()`, `rollback()`, `suggestLabels()` |\n| **PullRequest** | extends Issue + `headRef`, `baseRef`, `merged`, `draft` | STI on Issue table. `summarize()`, `merge()` |\n| **Project** | `projectId`, `title`, `statuses[]`, `statusFieldId` | GitHub Projects V2. `addItem()`, `moveItem()`, `analyzeHealth()` |\n| **Comment** | `issueId` (FK), `body`, `authorLogin` | AI analysis support |\n| **Label** | `repositoryId` (optional FK), `projectId` (optional FK), `name`, `color` | Scope: repository, project, or neither |\n\n## Key Patterns\n\n- **Repository is optional (project-native issues)**: an Issue/Label may carry only a `projectId`. `issue.hasRepository()` gates every provider call: `sync()` is a no-op, `close/addLabels/removeLabel/assign/addComment/rollback/incorporateFeedback(apply)` change local state only, `getComments()` reads stored `Comment` rows, `getRepository()` throws, `getUrl()` returns `''`. No unique key spans `repositoryId`+`number` (lookups only), so NULL repositories need no partial index. Schema change adds `issues.project_id`/`labels.project_id` and relaxes `repository_id` to nullable on both; `db:migrate` generates it from the manifest.\n\n- **Token config reference**: stores env var name (`tokenConfigKey: 'GITHUB_TOKEN'`), not the token itself. Resolved at runtime from `process.env` or `getModuleConfig()`\n- **Living spec** (`incorporateFeedback()`): AI synthesizes issue comments into updated body. Supports preview mode and `rollback()`\n- **Provider-agnostic**: GitHub primary, GitLab/Bitbucket/Azure planned. Uses `@happyvertical/repos` and `@happyvertical/projects` SDK packages\n- **PullRequest is STI on Issue**: shares table, discriminated by `_meta_type`\n\n## Collection Methods\n\nAll collections provide: `discover({ repository, filters })`, `findByRepository(repoId)`, `findOpen(repoId?)`, `batchSync(repository)`.\n\n## Gotchas\n\n- **Money is integer minor units** (cents) — `$19.99` is `1999`.\n  `ServiceChargeSnapshot.amount` and `ServiceCompensationSnapshot.amount`\n  (declared in smrt-timesheets)\n  initialize `= 0`, never `= 0.0`: the integer literal is what maps them to\n  INTEGER columns (BIGINT on fresh PostgreSQL/DuckDB databases; #2401, #2373). The two convert as a pair — the delivery margin is\n  `charge - compensation`, an exact integer subtraction with no tolerance —\n  and both are fed verbatim by `CommercialSnapshot.amount`, so a resolver that\n  returns major units is wrong on every engine: snapshot `save()` refuses a\n  fractional value (`19.99`) on SQLite and PostgreSQL alike, but a whole\n  major-unit value (`150` for $150.00) is a valid integer and is stored\n  100× too small. `pnpm --filter @happyvertical/smrt-timesheets\n  test:postgres` is the lane that holds the line (moved with the snapshots in\n  #3288).\n- **UI formats by dividing, never by `toFixed`**: `formatCurrency()` and\n  `ServiceEvidenceList`'s `money()` scale back to major units using the\n  currency's own minor-unit exponent, so zero-decimal currencies (JPY, KRW) are\n  not divided.\n- **Migrating an existing database**: `preflightProjectsMoneyMinorUnits(db)`\n  reports which columns still hold major units and which rows would be rounded\n  or exceed JavaScript's safe-integer range; `migrateProjectsMoneyToMinorUnits(db)` converts them\n  (idempotent via `_smrt_backfills`). On SQLite the values are rescaled but the\n  declared type needs the table-rebuild path (#2370). Fresh PostgreSQL/DuckDB\n  INTEGER columns are BIGINT and hydration rejects values outside JavaScript's\n  safe-integer range; existing PostgreSQL `int4` columns require #2424.\n- **SDK dependency**: requires `@happyvertical/repos` and `@happyvertical/projects` from SDK\n- **tokenConfigKey not tokenValue**: never store actual tokens in the database\n- **synthesisCount tracks incorporateFeedback calls**: incremented on each apply\n",
+  "agentDoc": "# @happyvertical/smrt-projects\n\nProvider-agnostic project management plus the managed-application delivery\ncontrol plane. Repository and board providers remain canonical; managed apps\nonly receive scoped Project Integration credentials and provider-neutral\nrequest/delivery projections.\n\n## Managed application delivery (#1949)\n\n- `ProjectIntegration` stores capability grants and a sensitive credential\n  hash; the raw credential is returned once by\n  `ProjectIntegrationCollection.provision()`/`rotate()` and is never persisted.\n  Provisioning, rotation, and revocation are append-only audited.\n- The stable requester identity is supplied when authenticating\n  `ManagedProjectClient`; request reads are always restricted to that requester\n  and integration.\n- `DevelopmentRequest` preserves evidence, origin, discussion, visibility, and\n  lifecycle history. `ManagedProjectClient` owns managed intake and\n  `DevelopmentRequestService` adds internal triage and work projection.\n- `DevelopmentRequestWorkLink` connects zero-to-many provider-neutral work\n  items. Canonical status stays on the link and drives request lifecycle\n  projection without granting the managed app provider credentials.\n- `ProjectDeliveryEvent` is idempotent per integration key and sequenced for\n  replay. Preview decisions flow through the control-plane adapter, never\n  directly to repository providers.\n- `AssistanceRequest` preserves conversational intake before lossless routing\n  to Support, Development, or both. `smrt-support` supplies the concrete\n  `ProjectAssistanceSupportAdapter`.\n- `ManagedProjectClient` deliberately exposes no repository or board client;\n  delivery and assistance use separate capability-gated service facades.\n\n## Shared Professional Service evidence (#1955, #3288)\n\n`ServiceTimeEntry`, `ServiceChargeSnapshot`, `ServiceCompensationSnapshot`,\ntheir collections, and `ServiceEvidenceService` are owned by\n`@happyvertical/smrt-timesheets` (#3288) and **re-exported** here unchanged,\non the unchanged `service_time_entries` / snapshot tables. Do not reintroduce\na projects subclass: a third same-named class on the table breaks the\nsingle-table-family resolution (see `packages/timesheets/AGENTS.md`).\n`caseId` / `specialistId` exist only on smrt-support's subtype;\n`SubscriptionServiceCommercialResolver` reads them duck-typed when a support\nentry is priced. It prices client work through `smrt-subscriptions` (#1925);\nprovider compensation remains a separate resolver and snapshot. The\ntime-entry Svelte components are re-exported from smrt-timesheets too. See\n`SERVICE_TIME_MIGRATION.md`.\n\n## Models\n\n| Model | Key Fields | Notes |\n|-------|-----------|-------|\n| **Repository** | `owner`, `name`, `providerType`, `tokenConfigKey` | `sync()`, `getIssues()`, `getPullRequests()` |\n| **Issue** | `repositoryId` (optional FK), `projectId` (optional FK), `number`, `title`, `body`, `state`, `labels[]` | `incorporateFeedback()`, `rollback()`, `suggestLabels()` |\n| **PullRequest** | extends Issue + `headRef`, `baseRef`, `merged`, `draft` | STI on Issue table. `summarize()`, `merge()` |\n| **Project** | `projectId`, `title`, `statuses[]`, `statusFieldId` | GitHub Projects V2. `addItem()`, `moveItem()`, `analyzeHealth()` |\n| **ProjectQuestion** | polymorphic project target, `prompt`, `answer`, owner, `status`, `revision` | Owner question lifecycle; mutate through `ProjectGovernanceService`. |\n| **ProjectDecision** | polymorphic project target, options, `outcome`, `rationale`, owner, `status`, `revision` | Project choice lifecycle; mutate through `ProjectGovernanceService`. |\n| **ProjectGovernanceEvent** | question/decision target, actor, action, status, revision | Immutable lifecycle history. |\n| **Comment** | `issueId` (FK), `body`, `authorLogin` | AI analysis support |\n| **Label** | `repositoryId` (optional FK), `projectId` (optional FK), `name`, `color` | Scope: repository, project, or neither |\n\n## Key Patterns\n\n- **Repository is optional (project-native issues)**: an Issue/Label may carry only a `projectId`. `issue.hasRepository()` gates every provider call: `sync()` is a no-op, `close/addLabels/removeLabel/assign/addComment/rollback/incorporateFeedback(apply)` change local state only, `getComments()` reads stored `Comment` rows, `getRepository()` throws, `getUrl()` returns `''`. No unique key spans `repositoryId`+`number` (lookups only), so NULL repositories need no partial index. Schema change adds `issues.project_id`/`labels.project_id` and relaxes `repository_id` to nullable on both; `db:migrate` generates it from the manifest.\n\n- **Token config reference**: stores env var name (`tokenConfigKey: 'GITHUB_TOKEN'`), not the token itself. Resolved at runtime from `process.env` or `getModuleConfig()`\n- **Living spec** (`incorporateFeedback()`): AI synthesizes issue comments into updated body. Supports preview mode and `rollback()`\n- **Provider-agnostic**: GitHub primary, GitLab/Bitbucket/Azure planned. Uses `@happyvertical/repos` and `@happyvertical/projects` SDK packages\n- **PullRequest is STI on Issue**: shares table, discriminated by `_meta_type`\n\n## Collection Methods\n\nAll collections provide: `discover({ repository, filters })`, `findByRepository(repoId)`, `findOpen(repoId?)`, `batchSync(repository)`.\n\n## Gotchas\n\n- **Money is integer minor units** (cents) — `$19.99` is `1999`.\n  `ServiceChargeSnapshot.amount` and `ServiceCompensationSnapshot.amount`\n  (declared in smrt-timesheets)\n  initialize `= 0`, never `= 0.0`: the integer literal is what maps them to\n  INTEGER columns (BIGINT on fresh PostgreSQL/DuckDB databases; #2401, #2373). The two convert as a pair — the delivery margin is\n  `charge - compensation`, an exact integer subtraction with no tolerance —\n  and both are fed verbatim by `CommercialSnapshot.amount`, so a resolver that\n  returns major units is wrong on every engine: snapshot `save()` refuses a\n  fractional value (`19.99`) on SQLite and PostgreSQL alike, but a whole\n  major-unit value (`150` for $150.00) is a valid integer and is stored\n  100× too small. `pnpm --filter @happyvertical/smrt-timesheets\n  test:postgres` is the lane that holds the line (moved with the snapshots in\n  #3288).\n- **UI formats by dividing, never by `toFixed`**: `formatCurrency()` and\n  `ServiceEvidenceList`'s `money()` scale back to major units using the\n  currency's own minor-unit exponent, so zero-decimal currencies (JPY, KRW) are\n  not divided.\n- **Migrating an existing database**: `preflightProjectsMoneyMinorUnits(db)`\n  reports which columns still hold major units and which rows would be rounded\n  or exceed JavaScript's safe-integer range; `migrateProjectsMoneyToMinorUnits(db)` converts them\n  (idempotent via `_smrt_backfills`). On SQLite the values are rescaled but the\n  declared type needs the table-rebuild path (#2370). Fresh PostgreSQL/DuckDB\n  INTEGER columns are BIGINT and hydration rejects values outside JavaScript's\n  safe-integer range; existing PostgreSQL `int4` columns require #2424.\n- **SDK dependency**: requires `@happyvertical/repos` and `@happyvertical/projects` from SDK\n- **tokenConfigKey not tokenValue**: never store actual tokens in the database\n- **synthesisCount tracks incorporateFeedback calls**: incremented on each apply\n",
   "recipes": [
     {
       "id": "projects.tracker",