PyPI - taskops-cli - Versions diffs - 0.2.0__py3-none-any.whl - Mend

taskops-cli 0.2.0__py3-none-any.whl

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 (193) hide show

taskops/__init__.py +39 -0
taskops/_clock.py +32 -0
taskops/_errors.py +160 -0
taskops/_ids.py +63 -0
taskops/_types.py +106 -0
taskops/_version.py +7 -0
taskops/assets/GUIDE.md +220 -0
taskops/contracts/__init__.py +96 -0
taskops/contracts/_fields.py +113 -0
taskops/contracts/actor.py +30 -0
taskops/contracts/board.py +142 -0
taskops/contracts/commit.py +36 -0
taskops/contracts/day.py +150 -0
taskops/contracts/dep.py +23 -0
taskops/contracts/event.py +58 -0
taskops/contracts/gitstate.py +45 -0
taskops/contracts/index.py +37 -0
taskops/contracts/lease.py +43 -0
taskops/contracts/log.py +59 -0
taskops/contracts/remote.py +48 -0
taskops/contracts/results.py +84 -0
taskops/contracts/task.py +94 -0
taskops/contracts/tools.py +110 -0
taskops/contracts/wire.py +60 -0
taskops/engine/__init__.py +34 -0
taskops/engine/_blocks.py +48 -0
taskops/engine/_briefs.py +92 -0
taskops/engine/_chunks.py +66 -0
taskops/engine/_closed.py +65 -0
taskops/engine/_entries.py +126 -0
taskops/engine/_events.py +55 -0
taskops/engine/_opened.py +51 -0
taskops/engine/_process.py +80 -0
taskops/engine/_prompts.py +98 -0
taskops/engine/_stream.py +129 -0
taskops/engine/activity.py +94 -0
taskops/engine/bus.py +42 -0
taskops/engine/commitline.py +110 -0
taskops/engine/day.py +142 -0
taskops/engine/diffstat.py +63 -0
taskops/engine/gitio.py +108 -0
taskops/engine/gitstate.py +96 -0
taskops/engine/history.py +76 -0
taskops/engine/identity.py +84 -0
taskops/engine/log.py +68 -0
taskops/engine/machine.py +160 -0
taskops/engine/narrate.py +91 -0
taskops/engine/project.py +57 -0
taskops/engine/replay.py +142 -0
taskops/engine/reports.py +67 -0
taskops/engine/scheduler.py +135 -0
taskops/engine/transcript.py +127 -0
taskops/engine/wire.py +92 -0
taskops/engine/worker.py +115 -0
taskops/py.typed +0 -0
taskops/render/__init__.py +40 -0
taskops/render/_closed_days.py +64 -0
taskops/render/_dossier.py +68 -0
taskops/render/_opened.py +64 -0
taskops/render/_sections.py +51 -0
taskops/render/_tasklist.py +72 -0
taskops/render/_text.py +74 -0
taskops/render/_verbatim.py +65 -0
taskops/render/ansi.py +92 -0
taskops/render/board.py +55 -0
taskops/render/day.py +102 -0
taskops/render/dispatch.py +104 -0
taskops/render/inbox.py +27 -0
taskops/render/log.py +47 -0
taskops/render/recover.py +64 -0
taskops/render/report.py +51 -0
taskops/render/reports.py +57 -0
taskops/render/results.py +96 -0
taskops/render/session.py +75 -0
taskops/render/task.py +88 -0
taskops/render/tasklist.py +65 -0
taskops/storage/__init__.py +36 -0
taskops/storage/_ddl.py +78 -0
taskops/storage/_delivered.py +51 -0
taskops/storage/_deps.py +69 -0
taskops/storage/_events.py +127 -0
taskops/storage/_leases.py +108 -0
taskops/storage/_rows.py +90 -0
taskops/storage/_tasks.py +124 -0
taskops/storage/locate.py +76 -0
taskops/storage/schema.py +66 -0
taskops/storage/store.py +120 -0
taskops/storage/sync.py +139 -0
taskops/transports/__init__.py +6 -0
taskops/transports/cli/__init__.py +0 -0
taskops/transports/cli/commands/__init__.py +3 -0
taskops/transports/cli/commands/_digest.py +64 -0
taskops/transports/cli/commands/_serve_init.py +65 -0
taskops/transports/cli/commands/_shared.py +50 -0
taskops/transports/cli/commands/_tasks_args.py +112 -0
taskops/transports/cli/commands/_window.py +45 -0
taskops/transports/cli/commands/ask.py +27 -0
taskops/transports/cli/commands/dispatch.py +43 -0
taskops/transports/cli/commands/init.py +48 -0
taskops/transports/cli/commands/log.py +22 -0
taskops/transports/cli/commands/plan.py +43 -0
taskops/transports/cli/commands/pushpull.py +53 -0
taskops/transports/cli/commands/recover.py +30 -0
taskops/transports/cli/commands/remote.py +56 -0
taskops/transports/cli/commands/report.py +82 -0
taskops/transports/cli/commands/run_.py +60 -0
taskops/transports/cli/commands/serve.py +74 -0
taskops/transports/cli/commands/sync.py +22 -0
taskops/transports/cli/commands/tasks.py +79 -0
taskops/transports/cli/commands/ui.py +72 -0
taskops/transports/cli/commands/update.py +25 -0
taskops/transports/cli/main.py +85 -0
taskops/transports/hooks/__init__.py +15 -0
taskops/transports/hooks/__main__.py +63 -0
taskops/transports/hooks/_args.py +28 -0
taskops/transports/hooks/claude.py +78 -0
taskops/transports/hooks/commit.py +61 -0
taskops/transports/hooks/events.py +107 -0
taskops/transports/hooks/record.py +55 -0
taskops/transports/http/__init__.py +21 -0
taskops/transports/http/_handler.py +132 -0
taskops/transports/http/_wire.py +79 -0
taskops/transports/http/_wsframes.py +116 -0
taskops/transports/http/agentapi.py +69 -0
taskops/transports/http/api.py +122 -0
taskops/transports/http/exchange.py +80 -0
taskops/transports/http/live.py +160 -0
taskops/transports/http/policy.py +110 -0
taskops/transports/http/projects.py +116 -0
taskops/transports/http/reports.py +75 -0
taskops/transports/http/router.py +90 -0
taskops/transports/http/server.py +50 -0
taskops/transports/http/static.py +86 -0
taskops/transports/http/ui/app.js +59 -0
taskops/transports/http/ui/index.html +23 -0
taskops/transports/http/ui/style.css +1 -0
taskops/transports/http/websocket.py +60 -0
taskops/transports/mcp/__init__.py +19 -0
taskops/transports/mcp/__main__.py +7 -0
taskops/transports/mcp/_descriptions.py +102 -0
taskops/transports/mcp/_reads.py +82 -0
taskops/transports/mcp/_writes.py +72 -0
taskops/transports/mcp/answers.py +44 -0
taskops/transports/mcp/arguments.py +104 -0
taskops/transports/mcp/dispatch.py +47 -0
taskops/transports/mcp/protocol.py +83 -0
taskops/transports/mcp/schema.py +50 -0
taskops/transports/mcp/server.py +49 -0
taskops/transports/mcp/tools.py +66 -0
taskops/usecases/__init__.py +56 -0
taskops/usecases/_entry.py +84 -0
taskops/usecases/_facts.py +49 -0
taskops/usecases/_freeing.py +93 -0
taskops/usecases/_gitignore.py +94 -0
taskops/usecases/_mirroring.py +57 -0
taskops/usecases/_narrating.py +77 -0
taskops/usecases/_project.py +67 -0
taskops/usecases/_range.py +102 -0
taskops/usecases/_reasons.py +54 -0
taskops/usecases/_remotefile.py +62 -0
taskops/usecases/_reportsync.py +108 -0
taskops/usecases/_routing.py +91 -0
taskops/usecases/_wireclient.py +141 -0
taskops/usecases/ask.py +41 -0
taskops/usecases/claim.py +104 -0
taskops/usecases/dispatch.py +160 -0
taskops/usecases/dossier.py +155 -0
taskops/usecases/edit.py +71 -0
taskops/usecases/exchange.py +86 -0
taskops/usecases/feed.py +138 -0
taskops/usecases/guard.py +122 -0
taskops/usecases/hooks.py +127 -0
taskops/usecases/index.py +62 -0
taskops/usecases/ingest.py +60 -0
taskops/usecases/log.py +134 -0
taskops/usecases/narration.py +91 -0
taskops/usecases/plan.py +128 -0
taskops/usecases/pushpull.py +119 -0
taskops/usecases/recover.py +84 -0
taskops/usecases/remote.py +78 -0
taskops/usecases/report.py +87 -0
taskops/usecases/reportfile.py +106 -0
taskops/usecases/session.py +134 -0
taskops/usecases/setup.py +92 -0
taskops/usecases/sync.py +78 -0
taskops/usecases/update.py +123 -0
taskops/usecases/view.py +112 -0
taskops_cli-0.2.0.dist-info/METADATA +291 -0
taskops_cli-0.2.0.dist-info/RECORD +193 -0
taskops_cli-0.2.0.dist-info/WHEEL +5 -0
taskops_cli-0.2.0.dist-info/entry_points.txt +2 -0
taskops_cli-0.2.0.dist-info/licenses/LICENSE +21 -0
taskops_cli-0.2.0.dist-info/top_level.txt +1 -0

taskops/transports/http/ui/index.html ADDED Viewed

@@ -0,0 +1,23 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="color-scheme" content="dark light" />
+    <!-- The mount point, and the ONE line the server rewrites.
+         Every other href/src below is relative, and `api.ts` reads `document.baseURI`, so
+         re-pointing this tag moves the whole app under `/<project>/` when `taskops serve`
+         mounts it. `taskops ui` leaves it exactly as it is. -->
+    <base href="/" />
+    <title>taskops ui</title>
+    <link rel="stylesheet" href="style.css" />
+    <link
+      rel="icon"
+      href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' rx='7' fill='%230f1115'/%3E%3Cpath d='M8 16.5l5 5 11-11' stroke='%23b8ff3a' stroke-width='3.5' fill='none' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E"
+    />
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="app.js"></script>
+  </body>
+</html>

taskops/transports/http/ui/style.css ADDED Viewed

@@ -0,0 +1 @@

+ :root{--bg: #0f1115;--bg-raised: #171a21;--bg-card: #1b1f28;--bg-hover: #212633;--line: #262c39;--line-soft: #1e2430;--ink: #e6e8ee;--ink-dim: #8b93a7;--ink-faint: #5b6479;--lime: #b8ff3a;--amber: #ffb84d;--red: #ff6b6b;--blue: #6bb6ff;--violet: #b48cff;--mono: ui-monospace, "SF Mono", "JetBrains Mono", Menlo, Consolas, monospace;--sans: ui-sans-serif, -apple-system, "Inter", "Segoe UI", system-ui, sans-serif;--r: 8px;--r-lg: 12px;--shadow: 0 8px 28px rgb(0 0 0 / 45%);--pad: 14px}@media (prefers-color-scheme: light){:root{--bg: #f7f8fa;--bg-raised: #ffffff;--bg-card: #ffffff;--bg-hover: #f0f2f6;--line: #dde1e8;--line-soft: #e008;--line-soft: #e8ebf0;--ink: #12151c;--ink-dim: #5b6479;--ink-faint: #8b93a7;--lime: #4f9c00;--amber: #b06f00;--red: #c92a2a;--blue: #1268c3;--violet: #6d3fd4;--shadow: 0 6px 20px rgb(15 20 35 / 12%)}}*,*:before,*:after{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--ink);font:14px/1.55 var(--sans);-webkit-font-smoothing:antialiased}h1,h2,h3{margin:0;font-weight:600;line-height:1.3}h1{font-size:20px;letter-spacing:-.01em}h2{font-size:13px}h3{font-size:11px;text-transform:uppercase;letter-spacing:.08em;color:var(--ink-dim)}p{margin:0 0 8px}ul,ol{margin:0;padding:0;list-style:none}code,pre{font-family:var(--mono);font-size:12px}pre{margin:0;white-space:pre-wrap;word-break:break-word}button{font:inherit;color:inherit;background:var(--bg-raised);border:1px solid var(--line);border-radius:6px;padding:5px 10px;cursor:pointer;transition:background .12s ease,border-color .12s ease}button:hover:not(:disabled){background:var(--bg-hover);border-color:var(--ink-faint)}button:disabled{opacity:.45;cursor:not-allowed}button.primary{background:var(--lime);color:#0d1207;border-color:transparent;font-weight:600}button.primary:hover:not(:disabled){filter:brightness(1.08);background:var(--lime)}button.linkish{background:none;border:none;padding:0;color:var(--lime);font-family:var(--mono);font-size:12px;text-decoration:none}button.linkish:hover{background:none;text-decoration:underline}input,textarea{font:inherit;width:100%;color:var(--ink);background:var(--bg);border:1px solid var(--line);border-radius:6px;padding:7px 10px}input:focus,textarea:focus{outline:2px solid color-mix(in oklab,var(--lime) 55%,transparent);outline-offset:-1px;border-color:transparent}textarea{resize:vertical;font-family:var(--mono);font-size:12px}.dim{color:var(--ink-dim)}.tally{font-family:var(--mono);font-size:11px;color:var(--ink-dim);background:var(--bg);border:1px solid var(--line);border-radius:20px;padding:0 6px}.top{position:sticky;top:0;z-index:20;display:flex;align-items:center;gap:16px;padding:10px 16px;background:color-mix(in oklab,var(--bg) 88%,transparent);backdrop-filter:blur(12px);border-bottom:1px solid var(--line)}.brand{display:flex;align-items:center;gap:10px;min-width:0}.brand>div{display:flex;flex-direction:column;line-height:1.25;min-width:0}.brand strong{font-size:13px;letter-spacing:-.01em}.logo{display:grid;place-items:center;width:26px;height:26px;border-radius:7px;background:var(--lime);color:#0d1207;font-weight:700;font-size:15px}.repo{font-family:var(--mono);font-size:11px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.top-right{display:flex;align-items:center;gap:12px;margin-left:auto}.stats{display:flex;gap:10px}.stat{font-size:11px;color:var(--ink-dim)}.stat b{font-family:var(--mono);font-size:13px;color:var(--ink)}.stat-good b{color:var(--lime)}.badge{font-size:10px;text-transform:uppercase;letter-spacing:.07em;color:var(--amber);border:1px solid color-mix(in oklab,var(--amber) 40%,transparent);border-radius:20px;padding:2px 8px}.live{display:flex;align-items:center;gap:6px;font-size:11px;font-family:var(--mono)}.live.on{color:var(--lime)}.live.off{color:var(--ink-faint)}.live .dot{width:7px;height:7px;border-radius:50%;background:currentColor}.live.on .dot{animation:tick .9s ease-out}@keyframes tick{0%{transform:scale(1);box-shadow:0 0 color-mix(in oklab,var(--lime) 70%,transparent)}40%{transform:scale(1.7)}to{transform:scale(1);box-shadow:0 0 0 9px transparent}}@media (prefers-reduced-motion: reduce){.live.on .dot{animation:none}*{transition:none!important}}.search{position:relative;flex:1 1 260px;max-width:420px}.hits{position:absolute;top:calc(100% + 6px);left:0;right:0;z-index:30;background:var(--bg-raised);border:1px solid var(--line);border-radius:var(--r);box-shadow:var(--shadow);overflow:hidden}.hits button{display:block;width:100%;text-align:left;background:none;border:none;border-radius:0;padding:8px 10px;font-size:13px}.hits button:hover{background:var(--bg-hover)}.hits code{color:var(--lime);margin-right:6px}.squeeze{padding:4px 9px;font-size:13px;line-height:1;color:var(--ink-dim)}.squeeze.on{color:var(--lime);border-color:color-mix(in oklab,var(--lime) 40%,transparent);background:color-mix(in oklab,var(--lime) 10%,transparent)}main{padding:16px}.banner{display:flex;align-items:center;gap:10px;margin:12px 16px 0;padding:9px 12px;font-size:13px;color:var(--red);background:color-mix(in oklab,var(--red) 10%,transparent);border:1px solid color-mix(in oklab,var(--red) 35%,transparent);border-radius:var(--r)}.loading{padding:40px 0;text-align:center}.board{display:flex;gap:12px;overflow-x:auto;padding-bottom:8px;scroll-snap-type:x proximity}.column{flex:0 0 272px;scroll-snap-align:start;background:var(--bg-raised);border:1px solid var(--line-soft);border-radius:var(--r-lg);padding:10px}.column-head{display:flex;align-items:center;gap:7px;padding:2px 4px 10px;flex-wrap:wrap}.column-head h2{flex:1}.column-head .tally{margin-left:auto}.mark{font-family:var(--mono);color:var(--ink-faint)}.group-by{flex:0 0 100%;margin-top:2px;font-family:var(--mono);font-size:10.5px;padding:2px 7px;color:var(--ink-dim)}.group>summary{display:flex;align-items:center;gap:7px;padding:5px 4px;cursor:pointer;list-style:none;font-size:11px;text-transform:uppercase;letter-spacing:.06em;color:var(--ink-dim);border-bottom:1px solid var(--line-soft)}.group>summary::-webkit-details-marker{display:none}.group>summary:before{content:"\25b8";color:var(--ink-faint);font-size:9px}.group[open]>summary:before{content:"\25be"}.group>summary:hover{color:var(--ink)}.group-label{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.group[open]{display:flex;flex-direction:column;gap:8px}.group[open]>summary{margin-bottom:2px}.column-ready{box-shadow:inset 0 2px 0 var(--lime)}.column-claimed,.column-in_progress{box-shadow:inset 0 2px 0 var(--amber)}.column-blocked{box-shadow:inset 0 2px 0 var(--red)}.column-review{box-shadow:inset 0 2px 0 var(--blue)}.column-done{box-shadow:inset 0 2px color-mix(in oklab,var(--lime) 45%,var(--line))}.column-ready .mark{color:var(--lime)}.column-blocked .mark{color:var(--red)}.column-claimed .mark,.column-in_progress .mark{color:var(--amber)}.cards{display:flex;flex-direction:column;gap:8px;min-height:44px}.column-empty{margin:0;padding:12px 4px;font-size:12px;text-align:center;border:1px dashed var(--line);border-radius:var(--r)}.card{background:var(--bg-card);border:1px solid var(--line);border-radius:var(--r);padding:var(--pad);cursor:pointer;transition:border-color .12s ease,transform .12s ease,box-shadow .12s ease}.card:hover{border-color:var(--ink-faint);transform:translateY(-1px);box-shadow:var(--shadow)}.card:focus-visible{outline:2px solid var(--lime);outline-offset:1px}.card.held{border-left:2px solid var(--amber)}.card-top{display:flex;align-items:center;gap:7px;margin-bottom:7px}.card .id{color:var(--ink-dim)}.card .title{margin:0 0 8px;font-size:13.5px;line-height:1.4}.card-lease{display:flex;flex-wrap:wrap;align-items:center;gap:7px;margin-bottom:7px}.card-foot{font-size:11px}.branch{color:var(--ink-dim);background:var(--bg);border:1px solid var(--line);border-radius:4px;padding:1px 5px;font-size:11px;max-width:100%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.pri{font-family:var(--mono);font-size:10.5px;font-weight:700;letter-spacing:.02em}.pri-urgent{color:var(--red)}.pri-high{color:var(--amber)}.pri-normal{color:var(--ink-faint)}.actor{font-family:var(--mono);font-size:11.5px;white-space:nowrap}.actor-agent{color:var(--violet)}.actor-dev{color:var(--blue)}.actor-unknown{color:var(--ink-dim)}.counts{display:flex;gap:6px;margin-left:auto;font-family:var(--mono);font-size:11px}.count.blocked{color:var(--red)}.count.blocking{color:var(--amber)}.count.commits{color:var(--lime)}.labels{display:flex;flex-wrap:wrap;gap:5px;margin-bottom:7px}.label{font-size:10.5px;color:var(--ink-dim);background:var(--bg);border:1px solid var(--line);border-radius:20px;padding:1px 7px}.empty{padding:56px 20px;text-align:center;max-width:44rem;margin:0 auto}.empty h2{font-size:17px;margin-bottom:8px}.empty pre{text-align:left;margin-top:14px;padding:12px;background:var(--bg-raised);border:1px solid var(--line);border-radius:var(--r)}.views{display:flex;gap:4px}.views button{font-size:12px;padding:4px 11px;background:none;border-color:transparent;color:var(--ink-dim)}.views button.on{color:var(--ink);background:var(--bg-raised);border-color:var(--line)}.activity{display:flex;flex-direction:column;gap:12px}.activity-head{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.activity-head h2{font-size:15px}.activity-head .filter{flex:1 1 220px;max-width:340px}.meta-count{font-size:11px;font-family:var(--mono)}.windows{display:flex;gap:3px}.windows button,.kind,.chip{font-family:var(--mono);font-size:11px;padding:3px 8px;color:var(--ink-dim)}.windows button.on,.kind.on{color:var(--lime);border-color:color-mix(in oklab,var(--lime) 40%,transparent);background:color-mix(in oklab,var(--lime) 10%,transparent)}.chip{margin-left:7px;color:var(--lime);border-color:color-mix(in oklab,var(--lime) 35%,transparent)}.activity-body{display:grid;grid-template-columns:260px minmax(0,1fr);gap:16px;align-items:start}@media (max-width: 860px){.activity-body{grid-template-columns:minmax(0,1fr)}}.people{position:sticky;top:72px;display:flex;flex-direction:column;gap:8px}.people ul{display:flex;flex-direction:column;gap:6px}.person button{width:100%;text-align:left;padding:8px 10px;background:var(--bg-raised);border-color:var(--line-soft)}.person.on button{border-color:color-mix(in oklab,var(--lime) 45%,transparent);background:color-mix(in oklab,var(--lime) 8%,transparent)}.person-top{display:flex;align-items:center;gap:7px;margin-bottom:4px;font-size:11px}.person-top .dim{margin-left:auto}.person-counts{display:flex;align-items:center;gap:8px;font-size:11px;font-family:var(--mono);color:var(--ink-dim)}.timeline{display:flex;flex-direction:column;gap:10px}.timeline h3{display:flex;align-items:center}.kinds{display:flex;flex-wrap:wrap;gap:4px}.day{display:flex;flex-direction:column;gap:6px}.day h4{position:sticky;top:64px;z-index:5;display:flex;align-items:center;gap:7px;margin:6px 0 2px;padding:4px 0;font-size:11px;text-transform:uppercase;letter-spacing:.07em;color:var(--ink-dim);background:var(--bg);border-bottom:1px solid var(--line-soft)}.events{display:flex;flex-direction:column}.event{display:flex;align-items:baseline;gap:9px;padding:5px 2px}.event+.event{border-top:1px solid var(--line-soft)}.event .when{font-family:var(--mono);font-size:11px;flex:0 0 44px}.kind-dot{width:6px;height:6px;border-radius:50%;flex:0 0 auto;background:var(--ink-faint)}.kind-commit,.kind-done{background:var(--lime)}.kind-status,.kind-created,.kind-branch{background:var(--blue)}.kind-claimed,.kind-activity,.kind-handoff,.kind-released{background:var(--amber)}.kind-comment,.kind-message{background:var(--violet)}.kind-blocked{background:var(--red)}.event-body{flex:1;min-width:0}.event-top{display:flex;align-items:baseline;gap:8px;font-size:11.5px;min-width:0}.ellipsis{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.event-said{margin:1px 0 0;font-size:12.5px;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden}.drawer{position:fixed;inset:0;z-index:40;background:#0000008c;backdrop-filter:blur(2px);display:flex;justify-content:flex-end}.panel{width:min(620px,100%);height:100%;overflow-y:auto;background:var(--bg);border-left:1px solid var(--line);padding:16px 20px 40px;display:flex;flex-direction:column;gap:16px;animation:slide .18s ease-out}@keyframes slide{0%{transform:translate(24px);opacity:.6}}.panel-head{display:flex;align-items:center;gap:10px}.panel-head>div{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.panel-head .close{margin-left:auto;padding:3px 9px}.id.big{font-size:13px;color:var(--lime)}.panel h1{margin:0}.meta{font-size:11.5px;display:flex;align-items:center;gap:5px;flex-wrap:wrap}.status{font-family:var(--mono);font-size:11px;border-radius:20px;padding:2px 9px;border:1px solid currentColor}.status-ready{color:var(--lime)}.status-claimed,.status-in_progress{color:var(--amber)}.status-blocked{color:var(--red)}.status-review{color:var(--blue)}.status-done{color:var(--lime)}.status-backlog,.status-cancelled{color:var(--ink-dim)}.panel section{display:flex;flex-direction:column;gap:8px}.cmd{padding:10px 12px;color:var(--lime);background:var(--bg-raised);border:1px solid var(--line);border-radius:var(--r);user-select:all}.spec{padding:12px;line-height:1.6;background:var(--bg-raised);border:1px solid var(--line);border-radius:var(--r)}.files{display:flex;flex-wrap:wrap;gap:6px}.files code{background:var(--bg-raised);border:1px solid var(--line);border-radius:5px;padding:2px 7px;color:var(--ink-dim)}.warn{padding:12px;background:color-mix(in oklab,var(--red) 8%,transparent);border:1px solid color-mix(in oklab,var(--red) 32%,transparent);border-radius:var(--r)}.warn h3{color:var(--red)}.warn ul,.graph{display:flex;flex-direction:column;gap:5px;font-size:13px}.graph li{display:flex;align-items:baseline;gap:7px}.thread{display:flex;flex-direction:column;gap:12px}.thread li{padding-left:10px;border-left:2px solid var(--line)}.msg-head{display:flex;align-items:center;gap:8px;font-size:11px;margin-bottom:3px}.msg{margin:0;font-size:13px;white-space:pre-wrap}.tag{font-size:9.5px;text-transform:uppercase;letter-spacing:.06em;color:var(--violet);border:1px solid color-mix(in oklab,var(--violet) 40%,transparent);border-radius:20px;padding:0 6px}.compose{padding-top:8px;border-top:1px solid var(--line)}.actions{display:flex;flex-wrap:wrap;gap:6px}.actions button{font-size:12px}.failed{color:var(--red);font-size:12.5px;margin:0}.commits{display:flex;flex-direction:column;gap:8px}.commit{padding:8px 10px;background:var(--bg-raised);border:1px solid var(--line)}.commit-head{display:flex;align-items:baseline;gap:8px;margin-bottom:5px}.commit .sha{color:var(--lime);flex:0 0 auto}.commit .subject{font-size:13px}.reports{display:grid;grid-template-columns:240px minmax(0,1fr);gap:16px;align-items:start}@media (max-width: 860px){.reports{grid-template-columns:minmax(0,1fr)}}.report-list{position:sticky;top:72px;display:flex;flex-direction:column;gap:8px}.report-list ul{display:flex;flex-direction:column;gap:6px}.report-row button{width:100%;text-align:left;padding:8px 10px;background:var(--bg-raised);border-color:var(--line-soft)}.report-row.on button{border-color:color-mix(in oklab,var(--lime) 45%,transparent);background:color-mix(in oklab,var(--lime) 8%,transparent)}.report-row-top{display:flex;align-items:center;gap:7px;margin-bottom:4px}.report-row-top code{font-size:12px}.report-row-top .narr{margin-left:auto;color:var(--lime);font-size:11px}.report-row-meta{display:flex;align-items:center;gap:7px;font-size:11px;font-family:var(--mono)}.stale{color:var(--amber);border:1px solid color-mix(in oklab,var(--amber) 35%,transparent);border-radius:20px;padding:0 6px}.report-body{display:flex;flex-direction:column;gap:12px;min-width:0}.report-head{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.report-head h2{font-size:15px;font-family:var(--mono)}.report-path{font-size:11px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.report-head button{margin-left:auto}.narrating{display:flex;align-items:center;gap:8px;font-size:12.5px}.spinner{width:11px;height:11px;flex:0 0 auto;border-radius:50%;border:2px solid var(--line);border-top-color:var(--lime);animation:spin .72s linear infinite}@keyframes spin{to{transform:rotate(360deg)}}.narration{padding:14px 16px;border-radius:var(--r-lg);background:color-mix(in oklab,var(--lime) 6%,var(--bg-raised));border:1px solid color-mix(in oklab,var(--lime) 30%,transparent)}.narration h3{color:var(--lime);margin-bottom:6px}.narration.pending{background:var(--bg-raised);border-color:var(--line)}.narration.pending h3{color:var(--ink-dim)}.narration.streaming{border-color:color-mix(in oklab,var(--lime) 55%,transparent)}.narration.streaming h3{animation:breathe 1.6s ease-in-out infinite}@keyframes breathe{50%{opacity:.45}}@media (prefers-reduced-motion: reduce){.narration.streaming h3{animation:none}}.report-row-meta .running{color:var(--lime)}.dossier{padding:14px 16px;border-radius:var(--r);background:var(--bg-raised);border:1px solid var(--line)}.md{display:flex;flex-direction:column;gap:9px;min-width:0}.md-h{margin-top:6px;font-size:14px;font-weight:600;color:var(--ink);text-transform:none;letter-spacing:0}.md h2.md-h{font-size:15px}.md-p{margin:0;white-space:pre-wrap;font-size:13px;line-height:1.6}.md-p code,.md-list code,.md-table code{color:var(--lime);font-size:11.5px}.md-list{display:flex;flex-direction:column;gap:4px;padding-left:18px;font-size:13px}.md-list li{list-style:disc}ol.md-list li{list-style:decimal}.md-code{padding:10px 12px;overflow-x:auto;background:var(--bg);border:1px solid var(--line);border-radius:var(--r)}.md-rule{border:0;border-top:1px solid var(--line-soft)}.md-table-wrap{overflow-x:auto}.md-table{border-collapse:collapse;font-size:12.5px}.md-table th,.md-table td{padding:5px 10px;border:1px solid var(--line-soft);text-align:left}.md-table th{color:var(--ink-dim);font-weight:600;background:var(--bg)}

taskops/transports/http/websocket.py ADDED Viewed

@@ -0,0 +1,60 @@
+"""The websocket handshake: turning an HTTP request into a socket.
+Only the upgrade lives here. Everything that flows afterwards is `_wsframes`, and the split is the
+same one the rest of this package makes everywhere — HTTP is one concern, the binary protocol on the
+other side of it is another.
+"""
+from __future__ import annotations
+import base64
+import hashlib
+import os
+from ._wsframes import (
+    OPCODE_CLOSE,
+    OPCODE_PING,
+    OPCODE_PONG,
+    OPCODE_TEXT,
+    close_frame,
+    ping_frame,
+    read_frame,
+    text_frame,
+)
+__all__ = ["accept_key", "handshake_headers", "is_upgrade", "new_key", "text_frame",
+           "close_frame", "ping_frame", "read_frame", "OPCODE_TEXT", "OPCODE_CLOSE",
+           "OPCODE_PING", "OPCODE_PONG"]
+_GUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11"
+"""The magic string from RFC 6455 §4.2.2. It exists so a server cannot accidentally complete a
+handshake it did not understand — the client checks that we hashed its key with exactly this."""
+def is_upgrade(headers: dict[str, str]) -> bool:
+    """Is this request asking to become a websocket.
+    Checked on the lower-cased header map the server already built. `Connection` may legitimately be
+    a LIST (`keep-alive, Upgrade`), which is why this is a substring test and not equality — the
+    equality version works in every browser and fails behind some proxies.
+    """
+    return ("websocket" in headers.get("upgrade", "").lower()
+            and "upgrade" in headers.get("connection", "").lower()
+            and bool(headers.get("sec-websocket-key")))
+def accept_key(client_key: str) -> str:
+    """The `Sec-WebSocket-Accept` value: sha1 of the key plus the GUID, base64."""
+    digest = hashlib.sha1((client_key.strip() + _GUID).encode("utf-8")).digest()
+    return base64.b64encode(digest).decode("ascii")
+def handshake_headers(client_key: str) -> dict[str, str]:
+    """The headers that complete the upgrade. Status 101 is the server's job."""
+    return {"Upgrade": "websocket", "Connection": "Upgrade",
+            "Sec-WebSocket-Accept": accept_key(client_key)}
+def new_key() -> str:
+    """A client-side `Sec-WebSocket-Key`. Only the tests need this — a browser makes its own."""
+    return base64.b64encode(os.urandom(16)).decode("ascii")

taskops/transports/mcp/__init__.py ADDED Viewed

@@ -0,0 +1,19 @@
+"""The MCP transport: five tools over JSON-RPC on stdio.
+Layered on purpose — `tools` is the surface, `schema` generates it from `contracts/`,
+`arguments` reads what a model wrote, `dispatch` maps a name to a use case and a renderer,
+`protocol` is JSON-RPC as a pure function, and `server` is the wire.
+Nothing here imports the engine at module scope: a host lists the tools before it asks
+anything, and that handshake must stay free of sqlite and git. `dispatch` is imported inside
+`protocol`'s tools/call branch, where the cost is warranted.
+"""
+from __future__ import annotations
+from .protocol import INSTRUCTIONS, PROTOCOL, respond
+from .server import main, serve
+from .tools import TOOLS, Tool, listing
+__all__ = ["TOOLS", "Tool", "listing", "PROTOCOL", "INSTRUCTIONS", "respond",
+           "serve", "main"]

taskops/transports/mcp/__main__.py ADDED Viewed

@@ -0,0 +1,7 @@
+"""`python -m taskops.transports.mcp` — the server a host launches."""
+from __future__ import annotations
+from .server import main
+raise SystemExit(main())

taskops/transports/mcp/_descriptions.py ADDED Viewed

@@ -0,0 +1,102 @@
+"""The tool descriptions. Prose, not logic — which is why they are not in `tools.py`.
+Same split as `storage/_ddl`: that module is the SQL, this one is the text, and in both
+cases the point is that reviewing a change to the assembly is not also re-reading sixty
+lines of unchanged content.
+These strings are the single highest-leverage text in the package. They are what an agent
+reads before it decides which tool to call and what to put in it, and every sentence here
+earns its place by preventing a mistake seen in a real session — an agent coding before
+claiming, closing a task with nothing to show, or discovering a shared file at merge time.
+"""
+from __future__ import annotations
+__all__ = ["NEXT", "UPDATE", "ASK", "PLAN", "REPORT", "DISPATCH", "RECOVER"]
+NEXT = (
+    "CLAIM the next piece of work — the call to make when you are ready to code, and the "
+    "first call in any session where you do not already hold a task. Returns the task's "
+    "full spec, the exact branch to create, the conversation so far, the commits already "
+    "on it, and a WARNING listing any other agent editing the same files. The claim is "
+    "atomic and leased: no two agents can hold one task, and if your process dies the "
+    "lease expires and the work returns to the queue instead of sitting there looking "
+    "claimed forever. Every taskops call you make afterwards renews it, so a long task "
+    "never expires under you. When nothing is available it says WHY — everything blocked, "
+    "everything taken, or the project is finished — which is usually something you can "
+    "act on."
+)
+UPDATE = (
+    "Record progress, hand work back, close a task, or MESSAGE another developer's agent — "
+    "one call, because they are one thought. `comment` is what the next agent and the "
+    "human reviewing at 9am will read, so write the decision and the surprise rather than "
+    "a restatement of the title. `mentions` reaches other actors' inboxes: they see it "
+    "within one tool call of their own, and it appears live on the board — this is how you "
+    "raise a shared file before you both edit it. `status=released` returns the task to "
+    "the queue with your progress attached, which is the honest move when you are out of "
+    "context or out of depth. `status=done` requires a commit bound to this task (pass "
+    "no_code with a comment if the task genuinely produced none) — that guard is the "
+    "reason the board can be trusted."
+)
+ASK = (
+    "READ a task in full: the spec, the whole conversation, the commits, what blocks it, "
+    "what it is blocking, its subtasks, and which OTHER tasks touch the same files. Use it "
+    "before starting on a task somebody handed you by id, and before editing a file you "
+    "suspect is contested — the neighbours list is the one thing that prevents a merge "
+    "conflict rather than reporting it afterwards. With `query` instead of `task` it "
+    "searches titles and specs, for when you know what the work is called but not its id."
+)
+PLAN = (
+    "Turn a decomposition into a persistent task graph in ONE call — tasks, their "
+    "parent/child tree, and the dependencies between them. YOU do the decomposition; this "
+    "makes it durable, ordered, and visible to every other agent and developer on the "
+    "project. `after` accepts the 0-based index of an earlier task in the same batch, so a "
+    "whole plan lands atomically instead of needing a second pass that a context limit can "
+    "cut short. Write each `spec` for a FRESH agent with none of your context: what done "
+    "looks like, what must not change, which files to start from. Name `files` and the "
+    "scheduler will never hand two agents the same one."
+)
+REPORT = (
+    "The generated view: `board` (every column, who holds what), `standup` (what changed "
+    "in a window, per actor, and what needs a human), or `day` (ONE calendar day in full — "
+    "every card closed with who closed it, how long it was held, each of its commits with "
+    "the size of its diff, what is still in flight or blocked, the whole conversation, and "
+    "a roll-up per actor), or `range` (that same dossier over MANY days, its closed cards "
+    "grouped by day, newest first). Nobody writes these by hand, so they cannot be out of "
+    "date — use `standup` when a human asks how it is going, `day` with date='yesterday' "
+    "when they ask what got done, and `range` when they ask about the project rather than "
+    "about a day: with `last`='7d' for the week, and with NO window fields at all for "
+    "everything since the log began, which is the answer to 'evaluate all of this'."
+)
+DISPATCH = (
+    "PREPARE workers for cards, then spawn them YOURSELF as sub-agents of this session. It assigns "
+    "each card to a named worker, creates a git worktree per card already checked out on that card's "
+    "branch, and returns a ready-to-use BRIEF per card. It starts nothing — you take those briefs and "
+    "spawn one sub-agent each, ALL IN ONE MESSAGE so they run in parallel, on the session you are "
+    "already in. That is the whole flow: plan, dispatch, spawn. Each brief already tells its worker "
+    "which worktree to work in and never to run `git switch`, because sub-agents share this repository "
+    "and switching would move every other worker's branch at once. `count` says how many (default 3, "
+    "ceiling 12); `dry_run` shows which cards would be picked and changes nothing. Assignment happens "
+    "first, so no other agent is offered a card you prepared — and IF YOU DO NOT SPAWN THEM, run "
+    "recovery, because otherwise those cards sit assigned to workers that never existed and are "
+    "invisible to everybody else. This tool never starts a process itself."
+)
+RECOVER = (
+    "UNSTICK the board: hand back every card whose worker died, and say what survived. Call it when "
+    "the board shows work in flight that is not moving — cards sitting `claimed` by agents that were "
+    "killed, or assigned to workers somebody dispatched and never spawned. Both cases are covered, "
+    "and the second has no lease at all, so nothing else finds it: those cards are invisible to every "
+    "other agent and claimable by nobody until this runs. It does not wait for a lease to expire, "
+    "because if you are looking at the board you have already noticed. It clears the ASSIGNMENT as "
+    "well as the claim, so the card returns to the open pool. And it writes on each card what "
+    "survived: commits are safe in git, and any UNCOMMITTED work is named with its full path — a "
+    "killed agent writes before it commits, so that path is often real work. Read it before letting "
+    "anybody start the task over. Workers still reporting are left alone and named in the reply; pass "
+    "`force` to release those too."
+)

taskops/transports/mcp/_reads.py ADDED Viewed

@@ -0,0 +1,82 @@
+"""Handlers that only QUERY: read a task, search, or render a projection.
+Split from `_handlers` because there are seven tools and one file of them stopped being readable. The
+seam is what a handler DOES: these answer questions and change nothing, so they are safe to call twice and their only
+real decisions are about SHAPE — `ask` serves two forms behind one tool, and `report` four.
+"""
+from __future__ import annotations
+from typing import Any
+from ...render import (
+    render_board,
+    render_day,
+    render_search,
+    render_standup,
+    render_view,
+)
+from ...usecases import (
+    Selector,
+    ask,
+    board,
+    day,
+    period,
+    search,
+    standup,
+)
+from . import arguments as arg
+__all__ = ["ask_", "report_"]
+def ask_(args: dict[str, Any]) -> str:
+    """`task` or `query`, and saying so when neither came.
+    Two shapes behind one tool: an agent either knows which task it means or it does not,
+    and making that two tools would have it choose wrong half the time.
+    """
+    if wanted := arg.optional(args, "task"):
+        return render_view(ask(arg.repo(args), wanted,
+                               actor=arg.optional(args, "actor")))
+    if query := arg.optional(args, "query"):
+        return render_search(search(arg.repo(args), query), query)
+    raise arg.Missing("pass `task` to read one, or `query` to search")
+def report_(args: dict[str, Any]) -> str:
+    """Four kinds, and an unknown one is REFUSED rather than quietly given a board.
+    `fleet` and `burndown` used to be answerable here. Falling through to the board would
+    hand an agent that asked for one of them a report about something else and no way to
+    tell — so the removal is stated, with what to ask for instead.
+    """
+    kind = arg.optional(args, "kind") or "board"
+    where = arg.repo(args)
+    if kind == "standup":
+        return render_standup(standup(where, since=arg.optional(args, "since") or "24h",
+                                      actor=arg.optional(args, "actor")))
+    if kind == "day":
+        return render_day(day(where, arg.optional(args, "date") or "today"))
+    if kind == "range":
+        return render_day(period(where, _span(args)))
+    if kind != "board":
+        raise arg.Missing(f"`{kind}` is not a report — ask for `board`, `standup`, `day` "
+                          f"or `range`")
+    return render_board(board(where))
+def _span(args: dict[str, Any]) -> Selector:
+    """`range` with nothing to narrow it is the WHOLE project.
+    The generous default is the point: an agent asked to evaluate what was done here should
+    get everything by asking for a range, not an empty report because it did not know which
+    of three window fields this tool wanted.
+    """
+    last, first = arg.optional(args, "last"), arg.optional(args, "from_date")
+    to = arg.optional(args, "to")
+    if not (last or first):
+        return Selector(whole=True, to=to)
+    return Selector(date=first, to=to, last=last)

taskops/transports/mcp/_writes.py ADDED Viewed

@@ -0,0 +1,72 @@
+"""Handlers that CHANGE the board: plan, claim, update, dispatch, recover.
+Split from `_handlers` because there are seven tools and one file of them stopped being readable. The
+seam is what a handler DOES: every one of these writes, so each is the entry point of a use case that enforces a rule —
+a guard, a lease, an assignment — and none of them may make that decision here.
+"""
+from __future__ import annotations
+from typing import Any
+from ...render import (
+    render_dispatch,
+    render_next,
+    render_plan,
+    render_recover,
+    render_update,
+)
+from ...usecases import (
+    dispatch,
+    next_task,
+    plan,
+    recover,
+    update,
+)
+from . import arguments as arg
+__all__ = ["plan_", "next_", "update_", "dispatch_", "recover_"]
+def plan_(args: dict[str, Any]) -> str:
+    return render_plan(plan(arg.repo(args), arg.entries(args),
+                            actor=arg.optional(args, "actor")))
+def next_(args: dict[str, Any]) -> str:
+    return render_next(next_task(arg.repo(args), actor=arg.optional(args, "actor"),
+                                 session=arg.optional(args, "session"),
+                                 labels=arg.csv(args, "labels"),
+                                 task=arg.optional(args, "task")))
+def update_(args: dict[str, Any]) -> str:
+    return render_update(update(arg.repo(args), arg.text(args, "task"),
+                                actor=arg.optional(args, "actor"),
+                                status=arg.optional(args, "status"),
+                                comment=arg.optional(args, "comment"),
+                                mentions=arg.csv(args, "mentions"),
+                                blocked_on=arg.optional(args, "blocked_on"),
+                                no_code=arg.flag(args, "no_code")))
+def dispatch_(args: dict[str, Any]) -> str:
+    return render_dispatch(dispatch(arg.repo(args), tasks=arg.csv(args, "tasks"),
+                                    count=arg.count(args), actor=arg.optional(args, "actor"),
+                                    prefix=arg.optional(args, "prefix"),
+                                    model=arg.optional(args, "model"),
+                                    # `spawn` is NOT read, on purpose: this surface never starts a
+                                    # process. See `DispatchParams` for why.
+                                    dry_run=arg.flag(args, "dry_run")))
+def recover_(args: dict[str, Any]) -> str:
+    """`grace` of 0 means "use the default", which is what an omitted integer reads as."""
+    from ..._clock import HEARTBEAT_GRACE
+    asked = arg.count(args, "grace")
+    return render_recover(recover(arg.repo(args), actor=arg.optional(args, "actor"),
+                                  force=arg.flag(args, "force"),
+                                  grace=float(asked) or HEARTBEAT_GRACE))

taskops/transports/mcp/answers.py ADDED Viewed

@@ -0,0 +1,44 @@
+"""What a tool call returns — one record, and the one way a failure is shaped.
+The reader is a model, so this matters more than usual: `isError` tells it not to trust the
+text as an answer, and the machine code inside the text tells it what to do about it. A
+failure each call site formats its own way is a failure an agent cannot parse.
+"""
+from __future__ import annotations
+from dataclasses import dataclass
+from ..._errors import TaskopsError
+__all__ = ["Answer", "answer", "failure", "from_engine"]
+@dataclass(frozen=True, slots=True)
+class Answer:
+    """Text for the agent, and whether it is an answer or an apology."""
+    text: str
+    failed: bool = False
+def answer(text: str) -> Answer:
+    return Answer(text=text)
+def failure(message: str, code: str = "error") -> Answer:
+    """The machine-readable half travels IN the text.
+    MCP has no error field beyond the `isError` flag, and a code the agent can match on is
+    what turns "it failed" into "claim the task first".
+    """
+    return Answer(text=f"error ({code}): {message}", failed=True)
+def from_engine(err: TaskopsError) -> Answer:
+    """A typed failure, translated ONCE.
+    The taxonomy carries its own stable code, so a new error type reaches this surface
+    correctly the day it is added rather than the day somebody remembers to map it.
+    """
+    return failure(str(err), err.code)

taskops/transports/mcp/arguments.py ADDED Viewed

@@ -0,0 +1,104 @@
+"""Reading the arguments a model wrote.
+Its own module because this is where values from outside become the arguments a use case is
+called with, and every rule about that belongs where it can be read at once. The caller is
+a language model, so the rules are stricter than for a typed client: a missing key, a
+number where a string belongs, and a comma-separated list where an array was declared are
+all ordinary Tuesday traffic, and none of them may reach the engine as a crash.
+"""
+from __future__ import annotations
+import json
+from pathlib import Path
+from typing import Any, cast
+from ..._errors import BadRequest
+__all__ = ["Missing", "repo", "text", "optional", "flag", "csv", "count", "entries"]
+class Missing(BadRequest):
+    """An argument the caller left out. A subclass so one `except` covers both this and
+    an argument that was present and meaningless."""
+    code = "bad_request"
+def repo(arguments: dict[str, Any]) -> Path:
+    return Path(text(arguments, "repo_path"))
+def text(arguments: dict[str, Any], name: str) -> str:
+    value = arguments.get(name)
+    if not isinstance(value, str) or not value.strip():
+        raise Missing(f"`{name}` is required, as a non-empty string")
+    return value.strip()
+def optional(arguments: dict[str, Any], name: str) -> str:
+    """A string the caller may leave out entirely. "" means "no opinion"."""
+    value = arguments.get(name)
+    return value.strip() if isinstance(value, str) else ""
+def flag(arguments: dict[str, Any], name: str, *, default: bool = False) -> bool:
+    """Present-and-false is the only way to turn a defaulted flag off; a missing key
+    means the caller had no opinion, which is not the same thing."""
+    value = arguments.get(name)
+    return value if isinstance(value, bool) else default
+def csv(arguments: dict[str, Any], name: str) -> tuple[str, ...]:
+    """A comma-separated string, or a real list, into a tuple.
+    Both accepted because the schema says string and models send lists anyway — and a
+    `mentions` field that silently dropped a list would mean a message nobody received,
+    which is the worst possible way for this to fail.
+    """
+    value: object = arguments.get(name)
+    if isinstance(value, list):
+        items = cast("list[object]", value)
+        return tuple(str(item).strip() for item in items if str(item).strip())
+    if isinstance(value, str):
+        return tuple(part.strip() for part in value.split(",") if part.strip())
+    return ()
+def count(arguments: dict[str, Any], name: str = "count") -> int:
+    """A non-negative integer, or 0 for "no opinion".
+    `bool` is excluded explicitly: `True == 1` in Python, so `count: true` would silently mean one
+    worker. A string of digits is accepted because a model that has been told a field is a number
+    still sends "3" often enough to matter.
+    """
+    value = arguments.get(name)
+    if isinstance(value, bool):
+        return 0
+    if isinstance(value, int):
+        return max(0, value)
+    if isinstance(value, str) and value.strip().isdigit():
+        return int(value.strip())
+    return 0
+def entries(arguments: dict[str, Any]) -> list[dict[str, Any]]:
+    """The `plan` batch, however the caller packaged it.
+    FIELD HABIT: a model sends `{tasks: "<json string>"}` — learned from tools whose
+    arguments are stringly typed — and it would fail as a missing list. A single task sent
+    unwrapped is accepted for the same reason: the caller said what it wanted, and
+    rejecting it over a bracket teaches it nothing about the real requirement.
+    """
+    found: object = arguments.get("tasks")
+    if isinstance(found, str) and found.strip():
+        try:
+            found = json.loads(found)
+        except json.JSONDecodeError as bad:
+            raise Missing(f"`tasks` is a string that is not JSON: {bad}") from bad
+    if isinstance(found, dict):
+        found = [cast("object", found)]
+    if isinstance(found, list) and found:
+        items = cast("list[object]", found)
+        return [cast("dict[str, Any]", item) for item in items if isinstance(item, dict)]
+    raise Missing("`tasks` is required — a non-empty list of {title, spec, after?}")

taskops/transports/mcp/dispatch.py ADDED Viewed

@@ -0,0 +1,47 @@
+"""One tool call -> the text the agent reads. A TABLE, never a chain of ifs.
+The handlers live in `_reads` and `_writes`, split by what they DO rather than by tool count: one
+group answers questions and changes nothing, the other enters a use case that enforces a rule. What is
+left here is the routing and the ONE place a typed engine failure becomes a sentence an agent can act
+on — which is the whole reason the CLI, MCP and HTTP surfaces cannot drift apart.
+"""
+from __future__ import annotations
+from typing import Any, Callable
+from ..._errors import TaskopsError
+from . import _reads as read
+from . import _writes as write
+from .answers import Answer, answer, failure, from_engine
+__all__ = ["call_tool", "HANDLERS"]
+Handler = Callable[[dict[str, Any]], str]
+HANDLERS: dict[str, Handler] = {
+    "taskops_next": write.next_,
+    "taskops_update": write.update_,
+    "taskops_ask": read.ask_,
+    "taskops_plan": write.plan_,
+    "taskops_dispatch": write.dispatch_,
+    "taskops_recover": write.recover_,
+    "taskops_report": read.report_,
+}
+def call_tool(name: str, args: dict[str, Any]) -> Answer:
+    """Never raises for a failure anyone should expect.
+    An unknown tool, an argument the model left out, an uninitialised project and a lost race for a
+    lease are all ordinary traffic here, and each one is worth a sentence the agent can act on rather
+    than a traceback the host swallows.
+    """
+    handler = HANDLERS.get(name)
+    if handler is None:
+        return failure(f"no tool named {name} — taskops serves "
+                       f"{', '.join(sorted(HANDLERS))}", "unknown_tool")
+    try:
+        return answer(handler(args))
+    except TaskopsError as err:
+        return from_engine(err)