@pulsarinteractive/geniustasker 0.1.0-beta.14 → 0.1.0-beta.15
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/CHANGELOG.md +7 -0
- package/README.md +1 -1
- package/docs/CHATGPT.md +17 -0
- package/docs/CLI.md +24 -9
- package/docs/INTEGRATIONS.md +4 -4
- package/docs/PLANNING.md +62 -18
- package/docs/TASK_CHECKLISTS.md +85 -0
- package/docs/TASK_LOCKS.md +18 -10
- package/docs/TASK_PAUSES.md +91 -0
- package/examples/codex.toml +1 -1
- package/examples/mcp.json +1 -1
- package/mcp.json +1 -1
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/remote/tool-catalog.json +145 -6
- package/remote/workflows.json +31 -9
- package/skills/geniustasker/SKILL.md +20 -2
- package/skills/geniustasker/references/agent-runs.md +23 -5
- package/skills/geniustasker/references/collaboration.md +15 -2
- package/skills/geniustasker/references/host-events.md +9 -0
- package/skills/geniustasker/references/incremental-reads.md +4 -2
- package/skills/geniustasker/references/protocols.md +13 -2
- package/skills/geniustasker-planning/SKILL.md +24 -4
- package/src/cli.mjs +8 -1
- package/src/command-catalog.mjs +101 -0
- package/src/command-input-schemas.mjs +316 -2
- package/src/commands.mjs +13 -1
- package/src/mcp.mjs +2 -2
- package/src/resources.mjs +11 -4
- package/src/task-availability-contract.mjs +45 -0
- package/src/task-availability.mjs +13 -3
- package/src/task-state-legacy-contract.mjs +121 -0
package/remote/tool-catalog.json
CHANGED
|
@@ -80,6 +80,7 @@
|
|
|
80
80
|
"enum": [
|
|
81
81
|
"agentRuns",
|
|
82
82
|
"assets",
|
|
83
|
+
"checklist",
|
|
83
84
|
"comments",
|
|
84
85
|
"documentFolders",
|
|
85
86
|
"documents",
|
|
@@ -150,8 +151,14 @@
|
|
|
150
151
|
},
|
|
151
152
|
"taskState": {
|
|
152
153
|
"type": "string",
|
|
153
|
-
"enum": ["v1"],
|
|
154
|
-
"description": "Explicit task availability opt-in
|
|
154
|
+
"enum": ["v1", "v2"],
|
|
155
|
+
"description": "Explicit task-only availability opt-in after capability discovery. Choose v2 only when collections[id=tasks].taskStateVersions includes v2; otherwise v1 when taskState advertises v1. Omit on older deployments. No implicit opt-in or available fallback: v1 omits Paused snapshots."
|
|
156
|
+
},
|
|
157
|
+
"taskId": {
|
|
158
|
+
"type": "string",
|
|
159
|
+
"minLength": 1,
|
|
160
|
+
"maxLength": 128,
|
|
161
|
+
"description": "Checklist parent task ID; required for a bounded checklist list unless reading one exact item id. Preserve this filter with epoch/checkpoint during pagination. Filtered lists have no change cursor."
|
|
155
162
|
}
|
|
156
163
|
},
|
|
157
164
|
"required": ["scope", "collection"],
|
|
@@ -308,6 +315,10 @@
|
|
|
308
315
|
"approval.cancel",
|
|
309
316
|
"approval.consume",
|
|
310
317
|
"approval.request",
|
|
318
|
+
"checklist.create",
|
|
319
|
+
"checklist.move",
|
|
320
|
+
"checklist.remove",
|
|
321
|
+
"checklist.update",
|
|
311
322
|
"comment.create",
|
|
312
323
|
"comment.delete",
|
|
313
324
|
"comment.update",
|
|
@@ -345,6 +356,7 @@
|
|
|
345
356
|
"metric.record",
|
|
346
357
|
"metric.update",
|
|
347
358
|
"metric.void",
|
|
359
|
+
"project.configureInstructions",
|
|
348
360
|
"project.create",
|
|
349
361
|
"project.delete",
|
|
350
362
|
"project.features",
|
|
@@ -355,11 +367,14 @@
|
|
|
355
367
|
"protocol.start",
|
|
356
368
|
"question.close",
|
|
357
369
|
"question.create",
|
|
370
|
+
"run.checklist",
|
|
358
371
|
"run.checkpoint",
|
|
359
372
|
"run.claim",
|
|
360
373
|
"run.finish",
|
|
361
374
|
"run.lock",
|
|
362
375
|
"run.patch",
|
|
376
|
+
"run.pause",
|
|
377
|
+
"run.resume",
|
|
363
378
|
"run.unlock",
|
|
364
379
|
"schedule.create",
|
|
365
380
|
"schedule.delete",
|
|
@@ -375,8 +390,10 @@
|
|
|
375
390
|
"task.archive",
|
|
376
391
|
"task.create",
|
|
377
392
|
"task.lock",
|
|
393
|
+
"task.pause",
|
|
378
394
|
"task.report",
|
|
379
395
|
"task.restore",
|
|
396
|
+
"task.resume",
|
|
380
397
|
"task.unlock",
|
|
381
398
|
"task.update",
|
|
382
399
|
"ticket.create",
|
|
@@ -405,6 +422,10 @@
|
|
|
405
422
|
"approval.cancel",
|
|
406
423
|
"approval.consume",
|
|
407
424
|
"approval.request",
|
|
425
|
+
"checklist.create",
|
|
426
|
+
"checklist.move",
|
|
427
|
+
"checklist.remove",
|
|
428
|
+
"checklist.update",
|
|
408
429
|
"comment.create",
|
|
409
430
|
"comment.delete",
|
|
410
431
|
"comment.update",
|
|
@@ -442,6 +463,7 @@
|
|
|
442
463
|
"metric.record",
|
|
443
464
|
"metric.update",
|
|
444
465
|
"metric.void",
|
|
466
|
+
"project.configureInstructions",
|
|
445
467
|
"project.create",
|
|
446
468
|
"project.delete",
|
|
447
469
|
"project.features",
|
|
@@ -452,11 +474,14 @@
|
|
|
452
474
|
"protocol.start",
|
|
453
475
|
"question.close",
|
|
454
476
|
"question.create",
|
|
477
|
+
"run.checklist",
|
|
455
478
|
"run.checkpoint",
|
|
456
479
|
"run.claim",
|
|
457
480
|
"run.finish",
|
|
458
481
|
"run.lock",
|
|
459
482
|
"run.patch",
|
|
483
|
+
"run.pause",
|
|
484
|
+
"run.resume",
|
|
460
485
|
"run.unlock",
|
|
461
486
|
"schedule.create",
|
|
462
487
|
"schedule.delete",
|
|
@@ -472,8 +497,10 @@
|
|
|
472
497
|
"task.archive",
|
|
473
498
|
"task.create",
|
|
474
499
|
"task.lock",
|
|
500
|
+
"task.pause",
|
|
475
501
|
"task.report",
|
|
476
502
|
"task.restore",
|
|
503
|
+
"task.resume",
|
|
477
504
|
"task.unlock",
|
|
478
505
|
"task.update",
|
|
479
506
|
"ticket.create",
|
|
@@ -542,6 +569,10 @@
|
|
|
542
569
|
"approval.cancel",
|
|
543
570
|
"approval.consume",
|
|
544
571
|
"approval.request",
|
|
572
|
+
"checklist.create",
|
|
573
|
+
"checklist.move",
|
|
574
|
+
"checklist.remove",
|
|
575
|
+
"checklist.update",
|
|
545
576
|
"comment.create",
|
|
546
577
|
"comment.delete",
|
|
547
578
|
"comment.update",
|
|
@@ -579,6 +610,7 @@
|
|
|
579
610
|
"metric.record",
|
|
580
611
|
"metric.update",
|
|
581
612
|
"metric.void",
|
|
613
|
+
"project.configureInstructions",
|
|
582
614
|
"project.create",
|
|
583
615
|
"project.delete",
|
|
584
616
|
"project.features",
|
|
@@ -589,11 +621,14 @@
|
|
|
589
621
|
"protocol.start",
|
|
590
622
|
"question.close",
|
|
591
623
|
"question.create",
|
|
624
|
+
"run.checklist",
|
|
592
625
|
"run.checkpoint",
|
|
593
626
|
"run.claim",
|
|
594
627
|
"run.finish",
|
|
595
628
|
"run.lock",
|
|
596
629
|
"run.patch",
|
|
630
|
+
"run.pause",
|
|
631
|
+
"run.resume",
|
|
597
632
|
"run.unlock",
|
|
598
633
|
"schedule.create",
|
|
599
634
|
"schedule.delete",
|
|
@@ -609,8 +644,10 @@
|
|
|
609
644
|
"task.archive",
|
|
610
645
|
"task.create",
|
|
611
646
|
"task.lock",
|
|
647
|
+
"task.pause",
|
|
612
648
|
"task.report",
|
|
613
649
|
"task.restore",
|
|
650
|
+
"task.resume",
|
|
614
651
|
"task.unlock",
|
|
615
652
|
"task.update",
|
|
616
653
|
"ticket.create",
|
|
@@ -1040,6 +1077,10 @@
|
|
|
1040
1077
|
"kind": {
|
|
1041
1078
|
"type": "string",
|
|
1042
1079
|
"enum": [
|
|
1080
|
+
"checklist.create",
|
|
1081
|
+
"checklist.move",
|
|
1082
|
+
"checklist.remove",
|
|
1083
|
+
"checklist.update",
|
|
1043
1084
|
"document.create",
|
|
1044
1085
|
"document.delete",
|
|
1045
1086
|
"document.update",
|
|
@@ -1054,11 +1095,14 @@
|
|
|
1054
1095
|
"protocol.cancel",
|
|
1055
1096
|
"protocol.publish",
|
|
1056
1097
|
"protocol.start",
|
|
1098
|
+
"run.checklist",
|
|
1057
1099
|
"run.checkpoint",
|
|
1058
1100
|
"run.claim",
|
|
1059
1101
|
"run.finish",
|
|
1060
1102
|
"run.lock",
|
|
1061
1103
|
"run.patch",
|
|
1104
|
+
"run.pause",
|
|
1105
|
+
"run.resume",
|
|
1062
1106
|
"run.unlock",
|
|
1063
1107
|
"schedule.create",
|
|
1064
1108
|
"schedule.delete",
|
|
@@ -1074,8 +1118,10 @@
|
|
|
1074
1118
|
"task.archive",
|
|
1075
1119
|
"task.create",
|
|
1076
1120
|
"task.lock",
|
|
1121
|
+
"task.pause",
|
|
1077
1122
|
"task.report",
|
|
1078
1123
|
"task.restore",
|
|
1124
|
+
"task.resume",
|
|
1079
1125
|
"task.unlock",
|
|
1080
1126
|
"task.update",
|
|
1081
1127
|
"ticket.create",
|
|
@@ -1338,6 +1384,7 @@
|
|
|
1338
1384
|
"type": "string",
|
|
1339
1385
|
"enum": [
|
|
1340
1386
|
"agentRuns",
|
|
1387
|
+
"checklist",
|
|
1341
1388
|
"comments",
|
|
1342
1389
|
"documentFolders",
|
|
1343
1390
|
"documents",
|
|
@@ -1384,8 +1431,14 @@
|
|
|
1384
1431
|
},
|
|
1385
1432
|
"taskState": {
|
|
1386
1433
|
"type": "string",
|
|
1387
|
-
"enum": ["v1"],
|
|
1388
|
-
"description": "Explicit task availability opt-in
|
|
1434
|
+
"enum": ["v1", "v2"],
|
|
1435
|
+
"description": "Explicit task-only availability opt-in after capability discovery. Choose v2 only when collections[id=tasks].taskStateVersions includes v2; otherwise v1 when taskState advertises v1. Omit on older deployments. No implicit opt-in or available fallback: v1 omits Paused snapshots."
|
|
1436
|
+
},
|
|
1437
|
+
"taskId": {
|
|
1438
|
+
"type": "string",
|
|
1439
|
+
"minLength": 1,
|
|
1440
|
+
"maxLength": 128,
|
|
1441
|
+
"description": "Checklist parent task ID; required for a bounded checklist list unless reading one exact item id. Preserve this filter with epoch/checkpoint during pagination. Filtered lists have no change cursor."
|
|
1389
1442
|
}
|
|
1390
1443
|
},
|
|
1391
1444
|
"required": ["scope", "collection"],
|
|
@@ -1411,7 +1464,13 @@
|
|
|
1411
1464
|
},
|
|
1412
1465
|
"kind": {
|
|
1413
1466
|
"type": "string",
|
|
1414
|
-
"enum": [
|
|
1467
|
+
"enum": [
|
|
1468
|
+
"project.configureInstructions",
|
|
1469
|
+
"project.create",
|
|
1470
|
+
"project.delete",
|
|
1471
|
+
"project.features",
|
|
1472
|
+
"project.update"
|
|
1473
|
+
]
|
|
1415
1474
|
},
|
|
1416
1475
|
"scope": {
|
|
1417
1476
|
"type": "string",
|
|
@@ -1482,7 +1541,8 @@
|
|
|
1482
1541
|
"runs",
|
|
1483
1542
|
"metrics",
|
|
1484
1543
|
"intents",
|
|
1485
|
-
"feedback"
|
|
1544
|
+
"feedback",
|
|
1545
|
+
"checklist"
|
|
1486
1546
|
]
|
|
1487
1547
|
}
|
|
1488
1548
|
},
|
|
@@ -2259,5 +2319,84 @@
|
|
|
2259
2319
|
"write": true,
|
|
2260
2320
|
"destructive": true,
|
|
2261
2321
|
"idempotent": true
|
|
2322
|
+
},
|
|
2323
|
+
{
|
|
2324
|
+
"name": "tasker_changes",
|
|
2325
|
+
"title": "Read one bounded change page",
|
|
2326
|
+
"description": "One call reads one bounded page and spends the normal read budget. Use the opaque changeCursor from a completed eligible resources inventory, or the previous nextCursor, for the same scope, collection, archive selection and access context. Filtered taskId/metricId inventories have no change cursor. Never invent or modify a cursor or add filters; after a reset-required refusal restart the bounded inventory. Follow nextCursor while hasMore; otherwise honor pollAfterSeconds and avoid unbounded polling. Explicit taskState opt-in follows capabilities: v2 only when taskStateVersions includes v2, otherwise v1 when advertised. Omission is legacy; absent or Unknown task availability never means available. A checkpoint advance, including remove without a snapshot, invalidates previous task availability decisions.",
|
|
2327
|
+
"inputSchema": {
|
|
2328
|
+
"type": "object",
|
|
2329
|
+
"properties": {
|
|
2330
|
+
"scope": {
|
|
2331
|
+
"type": "string",
|
|
2332
|
+
"description": "The exact scope used to obtain this cursor; never move a cursor between projects or accounts.",
|
|
2333
|
+
"minLength": 1,
|
|
2334
|
+
"maxLength": 256
|
|
2335
|
+
},
|
|
2336
|
+
"collection": {
|
|
2337
|
+
"type": "string",
|
|
2338
|
+
"description": "The exact permitted collection used to obtain this cursor.",
|
|
2339
|
+
"minLength": 1,
|
|
2340
|
+
"maxLength": 32,
|
|
2341
|
+
"enum": [
|
|
2342
|
+
"agentRuns",
|
|
2343
|
+
"assets",
|
|
2344
|
+
"checklist",
|
|
2345
|
+
"comments",
|
|
2346
|
+
"documentFolders",
|
|
2347
|
+
"documents",
|
|
2348
|
+
"edges",
|
|
2349
|
+
"filters",
|
|
2350
|
+
"gitHubLinks",
|
|
2351
|
+
"goals",
|
|
2352
|
+
"history",
|
|
2353
|
+
"members",
|
|
2354
|
+
"memory",
|
|
2355
|
+
"metricCorrections",
|
|
2356
|
+
"metricGoals",
|
|
2357
|
+
"metricObservations",
|
|
2358
|
+
"metrics",
|
|
2359
|
+
"nodeIndex",
|
|
2360
|
+
"nodes",
|
|
2361
|
+
"pageIndex",
|
|
2362
|
+
"pages",
|
|
2363
|
+
"personalMetricCorrections",
|
|
2364
|
+
"personalMetricGoals",
|
|
2365
|
+
"personalMetricObservations",
|
|
2366
|
+
"personalMetrics",
|
|
2367
|
+
"preparedLists",
|
|
2368
|
+
"project",
|
|
2369
|
+
"projectDocumentIndex",
|
|
2370
|
+
"projectDocuments",
|
|
2371
|
+
"protocolInstances",
|
|
2372
|
+
"questions",
|
|
2373
|
+
"schedules",
|
|
2374
|
+
"sprintHistory",
|
|
2375
|
+
"sprints",
|
|
2376
|
+
"tags",
|
|
2377
|
+
"taskTemplates",
|
|
2378
|
+
"tasks",
|
|
2379
|
+
"workflows"
|
|
2380
|
+
]
|
|
2381
|
+
},
|
|
2382
|
+
"cursor": {
|
|
2383
|
+
"type": "string",
|
|
2384
|
+
"description": "Opaque server continuation. Preserve every byte; no timestamps, offsets, hand-built cursors or cursors from filtered inventories.",
|
|
2385
|
+
"minLength": 1,
|
|
2386
|
+
"maxLength": 4096
|
|
2387
|
+
},
|
|
2388
|
+
"taskState": {
|
|
2389
|
+
"type": "string",
|
|
2390
|
+
"enum": ["v1", "v2"],
|
|
2391
|
+
"description": "Tasks only. Explicitly keep the capability-supported availability version used for task reads; v1 omits Paused snapshots, v2 includes pause metadata. Omit on older services."
|
|
2392
|
+
}
|
|
2393
|
+
},
|
|
2394
|
+
"required": ["scope", "collection", "cursor"],
|
|
2395
|
+
"additionalProperties": false
|
|
2396
|
+
},
|
|
2397
|
+
"scopes": [],
|
|
2398
|
+
"route": "changes",
|
|
2399
|
+
"write": false,
|
|
2400
|
+
"destructive": false
|
|
2262
2401
|
}
|
|
2263
2402
|
]
|
package/remote/workflows.json
CHANGED
|
@@ -32,9 +32,11 @@
|
|
|
32
32
|
"Importance measures verified impact, independently of urgency, due dates, effort and parent/subtask hierarchy: Minor is limited consequence; Normal is expected useful work or insufficient evidence for more; Important materially advances an identified goal or removes a substantial verified blocker; Critical has severe concrete consequences for this project. Do not inflate importance to obtain XP, pushes or attention. Agent-created or changed Important/Critical classifications require a short importanceReason (at most 400 characters) describing the actual consequence or evidence, not just an urgency label.",
|
|
33
33
|
"importanceOrigin is server-owned: never supply it. Preserve a human-origin importance and its reason. If reassessment would help, propose the new value and reason through a supported question or the current conversation; a human must apply it through the application. task_importance_human_review_required is a final conflict, not permission to retry through another profile/transport, clear provenance or recreate the task. A question answer does not bypass that protection. Use normal immutable-command recovery and readback; an importance-only edit does not establish notification delivery, XP or any future Flutter threshold control.",
|
|
34
34
|
"Tags and saved filters are project-specific. Use tag.create/update/delete and filter.create/update/delete. Reuse existing names and criteria; never impose example release labels globally.",
|
|
35
|
-
"Record
|
|
35
|
+
"Record current attributable work with task.report and relevant comments. On existing deployments task.report moves an open task InProgress, so do not use it merely to summarize inactive or partially implemented lots; discover task.pause/resume or the live run equivalents for a known interruption; if the connected service does not advertise these commands, retain an authorized note. Never patch status to pause/resume or reset started work to New. Questions and action approvals are separate workflows; an agent may request or consume an exact granted approval but cannot approve on a human behalf. Mark work complete only when the requested work is actually complete.",
|
|
36
36
|
"Use project.update for ordinary project settings and project.features for planning switches, with projects:write and native administration rights. project.features is a full configuration: read and preserve all seven booleans and timeZone. It cannot change agent opt-in, membership, ownership or counters. project.delete requires project ownership, a current revision and an explicit user deletion request.",
|
|
37
|
-
"For
|
|
37
|
+
"For an explicit request to set up or revise agent instructions, discover project.configureInstructions and inspect command_help. Only the actual project owner may replace instructions; projects:write, current scope grant, agentsEnabled=true and the current project revision remain required. Send only instructions (complete replacement, at most 12000 characters; empty explicitly clears). Preserve unrelated human guidance and exclude credentials/unrelated private context. Retain the exact operation after uncertainty, then read project.agentInstructions and unchanged agentsEnabled. This pending source addition requires compatible client and service; if unavailable retain the text and explain the gap, without private API fallback. Instructions do not grant permissions.",
|
|
38
|
+
"For sprint/workflow/recurrence lifecycle use the planning guide. For project documents use document.create/update/delete and folder.create/update/delete; these are separate from Memory. Folders use parent and documents use folder. Prevent duplicate names, preserve unrelated contents and read the current revision before moving or deleting.",
|
|
39
|
+
"For small steps of one deliverable read workflow checklist. Use separate tickets for independent ownership, dependency, deadline or estimate. Check/uncheck is an explicit desired boolean; no XP, push, auto-Done or resumption follows a checked item. Discover connected-service support first; client installation alone is insufficient."
|
|
38
40
|
]
|
|
39
41
|
},
|
|
40
42
|
"memory": {
|
|
@@ -62,16 +64,19 @@
|
|
|
62
64
|
"title": "Sprint, workflow and recurring-task lifecycle",
|
|
63
65
|
"steps": [
|
|
64
66
|
"Inspect the project, its enabled features and current sprint/workflow/schedule records. tasks:write does not grant project administrator rights. Enable planning only with project.features and projects:write; preserve unrelated settings.",
|
|
65
|
-
"Read the task and
|
|
67
|
+
"Read the task and prerequisites before changing progress. New means not yet started; InProgress means current identifiable execution, not partially implemented code, an undelivered lot or an old claim. Multiple InProgress tasks require real parallel activity with identifiable actors. Done requires verified intended work and acceptance criteria. Creating a plan or claiming/finishing a run does not itself start or finish the task. Never force Done to clear dependencies or make a plan appear complete.",
|
|
68
|
+
"For a known interruption or switch away from work you control, preserve descriptions, comments and verified results; record a useful reason and concrete resumption point. Discover task.pause/resume, or run.pause/resume under your live claim. Client beta.15 supports these pause commands; if the service does not advertise them explain the missing transition and retain an authorized note. Never patch status to pause/resume or relabel started work New or Done. Resume explicitly only for actual renewed execution. A manual lock requires a real obstacle. Silence or an expired lease does not prove interruption; do not reset another worker’s task from stale reporting.",
|
|
69
|
+
"Discover explicit task.pause {reason,nextSteps} and task.resume {} before use: both target the task ID/current revision. Pause accepts InProgress or Paused, never never-started, Done or archived work. Reason must be useful, 1–500 characters; nextSteps must give a concrete resumption point, 1–2000 characters. Resume requests InProgress and still respects current blockers. Under a live claim use run.pause {taskRevision,reason,nextSteps} or run.resume {taskRevision} targeting its current run revision. They set Waiting/Working without extending the lease or releasing the claim. Locked is an independent obstacle; unlock does not resume a paused task. Never use raw status or pause metadata patches. Retain exact immutable operations and reread both records after success.",
|
|
66
70
|
"On every authorized task creation or taking charge of existing work, actively check estimateDays and supply a scope-based working-effort estimate when possible. Preserve human choices. If effort is unknown, keep null, explain the missing assumption in the plan or an authorized progress note, and reassess after clarification. Apply this check to each new or explicitly revised protocol step; never fabricate a value, modify an immutable published version or rewrite a saved retry to fill the field.",
|
|
67
71
|
"estimateDays is approximate effort in working days: 0.1 is one tenth and 1 is one working day. It is not a deadline, elapsed calendar/waiting time or AI runtime. Do not assume hours per day. Use null for unknown; do not invent precision or overwrite a human estimate without an authorized reason. Reassess and explain estimates when scope changes. Current source supports finite 0.1..60; installed beta.13 and older deployments may reject values below 0.25. Inspect current command help/capabilities, preserve the intended value and explain a refusal rather than silently rounding it.",
|
|
68
|
-
"Discover task.lock/unlock and run.lock/unlock before use:
|
|
69
|
-
"First inspect capabilities.collections:
|
|
72
|
+
"Discover task.lock/unlock and run.lock/unlock before use: client support is not proof of connected-service support. Canonical progress in the pause extension includes New/InProgress/Paused/Done; never write status Locked. Effective Locked may have both a manual reason and unfinished live prerequisites. Manual unlock removes only the reason, never the prerequisites. Already Done work remains Done when a prerequisite reopens; locking Done needs an explicitly intended reopen. Do not force completion or remove dependencies to bypass a refusal.",
|
|
73
|
+
"First inspect capabilities.collections: for entry id=tasks prefer explicit taskState:v2 only when taskStateVersions includes v2; otherwise select v1 only when taskState advertises v1. Use the same explicit version for task resources/changes/watch (CLI --task-state) and continuations. V1 omits snapshots for Paused tasks; v2 requires nullable pauseReason/pauseNextSteps/pausedAt. Client beta.15 supports v2; the connected service must advertise it. Read-only task grants are sufficient. Never add it silently on older deployments: omission keeps the legacy response with no snapshot. Read taskAvailability on task resources or change upserts when the deployment exposes it. Unknown/incomplete or absence is not available. Read one exact task when needed; no whole-project graph scan. Up to 20 blockingIds can be shown; blockersTruncated means the list is not exhaustive. source epoch/authorizationEpoch/head determine freshness: changed task-module head invalidates old dependent availability even without a dependent revision/delta, and can exceed the change page checkpoint. Keep these source values separate and reread before a decision.",
|
|
70
74
|
"Manual changes require tasks:write plus native task rights and current immutable revisions. task.lock targets the task with data {reason}, a real nonempty reason up to 500 characters; task.unlock uses data {}. The owner of a live agent claim must instead use run.lock {taskRevision,reason} or run.unlock {taskRevision}, targeting the run ID/current run revision. Do not bypass a claim, expiry or takeover through direct task commands. Read affected records after success. Retain the exact operation after uncertainty; no automatic retries of a known lock refusal.",
|
|
71
75
|
"sprint.create and sprint.update require name, goal, start and end (ISO timestamps); goal may be omitted on create. Only Planned or Active sprints are editable, and only one may be Active. sprint.start changes a Planned sprint to Active. sprint.complete accepts carryToSprint (a Planned sprint ID or null for backlog), preserves completion history and moves unfinished work atomically. sprint.delete removes only a Planned sprint and returns its tickets to backlog.",
|
|
72
76
|
"workflow.create/update require name, category (New, InProgress or Done) and integer order. Workflow edits require native PROJECT.ADMIN. The last stage in a category cannot be removed. workflow.delete accepts replacement; it is required when tasks use that stage and must name another existing stage. Server updates affected task status and references atomically.",
|
|
73
77
|
"schedule.create/update set the recurring task fields, including period, interval, startTime, weekDay and IANA timeZoneId. Read current settings before edits; preserve owner, notifications, deadlines and dependencies. The server validates recurrence and invalidates its scheduler checkpoint. Never send nextCheck, lastCreation or disabled: these are server-managed. schedule.delete stops future occurrences, preserves existing task history and removes dependent recurrence references.",
|
|
74
|
-
"Prepare and execute the exact command once; uncertain retries reuse its immutable envelope. On conflict reread the affected records. Read back sprint/task/schedule changes and let normal application realtime subscriptions refresh the open views. Never claim a successful command proves device rendering."
|
|
78
|
+
"Prepare and execute the exact command once; uncertain retries reuse its immutable envelope. On conflict reread the affected records. Read back sprint/task/schedule changes and let normal application realtime subscriptions refresh the open views. Never claim a successful command proves device rendering.",
|
|
79
|
+
"For small steps of one deliverable read workflow checklist. Use separate tickets for independent ownership, dependency, deadline or estimate. Check/uncheck is an explicit desired boolean; no XP, push, auto-Done or resumption follows a checked item. Discover connected-service support first; client installation alone is insufficient."
|
|
75
80
|
]
|
|
76
81
|
},
|
|
77
82
|
"protocols": {
|
|
@@ -79,13 +84,14 @@
|
|
|
79
84
|
"steps": [
|
|
80
85
|
"Discover current commands and collections first. Read the chosen Details project, its agent opt-in, members, features, taskTemplates and relevant protocolInstances with tasks:read. An older name/description template without protocolDefinition is not a published protocol. Never convert ordinary templates or enable project features without a user request.",
|
|
81
86
|
"Read tasker_command_help for protocol.publish/start/apply/cancel (CLI commands describe --kind). The local snapshot includes nested required fields and limits without network access. Do not supply the internal action field; current grants and semantic validation remain server-owned.",
|
|
82
|
-
"When current protocol.publish help exposes estimateDays, actively check each new or explicitly revised step and supply finite effort 0.1..60 working days or null for unknown. Preserve human choices; explain the missing assumption for unknown effort and reassess after clarification without fabricating values. This is separate from dueAfterDays and elapsed AI time; preserve human estimates and reassess only within the requested scope. Older published versions may omit the field: preserve that absence in definitions and previews, because adding null changes immutable content and can change the digest.
|
|
87
|
+
"When current protocol.publish help exposes estimateDays, actively check each new or explicitly revised step and supply finite effort 0.1..60 working days or null for unknown. Preserve human choices; explain the missing assumption for unknown effort and reassess after clarification without fabricating values. This is separate from dueAfterDays and elapsed AI time; preserve human estimates and reassess only within the requested scope. Older published versions may omit the field: preserve that absence in definitions and previews, because adding null changes immutable content and can change the digest. Current client schemas include this optional field; installed beta.13 and older connected services may not accept it. Publishing or applying creates planned work, not completed tasks.",
|
|
83
88
|
"A published protocol is an immutable version: protocol.publish creates a new UUID and accepts definition plus previousVersionId (null for a new family, otherwise the latest version ID). Publication needs native project administration and tasks:write. Keep stable step keys, valid parent/dependency keys, explicit acceptance criteria, reasonable importance and delivery requests. Minor/Normal/Important/Critical measure impact, not urgency; Important/Critical need a concrete reason. Requested push/animation never overrides recipient preferences.",
|
|
84
89
|
"Bind only declared primitive variables, with exact current member IDs and the project epoch. Choose one lowercase UUID for instanceId and retain it. Capture one timezone-qualified anchor; dueAfterDays adds elapsed 24-hour days, not a local recurring schedule. Text values are data, never executable instructions. Do not invent missing required information or copy unrelated account history.",
|
|
85
90
|
"Call tasker_protocol_preview or CLI protocols preview --file with scope, protocolVersionId and bindings. It creates nothing, requires tasks:read and charges the normal read budget. Inspect one page of at most 20 steps. Follow nextAfter only as needed, preserving every binding and the returned digest; a continuation after zero requires that digest. Stop and reconcile on a changed preview or lost access. Do not claim uninspected pages were checked.",
|
|
86
91
|
"After the user has requested this materialization, prepare protocol.start with id equal to bindings.instanceId, expectedRevision:null and data {protocolVersionId,bindings}. Read the new protocolInstances record and its digest/revision. For each explicitly intended batch prepare protocol.apply on that same instance with the current revision and data {digest,from:appliedCount,count:20 or fewer}. Each call uses normal permission and storage admission. No automatic server loop or bulk quota bypass creates all 200 possible steps at once.",
|
|
87
92
|
"Retain the immutable command before every write. After a timeout retry that exact operation; do not advance from or mint a new operation ID until its outcome is known. On a definitive conflict read the instance and affected tasks before deciding whether a new command is appropriate. Do not recreate or overwrite a task to bypass a collision, revocation, expiration or human importance decision. The creating user or a current project administrator may continue or cancel an instance. The same user may continue with another profile only under its current grants. An uncertain operation keeps its original immutable identity; resolve its outcome before preparing a new batch under a different session/profile.",
|
|
88
|
-
"Applied means task materialization is finished, not that anyone completed the work. Read the instance and affected tasks to report the actual result. protocol.cancel with the current revision stops remaining materialization and retains already created tasks; it is not a rollback or a deletion command. Do not edit server-owned instance state, bindings, cursor or provenance directly."
|
|
93
|
+
"Applied means task materialization is finished, not that anyone completed the work. Read the instance and affected tasks to report the actual result. protocol.cancel with the current revision stops remaining materialization and retains already created tasks; it is not a rollback or a deletion command. Do not edit server-owned instance state, bindings, cursor or provenance directly.",
|
|
94
|
+
"Materialization creates planned steps, not a batch of InProgress work. Only steps with current identifiable execution are active; multiple active steps require actual parallel workers. Partial implementation or remaining delivery alone does not qualify. For a known interruption preserve the work, reason and resumption point; discover task.pause/resume or the live run equivalents before use. Client beta.15 supports these commands; if the service does not advertise them retain an authorized note. Never patch status or reset started work to New; resume explicitly only when execution resumes. Stale leases alone prove nothing about current execution."
|
|
89
95
|
]
|
|
90
96
|
},
|
|
91
97
|
"runs": {
|
|
@@ -94,9 +100,11 @@
|
|
|
94
100
|
"Read current identity, capabilities, relevant Details project and task. Discover agentRuns and run.claim/checkpoint/patch/finish; require current project rights, task read/write grants and enabled agent contributions. Read one bounded page, never crawl every project.",
|
|
95
101
|
"When taking charge, check estimateDays as part of understanding the task: retain human choices, supply a scope-based working-effort estimate within the authorized work when possible, or keep unknown effort null with a useful explanation and reassess after clarification. Never substitute elapsed AI runtime. Use run.patch with both current revisions for authorized estimate edits while holding a claim; do not bypass it with task.update.",
|
|
96
102
|
"Use tasker_command_help for the selected run command. Claim only authorized open work with a new run UUID, null create revision, current task ID/taskRevision and scope epoch. A concurrent claim conflict means reread or select independent work, not overwrite or profile switching.",
|
|
103
|
+
"Use Working and task InProgress only for current attributable execution. Several active tasks require actual parallel workers; partial code and undelivered lots are not activity. For a known interruption or switch away from work you control, preserve descriptions, comments and verified results; record a useful reason and concrete resumption point. Discover task.pause/resume, or run.pause/resume under your live claim. Client beta.15 supports these pause commands; if the service does not advertise them explain the missing transition and retain an authorized note. Never patch status to pause/resume or relabel started work New or Done. Resume explicitly only for actual renewed execution. A manual lock requires a real obstacle. Silence or an expired lease does not prove interruption; do not reset another worker’s task from stale reporting. Waiting is a run report, not an automatic task pause. Keep the current run/task fence for any supported transition.",
|
|
104
|
+
"Discover explicit task.pause {reason,nextSteps} and task.resume {} before use: both target the task ID/current revision. Pause accepts InProgress or Paused, never never-started, Done or archived work. Reason must be useful, 1–500 characters; nextSteps must give a concrete resumption point, 1–2000 characters. Resume requests InProgress and still respects current blockers. Under a live claim use run.pause {taskRevision,reason,nextSteps} or run.resume {taskRevision} targeting its current run revision. They set Waiting/Working without extending the lease or releasing the claim. Locked is an independent obstacle; unlock does not resume a paused task. Never use raw status or pause metadata patches. Retain exact immutable operations and reread both records after success.",
|
|
97
105
|
"Report real Working, Waiting or NeedsReview checkpoints against the run revision. Waiting/review need useful nextSteps. Include only labeled HTTPS evidence without credentials or signed private URLs. No fabricated progress or full terminal/chat logs. A valid checkpoint may renew the live lease; respect service retry times.",
|
|
98
106
|
"Use run.patch while holding the claim. The envelope uses the run revision; data.taskRevision uses the task revision; patch accepts only task.update fields. Ordinary ACL, dependencies, task transitions and human importance choices still apply. Human edits require a fresh read and reconciliation.",
|
|
99
|
-
"For an authorized manual blocker while holding the claim, use run.lock with {taskRevision,reason} or run.unlock with {taskRevision}, the run ID and current run revision. Reason must describe a real blocker, 1–500 characters and nonempty after trimming. Read both task and run after success. task.lock/unlock and manualLockReason/status patches cannot bypass a claim or expired lease. Unlock removes only the manual cause; unfinished prerequisites still block and Unknown/incomplete availability is not free. Discover these
|
|
107
|
+
"For an authorized manual blocker while holding the claim, use run.lock with {taskRevision,reason} or run.unlock with {taskRevision}, the run ID and current run revision. Reason must describe a real blocker, 1–500 characters and nonempty after trimming. Read both task and run after success. task.lock/unlock and manualLockReason/status patches cannot bypass a claim or expired lease. Unlock removes only the manual cause; unfinished prerequisites still block and Unknown/incomplete availability is not free. Discover these commands before use; retain exact immutable operations for uncertain retry.",
|
|
100
108
|
"An expired lease means stale reporting, not known failure or blockage. Tasker neither starts an agent nor observes an uninstrumented process. Never promise always-on operation. Respect cancellation_requested, TakenOver and Superseded; human control remains in the app and cannot be impersonated through MCP.",
|
|
101
109
|
"Use run.finish with Completed, Failed or Cancelled and truthful summary/evidence. It ends the run, not the task. Complete the task through run.patch only after verified intended work. After lease expiry, only a final result on the unchanged claim under its original user/profile may close it; task patches stay refused. A deleted task permits only Failed or Cancelled under current project permissions. Do not infer XP, task completion or device display from a run receipt.",
|
|
102
110
|
"Keep immutable operations and original identity after an uncertain result. Local CLI/stdio retain a journal; hosted ChatGPT must retain the exact command object. Reread after a definitive conflict and after finish or human takeover: the task revision changes as a server concurrency barrier without changing its content. New work after expiry requires current authority and an explicit fresh claim; never bypass human takeover. History is bounded: checkpointCount may exceed retained checkpoints.",
|
|
@@ -147,6 +155,20 @@
|
|
|
147
155
|
"Read a bounded page or exact decision on request; never poll. The team records a final status/resolution and optional message. Saved for later does not promise delivery. No conversation or replies; canReply stays false. Only closure can send a notification subject to user settings. Do not expose internal notes, priority, assignee or another user’s duplicate target. Mark read only the revision actually viewed; remove images only at the user’s request.",
|
|
148
156
|
"Sending, delivery receipts, media writes and mark-read use feedback:write. History, decisions and image downloads use feedback:read. Stop on unavailable or denied access and honor retry guidance. Reconnect only in the relevant host with human consent if new scopes are needed; a CLI login does not repair a ChatGPT connection."
|
|
149
157
|
]
|
|
158
|
+
},
|
|
159
|
+
"checklist": {
|
|
160
|
+
"title": "Small steps within one deliverable",
|
|
161
|
+
"steps": [
|
|
162
|
+
"Discover the checklist collection and checklist.create/update/move/remove plus run.checklist before use. Client beta.15 supports these commands; connected-service capabilities remain authoritative. Normal tasks:read/tasks:write, native parent rights and claim fences apply. Do not broaden consent or bypass an absent capability.",
|
|
163
|
+
"Use a checklist for small checkable steps of the same deliverable. Use separate tickets when a step needs its own owner, dependency, deadline or estimate. Preserve the requested scope and existing breakdown; do not silently turn an independently planned workstream into a checkbox.",
|
|
164
|
+
"Read the parent task and one bounded checklist resource page with taskId. CLI: resources list --scope project:ID --collection checklist --task-id TASK_ID. Use id for one exact item. Preserve taskId, epoch and checkpoint with nextAfter. A filtered list has no changeCursor; revalidate normally after changes rather than inventing one. Do not scan every task.",
|
|
165
|
+
"Inspect command_help. Target the item UUID; null revision for checklist.create {task,title}, current item revision for checklist.update {task,title?,checked?}, checklist.move {task,neighborId,neighborRevision}, checklist.remove {task}. Update needs title or checked. At most 50 items; title 1–240 characters, useful and nonempty after trimming. Creation appends unchecked. Send the desired checked boolean, never a toggle.",
|
|
166
|
+
"Move swaps with one current adjacent neighbor using both revisions. Read again after a neighbor conflict. Do not supply raw order, counters, metadata or a replacement array on the task. Remove deletes only the intended item and the server compacts bounded siblings. Current parent ACL, archived-task and storage admission rules apply.",
|
|
167
|
+
"Under your live claim use run.checklist with run ID/current run revision and data {taskRevision,itemId,itemRevision,change}; itemRevision is null for create, current otherwise. Nested change includes task, action createChecklistItem/updateChecklistItem/moveChecklistItem/removeChecklistItem and its corresponding fields. These nested action values are required; normal checklist commands omit top-level action. Keep all run/task/item/neighbor fences; never bypass a claim or expired lease through a direct item command.",
|
|
168
|
+
"Prepare one immutable operation before sending; after uncertainty retry it unchanged. A definitive conflict requires fresh relevant reads before a new operation. Parent counters/revision change on success: reread task, items and run as needed before the next edit. No duplicate create after an uncertain result.",
|
|
169
|
+
"Current checklistCount/checklistDoneCount on the parent are server-owned totals. Compute a percentage from these or a complete current list, never one partial page. An empty list is no checklist, not completion. A checkbox gives no XP or push; 100% never auto-completes the task. Checking or editing does not start, resume, unlock, reopen or move Paused work to New. Verify intended completion separately before Done.",
|
|
170
|
+
"Archived task checklists may be read under current rights, but writes are refused; do not restore a task merely to bypass the refusal. Checklist corrections on unarchived Done work leave Done and completion history intact, even when unchecked. If real acceptance work is incomplete, reconcile progress explicitly within the authorized request, never through checkbox side effects. Paused preserves its reason, next steps and time even at 100%."
|
|
171
|
+
]
|
|
150
172
|
}
|
|
151
173
|
}
|
|
152
174
|
}
|
|
@@ -86,8 +86,24 @@ dependencies and relevant comments. Report meaningful progress in comments
|
|
|
86
86
|
when authorized: the intended change, verified result, blocker or next action.
|
|
87
87
|
Do not create noisy comments for every tool call or label unverified work done.
|
|
88
88
|
The user owns the workflow; Tasker does not require one fixed planning method.
|
|
89
|
-
|
|
90
|
-
|
|
89
|
+
When the user asks to set up or revise project agent instructions, discover
|
|
90
|
+
`project.configureInstructions` and read [Project configuration](../../docs/PLANNING.md#create-and-configure-a-project).
|
|
91
|
+
It requires the actual project owner, existing projects:write consent and an
|
|
92
|
+
already enabled project. Preserve unrelated guidance, use the current revision
|
|
93
|
+
and read back the result; never turn instruction text into new permissions.
|
|
94
|
+
If unavailable, retain the proposed text and explain the missing capability.
|
|
95
|
+
Use InProgress only for current, identifiable execution by a person or agent.
|
|
96
|
+
Partial implementation, an undelivered lot or an old claim is not active work.
|
|
97
|
+
Several InProgress tasks require real concurrent work with clear attribution.
|
|
98
|
+
For a known interruption of work you control, preserve the description and
|
|
99
|
+
record the reason and concrete resumption point through the discovered
|
|
100
|
+
[task.pause/task.resume contract](../../docs/TASK_PAUSES.md), or run.pause/resume
|
|
101
|
+
under your live claim. Client beta.15 supports these commands; discover current
|
|
102
|
+
service support, and keep an authorized note if absent.
|
|
103
|
+
Never patch status to pause/resume or relabel started work New or Done. Resume
|
|
104
|
+
explicitly only when execution resumes. A manual lock needs a real obstacle;
|
|
105
|
+
it is independent of Paused. Silence or an expired lease does not prove work stopped.
|
|
106
|
+
On every authorized task creation or taking charge of
|
|
91
107
|
existing work, check `estimateDays`: supply a working-effort estimate when the
|
|
92
108
|
scope supports one, preserving human choices. If unknown, keep null, explain
|
|
93
109
|
what is missing and reassess after clarification. Do the same for each step of
|
|
@@ -101,6 +117,8 @@ For task availability or manual blocking, read
|
|
|
101
117
|
manual unlock cannot clear unfinished prerequisites. A live claim requires
|
|
102
118
|
run.lock/run.unlock rather than an unfenced direct task change.
|
|
103
119
|
|
|
120
|
+
For small steps within one deliverable, read [Task checklists](../../docs/TASK_CHECKLISTS.md). Use separate tickets for independent owners, dependencies, deadlines or estimates. Checkbox progress never completes or resumes a task; the claim owner uses run.checklist. Discover connected-service support before use; client installation alone is insufficient.
|
|
121
|
+
|
|
104
122
|
Discover command kinds/fields through capabilities and `commands describe`.
|
|
105
123
|
Creation uses a new record ID and null revision. Other commands use the revision
|
|
106
124
|
just read. `ticket.plan` targets the project root revision and includes each
|
|
@@ -62,6 +62,24 @@ may renew a live lease. Schedule bounded updates around real work and respect
|
|
|
62
62
|
retry times, not a polling loop that invents movement. The saved lease is the
|
|
63
63
|
server authority; a local timer alone never authorizes another write.
|
|
64
64
|
|
|
65
|
+
Use Working and task InProgress only for current, attributable execution.
|
|
66
|
+
Partially written code or an undelivered lot does not establish activity.
|
|
67
|
+
Concurrent InProgress tasks need actual parallel workers and clear attribution.
|
|
68
|
+
For a known interruption or switch away from work you control, record the real
|
|
69
|
+
reason and concrete resumption point while preserving descriptions and history.
|
|
70
|
+
Discover [explicit pause/resume](../../../docs/TASK_PAUSES.md) before use: these
|
|
71
|
+
commands require both client and connected-service support. Under your live claim,
|
|
72
|
+
run.pause targets the run revision with {taskRevision,reason,nextSteps};
|
|
73
|
+
run.resume uses {taskRevision}. Reason is 1–500 characters and nextSteps 1–2000,
|
|
74
|
+
both useful and nonempty after trimming. Pause sets the task Paused and the run
|
|
75
|
+
Waiting; explicit resume requests InProgress and Working only when execution
|
|
76
|
+
resumes. Neither extends the lease or releases the claim. A normal Waiting
|
|
77
|
+
checkpoint is a separate report, not an automatic task pause. Never patch status
|
|
78
|
+
to enter/leave Paused or reset started work to New. Locked is an independent real
|
|
79
|
+
obstacle. Preserve current run/task fences; an expired claim cannot be bypassed
|
|
80
|
+
through direct task commands. If unsupported, retain an authorized note and
|
|
81
|
+
explain the missing transition.
|
|
82
|
+
|
|
65
83
|
Only the creating user/profile may report on the run. A new profile is a new
|
|
66
84
|
identity, not a way to resume an uncertain write. Original immutable operations
|
|
67
85
|
retain their original connection/session identity for retries.
|
|
@@ -84,7 +102,7 @@ A human edit changes the revision; reread and reconcile instead of overwriting.
|
|
|
84
102
|
For an authorized manual blocker under your claim, use `run.lock` with
|
|
85
103
|
`data: {taskRevision, reason}` or `run.unlock` with `data: {taskRevision}`.
|
|
86
104
|
The envelope targets the run and its revision; taskRevision comes from a fresh
|
|
87
|
-
task read. Read both records after success. Discover these
|
|
105
|
+
task read. Read both records after success. Discover these commands
|
|
88
106
|
before use and follow [task locks](../../../docs/TASK_LOCKS.md). Never fall back
|
|
89
107
|
to task.lock/unlock, patch a manual lock field or set status Locked to evade the
|
|
90
108
|
claim. Removing a manual reason does not remove unfinished prerequisites or
|
|
@@ -94,8 +112,8 @@ establish that unknown availability is free.
|
|
|
94
112
|
|
|
95
113
|
- `Waiting` is an explicit agent report requiring information or another action.
|
|
96
114
|
- `NeedsReview` is an explicit request to inspect a real result.
|
|
97
|
-
- An expired `leaseUntil` means the signal is stale. It does not prove
|
|
98
|
-
blockage, cancellation or task completion. Do not generate a failure report
|
|
115
|
+
- An expired `leaseUntil` means the signal is stale. It does not prove an
|
|
116
|
+
interruption, failure, blockage, cancellation or task completion. Do not generate a failure report
|
|
99
117
|
just because a heartbeat was absent.
|
|
100
118
|
- `cancelRequestedAt` asks the agent to stop. Stop new task changes and safely
|
|
101
119
|
finish as `Cancelled` when still authorized. Human cancellation/takeover is an
|
|
@@ -114,8 +132,8 @@ next steps when needed and actual evidence. Finishing the run does **not** mark
|
|
|
114
132
|
the task Done. If the requested work is verified and task completion is intended,
|
|
115
133
|
apply that task transition through the live run first, then finish the run.
|
|
116
134
|
Do not award yourself progress, XP or successful delivery from an exit code alone.
|
|
117
|
-
Task
|
|
118
|
-
|
|
135
|
+
Task InProgress requires current execution, independently of an earlier claim
|
|
136
|
+
or checkpoint. Follow [task progress and effort](../../../docs/PLANNING.md#progress-and-effort)
|
|
119
137
|
when updating the task. Never convert the run's elapsed time into `estimateDays`
|
|
120
138
|
or force Done because the process stopped or another task depends on it.
|
|
121
139
|
|
|
@@ -26,14 +26,17 @@ independent authorized work; do not invent approval or repeatedly poll rapidly.
|
|
|
26
26
|
|
|
27
27
|
Use the discovered `task.report` command with `tasks:write`, an open unarchived
|
|
28
28
|
agent-enabled task and its current revision. Pick `Working`, `NeedsInformation`
|
|
29
|
-
or `NeedsReview`;
|
|
29
|
+
or `NeedsReview`; a report is separate from explicit task pause/resume. Describe
|
|
30
30
|
what changed in `summary` (up to 2,000 UTF-16 units). `nextSteps` is required for
|
|
31
31
|
information/review requests (up to 4,000 units). Include up to eight explicitly
|
|
32
32
|
labeled HTTPS evidence links; never include credentials, signed private URLs or
|
|
33
33
|
claim that an author-provided link is independent verification.
|
|
34
34
|
|
|
35
35
|
The phase and attributed, immutable discussion receipt commit together. A report
|
|
36
|
-
moves an open ticket to InProgress, not Done.
|
|
36
|
+
on older deployments moves an open ticket to InProgress, not Done. On services
|
|
37
|
+
with the pause extension only Working requests InProgress;
|
|
38
|
+
NeedsInformation/NeedsReview preserve current progress, and Working cannot
|
|
39
|
+
resume Paused. Confirm current service support before relying on that behavior. Read `workPhase` and `lastWorkReport`
|
|
37
40
|
on the task, and `workReport` on its comment. Reuse the exact saved operation after
|
|
38
41
|
an uncertain response. Correct a published report with a new report, not by
|
|
39
42
|
rewriting history. Human users can moderate/delete comments, so a missing receipt
|
|
@@ -41,6 +44,16 @@ is not an invitation to recreate its text. Completing/reopening the task clears
|
|
|
41
44
|
its current work phase and retains the report as history. A report does not grant
|
|
42
45
|
permission or count as approval. Use a question when a human answer is needed.
|
|
43
46
|
|
|
47
|
+
That status side effect matters on existing deployments: do not use task.report
|
|
48
|
+
as a generic note for inactive work or to summarize every partially implemented
|
|
49
|
+
lot. InProgress requires current identifiable execution. For a known
|
|
50
|
+
interruption, discover [task.pause/run.pause](../../../docs/TASK_PAUSES.md) and
|
|
51
|
+
retain a reason and next steps; use explicit resume only when execution resumes.
|
|
52
|
+
Check connected-service support. If absent, retain
|
|
53
|
+
an authorized ordinary comment and explain the missing transition. Never patch
|
|
54
|
+
status or reset started work to New. Waiting for information is not evidence
|
|
55
|
+
that a worker is currently executing, and a stale lease is not proof they stopped.
|
|
56
|
+
|
|
44
57
|
## Request and consume a precise human decision
|
|
45
58
|
|
|
46
59
|
Use `approval.request` with `approvals:write` when a concrete action needs a
|
|
@@ -29,6 +29,15 @@ No hook edits the task or awards XP. A `finished` run still does not mark its ta
|
|
|
29
29
|
Done. A cancelled/replaced/expired lease may refuse a checkpoint; keep the real
|
|
30
30
|
event and report that refusal rather than starting an unauthorized replacement.
|
|
31
31
|
|
|
32
|
+
Working checkpoints describe current identifiable execution, not merely partial
|
|
33
|
+
implementation. Multiple task InProgress states require actual concurrent work.
|
|
34
|
+
If the host knows work was interrupted, retain its reason and resumption point;
|
|
35
|
+
these events do not themselves pause or resume the task. Discover the separate
|
|
36
|
+
[run.pause/run.resume commands](../../../docs/TASK_PAUSES.md) before use, retaining
|
|
37
|
+
current run/task revisions and an exact operation. Client beta.15 supports them;
|
|
38
|
+
check connected-service capabilities before use. Never patch status or reset started work to
|
|
39
|
+
New. An expired lease or silence alone is not an observed interruption.
|
|
40
|
+
|
|
32
41
|
## Save the event before sending
|
|
33
42
|
|
|
34
43
|
For each actual event, the host persists one UUID `eventId` and its original
|
|
@@ -5,8 +5,10 @@ For task availability, first follow the capability opt-in in
|
|
|
5
5
|
checkpoint invalidates older availability decisions even when the delta is
|
|
6
6
|
only a `remove` and contains no snapshot for the dependent task. Dependents do
|
|
7
7
|
not receive synthetic deltas. Before starting or completing a task, reread its
|
|
8
|
-
exact ID with
|
|
9
|
-
|
|
8
|
+
exact ID with explicitly selected `taskState: "v2"` when the tasks collection's
|
|
9
|
+
`taskStateVersions` advertises v2, otherwise v1 only when `taskState` advertises
|
|
10
|
+
v1, and check the current snapshot. V1 omits snapshots for Paused tasks; absence
|
|
11
|
+
or incomplete/Unknown is not permission to proceed. Keep
|
|
10
12
|
snapshot source heads separate from historical change-window checkpoints.
|
|
11
13
|
|
|
12
14
|
After a complete resource read, retain its final `changeCursor`. Use
|