toga-ai 1.0.981 → 1.0.983

package/knowledge/2.0/apps/worker2/INDEX.md

@@ -72,4 +72,4 @@
 | [PHP Runtime Upgrade on Elastic Beanstalk (worker2 8.3 → 8.5 + PhpSpreadsheet 1.x → 3.x)](workflows/php-runtime-upgrade-dependency-audit.md) | Reusable checklist for moving a TOGA repo across an EB PHP runtime jump (worker2 8.3 → 8.5 + PhpSpreadsheet 1.x → 3.x); open before any runtime bump or when a c |
 | [Running worker2 locally against real NetSuite (and what EB does instead)](workflows/running-worker2-locally.md) | Boot worker2 on a dev machine to run a real worker action against live NetSuite + a local Forecast DB; open when local boot fails or before any local NetSuite r |
 | [Repointing the Sprint Tooling at a New ClickUp Sprints Folder (+ table reset)](workflows/sprint-clickup-folder-repoint.md) | Move worker2's sprint tooling onto a new ClickUp "True Dev Sprints" folder and reset the Team sprint tables; open when the sprints folder id changes. |
-| [Ticket → ClickUp Pseudocode Planning (Talos-grounded)](workflows/ticket-to-pseudocode-planning.md) | Procedure to turn a ClickUp ticket into a reviewed, formatted plan posted to its `📝 Pseudocode` field (ClickUp + codebase + Talos); open when planning a ticket |
+| [Ticket → ClickUp Pseudocode Planning (Talos-grounded)](workflows/ticket-to-pseudocode-planning.md) | Retired procedure (`/plan-ticket` + `/work-ticket`) that planned a ClickUp ticket into its `📝 Pseudocode` field; open only for history. |

package/knowledge/2.0/apps/worker2/features/clickup-github-autolink.md

@@ -30,8 +30,15 @@ How ClickUp surfaces branches/PRs/commits in a ticket's GitHub tab and the branc
 
 - **Bare ticket-id branch name is now the git-workflow rule** (`rules/common/git-workflow.md`, 2026-10-08) — a `feature/…` prefix breaks ClickUp's native auto-link, which matches on the bare ticket id. Confirmed against live repos already on `TRUE-79142` (worker) and `TRUE-77219` (api2).
 
+- **If PRs stop linking, the integration was disconnected** (it was, until 2026-10-08). Fix:
+  1. ClickUp → Settings → App Center → GitHub → Reconnect (authorize as the `agilantgit` GitHub account; workspace-level).
+  2. GitHub Settings → "Connect Repositories to Spaces": add each repo AND link it to the **Development** space. A repo not linked to that space never links its PRs.
+  3. Repos added 2026-10-08: worker2, dbchanges2, toga25-desk, toga25-iq, toga25-blox, toga25-supply, toga2-commerce, toga2-supply, toga2-template, toga-blox-npm, saml, forward, apiproxy (`test` and `claude` skipped). A PR titled with the ticket id then linked automatically (verified).
+- **Settings:** leave "auto-generated branch name" as `:taskId:`. Do not turn on "Update Task Status from GitHub" — worker2 owns status automation.
+
 ## Change history
 
+- 2026-10-08 — Added reconnect fix, Development-space repo linking, and settings to leave alone. (jcardinal)
 - 2026-10-08 — `/work-ticket` and `/plan-ticket` retired; `/finish` opens the PRs. PR title = ticket id first; base = repo default branch; git-workflow now uses bare ticket-id branches. (jcardinal)
 
 ## Related

package/knowledge/standalone/apps/claude/workflows/clickup-ticket-workflow.md

@@ -74,7 +74,7 @@ Write values are strings: drop_down = option uuid; labels = JSON array string of
 
 1. `claude mcp add --scope user --transport http clickup https://mcp.clickup.com/mcp`
 2. In Claude Code, run `/mcp` and sign in to `clickup`.
-3. `gh auth login` (needed by `/finish` for PRs).
+3. `gh auth login` (needed by `/finish` for PRs; `gh` is often installed but not logged in).
 4. `npx toga-ai` in the workspace (installs the skills, the hook, and the settings).
 
 ## Gotchas
@@ -87,8 +87,11 @@ All tested 2026-10-08:
   headings, numbered steps, indented sub-points, no markdown symbols (no #, *, backticks, or _).
 - **The MCP cannot add a new option** to a labels or drop_down field. A truly new value: the
   developer adds it in ClickUp under that field, then Claude sets it.
-- **`clickup_get_task` with custom fields returns ~90k characters** (every field carries its
-  full option list). Only the `ticket-reader` agent does that read. Drop_down values come back
+- **`clickup_get_task` with custom fields returns ~76k characters** (every field carries its
+  full option list). Claude Code then replaces the tool result with "Output has been saved to
+  <file>". So the `ticket-reader` does a small read first, and `start-gate` reads the saved file
+  only from `~/.claude/projects/*/tool-results/`. Debug: env `TOGA_START_GATE_DEBUG=1` writes
+  `gate-debug.log` in the sessions dir. Only the `ticket-reader` agent does the full read. Drop_down values come back
   as an orderindex — map them through `type_config.options`.
 - **Done status is `development finished`** (lowercase; valid on the Dev Sprints lists).
 - **The ClickUp GitHub integration works:** a PR whose title starts with the ticket id auto-links.
@@ -108,6 +111,11 @@ All tested 2026-10-08:
   now?"; yes = it runs the `/commit` steps itself, then continues; no = stop. `gh` not logged in
   → "Run `gh auth login` in a terminal, then tell me 'done'", then re-check `gh auth status`.
 
+- **The PR summary comment comes from a GitHub Action:** `.github/workflows/pr-summary.yml` +
+  `ci/pr-review/`, built from the `/commit` notes. Re-run it with the `re-review` label. Setup:
+  `ci/pr-review/SETUP.md`. Still pending: CODEOWNERS, the protected `pr-summary-v1` tag, and the
+  caller file in each app repo.
+
 ## Change history
 
 - 2026-10-08 — Created: ClickUp-tied sessions (`/start`, `/commit`, `/pseudocode`, `/finish`)
@@ -117,6 +125,7 @@ All tested 2026-10-08:
 - 2026-10-08 — Claude posts the PM comment and writes PR/commit/KB summaries without asking
   for approval; `clickup_create_comment` removed from permissions.ask. Field changes and
   pushes still ask. (jcardinal)
+- 2026-10-08 — Added big-read/saved-file behavior, `gh auth login` note, and PR summary Action. (jcardinal)
 
 ## Related
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toga-ai",
-  "version": "1.0.981",
+  "version": "1.0.983",
   "description": "TOGA Technology Team Claude Knowledge System — shared AI coding harness with skills, knowledge base CLI, and project installer for Claude Code.",
   "keywords": [
     "claude",