@haneinfo/collaboration 0.13.1 → 0.13.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,179 +1,182 @@
1
- # Instance collaboration
2
-
3
- Immutable plain-text comments, a read-time activity timeline, and following for StateMachine instances.
4
- Install the collaboration plugin with StateMachine, identity, notification inbox, Prisma and optional
5
- RBAC capabilities. Include `prisma/collaboration.prisma` in the App schema and migrate it normally.
6
- No separate timeline event table is created. The package starts at 0.0.0 for a first minor release.
7
-
8
- Readers and writers must be the submitter, have `state-machine:instance:read`, or hold a reader grant. Comments cannot be
9
- updated or deleted through this package. Text is stored and returned literally: clients render it as
10
- text, without HTML or Markdown interpretation. Mentions use `@{userId}`; recipients must be active
11
- and currently able to read the instance. Agent/MCP comments are always marked `isAiGenerated`.
12
-
13
- HTTP routes under `/state-machine-instances/:id`: GET/POST `comments`, GET `timeline`, POST/DELETE
14
- `follow`. Reads accept offset (default 0) and limit (default 50, maximum 200). Timeline events sort by
15
- ascending timestamp then stable source-prefixed id, and expose `hasMore`. Sources are history,
16
- CHOICE decisions, issued numbers, notification failures and comments. Concurrent additions may
17
- change offset boundaries between separate requests; one request uses a database snapshot.
18
-
19
- Register `CollaborationMcpTools.registerInto(registry, { scopeNamespace })` in the App's existing
20
- internal MCP registry. Tools are `get_instance_comments`, `get_instance_timeline`,
21
- `comment_on_instance`, `follow_instance`, `unfollow_instance`; all require `<namespace>:instance:read`
22
- transport scope plus live instance-read authorization. User text and timeline details use
23
- `$userContent` wrappers. The package creates no public endpoint or new business permission.
24
-
25
- Following is unique per instance/user and covers every subsequent transition and new comment.
26
- The approved `state-machine.transition.recorded` event is consumed through `StateMachineListener.onEvent`
27
- inside the originating transaction, independent of stale state-entry suppression. Transition
28
- notifications use the existing `state-machine-transition:<historyId>` key. Comment notifications use
29
- `collaboration-comment:<commentId>`, union followers, mentions and submitter, exclude the author, and recheck each
30
- recipient's active identity and instance-read permission immediately before delivery. The inbox's
31
- recipient/key unique constraint handles replay and overlap with transition-action notifications.
32
- Transition followers do not add an automatic submitter notification unless that person follows;
33
- existing transition notify actions keep their recipient semantics.
34
-
35
- Configuration: `collaboration: { appName?: string }`. App name defaults to `app`. No subscription
36
- rules, event-type filtering, comment editing, or alternate objects are provided.
37
-
38
- Mutating tools additionally declare `mutates: true`. Both the generated catalog and MCP wire
39
- annotations then report `readOnlyHint: false`, even for writes authorized by existing read scopes.
40
- This conservative declaration cannot turn a write scope into a read-only operation.
41
-
42
- ## Instance readers and stored query values
43
-
44
- Instance readers have the same discussion and following access as the submitter or a holder of
45
- `state-machine:instance:read`. Apply the state-machine reader-table migration and existing-task
46
- backfill before upgrading. Reader checks use the caller transaction, including mention validation
47
- and delivery; task status does not revoke readership.
48
-
49
- Comment recipients are the deduplicated union of followers, mentions and submitter, excluding
50
- the author even if they follow or mention themselves. Other recipients receive one notification.
51
- Transition notifications keep their existing behavior, including notifications to an actor who
52
- follows the instance. ADMIN has no new special case.
53
-
54
- ## Mechanism compatibility
55
-
56
- Supports state-machine 0.7 as well as 0.6. Instance readership continues to use the existing
57
- StateMachine contract; Collaboration does not implement condition comparison operators.
58
-
59
- ## Frontend contracts
60
-
61
- GET /state-machine-instances/:id/mentionable?q= returns { items: [{ id, name }] }, at most 20 active readers other than the caller. Names may be null. Matching uses case-insensitive name containment; an empty q searches all names. q is at most 200 characters. A nonreader receives INSTANCE_NOT_FOUND (404), exactly like a missing instance.
62
-
63
- IdentityStorePort.searchActiveByName owns database filtering and keyset pages of at most 20 candidates. Upgrade identity-core with collaboration. Missing optional identity search fails closed with IDENTITY_SEARCH_UNAVAILABLE (503). Collaboration evaluates each candidate through the existing effective RBAC authorization and reader grant check; it does not query role tables or reproduce role policy. Memory is bounded by one candidate page plus 20 results; a sparse query can require many bounded queries. Results are ordered by identity id. Comments revalidate mentions when posted.
64
-
65
- GET comments and GET timeline now include following: boolean for the caller, queried in the same transaction as the page. MCP get_instance_comments and get_instance_timeline preserve following. New list_mentionable_users accepts { instanceId, q? }, uses <namespace>:instance:read, is read-only, and wraps each name in $userContent. The manifest declares all six tools; no confirmation or new mutation tool is added.
66
-
67
- ## Instance privacy alignment
68
-
69
- Collaboration already returns identical INSTANCE_NOT_FOUND/404 for missing and unreadable instances before comments, timeline, mentions and follow operations. State-machine now applies the same hiding behavior before human writes; collaboration authorization is unchanged. No general-user people lookup is added.
70
-
71
- ## Delegated transition timeline
72
-
73
- History timeline details optionally include actingUserId and onBehalfOfId from the existing history
74
- decision JSON, allowing clients to display who acted for whom. actorId, triggerRef and every existing
75
- field retain their meanings. No new table, timeline kind, frontend or historical name snapshot is
76
- added. Permanent instance readers, including past delegates, retain read/comment access.
77
-
78
-
79
- ## Instance access lists (draft implementation)
80
-
81
- Implemented against draft decision 202610-c8e3; the decision remains draft.
82
-
83
- Comments, mentions, mentionable discovery, follows and notification recipients use the submitter,
84
- effective instance:read, or matching USER/ROLE access (READ or WRITE). Losing manual/role access
85
- immediately blocks new reads, mentions and notifications; old inbox entries are retained.
86
- The existing timeline SQL union classifies triggerType ACCESS as kind ACCESS and preserves the
87
- existing details fields, adding decision.access with the action, principal and previous/new levels.
88
- No state transition, revision bump or follower transition notification is generated for access changes.
89
- MCP wraps decision as $userContent, including access activity. User/grantor names are plain text.
90
-
91
- Upgrade the affected mechanisms together after applying the App migration. The maintained model,
92
- HTTP routes, read-only list_instance_access MCP tool, errors and permission contract are documented
93
- in @haneinfo/state-machine/agent-guide.md. Its prisma/instance-access.sql migrates the existing reader
94
- table to USER/ROLE, READ/WRITE and ASSIGNED/DELEGATED/GRANTED rows while retaining timestamps.
95
- The maintainer selected (instanceId, principalType, principalId, source) uniqueness. Manual grants are
96
- limited to 100 by default; permanent READ entries survive manual removal. See the package repository
97
- validation/equipment-loan/instance-access/report.md for SQL, tests and App restoration evidence.
98
-
99
- ## Optional attachments (draft decision 202610-5f3b)
100
-
101
- Attachment activity uses existing history with triggerType ATTACHMENT and optional decision.attachment (action, id, plain-text fileName). No storage keys, state/revision changes or notifications are introduced. Collaboration classifies these history rows as ATTACHMENT in its existing SQL union; MCP retains decision $userContent wrapping. See @haneinfo/attachments/agent-guide.md for authorization, storage, scanning, migration and retention. Apps adopting the optional package add its reverse instance relation; the core fragment does not depend on attachments.
102
-
103
-
104
- ## Document generation (draft 202610-d4f6)
105
-
106
- The optional @haneinfo/document-templates package adds DOCUMENT activity using existing history
107
- and decision.document (templateCode, templateVersion, format), attributed by triggerUserId.
108
- No tables, state/revision changes or notifications are added. Collaboration classifies the row
109
- as DOCUMENT in its existing authorized SQL timeline. Instance history and timeline fields remain
110
- unchanged. Read the document-templates agent guide for fonts, configuration, HTTP and read-only MCP.
111
-
112
-
113
- ## Instance lifecycle (draft 202610-f1a8)
114
-
115
- Implemented from draft decision 202610-f1a8; the decision remains draft. Upgrade state-machine,
116
- list-view, collaboration, attachments, import-export, assignment and timer together. No frontend,
117
- automatic archive or bulk lifecycle operations are included. Permanently purged data cannot be
118
- restored by this API: database and private file backups must cover the entire deletion retention
119
- period and be restored consistently.
120
-
121
- Apply prisma/instance-lifecycle.sql to add ON DELETE CASCADE foreign keys for comments/follows;
122
- add comments CollaborationComment[] and follows CollaborationFollow[] to the App's instance model.
123
- Check and reconcile pre-existing orphan rows before applying these constraints; migration does not
124
- silently delete them. The core fragment does not depend on this optional package. LIFECYCLE history
125
- joins the existing timeline UNION with the original event fields and optional decision.lifecycle.
126
- Actions are ARCHIVED, RESTORED, DELETED, UNDELETED; actorId and at retain who/when. Existing MCP
127
- decision wrapping applies. Deleted-instance comments, timeline, mentions and follows use the same
128
- missing-id 404. Archive does not block them. Lifecycle events produce no collaboration notifications.
129
-
130
-
131
- ## Instance tags (draft 202610-2c5d)
132
-
133
- Implemented from draft 202610-2c5d; the decision remains draft. See @haneinfo/tags/agent-guide.md
134
- for data, migration and authorization. The existing timeline SQL classifies TAG activities and retains all original fields/pagination.
135
- decision.tag contains action ADDED/REMOVED, normalizedKey and label; the existing MCP decision
136
- wrapper covers this user text. Each actual tag change has one activity and sends no notification.
137
-
138
- ## Unified search (draft 202610-a3d8)
139
-
140
- Draft implementation; the decision remains draft. Each comment emits
141
- `collaboration.comment.added` (instanceId, commentId, authorId, isAiGenerated, at; never the body)
142
- in the comment transaction. When the optional `SEARCH_PROVIDERS` registry is present (manifest
143
- optionalRequires `haneinfo.search`), CollaborationService registers `CommentsSearchProvider`: the
144
- newest `commentLimit` (default 200) comments, newest first, AI-generated included, composed with the
145
- shared plugin-api helpers and the configured row limit. Without @haneinfo/search nothing is
146
- registered and comments behave as before. The manifest requires plugin API 1.19.0.
147
-
148
- ## Object references (draft 202610-f7a2)
149
-
150
- The timeline SQL classifies `REFERENCE` history entries (written by the optional
151
- @haneinfo/references through state-machine) as the `REFERENCE` kind, with `decision.reference`
152
- (action LINKED or UNLINKED, linkId, kind, direction, other `{ type, id, number }`) in `details`;
153
- original fields, ordering and pagination are unchanged. No notification is sent.
154
-
155
- ## Spaces (draft 202610-b1d6)
156
-
157
- The timeline SQL classifies `SPACE` history entries (written by the optional @haneinfo/spaces
158
- through state-machine when an instance is placed, moved or taken out) as the `SPACE` kind, with
159
- `decision.space` (action PLACED, MOVED or REMOVED, nodeId, previousNodeId) in `details`; original
160
- fields, ordering and pagination are unchanged. No notification is sent.
161
-
162
- ## Structured timeline (draft 202610-a8d3)
163
-
164
- Draft implementation; the decision remains draft. Every timeline entry adds fields a client can turn
165
- into a sentence: `actor: { id, name } | null` (null for the system; names come from one batched
166
- `findActiveNamesByIds` per page and are null when unknown or inactive), `transition`, `fromState`,
167
- `toState` as `{ key, label }` from the instance's pinned machine in the request locale (`?locale=` or
168
- Accept-Language; zh-TW by default), and per kind: START `toState`; TRANSITION `trigger` (USER,
169
- ASSIGNMENT, TIMER, CHOICE) and `onBehalfOf`; CHOICE `outcome` (SELECTED, FAILED) and the selected
170
- target; NUMBER `text` (the number); NOTIFICATION_FAILURE `transition` and `reason`; COMMENT `text`,
171
- `mentions: [{ id, name }]`, `aiGenerated`; ACCESS `action` and `access: { principal: { type, id, name },
172
- level, previousLevel }`; ATTACHMENT and TAG `action` and `text`; REFERENCE `action` and
173
- `reference: { kind, direction, other: { type, id, number } }`; SPACE `action` and `space: { nodeId,
174
- previousNodeId }` (no node names); DOCUMENT `document: { templateCode, templateVersion, format }`;
175
- LIFECYCLE `action`. Link ids, attachment ids, CHOICE evidence and notification error details are not
176
- projected. `id`, `instanceId`, `actorId` and `details` are unchanged and deprecated: the instance
177
- frontend still reads them and they will be removed after it switches. MCP `get_instance_timeline`
178
- uses zh-TW and wraps names, labels and text as `$userContent` (details keep their previous wrapping).
179
- Readership is unchanged. Requires plugin API 1.26.0.
1
+ # Instance collaboration
2
+
3
+ Immutable plain-text comments, a read-time activity timeline, and following for StateMachine instances.
4
+ Install the collaboration plugin with StateMachine, identity, notification inbox, Prisma and optional
5
+ RBAC capabilities. Include `prisma/collaboration.prisma` in the App schema and migrate it normally.
6
+ No separate timeline event table is created. See package.json for the current package version.
7
+
8
+ Readers and writers must be the submitter, have `state-machine:instance:read`, or hold a reader grant. Comments cannot be
9
+ updated or deleted through this package. Text is stored and returned literally: clients render it as
10
+ text, without HTML or Markdown interpretation. Mentions use `@{userId}`; recipients must be active
11
+ and currently able to read the instance. Agent/MCP comments are always marked `isAiGenerated`.
12
+
13
+ HTTP routes under `/state-machine-instances/:id`: GET/POST `comments`, GET `timeline`, POST/DELETE
14
+ `follow`. Reads accept offset (default 0) and limit (default 50, maximum 200). Timeline events sort by
15
+ ascending timestamp then stable source-prefixed id, and expose `hasMore`. Sources are history,
16
+ CHOICE decisions, issued numbers, notification failures and comments. Concurrent additions may
17
+ change offset boundaries between separate requests; one request uses a database snapshot.
18
+
19
+ Register `CollaborationMcpTools.registerInto(registry, { scopeNamespace })` in the App's existing
20
+ internal MCP registry. Tools are `get_instance_comments`, `get_instance_timeline`,
21
+ `comment_on_instance`, `follow_instance`, `unfollow_instance`; all require `<namespace>:instance:read`
22
+ transport scope plus live instance-read authorization. User text and timeline details use
23
+ `$userContent` wrappers. The package creates no public endpoint or new business permission.
24
+
25
+ Following is unique per instance/user and covers every subsequent transition and new comment.
26
+ The approved `state-machine.transition.recorded` event is consumed through `StateMachineListener.onEvent`
27
+ inside the originating transaction, independent of stale state-entry suppression. Transition
28
+ notifications use the existing `state-machine-transition:<historyId>` key. Comment notifications use
29
+ `collaboration-comment:<commentId>`, union followers, mentions and submitter, exclude the author, and recheck each
30
+ recipient's active identity and instance-read permission immediately before delivery. The inbox's
31
+ recipient/key unique constraint handles replay and overlap with transition-action notifications.
32
+ Transition followers do not add an automatic submitter notification unless that person follows;
33
+ existing transition notify actions keep their recipient semantics.
34
+
35
+ Configuration: `collaboration: { appName?: string }`. App name defaults to `app`. No subscription
36
+ rules, event-type filtering, comment editing, or alternate objects are provided.
37
+
38
+ Transactions retry write conflicts and deadlocks up to six attempts with jitter, including
39
+ PostgreSQL 40001/40P01 errors wrapped by Prisma raw queries as P2010. Other errors are not retried.
40
+
41
+ Mutating tools additionally declare `mutates: true`. Both the generated catalog and MCP wire
42
+ annotations then report `readOnlyHint: false`, even for writes authorized by existing read scopes.
43
+ This conservative declaration cannot turn a write scope into a read-only operation.
44
+
45
+ ## Instance readers and stored query values
46
+
47
+ Instance readers have the same discussion and following access as the submitter or a holder of
48
+ `state-machine:instance:read`. Apply the state-machine reader-table migration and existing-task
49
+ backfill before upgrading. Reader checks use the caller transaction, including mention validation
50
+ and delivery; task status does not revoke readership.
51
+
52
+ Comment recipients are the deduplicated union of followers, mentions and submitter, excluding
53
+ the author even if they follow or mention themselves. Other recipients receive one notification.
54
+ Transition notifications keep their existing behavior, including notifications to an actor who
55
+ follows the instance. ADMIN has no new special case.
56
+
57
+ ## Mechanism compatibility
58
+
59
+ Supports state-machine 0.7 as well as 0.6. Instance readership continues to use the existing
60
+ StateMachine contract; Collaboration does not implement condition comparison operators.
61
+
62
+ ## Frontend contracts
63
+
64
+ GET /state-machine-instances/:id/mentionable?q= returns { items: [{ id, name }] }, at most 20 active readers other than the caller. Names may be null. Matching uses case-insensitive name containment; an empty q searches all names. q is at most 200 characters. A nonreader receives INSTANCE_NOT_FOUND (404), exactly like a missing instance.
65
+
66
+ IdentityStorePort.searchActiveByName owns database filtering and keyset pages of at most 20 candidates. Upgrade identity-core with collaboration. Missing optional identity search fails closed with IDENTITY_SEARCH_UNAVAILABLE (503). Collaboration evaluates each candidate through the existing effective RBAC authorization and reader grant check; it does not query role tables or reproduce role policy. Memory is bounded by one candidate page plus 20 results; a sparse query can require many bounded queries. Results are ordered by identity id. Comments revalidate mentions when posted.
67
+
68
+ GET comments and GET timeline now include following: boolean for the caller, queried in the same transaction as the page. MCP get_instance_comments and get_instance_timeline preserve following. New list_mentionable_users accepts { instanceId, q? }, uses <namespace>:instance:read, is read-only, and wraps each name in $userContent. The manifest declares all six tools; no confirmation or new mutation tool is added.
69
+
70
+ ## Instance privacy alignment
71
+
72
+ Collaboration already returns identical INSTANCE_NOT_FOUND/404 for missing and unreadable instances before comments, timeline, mentions and follow operations. State-machine now applies the same hiding behavior before human writes; collaboration authorization is unchanged. No general-user people lookup is added.
73
+
74
+ ## Delegated transition timeline
75
+
76
+ History timeline details optionally include actingUserId and onBehalfOfId from the existing history
77
+ decision JSON, allowing clients to display who acted for whom. actorId, triggerRef and every existing
78
+ field retain their meanings. No new table, timeline kind, frontend or historical name snapshot is
79
+ added. Permanent instance readers, including past delegates, retain read/comment access.
80
+
81
+
82
+ ## Instance access lists (implementation)
83
+
84
+ Implemented against approved decision 202610-c8e3.
85
+
86
+ Comments, mentions, mentionable discovery, follows and notification recipients use the submitter,
87
+ effective instance:read, or matching USER/ROLE access (READ or WRITE). Losing manual/role access
88
+ immediately blocks new reads, mentions and notifications; old inbox entries are retained.
89
+ The existing timeline SQL union classifies triggerType ACCESS as kind ACCESS and preserves the
90
+ existing details fields, adding decision.access with the action, principal and previous/new levels.
91
+ No state transition, revision bump or follower transition notification is generated for access changes.
92
+ MCP wraps decision as $userContent, including access activity. User/grantor names are plain text.
93
+
94
+ Upgrade the affected mechanisms together after applying the App migration. The maintained model,
95
+ HTTP routes, read-only list_instance_access MCP tool, errors and permission contract are documented
96
+ in @haneinfo/state-machine/agent-guide.md. Its prisma/instance-access.sql migrates the existing reader
97
+ table to USER/ROLE, READ/WRITE and ASSIGNED/DELEGATED/GRANTED rows while retaining timestamps.
98
+ The maintainer selected (instanceId, principalType, principalId, source) uniqueness. Manual grants are
99
+ limited to 100 by default; permanent READ entries survive manual removal. See the package repository
100
+ validation/equipment-loan/instance-access/report.md for SQL, tests and App restoration evidence.
101
+
102
+ ## Optional attachments (approved decision 202610-5f3b)
103
+
104
+ Attachment activity uses existing history with triggerType ATTACHMENT and optional decision.attachment (action, id, plain-text fileName). No storage keys, state/revision changes or notifications are introduced. Collaboration classifies these history rows as ATTACHMENT in its existing SQL union; MCP retains decision $userContent wrapping. See @haneinfo/attachments/agent-guide.md for authorization, storage, scanning, migration and retention. Apps adopting the optional package add its reverse instance relation; the core fragment does not depend on attachments.
105
+
106
+
107
+ ## Document generation (approved decision 202610-d4f6)
108
+
109
+ The optional @haneinfo/document-templates package adds DOCUMENT activity using existing history
110
+ and decision.document (templateCode, templateVersion, format), attributed by triggerUserId.
111
+ No tables, state/revision changes or notifications are added. Collaboration classifies the row
112
+ as DOCUMENT in its existing authorized SQL timeline. Instance history and timeline fields remain
113
+ unchanged. Read the document-templates agent guide for fonts, configuration, HTTP and read-only MCP.
114
+
115
+
116
+ ## Instance lifecycle (approved decision 202610-f1a8)
117
+
118
+ Implemented from approved decision 202610-f1a8. Upgrade state-machine,
119
+ list-view, collaboration, attachments, import-export, assignment and timer together. No frontend,
120
+ automatic archive or bulk lifecycle operations are included. Permanently purged data cannot be
121
+ restored by this API: database and private file backups must cover the entire deletion retention
122
+ period and be restored consistently.
123
+
124
+ Apply prisma/instance-lifecycle.sql to add ON DELETE CASCADE foreign keys for comments/follows;
125
+ add comments CollaborationComment[] and follows CollaborationFollow[] to the App's instance model.
126
+ Check and reconcile pre-existing orphan rows before applying these constraints; migration does not
127
+ silently delete them. The core fragment does not depend on this optional package. LIFECYCLE history
128
+ joins the existing timeline UNION with the original event fields and optional decision.lifecycle.
129
+ Actions are ARCHIVED, RESTORED, DELETED, UNDELETED; actorId and at retain who/when. Existing MCP
130
+ decision wrapping applies. Deleted-instance comments, timeline, mentions and follows use the same
131
+ missing-id 404. Archive does not block them. Lifecycle events produce no collaboration notifications.
132
+
133
+
134
+ ## Instance tags (approved decision 202610-2c5d)
135
+
136
+ Implemented from approved decision 202610-2c5d. See @haneinfo/tags/agent-guide.md
137
+ for data, migration and authorization. The existing timeline SQL classifies TAG activities and retains all original fields/pagination.
138
+ decision.tag contains action ADDED/REMOVED, normalizedKey and label; the existing MCP decision
139
+ wrapper covers this user text. Each actual tag change has one activity and sends no notification.
140
+
141
+ ## Unified search (approved decision 202610-a3d8)
142
+
143
+ Implemented under the approved decision. Each comment emits
144
+ `collaboration.comment.added` (instanceId, commentId, authorId, isAiGenerated, at; never the body)
145
+ in the comment transaction. When the optional `SEARCH_PROVIDERS` registry is present (manifest
146
+ optionalRequires `haneinfo.search`), CollaborationService registers `CommentsSearchProvider`: the
147
+ newest `commentLimit` (default 200) comments, newest first, AI-generated included, composed with the
148
+ shared plugin-api helpers and the configured row limit. Without @haneinfo/search nothing is
149
+ registered and comments behave as before. The manifest requires plugin API 1.19.0.
150
+
151
+ ## Object references (approved decision 202610-f7a2)
152
+
153
+ The timeline SQL classifies `REFERENCE` history entries (written by the optional
154
+ @haneinfo/references through state-machine) as the `REFERENCE` kind, with `decision.reference`
155
+ (action LINKED or UNLINKED, linkId, kind, direction, other `{ type, id, number }`) in `details`;
156
+ original fields, ordering and pagination are unchanged. No notification is sent.
157
+
158
+ ## Spaces (approved decision 202610-b1d6)
159
+
160
+ The timeline SQL classifies `SPACE` history entries (written by the optional @haneinfo/spaces
161
+ through state-machine when an instance is placed, moved or taken out) as the `SPACE` kind, with
162
+ `decision.space` (action PLACED, MOVED or REMOVED, nodeId, previousNodeId) in `details`; original
163
+ fields, ordering and pagination are unchanged. No notification is sent.
164
+
165
+ ## Structured timeline (approved decision 202610-a8d3)
166
+
167
+ Implemented under the approved decision. Every timeline entry adds fields a client can turn
168
+ into a sentence: `actor: { id, name } | null` (null for the system; names come from one batched
169
+ `findActiveNamesByIds` per page and are null when unknown or inactive), `transition`, `fromState`,
170
+ `toState` as `{ key, label }` from the instance's pinned machine in the request locale (`?locale=` or
171
+ Accept-Language; zh-TW by default), and per kind: START `toState`; TRANSITION `trigger` (USER,
172
+ ASSIGNMENT, TIMER, CHOICE) and `onBehalfOf`; CHOICE `outcome` (SELECTED, FAILED) and the selected
173
+ target; NUMBER `text` (the number); NOTIFICATION_FAILURE `transition` and `reason`; COMMENT `text`,
174
+ `mentions: [{ id, name }]`, `aiGenerated`; ACCESS `action` and `access: { principal: { type, id, name },
175
+ level, previousLevel }`; ATTACHMENT and TAG `action` and `text`; REFERENCE `action` and
176
+ `reference: { kind, direction, other: { type, id, number } }`; SPACE `action` and `space: { nodeId,
177
+ previousNodeId }` (no node names); DOCUMENT `document: { templateCode, templateVersion, format }`;
178
+ LIFECYCLE `action`. Link ids, attachment ids, CHOICE evidence and notification error details are not
179
+ projected. `id`, `instanceId`, `actorId` and `details` are unchanged and deprecated: the instance
180
+ frontend still reads them and they will be removed after it switches. MCP `get_instance_timeline`
181
+ uses zh-TW and wraps names, labels and text as `$userContent` (details keep their previous wrapping).
182
+ Readership is unchanged. Requires plugin API 1.26.0.
package/agent-guide.md CHANGED
@@ -8,7 +8,7 @@ Install the collaboration plugin with StateMachine, identity, notification inbox
8
8
 
9
9
  RBAC capabilities. Include `prisma/collaboration.prisma` in the App schema and migrate it normally.
10
10
 
11
- No separate timeline event table is created. The package starts at 0.0.0 for a first minor release.
11
+ No separate timeline event table is created. See package.json for the current package version.
12
12
 
13
13
 
14
14
 
@@ -116,9 +116,9 @@ field retain their meanings. No new table, timeline kind, frontend or historical
116
116
  added. Permanent instance readers, including past delegates, retain read/comment access.
117
117
 
118
118
 
119
- ## Instance access lists (draft implementation)
119
+ ## Instance access lists (implementation)
120
120
 
121
- Implemented against draft decision 202610-c8e3; the decision remains draft.
121
+ Implemented against approved decision 202610-c8e3.
122
122
 
123
123
  Comments, mentions, mentionable discovery, follows and notification recipients use the submitter,
124
124
  effective instance:read, or matching USER/ROLE access (READ or WRITE). Losing manual/role access
@@ -136,12 +136,12 @@ The maintainer selected (instanceId, principalType, principalId, source) uniquen
136
136
  limited to 100 by default; permanent READ entries survive manual removal. See the package repository
137
137
  validation/equipment-loan/instance-access/report.md for SQL, tests and App restoration evidence.
138
138
 
139
- ## Optional attachments (draft decision 202610-5f3b)
139
+ ## Optional attachments (approved decision 202610-5f3b)
140
140
 
141
141
  Attachment activity uses existing history with triggerType ATTACHMENT and optional decision.attachment (action, id, plain-text fileName). No storage keys, state/revision changes or notifications are introduced. Collaboration classifies these history rows as ATTACHMENT in its existing SQL union; MCP retains decision $userContent wrapping. See @haneinfo/attachments/agent-guide.md for authorization, storage, scanning, migration and retention. Apps adopting the optional package add its reverse instance relation; the core fragment does not depend on attachments.
142
142
 
143
143
 
144
- ## Document generation (draft 202610-d4f6)
144
+ ## Document generation (approved decision 202610-d4f6)
145
145
 
146
146
  The optional @haneinfo/document-templates package adds DOCUMENT activity using existing history
147
147
  and decision.document (templateCode, templateVersion, format), attributed by triggerUserId.
@@ -150,9 +150,9 @@ as DOCUMENT in its existing authorized SQL timeline. Instance history and timeli
150
150
  unchanged. Read the document-templates agent guide for fonts, configuration, HTTP and read-only MCP.
151
151
 
152
152
 
153
- ## Instance lifecycle (draft 202610-f1a8)
153
+ ## Instance lifecycle (approved decision 202610-f1a8)
154
154
 
155
- Implemented from draft decision 202610-f1a8; the decision remains draft. Upgrade state-machine,
155
+ Implemented from approved decision 202610-f1a8. Upgrade state-machine,
156
156
  list-view, collaboration, attachments, import-export, assignment and timer together. No frontend,
157
157
  automatic archive or bulk lifecycle operations are included. Permanently purged data cannot be
158
158
  restored by this API: database and private file backups must cover the entire deletion retention
@@ -168,14 +168,14 @@ decision wrapping applies. Deleted-instance comments, timeline, mentions and fol
168
168
  missing-id 404. Archive does not block them. Lifecycle events produce no collaboration notifications.
169
169
 
170
170
 
171
- ## Instance tags (draft 202610-2c5d)
171
+ ## Instance tags (approved decision 202610-2c5d)
172
172
 
173
- Implemented from draft 202610-2c5d; the decision remains draft. See @haneinfo/tags/agent-guide.md
173
+ Implemented from approved decision 202610-2c5d. See @haneinfo/tags/agent-guide.md
174
174
  for data, migration and authorization. The existing timeline SQL classifies TAG activities and retains all original fields/pagination.
175
175
  decision.tag contains action ADDED/REMOVED, normalizedKey and label; the existing MCP decision
176
176
  wrapper covers this user text. Each actual tag change has one activity and sends no notification.
177
177
 
178
- ## Unified search (draft 202610-a3d8)
178
+ ## Unified search (approved decision 202610-a3d8)
179
179
 
180
180
  Optional. With @haneinfo/search installed this package contributes its search source through
181
181
  SEARCH_PROVIDERS and value-free transactional events; see @haneinfo/search/agent-guide.md and this
@@ -1 +1 @@
1
- {"version":3,"file":"prisma-store.d.ts","sourceRoot":"","sources":["../src/prisma-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AA0BhF,qBAAa,wBAAyB,YAAW,kBAAkB;IACjE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;gBAClB,MAAM,EAAE,OAAO;IAGrB,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAO3D,QAAQ,CACZ,EAAE,EAAE,OAAO,EACX,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,SAAS,MAAM,EAAO;IAcnC;;;;OAIG;IACG,WAAW,CAAC,CAAC,EACjB,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,EACjC,SAAS,GAAE,gBAAgB,GAAG,eAAkC,GAC/D,OAAO,CAAC,CAAC,CAAC;IAUb,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,CAAC;IAGzE,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAQjE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAUxE,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM;IAQ/C,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,wBAAwB,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;0BAEV,MAAM,GAAG,IAAI;;CAqC3F"}
1
+ {"version":3,"file":"prisma-store.d.ts","sourceRoot":"","sources":["../src/prisma-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AA8BhF,qBAAa,wBAAyB,YAAW,kBAAkB;IACjE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;gBAClB,MAAM,EAAE,OAAO;IAGrB,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAO3D,QAAQ,CACZ,EAAE,EAAE,OAAO,EACX,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,SAAS,MAAM,EAAO;IAcnC;;;;OAIG;IACG,WAAW,CAAC,CAAC,EACjB,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,EACjC,SAAS,GAAE,gBAAgB,GAAG,eAAkC,GAC/D,OAAO,CAAC,CAAC,CAAC;IAUb,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,CAAC;IAGzE,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAQjE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAUxE,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM;IAQ/C,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,wBAAwB,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;0BAEV,MAAM,GAAG,IAAI;;CAqC3F"}
@@ -1,9 +1,17 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.PrismaCollaborationStore = void 0;
4
+ const common_1 = require("@haneinfo/common");
4
5
  const TRANSACTION_ATTEMPTS = 6;
5
- /** Prisma P2034: the transaction failed due to a write conflict or a deadlock. */
6
- const isWriteConflict = (error) => typeof error === 'object' && error !== null && error.code === 'P2034';
6
+ /** Prisma delegates use P2034; raw SQL wraps the same PostgreSQL aborts in P2010. */
7
+ const isWriteConflict = (error) => {
8
+ if ((0, common_1.isPrismaErrorCode)(error, 'P2034'))
9
+ return true;
10
+ if (!(0, common_1.isPrismaErrorCode)(error, 'P2010'))
11
+ return false;
12
+ const value = error;
13
+ return value.meta?.code === '40P01' || value.meta?.code === '40001';
14
+ };
7
15
  class PrismaCollaborationStore {
8
16
  constructor(prisma) {
9
17
  this.db = prisma;
@@ -1 +1 @@
1
- {"version":3,"file":"prisma-store.js","sourceRoot":"","sources":["../src/prisma-store.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"prisma-store.js","sourceRoot":"","sources":["../src/prisma-store.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@haneinfo/collaboration",
3
- "version": "0.13.1",
3
+ "version": "0.13.3",
4
4
  "private": false,
5
5
  "description": "Immutable instance comments, merged timelines and following.",
6
6
  "files": [
@@ -29,16 +29,16 @@
29
29
  "./prisma/collaboration.prisma": "./prisma/collaboration.prisma"
30
30
  },
31
31
  "dependencies": {
32
- "@haneinfo/plugin-api": "1.26.0"
32
+ "@haneinfo/plugin-api": "1.28.0"
33
33
  },
34
34
  "peerDependencies": {
35
- "@haneinfo/common": "^0.3.4 || ^0.4.0 || ^0.5.0",
35
+ "@haneinfo/common": "^0.6.1",
36
36
  "@haneinfo/plugin-host-nest": "^2.1.0",
37
37
  "@nestjs/common": "^11.0.0",
38
38
  "@nestjs/core": "^11.0.0",
39
39
  "@prisma/client": "^6.19.0",
40
40
  "zod": "^4.4.0",
41
- "@haneinfo/state-machine": "^0.6.0 || ^0.7.0 || ^0.8.0 || ^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0 || ^0.13.0 || ^0.14.0 || ^0.15.0 || ^0.16.0 || ^0.17.0 || ^0.18.0 || ^0.19.0 || ^0.20.0 || ^0.21.0 || ^0.22.0 || ^0.23.0 || ^0.24.0"
41
+ "@haneinfo/state-machine": "^0.6.0 || ^0.7.0 || ^0.8.0 || ^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0 || ^0.13.0 || ^0.14.0 || ^0.15.0 || ^0.16.0 || ^0.17.0 || ^0.18.0 || ^0.19.0 || ^0.20.0 || ^0.21.0 || ^0.22.0 || ^0.23.0 || ^0.24.0 || ^0.25.0"
42
42
  },
43
43
  "devDependencies": {
44
44
  "@nestjs/common": "^11.0.0",
@@ -48,12 +48,12 @@
48
48
  "typescript": "^5.9.3",
49
49
  "vitest": "^4.1.11",
50
50
  "zod": "^4.4.0",
51
- "@haneinfo/common": "0.5.0",
52
- "@haneinfo/definition-registry": "0.2.5",
53
- "@haneinfo/form": "0.5.0",
54
- "@haneinfo/state-machine": "0.24.0",
55
- "@haneinfo/plugin-host-nest": "2.1.0",
56
- "@haneinfo/plugin-testkit": "2.3.0"
51
+ "@haneinfo/common": "0.6.1",
52
+ "@haneinfo/definition-registry": "0.2.7",
53
+ "@haneinfo/form": "0.6.1",
54
+ "@haneinfo/state-machine": "0.25.2",
55
+ "@haneinfo/plugin-testkit": "2.3.1",
56
+ "@haneinfo/plugin-host-nest": "2.1.1"
57
57
  },
58
58
  "license": "UNLICENSED",
59
59
  "publishConfig": {
@@ -1,25 +1,25 @@
1
- /// Immutable plain-text discussion. Mutation routes are deliberately absent. @internal
2
- model CollaborationComment {
3
- id String @id @default(cuid())
4
- instanceId String @map("instance_id")
5
- instance StateMachineInstance @relation(fields: [instanceId], references: [id], onDelete: Cascade)
6
- authorId String @map("author_id")
7
- body String
8
- isAiGenerated Boolean @default(false) @map("is_ai_generated")
9
- mentions String[]
10
- createdAt DateTime @default(now()) @map("created_at")
11
-
12
- @@index([instanceId, createdAt, id])
13
- @@map("collaboration_comments")
14
- }
15
-
16
- /// A single user's interest in all future transitions and comments. @internal
17
- model CollaborationFollow {
18
- instanceId String @map("instance_id")
19
- instance StateMachineInstance @relation(fields: [instanceId], references: [id], onDelete: Cascade)
20
- userId String @map("user_id")
21
- createdAt DateTime @default(now()) @map("created_at")
22
-
23
- @@id([instanceId, userId])
24
- @@map("collaboration_follows")
25
- }
1
+ /// Immutable plain-text discussion. Mutation routes are deliberately absent. @internal
2
+ model CollaborationComment {
3
+ id String @id @default(cuid())
4
+ instanceId String @map("instance_id")
5
+ instance StateMachineInstance @relation(fields: [instanceId], references: [id], onDelete: Cascade)
6
+ authorId String @map("author_id")
7
+ body String
8
+ isAiGenerated Boolean @default(false) @map("is_ai_generated")
9
+ mentions String[]
10
+ createdAt DateTime @default(now()) @map("created_at")
11
+
12
+ @@index([instanceId, createdAt, id])
13
+ @@map("collaboration_comments")
14
+ }
15
+
16
+ /// A single user's interest in all future transitions and comments. @internal
17
+ model CollaborationFollow {
18
+ instanceId String @map("instance_id")
19
+ instance StateMachineInstance @relation(fields: [instanceId], references: [id], onDelete: Cascade)
20
+ userId String @map("user_id")
21
+ createdAt DateTime @default(now()) @map("created_at")
22
+
23
+ @@id([instanceId, userId])
24
+ @@map("collaboration_follows")
25
+ }
@@ -1,4 +1,4 @@
1
- ALTER TABLE collaboration_comments ADD CONSTRAINT collaboration_comments_instance_id_fkey
2
- FOREIGN KEY(instance_id) REFERENCES state_machine_instances(id) ON DELETE CASCADE ON UPDATE CASCADE;
3
- ALTER TABLE collaboration_follows ADD CONSTRAINT collaboration_follows_instance_id_fkey
4
- FOREIGN KEY(instance_id) REFERENCES state_machine_instances(id) ON DELETE CASCADE ON UPDATE CASCADE;
1
+ ALTER TABLE collaboration_comments ADD CONSTRAINT collaboration_comments_instance_id_fkey
2
+ FOREIGN KEY(instance_id) REFERENCES state_machine_instances(id) ON DELETE CASCADE ON UPDATE CASCADE;
3
+ ALTER TABLE collaboration_follows ADD CONSTRAINT collaboration_follows_instance_id_fkey
4
+ FOREIGN KEY(instance_id) REFERENCES state_machine_instances(id) ON DELETE CASCADE ON UPDATE CASCADE;