threadroot 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -4,6 +4,32 @@ All notable changes to Threadroot will be documented here.
 
 Threadroot follows semantic versioning after the first public release. While `0.x`, minor versions may include breaking changes as the harness format settles.
 
+## 0.1.3 - Verified Codex MCP setup
+
+### Added
+
+- `threadroot mcp check` to verify Codex MCP config, launch the stdio server, complete a JSON-RPC initialize handshake, and assert required Threadroot tools are available.
+- MCP server initialization instructions that tell agents how to use `context`, `doctor`, skills, tools, and durable memory.
+- Doctor checks for configured-but-broken Codex MCP.
+
+### Changed
+
+- `bootstrap --mcp` and `setup --global --mcp` now write a local-aware MCP command. Package-bin symlinks and local dev runs resolve to `node /path/to/dist/index.js mcp`, with `threadroot mcp` as the fallback.
+- Package smoke now verifies MCP from the packed tarball.
+
+## 0.1.2 - One-command bootstrap and session start
+
+### Added
+
+- `threadroot bootstrap` as the simple first-run command for global agent setup, local-only harness initialization, health checks, and initial context.
+- `threadroot start "<task>"` as the daily agent-session command for doctor, status, task context, and Threadroot command discovery.
+- Package smoke coverage for the new bootstrap/start flow.
+
+### Changed
+
+- The generated agent bootstrap prompt now uses `threadroot bootstrap --yes` and `threadroot start "<task>"` instead of spelling out lower-level setup commands.
+- README quickstart now leads with the simplified bootstrap/start flow.
+
 ## 0.1.1 - Clean setup and global agent bootstrap
 
 ### Changed

package/README.md

@@ -13,20 +13,17 @@ service.
 Run Threadroot without adding it to your project:
 
 ```bash
-npx threadroot setup --global --dry-run
-npx threadroot setup --global
-npx threadroot init
+npx threadroot bootstrap --yes
 # or
-pnpm dlx threadroot init
+pnpm dlx threadroot bootstrap --yes
 # or
-npm exec --package=threadroot -- threadroot init
+npm exec --package=threadroot -- threadroot bootstrap --yes
 ```
 
 After initialization:
 
 ```bash
-threadroot doctor
-threadroot context "write tests"
+threadroot start "write tests"
 ```
 
 For local development on Threadroot itself:
@@ -40,11 +37,10 @@ node dist/index.js --help
 ## Quick start
 
 ```bash
-tr setup --global       # one-time machine setup for supported coding agents
-tr init                 # detect the repo and scaffold local-only .threadroot/
-tr status               # authored objects and optional compiled outputs
-tr context "write tests" # task-relevant skills, rules, tools, and memory
-tr doctor               # health check for harness validity, setup hints, tool trust
+tr bootstrap --yes      # one-time machine setup + local-only .threadroot/
+tr bootstrap --yes --mcp # also configure and verify global Codex MCP
+tr start "write tests"  # doctor, status, relevant context, and command map
+tr mcp check            # verify Codex MCP config and server handshake
 tr expose codex         # optional: write a thin project skill shim for Codex
 ```
 
@@ -53,6 +49,8 @@ tr expose codex         # optional: write a thin project skill shim for Codex
 ## CLI surface
 
 ```bash
+tr bootstrap [--yes] [--agent <list>] [--task <task>] [--mcp] [--expose <list>]
+tr start ["<task>"]
 tr setup --global [--agent <list>] [--dry-run] [--check] [--undo] [--mcp]
 tr init [--force] [--no-import] [--profile <p>] [--adapters <list>] [--expose <list>]
 tr expose [agent|all] [--dry-run] [--check] [--undo] [--force]
@@ -75,6 +73,7 @@ tr connections list | check
 tr connections add <name> --provider <p> --command <cmd>
 tr packs list | inspect <pack> | validate <pack> | install <pack>
 tr mcp                            # run the local MCP server (stdio)
+tr mcp check                      # verify Codex MCP config and required tools
 tr mcp setup [--write]            # wire MCP into agents
 ```
 
@@ -99,19 +98,25 @@ turns the harness into legacy vendor instruction formats only when adapters are
 in `harness.yaml` or when you run `tr compile --adapter <name>`. Hand-authored prose in a
 vendor file is preserved; Threadroot only owns the block it marks as generated.
 
-## Global setup and exposure
+## Bootstrap, global setup, and exposure
 
-The best experience is one-time global setup plus local-only project harnesses:
+The simple path is:
 
 ```bash
-tr setup --global --dry-run
-tr setup --global
-tr init
+tr bootstrap --yes --mcp
+tr start "current task"
 ```
 
+Without `--yes`, `tr bootstrap` prints a dry-run plan. With `--yes`, it installs global
+agent bootstrap skills, initializes `.threadroot/` if needed, runs doctor, and prints
+task context. With `--mcp`, it also writes Codex MCP config using the current CLI entry
+(`node /path/dist/index.js mcp` when Threadroot can resolve the package path, or
+`threadroot mcp` as a fallback) and verifies the stdio server handshake. It does not write
+provider-specific project files unless you pass `--expose`.
+
 Global setup installs a tiny `threadroot` skill into supported agent user-skill
-directories so agents know to call `threadroot doctor` and `threadroot context "<task>"`
-when they see `.threadroot/`.
+directories so agents know to call `threadroot bootstrap --yes` when setup is missing
+and `threadroot start "<task>"` when they see `.threadroot/`.
 
 Supported global skill targets:
 
@@ -237,6 +242,7 @@ Threadroot runs a local MCP server over stdio that exposes the harness to agents
 
 ```bash
 tr mcp
+tr mcp check            # verify Codex global MCP config and required tools
 tr mcp setup            # print config snippets and a pasteable agent bootstrap prompt
 tr mcp setup --write    # opt-in: write project-local MCP config for supported agents
 ```
@@ -246,8 +252,12 @@ Tools: `context`, `skills_list`, `skills_get`, `tools_list`, `tools_check`, `too
 `memory_append`, `status`, `doctor`.
 
 `tr mcp setup` also prints a copy/paste agent prompt that follows the real CLI flow:
-check availability, run `threadroot init` when needed, inspect `status`, use
-`threadroot context`, and ask before writing MCP config.
+check availability, run `threadroot bootstrap --yes`, run `threadroot start "<task>"`,
+and ask before writing project-local MCP config.
+
+After changing Codex MCP config, reload VS Code/Codex or start a new Codex session. `tr mcp
+check` proves the server works from the terminal; the agent surface still has to load its
+MCP configuration.
 
 ## Profiles
 
@@ -287,8 +297,9 @@ THREADROOT_ROOT="$(pwd)"
 TMP_REPO="$(mktemp -d /tmp/threadroot-smoke.XXXXXX)"
 rsync -a --exclude .git --exclude node_modules --exclude dist ./ "$TMP_REPO/"
 cd "$TMP_REPO"
-node "$THREADROOT_ROOT/dist/index.js" init --no-import
-HOME="$TMP_REPO/home" node "$THREADROOT_ROOT/dist/index.js" setup --global --agent codex --dry-run
+HOME="$TMP_REPO/home" node "$THREADROOT_ROOT/dist/index.js" bootstrap --yes --agent codex --mcp --no-import
+HOME="$TMP_REPO/home" node "$THREADROOT_ROOT/dist/index.js" mcp check
+HOME="$TMP_REPO/home" node "$THREADROOT_ROOT/dist/index.js" start "write tests"
 node "$THREADROOT_ROOT/dist/index.js" expose codex
 node "$THREADROOT_ROOT/dist/index.js" status
 node "$THREADROOT_ROOT/dist/index.js" context "write tests"