@jonit-dev/night-watch-cli 1.8.2 → 1.8.4-beta.0

package/dist/scripts/publish.sh

@@ -4,6 +4,14 @@ set -euo pipefail
 REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
 CLI_PKG="$REPO_ROOT/packages/cli"
 PROJECTS_FILE="$HOME/.night-watch/projects.json"
+BETA=false
+
+# Parse flags
+for arg in "$@"; do
+  case $arg in
+    --beta) BETA=true ;;
+  esac
+done
 
 cd "$REPO_ROOT"
 
@@ -11,16 +19,70 @@ cd "$REPO_ROOT"
 # Force all npm calls to use the official registry where the auth token is stored.
 export npm_config_registry=https://registry.npmjs.org
 
+CURRENT_VERSION=$(node -p "require('$CLI_PKG/package.json').version")
+
+# Confirmation prompt
+echo ""
+if [[ "$BETA" == true ]]; then
+  echo "  ┌─────────────────────────────────────────────────────────┐"
+  echo "  │                  BETA RELEASE                           │"
+  echo "  │                                                         │"
+  echo "  │  Published to: npm tag @beta                           │"
+  echo "  │  Install with: npm i -g @jonit-dev/night-watch-cli@beta │"
+  echo "  │  Current version: $CURRENT_VERSION"
+  echo "  └─────────────────────────────────────────────────────────┘"
+  echo ""
+  read -r -p "  Publish beta release? [y/N] " confirm
+else
+  echo "  ┌─────────────────────────────────────────────────────────┐"
+  echo "  │              STABLE (LATEST) RELEASE                    │"
+  echo "  │                                                         │"
+  echo "  │  WARNING: This publishes to the @latest npm tag.       │"
+  echo "  │  All users running 'npm update' will receive this.     │"
+  echo "  │                                                         │"
+  echo "  │  Only proceed if this version is production-ready.     │"
+  echo "  │  Current version: $CURRENT_VERSION"
+  echo "  └─────────────────────────────────────────────────────────┘"
+  echo ""
+  read -r -p "  Publish stable release to ALL users? [y/N] " confirm
+fi
+
+if [[ ! "$confirm" =~ ^[Yy]$ ]]; then
+  echo "Aborted."
+  exit 0
+fi
+
+echo ""
 echo "==> Running verify + tests..."
 yarn verify && yarn test
 
-echo "==> Bumping patch version..."
-CURRENT_VERSION=$(node -p "require('$CLI_PKG/package.json').version")
-IFS='.' read -r major minor patch <<< "$CURRENT_VERSION"
-NEW_VERSION="$major.$minor.$((patch + 1))"
-echo "    $CURRENT_VERSION -> $NEW_VERSION"
+# Version bumping
+IFS='.' read -r major minor patch_full <<< "$CURRENT_VERSION"
+
+if [[ "$BETA" == true ]]; then
+  # Strip any existing pre-release suffix from patch
+  patch="${patch_full%%-*}"
+
+  # Check if current version is already a beta of the next patch
+  if [[ "$CURRENT_VERSION" =~ ^([0-9]+\.[0-9]+\.[0-9]+)-beta\.([0-9]+)$ ]]; then
+    # Bump beta number: 1.8.4-beta.0 -> 1.8.4-beta.1
+    base="${BASH_REMATCH[1]}"
+    beta_num="${BASH_REMATCH[2]}"
+    NEW_VERSION="$base-beta.$((beta_num + 1))"
+  else
+    # Start new beta: 1.8.3 -> 1.8.4-beta.0
+    NEW_VERSION="$major.$minor.$((patch + 1))-beta.0"
+  fi
+  NPM_TAG="beta"
+else
+  # Stable: strip any pre-release suffix and bump patch
+  patch="${patch_full%%-*}"
+  NEW_VERSION="$major.$minor.$((patch + 1))"
+  NPM_TAG="latest"
+fi
+
+echo "==> Bumping version: $CURRENT_VERSION -> $NEW_VERSION"
 
-# Update package.json
 node -e "
   const fs = require('fs');
   const pkg = JSON.parse(fs.readFileSync('$CLI_PKG/package.json', 'utf8'));
@@ -33,9 +95,9 @@ git add "$CLI_PKG/package.json"
 git commit -m "chore: bump version to $NEW_VERSION"
 git push origin master
 
-echo "==> Publishing to npm..."
+echo "==> Publishing to npm (tag: $NPM_TAG)..."
 cd "$CLI_PKG"
-npm publish --access public
+npm publish --access public --tag "$NPM_TAG"
 
 echo "==> Installing globally (waiting for registry propagation)..."
 echo "    Waiting 60s for npm registry to propagate..."
@@ -54,25 +116,31 @@ for attempt in 1 2 3 4 5; do
 done
 night-watch --version
 
-echo "==> Updating registered projects (skipping /tmp/*)..."
-if [[ -f "$PROJECTS_FILE" ]]; then
-  node -e "
-    const projects = JSON.parse(require('fs').readFileSync('$PROJECTS_FILE', 'utf8'));
-    projects
-      .filter(p => p.path && !p.path.startsWith('/tmp/'))
-      .forEach(p => {
-        console.log('  Project: ' + p.name + ' (' + p.path + ')');
-        const { execSync } = require('child_process');
-        try {
-          execSync('night-watch update --projects ' + p.path, { stdio: 'inherit' });
-        } catch (e) {
-          console.error('  WARN: update failed for ' + p.name);
-        }
-      });
-  "
+# Only update registered projects for stable releases
+if [[ "$BETA" == true ]]; then
+  echo ""
+  echo "==> Skipping project updates (beta release)."
 else
-  echo "    No projects file found at $PROJECTS_FILE, skipping."
+  echo "==> Updating registered projects (skipping /tmp/*)..."
+  if [[ -f "$PROJECTS_FILE" ]]; then
+    node -e "
+      const projects = JSON.parse(require('fs').readFileSync('$PROJECTS_FILE', 'utf8'));
+      projects
+        .filter(p => p.path && !p.path.startsWith('/tmp/'))
+        .forEach(p => {
+          console.log('  Project: ' + p.name + ' (' + p.path + ')');
+          const { execSync } = require('child_process');
+          try {
+            execSync('night-watch update --projects ' + p.path, { stdio: 'inherit' });
+          } catch (e) {
+            console.error('  WARN: update failed for ' + p.name);
+          }
+        });
+    "
+  else
+    echo "    No projects file found at $PROJECTS_FILE, skipping."
+  fi
 fi
 
 echo ""
-echo "Done! Published $NEW_VERSION"
+echo "Done! Published $NEW_VERSION (@$NPM_TAG)"

package/dist/templates/prd-executor.md

@@ -233,3 +233,4 @@ If two parallel agents modify the same file:
 - **Full context** - each agent gets the complete phase spec + project rules
 - **Verify always** - never skip verification between waves
 - **Task tracking** - every phase is a tracked task with status updates
+- **Clean up worktrees** - after opening a PR for a worktree branch, immediately remove the worktree to avoid blocking future `git checkout` operations

package/dist/templates/skills/_codex-block.md

@@ -0,0 +1,58 @@
+## Night Watch Skills
+
+The following Night Watch CLI commands are available. Use them when the user asks to manage PRDs, board issues, or trigger Night Watch operations.
+
+### Create a PRD (`/nw-create-prd`)
+
+Create a new PRD at `docs/prds/<name>.md`. Ask for feature title, assess complexity (1=Simple, 2=Medium, 3=Complex), split into phases with checkbox tasks, then write the file. Tell the user to run `night-watch run` to execute immediately.
+
+### Add Issue to Board (`/nw-add-issue`)
+
+Add a GitHub issue to the Night Watch board:
+
+```
+night-watch board add-issue <issue-number>
+night-watch board add-issue <issue-number> --column "In Progress"
+```
+
+Available columns: Draft, Ready, In Progress, Review, Done.
+
+### Run Next PRD (`/nw-run`)
+
+Manually trigger Night Watch to execute the next PRD:
+
+```
+night-watch prd list         # see what's queued
+night-watch run              # execute next PRD
+night-watch run --prd <file> # run specific PRD
+night-watch logs --follow    # monitor progress
+```
+
+### Slice Roadmap (`/nw-slice`)
+
+Break a high-level feature into multiple PRD files:
+
+```
+night-watch slice
+```
+
+Reads `docs/roadmap.md` and generates PRDs. Review and adjust output in `docs/prds/`.
+
+### Sync Board (`/nw-board-sync`)
+
+Sync the GitHub board with PRD/PR state:
+
+```
+night-watch board status
+night-watch board sync
+```
+
+### Review PRs (`/nw-review`)
+
+Run automated PR review:
+
+```
+night-watch review
+night-watch review --pr <number>
+night-watch logs --type review
+```

package/dist/templates/skills/nw-add-issue.md

@@ -0,0 +1,39 @@
+# Skill: nw-add-issue
+
+Add an existing GitHub issue to the Night Watch project board for tracking and execution.
+
+## When to use
+
+When the user wants to add a GitHub issue to the Night Watch Kanban board.
+
+## Steps
+
+1. **Check for issue number** — if not provided, list open issues:
+
+   ```
+   gh issue list --state open --limit 20
+   ```
+
+   Ask the user which issue(s) to add.
+
+2. **Add the issue to the board**:
+
+   ```
+   night-watch board add-issue <issue-number>
+   ```
+
+3. **Optionally specify a column** (default: "Ready"):
+
+   ```
+   night-watch board add-issue <issue-number> --column "In Progress"
+   ```
+
+   Available columns: `Draft`, `Ready`, `In Progress`, `Review`, `Done`
+
+4. **Confirm** the issue was added and show its board position.
+
+## Notes
+
+- Issues in "Ready" are picked up automatically by Night Watch on the next run
+- Move issues to "Draft" if they're not yet ready for autonomous execution
+- Use `night-watch board sync` if the board gets out of sync with PRDs

package/dist/templates/skills/nw-board-sync.md

@@ -0,0 +1,47 @@
+# Skill: nw-board-sync
+
+Sync the GitHub Project board with the current state of Night Watch PRDs and pull requests.
+
+## When to use
+
+When the board is out of sync with PRD/PR status, or after manual changes to issues or PRDs.
+
+## Steps
+
+1. **View current board state**:
+
+   ```
+   night-watch board status
+   ```
+
+2. **Sync board with PRD filesystem**:
+
+   ```
+   night-watch board sync
+   ```
+
+3. **List open issues that may need board assignment**:
+
+   ```
+   gh issue list --state open --label "night-watch"
+   ```
+
+4. **Add any missing issues to the board**:
+   ```
+   night-watch board add-issue <number>
+   ```
+
+## Board Columns
+
+| Column      | Meaning                                          |
+| ----------- | ------------------------------------------------ |
+| Draft       | Not ready for execution                          |
+| Ready       | Queued for Night Watch — picked up automatically |
+| In Progress | Currently being implemented                      |
+| Review      | PR opened, awaiting review                       |
+| Done        | Merged and complete                              |
+
+## Notes
+
+- Night Watch auto-moves issues from Ready → In Progress when starting, and In Progress → Review when opening a PR
+- Use `night-watch board setup` to create the board if it doesn't exist yet

package/dist/templates/skills/nw-create-prd.md

@@ -0,0 +1,61 @@
+# Skill: nw-create-prd
+
+Create a new Product Requirements Document (PRD) for Night Watch to implement autonomously.
+
+## When to use
+
+When the user describes a feature, bug fix, or improvement they want Night Watch to implement.
+
+## Steps
+
+1. **Gather requirements** — if not fully described, ask:
+   - What problem does this solve?
+   - What is the expected outcome?
+
+2. **Assess complexity**:
+   - **1 (Simple)**: single-file fix, minor config change, small bug
+   - **2 (Medium)**: multi-file feature, new endpoint, new component
+   - **3 (Complex)**: new subsystem, architectural change, major refactor
+
+3. **Split into phases** — each phase should be an independently testable checkpoint:
+   - Phase 1: data models, interfaces, schema
+   - Middle phases: services, API, core logic
+   - Final phase: UI, integration, tests
+
+4. **Write the PRD** to `docs/prds/<kebab-case-title>.md` using this structure:
+
+```
+# PRD: <Title>
+
+**Complexity: <1|2|3> → <Simple|Medium|Complex> mode**
+
+## Problem
+
+<1-2 sentences describing the user problem or business need>
+
+## Solution
+
+- <bullet 1>
+- <bullet 2>
+- <bullet 3>
+
+## Phases
+
+### Phase 1: <Name>
+
+- [ ] <specific implementation task>
+- [ ] <write tests for above>
+
+### Phase 2: <Name>
+
+- [ ] <specific implementation task>
+- [ ] <write integration tests>
+
+## Acceptance Criteria
+
+- [ ] All phases complete
+- [ ] All tests pass
+- [ ] Feature reachable from existing code (no orphaned code)
+```
+
+5. **Confirm** to the user: show the file path and remind them to run `night-watch run` to execute immediately, or it will run on the next scheduled cron cycle.

package/dist/templates/skills/nw-review.md

@@ -0,0 +1,39 @@
+# Skill: nw-review
+
+Run the Night Watch automated PR reviewer on open pull requests.
+
+## When to use
+
+When the user wants to trigger automated code review on Night Watch PRs, or when a PR needs a review score.
+
+## Steps
+
+1. **List open Night Watch PRs**:
+
+   ```
+   gh pr list --state open --json number,title,headRefName --jq '.[] | select(.headRefName | startswith("night-watch/"))'
+   ```
+
+2. **Run the reviewer** (processes all eligible PRs):
+
+   ```
+   night-watch review
+   ```
+
+3. **Review a specific PR**:
+
+   ```
+   night-watch review --pr <number>
+   ```
+
+4. **Check review results**:
+   ```
+   night-watch logs --type review
+   ```
+
+## Notes
+
+- Minimum passing score: 80/100 (configurable via `minReviewScore` in `night-watch.config.json`)
+- Failed reviews block auto-merge and trigger webhook notifications
+- The reviewer runs automatically on its own cron schedule (`reviewerSchedule` in config)
+- Review checks: code quality, test coverage, PR description, acceptance criteria alignment

package/dist/templates/skills/nw-run.md

@@ -0,0 +1,39 @@
+# Skill: nw-run
+
+Manually trigger Night Watch to execute the next available PRD immediately.
+
+## When to use
+
+When the user wants to run Night Watch now instead of waiting for the cron schedule.
+
+## Steps
+
+1. **Check what's queued**:
+
+   ```
+   night-watch prd list
+   ```
+
+2. **Run the executor**:
+
+   ```
+   night-watch run
+   ```
+
+3. **To run a specific PRD** by filename:
+
+   ```
+   night-watch run --prd <filename.md>
+   ```
+
+4. **Monitor logs** in real time:
+   ```
+   night-watch logs --follow
+   ```
+
+## Notes
+
+- Night Watch executes ONE PRD per run to prevent timeouts and reduce risk
+- The automated cron schedule runs on a configurable interval (check with `night-watch status`)
+- Use `night-watch queue` to see all queued PRDs in priority order
+- If a run fails, the PRD is NOT marked as done — fix the issue and re-run

package/dist/templates/skills/nw-slice.md

@@ -0,0 +1,33 @@
+# Skill: nw-slice
+
+Slice a high-level roadmap item or epic into multiple focused PRD files for Night Watch execution.
+
+## When to use
+
+When the user has a large feature or roadmap item that should be broken into smaller,
+independently-executable pieces.
+
+## Steps
+
+1. **Ask for the epic description** if not provided.
+
+2. **Run the slicer** to auto-generate PRDs from a roadmap file:
+
+   ```
+   night-watch slice
+   ```
+
+   This reads `docs/roadmap.md` (or configured roadmap path) and generates PRD files.
+
+3. **To slice a specific feature**, first add it to `docs/roadmap.md`, then run slice.
+
+4. **Review generated PRDs** in `docs/prds/` — adjust scope, complexity, or phases if needed.
+
+5. PRDs run in creation order (or by `prdPriority` config) on the next Night Watch execution.
+
+## Tips
+
+- Each PRD should be deployable independently without breaking anything
+- Keep PRDs focused on 1-2 user stories for faster execution
+- Complex PRDs (score 3) often benefit from splitting into 2 medium PRDs
+- Use `Depends-On: <other-prd.md>` in a PRD's front matter to enforce ordering

package/dist/templates/skills/skills/_codex-block.md

@@ -0,0 +1,58 @@
+## Night Watch Skills
+
+The following Night Watch CLI commands are available. Use them when the user asks to manage PRDs, board issues, or trigger Night Watch operations.
+
+### Create a PRD (`/nw-create-prd`)
+
+Create a new PRD at `docs/prds/<name>.md`. Ask for feature title, assess complexity (1=Simple, 2=Medium, 3=Complex), split into phases with checkbox tasks, then write the file. Tell the user to run `night-watch run` to execute immediately.
+
+### Add Issue to Board (`/nw-add-issue`)
+
+Add a GitHub issue to the Night Watch board:
+
+```
+night-watch board add-issue <issue-number>
+night-watch board add-issue <issue-number> --column "In Progress"
+```
+
+Available columns: Draft, Ready, In Progress, Review, Done.
+
+### Run Next PRD (`/nw-run`)
+
+Manually trigger Night Watch to execute the next PRD:
+
+```
+night-watch prd list         # see what's queued
+night-watch run              # execute next PRD
+night-watch run --prd <file> # run specific PRD
+night-watch logs --follow    # monitor progress
+```
+
+### Slice Roadmap (`/nw-slice`)
+
+Break a high-level feature into multiple PRD files:
+
+```
+night-watch slice
+```
+
+Reads `docs/roadmap.md` and generates PRDs. Review and adjust output in `docs/prds/`.
+
+### Sync Board (`/nw-board-sync`)
+
+Sync the GitHub board with PRD/PR state:
+
+```
+night-watch board status
+night-watch board sync
+```
+
+### Review PRs (`/nw-review`)
+
+Run automated PR review:
+
+```
+night-watch review
+night-watch review --pr <number>
+night-watch logs --type review
+```

package/dist/templates/skills/skills/nw-add-issue.md

@@ -0,0 +1,39 @@
+# Skill: nw-add-issue
+
+Add an existing GitHub issue to the Night Watch project board for tracking and execution.
+
+## When to use
+
+When the user wants to add a GitHub issue to the Night Watch Kanban board.
+
+## Steps
+
+1. **Check for issue number** — if not provided, list open issues:
+
+   ```
+   gh issue list --state open --limit 20
+   ```
+
+   Ask the user which issue(s) to add.
+
+2. **Add the issue to the board**:
+
+   ```
+   night-watch board add-issue <issue-number>
+   ```
+
+3. **Optionally specify a column** (default: "Ready"):
+
+   ```
+   night-watch board add-issue <issue-number> --column "In Progress"
+   ```
+
+   Available columns: `Draft`, `Ready`, `In Progress`, `Review`, `Done`
+
+4. **Confirm** the issue was added and show its board position.
+
+## Notes
+
+- Issues in "Ready" are picked up automatically by Night Watch on the next run
+- Move issues to "Draft" if they're not yet ready for autonomous execution
+- Use `night-watch board sync` if the board gets out of sync with PRDs

package/dist/templates/skills/skills/nw-board-sync.md

@@ -0,0 +1,47 @@
+# Skill: nw-board-sync
+
+Sync the GitHub Project board with the current state of Night Watch PRDs and pull requests.
+
+## When to use
+
+When the board is out of sync with PRD/PR status, or after manual changes to issues or PRDs.
+
+## Steps
+
+1. **View current board state**:
+
+   ```
+   night-watch board status
+   ```
+
+2. **Sync board with PRD filesystem**:
+
+   ```
+   night-watch board sync
+   ```
+
+3. **List open issues that may need board assignment**:
+
+   ```
+   gh issue list --state open --label "night-watch"
+   ```
+
+4. **Add any missing issues to the board**:
+   ```
+   night-watch board add-issue <number>
+   ```
+
+## Board Columns
+
+| Column      | Meaning                                          |
+| ----------- | ------------------------------------------------ |
+| Draft       | Not ready for execution                          |
+| Ready       | Queued for Night Watch — picked up automatically |
+| In Progress | Currently being implemented                      |
+| Review      | PR opened, awaiting review                       |
+| Done        | Merged and complete                              |
+
+## Notes
+
+- Night Watch auto-moves issues from Ready → In Progress when starting, and In Progress → Review when opening a PR
+- Use `night-watch board setup` to create the board if it doesn't exist yet

package/dist/templates/skills/skills/nw-create-prd.md

@@ -0,0 +1,61 @@
+# Skill: nw-create-prd
+
+Create a new Product Requirements Document (PRD) for Night Watch to implement autonomously.
+
+## When to use
+
+When the user describes a feature, bug fix, or improvement they want Night Watch to implement.
+
+## Steps
+
+1. **Gather requirements** — if not fully described, ask:
+   - What problem does this solve?
+   - What is the expected outcome?
+
+2. **Assess complexity**:
+   - **1 (Simple)**: single-file fix, minor config change, small bug
+   - **2 (Medium)**: multi-file feature, new endpoint, new component
+   - **3 (Complex)**: new subsystem, architectural change, major refactor
+
+3. **Split into phases** — each phase should be an independently testable checkpoint:
+   - Phase 1: data models, interfaces, schema
+   - Middle phases: services, API, core logic
+   - Final phase: UI, integration, tests
+
+4. **Write the PRD** to `docs/prds/<kebab-case-title>.md` using this structure:
+
+```
+# PRD: <Title>
+
+**Complexity: <1|2|3> → <Simple|Medium|Complex> mode**
+
+## Problem
+
+<1-2 sentences describing the user problem or business need>
+
+## Solution
+
+- <bullet 1>
+- <bullet 2>
+- <bullet 3>
+
+## Phases
+
+### Phase 1: <Name>
+
+- [ ] <specific implementation task>
+- [ ] <write tests for above>
+
+### Phase 2: <Name>
+
+- [ ] <specific implementation task>
+- [ ] <write integration tests>
+
+## Acceptance Criteria
+
+- [ ] All phases complete
+- [ ] All tests pass
+- [ ] Feature reachable from existing code (no orphaned code)
+```
+
+5. **Confirm** to the user: show the file path and remind them to run `night-watch run` to execute immediately, or it will run on the next scheduled cron cycle.