@ycodium-ai/plugin-team 0.2.3433 → 0.2.3474

package/README.md

@@ -1,39 +1,52 @@
 # @ycodium-ai/plugin-team
 
-Save a project's team members, choose a lead, and give that lead a goal. The **Teams**
-project workbench tab on Web and Desktop opens a conversation for each member and sends the lead
+Manage a project's team members, choose a lead, and give that lead a goal. The **Teams**
+project workbench tab on Web and Desktop opens a conversation for each agent member and sends the lead
 a brief for splitting and assigning the work.
 
 This plugin is bundled with Ycodium as `core.team` and is enabled by default.
 It has no separate installation step in a bundled checkout. Enabling the plugin exposes the tab;
-disabling it removes the tab and commands. Saved roster and goal facts stay in the host event log,
+disabling it removes the tab and commands. The lead and goal facts stay in the host event log,
 and enabling it again rebuilds their state. Existing conversations remain in the conversation list.
 
-Each project has one roster of 1–8 members. Names must be distinct after trimming surrounding
-spaces and ignoring capitalization. One member must be the lead. Concurrent edits use revisions;
-the editor reloads the roster when another writer has saved a newer revision.
+A project's team is its active agent members, 1–8 of them, kept in the host's project members: the
+tab adds, edits, removes and restores them as you, and records you as the author. People can be
+members too but take no part in a goal. Names must be distinct after trimming surrounding spaces and
+ignoring capitalization. One local agent member must be the lead; the plugin stores only that choice.
+A roster saved before members lived in the host keeps working until you import it from the tab. On
+mobile the plugin's page lists the members read-only. The lead of the current goal can also add, change,
+remove and restore agent members with the `team_create_member`, `team_update_member`,
+`team_remove_member` and `team_restore_member` tools; the plugin writes those changes and keeps who asked
+in its own facts.
 
 Keep the project's board and project memory switches on so the lead can create work items and
-assign them to member conversations. Starting another goal asks for confirmation; the previous
+assign them to members. Starting another goal asks for confirmation; the previous
 goal's conversations keep running. If starting fails midway, Retry completes the same request
 without creating duplicate conversations or sending the lead another first turn.
 
+Work can be assigned to a member as well as to a conversation. The assignment wakes the conversation that runs
+for that member in the current goal, and the member starts it by moving it into progress. A member who joins
+while a goal is running gets a conversation of its own (an agent that has no goal to join waits for
+the next one); work already in a conversation's hands stays with it when the member later runs elsewhere. When
+a member is removed, the work that has not reached it is taken back and the lead is told.
+
 Starting a goal also puts the goal on the board as a work item assigned to the lead, recorded
 with this plugin as its author. The lead does no item itself, merging and pushing included; when
 everything the goal waits on is finished, it checks the results and marks the goal item done,
 and the goal bar shows that item's state.
 
 Member conversations initially have no messages. The project board shows up to 500 work items,
-supports creation and assignment to the current goal's members, and moves cards between states
+supports creation and assignment to the project's members, and moves cards between states
 by dragging or using the card menu.
 Open a card's details to read its description, follow dependencies, reply to comments, and see who changed it.
 It does not provide sorting or filters.
 Mobile does not render the project workbench seat.
-The plugin declares `work.read`, `work.writeAsPerson`, `communication.read` (to show people's names
-in history), the `project.workbench.tab` UI seat, and
-command dispatch permission for creating conversations, starting the lead's first turn, and
-creating or updating work items and posting comments. Work items and comments you change in the
-tab are recorded as yours, with this plugin shown as the source.
+The plugin declares `work.read`, `members.read`, `work.writeAsPerson`, `communication.read` (to show
+people's names in history), the `project.workbench.tab` UI seat, and
+command dispatch permission for creating conversations, starting the lead's first turn, creating or
+updating work items, posting comments, and adding, changing, removing and restoring project members.
+Work items, comments and members you change in the tab are recorded as yours, with this plugin shown as
+the source.
 
 Implementation and command shapes: [team plugin](../../docs/internals/team-plugin.md).