tspl-cli 0.1.3 → 0.1.5

package/README.md

@@ -28,7 +28,7 @@ npm i -g tspl-cli → tspl setup → tspl init → tspl task new "…" → tspl
 
 ## Requirements
 
-- **Node 22 or newer** (`node --version`)
+- **Node 20 or newer** (`node --version`)
 - **git**
 - **A TSPL account.** Ask your organization's owner or admin to add you. You get a temporary password and choose your own at the first login.
 - **An AI tool** you are signed in to with your own subscription: Claude Code, Codex CLI, Gemini CLI, Antigravity, Cursor or VS Code Copilot
@@ -129,7 +129,7 @@ tspl init
 `tspl init` does the following:
 
 1. **Links the folder to a TSPL project.** It recognizes your repositories by their git history, so folder names and git hosts don't matter. If the project doesn't exist yet, it offers to create it (owner, admin or PM only). If it finds new repositories, it offers to add them.
-2. **Finds your checks.** It reads your package scripts, without running them, and asks you to confirm which ones are the real **test**, **lint**, **typecheck** and **build** commands, and which are required.
+2. **Finds your checks.** It reads your package scripts, without running them, and asks you to confirm which ones are the real **test**, **lint**, **typecheck** and **build** commands, and which are required. A test check is optional: without one, each done-when item is checked by a person (`tspl task verify`), or you finish the task with `tspl task done`.
 3. **Asks about pull requests:** the GitHub repository, the target branch and the CI policy.
 4. **Offers browser tests.** For web apps without browser tests, it offers to set up Playwright. Skip this with `--no-e2e`.
 5. **Saves the shared project files** in `.tspl/`.
@@ -326,11 +326,14 @@ tspl build push t-xxxx    # push the branch of every repo on the plan
 ```bash
 tspl build stop t-xxxx                  # stop and lift the edit lock (branches are kept)
 tspl plan amend t-xxxx                  # cancel the stopped run so a new plan version can be made
+tspl task done t-xxxx --note "tested by hand on staging"   # mark it done yourself
 tspl task delete t-xxxx --reason "duplicate"
 ```
 
 Use `stop` and `amend` only when the plan really has to change, not for every failure. A new plan version needs new approvals.
 
+`tspl task done` finishes an approved task by hand, even if checks, tests, review or the pull request did not run. Any contributor can use it; a note is required. The task history keeps who marked it done, the note, and what was still open; the console shows the skipped steps as skipped. Stop a running build first (`tspl build stop`).
+
 ### Build by hand instead of `task run`
 
 ```bash
@@ -435,6 +438,7 @@ The steps are `plan`, `build`, `verify` and `bulk`. The engines are `claude`, `c
 | `tspl task choose` | choose an approach before planning |
 | `tspl task run` / `watch` / `status` | build a task, follow it, see where it is |
 | `tspl task verify` | record a check you did by hand |
+| `tspl task done` | mark an approved task done by hand, with a note |
 | `tspl plan list` / `show` / `approve` / `reject` / `amend` | review and decide on plans |
 | `tspl build start` / `status` / `check` / `push` / `stop` | manual build commands |
 | `tspl member ...` | people and roles |
@@ -469,7 +473,7 @@ tspl task run --help
 | `You are logged in to …, not …` | run `tspl login --api https://aitool-api.techivies.com` |
 | Login expired | run `tspl login` |
 | Forgot your password | run `tspl forgot-password --email you@company.com` |
-| `tspl needs Node 22 or newer` | install Node 22+ from https://nodejs.org, then reinstall tspl |
+| `tspl needs Node 20 or newer` | install Node 20+ from https://nodejs.org, then reinstall tspl |
 | `/tspl` doesn't show in your AI tool | run `tspl connect <tool>` and restart the tool |
 | `plan approve` refuses to run | run it in a normal terminal, not inside an AI tool |
 | Build won't start: uncommitted changes | commit or stash your work, then run again |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tspl-cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "TSPL command-line tool: learns your code, plans changes with you, builds, tests and opens pull requests",
   "keywords": [
     "tspl",
@@ -27,13 +27,13 @@
     "README.md"
   ],
   "engines": {
-    "node": ">=22"
+    "node": ">=20"
   },
   "dependencies": {
     "@babel/parser": "^7.29.9",
-    "@inquirer/prompts": "^8.7.2",
+    "@inquirer/prompts": "^7.10.1",
     "@modelcontextprotocol/sdk": "^1.31.0",
-    "commander": "^15.0.0",
+    "commander": "^14.0.3",
     "zod": "^4.6.5"
   },
   "scripts": {},

package/src/commands/task.command.js

@@ -365,6 +365,21 @@ const verify = async (id, options) => {
   console.log(`Recorded: done-when ${criterion} checked by you on ${workflow.heads.map(head => `${head.name}@${String(head.headSha).slice(0, 7)}`).join(', ')}. Continue: tspl task run ${id}`)
 }
 
+const markDone = async (id, options) => {
+  const { project } = await findProject(process.cwd())
+  const task = await request('GET', taskUrl(project._id, id))
+  const open = task.workflow ? `stage ${task.workflow.stage}` : `status ${task.status}`
+  if (!options.yes && !(await confirm({ message: `Mark ${id} done by hand (now ${open})? Checks that did not run stay recorded as skipped.`, default: false }))) {
+    console.log('Nothing changed.')
+    return
+  }
+  const { task: done, workflow } = await request('POST', `${taskUrl(project._id, id)}/workflow/done`, { note: options.note })
+  require('../workflow/runtime').finishLocal(id)
+  const problems = (workflow && workflow.manualCompletion && workflow.manualCompletion.problems) || []
+  console.log(`${id} is ${done.status}, marked by you: "${options.note}".`)
+  if (problems.length) console.log(`Still open when it was marked done (kept in the task history):\n${problems.map(item => `  - ${item}`).join('\n')}`)
+}
+
 const remove = async (id, options) => {
   const { project } = await findProject(process.cwd())
   if (!options.yes && !(await confirm({ message: `Delete task ${id} for everyone? It disappears from the console and from every list.`, default: false }))) {
@@ -465,6 +480,12 @@ module.exports = {
       .option('--note <text>', 'what you looked at')
       .option('--file <paths...>', 'screenshots or a screen recording that show it (png, jpg, webp, webm, mp4)')
       .action(verify)
+    task
+      .command('done <task>')
+      .description('Mark an approved task done by hand, even if checks, tests or delivery did not run (kept in its history with your note)')
+      .requiredOption('--note <text>', 'why it is done, e.g. "tested by hand on staging"')
+      .option('-y, --yes', 'do not ask to confirm')
+      .action(markDone)
     task
       .command('scope <task>')
       .description('Confirm a task scope as PM, or send it back with --back --note "…"')

package/src/project-init.js

@@ -219,7 +219,7 @@ const readiness = (config, localPaths) => {
   const problems = []
   const warnings = []
   if (!config.checks.some(check => check.required && TEST_CATEGORIES.includes(check.category))) {
-    problems.push('No required test check is configured. Add one to .tspl/project.json (category unit, integration or e2e); a tested PR needs it.')
+    warnings.push('No required test check is configured: done-when items without a runnable test need a person (tspl task verify), or finish with tspl task done.')
   }
   config.repos.forEach(repo => {
     if (!localPaths.has(repo.name)) problems.push(`Repo ${repo.name} is not cloned on this machine.`)

package/src/runtime-check.js

@@ -1,6 +1,6 @@
 'use strict'
 
-const MIN_NODE_MAJOR = 22
+const MIN_NODE_MAJOR = 20
 
 const nodeVersion = () => process.env.TSPL_TEST_NODE_VERSION || process.versions.node
 

package/src/shared/workflow-progress.js

@@ -11,8 +11,14 @@ const workflowProgress = (task, at = new Date()) => {
   if (!wf) return null
   const current = effectiveStage(wf), position = wf.stage === 'ready' ? STAGES.length : STAGES.indexOf(current)
   const options = task.plan?.workflow?.options || {}
+  const manual = wf.stage === 'ready' && wf.manualCompletion
   const steps = STAGES.map((stage, i) => {
     const saved = wf.stageResults?.[stage] || {}
+    if (manual) {
+      const done = saved.status === 'done'
+      const by = manual.userName || 'a person'
+      return { stage, label: LABELS[stage], status: done ? 'done' : 'skipped', reason: done ? saved.reason || `${LABELS[stage]} completed.` : `Skipped: marked done by ${by} (${manual.note}).`, startedAt: saved.startedAt || null, finishedAt: saved.finishedAt || null, command: null }
+    }
     let status = i < position ? 'done' : i === position ? 'running' : 'pending'
     let reason = status === 'done' ? `${LABELS[stage]} completed; workflow advanced.` : status === 'pending' ? `Waiting for ${LABELS[STAGES[i - 1]] || 'plan approval'} to complete.` : `${LABELS[stage]} is running.`
     if (stage === 'reviewing' && options.review === false || ['awaiting-delivery', 'creating-pr', 'awaiting-ci'].includes(stage) && options.pullRequest === false) { status = 'skipped'; reason = 'Not required by this task’s approved workflow.' }

package/src/shared/workflow.js

@@ -212,9 +212,6 @@ const validateSnapshot = snapshot => {
     if (ids.has(check.id)) throw new Error(`Duplicate check id "${check.id}"`)
     ids.add(check.id)
   })
-  if (!checks.some(check => check.required && TEST_CATEGORIES.includes(check.category))) {
-    throw new Error('The project has no required test check; add one to .tspl/project.json before planning a tested pull request')
-  }
   const acceptance = snapshot.acceptance === undefined ? 0 : snapshot.acceptance
   const manualCriteria = snapshot.manualCriteria === undefined ? [] : snapshot.manualCriteria
   if (!Number.isInteger(acceptance) || acceptance < 0) throw new Error('acceptance must be a count')

package/src/workflow/controller.js

@@ -380,7 +380,7 @@ const runTask = async ({ cwd, taskId, signal, options = {} }, deps) => {
           if (problems.length) {
             const manual = problems.filter(text => /Acceptance criterion/.test(text))
             if (manual.length === problems.length) {
-              return outcome('reviewing', manual, snapshot.manualCriteria.map(n => `tspl task verify ${taskKey} --check ${n}`).concat([`Then: ${again}`]))
+              return outcome('reviewing', manual, snapshot.manualCriteria.map(n => `tspl task verify ${taskKey} --check ${n}`).concat([`Then: ${again}`, `Or finish by hand: tspl task done ${taskKey} --note "…"`]))
             }
             return block('other', problems.join(' '), [`Fix it, then: ${again}`])
           }