From 8c35312cc634fac75ea18a2ac1b839147597b249 Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Wed, 28 Oct 2026 10:16:57 -0700 Subject: [PATCH 1/5] docs(claim-table): mark the W1b first-touch lines WALKED Marks the lines Lily kept as WALKED with W1b, 2026-10-27: the README line "Create an account and a pod, then press Run it here" (new row), quickstart steps 1-3 and the quickstart DeepSeek line. Steps 2 and 3 are new rows; the cut card rows stay CUT. Fixes the runtime-token row's pointer to agentRuntimeAuth.ts:51, where the cm_agent_ check is. Leaves the quickstart limits row TRUE until the owner says whether W1b covered that text. Co-Authored-By: Claude Haiku 5.5 Co-authored-by: wren Agent-Model: claude/claude-haiku-5-5/max --- docs/audits/claim-table.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/audits/claim-table.md b/docs/audits/claim-table.md index 0836beb829..3f48bbd7d6 100644 --- a/docs/audits/claim-table.md +++ b/docs/audits/claim-table.md @@ -36,6 +36,7 @@ Owner: TASK-010. Source: `README.md`. | README | Agents claim work on the pod's board and post what they tried (L36) | TRUE | backend/routes/tasksApi.ts:616 (`POST /:podId/:taskId/claim`); backend/routes/tasksApi.ts:809 (`POST /:podId/:taskId/updates`) | 2026-10-26 | | README | Activity shows what needs you across every pod (L38) | TRUE | frontend/src/i18n/locales/en.json:160 ("what needs you, then what moved"), :175 ("All pods" filter), :811 ("Every open question, from every pod, lands in one place") | 2026-10-25 | | README | On commonly.me, with nothing to install (L60) | TRUE | Takes the verdict of the hosted-agent row above (en.json:619, V2AgentBYO.tsx:137). | 2026-10-26 | +| README | Create an account and a pod, then press "Run it here" (L54) | WALKED | W1b, 2026-10-27 | 2026-10-27 | | README | Sign up with GitHub, Google or email (L62) | CUT | backend/controllers/authController.ts:615–625 (`registrationOpen`); backend/routes/auth.ts:237 (`/registration-policy`); live `https://api.commonly.me/api/auth/registration-policy` on 10-25 returned `inviteOnly:false, registrationOpen:true`. Invite-only is the production default when `REGISTRATION_INVITE_ONLY` is unset (authController.ts:36–40), so this depends on that env var being off. Providers: frontend/src/i18n/locales/en.json:116–117, :380 (Google, GitHub). Removed in this PR: not walked in time, cut by Lily's ruling (10-28 05:50Z). | 2026-10-28 | | README | Install the CLI with `npm i -g @commonlyai/cli@latest` (L71) | TRUE | cli/package.json:2 (name), :9 (bin `commonly`) | 2026-10-25 | | README | `commonly agent run --adapter claude` (L74) | TRUE | cli/src/commands/agent.js:295 (`agent run --adapter`), :361 | 2026-10-25 | @@ -64,16 +65,18 @@ Owner: TASK-011. Source: `docs-site/quickstart.mdx` and `docs-site/introduction. | Page | Claim | Verdict | Evidence | Date | |---|---|---|---|---| -| quickstart | Create an account at commonly.me/v2/register | TRUE | `frontend/src/v2/V2App.tsx:215` (`register` route) | 2026-10-26 | +| quickstart | Create an account at commonly.me/v2/register | WALKED | W1b, 2026-10-27. `frontend/src/v2/V2App.tsx:215` (`register` route) | 2026-10-27 | +| quickstart | Create a pod | WALKED | W1b, 2026-10-27 | 2026-10-27 | | quickstart | Create a pod; it opens with a "Your pod is ready" card | CUT | `frontend/src/i18n/locales/en.json:617` (`newPod.title`), rendered by `V2ThreadStarter.tsx`. GTM walk with 390 and 1440 shots still owed Removed in this PR: not walked in time, cut by Lily's ruling (10-28 05:50Z). | 2026-10-28 | | quickstart | On that card, "Run it here" starts a hosted agent | CUT | `en.json:619` (`runHere`); starter states "Adding agent…", "Starting agent…", "Agent running" at `en.json:622-624`. Timing (about 8 s) is not on the page and needs a walk Removed in this PR: not walked in time, cut by Lily's ruling (10-28 05:50Z). | 2026-10-28 | +| quickstart | Choose "Run it here" | WALKED | W1b, 2026-10-27 | 2026-10-27 | | quickstart | Type `@` in the pod's message box to pick the agent | CUT | `en.json:612` ("Use @ to mention an agent or teammate") Removed in this PR: not walked in time, cut by Lily's ruling (10-28 05:50Z). | 2026-10-28 | -| quickstart | Commonly runs a hosted agent on DeepSeek V4 Flash | TRUE | `backend/services/nativeRuntimeService.ts:101` (`DEFAULT_MODEL`), `:224` (display name). Overridable by `LITELLM_CHAT_MODEL`, so re-check on prod | 2026-10-26 | +| quickstart | Commonly runs a hosted agent on DeepSeek V4 Flash | WALKED | W1b, 2026-10-27. `backend/services/nativeRuntimeService.ts:101` (`DEFAULT_MODEL`), `:224` (display name). Overridable by `LITELLM_CHAT_MODEL`, so re-check on prod | 2026-10-27 | | quickstart | The Run it here setup shows the free plan's agent and daily turn limits | TRUE | `frontend/src/v2/components/V2AgentBYO.tsx:1136-1139` renders `hosting.caps.turnsPerDay`; caps from `backend/services/hostedRuntimeService.ts:55-60`. No numbers are stated on the page | 2026-10-26 | | quickstart | "About a minute" (frontmatter description) | CUT | No walk of the full sign-up-to-answer time. Removed from the description | 2026-10-26 | | quickstart | Links: `/bring-your-own/`, `/bring-your-own/claude-code`, `/codex`, `/work-in-your-repo`, `/concepts/pods` | TRUE | Targets exist: `docs-site/bring-your-own/*.mdx`, `docs-site/concepts/pods.mdx` | 2026-10-26 | | introduction | Commonly can host an agent for you ("Run it here") | TRUE | `en.json:1621` (`hosted`: "Run it here") | 2026-10-26 | -| introduction | Agents run on your own machine and connect with a runtime token | TRUE | `backend/middleware/agentRuntimeAuth.ts:52` (`cm_agent_` token); `cli/src/index.js:62` (`commonly agent attach`) | 2026-10-26 | +| introduction | Agents run on your own machine and connect with a runtime token | TRUE | `backend/middleware/agentRuntimeAuth.ts:51` (`cm_agent_` token); `cli/src/index.js:62` (`commonly agent attach`) | 2026-10-26 | | introduction | A pod holds conversation, files, tasks and context | TRUE | Conversation: `backend/models/Message.ts:43` (`podId`). Files: `backend/models/PodAsset.ts:40` (`podId`). Tasks: `backend/routes/tasksApi.ts:226-253` (`GET /:podId` filters `Task.find` by `podId`; mounted at `backend/server.ts:257`). Context: `backend/routes/contextApi.ts:80-91` (`/context/:podId`) | 2026-10-26 | | introduction | Each agent keeps its own identity and memory | TRUE | Agent memory routes: `backend/routes/agentMemoryView.ts`, `backend/routes/agentProfile.ts` | 2026-10-26 | | introduction | Request a seat via Agents → Bring your own agent → On my computer, then pick the computer and seat | CUT | `en.json:70` ("Agents"), `:1510` ("Bring your own agent"), `:1630` ("On my computer"). The click path needs a walk Removed in this PR: not walked in time, cut by Lily's ruling (10-28 05:50Z). | 2026-10-28 | From ecde9b168c10eca6a75a97bf17dce88c83306e9b Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Wed, 28 Oct 2026 10:44:50 -0700 Subject: [PATCH 2/5] docs(claim-table): cite G2 for signup, TRUE by code elsewhere The W1b walk's 390 and 1440 files are not available. G2 (101083, 2026-10-28) covers signup, the auto-created pod, the hosted reply and the invite. It does not cover pressing "Run it here", the create-pod step or the model name, so those rows cite code on main. The DeepSeek row returns to main's text. Co-Authored-By: Claude Haiku 5.5 Co-authored-by: wren Agent-Model: claude/claude-haiku-5-5/max --- docs/audits/claim-table.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/audits/claim-table.md b/docs/audits/claim-table.md index 3f48bbd7d6..f12bb2035a 100644 --- a/docs/audits/claim-table.md +++ b/docs/audits/claim-table.md @@ -36,7 +36,7 @@ Owner: TASK-010. Source: `README.md`. | README | Agents claim work on the pod's board and post what they tried (L36) | TRUE | backend/routes/tasksApi.ts:616 (`POST /:podId/:taskId/claim`); backend/routes/tasksApi.ts:809 (`POST /:podId/:taskId/updates`) | 2026-10-26 | | README | Activity shows what needs you across every pod (L38) | TRUE | frontend/src/i18n/locales/en.json:160 ("what needs you, then what moved"), :175 ("All pods" filter), :811 ("Every open question, from every pod, lands in one place") | 2026-10-25 | | README | On commonly.me, with nothing to install (L60) | TRUE | Takes the verdict of the hosted-agent row above (en.json:619, V2AgentBYO.tsx:137). | 2026-10-26 | -| README | Create an account and a pod, then press "Run it here" (L54) | WALKED | W1b, 2026-10-27 | 2026-10-27 | +| README | Create an account and a pod, then press "Run it here" (L54) | TRUE | `backend/controllers/authController.ts:365–368` (signup creates the "My Workspace" pod); `frontend/src/v2/components/V2ThreadStarter.tsx:63` (the "Run it here" button, `podChat.newPod.runHere`) | 2026-10-28 | | README | Sign up with GitHub, Google or email (L62) | CUT | backend/controllers/authController.ts:615–625 (`registrationOpen`); backend/routes/auth.ts:237 (`/registration-policy`); live `https://api.commonly.me/api/auth/registration-policy` on 10-25 returned `inviteOnly:false, registrationOpen:true`. Invite-only is the production default when `REGISTRATION_INVITE_ONLY` is unset (authController.ts:36–40), so this depends on that env var being off. Providers: frontend/src/i18n/locales/en.json:116–117, :380 (Google, GitHub). Removed in this PR: not walked in time, cut by Lily's ruling (10-28 05:50Z). | 2026-10-28 | | README | Install the CLI with `npm i -g @commonlyai/cli@latest` (L71) | TRUE | cli/package.json:2 (name), :9 (bin `commonly`) | 2026-10-25 | | README | `commonly agent run --adapter claude` (L74) | TRUE | cli/src/commands/agent.js:295 (`agent run --adapter`), :361 | 2026-10-25 | @@ -65,13 +65,13 @@ Owner: TASK-011. Source: `docs-site/quickstart.mdx` and `docs-site/introduction. | Page | Claim | Verdict | Evidence | Date | |---|---|---|---|---| -| quickstart | Create an account at commonly.me/v2/register | WALKED | W1b, 2026-10-27. `frontend/src/v2/V2App.tsx:215` (`register` route) | 2026-10-27 | -| quickstart | Create a pod | WALKED | W1b, 2026-10-27 | 2026-10-27 | +| quickstart | Create an account at commonly.me/v2/register | WALKED | G2 walk 101083, 2026-10-28. `frontend/src/v2/V2App.tsx:215` (`register` route, under `/v2/*` at `frontend/src/App.tsx:315`) | 2026-10-28 | +| quickstart | Create a pod | TRUE | `frontend/src/v2/components/V2PodsSidebar.tsx:307–314` (`handleCreatePod` calls `createPod`). Signup also creates "My Workspace" (`backend/controllers/authController.ts:368`) | 2026-10-28 | | quickstart | Create a pod; it opens with a "Your pod is ready" card | CUT | `frontend/src/i18n/locales/en.json:617` (`newPod.title`), rendered by `V2ThreadStarter.tsx`. GTM walk with 390 and 1440 shots still owed Removed in this PR: not walked in time, cut by Lily's ruling (10-28 05:50Z). | 2026-10-28 | | quickstart | On that card, "Run it here" starts a hosted agent | CUT | `en.json:619` (`runHere`); starter states "Adding agent…", "Starting agent…", "Agent running" at `en.json:622-624`. Timing (about 8 s) is not on the page and needs a walk Removed in this PR: not walked in time, cut by Lily's ruling (10-28 05:50Z). | 2026-10-28 | -| quickstart | Choose "Run it here" | WALKED | W1b, 2026-10-27 | 2026-10-27 | +| quickstart | Choose "Run it here" | TRUE | `frontend/src/v2/components/V2ThreadStarter.tsx:63` (`podChat.newPod.runHere`), `frontend/src/v2/components/V2AgentBYO.tsx:1052` (`agentByo.actions.runHere`); `frontend/src/i18n/locales/en.json:622` | 2026-10-28 | | quickstart | Type `@` in the pod's message box to pick the agent | CUT | `en.json:612` ("Use @ to mention an agent or teammate") Removed in this PR: not walked in time, cut by Lily's ruling (10-28 05:50Z). | 2026-10-28 | -| quickstart | Commonly runs a hosted agent on DeepSeek V4 Flash | WALKED | W1b, 2026-10-27. `backend/services/nativeRuntimeService.ts:101` (`DEFAULT_MODEL`), `:224` (display name). Overridable by `LITELLM_CHAT_MODEL`, so re-check on prod | 2026-10-27 | +| quickstart | Commonly runs a hosted agent on DeepSeek V4 Flash | TRUE | `backend/services/nativeRuntimeService.ts:101` (`DEFAULT_MODEL`), `:224` (display name). Overridable by `LITELLM_CHAT_MODEL`, so re-check on prod | 2026-10-26 | | quickstart | The Run it here setup shows the free plan's agent and daily turn limits | TRUE | `frontend/src/v2/components/V2AgentBYO.tsx:1136-1139` renders `hosting.caps.turnsPerDay`; caps from `backend/services/hostedRuntimeService.ts:55-60`. No numbers are stated on the page | 2026-10-26 | | quickstart | "About a minute" (frontmatter description) | CUT | No walk of the full sign-up-to-answer time. Removed from the description | 2026-10-26 | | quickstart | Links: `/bring-your-own/`, `/bring-your-own/claude-code`, `/codex`, `/work-in-your-repo`, `/concepts/pods` | TRUE | Targets exist: `docs-site/bring-your-own/*.mdx`, `docs-site/concepts/pods.mdx` | 2026-10-26 | From fd9e20d58855197e312e1066e175e80e110d3d79 Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Wed, 28 Oct 2026 10:45:53 -0700 Subject: [PATCH 3/5] docs(claim-table): row 68 reads TRUE; walked G2 (101083, 2026-10-28) walked the signup path without screenshots, so the verdict is TRUE with the walk as walked evidence. WALKED alone needs a 390 and a 1440 screenshot under the legend, which this walk does not have. Co-Authored-By: Claude Haiku 5.5 Co-authored-by: wren Agent-Model: claude/claude-haiku-5-5/max --- docs/audits/claim-table.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/audits/claim-table.md b/docs/audits/claim-table.md index f12bb2035a..8cbf08a301 100644 --- a/docs/audits/claim-table.md +++ b/docs/audits/claim-table.md @@ -65,7 +65,7 @@ Owner: TASK-011. Source: `docs-site/quickstart.mdx` and `docs-site/introduction. | Page | Claim | Verdict | Evidence | Date | |---|---|---|---|---| -| quickstart | Create an account at commonly.me/v2/register | WALKED | G2 walk 101083, 2026-10-28. `frontend/src/v2/V2App.tsx:215` (`register` route, under `/v2/*` at `frontend/src/App.tsx:315`) | 2026-10-28 | +| quickstart | Create an account at commonly.me/v2/register | TRUE; walked | G2 walk 101083, 2026-10-28. `frontend/src/v2/V2App.tsx:215` (`register` route, under `/v2/*` at `frontend/src/App.tsx:315`) | 2026-10-28 | | quickstart | Create a pod | TRUE | `frontend/src/v2/components/V2PodsSidebar.tsx:307–314` (`handleCreatePod` calls `createPod`). Signup also creates "My Workspace" (`backend/controllers/authController.ts:368`) | 2026-10-28 | | quickstart | Create a pod; it opens with a "Your pod is ready" card | CUT | `frontend/src/i18n/locales/en.json:617` (`newPod.title`), rendered by `V2ThreadStarter.tsx`. GTM walk with 390 and 1440 shots still owed Removed in this PR: not walked in time, cut by Lily's ruling (10-28 05:50Z). | 2026-10-28 | | quickstart | On that card, "Run it here" starts a hosted agent | CUT | `en.json:619` (`runHere`); starter states "Adding agent…", "Starting agent…", "Agent running" at `en.json:622-624`. Timing (about 8 s) is not on the page and needs a walk Removed in this PR: not walked in time, cut by Lily's ruling (10-28 05:50Z). | 2026-10-28 | From 4ee97ddc3793fca79028c4a9590b67c4c264678f Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Wed, 28 Oct 2026 10:51:32 -0700 Subject: [PATCH 4/5] docs(claim-table): define TRUE; walked in the legend Row 68 carries TRUE; walked, but the legend defined only WALKED, and WALKED requires a 390 and a 1440 screenshot. The new form takes a file:line plus a walk cited by ID and date, with no screenshots. Co-Authored-By: Claude Haiku 5.5 Co-authored-by: wren Agent-Model: claude/claude-haiku-5-5/max --- docs/audits/claim-table.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/audits/claim-table.md b/docs/audits/claim-table.md index 8cbf08a301..7348338207 100644 --- a/docs/audits/claim-table.md +++ b/docs/audits/claim-table.md @@ -1,7 +1,8 @@ # Docs claim table One row per factual claim on a customer-facing page, each with one verdict and its evidence. Evidence is a walk on -prod with a 390 and a 1440 screenshot, or a `file:line` on `main`. It is no older than 14 days. A +prod with a 390 and a 1440 screenshot, or a `file:line` on `main`. A `TRUE; walked` row carries a +`file:line` and a walk cited by ID and date, with no screenshots. It is no older than 14 days. A claim past 14 days is re-walked in the next release batch, or it comes out. The first-touch pages (quickstart, bring your own agent, connectors, self-host, pricing) are re-walked every week. @@ -11,6 +12,8 @@ claim past 14 days is re-walked in the next release batch, or it comes out. The 1440 screenshot. - **TRUE**: code on `main` does what the claim says. The evidence is a `file:line` on `main`, not another doc. +- **TRUE; walked**: the `file:line` on `main` is the evidence, and a walk on commonly.me by someone + who did not write the claim is cited by walk ID and date. Screenshots are required only for WALKED. - **STALE**: the feature or fact is gone. The same PR removes the claim. - **FALSE**: the claim is wrong. The same PR fixes it or removes it. - **CUT**: the claim was not walked in time. The same PR removes it, and it can come back with From 2ab220b01fc39fbb6f9bed839afe1c73ba2fbdf6 Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Wed, 28 Oct 2026 11:47:52 -0700 Subject: [PATCH 5/5] docs(claim-table): cite the free-plan limits at :57-61 and the Run it here line The row cited hostedRuntimeService.ts:55-60, which misses the free-plan turns cap at :61. Its frontend cite was the mode-card hint, which shows turns only; it now cites the line under the Run it here button that shows agents and turns. Co-Authored-By: Claude Haiku 5.5 Co-authored-by: wren Agent-Model: claude/claude-haiku-5-5/max --- docs/audits/claim-table.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/audits/claim-table.md b/docs/audits/claim-table.md index 7348338207..38b3448f6e 100644 --- a/docs/audits/claim-table.md +++ b/docs/audits/claim-table.md @@ -75,7 +75,7 @@ Owner: TASK-011. Source: `docs-site/quickstart.mdx` and `docs-site/introduction. | quickstart | Choose "Run it here" | TRUE | `frontend/src/v2/components/V2ThreadStarter.tsx:63` (`podChat.newPod.runHere`), `frontend/src/v2/components/V2AgentBYO.tsx:1052` (`agentByo.actions.runHere`); `frontend/src/i18n/locales/en.json:622` | 2026-10-28 | | quickstart | Type `@` in the pod's message box to pick the agent | CUT | `en.json:612` ("Use @ to mention an agent or teammate") Removed in this PR: not walked in time, cut by Lily's ruling (10-28 05:50Z). | 2026-10-28 | | quickstart | Commonly runs a hosted agent on DeepSeek V4 Flash | TRUE | `backend/services/nativeRuntimeService.ts:101` (`DEFAULT_MODEL`), `:224` (display name). Overridable by `LITELLM_CHAT_MODEL`, so re-check on prod | 2026-10-26 | -| quickstart | The Run it here setup shows the free plan's agent and daily turn limits | TRUE | `frontend/src/v2/components/V2AgentBYO.tsx:1136-1139` renders `hosting.caps.turnsPerDay`; caps from `backend/services/hostedRuntimeService.ts:55-60`. No numbers are stated on the page | 2026-10-26 | +| quickstart | The Run it here setup shows the free plan's agent and daily turn limits | TRUE | `frontend/src/v2/components/V2AgentBYO.tsx:1054-1057` renders `hosting.caps.agentsPerUser` and `hosting.caps.turnsPerDay` directly under the Run it here button; caps from `backend/services/hostedRuntimeService.ts:57-61`. No numbers are stated on the page | 2026-10-28 | | quickstart | "About a minute" (frontmatter description) | CUT | No walk of the full sign-up-to-answer time. Removed from the description | 2026-10-26 | | quickstart | Links: `/bring-your-own/`, `/bring-your-own/claude-code`, `/codex`, `/work-in-your-repo`, `/concepts/pods` | TRUE | Targets exist: `docs-site/bring-your-own/*.mdx`, `docs-site/concepts/pods.mdx` | 2026-10-26 | | introduction | Commonly can host an agent for you ("Run it here") | TRUE | `en.json:1621` (`hosted`: "Run it here") | 2026-10-26 |