@hasna/todos 0.15.3 → 0.15.5

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.
@@ -0,0 +1,51 @@
1
+ /**
2
+ * `todos delegate <task> <worker> --brief <path>` — one atomic verb for
3
+ * handing a filed task to a worker.
4
+ *
5
+ * THE MEASURED CAUSE, because it decides the shape of everything below. At 24.8
6
+ * actionable signals an hour — one every 2.4 minutes — the ATOMIC act survives
7
+ * and the PIPELINE dies. Filing a task is one step and ran 13 times out of 14.
8
+ * Dispatching one was six steps across three CLIs and ran 0 times out of 14. On
9
+ * the same day, the single instructions config that landed unaided was the
10
+ * one-step timezone note, while all six directive pipelines died. A prompt
11
+ * cannot close that gap, because a prompt cannot make an announcement true;
12
+ * only a verb that writes the record AS PART OF the act can.
13
+ *
14
+ * So the seven effects below are ONE invocation, and the verb is worth building
15
+ * only while it stays one. Any change that adds a required second call — a
16
+ * follow-up `start`, a manual post, a separate registration — reproduces the
17
+ * failure this was built to remove, and will fail the same way, silently, while
18
+ * looking implemented.
19
+ *
20
+ * THE SEVEN EFFECTS, in order:
21
+ * 1. REFUSE an absent or empty brief. Runs first, before any write, so a bad
22
+ * invocation costs nothing. See `lib/delegation-brief.ts`.
23
+ * 2. READ AND PRINT the receiving seat's open count; park only when a
24
+ * threshold is armed. See `lib/delegation-policy.ts` for why the default
25
+ * is unset.
26
+ * 3. REGISTER the worker identity, lineage-linked to the dispatcher.
27
+ * 4. ASSIGN the row and populate assigned_by / delegated_from /
28
+ * delegation_depth.
29
+ * 5. APPEND the [DISPATCH] comment — this is what makes the act and the
30
+ * record one event rather than two things someone has to remember.
31
+ * 6. POST the one-line channel notice, once.
32
+ * 7. RECORD a claim deadline for the steering pass.
33
+ *
34
+ * WHAT IT DELIBERATELY DOES NOT DO, and this is load-bearing rather than an
35
+ * omission: it never writes `started_at`. The worker still claims with `todos
36
+ * start`. That keeps `started_at` honest AND keeps this verb's own failure mode
37
+ * countable — a dispatched row nobody claimed stays visibly unclaimed, so
38
+ * "dispatch laundering" (a [DISPATCH] comment older than the claim window on a
39
+ * row with a null started_at) is a query rather than a guess. A verb that
40
+ * stamped started_at would launder its own failures into apparent progress.
41
+ *
42
+ * WHY IT IS NOT `dispatch`. That verb is taken, and it is the route operating
43
+ * rule 12 forbids: it types a prompt into a tmux pane and presses Enter. It is
44
+ * left entirely alone here, along with its `dispatch run` subcommand, its
45
+ * sibling `dispatches`, and their two SQLite tables. `delegate` also fits the
46
+ * data model rather than fighting it — `delegated_from` and `delegation_depth`
47
+ * were already columns, so the noun existed and only the verb was missing.
48
+ */
49
+ import type { Command } from "commander";
50
+ export declare function registerDelegateCommands(program: Command): void;
51
+ //# sourceMappingURL=delegate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/delegate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmDzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwU/D"}
@@ -1 +1 @@
1
- {"version":3,"file":"project-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/project-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2QzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QA+kCvD"}
1
+ {"version":3,"file":"project-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/project-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4QzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QAwlCvD"}