@sinoia/hubdoc-tools 1.9.0 → 1.11.0

package/docs/llm-usage.md

@@ -377,12 +377,36 @@ themselves. All commands support `--json` for machine parsing.
 | start | complete`.
 
 `hubdoc tickets --project=<pid>` — `ls | show | create | update | delete
-| assign | status | move | activities | deliverable | dispatch`. Every
-verb requires `--project=<pid>`. `ls --backlog` (or `ls --sprint null`)
-lists the backlog. `assign --to null` unassigns. `status --to <state>
-[--column <col>]` uses the canonical statuses: `open | in_progress | done
-| blocked | awaiting_human | cancelled | failed` and optionally pins the
-kanban column at the same time.
+| assign | set-agent | status | move | activities | deliverable |
+dispatch | comment | comments`. Every verb requires `--project=<pid>`.
+`ls --backlog` (or `ls --sprint null`) lists the backlog. `assign --to
+null` unassigns. `status --to <state> [--column <col>]` uses the
+canonical statuses: `open | in_progress | done | blocked |
+awaiting_human | cancelled | failed` and optionally pins the kanban
+column at the same time. `comment <id> --body <text>` (or `--body-file
+<path>`) posts a message on the ticket's discussion thread (visible in
+Corex / Agoria, attributed to the token holder); `comments <id>` reads
+the thread oldest-first (paginated like `activities`).
+
+**Agent configuration on tickets** (corex#591) : `create` and `update`
+both accept `--agent-config <json>` — free-form jsonb persisted on the
+ticket and read back by `dispatch_agent` / the agent runner (canonical
+keys: `agent_role: planner|executor|…`, `instructions`). The convenience
+verb `tickets set-agent <id> --project <pid> --agent <agent-id>
+[--agent-config <json>]` PATCHes `assignee_id` and (optionally)
+`agent_config` in one call — the shortest path from "empty ticket" to
+"dispatchable". Use `hubdoc agents ls [--active]` to discover
+dispatchable agent UUIDs (STI: `Agents::Planner`, `Agents::Executor`,
+`Agents::Classifier`, `Agents::Conversational`, …).
+
+**Project ACL** (hubdoc-tools#15) : the `permissions` verbs now accept
+`--on-type project` (alias of `Projects::Project`) — the corex
+`/api/v1/permissions` controller is polymorphic and `Projects::Project`
+includes `HasPermissionsConcern`. This lets an agent share a **standalone
+project** (no workspace attached) with a colleague or another agent
+without going through a workspace-scoped ACL. Example:
+`hubdoc permissions grant --to <user-id> --to-type user --on <project-id>
+--on-type project --level admin`.
 
 `hubdoc tasks --project=<pid> --ticket=<tid>` — `ls | show | create |
 update | delete | complete | reorder`. Sub-tasks live under a ticket;
@@ -440,10 +464,20 @@ hubdoc tasks create --project "$PID" --ticket "$TID" \
 hubdoc tasks create --project "$PID" --ticket "$TID" \
     --title "Rédiger devis" --priority high --due 2026-07-16 --json
 
-# 5. Dispatch the agent already configured on the ticket.
+# 5. Pick a dispatchable agent then set it on the ticket in one shot.
+AGENT_ID=$(hubdoc agents ls --active --json | jq -r '.items[] | select(.key=="planner") | .id')
+hubdoc tickets set-agent "$TID" --project "$PID" \
+    --agent "$AGENT_ID" \
+    --agent-config '{"agent_role":"planner","instructions":"Rédige un devis à partir des PJ."}' --json
+
+# 5b. Now `dispatch` can actually fire (agent + agent_config both set).
 hubdoc tickets dispatch "$TID" --project "$PID" --json
 
-# 6. Later — publish an already-attached deliverable and close the ticket.
+# 6. Later — post a follow-up on the ticket thread (visible to the human):
+hubdoc tickets comment "$TID" --project "$PID" \
+    --body "Point d’avancement : devis en cours de rédaction, ETA demain 10h." --json
+
+# 7. Publish an already-attached deliverable and close the ticket.
 hubdoc tickets deliverable "$TID" --project "$PID" \
     --deliverable "$DELIVERABLE_ID" --json
 hubdoc tickets status "$TID" --project "$PID" \

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sinoia/hubdoc-tools",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "description": "Professional command-line tool for HubDoc document management and bulk import/export",
   "main": "cli.js",
   "bin": {