taskchef 8.7.1 → 9.0.1

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.
Files changed (150) hide show
  1. package/.codex-plugin/plugin.json +7 -10
  2. package/.mcp.json +3 -2
  3. package/README.md +35 -158
  4. package/docs/mcp-app.md +23 -6
  5. package/docs/spec.md +38 -746
  6. package/docs/taskchef-next-storage.md +2 -2
  7. package/index.js +2 -99
  8. package/package.json +12 -49
  9. package/skills/delegate/SKILL.md +44 -0
  10. package/skills/delegate/agents/openai.yaml +4 -0
  11. package/src/codex-app.js +3 -152
  12. package/src/codex-session-scanner.js +2 -2
  13. package/src/file-lock.js +25 -0
  14. package/src/mcp-app/react/NextTaskDetail.test.tsx +1 -1
  15. package/src/mcp-app/react/NextTaskDetail.tsx +8 -8
  16. package/src/mcp-app/react/main.test.tsx +3 -3
  17. package/src/mcp-app/react/main.tsx +7 -7
  18. package/src/mcp-app.js +2 -2
  19. package/src/mcp.js +4 -542
  20. package/src/next-cache.js +2 -2
  21. package/src/next-github.js +3 -3
  22. package/src/next-notifications.js +2 -2
  23. package/src/{dashboard/react → ui}/components/CardStatusIcons.tsx +1 -1
  24. package/src/{dashboard/react → ui}/components/GitHubLinks.tsx +1 -1
  25. package/src/{dashboard/react → ui}/components/LinkedText.tsx +1 -1
  26. package/src/{dashboard/react → ui}/components/RelativeTime.test.tsx +1 -1
  27. package/src/{dashboard/react → ui}/components/RelativeTime.tsx +1 -1
  28. package/src/{dashboard/react → ui}/components/ReplyImagePreview.test.tsx +1 -1
  29. package/src/{dashboard/react → ui}/components/TaskBoard.tsx +1 -1
  30. package/src/{dashboard/react → ui}/components/TaskCard.tsx +1 -1
  31. package/src/{dashboard/react → ui}/components/TurnContent.tsx +1 -1
  32. package/src/{dashboard/react → ui}/presentation.ts +1 -1
  33. package/src/user-prompt.js +11 -0
  34. package/src/version.js +0 -1
  35. package/BACKLOG.md +0 -48
  36. package/assets/e2e-benchmark-example.json +0 -50
  37. package/assets/taskchef-dispatcher-instructions.md +0 -44
  38. package/bin/taskchef.js +0 -20
  39. package/docs/advanced-guide.md +0 -497
  40. package/docs/dashboard-lifecycle.md +0 -149
  41. package/docs/dashboard-ui.md +0 -40
  42. package/docs/firstmate-taskchef-comparison.md +0 -283
  43. package/docs/images/ccusage-token-consumption.png +0 -0
  44. package/docs/images/dashboard-identity.jpg +0 -0
  45. package/docs/images/dashboard-token-pending.jpg +0 -0
  46. package/docs/images/interrupted-turn-recovery.jpg +0 -0
  47. package/docs/images/notification-event-snapshots.jpg +0 -0
  48. package/docs/images/readme-board.png +0 -0
  49. package/docs/images/readme-completed.png +0 -0
  50. package/docs/images/readme-list.png +0 -0
  51. package/docs/images/readme-needs-input.png +0 -0
  52. package/docs/images/readme-roles.png +0 -0
  53. package/docs/images/reported-work-duration-desktop.jpg +0 -0
  54. package/docs/images/reported-work-duration-mobile.jpg +0 -0
  55. package/docs/images/result-history-dashboard.jpg +0 -0
  56. package/docs/images/taskchef-pr-icon-comparison.jpg +0 -0
  57. package/docs/images/taskchef-unified-status-popup.jpg +0 -0
  58. package/docs/workflows.md +0 -476
  59. package/mcp/dashboard-session.js +0 -51
  60. package/scripts/benchmark-dispatch-prepare.js +0 -90
  61. package/scripts/e2e-benchmark.js +0 -206
  62. package/scripts/roles/resolve_roles.py +0 -293
  63. package/skills/taskchef-bootstrap/SKILL.md +0 -96
  64. package/skills/taskchef-bootstrap/agents/openai.yaml +0 -4
  65. package/skills/taskchef-bootstrap/references/project-index.md +0 -154
  66. package/skills/taskchef-copilot/SKILL.md +0 -75
  67. package/skills/taskchef-copilot/agents/openai.yaml +0 -4
  68. package/skills/taskchef-dashboard/SKILL.md +0 -24
  69. package/skills/taskchef-dashboard/agents/openai.yaml +0 -4
  70. package/skills/taskchef-delegate/SKILL.md +0 -102
  71. package/skills/taskchef-delegate/agents/openai.yaml +0 -4
  72. package/skills/taskchef-delegate/references/model-roles.md +0 -29
  73. package/skills/taskchef-executor/SKILL.md +0 -154
  74. package/skills/taskchef-executor/agents/openai.yaml +0 -4
  75. package/skills/taskchef-executor/references/compatibility.md +0 -22
  76. package/skills/taskchef-executor/references/ending-actions.md +0 -26
  77. package/src/backups.js +0 -359
  78. package/src/cli.js +0 -733
  79. package/src/config-audit.js +0 -99
  80. package/src/config-mutations.js +0 -106
  81. package/src/dashboard/actions.js +0 -136
  82. package/src/dashboard/app.js +0 -1172
  83. package/src/dashboard/dist/app.js +0 -269
  84. package/src/dashboard/dist/app.js.map +0 -1
  85. package/src/dashboard/dist/index.html +0 -16
  86. package/src/dashboard/dist/styles.css +0 -1
  87. package/src/dashboard/index.html +0 -148
  88. package/src/dashboard/react/App.test.tsx +0 -346
  89. package/src/dashboard/react/App.tsx +0 -515
  90. package/src/dashboard/react/api.test.ts +0 -40
  91. package/src/dashboard/react/api.ts +0 -103
  92. package/src/dashboard/react/components/ActivityTimeline.tsx +0 -118
  93. package/src/dashboard/react/components/ModelSettings.test.tsx +0 -180
  94. package/src/dashboard/react/components/ModelSettings.tsx +0 -106
  95. package/src/dashboard/react/components/NotificationCenter.test.tsx +0 -76
  96. package/src/dashboard/react/components/NotificationCenter.tsx +0 -111
  97. package/src/dashboard/react/components/PullRequestBadges.tsx +0 -18
  98. package/src/dashboard/react/components/TaskDetail.test.tsx +0 -255
  99. package/src/dashboard/react/components/TaskDetail.tsx +0 -271
  100. package/src/dashboard/react/components/UsagePanel.tsx +0 -96
  101. package/src/dashboard/react/index.html +0 -15
  102. package/src/dashboard/react/main.tsx +0 -12
  103. package/src/dashboard/react/overlay-state.test.ts +0 -110
  104. package/src/dashboard/react/overlay-state.ts +0 -60
  105. package/src/dashboard/react/presentation.test.tsx +0 -571
  106. package/src/dashboard/styles.css +0 -261
  107. package/src/dashboard-control.js +0 -34
  108. package/src/dashboard-manager.js +0 -339
  109. package/src/dashboard-session-process.js +0 -88
  110. package/src/dashboard-session.js +0 -86
  111. package/src/dashboard.js +0 -1303
  112. package/src/delegation.js +0 -277
  113. package/src/github.js +0 -107
  114. package/src/model-roles.js +0 -70
  115. package/src/recorded-usage-tracker.js +0 -92
  116. package/src/usage-tracker.js +0 -650
  117. package/src/usage.js +0 -367
  118. package/src/workspace-path.js +0 -48
  119. package/src/workspace.js +0 -3629
  120. /package/src/{dashboard/react → ui}/components/AnimatedUsage.test.tsx +0 -0
  121. /package/src/{dashboard/react → ui}/components/CardStatusIcons.test.tsx +0 -0
  122. /package/src/{dashboard/react → ui}/components/ImageGallery.tsx +0 -0
  123. /package/src/{dashboard/react → ui}/components/OpenChatButton.test.tsx +0 -0
  124. /package/src/{dashboard/react → ui}/components/OpenChatButton.tsx +0 -0
  125. /package/src/{dashboard/react → ui}/components/PrGlyph.tsx +0 -0
  126. /package/src/{dashboard/react → ui}/components/QueuedPrompts.test.tsx +0 -0
  127. /package/src/{dashboard/react → ui}/components/QueuedPrompts.tsx +0 -0
  128. /package/src/{dashboard/react → ui}/components/ReplyCover.test.tsx +0 -0
  129. /package/src/{dashboard/react → ui}/components/ReplyCover.tsx +0 -0
  130. /package/src/{dashboard/react → ui}/components/ReplyImagePreview.tsx +0 -0
  131. /package/src/{dashboard/react → ui}/components/ReplyMarkdown.test.tsx +0 -0
  132. /package/src/{dashboard/react → ui}/components/ReplyMarkdown.tsx +0 -0
  133. /package/src/{dashboard/react → ui}/components/SavedUsageFormat.test.tsx +0 -0
  134. /package/src/{dashboard/react → ui}/components/SavedUsageFormat.tsx +0 -0
  135. /package/src/{dashboard/react → ui}/components/ShimmerText.tsx +0 -0
  136. /package/src/{dashboard/react → ui}/components/StatsGrid.tsx +0 -0
  137. /package/src/{dashboard/react → ui}/components/StatusBadge.tsx +0 -0
  138. /package/src/{dashboard/react → ui}/components/TaskBoard.test.tsx +0 -0
  139. /package/src/{dashboard/react → ui}/components/TaskCardStats.test.tsx +0 -0
  140. /package/src/{dashboard/react → ui}/components/TaskCardStats.tsx +0 -0
  141. /package/src/{dashboard/react → ui}/components/TurnContent.test.tsx +0 -0
  142. /package/src/{dashboard/react → ui}/fixtures.ts +0 -0
  143. /package/src/{dashboard → ui}/github-links.js +0 -0
  144. /package/src/{dashboard/react → ui}/image-cache.test.ts +0 -0
  145. /package/src/{dashboard/react → ui}/image-cache.ts +0 -0
  146. /package/src/{dashboard → ui}/state.js +0 -0
  147. /package/src/{dashboard/react → ui}/styles.css +0 -0
  148. /package/src/{dashboard/react → ui}/test-setup.ts +0 -0
  149. /package/src/{dashboard → ui}/time.js +0 -0
  150. /package/src/{dashboard/react → ui}/types.ts +0 -0
@@ -1,6 +1,6 @@
1
1
  import { Box, Paper, Stack, Text, Title } from "@mantine/core";
2
2
  import { IconArrowUpRight } from "@tabler/icons-react";
3
- import { latestTurnPresentation } from "../../state.js";
3
+ import { latestTurnPresentation } from "../state.js";
4
4
  import type { Task } from "../types";
5
5
  import { GitHubLinks } from "./GitHubLinks";
6
6
  import { LinkedText } from "./LinkedText";
@@ -3,7 +3,7 @@ import { useCallback, useLayoutEffect, useRef, useState } from "react";
3
3
  import type { Task } from "../types";
4
4
  import { ImageGallery } from "./ImageGallery";
5
5
  import { ReplyImagePreview } from "./ReplyImagePreview";
6
- import { formatWorkedDuration } from "../../time.js";
6
+ import { formatWorkedDuration } from "../time.js";
7
7
  import { ReplyMarkdown } from "./ReplyMarkdown";
8
8
 
9
9
  const hidePromptImage = () => null;
@@ -3,7 +3,7 @@ import {
3
3
  durationBetween,
4
4
  reportedWorkSummary,
5
5
  terminalTurnDuration,
6
- } from "../../reported-work.js";
6
+ } from "../reported-work.js";
7
7
 
8
8
  export { durationBetween };
9
9
 
@@ -3,6 +3,17 @@ import { normalizeUri } from "micromark-util-sanitize-uri";
3
3
  // Convert Codex's supplied prompt context to readable Markdown. Unknown or
4
4
  // malformed context stays visible; this does not change the recorded input.
5
5
  export function displayUserPrompt(text) {
6
+ const questionReply = /^\s*<send_user_message_question_reply>([\s\S]*)<\/send_user_message_question_reply>\s*$/.exec(text);
7
+ if (questionReply) {
8
+ try {
9
+ const value = JSON.parse(questionReply[1]);
10
+ const replies = Array.isArray(value) ? value : [value];
11
+ if (replies.length && replies.every(reply => reply && typeof reply.question === "string" && typeof reply.answer === "string")) {
12
+ return replies.map(reply => `${reply.question.split('\n').map(line => `> ${line}`).join('\n')}\n\n${reply.answer}`).join('\n\n');
13
+ }
14
+ } catch { /* Preserve unrecognized input rather than losing the user's prompt. */ }
15
+ return text;
16
+ }
6
17
  const requestHeading = /^##? My request:[ \t]*(?:\r?\n|$)/m.exec(text);
7
18
  if (!requestHeading || !/^(?:[ \t]*\r?\n)*(?:# Response annotations:|# Files mentioned by the user:|<in-app-browser-context source="ambient-ui-state">)\r?\n/.test(text)) return text;
8
19
  const context = text.slice(0, requestHeading.index);
package/src/version.js CHANGED
@@ -6,4 +6,3 @@ const packageMetadata = require("../package.json");
6
6
  export const TASKCHEF_APP_NAME = require("../.codex-plugin/plugin.json").interface.displayName;
7
7
 
8
8
  export const TASKCHEF_VERSION = packageMetadata.version;
9
- export const DASHBOARD_SERVER_VERSION = "4";
package/BACKLOG.md DELETED
@@ -1,48 +0,0 @@
1
- # TaskChef backlog
2
-
3
- [`docs/spec.md`](docs/spec.md) is the current contract. These ideas need a concrete user case and a
4
- clear data model before implementation.
5
-
6
- ## Task history views
7
-
8
- - Add date ranges and title search if the task log becomes difficult to
9
- browse.
10
- - Consider export formats for personal activity reports.
11
- - Define archival or retention only when real logs become large enough to need
12
- it.
13
- - Consider grouping entries created from one broad request without storing the
14
- full original prompt.
15
-
16
- ## Optional reports
17
-
18
- - Consider user-scheduled, read-only digests that query recorded Codex tasks
19
- and publish a report without writing status or results to the TaskChef
20
- workspace.
21
- - Define batching and partial-read behavior for large task histories.
22
- - Decide whether inaccessible or deleted Codex tasks need a separate report
23
- category.
24
-
25
- ## Remote projects
26
-
27
- - Import remote connection projects returned by native project discovery.
28
- - Persist the native project and host identity needed to distinguish identical
29
- paths on different hosts.
30
- - Re-resolve remote identities before dispatch.
31
- - Define unavailable-host, renamed-project, moved-path, and stale-identity
32
- behavior.
33
- - Evaluate isolated worktrees and conflict handling for concurrent tasks in one
34
- project.
35
-
36
- ## Integrations
37
-
38
- - Add GitHub automation only when task history alone is insufficient.
39
- - Evaluate automatic project discovery rules and exclusions.
40
- - Consider multiple executor threads for one logical assignment if a real
41
- workflow requires it.
42
-
43
- ## Transport-authenticated executor identity
44
-
45
- - If custom MCP later receives authenticated calling-task metadata, compare it
46
- with the executor's `link_task` assertion.
47
- - Keep the current local cooperative trust model until such metadata exists;
48
- do not reintroduce parent/session identity, hooks, task search, or polling.
@@ -1,50 +0,0 @@
1
- {
2
- "schemaVersion": 2,
3
- "benchmark": "taskchef-executor-self-link-e2e",
4
- "taskchefVersion": "0.0.0",
5
- "runId": "replace-with-run-id",
6
- "startedAt": "2026-08-24T10:00:00.000Z",
7
- "completedAt": "2026-08-24T10:01:00.000Z",
8
- "workload": {
9
- "project": "example-project",
10
- "title": "Provisional self-link example",
11
- "prompt": "Pause for approval, then complete the requested work."
12
- },
13
- "task": {
14
- "taskId": "00000000-0000-4000-8000-000000000000",
15
- "threadId": "00000000-0000-7000-8000-000000000000",
16
- "clientThreadId": "local:replace-with-provisional-id",
17
- "recorded": true,
18
- "linked": true
19
- },
20
- "turns": {
21
- "needsInput": "00000000-0001-7000-8000-000000000000",
22
- "completion": "00000000-0002-7000-8000-000000000000"
23
- },
24
- "events": {
25
- "preparedAt": "2026-08-24T10:00:00.000Z",
26
- "recordedAt": "2026-08-24T10:00:01.000Z",
27
- "createdAt": "2026-08-24T10:00:02.000Z",
28
- "linkedAt": "2026-08-24T10:00:05.000Z",
29
- "needsInputAt": "2026-08-24T10:00:20.000Z",
30
- "followedUpAt": "2026-08-24T10:00:40.000Z",
31
- "completedAt": "2026-08-24T10:01:00.000Z"
32
- },
33
- "validation": {
34
- "exactMarkerCorrelated": true,
35
- "noDispatcherPostCreateReads": true,
36
- "childIdentityVerified": true,
37
- "parentIdentityRejected": true,
38
- "linkRetryVerified": true,
39
- "needsInputVerified": true,
40
- "followUpTurnFresh": true,
41
- "dashboardDeepLinkVerified": true,
42
- "outputVerified": true
43
- },
44
- "summary": {
45
- "totalWallMs": 60000,
46
- "provisionalPath": true,
47
- "linked": true,
48
- "freshFollowUp": true
49
- }
50
- }
@@ -1,44 +0,0 @@
1
- <!-- taskchef:dispatcher-instructions:start -->
2
- # TaskChef Dispatcher Instructions
3
-
4
- This folder is the canonical per-user TaskChef dispatcher workspace.
5
-
6
- - Early in every dispatcher turn, best-effort call the TaskChef
7
- `ensure_dashboard` MCP tool. Dashboard startup failure must not block direct
8
- TaskChef answers, reporting, or delegation.
9
- - A request to start, recover, or open the TaskChef dashboard is TaskChef
10
- maintenance, not delegated project work. Use `$taskchef-dashboard`.
11
- - Use `$taskchef-bootstrap` when initializing or refreshing this workspace,
12
- changing or listing its configured projects, running TaskChef doctor,
13
- or repairing its managed instructions.
14
- - When the user asks to answer, follow up, resume, or continue the same
15
- recorded assignment in its existing executor task, use `$taskchef-copilot`
16
- before the general delegation rule. A direct imperative that names the exact
17
- existing task is explicit send authorization, but copilot must immediately
18
- re-read that exact task and apply its state and identity guardrails.
19
- - For every other actionable request that asks for an independent new outcome,
20
- use `$taskchef-delegate` automatically, even when the user does not explicitly
21
- say "delegate" or mention TaskChef.
22
- - Delegation lists native projects once per batch, reconciles that exact
23
- snapshot once, and routes only to one eligible exact native target.
24
- - GitHub issue and pull-request URLs may identify any repository advertised by
25
- a configured project, including child repositories of managed workspaces.
26
- - Do not perform delegated work directly in the dispatcher thread.
27
- - Return immediately after dispatch, as required by `$taskchef-delegate`.
28
- - Answer directly only when the user explicitly asks about TaskChef itself or
29
- explicitly says not to delegate.
30
- - Use `$taskchef-copilot` when the user asks what delegated work finished,
31
- what needs attention, why it failed or needs input, or what should happen
32
- next, including same-assignment continuation in an exact existing executor.
33
- Copilot uses the cached TaskChef brief by default; the dashboard is the
34
- primary monitoring and browsing UI. Live verification is explicit or
35
- contradiction-driven, focused, and never polled.
36
- - Explicit invocations of TaskChef skills from other Codex projects use this
37
- same workspace and task history through TaskChef's global resolution rules.
38
- - Every final response in this dispatcher workspace must end with this exact
39
- clickable link on its final non-empty line:
40
- `[TaskChef Dashboard](http://127.0.0.1:3210/)`. Keep any
41
- `::created-thread{...}` directive required by delegation on its own line
42
- immediately before the dashboard link so the immediate-return contract still
43
- holds. Include the link even when `ensure_dashboard` failed.
44
- <!-- taskchef:dispatcher-instructions:end -->
package/bin/taskchef.js DELETED
@@ -1,20 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- import { runCli } from "../src/cli.js";
4
-
5
- try {
6
- process.exitCode = await runCli(process.argv.slice(2));
7
- } catch (error) {
8
- if (process.argv.includes("--json")) {
9
- process.stdout.write(`${JSON.stringify({
10
- error: {
11
- code: error.code ?? "ERROR",
12
- message: error.message,
13
- ...(error.details ? { details: error.details } : {}),
14
- },
15
- })}\n`);
16
- } else {
17
- process.stderr.write(`taskchef: ${error.message}\n`);
18
- }
19
- process.exitCode = 1;
20
- }