Skip to content

feat(tbd-cli): Complete tbd V1 CLI implementation (Phases 1-25)#6

Merged
jlevy merged 48 commits into
mainfrom
claude/add-prime-setup-uninstall-tests
Jan 17, 2026
Merged

feat(tbd-cli): Complete tbd V1 CLI implementation (Phases 1-25)#6
jlevy merged 48 commits into
mainfrom
claude/add-prime-setup-uninstall-tests

Conversation

@jlevy
Copy link
Copy Markdown
Owner

@jlevy jlevy commented Jan 17, 2026

Summary

This PR completes the tbd V1 CLI implementation across 25 phases of development:

  • Core Implementation (Phases 1-11): Full CLI with create, list, show, update, close, reopen, search, label, dependency management
  • Polish & Testing (Phases 12-17): Tryscript golden tests, security hardening, CI configuration
  • Bug Fixes & Architecture (Phases 18-21): Worktree architecture, directory naming refactor, atomic file operations
  • Agent Integration (Phases 22-25): Short ID preservation during import, requireInit() enforcement, prime/setup/uninstall commands, status command

Key Features:

  • 187 vitest unit tests passing
  • 420 tryscript golden tests passing
  • Commands: prime, setup claude/cursor/codex, uninstall, status
  • Import preserves original beads short IDs
  • Documentation uses consistent --option=value syntax

Test Coverage

Category Tests
Unit Tests (vitest) 187
Golden Tests (tryscript) 420
Performance benchmark 5K issues

Validation Plan

See valid-2026-01-15-tbd-v1-implementation.md for complete validation details.

Manual Validation

Phase 24-25 Commands

  • tbd status - Works in initialized and uninitialized states
  • tbd prime - Outputs workflow context for AI agents
  • tbd prime --full / --mcp - Mode selection works
  • tbd setup claude - Creates Claude Code hooks
  • tbd setup cursor - Creates Cursor rules
  • tbd setup codex - Creates AGENTS.md section
  • tbd uninstall --all - Removes all integrations

Import Validation

# Initialize and import from beads
rm -rf .tbd && tbd init
tbd import --from-beads --verbose
tbd import --validate
tbd list --all | wc -l  # Should show ~100+ issues

requireInit() Enforcement

cd /tmp && mkdir test-dir && cd test-dir
tbd list  # Should error: "Not initialized. Run 'tbd init' first."
tbd status  # Should work (shows not initialized)

🤖 Generated with Claude Code

jlevy and others added 30 commits January 17, 2026 01:34
@jlevy @claude
test(tbd-cli): Add dedicated cli-sync.tryscript.md for sync tests
95e38ed 
Move sync tests from cli-advanced.tryscript.md to a dedicated file
that properly documents the critical sync commit behavior:

- Tests that verify files are committed before push
- Tests for sync status command
- Tests for error handling with missing remotes
- Tests for idempotent sync behavior

This makes it clear that sync commit verification is a core workflow
requirement, not an "advanced" feature.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
docs: Add tbd status command specification (Phase 25)
db2d0ed 
Replace tbd info with tbd status - a git-like orientation command that
works without initialization. Unlike Beads where bd status is an alias
for bd stats, tbd status is a distinct orientation command.

- Update tbd-design-v3.md with full status command spec
- Add Phase 25 to implementation plan with tasks tbd-1890 through tbd-1895
- Create beads for Phase 25 work

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
chore(beads): Add Phase 25 tasks (tbd-1890 through tbd-1895)
30b3036 
Create beads for status command work:
- tbd-1890: Phase 25 Epic
- tbd-1891: Implement tbd status command
- tbd-1892: Add beads detection
- tbd-1893: Add integration detection
- tbd-1894: Remove info command
- tbd-1895: Golden tests for status

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy
chore(beads): Sync beads state (tbd-1884, tbd-1885 closed)
a34d031
@jlevy @claude
test(tbd-cli): Add dedicated cli-sync.tryscript.md for sync tests
4d58187 
Create comprehensive sync test file to verify critical commit behavior:
- Tests that files written to worktree are committed before push
- Tests for multiple issues and batch syncing
- Tests for sync --status command and JSON output
- Tests for error handling with missing remotes
- Tests for idempotent sync behavior

Move detailed sync tests out of cli-advanced.tryscript.md to this
dedicated file, keeping only smoke tests in advanced.

This makes it clear that sync commit verification is a core workflow
requirement, not an "advanced" feature.

Relates-to: tbd-1885

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
chore(beads): Update beads state
790bdf5 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
test: Add golden tests for prime, setup, and uninstall commands
aeda0e6 
Add comprehensive tryscript golden tests for three command groups:

cli-prime.tryscript.md (21 tests):
- Prime in initialized vs uninitialized project
- Prime --full, --mcp, --export flags
- Custom PRIME.md override behavior

cli-setup-commands.tryscript.md (35 tests):
- Setup claude --check and --dry-run (safe operations only)
- Setup cursor: install, check, remove
- Setup codex: create, update, remove AGENTS.md

cli-uninstall.tryscript.md (27 tests):
- Uninstall without confirmation (preview)
- Uninstall --confirm (full cleanup)
- Uninstall --keep-branch option
- Uninstall --dry-run mode

Total: 83 new golden tests, bringing tryscript total to 438.

Closes tbd-1880, tbd-1883
Partially addresses tbd-1881 (aider tests blocked on tbd-1879)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
chore(beads): Close verified stale beads (Phase 22, 23, 25)
53f1a8e 
Verified and closed:
- Phase 22 (tbd-1868-1873): Import ID preservation - all implemented
- Phase 23 (tbd-1874, 1874.1-1874.4): Init behavior - requireInit in all commands
- Phase 25 (tbd-1891-1893): Status command with beads/integration detection

Still open:
- tbd-1874.5: Auto-init import tests (tests not yet written)
- tbd-1894: Remove info command (not done)
- tbd-1895: Status golden tests (not done)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
chore(beads): Sync beads state (add tbd-1896)
a636f88 
New issue added: tbd-1896 - Remove MCP auto-detection from tbd prime

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy
chore(beads): Add tasks for migrating golden scenarios to tryscripts …
77b79cb 
…(tbd-1897 through tbd-1905)
@jlevy @claude
chore(beads): Close aider-related tasks
182a849 
- tbd-1879: tbd setup aider - will not implement, not needed
- tbd-1881: Golden tests for setup - complete (claude/cursor/codex done)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
chore(beads): Close Phase 25 tasks - status command complete
a6b334f 
Closed:
- tbd-1880: Golden tests for prime (12 tests)
- tbd-1894: Remove info command (deleted)
- tbd-1895: Golden tests for status (9 tests)
- tbd-1890: Phase 25 Epic complete

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
feat(tbd-cli): Add tbd status command, replace info (Phase 25)
1bb3bf0 
Implement `tbd status` as the orientation command that works without
initialization (like `git status`). Unlike Beads where `bd status` is
an alias for `bd stats`, `tbd status` is a distinct orientation command.

Status command features:
- Works pre-init: shows git repo, beads detection, init suggestions
- Post-init: shows config, issue summary, integration status
- Detects integrations: Claude Code hooks, Cursor rules, Codex AGENTS.md
- JSON output support with --json flag

Changes:
- Add src/cli/commands/status.ts with StatusHandler
- Remove src/cli/commands/info.ts (replaced by status)
- Update cli.ts to use statusCommand instead of infoCommand
- Update README.md, tbd-docs.md with status command docs
- Add cli-status.tryscript.md golden tests
- Update all test files referencing info to use status
- Close beads tbd-1890 through tbd-1895

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
refactor(prime): Remove MCP auto-detection from tbd prime (tbd-1896)
aea04b5 
Remove the --mcp and --full flags along with the MCP auto-detection
logic. tbd prime now always outputs the full workflow context.

Changes:
- Remove isMcpEnabled() function that checked ~/.claude/settings.json
- Remove MCP_MODE_OUTPUT constant (minimal ~50 token output)
- Remove --mcp and --full CLI options
- Rename CLI_MODE_OUTPUT to PRIME_OUTPUT for clarity

The MCP detection was dead code since tbd doesn't provide an MCP server.
Simplifying to always output full context matches actual usage.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
refactor(tbd-cli): Add natural sort and remove deprecated golden tests
89528ad 
- Add sort.ts with naturalCompare/naturalSort for stable alphanumeric ordering
- Use extractUlidFromInternalId() helper instead of manual regex in import.ts, list.ts, idMapping.ts
- Add secondary sort by short ID in list command for deterministic output
- Use naturalSort in idMapping for consistent YAML output
- Add INTERNAL_ID_PREFIX constant to ids.ts
- Add test for invalid --title option in cli-crud.tryscript.md
- Remove deprecated YAML-based golden tests (replaced by tryscripts)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
refactor(tbd-cli): Use centralized ID helpers in idMapping
7dfcaa0 
Replace hardcoded 'is-' prefix with makeInternalId() and isInternalId()
helper functions from ids.ts for better maintainability.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
refactor(tbd-cli): Use centralized ID helpers in create and doctor
66f8c3a 
- create.ts: Use extractUlidFromInternalId() instead of slice(3)
- doctor.ts: Use validateIssueId() instead of hardcoded prefix check

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
refactor(tbd-cli): Add makeInternalId import in import.ts
05cc310 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
chore(beads): Sync beads state (formatting normalization)
d7fb9da 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy
chore(beads): Close golden test migration beads (tbd-1897 through tbd…
a44e4d4 
…-1905)

All YAML scenario tests were already migrated to tryscript format in commit 89528ad.
@jlevy @claude
fix(tests): Fix flaky performance tests by using beforeAll
adece9e 
The performance tests were timing out because:
1. beforeEach was writing 1000 files before EACH test (not once)
2. Sequential file writes took >10s, exceeding the default hook timeout

Fixed by:
- Using beforeAll instead of beforeEach for expensive setup
- Creating dedicated temp directories per describe block
- Writing files in parallel batches of 50 for faster I/O
- Adding explicit 60s timeout for setup hooks
- Proper cleanup with afterAll

Test duration reduced from potential 5×10s timeouts to ~6s total.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
fix(tbd-cli): Apply colored help to all subcommands
66b902d 
Commander.js's addCommand() does not inherit configureHelp() settings
from the parent command. This caused subcommand help (e.g., tbd list
--help) to be uncolored while the main program help was colored.

Added applyColoredHelpToAllCommands() function that recursively applies
the colored help configuration to all commands after they are added
to the program. Also updated research doc to correct the misinformation
about configureHelp() propagation.

Fixes: tbd-1823, tbd-1831, tbd-1832, tbd-1833, tbd-1834

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
feat(tbd-cli): Add help epilog with GitHub link
690ca2a 
Add colored epilog text at the bottom of all help commands
displaying: "For more on tbd, see: https://github.com/jlevy/tbd"

The epilog is rendered in blue and respects the --color option.

Also fix: use colors.id instead of colors.cyan in docs command
(colors.id is semantically correct for slugs and uses cyan internally)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
chore(beads): Sync beads state
35d1024 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
fix(tbd-cli): Add missing github-slugger dependency
d7cf165 
The docs command uses github-slugger for generating markdown-style
anchor IDs, but the dependency was missing from package.json.

Closes tbd-1826: Add topic-specific help to tbd docs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
chore(beads): Close tbd-1826 - topic-specific docs help
98fa405 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
test(tbd-cli): Add golden tests for docs topic argument and slugified…
e37064a 
… IDs

Add tests for:
- docs --help shows [topic] argument
- docs --list shows slugified IDs (e.g., id-system)
- docs <topic> positional argument works
- docs --list --json outputs array with slugs

Also update cli-setup.tryscript.md to reflect new docs command signature.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
test(tbd-cli): Fix YAML frontmatter and list ordering tests (tbd-1817)
2d10fce 
- Fix cli-filesystem.tryscript.md test expectation for description after frontmatter
- Fix cli-color-modes.tryscript.md list tests to use --sort=created for deterministic order
- Update test expectations to match descending created_at order

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
docs: Update CLI documentation to use full options instead of short a…
39018c3 
…liases

Replace all short option aliases (-t, -p, -d, -f, -l) with their full
equivalents (--type, --priority, --description, --file, --label) in
documentation. This prepares for removing short option support to reduce
CLI surface area and improve clarity.

Also includes doc structure improvements and formatting updates.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
test(tbd-cli): Update test files for full option names and help output
38d9cd6 
- Replace short options (-t, -p, -d, -f, -l) with full equivalents
  (--type, --priority, --description, --file, --label) in all test files
- Update expected help output to include new readme command
- Add "For more on tbd" footer to help output expectations
- Add cli-import-autoinit.tryscript.md for auto-init during import
- Fix spacing issues with --description and --label arguments
- Normalize "TBD" to "tbd" in test file titles

All 467 tryscript tests pass.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
jlevy and others added 18 commits January 17, 2026 03:42
@jlevy @claude
docs: Use --option=value syntax consistently in documentation and tests
6e2561d 
Change all CLI option examples from space-separated format (--type bug)
to equals-separated format (--type=bug) for consistency. Both formats
work with Commander.js, but the equals format is more explicit and
GNU-style.

Updated files:
- docs/tbd-docs.md - Main CLI documentation
- README.md - Quick start examples
- docs/project/architecture/current/tbd-design-v3.md - Design document
- packages/tbd-cli/src/docs/ - Embedded documentation copies
- packages/tbd-cli/tests/*.tryscript.md - All test files

All 467 tryscript tests pass.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
chore(beads): Sync beads state
b35292f 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
feat(tbd-cli): Show beads disable tip after import
fcdaec3 
After importing from beads, display helpful tip showing how to disable
beads integrations to prevent agent confusion:
- bd hooks uninstall (git hooks)
- bd setup claude --remove (Claude Code hooks)
- bd setup <editor> --remove (cursor, codex, etc.)

Also:
- Run flowmark --auto on all markdown files
- Add new research docs
- Add readme command

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
docs: Update CLI startup performance research with verified timings
0361b00 
Update measured timing data from verification run on 2026-01-17:
- V8 baseline: ~20ms → ~15ms
- Dependency loading: ~28ms → ~23ms
- YAML library: 13ms → ~11ms
- Zod: 5.2ms → ~4.4ms
- Lazy loading potential improvement: 45% → ~55%

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy
docs: Update readme.
e4facd0
@jlevy @claude
refactor(tbd-cli): Rename 'depends' command to 'dep' for Beads consis…
0c39378 
…tency

Match Beads CLI convention by using 'tbd dep' instead of 'tbd depends'
for dependency management commands. This aligns with the design spec
and maintains familiar command names for users migrating from Beads.

Changes:
- Rename depends.ts to dep.ts
- Update cli.ts imports to use depCommand
- Update all tryscript tests to use 'tbd dep' command
- Update documentation (README.md, tbd-docs.md)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
chore(tbd-cli): Gitignore src/docs as build artifacts
d95a6e2 
The files in src/docs/ are copied from the repo root during the
prebuild step by copy-docs.mjs. They should be gitignored as
generated files, not tracked.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
docs: Update implementation plan and CLI help options
da1579d 
- Add Phase 25 (Status Command & Test Expansion) to implementation plan
- Update test counts: 187 vitest, 420 tryscript golden tests
- Document CLI help style improvements (full option names)
- Remove short -V version flag for consistent --option=value style
- Add explicit --help option to CLI
- Sync beads tracking state

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy
docs: Naming consistency.
4c8bb84
@jlevy @claude
chore(beads): Sync beads state
096b83b 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
test(tbd-cli): Fix cli-setup tryscript golden tests
58f075b 
Update expected output to match current CLI behavior:
- Remove -V short flag test (option no longer exists)
- Update help output: `--help` instead of `-h, --help`
- Update help output: `dep` instead of `depends` (renamed command)
- Update status output: `Tbd` capitalization
- Update status output: branch shown only when repo has commits
- Fix Git repository line to match actual output format

Note: --sync-branch and --remote init options are not currently
applied (tracked as bug for future fix).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
feat(tbd-cli): Add help width limit and colorized Markdown output
2618591 
- Set Commander help text max width to 88 characters (or terminal width if smaller)
- Add marked + marked-terminal for colorized Markdown rendering
- Integrate renderMarkdown into docs and readme commands for colored output
- Respects --color option and TTY detection

Closes tbd-1935, tbd-1936

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
chore(beads): Sync beads state
3743616 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
test(tbd-cli): Fix status output casing in golden tests
8b44280 
Use lowercase 'tbd' consistently in status output tests to match
actual CLI output (the capitalized 'Tbd' was from a stale global install).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
chore: Update pnpm lockfile for marked dependencies
3e588c0 
Add marked and marked-terminal dependencies to root lockfile.
These were added in 2618591 but only to npm lockfile, not pnpm.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
fix(tbd-cli): Add bin-bootstrap.cjs source file
4a7189f 
The CJS bootstrap file was missing from version control.
This file is required for the build to produce dist/bin-bootstrap.cjs.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
chore(beads): Sync beads state
0d8fa6e 
Closed issues:
- tbd-1934: Lazy command loading (superseded by compile cache)
- tbd-1921: Beads migration docs (Beads-side documentation)
- tbd-1937: Enable Node.js compile cache (implemented)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jlevy @claude
fix(tbd-cli): Fix coverage script to generate required files
f3f6e74 
Change test:coverage to run vitest with --coverage first (which generates
coverage-summary.json and coverage-final.json required by CI), then run
tryscript tests separately.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jan 17, 2026

Coverage Report for packages/tbd-cli

Status Category Percentage Covered / Total
🔵 Lines 12.66% 657 / 5186
🔵 Statements 12.66% 657 / 5186
🔵 Functions 38.53% 42 / 109
🔵 Branches 80.1% 153 / 191
File Coverage
File Stmts Branches Functions Lines Uncovered Lines
Changed Files
packages/tbd-cli/src/cli/cli.ts 0% 0% 0% 0% 1-152
packages/tbd-cli/src/cli/commands/create.ts 0% 0% 0% 0% 1-153
packages/tbd-cli/src/cli/commands/docs.ts 0% 0% 0% 0% 1-190
packages/tbd-cli/src/cli/commands/doctor.ts 0% 0% 0% 0% 1-264
packages/tbd-cli/src/cli/commands/import.ts 0% 0% 0% 0% 1-666
packages/tbd-cli/src/cli/commands/list.ts 0% 0% 0% 0% 1-232
packages/tbd-cli/src/cli/commands/prime.ts 0% 0% 0% 0% 1-131
packages/tbd-cli/src/cli/commands/readme.ts 0% 0% 0% 0% 1-65
packages/tbd-cli/src/cli/commands/setup.ts 0% 0% 0% 0% 1-564
packages/tbd-cli/src/cli/commands/status.ts 0% 0% 0% 0% 1-384
packages/tbd-cli/src/cli/lib/output.ts 0% 0% 0% 0% 1-300
packages/tbd-cli/src/file/idMapping.ts 0% 0% 0% 0% 1-210
packages/tbd-cli/src/lib/ids.ts 93.9% 100% 83.33% 93.9% 125-126, 235-237
packages/tbd-cli/src/lib/sort.ts 100% 100% 100% 100%
Generated in workflow #76 for commit f3f6e74 by the Vitest Coverage Report Action

@jlevy jlevy merged commit 48c6316 into main Jan 17, 2026
5 checks passed
jlevy pushed a commit that referenced this pull request Jan 17, 2026
@claude
docs: Consolidate review with all bugs and enhancements
4d0c357 
Merged Beads vs tbd comparison into main review document.
Now includes:

Bugs (6 total):
- #1: Exit codes return 0 on errors (CRITICAL)
- #2: Dependency direction semantics confusing
- #3: Search outputs message with --quiet
- #4: Doctor warns on empty issues dir
- #5: Import changes ID prefix
- #6: Errors not JSON with --json flag

Enhancements (20 total):
- Critical (3): exit codes, npm publish, git version check
- High (5): dep semantics, error JSON, tests, docs, import prefix
- Medium (7): brief flag, templates, query DSL, batch ops, etc.
- Low (5): history, GitHub sync, plugins, index, auto-links

Key finding: tbd's single session protocol is better than
Beads' 5 conditional protocols. Keep it simple.
gbasin added a commit to gbasin/tbd that referenced this pull request Feb 12, 2026
@gbasin @claude
process: fourth-pass spec refinement for orchestrator harness
3d12350 
Design decisions applied:
- Remove AI spec review from v1 (harness expects finished spec)
- Move human_review gate to Phase 2 (after decomposition)
- Agents receive entire frozen spec (no section extraction)
- Cycle detection in buildDependencyGraph() — fail fast
- Deadlock detection in scheduler (blocked-bead deadlock)
- Process group killing via detached: true + kill(-pid)
- Resume re-reads harness.yml for operational config changes
- Trust agent push (no post-completion verification)

New sections:
- Example Agent Prompt (complete prompt template)
- Known Limitations (soft isolation, spec tampering, Unix-only, no cost controls, LWW)
- Deadlock Detection (cycle + blocked-bead scenarios)

Fixes:
- Pipeline diagram: removed AI review box, fixed "dedicated" → "fresh" worktree
- Agent Pool Model: "dedicated worktree" → "fresh ephemeral worktree"
- JudgeResult.newBeads: added 'feature' type
- Config YAML: human_review under phases.decompose with correct comment
- Defaults: added guidelines, completion checks, acceptance model
- Open Questions: resolved jlevy#1 (entire spec) and jlevy#6 (port algorithm)
- Code Organization: added lib/graph.ts
- Process Lifecycle: spawn with detached:true, SIGTERM targets process groups
- Testing: added cycle detection, deadlock, process group, resume config tests
- Future Work: added preview-acceptance, spec review phase, Windows, hash verify

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@jlevy