@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.
- package/dist/client.d.ts +11 -2
- package/dist/generated/commands.d.ts +1 -1
- package/dist/generated/models.d.ts +826 -73
- package/dist/generated/schemas.d.ts +1263 -99
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1847 -161
- package/package.json +2 -2
|
@@ -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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
2786
|
-
readonly description: "
|
|
2787
|
-
readonly
|
|
2788
|
-
|
|
2789
|
-
|
|
2790
|
-
|
|
2791
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
4724
|
-
readonly description: "
|
|
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
|
|
4727
|
-
readonly
|
|
4728
|
-
readonly
|
|
5238
|
+
readonly category: {
|
|
5239
|
+
readonly $ref: "#/$defs/StatusCategory";
|
|
5240
|
+
readonly description: "The normalised value filters compare against.";
|
|
4729
5241
|
};
|
|
4730
|
-
readonly
|
|
4731
|
-
readonly description: "
|
|
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 ["
|
|
5247
|
+
readonly required: readonly ["category", "name"];
|
|
4736
5248
|
readonly type: "object";
|
|
4737
5249
|
};
|
|
4738
|
-
readonly
|
|
4739
|
-
readonly description: "
|
|
5250
|
+
readonly StatusCategory: {
|
|
5251
|
+
readonly description: "The normalised status vocabulary shared across every source.";
|
|
4740
5252
|
readonly oneOf: readonly [{
|
|
4741
|
-
readonly
|
|
4742
|
-
readonly
|
|
4743
|
-
|
|
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
|
|
4752
|
-
readonly
|
|
4753
|
-
|
|
4754
|
-
|
|
4755
|
-
|
|
4756
|
-
|
|
4757
|
-
|
|
4758
|
-
|
|
4759
|
-
|
|
4760
|
-
|
|
4761
|
-
|
|
4762
|
-
|
|
4763
|
-
|
|
4764
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
};
|