@shivaedev/work-board 0.12.0 → 0.14.0

package/dist/server/views/remainingQueries.d.ts

@@ -0,0 +1,716 @@
+import { Effect } from "effect";
+import type { Diagnostics } from "#diagnostics/source.ts";
+import type { HandoffsService } from "#server/handoffs/Service.ts";
+import type { Responses } from "#server/responses/service.ts";
+import type { HandlerOptions } from "#server/rpc/HandlerOptions.ts";
+export declare function remainingQueries({ changes, document, index, writable }: HandlerOptions, services: {
+    readonly diagnostics: typeof Diagnostics.Service;
+    readonly responses: typeof Responses.Service;
+    readonly handoffs: typeof HandoffsService.Service;
+}): {
+    diagnostics: () => Effect.Effect<{
+        now: number;
+        sources: {
+            codex: import("#diagnostics/source.ts").Observation<{
+                readonly primary: {
+                    readonly resetsAt: number | null;
+                    readonly usedPercent: number;
+                    readonly windowDurationMins: number | null;
+                } | null;
+                readonly secondary: {
+                    readonly resetsAt: number | null;
+                    readonly usedPercent: number;
+                    readonly windowDurationMins: number | null;
+                } | null;
+            }>;
+            fleet: import("#diagnostics/source.ts").Observation<{
+                readonly concurrency: number;
+                readonly lastCapacityRejection: {
+                    readonly at: number;
+                    readonly cause: string;
+                } | null;
+                readonly lastSchedulerPass: number | null;
+                readonly observedAt: number;
+                readonly queued: number;
+                readonly running: number;
+                readonly staleAfterMs: number;
+                readonly version: 2;
+                readonly waiting: {
+                    readonly automation: number;
+                    readonly maintainer: number;
+                    readonly orchestrator: number;
+                };
+            }>;
+            github: import("#diagnostics/source.ts").Observation<{
+                readonly core: {
+                    readonly limit: number;
+                    readonly remaining: number;
+                    readonly reset: number;
+                };
+                readonly graphql: {
+                    readonly limit: number;
+                    readonly remaining: number;
+                    readonly reset: number;
+                };
+            }>;
+        };
+    }, never, never>;
+    handoff: (url: string) => Effect.Effect<{
+        background: string;
+        goal: string;
+        item: string;
+        nextAction: string;
+        reading: {
+            records: {
+                readonly context: string;
+                readonly file: string;
+                readonly handoff: {
+                    readonly by?: string | undefined;
+                    readonly constraints: string;
+                    readonly goal: string;
+                    readonly item: string;
+                    readonly nextAction: string;
+                    readonly note?: string | undefined;
+                    readonly preparedAt: number;
+                    readonly recipient: string;
+                    readonly reviewedRevision: string;
+                    readonly source: string;
+                    readonly state: "acknowledged" | "rejected" | "requested" | "unavailable";
+                };
+                readonly id: string;
+                readonly prompt: string;
+            }[];
+            unknown: string[];
+        };
+        source: {
+            readonly context: string;
+            readonly id: string;
+            readonly item: string;
+            readonly reviewedRevision: string;
+            readonly source: string;
+        } | undefined;
+        unavailable: string | undefined;
+        writable: boolean;
+    }, import("@shivaedev/platform/errors/taxonomy.ts").ServiceUnavailable, never>;
+    respond: (url: string) => Effect.Effect<{
+        document: {
+            readonly diagnostics: readonly {
+                readonly field?: string | undefined;
+                readonly line: number;
+                readonly message: string;
+            }[];
+            readonly file: string;
+            readonly identity?: string | undefined;
+            readonly links: {
+                readonly [x: string]: string;
+            };
+            readonly metadata: {
+                readonly areas?: readonly string[] | undefined;
+                readonly attention?: readonly {
+                    readonly id: string;
+                    readonly kind: "blocker" | "decision" | "review";
+                    readonly managed?: boolean | undefined;
+                    readonly reason: string;
+                    readonly responseFrom: readonly string[];
+                    readonly state: "closed" | "open";
+                    readonly unblocks: readonly string[];
+                }[] | undefined;
+                readonly criteria?: readonly {
+                    readonly id: string;
+                    readonly text: string;
+                }[] | undefined;
+                readonly evidence?: readonly {
+                    readonly checkedRevision?: string | undefined;
+                    readonly criterion?: string | undefined;
+                    readonly method?: string | undefined;
+                    readonly observedAt?: string | undefined;
+                    readonly outcome?: string | undefined;
+                    readonly source: string;
+                }[] | undefined;
+                readonly handoff?: {
+                    readonly by?: string | undefined;
+                    readonly constraints: string;
+                    readonly goal: string;
+                    readonly item: string;
+                    readonly nextAction: string;
+                    readonly note?: string | undefined;
+                    readonly preparedAt: number;
+                    readonly recipient: string;
+                    readonly reviewedRevision: string;
+                    readonly source: string;
+                    readonly state: "acknowledged" | "rejected" | "requested" | "unavailable";
+                } | undefined;
+                readonly id?: string | undefined;
+                readonly items?: readonly string[] | undefined;
+                readonly kind?: "board" | "decision" | "goal" | "handoff" | "investigation" | "project" | "question" | "report" | "response" | "result" | "task" | undefined;
+                readonly nextAction?: string | undefined;
+                readonly options?: readonly {
+                    readonly description: string;
+                    readonly label: string;
+                }[] | undefined;
+                readonly owner?: string | undefined;
+                readonly question?: {
+                    readonly deadline: number;
+                    readonly item: string;
+                    readonly reason: string;
+                    readonly registeredAt: number;
+                    readonly request: string;
+                    readonly reviewedRevision: string;
+                    readonly source: string;
+                } | undefined;
+                readonly recommended?: string | undefined;
+                readonly relationships?: readonly {
+                    readonly kind: "depends_on" | "implements" | "informs" | "relates_to";
+                    readonly target: string;
+                }[] | undefined;
+                readonly requestReceipt?: {
+                    readonly disposition: "applied" | "superseded";
+                    readonly question: string;
+                    readonly recordedAt: number;
+                    readonly response?: string | undefined;
+                    readonly reviewedRevision: string;
+                } | undefined;
+                readonly response?: {
+                    readonly answers?: readonly {
+                        readonly prompt: string;
+                        readonly selected: readonly string[];
+                        readonly text: string;
+                    }[] | undefined;
+                    readonly author: string;
+                    readonly question: string;
+                    readonly recordedAt: number;
+                    readonly reviewedRevision: string;
+                    readonly supersedes?: string | undefined;
+                    readonly type: "answer" | "clarify" | "not_now";
+                } | undefined;
+                readonly status?: string | undefined;
+            };
+            readonly modified: number;
+            readonly questionActions: {
+                readonly [x: string]: string;
+            };
+            readonly reading?: {
+                readonly backlinks: readonly {
+                    readonly href: string;
+                    readonly kind: string;
+                    readonly label: string;
+                    readonly status?: string | undefined;
+                    readonly title?: string | undefined;
+                }[];
+                readonly board: boolean;
+                readonly claims: {
+                    readonly [x: string]: readonly {
+                        readonly href?: string | undefined;
+                        readonly label: string;
+                    }[];
+                };
+                readonly evidenceSources: readonly {
+                    readonly href?: string | undefined;
+                    readonly problem: string;
+                }[];
+                readonly lines: {
+                    readonly [x: string]: number;
+                };
+                readonly proseLine: number;
+                readonly raw?: string | undefined;
+                readonly receipts: {
+                    readonly [x: string]: {
+                        readonly disposition: "applied" | "superseded";
+                        readonly question: string;
+                        readonly recordedAt: number;
+                        readonly response?: string | undefined;
+                        readonly reviewedRevision: string;
+                    };
+                };
+            } | undefined;
+            readonly referenceDetails?: {
+                readonly [x: string]: {
+                    readonly status?: string | undefined;
+                    readonly title: string;
+                };
+            } | undefined;
+            readonly references: {
+                readonly [x: string]: string;
+            };
+            readonly requests: readonly {
+                readonly id: string;
+                readonly open: boolean;
+                readonly options?: readonly {
+                    readonly description: string;
+                    readonly label: string;
+                }[] | undefined;
+                readonly preview?: {
+                    readonly context: string;
+                    readonly id: string;
+                    readonly item: string;
+                    readonly reason: string;
+                    readonly request: string;
+                    readonly reviewedRevision: string;
+                    readonly source: string;
+                } | undefined;
+                readonly prompts?: readonly {
+                    readonly id: string;
+                    readonly mode: "many" | "one" | "text";
+                    readonly options: readonly {
+                        readonly id: string;
+                        readonly source: string;
+                    }[];
+                    readonly source: string;
+                }[] | undefined;
+                readonly promptUnavailable?: string | undefined;
+                readonly recommended?: string | undefined;
+                readonly responses?: readonly {
+                    readonly body: string;
+                    readonly id: string;
+                    readonly response: {
+                        readonly answers?: readonly {
+                            readonly prompt: string;
+                            readonly selected: readonly string[];
+                            readonly text: string;
+                        }[] | undefined;
+                        readonly author: string;
+                        readonly question: string;
+                        readonly recordedAt: number;
+                        readonly reviewedRevision: string;
+                        readonly supersedes?: string | undefined;
+                        readonly type: "answer" | "clarify" | "not_now";
+                    };
+                }[] | undefined;
+                readonly sourceOpen?: boolean | undefined;
+                readonly title?: string | undefined;
+                readonly unavailable?: string | undefined;
+            }[];
+            readonly source: string;
+            readonly unavailable: readonly string[];
+            readonly writable: boolean;
+        };
+        request: {
+            id: string;
+            open: boolean;
+            options?: readonly {
+                readonly description: string;
+                readonly label: string;
+            }[] | undefined;
+            prompts?: readonly {
+                readonly id: string;
+                readonly mode: "many" | "one" | "text";
+                readonly options: readonly {
+                    readonly id: string;
+                    readonly source: string;
+                }[];
+                readonly source: string;
+            }[] | undefined;
+            promptUnavailable?: string | undefined;
+            recommended?: string | undefined;
+            sourceOpen?: boolean | undefined;
+            title?: string | undefined;
+            unavailable?: string | undefined;
+            preview: {
+                readonly context: string;
+                readonly id: string;
+                readonly item: string;
+                readonly reason: string;
+                readonly request: string;
+                readonly reviewedRevision: string;
+                readonly source: string;
+            };
+            responses: {
+                readonly body: string;
+                readonly id: string;
+                readonly response: {
+                    readonly answers?: readonly {
+                        readonly prompt: string;
+                        readonly selected: readonly string[];
+                        readonly text: string;
+                    }[] | undefined;
+                    readonly author: string;
+                    readonly question: string;
+                    readonly recordedAt: number;
+                    readonly reviewedRevision: string;
+                    readonly supersedes?: string | undefined;
+                    readonly type: "answer" | "clarify" | "not_now";
+                };
+            }[];
+        };
+    }, unknown, never>;
+    result: (url: string) => Effect.Effect<{
+        readonly document: {
+            readonly diagnostics: readonly {
+                readonly field?: string | undefined;
+                readonly line: number;
+                readonly message: string;
+            }[];
+            readonly file: string;
+            readonly identity?: string | undefined;
+            readonly links: {
+                readonly [x: string]: string;
+            };
+            readonly metadata: {
+                readonly areas?: readonly string[] | undefined;
+                readonly attention?: readonly {
+                    readonly id: string;
+                    readonly kind: "blocker" | "decision" | "review";
+                    readonly managed?: boolean | undefined;
+                    readonly reason: string;
+                    readonly responseFrom: readonly string[];
+                    readonly state: "closed" | "open";
+                    readonly unblocks: readonly string[];
+                }[] | undefined;
+                readonly criteria?: readonly {
+                    readonly id: string;
+                    readonly text: string;
+                }[] | undefined;
+                readonly evidence?: readonly {
+                    readonly checkedRevision?: string | undefined;
+                    readonly criterion?: string | undefined;
+                    readonly method?: string | undefined;
+                    readonly observedAt?: string | undefined;
+                    readonly outcome?: string | undefined;
+                    readonly source: string;
+                }[] | undefined;
+                readonly handoff?: {
+                    readonly by?: string | undefined;
+                    readonly constraints: string;
+                    readonly goal: string;
+                    readonly item: string;
+                    readonly nextAction: string;
+                    readonly note?: string | undefined;
+                    readonly preparedAt: number;
+                    readonly recipient: string;
+                    readonly reviewedRevision: string;
+                    readonly source: string;
+                    readonly state: "acknowledged" | "rejected" | "requested" | "unavailable";
+                } | undefined;
+                readonly id?: string | undefined;
+                readonly items?: readonly string[] | undefined;
+                readonly kind?: "board" | "decision" | "goal" | "handoff" | "investigation" | "project" | "question" | "report" | "response" | "result" | "task" | undefined;
+                readonly nextAction?: string | undefined;
+                readonly options?: readonly {
+                    readonly description: string;
+                    readonly label: string;
+                }[] | undefined;
+                readonly owner?: string | undefined;
+                readonly question?: {
+                    readonly deadline: number;
+                    readonly item: string;
+                    readonly reason: string;
+                    readonly registeredAt: number;
+                    readonly request: string;
+                    readonly reviewedRevision: string;
+                    readonly source: string;
+                } | undefined;
+                readonly recommended?: string | undefined;
+                readonly relationships?: readonly {
+                    readonly kind: "depends_on" | "implements" | "informs" | "relates_to";
+                    readonly target: string;
+                }[] | undefined;
+                readonly requestReceipt?: {
+                    readonly disposition: "applied" | "superseded";
+                    readonly question: string;
+                    readonly recordedAt: number;
+                    readonly response?: string | undefined;
+                    readonly reviewedRevision: string;
+                } | undefined;
+                readonly response?: {
+                    readonly answers?: readonly {
+                        readonly prompt: string;
+                        readonly selected: readonly string[];
+                        readonly text: string;
+                    }[] | undefined;
+                    readonly author: string;
+                    readonly question: string;
+                    readonly recordedAt: number;
+                    readonly reviewedRevision: string;
+                    readonly supersedes?: string | undefined;
+                    readonly type: "answer" | "clarify" | "not_now";
+                } | undefined;
+                readonly status?: string | undefined;
+            };
+            readonly modified: number;
+            readonly questionActions: {
+                readonly [x: string]: string;
+            };
+            readonly reading?: {
+                readonly backlinks: readonly {
+                    readonly href: string;
+                    readonly kind: string;
+                    readonly label: string;
+                    readonly status?: string | undefined;
+                    readonly title?: string | undefined;
+                }[];
+                readonly board: boolean;
+                readonly claims: {
+                    readonly [x: string]: readonly {
+                        readonly href?: string | undefined;
+                        readonly label: string;
+                    }[];
+                };
+                readonly evidenceSources: readonly {
+                    readonly href?: string | undefined;
+                    readonly problem: string;
+                }[];
+                readonly lines: {
+                    readonly [x: string]: number;
+                };
+                readonly proseLine: number;
+                readonly raw?: string | undefined;
+                readonly receipts: {
+                    readonly [x: string]: {
+                        readonly disposition: "applied" | "superseded";
+                        readonly question: string;
+                        readonly recordedAt: number;
+                        readonly response?: string | undefined;
+                        readonly reviewedRevision: string;
+                    };
+                };
+            } | undefined;
+            readonly referenceDetails?: {
+                readonly [x: string]: {
+                    readonly status?: string | undefined;
+                    readonly title: string;
+                };
+            } | undefined;
+            readonly references: {
+                readonly [x: string]: string;
+            };
+            readonly requests: readonly {
+                readonly id: string;
+                readonly open: boolean;
+                readonly options?: readonly {
+                    readonly description: string;
+                    readonly label: string;
+                }[] | undefined;
+                readonly preview?: {
+                    readonly context: string;
+                    readonly id: string;
+                    readonly item: string;
+                    readonly reason: string;
+                    readonly request: string;
+                    readonly reviewedRevision: string;
+                    readonly source: string;
+                } | undefined;
+                readonly prompts?: readonly {
+                    readonly id: string;
+                    readonly mode: "many" | "one" | "text";
+                    readonly options: readonly {
+                        readonly id: string;
+                        readonly source: string;
+                    }[];
+                    readonly source: string;
+                }[] | undefined;
+                readonly promptUnavailable?: string | undefined;
+                readonly recommended?: string | undefined;
+                readonly responses?: readonly {
+                    readonly body: string;
+                    readonly id: string;
+                    readonly response: {
+                        readonly answers?: readonly {
+                            readonly prompt: string;
+                            readonly selected: readonly string[];
+                            readonly text: string;
+                        }[] | undefined;
+                        readonly author: string;
+                        readonly question: string;
+                        readonly recordedAt: number;
+                        readonly reviewedRevision: string;
+                        readonly supersedes?: string | undefined;
+                        readonly type: "answer" | "clarify" | "not_now";
+                    };
+                }[] | undefined;
+                readonly sourceOpen?: boolean | undefined;
+                readonly title?: string | undefined;
+                readonly unavailable?: string | undefined;
+            }[];
+            readonly source: string;
+            readonly unavailable: readonly string[];
+            readonly writable: boolean;
+        };
+        readonly feedback: readonly {
+            readonly matching: boolean;
+            readonly question: {
+                readonly context: string;
+                readonly id: string;
+                readonly question: {
+                    readonly deadline: number;
+                    readonly item: string;
+                    readonly reason: string;
+                    readonly registeredAt: number;
+                    readonly request: string;
+                    readonly reviewedRevision: string;
+                    readonly source: string;
+                };
+            };
+            readonly questionFile: string;
+            readonly response: {
+                readonly body: string;
+                readonly id: string;
+                readonly response: {
+                    readonly answers?: readonly {
+                        readonly prompt: string;
+                        readonly selected: readonly string[];
+                        readonly text: string;
+                    }[] | undefined;
+                    readonly author: string;
+                    readonly question: string;
+                    readonly recordedAt: number;
+                    readonly reviewedRevision: string;
+                    readonly supersedes?: string | undefined;
+                    readonly type: "answer" | "clarify" | "not_now";
+                };
+            };
+            readonly responseFile: string;
+            readonly supersedesFile?: string | undefined;
+        }[];
+        readonly feedbackUnknown: boolean;
+        readonly revision: string;
+        readonly targets: readonly {
+            readonly available: boolean;
+            readonly criteria: readonly {
+                readonly claims: readonly {
+                    readonly checkedRevision?: string | undefined;
+                    readonly method?: string | undefined;
+                    readonly observedAt?: string | undefined;
+                    readonly outcome?: string | undefined;
+                    readonly problem: string;
+                    readonly source: {
+                        readonly href?: string | undefined;
+                        readonly label: string;
+                    };
+                }[];
+                readonly link: {
+                    readonly href?: string | undefined;
+                    readonly label: string;
+                };
+                readonly text: string;
+            }[];
+            readonly link: {
+                readonly href?: string | undefined;
+                readonly label: string;
+            };
+            readonly status?: string | undefined;
+        }[];
+    }, unknown, never>;
+    start: () => Effect.Effect<{
+        empty: boolean;
+        templates: readonly [{
+            readonly file: "project.md";
+            readonly label: "Project";
+            readonly source: `---
+id: example.project
+kind: project
+criteria:
+  - id: readable-result
+    text: A reviewer can trace the result to its reasoning and recorded evidence.
+---
+# Project
+
+## Goal
+Describe the outcome and who needs it.
+
+## Scope and constraints
+Name what belongs here and what must remain outside this work.
+
+## Reading path
+- [Investigation](investigation.md)
+- [Agent result](result.md)
+
+## Acceptance
+The criterion above is a target, not a recorded pass.
+Record what was checked, the source revision, and remaining limitations.
+`;
+        }, {
+            readonly file: "investigation.md";
+            readonly label: "Investigation";
+            readonly source: `---
+id: example.investigation
+kind: investigation
+relationships:
+  - kind: informs
+    target: example.project
+criteria:
+  - id: explained-choice
+    text: Options, evidence, tradeoffs and the recommendation are explicit.
+---
+# Investigation
+
+## Question and background
+Explain the decision in context; do not require the reader to reconstruct it.
+
+## Options and tradeoffs
+| Option | Benefit | Cost | Evidence |
+| --- | --- | --- | --- |
+| First option | | | |
+| Second option | | | |
+
+## Recommendation
+State your take and what remains uncertain.
+
+## Response needed
+Name the exact question and the choices. Do not imply that a response was recorded.
+
+[Project and acceptance target](project.md)
+`;
+        }, {
+            readonly file: "result.md";
+            readonly label: "Agent result";
+            readonly source: `---
+id: example.result
+kind: result
+# A supplied result status is not work acceptance or an execution receipt.
+attention:
+  - id: review
+    kind: review
+    state: open
+    response_from: [maintainer]
+    reason: Review this exact report, its evidence and limitations.
+    unblocks: [example.project#readable-result]
+relationships:
+  - kind: implements
+    target: example.investigation
+  - kind: relates_to
+    target: example.project
+# Add evidence only after a real observation; replace every placeholder:
+# evidence:
+#   - criterion: example.project#readable-result
+#     source: ./evidence/reading-check.md
+#     method: Describe the actual check.
+#     outcome: Describe the observed result and its limits.
+#     observed_at: Use the actual ISO timestamp with timezone.
+#     checked_revision: Use the actual full source commit SHA.
+---
+# Agent result
+
+## Outcome and changes
+Explain what changed and why. Link the relevant source files or patch.
+
+## Reasoning
+[Investigation and alternatives](investigation.md)
+
+## Checks and evidence
+Add actual commands, observations and local evidence links.
+Recorded evidence does not by itself establish verified acceptance.
+
+## Limits and unresolved questions
+Name failures, skipped checks, uncertainty and any response needed.
+
+## Next action
+State the next action and who needs to respond, if known.
+
+[Project and acceptance target](project.md)
+
+::::question{id="verdict" select="one"}
+### What should happen with this report?
+
+:::option{id="revision"}
+Request another revision and explain what is missing.
+:::
+
+:::option{id="accept"}
+Accept this exact report version with its stated limitations.
+:::
+::::
+`;
+        }];
+    }, import("effect/PlatformError").PlatformError, never>;
+};
+//# sourceMappingURL=remainingQueries.d.ts.map