@jamesaphoenix/tx-types 0.11.1 → 0.12.0
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/README.md +105 -360
- package/dist/doc.d.ts +785 -10
- package/dist/doc.d.ts.map +1 -1
- package/dist/doc.js +332 -5
- package/dist/doc.js.map +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -2
- package/dist/index.js.map +1 -1
- package/dist/response.d.ts +108 -12
- package/dist/response.d.ts.map +1 -1
- package/dist/response.js +13 -1
- package/dist/response.js.map +1 -1
- package/dist/task.d.ts +24 -7
- package/dist/task.d.ts.map +1 -1
- package/dist/task.js +26 -4
- package/dist/task.js.map +1 -1
- package/package.json +1 -1
package/dist/task.js
CHANGED
|
@@ -10,7 +10,7 @@ import { Schema } from "effect";
|
|
|
10
10
|
// =============================================================================
|
|
11
11
|
/**
|
|
12
12
|
* All valid task statuses in lifecycle order.
|
|
13
|
-
* backlog → ready → planning → active → blocked → review →
|
|
13
|
+
* backlog → ready → planning → active → blocked → review → needs_review → done
|
|
14
14
|
*/
|
|
15
15
|
export const TASK_STATUSES = [
|
|
16
16
|
"backlog",
|
|
@@ -19,7 +19,7 @@ export const TASK_STATUSES = [
|
|
|
19
19
|
"active",
|
|
20
20
|
"blocked",
|
|
21
21
|
"review",
|
|
22
|
-
"
|
|
22
|
+
"needs_review",
|
|
23
23
|
"done",
|
|
24
24
|
];
|
|
25
25
|
/**
|
|
@@ -27,6 +27,18 @@ export const TASK_STATUSES = [
|
|
|
27
27
|
* Assignment is routing metadata, not lease ownership.
|
|
28
28
|
*/
|
|
29
29
|
export const TASK_ASSIGNEE_TYPES = ["human", "agent"];
|
|
30
|
+
/**
|
|
31
|
+
* Orchestration status values derived from task_claims.
|
|
32
|
+
* This is a computed second layer alongside the workflow status.
|
|
33
|
+
* Not stored in the database — derived at enrichment time from claim state.
|
|
34
|
+
*/
|
|
35
|
+
export const ORCHESTRATION_STATUSES = [
|
|
36
|
+
"unclaimed", // No active claim
|
|
37
|
+
"claimed", // Claim exists, worker reserved
|
|
38
|
+
"running", // Claim active + task status is "active"
|
|
39
|
+
"lease_expired", // Claim was active but lease has expired
|
|
40
|
+
"released", // Claim explicitly released
|
|
41
|
+
];
|
|
30
42
|
/**
|
|
31
43
|
* Regex pattern for valid task IDs.
|
|
32
44
|
*/
|
|
@@ -41,8 +53,8 @@ export const VALID_TRANSITIONS = {
|
|
|
41
53
|
planning: ["ready", "active", "blocked", "done"],
|
|
42
54
|
active: ["blocked", "review", "done"],
|
|
43
55
|
blocked: ["backlog", "ready", "planning", "active"],
|
|
44
|
-
review: ["active", "
|
|
45
|
-
|
|
56
|
+
review: ["active", "needs_review", "done"],
|
|
57
|
+
needs_review: ["active", "review", "done"],
|
|
46
58
|
done: ["backlog"],
|
|
47
59
|
};
|
|
48
60
|
// =============================================================================
|
|
@@ -52,6 +64,8 @@ export const VALID_TRANSITIONS = {
|
|
|
52
64
|
export const TaskStatusSchema = Schema.Literal(...TASK_STATUSES);
|
|
53
65
|
/** Task assignment intent type. */
|
|
54
66
|
export const TaskAssigneeTypeSchema = Schema.Literal(...TASK_ASSIGNEE_TYPES);
|
|
67
|
+
/** Orchestration status — derived from claim state, not stored directly. */
|
|
68
|
+
export const OrchestrationStatusSchema = Schema.Literal(...ORCHESTRATION_STATUSES);
|
|
55
69
|
/** Task ID - branded string matching tx-[a-z0-9]{6,12}. */
|
|
56
70
|
export const TaskIdSchema = Schema.String.pipe(Schema.pattern(TASK_ID_PATTERN), Schema.brand("TaskId"));
|
|
57
71
|
/**
|
|
@@ -95,6 +109,14 @@ export const TaskWithDepsSchema = Schema.Struct({
|
|
|
95
109
|
effectiveGroupContext: Schema.NullOr(Schema.String),
|
|
96
110
|
/** Source task ID that provided effectiveGroupContext */
|
|
97
111
|
effectiveGroupContextSourceTaskId: Schema.NullOr(TaskIdSchema),
|
|
112
|
+
/** Orchestration status derived from claims (null when claims not in use) */
|
|
113
|
+
orchestrationStatus: Schema.NullOr(OrchestrationStatusSchema),
|
|
114
|
+
/** Worker ID holding the active claim (null when no claim) */
|
|
115
|
+
claimedBy: Schema.NullOr(Schema.String),
|
|
116
|
+
/** Lease expiry time for the active claim (null when no claim) */
|
|
117
|
+
claimExpiresAt: Schema.NullOr(Schema.DateFromSelf),
|
|
118
|
+
/** Number of failed attempts for this task */
|
|
119
|
+
failedAttempts: Schema.Number.pipe(Schema.int()),
|
|
98
120
|
});
|
|
99
121
|
/** Recursive tree structure for task hierarchy. */
|
|
100
122
|
export const TaskTreeSchema = Schema.Struct({
|
package/dist/task.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"task.js","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,SAAS;IACT,OAAO;IACP,UAAU;IACV,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,
|
|
1
|
+
{"version":3,"file":"task.js","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":"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"}
|