@onetaskgraph/sdk 0.12.12 → 0.12.14

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.
@@ -787,10 +787,38 @@ export declare const runtimeSchemas: {
787
787
  readonly required: readonly ["task", "id"];
788
788
  readonly type: "object";
789
789
  };
790
+ readonly GlobalId: {
791
+ readonly description: "One item, qualified by the source it came from.\n\nRendered `<source>:<native>` and parsed by splitting on the **first** colon,\nso a native id may contain colons freely.";
792
+ readonly type: "string";
793
+ };
790
794
  readonly NativeId: {
791
795
  readonly description: "A source's own opaque identifier for one item.\n\nDeliberately unvalidated: a native id is whatever the upstream system says it\nis, colons included. The engine parses a qualified id by splitting on the\n*first* colon precisely so this stays true.";
792
796
  readonly type: "string";
793
797
  };
798
+ readonly Priority: {
799
+ readonly description: "How much a task matters, in the one vocabulary every source is normalised into.\n\nFive values, most pressing first after [`None`](Self::None): Linear's own priority has\nexactly these, and a source whose backend has none of its own maps its representation\nonto them. `none` is a value rather than an absent field, because \"no priority is set\" is\nsomething a person sets — writing `none` clears a priority — and a reader tells it apart\nfrom nothing by the value alone.";
800
+ readonly oneOf: readonly [{
801
+ readonly const: "none";
802
+ readonly description: "No priority is set.";
803
+ readonly type: "string";
804
+ }, {
805
+ readonly const: "urgent";
806
+ readonly description: "Drop everything for it.";
807
+ readonly type: "string";
808
+ }, {
809
+ readonly const: "high";
810
+ readonly description: "Next, before the rest.";
811
+ readonly type: "string";
812
+ }, {
813
+ readonly const: "medium";
814
+ readonly description: "In its turn.";
815
+ readonly type: "string";
816
+ }, {
817
+ readonly const: "low";
818
+ readonly description: "When there is nothing more pressing.";
819
+ readonly type: "string";
820
+ }];
821
+ };
794
822
  readonly Spent: {
795
823
  readonly description: "What one command spent, summed over the sources in it that meter their own requests.\n\n**Source-owned.** Every figure is what a source said it sent and spent while the command\nran, read through [`TaskSource::metering`](onetaskgraph_plugin_api::TaskSource::metering)\nbefore the command and again after it. The engine adds the differences up by name and\ninterprets none of them, which is why the budget and unit names are open vocabulary.";
796
824
  readonly properties: {
@@ -811,6 +839,57 @@ export declare const runtimeSchemas: {
811
839
  readonly required: readonly ["requests", "budgets"];
812
840
  readonly type: "object";
813
841
  };
842
+ readonly Status: {
843
+ readonly description: "A source's status, kept in both normalised and original form.\n\n`category` is what every filter compares against; `name` is the source's own\nwording, preserved so display never flattens \"In Review\" into \"In Progress\".";
844
+ readonly properties: {
845
+ readonly category: {
846
+ readonly $ref: "#/$defs/StatusCategory";
847
+ readonly description: "The normalised value filters compare against.";
848
+ };
849
+ readonly name: {
850
+ readonly description: "The source's own label for this status.";
851
+ readonly type: "string";
852
+ };
853
+ };
854
+ readonly required: readonly ["category", "name"];
855
+ readonly type: "object";
856
+ };
857
+ readonly StatusCategory: {
858
+ readonly description: "The normalised status vocabulary shared across every source.";
859
+ readonly oneOf: readonly [{
860
+ readonly const: "draft";
861
+ readonly description: "Written down but not yet committed to as work.";
862
+ readonly type: "string";
863
+ }, {
864
+ readonly const: "backlog";
865
+ readonly description: "Known about, not yet accepted as ready to work.";
866
+ readonly type: "string";
867
+ }, {
868
+ readonly const: "todo";
869
+ readonly description: "Accepted and ready to be picked up, and nothing has claimed it.";
870
+ readonly type: "string";
871
+ }, {
872
+ readonly const: "queued";
873
+ readonly description: "Claimed by work that will do it, and not yet started.";
874
+ readonly type: "string";
875
+ }, {
876
+ readonly const: "in-progress";
877
+ readonly description: "Being worked on.";
878
+ readonly type: "string";
879
+ }, {
880
+ readonly const: "done";
881
+ readonly description: "Finished.";
882
+ readonly type: "string";
883
+ }, {
884
+ readonly const: "cancelled";
885
+ readonly description: "Abandoned.";
886
+ readonly type: "string";
887
+ }, {
888
+ readonly const: "unknown";
889
+ readonly description: "The source reported a status this vocabulary cannot place.";
890
+ readonly type: "string";
891
+ }];
892
+ };
814
893
  readonly WriteFallback: {
815
894
  readonly description: "That an expected write read its target before writing, and why.";
816
895
  readonly properties: {
@@ -887,21 +966,38 @@ export declare const runtimeSchemas: {
887
966
  readonly type: "object";
888
967
  };
889
968
  readonly WriteResult: {
890
- readonly description: "What each mutation of an expected write came to, built from the mutations' own responses.";
969
+ readonly description: "What an item holds once a write is done, read off the write's own responses — and, for an\nexpected write, what each mutation it sent came to.\n\nEvery write verb and every item a copy lands answers one, with no request added for it: a\nfield the write kept is what the read before it held. `version` is `null` where the source\ncannot vouch for a token from its write's responses — a GitHub board for an item it has just\nwritten, a stdio-hosted plugin, an in-memory source — and otherwise the token a read would\nthen give.";
891
970
  readonly properties: {
892
971
  readonly parts: {
893
- readonly description: "One per mutation sent, in the order sent.";
972
+ readonly description: "One per mutation an expected write sent, in the order sent — absent for a write made\nwithout `--expect`.";
894
973
  readonly items: {
895
974
  readonly $ref: "#/$defs/WritePart";
896
975
  };
897
- readonly type: "array";
976
+ readonly type: readonly ["array", "null"];
977
+ };
978
+ readonly priority: {
979
+ readonly anyOf: readonly [{
980
+ readonly $ref: "#/$defs/Priority";
981
+ }, {
982
+ readonly type: "null";
983
+ }];
984
+ readonly default: null;
985
+ readonly description: "A task's priority after the write — `null` for a project or a document, which carry\nnone, and where an expected write that failed cannot say.";
986
+ };
987
+ readonly status: {
988
+ readonly anyOf: readonly [{
989
+ readonly $ref: "#/$defs/Status";
990
+ }, {
991
+ readonly type: "null";
992
+ }];
993
+ readonly default: null;
994
+ readonly description: "The item's status after the write, exactly as `task show` spells it — `null` for a\ndocument, which has none, and where an expected write that failed cannot say.";
898
995
  };
899
996
  readonly version: {
900
- readonly description: "The task's version after the write, where the last response determines it.";
997
+ readonly description: "The item's version after the write, where the write's responses determine it.";
901
998
  readonly type: readonly ["string", "null"];
902
999
  };
903
1000
  };
904
- readonly required: readonly ["parts"];
905
1001
  readonly type: "object";
906
1002
  };
907
1003
  };
@@ -933,6 +1029,14 @@ export declare const runtimeSchemas: {
933
1029
  readonly $ref: "#/$defs/NativeId";
934
1030
  readonly description: "The comment's own id, exactly as its source issued it.\n\nOpaque, as every [`NativeId`] is, and never qualified: a comment is addressed through\nthe qualified id of the task it is on, so its own id needs no source of its own.";
935
1031
  };
1032
+ readonly item: {
1033
+ readonly anyOf: readonly [{
1034
+ readonly $ref: "#/$defs/GlobalId";
1035
+ }, {
1036
+ readonly type: "null";
1037
+ }];
1038
+ readonly description: "The qualified id of the task the comment was added to — present on `task comment add`'s\nanswer, so a caller records what it commented on from the answer alone.";
1039
+ };
936
1040
  readonly origin: {
937
1041
  readonly anyOf: readonly [{
938
1042
  readonly $ref: "#/$defs/CommentOrigin";
@@ -1576,6 +1680,10 @@ export declare const runtimeSchemas: {
1576
1680
  readonly const: "match";
1577
1681
  readonly description: "A search of the destination by the caller's `--match-by`.";
1578
1682
  readonly type: "string";
1683
+ }, {
1684
+ readonly const: "intent";
1685
+ readonly description: "The item the destination holds under the key of a create an earlier attempt of this\ncopy recorded its intent for, at `onetaskgraph.creating`: that attempt's create,\nfinished rather than made twice.";
1686
+ readonly type: "string";
1579
1687
  }];
1580
1688
  };
1581
1689
  readonly Failure: {
@@ -1922,6 +2030,10 @@ export declare const runtimeSchemas: {
1922
2030
  readonly const: "match";
1923
2031
  readonly description: "A search of the destination by the caller's `--match-by`.";
1924
2032
  readonly type: "string";
2033
+ }, {
2034
+ readonly const: "intent";
2035
+ readonly description: "The item the destination holds under the key of a create an earlier attempt of this\ncopy recorded its intent for, at `onetaskgraph.creating`: that attempt's create,\nfinished rather than made twice.";
2036
+ readonly type: "string";
1925
2037
  }];
1926
2038
  };
1927
2039
  readonly Failure: {
@@ -1998,6 +2110,45 @@ export declare const runtimeSchemas: {
1998
2110
  readonly required: readonly ["destination"];
1999
2111
  readonly type: "object";
2000
2112
  };
2113
+ readonly Priority: {
2114
+ readonly description: "How much a task matters, in the one vocabulary every source is normalised into.\n\nFive values, most pressing first after [`None`](Self::None): Linear's own priority has\nexactly these, and a source whose backend has none of its own maps its representation\nonto them. `none` is a value rather than an absent field, because \"no priority is set\" is\nsomething a person sets — writing `none` clears a priority — and a reader tells it apart\nfrom nothing by the value alone.";
2115
+ readonly oneOf: readonly [{
2116
+ readonly const: "none";
2117
+ readonly description: "No priority is set.";
2118
+ readonly type: "string";
2119
+ }, {
2120
+ readonly const: "urgent";
2121
+ readonly description: "Drop everything for it.";
2122
+ readonly type: "string";
2123
+ }, {
2124
+ readonly const: "high";
2125
+ readonly description: "Next, before the rest.";
2126
+ readonly type: "string";
2127
+ }, {
2128
+ readonly const: "medium";
2129
+ readonly description: "In its turn.";
2130
+ readonly type: "string";
2131
+ }, {
2132
+ readonly const: "low";
2133
+ readonly description: "When there is nothing more pressing.";
2134
+ readonly type: "string";
2135
+ }];
2136
+ };
2137
+ readonly PriorityCondition: {
2138
+ readonly description: "What a guarded copy found a counterpart's priority at, and whether that met the condition.";
2139
+ readonly properties: {
2140
+ readonly held: {
2141
+ readonly $ref: "#/$defs/Priority";
2142
+ readonly description: "The counterpart's priority, as the copy's own pre-write read held it.";
2143
+ };
2144
+ readonly met: {
2145
+ readonly description: "Whether that priority is one the condition names.";
2146
+ readonly type: "boolean";
2147
+ };
2148
+ };
2149
+ readonly required: readonly ["held", "met"];
2150
+ readonly type: "object";
2151
+ };
2001
2152
  readonly SourceName: {
2002
2153
  readonly description: "The name a configuration document gives one configured source.";
2003
2154
  readonly pattern: "^[a-z0-9][a-z0-9-]*$";
@@ -2023,6 +2174,72 @@ export declare const runtimeSchemas: {
2023
2174
  readonly required: readonly ["requests", "budgets"];
2024
2175
  readonly type: "object";
2025
2176
  };
2177
+ readonly Status: {
2178
+ readonly description: "A source's status, kept in both normalised and original form.\n\n`category` is what every filter compares against; `name` is the source's own\nwording, preserved so display never flattens \"In Review\" into \"In Progress\".";
2179
+ readonly properties: {
2180
+ readonly category: {
2181
+ readonly $ref: "#/$defs/StatusCategory";
2182
+ readonly description: "The normalised value filters compare against.";
2183
+ };
2184
+ readonly name: {
2185
+ readonly description: "The source's own label for this status.";
2186
+ readonly type: "string";
2187
+ };
2188
+ };
2189
+ readonly required: readonly ["category", "name"];
2190
+ readonly type: "object";
2191
+ };
2192
+ readonly StatusCategory: {
2193
+ readonly description: "The normalised status vocabulary shared across every source.";
2194
+ readonly oneOf: readonly [{
2195
+ readonly const: "draft";
2196
+ readonly description: "Written down but not yet committed to as work.";
2197
+ readonly type: "string";
2198
+ }, {
2199
+ readonly const: "backlog";
2200
+ readonly description: "Known about, not yet accepted as ready to work.";
2201
+ readonly type: "string";
2202
+ }, {
2203
+ readonly const: "todo";
2204
+ readonly description: "Accepted and ready to be picked up, and nothing has claimed it.";
2205
+ readonly type: "string";
2206
+ }, {
2207
+ readonly const: "queued";
2208
+ readonly description: "Claimed by work that will do it, and not yet started.";
2209
+ readonly type: "string";
2210
+ }, {
2211
+ readonly const: "in-progress";
2212
+ readonly description: "Being worked on.";
2213
+ readonly type: "string";
2214
+ }, {
2215
+ readonly const: "done";
2216
+ readonly description: "Finished.";
2217
+ readonly type: "string";
2218
+ }, {
2219
+ readonly const: "cancelled";
2220
+ readonly description: "Abandoned.";
2221
+ readonly type: "string";
2222
+ }, {
2223
+ readonly const: "unknown";
2224
+ readonly description: "The source reported a status this vocabulary cannot place.";
2225
+ readonly type: "string";
2226
+ }];
2227
+ };
2228
+ readonly StatusCondition: {
2229
+ readonly description: "What a guarded copy found a counterpart's status at, and whether that met the condition.";
2230
+ readonly properties: {
2231
+ readonly held: {
2232
+ readonly $ref: "#/$defs/StatusCategory";
2233
+ readonly description: "The counterpart's status category, as the copy's own pre-write read held it.";
2234
+ };
2235
+ readonly met: {
2236
+ readonly description: "Whether that category is one the condition names.";
2237
+ readonly type: "boolean";
2238
+ };
2239
+ };
2240
+ readonly required: readonly ["held", "met"];
2241
+ readonly type: "object";
2242
+ };
2026
2243
  readonly WriteFallback: {
2027
2244
  readonly description: "That an expected write read its target before writing, and why.";
2028
2245
  readonly properties: {
@@ -2099,21 +2316,38 @@ export declare const runtimeSchemas: {
2099
2316
  readonly type: "object";
2100
2317
  };
2101
2318
  readonly WriteResult: {
2102
- readonly description: "What each mutation of an expected write came to, built from the mutations' own responses.";
2319
+ readonly description: "What an item holds once a write is done, read off the write's own responses — and, for an\nexpected write, what each mutation it sent came to.\n\nEvery write verb and every item a copy lands answers one, with no request added for it: a\nfield the write kept is what the read before it held. `version` is `null` where the source\ncannot vouch for a token from its write's responses — a GitHub board for an item it has just\nwritten, a stdio-hosted plugin, an in-memory source — and otherwise the token a read would\nthen give.";
2103
2320
  readonly properties: {
2104
2321
  readonly parts: {
2105
- readonly description: "One per mutation sent, in the order sent.";
2322
+ readonly description: "One per mutation an expected write sent, in the order sent — absent for a write made\nwithout `--expect`.";
2106
2323
  readonly items: {
2107
2324
  readonly $ref: "#/$defs/WritePart";
2108
2325
  };
2109
- readonly type: "array";
2326
+ readonly type: readonly ["array", "null"];
2327
+ };
2328
+ readonly priority: {
2329
+ readonly anyOf: readonly [{
2330
+ readonly $ref: "#/$defs/Priority";
2331
+ }, {
2332
+ readonly type: "null";
2333
+ }];
2334
+ readonly default: null;
2335
+ readonly description: "A task's priority after the write — `null` for a project or a document, which carry\nnone, and where an expected write that failed cannot say.";
2336
+ };
2337
+ readonly status: {
2338
+ readonly anyOf: readonly [{
2339
+ readonly $ref: "#/$defs/Status";
2340
+ }, {
2341
+ readonly type: "null";
2342
+ }];
2343
+ readonly default: null;
2344
+ readonly description: "The item's status after the write, exactly as `task show` spells it — `null` for a\ndocument, which has none, and where an expected write that failed cannot say.";
2110
2345
  };
2111
2346
  readonly version: {
2112
- readonly description: "The task's version after the write, where the last response determines it.";
2347
+ readonly description: "The item's version after the write, where the write's responses determine it.";
2113
2348
  readonly type: readonly ["string", "null"];
2114
2349
  };
2115
2350
  };
2116
- readonly required: readonly ["parts"];
2117
2351
  readonly type: "object";
2118
2352
  };
2119
2353
  };
@@ -2283,6 +2517,14 @@ export declare const runtimeSchemas: {
2283
2517
  }];
2284
2518
  readonly description: "That the write had to read its target first, and why — absent when it sent only its\nmutations.";
2285
2519
  };
2520
+ readonly held: {
2521
+ readonly anyOf: readonly [{
2522
+ readonly $ref: "#/$defs/WriteResult";
2523
+ }, {
2524
+ readonly type: "null";
2525
+ }];
2526
+ readonly description: "What the counterpart held, as the copy's read of it before writing found it — present\nonly on an item the copy refused after that read, such as `destination-status`.";
2527
+ };
2286
2528
  readonly placed: {
2287
2529
  readonly anyOf: readonly [{
2288
2530
  readonly $ref: "#/$defs/Placement";
@@ -2291,13 +2533,21 @@ export declare const runtimeSchemas: {
2291
2533
  }];
2292
2534
  readonly description: "Which source a routed copy placed it in, and the index of the route entry that\nmatched — `null` there when none did.\n\nPresent for every item a copy into a source declaring `routes` landed, a dry run's\nincluded, so a would-be create still says where it would go; absent for a copy into\na source with none, whose output is what it always was, and for an orphan, which was\nnot placed at all.";
2293
2535
  };
2536
+ readonly priority_condition: {
2537
+ readonly anyOf: readonly [{
2538
+ readonly $ref: "#/$defs/PriorityCondition";
2539
+ }, {
2540
+ readonly type: "null";
2541
+ }];
2542
+ readonly description: "What `--when-destination-priority` found the counterpart's priority at, and whether\nthat met it — present only when the copy was given the condition and this item was an\nupdate of a task.";
2543
+ };
2294
2544
  readonly result: {
2295
2545
  readonly anyOf: readonly [{
2296
2546
  readonly $ref: "#/$defs/WriteResult";
2297
2547
  }, {
2298
2548
  readonly type: "null";
2299
2549
  }];
2300
- readonly description: "What each mutation the write sent came to, and the version it left the task at — for a\nsource that reports its writes' parts.";
2550
+ readonly description: "What the item holds once the write is done — its version, status and priority — and,\nfor a write made with `--expect` on a source that reports its writes' parts, what each\nmutation it sent came to. Absent for a dry run and for an item nothing was written to\nor read of.";
2301
2551
  };
2302
2552
  readonly source: {
2303
2553
  readonly $ref: "#/$defs/GlobalId";
@@ -2311,6 +2561,14 @@ export declare const runtimeSchemas: {
2311
2561
  }];
2312
2562
  readonly description: "What the write spent at the sources that meter their own requests — the fallback's\nread included.";
2313
2563
  };
2564
+ readonly status_condition: {
2565
+ readonly anyOf: readonly [{
2566
+ readonly $ref: "#/$defs/StatusCondition";
2567
+ }, {
2568
+ readonly type: "null";
2569
+ }];
2570
+ readonly description: "What `--when-destination-status` found the counterpart's status at, and whether that\nmet it — present only when the copy was given the condition and this item was an update\nof a task, a refused one included.";
2571
+ };
2314
2572
  };
2315
2573
  readonly required: readonly ["source"];
2316
2574
  readonly title: "CopyOutcome";
@@ -2560,6 +2818,14 @@ export declare const runtimeSchemas: {
2560
2818
  }];
2561
2819
  readonly description: "That the write had to read its target first, and why — absent when it sent only its\nmutations.";
2562
2820
  };
2821
+ readonly held: {
2822
+ readonly anyOf: readonly [{
2823
+ readonly $ref: "#/$defs/WriteResult";
2824
+ }, {
2825
+ readonly type: "null";
2826
+ }];
2827
+ readonly description: "What the counterpart held, as the copy's read of it before writing found it — present\nonly on an item the copy refused after that read, such as `destination-status`.";
2828
+ };
2563
2829
  readonly placed: {
2564
2830
  readonly anyOf: readonly [{
2565
2831
  readonly $ref: "#/$defs/Placement";
@@ -2568,13 +2834,21 @@ export declare const runtimeSchemas: {
2568
2834
  }];
2569
2835
  readonly description: "Which source a routed copy placed it in, and the index of the route entry that\nmatched — `null` there when none did.\n\nPresent for every item a copy into a source declaring `routes` landed, a dry run's\nincluded, so a would-be create still says where it would go; absent for a copy into\na source with none, whose output is what it always was, and for an orphan, which was\nnot placed at all.";
2570
2836
  };
2837
+ readonly priority_condition: {
2838
+ readonly anyOf: readonly [{
2839
+ readonly $ref: "#/$defs/PriorityCondition";
2840
+ }, {
2841
+ readonly type: "null";
2842
+ }];
2843
+ readonly description: "What `--when-destination-priority` found the counterpart's priority at, and whether\nthat met it — present only when the copy was given the condition and this item was an\nupdate of a task.";
2844
+ };
2571
2845
  readonly result: {
2572
2846
  readonly anyOf: readonly [{
2573
2847
  readonly $ref: "#/$defs/WriteResult";
2574
2848
  }, {
2575
2849
  readonly type: "null";
2576
2850
  }];
2577
- readonly description: "What each mutation the write sent came to, and the version it left the task at — for a\nsource that reports its writes' parts.";
2851
+ readonly description: "What the item holds once the write is done — its version, status and priority — and,\nfor a write made with `--expect` on a source that reports its writes' parts, what each\nmutation it sent came to. Absent for a dry run and for an item nothing was written to\nor read of.";
2578
2852
  };
2579
2853
  readonly source: {
2580
2854
  readonly $ref: "#/$defs/GlobalId";
@@ -2588,6 +2862,14 @@ export declare const runtimeSchemas: {
2588
2862
  }];
2589
2863
  readonly description: "What the write spent at the sources that meter their own requests — the fallback's\nread included.";
2590
2864
  };
2865
+ readonly status_condition: {
2866
+ readonly anyOf: readonly [{
2867
+ readonly $ref: "#/$defs/StatusCondition";
2868
+ }, {
2869
+ readonly type: "null";
2870
+ }];
2871
+ readonly description: "What `--when-destination-status` found the counterpart's status at, and whether that\nmet it — present only when the copy was given the condition and this item was an update\nof a task, a refused one included.";
2872
+ };
2591
2873
  };
2592
2874
  readonly required: readonly ["source"];
2593
2875
  readonly type: "object";
@@ -2614,6 +2896,10 @@ export declare const runtimeSchemas: {
2614
2896
  readonly const: "match";
2615
2897
  readonly description: "A search of the destination by the caller's `--match-by`.";
2616
2898
  readonly type: "string";
2899
+ }, {
2900
+ readonly const: "intent";
2901
+ readonly description: "The item the destination holds under the key of a create an earlier attempt of this\ncopy recorded its intent for, at `onetaskgraph.creating`: that attempt's create,\nfinished rather than made twice.";
2902
+ readonly type: "string";
2617
2903
  }];
2618
2904
  };
2619
2905
  readonly Delivered: {
@@ -2782,13 +3068,52 @@ export declare const runtimeSchemas: {
2782
3068
  readonly required: readonly ["destination"];
2783
3069
  readonly type: "object";
2784
3070
  };
2785
- readonly SourceName: {
2786
- readonly description: "The name a configuration document gives one configured source.";
2787
- readonly pattern: "^[a-z0-9][a-z0-9-]*$";
2788
- readonly type: "string";
2789
- };
2790
- readonly Spent: {
2791
- readonly description: "What one command spent, summed over the sources in it that meter their own requests.\n\n**Source-owned.** Every figure is what a source said it sent and spent while the command\nran, read through [`TaskSource::metering`](onetaskgraph_plugin_api::TaskSource::metering)\nbefore the command and again after it. The engine adds the differences up by name and\ninterprets none of them, which is why the budget and unit names are open vocabulary.";
3071
+ readonly Priority: {
3072
+ readonly description: "How much a task matters, in the one vocabulary every source is normalised into.\n\nFive values, most pressing first after [`None`](Self::None): Linear's own priority has\nexactly these, and a source whose backend has none of its own maps its representation\nonto them. `none` is a value rather than an absent field, because \"no priority is set\" is\nsomething a person sets — writing `none` clears a priority — and a reader tells it apart\nfrom nothing by the value alone.";
3073
+ readonly oneOf: readonly [{
3074
+ readonly const: "none";
3075
+ readonly description: "No priority is set.";
3076
+ readonly type: "string";
3077
+ }, {
3078
+ readonly const: "urgent";
3079
+ readonly description: "Drop everything for it.";
3080
+ readonly type: "string";
3081
+ }, {
3082
+ readonly const: "high";
3083
+ readonly description: "Next, before the rest.";
3084
+ readonly type: "string";
3085
+ }, {
3086
+ readonly const: "medium";
3087
+ readonly description: "In its turn.";
3088
+ readonly type: "string";
3089
+ }, {
3090
+ readonly const: "low";
3091
+ readonly description: "When there is nothing more pressing.";
3092
+ readonly type: "string";
3093
+ }];
3094
+ };
3095
+ readonly PriorityCondition: {
3096
+ readonly description: "What a guarded copy found a counterpart's priority at, and whether that met the condition.";
3097
+ readonly properties: {
3098
+ readonly held: {
3099
+ readonly $ref: "#/$defs/Priority";
3100
+ readonly description: "The counterpart's priority, as the copy's own pre-write read held it.";
3101
+ };
3102
+ readonly met: {
3103
+ readonly description: "Whether that priority is one the condition names.";
3104
+ readonly type: "boolean";
3105
+ };
3106
+ };
3107
+ readonly required: readonly ["held", "met"];
3108
+ readonly type: "object";
3109
+ };
3110
+ readonly SourceName: {
3111
+ readonly description: "The name a configuration document gives one configured source.";
3112
+ readonly pattern: "^[a-z0-9][a-z0-9-]*$";
3113
+ readonly type: "string";
3114
+ };
3115
+ readonly Spent: {
3116
+ readonly description: "What one command spent, summed over the sources in it that meter their own requests.\n\n**Source-owned.** Every figure is what a source said it sent and spent while the command\nran, read through [`TaskSource::metering`](onetaskgraph_plugin_api::TaskSource::metering)\nbefore the command and again after it. The engine adds the differences up by name and\ninterprets none of them, which is why the budget and unit names are open vocabulary.";
2792
3117
  readonly properties: {
2793
3118
  readonly budgets: {
2794
3119
  readonly description: "What those requests spent, one entry per budget and unit, ordered by budget name.";
@@ -2807,6 +3132,21 @@ export declare const runtimeSchemas: {
2807
3132
  readonly required: readonly ["requests", "budgets"];
2808
3133
  readonly type: "object";
2809
3134
  };
3135
+ readonly Status: {
3136
+ readonly description: "A source's status, kept in both normalised and original form.\n\n`category` is what every filter compares against; `name` is the source's own\nwording, preserved so display never flattens \"In Review\" into \"In Progress\".";
3137
+ readonly properties: {
3138
+ readonly category: {
3139
+ readonly $ref: "#/$defs/StatusCategory";
3140
+ readonly description: "The normalised value filters compare against.";
3141
+ };
3142
+ readonly name: {
3143
+ readonly description: "The source's own label for this status.";
3144
+ readonly type: "string";
3145
+ };
3146
+ };
3147
+ readonly required: readonly ["category", "name"];
3148
+ readonly type: "object";
3149
+ };
2810
3150
  readonly StatusCategory: {
2811
3151
  readonly description: "The normalised status vocabulary shared across every source.";
2812
3152
  readonly oneOf: readonly [{
@@ -2843,6 +3183,21 @@ export declare const runtimeSchemas: {
2843
3183
  readonly type: "string";
2844
3184
  }];
2845
3185
  };
3186
+ readonly StatusCondition: {
3187
+ readonly description: "What a guarded copy found a counterpart's status at, and whether that met the condition.";
3188
+ readonly properties: {
3189
+ readonly held: {
3190
+ readonly $ref: "#/$defs/StatusCategory";
3191
+ readonly description: "The counterpart's status category, as the copy's own pre-write read held it.";
3192
+ };
3193
+ readonly met: {
3194
+ readonly description: "Whether that category is one the condition names.";
3195
+ readonly type: "boolean";
3196
+ };
3197
+ };
3198
+ readonly required: readonly ["held", "met"];
3199
+ readonly type: "object";
3200
+ };
2846
3201
  readonly WriteFallback: {
2847
3202
  readonly description: "That an expected write read its target before writing, and why.";
2848
3203
  readonly properties: {
@@ -2919,21 +3274,38 @@ export declare const runtimeSchemas: {
2919
3274
  readonly type: "object";
2920
3275
  };
2921
3276
  readonly WriteResult: {
2922
- readonly description: "What each mutation of an expected write came to, built from the mutations' own responses.";
3277
+ readonly description: "What an item holds once a write is done, read off the write's own responses — and, for an\nexpected write, what each mutation it sent came to.\n\nEvery write verb and every item a copy lands answers one, with no request added for it: a\nfield the write kept is what the read before it held. `version` is `null` where the source\ncannot vouch for a token from its write's responses — a GitHub board for an item it has just\nwritten, a stdio-hosted plugin, an in-memory source — and otherwise the token a read would\nthen give.";
2923
3278
  readonly properties: {
2924
3279
  readonly parts: {
2925
- readonly description: "One per mutation sent, in the order sent.";
3280
+ readonly description: "One per mutation an expected write sent, in the order sent — absent for a write made\nwithout `--expect`.";
2926
3281
  readonly items: {
2927
3282
  readonly $ref: "#/$defs/WritePart";
2928
3283
  };
2929
- readonly type: "array";
3284
+ readonly type: readonly ["array", "null"];
3285
+ };
3286
+ readonly priority: {
3287
+ readonly anyOf: readonly [{
3288
+ readonly $ref: "#/$defs/Priority";
3289
+ }, {
3290
+ readonly type: "null";
3291
+ }];
3292
+ readonly default: null;
3293
+ readonly description: "A task's priority after the write — `null` for a project or a document, which carry\nnone, and where an expected write that failed cannot say.";
3294
+ };
3295
+ readonly status: {
3296
+ readonly anyOf: readonly [{
3297
+ readonly $ref: "#/$defs/Status";
3298
+ }, {
3299
+ readonly type: "null";
3300
+ }];
3301
+ readonly default: null;
3302
+ readonly description: "The item's status after the write, exactly as `task show` spells it — `null` for a\ndocument, which has none, and where an expected write that failed cannot say.";
2930
3303
  };
2931
3304
  readonly version: {
2932
- readonly description: "The task's version after the write, where the last response determines it.";
3305
+ readonly description: "The item's version after the write, where the write's responses determine it.";
2933
3306
  readonly type: readonly ["string", "null"];
2934
3307
  };
2935
3308
  };
2936
- readonly required: readonly ["parts"];
2937
3309
  readonly type: "object";
2938
3310
  };
2939
3311
  };
@@ -3019,9 +3391,33 @@ export declare const runtimeSchemas: {
3019
3391
  readonly const: "match";
3020
3392
  readonly description: "A search of the destination by the caller's `--match-by`.";
3021
3393
  readonly type: "string";
3394
+ }, {
3395
+ readonly const: "intent";
3396
+ readonly description: "The item the destination holds under the key of a create an earlier attempt of this\ncopy recorded its intent for, at `onetaskgraph.creating`: that attempt's create,\nfinished rather than made twice.";
3397
+ readonly type: "string";
3022
3398
  }];
3023
3399
  readonly title: "CopyVia";
3024
3400
  };
3401
+ readonly CreateSettings: {
3402
+ readonly $schema: "https://json-schema.org/draft/2020-12/schema";
3403
+ readonly description: "How a copy out of one source keeps a create safe to retry: its two settings, each in whole\nseconds, read off the source's own block beside `cache` and `routes`.\n\n`create_lease_seconds` is how long the intent a copy records on the item it copies, at\n`onetaskgraph.creating`, stays its own before another attempt may take it over — read off\nthe copy's **source**. `create_quiescence_seconds` is how long after an intent was first\ntaken a retry waits for an earlier attempt's create to become listed before creating again\n— read off the copy's **destination**, and only where that destination's lookup by create\nkey can lag a create. Both default to 120 and are left out of a configuration that does not\nset them.";
3404
+ readonly properties: {
3405
+ readonly create_lease_seconds: {
3406
+ readonly description: "Seconds an intent to create stays the holder's own; 120 when absent.";
3407
+ readonly format: "uint64";
3408
+ readonly minimum: 0;
3409
+ readonly type: readonly ["integer", "null"];
3410
+ };
3411
+ readonly create_quiescence_seconds: {
3412
+ readonly description: "Seconds after an intent was first taken that a retry waits for the earlier create to be\nlisted; 120 when absent.";
3413
+ readonly format: "uint64";
3414
+ readonly minimum: 0;
3415
+ readonly type: readonly ["integer", "null"];
3416
+ };
3417
+ };
3418
+ readonly title: "CreateSettings";
3419
+ readonly type: "object";
3420
+ };
3025
3421
  readonly CredentialLayer: {
3026
3422
  readonly $schema: "https://json-schema.org/draft/2020-12/schema";
3027
3423
  readonly description: "Which layer answered for one credential name.";
@@ -3067,6 +3463,30 @@ export declare const runtimeSchemas: {
3067
3463
  readonly description: "A source's own opaque identifier for one item.\n\nDeliberately unvalidated: a native id is whatever the upstream system says it\nis, colons included. The engine parses a qualified id by splitting on the\n*first* colon precisely so this stays true.";
3068
3464
  readonly type: "string";
3069
3465
  };
3466
+ readonly Priority: {
3467
+ readonly description: "How much a task matters, in the one vocabulary every source is normalised into.\n\nFive values, most pressing first after [`None`](Self::None): Linear's own priority has\nexactly these, and a source whose backend has none of its own maps its representation\nonto them. `none` is a value rather than an absent field, because \"no priority is set\" is\nsomething a person sets — writing `none` clears a priority — and a reader tells it apart\nfrom nothing by the value alone.";
3468
+ readonly oneOf: readonly [{
3469
+ readonly const: "none";
3470
+ readonly description: "No priority is set.";
3471
+ readonly type: "string";
3472
+ }, {
3473
+ readonly const: "urgent";
3474
+ readonly description: "Drop everything for it.";
3475
+ readonly type: "string";
3476
+ }, {
3477
+ readonly const: "high";
3478
+ readonly description: "Next, before the rest.";
3479
+ readonly type: "string";
3480
+ }, {
3481
+ readonly const: "medium";
3482
+ readonly description: "In its turn.";
3483
+ readonly type: "string";
3484
+ }, {
3485
+ readonly const: "low";
3486
+ readonly description: "When there is nothing more pressing.";
3487
+ readonly type: "string";
3488
+ }];
3489
+ };
3070
3490
  readonly Spent: {
3071
3491
  readonly description: "What one command spent, summed over the sources in it that meter their own requests.\n\n**Source-owned.** Every figure is what a source said it sent and spent while the command\nran, read through [`TaskSource::metering`](onetaskgraph_plugin_api::TaskSource::metering)\nbefore the command and again after it. The engine adds the differences up by name and\ninterprets none of them, which is why the budget and unit names are open vocabulary.";
3072
3492
  readonly properties: {
@@ -3087,6 +3507,57 @@ export declare const runtimeSchemas: {
3087
3507
  readonly required: readonly ["requests", "budgets"];
3088
3508
  readonly type: "object";
3089
3509
  };
3510
+ readonly Status: {
3511
+ readonly description: "A source's status, kept in both normalised and original form.\n\n`category` is what every filter compares against; `name` is the source's own\nwording, preserved so display never flattens \"In Review\" into \"In Progress\".";
3512
+ readonly properties: {
3513
+ readonly category: {
3514
+ readonly $ref: "#/$defs/StatusCategory";
3515
+ readonly description: "The normalised value filters compare against.";
3516
+ };
3517
+ readonly name: {
3518
+ readonly description: "The source's own label for this status.";
3519
+ readonly type: "string";
3520
+ };
3521
+ };
3522
+ readonly required: readonly ["category", "name"];
3523
+ readonly type: "object";
3524
+ };
3525
+ readonly StatusCategory: {
3526
+ readonly description: "The normalised status vocabulary shared across every source.";
3527
+ readonly oneOf: readonly [{
3528
+ readonly const: "draft";
3529
+ readonly description: "Written down but not yet committed to as work.";
3530
+ readonly type: "string";
3531
+ }, {
3532
+ readonly const: "backlog";
3533
+ readonly description: "Known about, not yet accepted as ready to work.";
3534
+ readonly type: "string";
3535
+ }, {
3536
+ readonly const: "todo";
3537
+ readonly description: "Accepted and ready to be picked up, and nothing has claimed it.";
3538
+ readonly type: "string";
3539
+ }, {
3540
+ readonly const: "queued";
3541
+ readonly description: "Claimed by work that will do it, and not yet started.";
3542
+ readonly type: "string";
3543
+ }, {
3544
+ readonly const: "in-progress";
3545
+ readonly description: "Being worked on.";
3546
+ readonly type: "string";
3547
+ }, {
3548
+ readonly const: "done";
3549
+ readonly description: "Finished.";
3550
+ readonly type: "string";
3551
+ }, {
3552
+ readonly const: "cancelled";
3553
+ readonly description: "Abandoned.";
3554
+ readonly type: "string";
3555
+ }, {
3556
+ readonly const: "unknown";
3557
+ readonly description: "The source reported a status this vocabulary cannot place.";
3558
+ readonly type: "string";
3559
+ }];
3560
+ };
3090
3561
  readonly WriteFallback: {
3091
3562
  readonly description: "That an expected write read its target before writing, and why.";
3092
3563
  readonly properties: {
@@ -3163,21 +3634,38 @@ export declare const runtimeSchemas: {
3163
3634
  readonly type: "object";
3164
3635
  };
3165
3636
  readonly WriteResult: {
3166
- readonly description: "What each mutation of an expected write came to, built from the mutations' own responses.";
3637
+ readonly description: "What an item holds once a write is done, read off the write's own responses — and, for an\nexpected write, what each mutation it sent came to.\n\nEvery write verb and every item a copy lands answers one, with no request added for it: a\nfield the write kept is what the read before it held. `version` is `null` where the source\ncannot vouch for a token from its write's responses — a GitHub board for an item it has just\nwritten, a stdio-hosted plugin, an in-memory source — and otherwise the token a read would\nthen give.";
3167
3638
  readonly properties: {
3168
3639
  readonly parts: {
3169
- readonly description: "One per mutation sent, in the order sent.";
3640
+ readonly description: "One per mutation an expected write sent, in the order sent — absent for a write made\nwithout `--expect`.";
3170
3641
  readonly items: {
3171
3642
  readonly $ref: "#/$defs/WritePart";
3172
3643
  };
3173
- readonly type: "array";
3644
+ readonly type: readonly ["array", "null"];
3645
+ };
3646
+ readonly priority: {
3647
+ readonly anyOf: readonly [{
3648
+ readonly $ref: "#/$defs/Priority";
3649
+ }, {
3650
+ readonly type: "null";
3651
+ }];
3652
+ readonly default: null;
3653
+ readonly description: "A task's priority after the write — `null` for a project or a document, which carry\nnone, and where an expected write that failed cannot say.";
3654
+ };
3655
+ readonly status: {
3656
+ readonly anyOf: readonly [{
3657
+ readonly $ref: "#/$defs/Status";
3658
+ }, {
3659
+ readonly type: "null";
3660
+ }];
3661
+ readonly default: null;
3662
+ readonly description: "The item's status after the write, exactly as `task show` spells it — `null` for a\ndocument, which has none, and where an expected write that failed cannot say.";
3174
3663
  };
3175
3664
  readonly version: {
3176
- readonly description: "The task's version after the write, where the last response determines it.";
3665
+ readonly description: "The item's version after the write, where the write's responses determine it.";
3177
3666
  readonly type: readonly ["string", "null"];
3178
3667
  };
3179
3668
  };
3180
- readonly required: readonly ["parts"];
3181
3669
  readonly type: "object";
3182
3670
  };
3183
3671
  };
@@ -4700,6 +5188,30 @@ export declare const runtimeSchemas: {
4700
5188
  readonly required: readonly ["budget", "unit", "amount", "lower_bound"];
4701
5189
  readonly type: "object";
4702
5190
  };
5191
+ readonly Priority: {
5192
+ readonly description: "How much a task matters, in the one vocabulary every source is normalised into.\n\nFive values, most pressing first after [`None`](Self::None): Linear's own priority has\nexactly these, and a source whose backend has none of its own maps its representation\nonto them. `none` is a value rather than an absent field, because \"no priority is set\" is\nsomething a person sets — writing `none` clears a priority — and a reader tells it apart\nfrom nothing by the value alone.";
5193
+ readonly oneOf: readonly [{
5194
+ readonly const: "none";
5195
+ readonly description: "No priority is set.";
5196
+ readonly type: "string";
5197
+ }, {
5198
+ readonly const: "urgent";
5199
+ readonly description: "Drop everything for it.";
5200
+ readonly type: "string";
5201
+ }, {
5202
+ readonly const: "high";
5203
+ readonly description: "Next, before the rest.";
5204
+ readonly type: "string";
5205
+ }, {
5206
+ readonly const: "medium";
5207
+ readonly description: "In its turn.";
5208
+ readonly type: "string";
5209
+ }, {
5210
+ readonly const: "low";
5211
+ readonly description: "When there is nothing more pressing.";
5212
+ readonly type: "string";
5213
+ }];
5214
+ };
4703
5215
  readonly Spent: {
4704
5216
  readonly description: "What one command spent, summed over the sources in it that meter their own requests.\n\n**Source-owned.** Every figure is what a source said it sent and spent while the command\nran, read through [`TaskSource::metering`](onetaskgraph_plugin_api::TaskSource::metering)\nbefore the command and again after it. The engine adds the differences up by name and\ninterprets none of them, which is why the budget and unit names are open vocabulary.";
4705
5217
  readonly properties: {
@@ -4720,48 +5232,99 @@ export declare const runtimeSchemas: {
4720
5232
  readonly required: readonly ["requests", "budgets"];
4721
5233
  readonly type: "object";
4722
5234
  };
4723
- readonly WriteFallback: {
4724
- readonly description: "That an expected write read its target before writing, and why.";
5235
+ readonly Status: {
5236
+ readonly description: "A source's status, kept in both normalised and original form.\n\n`category` is what every filter compares against; `name` is the source's own\nwording, preserved so display never flattens \"In Review\" into \"In Progress\".";
4725
5237
  readonly properties: {
4726
- readonly read: {
4727
- readonly description: "Always `true`: the write made one read.";
4728
- readonly type: "boolean";
5238
+ readonly category: {
5239
+ readonly $ref: "#/$defs/StatusCategory";
5240
+ readonly description: "The normalised value filters compare against.";
4729
5241
  };
4730
- readonly reason: {
4731
- readonly description: "Why it could not take what it needed from the cache.";
5242
+ readonly name: {
5243
+ readonly description: "The source's own label for this status.";
4732
5244
  readonly type: "string";
4733
5245
  };
4734
5246
  };
4735
- readonly required: readonly ["read", "reason"];
5247
+ readonly required: readonly ["category", "name"];
4736
5248
  readonly type: "object";
4737
5249
  };
4738
- readonly WritePart: {
4739
- readonly description: "One mutation of an expected write.";
5250
+ readonly StatusCategory: {
5251
+ readonly description: "The normalised status vocabulary shared across every source.";
4740
5252
  readonly oneOf: readonly [{
4741
- readonly description: "The backend answered that it was applied.";
4742
- readonly properties: {
4743
- readonly outcome: {
4744
- readonly const: "landed";
4745
- readonly type: "string";
4746
- };
4747
- };
4748
- readonly required: readonly ["outcome"];
4749
- readonly type: "object";
5253
+ readonly const: "draft";
5254
+ readonly description: "Written down but not yet committed to as work.";
5255
+ readonly type: "string";
4750
5256
  }, {
4751
- readonly description: "The backend answered that it was refused.";
4752
- readonly properties: {
4753
- readonly error: {
4754
- readonly description: "What the backend said.";
4755
- readonly type: "string";
4756
- };
4757
- readonly outcome: {
4758
- readonly const: "rejected";
4759
- readonly type: "string";
4760
- };
4761
- readonly stale: {
4762
- readonly default: false;
4763
- readonly description: "Whether it was refused because an id the write took from a primed context — an\nitem's node id, a field's or an option's — no longer resolves. Such a part is\nsent again once, after one read.";
4764
- readonly type: "boolean";
5257
+ readonly const: "backlog";
5258
+ readonly description: "Known about, not yet accepted as ready to work.";
5259
+ readonly type: "string";
5260
+ }, {
5261
+ readonly const: "todo";
5262
+ readonly description: "Accepted and ready to be picked up, and nothing has claimed it.";
5263
+ readonly type: "string";
5264
+ }, {
5265
+ readonly const: "queued";
5266
+ readonly description: "Claimed by work that will do it, and not yet started.";
5267
+ readonly type: "string";
5268
+ }, {
5269
+ readonly const: "in-progress";
5270
+ readonly description: "Being worked on.";
5271
+ readonly type: "string";
5272
+ }, {
5273
+ readonly const: "done";
5274
+ readonly description: "Finished.";
5275
+ readonly type: "string";
5276
+ }, {
5277
+ readonly const: "cancelled";
5278
+ readonly description: "Abandoned.";
5279
+ readonly type: "string";
5280
+ }, {
5281
+ readonly const: "unknown";
5282
+ readonly description: "The source reported a status this vocabulary cannot place.";
5283
+ readonly type: "string";
5284
+ }];
5285
+ };
5286
+ readonly WriteFallback: {
5287
+ readonly description: "That an expected write read its target before writing, and why.";
5288
+ readonly properties: {
5289
+ readonly read: {
5290
+ readonly description: "Always `true`: the write made one read.";
5291
+ readonly type: "boolean";
5292
+ };
5293
+ readonly reason: {
5294
+ readonly description: "Why it could not take what it needed from the cache.";
5295
+ readonly type: "string";
5296
+ };
5297
+ };
5298
+ readonly required: readonly ["read", "reason"];
5299
+ readonly type: "object";
5300
+ };
5301
+ readonly WritePart: {
5302
+ readonly description: "One mutation of an expected write.";
5303
+ readonly oneOf: readonly [{
5304
+ readonly description: "The backend answered that it was applied.";
5305
+ readonly properties: {
5306
+ readonly outcome: {
5307
+ readonly const: "landed";
5308
+ readonly type: "string";
5309
+ };
5310
+ };
5311
+ readonly required: readonly ["outcome"];
5312
+ readonly type: "object";
5313
+ }, {
5314
+ readonly description: "The backend answered that it was refused.";
5315
+ readonly properties: {
5316
+ readonly error: {
5317
+ readonly description: "What the backend said.";
5318
+ readonly type: "string";
5319
+ };
5320
+ readonly outcome: {
5321
+ readonly const: "rejected";
5322
+ readonly type: "string";
5323
+ };
5324
+ readonly stale: {
5325
+ readonly default: false;
5326
+ readonly description: "Whether it was refused because an id the write took from a primed context — an\nitem's node id, a field's or an option's — no longer resolves. Such a part is\nsent again once, after one read.";
5327
+ readonly type: "boolean";
4765
5328
  };
4766
5329
  };
4767
5330
  readonly required: readonly ["outcome", "error"];
@@ -4796,21 +5359,38 @@ export declare const runtimeSchemas: {
4796
5359
  readonly type: "object";
4797
5360
  };
4798
5361
  readonly WriteResult: {
4799
- readonly description: "What each mutation of an expected write came to, built from the mutations' own responses.";
5362
+ readonly description: "What an item holds once a write is done, read off the write's own responses — and, for an\nexpected write, what each mutation it sent came to.\n\nEvery write verb and every item a copy lands answers one, with no request added for it: a\nfield the write kept is what the read before it held. `version` is `null` where the source\ncannot vouch for a token from its write's responses — a GitHub board for an item it has just\nwritten, a stdio-hosted plugin, an in-memory source — and otherwise the token a read would\nthen give.";
4800
5363
  readonly properties: {
4801
5364
  readonly parts: {
4802
- readonly description: "One per mutation sent, in the order sent.";
5365
+ readonly description: "One per mutation an expected write sent, in the order sent — absent for a write made\nwithout `--expect`.";
4803
5366
  readonly items: {
4804
5367
  readonly $ref: "#/$defs/WritePart";
4805
5368
  };
4806
- readonly type: "array";
5369
+ readonly type: readonly ["array", "null"];
5370
+ };
5371
+ readonly priority: {
5372
+ readonly anyOf: readonly [{
5373
+ readonly $ref: "#/$defs/Priority";
5374
+ }, {
5375
+ readonly type: "null";
5376
+ }];
5377
+ readonly default: null;
5378
+ readonly description: "A task's priority after the write — `null` for a project or a document, which carry\nnone, and where an expected write that failed cannot say.";
5379
+ };
5380
+ readonly status: {
5381
+ readonly anyOf: readonly [{
5382
+ readonly $ref: "#/$defs/Status";
5383
+ }, {
5384
+ readonly type: "null";
5385
+ }];
5386
+ readonly default: null;
5387
+ readonly description: "The item's status after the write, exactly as `task show` spells it — `null` for a\ndocument, which has none, and where an expected write that failed cannot say.";
4807
5388
  };
4808
5389
  readonly version: {
4809
- readonly description: "The task's version after the write, where the last response determines it.";
5390
+ readonly description: "The item's version after the write, where the write's responses determine it.";
4810
5391
  readonly type: readonly ["string", "null"];
4811
5392
  };
4812
5393
  };
4813
- readonly required: readonly ["parts"];
4814
5394
  readonly type: "object";
4815
5395
  };
4816
5396
  };
@@ -4831,7 +5411,7 @@ export declare const runtimeSchemas: {
4831
5411
  }, {
4832
5412
  readonly type: "null";
4833
5413
  }];
4834
- readonly description: "What each mutation the write sent came to, and the version it left the task at — for a\nsource that reports its writes' parts.";
5414
+ readonly description: "What the item holds once the write is done — its version, status and priority — and,\nfor a write made with `--expect` on a source that reports its writes' parts, what each\nmutation it sent came to. Absent for a dry run and for an item nothing was written to\nor read of.";
4835
5415
  };
4836
5416
  readonly spent: {
4837
5417
  readonly anyOf: readonly [{
@@ -4985,6 +5565,30 @@ export declare const runtimeSchemas: {
4985
5565
  readonly type: "string";
4986
5566
  }];
4987
5567
  };
5568
+ readonly Priority: {
5569
+ readonly description: "How much a task matters, in the one vocabulary every source is normalised into.\n\nFive values, most pressing first after [`None`](Self::None): Linear's own priority has\nexactly these, and a source whose backend has none of its own maps its representation\nonto them. `none` is a value rather than an absent field, because \"no priority is set\" is\nsomething a person sets — writing `none` clears a priority — and a reader tells it apart\nfrom nothing by the value alone.";
5570
+ readonly oneOf: readonly [{
5571
+ readonly const: "none";
5572
+ readonly description: "No priority is set.";
5573
+ readonly type: "string";
5574
+ }, {
5575
+ readonly const: "urgent";
5576
+ readonly description: "Drop everything for it.";
5577
+ readonly type: "string";
5578
+ }, {
5579
+ readonly const: "high";
5580
+ readonly description: "Next, before the rest.";
5581
+ readonly type: "string";
5582
+ }, {
5583
+ readonly const: "medium";
5584
+ readonly description: "In its turn.";
5585
+ readonly type: "string";
5586
+ }, {
5587
+ readonly const: "low";
5588
+ readonly description: "When there is nothing more pressing.";
5589
+ readonly type: "string";
5590
+ }];
5591
+ };
4988
5592
  readonly SourceName: {
4989
5593
  readonly description: "The name a configuration document gives one configured source.";
4990
5594
  readonly pattern: "^[a-z0-9][a-z0-9-]*$";
@@ -5010,6 +5614,57 @@ export declare const runtimeSchemas: {
5010
5614
  readonly required: readonly ["requests", "budgets"];
5011
5615
  readonly type: "object";
5012
5616
  };
5617
+ readonly Status: {
5618
+ readonly description: "A source's status, kept in both normalised and original form.\n\n`category` is what every filter compares against; `name` is the source's own\nwording, preserved so display never flattens \"In Review\" into \"In Progress\".";
5619
+ readonly properties: {
5620
+ readonly category: {
5621
+ readonly $ref: "#/$defs/StatusCategory";
5622
+ readonly description: "The normalised value filters compare against.";
5623
+ };
5624
+ readonly name: {
5625
+ readonly description: "The source's own label for this status.";
5626
+ readonly type: "string";
5627
+ };
5628
+ };
5629
+ readonly required: readonly ["category", "name"];
5630
+ readonly type: "object";
5631
+ };
5632
+ readonly StatusCategory: {
5633
+ readonly description: "The normalised status vocabulary shared across every source.";
5634
+ readonly oneOf: readonly [{
5635
+ readonly const: "draft";
5636
+ readonly description: "Written down but not yet committed to as work.";
5637
+ readonly type: "string";
5638
+ }, {
5639
+ readonly const: "backlog";
5640
+ readonly description: "Known about, not yet accepted as ready to work.";
5641
+ readonly type: "string";
5642
+ }, {
5643
+ readonly const: "todo";
5644
+ readonly description: "Accepted and ready to be picked up, and nothing has claimed it.";
5645
+ readonly type: "string";
5646
+ }, {
5647
+ readonly const: "queued";
5648
+ readonly description: "Claimed by work that will do it, and not yet started.";
5649
+ readonly type: "string";
5650
+ }, {
5651
+ readonly const: "in-progress";
5652
+ readonly description: "Being worked on.";
5653
+ readonly type: "string";
5654
+ }, {
5655
+ readonly const: "done";
5656
+ readonly description: "Finished.";
5657
+ readonly type: "string";
5658
+ }, {
5659
+ readonly const: "cancelled";
5660
+ readonly description: "Abandoned.";
5661
+ readonly type: "string";
5662
+ }, {
5663
+ readonly const: "unknown";
5664
+ readonly description: "The source reported a status this vocabulary cannot place.";
5665
+ readonly type: "string";
5666
+ }];
5667
+ };
5013
5668
  readonly WriteFallback: {
5014
5669
  readonly description: "That an expected write read its target before writing, and why.";
5015
5670
  readonly properties: {
@@ -5086,21 +5741,38 @@ export declare const runtimeSchemas: {
5086
5741
  readonly type: "object";
5087
5742
  };
5088
5743
  readonly WriteResult: {
5089
- readonly description: "What each mutation of an expected write came to, built from the mutations' own responses.";
5744
+ readonly description: "What an item holds once a write is done, read off the write's own responses — and, for an\nexpected write, what each mutation it sent came to.\n\nEvery write verb and every item a copy lands answers one, with no request added for it: a\nfield the write kept is what the read before it held. `version` is `null` where the source\ncannot vouch for a token from its write's responses — a GitHub board for an item it has just\nwritten, a stdio-hosted plugin, an in-memory source — and otherwise the token a read would\nthen give.";
5090
5745
  readonly properties: {
5091
5746
  readonly parts: {
5092
- readonly description: "One per mutation sent, in the order sent.";
5747
+ readonly description: "One per mutation an expected write sent, in the order sent — absent for a write made\nwithout `--expect`.";
5093
5748
  readonly items: {
5094
5749
  readonly $ref: "#/$defs/WritePart";
5095
5750
  };
5096
- readonly type: "array";
5751
+ readonly type: readonly ["array", "null"];
5752
+ };
5753
+ readonly priority: {
5754
+ readonly anyOf: readonly [{
5755
+ readonly $ref: "#/$defs/Priority";
5756
+ }, {
5757
+ readonly type: "null";
5758
+ }];
5759
+ readonly default: null;
5760
+ readonly description: "A task's priority after the write — `null` for a project or a document, which carry\nnone, and where an expected write that failed cannot say.";
5761
+ };
5762
+ readonly status: {
5763
+ readonly anyOf: readonly [{
5764
+ readonly $ref: "#/$defs/Status";
5765
+ }, {
5766
+ readonly type: "null";
5767
+ }];
5768
+ readonly default: null;
5769
+ readonly description: "The item's status after the write, exactly as `task show` spells it — `null` for a\ndocument, which has none, and where an expected write that failed cannot say.";
5097
5770
  };
5098
5771
  readonly version: {
5099
- readonly description: "The task's version after the write, where the last response determines it.";
5772
+ readonly description: "The item's version after the write, where the write's responses determine it.";
5100
5773
  readonly type: readonly ["string", "null"];
5101
5774
  };
5102
5775
  };
5103
- readonly required: readonly ["parts"];
5104
5776
  readonly type: "object";
5105
5777
  };
5106
5778
  };
@@ -5119,13 +5791,21 @@ export declare const runtimeSchemas: {
5119
5791
  }];
5120
5792
  readonly description: "That the write had to read its target first, and why — absent when it sent only its\nmutations.";
5121
5793
  };
5794
+ readonly held: {
5795
+ readonly anyOf: readonly [{
5796
+ readonly $ref: "#/$defs/WriteResult";
5797
+ }, {
5798
+ readonly type: "null";
5799
+ }];
5800
+ readonly description: "What the destination item a copy refused to write held, as the copy's read of it\nbefore writing found it — present only for a refusal made after that read, such as\n`target-task-origin`.";
5801
+ };
5122
5802
  readonly result: {
5123
5803
  readonly anyOf: readonly [{
5124
5804
  readonly $ref: "#/$defs/WriteResult";
5125
5805
  }, {
5126
5806
  readonly type: "null";
5127
5807
  }];
5128
- readonly description: "What each mutation the write sent came to, and the version it left the task at — for a\nsource that reports its writes' parts.";
5808
+ readonly description: "What the item holds once the write is done — its version, status and priority — and,\nfor a write made with `--expect` on a source that reports its writes' parts, what each\nmutation it sent came to. Absent for a dry run and for an item nothing was written to\nor read of.";
5129
5809
  };
5130
5810
  readonly spent: {
5131
5811
  readonly anyOf: readonly [{
@@ -5493,6 +6173,172 @@ export declare const runtimeSchemas: {
5493
6173
  readonly title: "HeldTask";
5494
6174
  readonly type: "object";
5495
6175
  };
6176
+ readonly HumanTaskProjected: {
6177
+ readonly $defs: {
6178
+ readonly SourceName: {
6179
+ readonly description: "The name a configuration document gives one configured source.";
6180
+ readonly pattern: "^[a-z0-9][a-z0-9-]*$";
6181
+ readonly type: "string";
6182
+ };
6183
+ };
6184
+ readonly $schema: "https://json-schema.org/draft/2020-12/schema";
6185
+ readonly additionalProperties: false;
6186
+ readonly description: "A durable projection's bound tracker identity, suitable for a directly clickable card.";
6187
+ readonly properties: {
6188
+ readonly project: {
6189
+ readonly description: "The resolved destination project.";
6190
+ readonly type: "string";
6191
+ };
6192
+ readonly source: {
6193
+ readonly $ref: "#/$defs/SourceName";
6194
+ readonly description: "The resolved configured source.";
6195
+ };
6196
+ readonly task: {
6197
+ readonly description: "The qualified task identity.";
6198
+ readonly type: "string";
6199
+ };
6200
+ readonly url: {
6201
+ readonly description: "The canonical tracker issue URL.";
6202
+ readonly type: "string";
6203
+ };
6204
+ };
6205
+ readonly required: readonly ["task", "url", "project", "source"];
6206
+ readonly title: "HumanTaskProjected";
6207
+ readonly type: "object";
6208
+ };
6209
+ readonly HumanTaskProjection: {
6210
+ readonly $defs: {
6211
+ readonly Priority: {
6212
+ readonly description: "How much a task matters, in the one vocabulary every source is normalised into.\n\nFive values, most pressing first after [`None`](Self::None): Linear's own priority has\nexactly these, and a source whose backend has none of its own maps its representation\nonto them. `none` is a value rather than an absent field, because \"no priority is set\" is\nsomething a person sets — writing `none` clears a priority — and a reader tells it apart\nfrom nothing by the value alone.";
6213
+ readonly oneOf: readonly [{
6214
+ readonly const: "none";
6215
+ readonly description: "No priority is set.";
6216
+ readonly type: "string";
6217
+ }, {
6218
+ readonly const: "urgent";
6219
+ readonly description: "Drop everything for it.";
6220
+ readonly type: "string";
6221
+ }, {
6222
+ readonly const: "high";
6223
+ readonly description: "Next, before the rest.";
6224
+ readonly type: "string";
6225
+ }, {
6226
+ readonly const: "medium";
6227
+ readonly description: "In its turn.";
6228
+ readonly type: "string";
6229
+ }, {
6230
+ readonly const: "low";
6231
+ readonly description: "When there is nothing more pressing.";
6232
+ readonly type: "string";
6233
+ }];
6234
+ };
6235
+ readonly ProjectionOwner: {
6236
+ readonly additionalProperties: false;
6237
+ readonly description: "The producer that owns the intent; nullable run and plan are explicit on the wire.";
6238
+ readonly properties: {
6239
+ readonly plan: {
6240
+ readonly description: "The owning plan, when applicable.";
6241
+ readonly type: readonly ["string", "null"];
6242
+ };
6243
+ readonly run: {
6244
+ readonly description: "The owning run, when applicable.";
6245
+ readonly type: readonly ["string", "null"];
6246
+ };
6247
+ readonly session: {
6248
+ readonly description: "The owning session.";
6249
+ readonly type: "string";
6250
+ };
6251
+ };
6252
+ readonly required: readonly ["session", "run", "plan"];
6253
+ readonly type: "object";
6254
+ };
6255
+ readonly ProjectionState: {
6256
+ readonly description: "The requested tracker lifecycle. Questions have no representation here.";
6257
+ readonly oneOf: readonly [{
6258
+ readonly const: "open";
6259
+ readonly description: "The operator has work to do.";
6260
+ readonly type: "string";
6261
+ }, {
6262
+ readonly const: "completed";
6263
+ readonly description: "The operator completed the work.";
6264
+ readonly type: "string";
6265
+ }, {
6266
+ readonly const: "dismissed";
6267
+ readonly description: "The operator dismissed the work, optionally recording a reason.";
6268
+ readonly type: "string";
6269
+ }];
6270
+ };
6271
+ readonly ProjectionVersion: {
6272
+ readonly const: 1;
6273
+ readonly type: "integer";
6274
+ };
6275
+ readonly Repository: {
6276
+ readonly description: "A repository identified by its normalized origin, without a URL scheme or `.git` suffix.";
6277
+ readonly type: "string";
6278
+ };
6279
+ readonly SourceName: {
6280
+ readonly description: "The name a configuration document gives one configured source.";
6281
+ readonly pattern: "^[a-z0-9][a-z0-9-]*$";
6282
+ readonly type: "string";
6283
+ };
6284
+ };
6285
+ readonly $schema: "https://json-schema.org/draft/2020-12/schema";
6286
+ readonly additionalProperties: false;
6287
+ readonly description: "Version 1 of the general human task projection request.";
6288
+ readonly properties: {
6289
+ readonly body: {
6290
+ readonly description: "The visible task content.";
6291
+ readonly type: "string";
6292
+ };
6293
+ readonly item_id: {
6294
+ readonly description: "The external idempotency identity, stable across producer retries.";
6295
+ readonly type: "string";
6296
+ };
6297
+ readonly owner: {
6298
+ readonly $ref: "#/$defs/ProjectionOwner";
6299
+ readonly description: "The producer that owns the intent.";
6300
+ };
6301
+ readonly priority: {
6302
+ readonly $ref: "#/$defs/Priority";
6303
+ readonly description: "Its priority, using the existing plugin API serialization.";
6304
+ };
6305
+ readonly project: {
6306
+ readonly description: "The plan's resolved destination project, or null for a configured human project.";
6307
+ readonly type: readonly ["string", "null"];
6308
+ };
6309
+ readonly reason: {
6310
+ readonly default: null;
6311
+ readonly description: "An optional dismissal reason. Omission and null both preserve absence.";
6312
+ readonly type: readonly ["string", "null"];
6313
+ };
6314
+ readonly repositories: {
6315
+ readonly description: "Normalized repository origins whose work this item concerns.";
6316
+ readonly items: {
6317
+ readonly $ref: "#/$defs/Repository";
6318
+ };
6319
+ readonly type: "array";
6320
+ };
6321
+ readonly schema_version: {
6322
+ readonly $ref: "#/$defs/ProjectionVersion";
6323
+ readonly description: "The wire contract version, always 1.";
6324
+ };
6325
+ readonly source: {
6326
+ readonly $ref: "#/$defs/SourceName";
6327
+ readonly description: "The configured source through which placement is resolved.";
6328
+ };
6329
+ readonly state: {
6330
+ readonly $ref: "#/$defs/ProjectionState";
6331
+ readonly description: "The desired lifecycle.";
6332
+ };
6333
+ readonly title: {
6334
+ readonly description: "The visible task title.";
6335
+ readonly type: "string";
6336
+ };
6337
+ };
6338
+ readonly required: readonly ["schema_version", "item_id", "owner", "title", "body", "priority", "repositories", "project", "source", "state"];
6339
+ readonly title: "HumanTaskProjection";
6340
+ readonly type: "object";
6341
+ };
5496
6342
  readonly IssueCompleted: {
5497
6343
  readonly $defs: {
5498
6344
  readonly CompleteAction: {
@@ -6558,11 +7404,19 @@ export declare const runtimeSchemas: {
6558
7404
  readonly const: "match";
6559
7405
  readonly description: "A search of the destination by the caller's `--match-by`.";
6560
7406
  readonly type: "string";
7407
+ }, {
7408
+ readonly const: "intent";
7409
+ readonly description: "The item the destination holds under the key of a create an earlier attempt of this\ncopy recorded its intent for, at `onetaskgraph.creating`: that attempt's create,\nfinished rather than made twice.";
7410
+ readonly type: "string";
6561
7411
  }];
6562
7412
  };
6563
7413
  readonly CreatesIn: {
6564
7414
  readonly description: "Where a create would file a task's issue.";
6565
7415
  readonly properties: {
7416
+ readonly refused: {
7417
+ readonly description: "Why the destination's own policy on where it creates — a GitHub Projects source's\n`creation_owners` — would refuse a create there, as the copy's refusal says it; absent\nwhen it would not. The locate itself never fails for it.";
7418
+ readonly type: readonly ["string", "null"];
7419
+ };
6566
7420
  readonly repository: {
6567
7421
  readonly $ref: "#/$defs/Repository";
6568
7422
  readonly description: "The repository, as a normalized origin `host/owner/name`.";
@@ -6776,6 +7630,30 @@ export declare const runtimeSchemas: {
6776
7630
  readonly description: "One caller-owned metadata key: `<namespace>.<name>`, at least two non-empty segments\nseparated by dots, whose first segment is not [`MetadataKey::RESERVED_NAMESPACE`].\n\nValidated wherever one is built, deserialized included, so a plugin handed one never has\nto ask whether it names a key this product owns.";
6777
7631
  readonly type: "string";
6778
7632
  };
7633
+ readonly Priority: {
7634
+ readonly description: "How much a task matters, in the one vocabulary every source is normalised into.\n\nFive values, most pressing first after [`None`](Self::None): Linear's own priority has\nexactly these, and a source whose backend has none of its own maps its representation\nonto them. `none` is a value rather than an absent field, because \"no priority is set\" is\nsomething a person sets — writing `none` clears a priority — and a reader tells it apart\nfrom nothing by the value alone.";
7635
+ readonly oneOf: readonly [{
7636
+ readonly const: "none";
7637
+ readonly description: "No priority is set.";
7638
+ readonly type: "string";
7639
+ }, {
7640
+ readonly const: "urgent";
7641
+ readonly description: "Drop everything for it.";
7642
+ readonly type: "string";
7643
+ }, {
7644
+ readonly const: "high";
7645
+ readonly description: "Next, before the rest.";
7646
+ readonly type: "string";
7647
+ }, {
7648
+ readonly const: "medium";
7649
+ readonly description: "In its turn.";
7650
+ readonly type: "string";
7651
+ }, {
7652
+ readonly const: "low";
7653
+ readonly description: "When there is nothing more pressing.";
7654
+ readonly type: "string";
7655
+ }];
7656
+ };
6779
7657
  readonly Spent: {
6780
7658
  readonly description: "What one command spent, summed over the sources in it that meter their own requests.\n\n**Source-owned.** Every figure is what a source said it sent and spent while the command\nran, read through [`TaskSource::metering`](onetaskgraph_plugin_api::TaskSource::metering)\nbefore the command and again after it. The engine adds the differences up by name and\ninterprets none of them, which is why the budget and unit names are open vocabulary.";
6781
7659
  readonly properties: {
@@ -6796,6 +7674,57 @@ export declare const runtimeSchemas: {
6796
7674
  readonly required: readonly ["requests", "budgets"];
6797
7675
  readonly type: "object";
6798
7676
  };
7677
+ readonly Status: {
7678
+ readonly description: "A source's status, kept in both normalised and original form.\n\n`category` is what every filter compares against; `name` is the source's own\nwording, preserved so display never flattens \"In Review\" into \"In Progress\".";
7679
+ readonly properties: {
7680
+ readonly category: {
7681
+ readonly $ref: "#/$defs/StatusCategory";
7682
+ readonly description: "The normalised value filters compare against.";
7683
+ };
7684
+ readonly name: {
7685
+ readonly description: "The source's own label for this status.";
7686
+ readonly type: "string";
7687
+ };
7688
+ };
7689
+ readonly required: readonly ["category", "name"];
7690
+ readonly type: "object";
7691
+ };
7692
+ readonly StatusCategory: {
7693
+ readonly description: "The normalised status vocabulary shared across every source.";
7694
+ readonly oneOf: readonly [{
7695
+ readonly const: "draft";
7696
+ readonly description: "Written down but not yet committed to as work.";
7697
+ readonly type: "string";
7698
+ }, {
7699
+ readonly const: "backlog";
7700
+ readonly description: "Known about, not yet accepted as ready to work.";
7701
+ readonly type: "string";
7702
+ }, {
7703
+ readonly const: "todo";
7704
+ readonly description: "Accepted and ready to be picked up, and nothing has claimed it.";
7705
+ readonly type: "string";
7706
+ }, {
7707
+ readonly const: "queued";
7708
+ readonly description: "Claimed by work that will do it, and not yet started.";
7709
+ readonly type: "string";
7710
+ }, {
7711
+ readonly const: "in-progress";
7712
+ readonly description: "Being worked on.";
7713
+ readonly type: "string";
7714
+ }, {
7715
+ readonly const: "done";
7716
+ readonly description: "Finished.";
7717
+ readonly type: "string";
7718
+ }, {
7719
+ readonly const: "cancelled";
7720
+ readonly description: "Abandoned.";
7721
+ readonly type: "string";
7722
+ }, {
7723
+ readonly const: "unknown";
7724
+ readonly description: "The source reported a status this vocabulary cannot place.";
7725
+ readonly type: "string";
7726
+ }];
7727
+ };
6799
7728
  readonly WriteFallback: {
6800
7729
  readonly description: "That an expected write read its target before writing, and why.";
6801
7730
  readonly properties: {
@@ -6872,21 +7801,38 @@ export declare const runtimeSchemas: {
6872
7801
  readonly type: "object";
6873
7802
  };
6874
7803
  readonly WriteResult: {
6875
- readonly description: "What each mutation of an expected write came to, built from the mutations' own responses.";
7804
+ readonly description: "What an item holds once a write is done, read off the write's own responses — and, for an\nexpected write, what each mutation it sent came to.\n\nEvery write verb and every item a copy lands answers one, with no request added for it: a\nfield the write kept is what the read before it held. `version` is `null` where the source\ncannot vouch for a token from its write's responses — a GitHub board for an item it has just\nwritten, a stdio-hosted plugin, an in-memory source — and otherwise the token a read would\nthen give.";
6876
7805
  readonly properties: {
6877
7806
  readonly parts: {
6878
- readonly description: "One per mutation sent, in the order sent.";
7807
+ readonly description: "One per mutation an expected write sent, in the order sent — absent for a write made\nwithout `--expect`.";
6879
7808
  readonly items: {
6880
7809
  readonly $ref: "#/$defs/WritePart";
6881
7810
  };
6882
- readonly type: "array";
7811
+ readonly type: readonly ["array", "null"];
7812
+ };
7813
+ readonly priority: {
7814
+ readonly anyOf: readonly [{
7815
+ readonly $ref: "#/$defs/Priority";
7816
+ }, {
7817
+ readonly type: "null";
7818
+ }];
7819
+ readonly default: null;
7820
+ readonly description: "A task's priority after the write — `null` for a project or a document, which carry\nnone, and where an expected write that failed cannot say.";
7821
+ };
7822
+ readonly status: {
7823
+ readonly anyOf: readonly [{
7824
+ readonly $ref: "#/$defs/Status";
7825
+ }, {
7826
+ readonly type: "null";
7827
+ }];
7828
+ readonly default: null;
7829
+ readonly description: "The item's status after the write, exactly as `task show` spells it — `null` for a\ndocument, which has none, and where an expected write that failed cannot say.";
6883
7830
  };
6884
7831
  readonly version: {
6885
- readonly description: "The task's version after the write, where the last response determines it.";
7832
+ readonly description: "The item's version after the write, where the write's responses determine it.";
6886
7833
  readonly type: readonly ["string", "null"];
6887
7834
  };
6888
7835
  };
6889
- readonly required: readonly ["parts"];
6890
7836
  readonly type: "object";
6891
7837
  };
6892
7838
  };
@@ -16207,6 +17153,30 @@ export declare const runtimeSchemas: {
16207
17153
  readonly description: "One item, qualified by the source it came from.\n\nRendered `<source>:<native>` and parsed by splitting on the **first** colon,\nso a native id may contain colons freely.";
16208
17154
  readonly type: "string";
16209
17155
  };
17156
+ readonly Priority: {
17157
+ readonly description: "How much a task matters, in the one vocabulary every source is normalised into.\n\nFive values, most pressing first after [`None`](Self::None): Linear's own priority has\nexactly these, and a source whose backend has none of its own maps its representation\nonto them. `none` is a value rather than an absent field, because \"no priority is set\" is\nsomething a person sets — writing `none` clears a priority — and a reader tells it apart\nfrom nothing by the value alone.";
17158
+ readonly oneOf: readonly [{
17159
+ readonly const: "none";
17160
+ readonly description: "No priority is set.";
17161
+ readonly type: "string";
17162
+ }, {
17163
+ readonly const: "urgent";
17164
+ readonly description: "Drop everything for it.";
17165
+ readonly type: "string";
17166
+ }, {
17167
+ readonly const: "high";
17168
+ readonly description: "Next, before the rest.";
17169
+ readonly type: "string";
17170
+ }, {
17171
+ readonly const: "medium";
17172
+ readonly description: "In its turn.";
17173
+ readonly type: "string";
17174
+ }, {
17175
+ readonly const: "low";
17176
+ readonly description: "When there is nothing more pressing.";
17177
+ readonly type: "string";
17178
+ }];
17179
+ };
16210
17180
  readonly Spent: {
16211
17181
  readonly description: "What one command spent, summed over the sources in it that meter their own requests.\n\n**Source-owned.** Every figure is what a source said it sent and spent while the command\nran, read through [`TaskSource::metering`](onetaskgraph_plugin_api::TaskSource::metering)\nbefore the command and again after it. The engine adds the differences up by name and\ninterprets none of them, which is why the budget and unit names are open vocabulary.";
16212
17182
  readonly properties: {
@@ -16227,6 +17197,57 @@ export declare const runtimeSchemas: {
16227
17197
  readonly required: readonly ["requests", "budgets"];
16228
17198
  readonly type: "object";
16229
17199
  };
17200
+ readonly Status: {
17201
+ readonly description: "A source's status, kept in both normalised and original form.\n\n`category` is what every filter compares against; `name` is the source's own\nwording, preserved so display never flattens \"In Review\" into \"In Progress\".";
17202
+ readonly properties: {
17203
+ readonly category: {
17204
+ readonly $ref: "#/$defs/StatusCategory";
17205
+ readonly description: "The normalised value filters compare against.";
17206
+ };
17207
+ readonly name: {
17208
+ readonly description: "The source's own label for this status.";
17209
+ readonly type: "string";
17210
+ };
17211
+ };
17212
+ readonly required: readonly ["category", "name"];
17213
+ readonly type: "object";
17214
+ };
17215
+ readonly StatusCategory: {
17216
+ readonly description: "The normalised status vocabulary shared across every source.";
17217
+ readonly oneOf: readonly [{
17218
+ readonly const: "draft";
17219
+ readonly description: "Written down but not yet committed to as work.";
17220
+ readonly type: "string";
17221
+ }, {
17222
+ readonly const: "backlog";
17223
+ readonly description: "Known about, not yet accepted as ready to work.";
17224
+ readonly type: "string";
17225
+ }, {
17226
+ readonly const: "todo";
17227
+ readonly description: "Accepted and ready to be picked up, and nothing has claimed it.";
17228
+ readonly type: "string";
17229
+ }, {
17230
+ readonly const: "queued";
17231
+ readonly description: "Claimed by work that will do it, and not yet started.";
17232
+ readonly type: "string";
17233
+ }, {
17234
+ readonly const: "in-progress";
17235
+ readonly description: "Being worked on.";
17236
+ readonly type: "string";
17237
+ }, {
17238
+ readonly const: "done";
17239
+ readonly description: "Finished.";
17240
+ readonly type: "string";
17241
+ }, {
17242
+ readonly const: "cancelled";
17243
+ readonly description: "Abandoned.";
17244
+ readonly type: "string";
17245
+ }, {
17246
+ readonly const: "unknown";
17247
+ readonly description: "The source reported a status this vocabulary cannot place.";
17248
+ readonly type: "string";
17249
+ }];
17250
+ };
16230
17251
  readonly WriteFallback: {
16231
17252
  readonly description: "That an expected write read its target before writing, and why.";
16232
17253
  readonly properties: {
@@ -16303,21 +17324,38 @@ export declare const runtimeSchemas: {
16303
17324
  readonly type: "object";
16304
17325
  };
16305
17326
  readonly WriteResult: {
16306
- readonly description: "What each mutation of an expected write came to, built from the mutations' own responses.";
17327
+ readonly description: "What an item holds once a write is done, read off the write's own responses — and, for an\nexpected write, what each mutation it sent came to.\n\nEvery write verb and every item a copy lands answers one, with no request added for it: a\nfield the write kept is what the read before it held. `version` is `null` where the source\ncannot vouch for a token from its write's responses — a GitHub board for an item it has just\nwritten, a stdio-hosted plugin, an in-memory source — and otherwise the token a read would\nthen give.";
16307
17328
  readonly properties: {
16308
17329
  readonly parts: {
16309
- readonly description: "One per mutation sent, in the order sent.";
17330
+ readonly description: "One per mutation an expected write sent, in the order sent — absent for a write made\nwithout `--expect`.";
16310
17331
  readonly items: {
16311
17332
  readonly $ref: "#/$defs/WritePart";
16312
17333
  };
16313
- readonly type: "array";
17334
+ readonly type: readonly ["array", "null"];
17335
+ };
17336
+ readonly priority: {
17337
+ readonly anyOf: readonly [{
17338
+ readonly $ref: "#/$defs/Priority";
17339
+ }, {
17340
+ readonly type: "null";
17341
+ }];
17342
+ readonly default: null;
17343
+ readonly description: "A task's priority after the write — `null` for a project or a document, which carry\nnone, and where an expected write that failed cannot say.";
17344
+ };
17345
+ readonly status: {
17346
+ readonly anyOf: readonly [{
17347
+ readonly $ref: "#/$defs/Status";
17348
+ }, {
17349
+ readonly type: "null";
17350
+ }];
17351
+ readonly default: null;
17352
+ readonly description: "The item's status after the write, exactly as `task show` spells it — `null` for a\ndocument, which has none, and where an expected write that failed cannot say.";
16314
17353
  };
16315
17354
  readonly version: {
16316
- readonly description: "The task's version after the write, where the last response determines it.";
17355
+ readonly description: "The item's version after the write, where the write's responses determine it.";
16317
17356
  readonly type: readonly ["string", "null"];
16318
17357
  };
16319
17358
  };
16320
- readonly required: readonly ["parts"];
16321
17359
  readonly type: "object";
16322
17360
  };
16323
17361
  };
@@ -17988,6 +19026,57 @@ export declare const runtimeSchemas: {
17988
19026
  readonly required: readonly ["requests", "budgets"];
17989
19027
  readonly type: "object";
17990
19028
  };
19029
+ readonly Status: {
19030
+ readonly description: "A source's status, kept in both normalised and original form.\n\n`category` is what every filter compares against; `name` is the source's own\nwording, preserved so display never flattens \"In Review\" into \"In Progress\".";
19031
+ readonly properties: {
19032
+ readonly category: {
19033
+ readonly $ref: "#/$defs/StatusCategory";
19034
+ readonly description: "The normalised value filters compare against.";
19035
+ };
19036
+ readonly name: {
19037
+ readonly description: "The source's own label for this status.";
19038
+ readonly type: "string";
19039
+ };
19040
+ };
19041
+ readonly required: readonly ["category", "name"];
19042
+ readonly type: "object";
19043
+ };
19044
+ readonly StatusCategory: {
19045
+ readonly description: "The normalised status vocabulary shared across every source.";
19046
+ readonly oneOf: readonly [{
19047
+ readonly const: "draft";
19048
+ readonly description: "Written down but not yet committed to as work.";
19049
+ readonly type: "string";
19050
+ }, {
19051
+ readonly const: "backlog";
19052
+ readonly description: "Known about, not yet accepted as ready to work.";
19053
+ readonly type: "string";
19054
+ }, {
19055
+ readonly const: "todo";
19056
+ readonly description: "Accepted and ready to be picked up, and nothing has claimed it.";
19057
+ readonly type: "string";
19058
+ }, {
19059
+ readonly const: "queued";
19060
+ readonly description: "Claimed by work that will do it, and not yet started.";
19061
+ readonly type: "string";
19062
+ }, {
19063
+ readonly const: "in-progress";
19064
+ readonly description: "Being worked on.";
19065
+ readonly type: "string";
19066
+ }, {
19067
+ readonly const: "done";
19068
+ readonly description: "Finished.";
19069
+ readonly type: "string";
19070
+ }, {
19071
+ readonly const: "cancelled";
19072
+ readonly description: "Abandoned.";
19073
+ readonly type: "string";
19074
+ }, {
19075
+ readonly const: "unknown";
19076
+ readonly description: "The source reported a status this vocabulary cannot place.";
19077
+ readonly type: "string";
19078
+ }];
19079
+ };
17991
19080
  readonly WriteFallback: {
17992
19081
  readonly description: "That an expected write read its target before writing, and why.";
17993
19082
  readonly properties: {
@@ -18064,21 +19153,38 @@ export declare const runtimeSchemas: {
18064
19153
  readonly type: "object";
18065
19154
  };
18066
19155
  readonly WriteResult: {
18067
- readonly description: "What each mutation of an expected write came to, built from the mutations' own responses.";
19156
+ readonly description: "What an item holds once a write is done, read off the write's own responses — and, for an\nexpected write, what each mutation it sent came to.\n\nEvery write verb and every item a copy lands answers one, with no request added for it: a\nfield the write kept is what the read before it held. `version` is `null` where the source\ncannot vouch for a token from its write's responses — a GitHub board for an item it has just\nwritten, a stdio-hosted plugin, an in-memory source — and otherwise the token a read would\nthen give.";
18068
19157
  readonly properties: {
18069
19158
  readonly parts: {
18070
- readonly description: "One per mutation sent, in the order sent.";
19159
+ readonly description: "One per mutation an expected write sent, in the order sent — absent for a write made\nwithout `--expect`.";
18071
19160
  readonly items: {
18072
19161
  readonly $ref: "#/$defs/WritePart";
18073
19162
  };
18074
- readonly type: "array";
19163
+ readonly type: readonly ["array", "null"];
19164
+ };
19165
+ readonly priority: {
19166
+ readonly anyOf: readonly [{
19167
+ readonly $ref: "#/$defs/Priority";
19168
+ }, {
19169
+ readonly type: "null";
19170
+ }];
19171
+ readonly default: null;
19172
+ readonly description: "A task's priority after the write — `null` for a project or a document, which carry\nnone, and where an expected write that failed cannot say.";
19173
+ };
19174
+ readonly status: {
19175
+ readonly anyOf: readonly [{
19176
+ readonly $ref: "#/$defs/Status";
19177
+ }, {
19178
+ readonly type: "null";
19179
+ }];
19180
+ readonly default: null;
19181
+ readonly description: "The item's status after the write, exactly as `task show` spells it — `null` for a\ndocument, which has none, and where an expected write that failed cannot say.";
18075
19182
  };
18076
19183
  readonly version: {
18077
- readonly description: "The task's version after the write, where the last response determines it.";
19184
+ readonly description: "The item's version after the write, where the write's responses determine it.";
18078
19185
  readonly type: readonly ["string", "null"];
18079
19186
  };
18080
19187
  };
18081
- readonly required: readonly ["parts"];
18082
19188
  readonly type: "object";
18083
19189
  };
18084
19190
  };
@@ -18523,6 +19629,30 @@ export declare const runtimeSchemas: {
18523
19629
  readonly description: "One item, qualified by the source it came from.\n\nRendered `<source>:<native>` and parsed by splitting on the **first** colon,\nso a native id may contain colons freely.";
18524
19630
  readonly type: "string";
18525
19631
  };
19632
+ readonly Priority: {
19633
+ readonly description: "How much a task matters, in the one vocabulary every source is normalised into.\n\nFive values, most pressing first after [`None`](Self::None): Linear's own priority has\nexactly these, and a source whose backend has none of its own maps its representation\nonto them. `none` is a value rather than an absent field, because \"no priority is set\" is\nsomething a person sets — writing `none` clears a priority — and a reader tells it apart\nfrom nothing by the value alone.";
19634
+ readonly oneOf: readonly [{
19635
+ readonly const: "none";
19636
+ readonly description: "No priority is set.";
19637
+ readonly type: "string";
19638
+ }, {
19639
+ readonly const: "urgent";
19640
+ readonly description: "Drop everything for it.";
19641
+ readonly type: "string";
19642
+ }, {
19643
+ readonly const: "high";
19644
+ readonly description: "Next, before the rest.";
19645
+ readonly type: "string";
19646
+ }, {
19647
+ readonly const: "medium";
19648
+ readonly description: "In its turn.";
19649
+ readonly type: "string";
19650
+ }, {
19651
+ readonly const: "low";
19652
+ readonly description: "When there is nothing more pressing.";
19653
+ readonly type: "string";
19654
+ }];
19655
+ };
18526
19656
  readonly SourceName: {
18527
19657
  readonly description: "The name a configuration document gives one configured source.";
18528
19658
  readonly pattern: "^[a-z0-9][a-z0-9-]*$";
@@ -18675,21 +19805,38 @@ export declare const runtimeSchemas: {
18675
19805
  readonly type: "object";
18676
19806
  };
18677
19807
  readonly WriteResult: {
18678
- readonly description: "What each mutation of an expected write came to, built from the mutations' own responses.";
19808
+ readonly description: "What an item holds once a write is done, read off the write's own responses — and, for an\nexpected write, what each mutation it sent came to.\n\nEvery write verb and every item a copy lands answers one, with no request added for it: a\nfield the write kept is what the read before it held. `version` is `null` where the source\ncannot vouch for a token from its write's responses — a GitHub board for an item it has just\nwritten, a stdio-hosted plugin, an in-memory source — and otherwise the token a read would\nthen give.";
18679
19809
  readonly properties: {
18680
19810
  readonly parts: {
18681
- readonly description: "One per mutation sent, in the order sent.";
19811
+ readonly description: "One per mutation an expected write sent, in the order sent — absent for a write made\nwithout `--expect`.";
18682
19812
  readonly items: {
18683
19813
  readonly $ref: "#/$defs/WritePart";
18684
19814
  };
18685
- readonly type: "array";
19815
+ readonly type: readonly ["array", "null"];
19816
+ };
19817
+ readonly priority: {
19818
+ readonly anyOf: readonly [{
19819
+ readonly $ref: "#/$defs/Priority";
19820
+ }, {
19821
+ readonly type: "null";
19822
+ }];
19823
+ readonly default: null;
19824
+ readonly description: "A task's priority after the write — `null` for a project or a document, which carry\nnone, and where an expected write that failed cannot say.";
19825
+ };
19826
+ readonly status: {
19827
+ readonly anyOf: readonly [{
19828
+ readonly $ref: "#/$defs/Status";
19829
+ }, {
19830
+ readonly type: "null";
19831
+ }];
19832
+ readonly default: null;
19833
+ readonly description: "The item's status after the write, exactly as `task show` spells it — `null` for a\ndocument, which has none, and where an expected write that failed cannot say.";
18686
19834
  };
18687
19835
  readonly version: {
18688
- readonly description: "The task's version after the write, where the last response determines it.";
19836
+ readonly description: "The item's version after the write, where the write's responses determine it.";
18689
19837
  readonly type: readonly ["string", "null"];
18690
19838
  };
18691
19839
  };
18692
- readonly required: readonly ["parts"];
18693
19840
  readonly type: "object";
18694
19841
  };
18695
19842
  };
@@ -19831,21 +20978,38 @@ export declare const runtimeSchemas: {
19831
20978
  readonly type: "object";
19832
20979
  };
19833
20980
  readonly WriteResult: {
19834
- readonly description: "What each mutation of an expected write came to, built from the mutations' own responses.";
20981
+ readonly description: "What an item holds once a write is done, read off the write's own responses — and, for an\nexpected write, what each mutation it sent came to.\n\nEvery write verb and every item a copy lands answers one, with no request added for it: a\nfield the write kept is what the read before it held. `version` is `null` where the source\ncannot vouch for a token from its write's responses — a GitHub board for an item it has just\nwritten, a stdio-hosted plugin, an in-memory source — and otherwise the token a read would\nthen give.";
19835
20982
  readonly properties: {
19836
20983
  readonly parts: {
19837
- readonly description: "One per mutation sent, in the order sent.";
20984
+ readonly description: "One per mutation an expected write sent, in the order sent — absent for a write made\nwithout `--expect`.";
19838
20985
  readonly items: {
19839
20986
  readonly $ref: "#/$defs/WritePart";
19840
20987
  };
19841
- readonly type: "array";
20988
+ readonly type: readonly ["array", "null"];
20989
+ };
20990
+ readonly priority: {
20991
+ readonly anyOf: readonly [{
20992
+ readonly $ref: "#/$defs/Priority";
20993
+ }, {
20994
+ readonly type: "null";
20995
+ }];
20996
+ readonly default: null;
20997
+ readonly description: "A task's priority after the write — `null` for a project or a document, which carry\nnone, and where an expected write that failed cannot say.";
20998
+ };
20999
+ readonly status: {
21000
+ readonly anyOf: readonly [{
21001
+ readonly $ref: "#/$defs/Status";
21002
+ }, {
21003
+ readonly type: "null";
21004
+ }];
21005
+ readonly default: null;
21006
+ readonly description: "The item's status after the write, exactly as `task show` spells it — `null` for a\ndocument, which has none, and where an expected write that failed cannot say.";
19842
21007
  };
19843
21008
  readonly version: {
19844
- readonly description: "The task's version after the write, where the last response determines it.";
21009
+ readonly description: "The item's version after the write, where the write's responses determine it.";
19845
21010
  readonly type: readonly ["string", "null"];
19846
21011
  };
19847
21012
  };
19848
- readonly required: readonly ["parts"];
19849
21013
  readonly type: "object";
19850
21014
  };
19851
21015
  };