niahere 0.2.87 → 0.2.89

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "niahere",
-  "version": "0.2.87",
+  "version": "0.2.89",
   "description": "A personal AI assistant daemon — chat, scheduled jobs, persona system, extensible via skills.",
   "type": "module",
   "scripts": {

package/skills/beads-tasks/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Persistent task management via Beads CLI (bd). Use when user mentions tasks, todos, issues, or tracking work.
   Check `which bd` first — if missing, offer: `npm install -g @beads/bd`.
   All commands: run from `$BEATS_DIR` (for example `~/.niahere/beads`) and use `bd <command>`. Always label: `--label project:<project-name>`.
-  Run `bd help-all` for available commands. Not for ephemeral in-conversation tracking.
+  Run `bd --help` or `bd help --all` for available commands. Not for ephemeral in-conversation tracking.
 ---
 
 ## Overview
@@ -19,7 +19,7 @@ Global task manager powered by [Beads](https://github.com/steveyegge/beads). Sto
 3. Set `BEATS_DIR` to your Beads workspace (for example `~/.niahere/beads`).
 4. All commands: `cd "$BEATS_DIR" && bd <command>`.
 5. Always label with `--label project:<name>`.
-6. Run `cd "$BEATS_DIR" && bd help-all` for available commands.
+6. Run `cd "$BEATS_DIR" && bd --help` or `bd help --all` for available commands.
 
 ## Core Commands
 
@@ -53,6 +53,8 @@ bd update <id> --status in_progress        # Start work
 bd update <id> --description "..."         # Add/replace description
 bd update <id> --add-label personal        # Add label
 bd update <id> --set-labels bug,urgent     # Replace all labels
+bd update <id> --claim                     # Atomically claim work
+bd update <id> --set-metadata team=platform # Set task-scoped metadata
 ```
 
 Chain multiple updates: `bd update <id> --priority P1 --type bug --parent <parent-id>`
@@ -63,7 +65,11 @@ Chain multiple updates: `bd update <id> --priority P1 --type bug --parent <paren
 bd list                          # Open tasks (tree view)
 bd list --all                    # Include closed/deferred tasks
 bd list --label project:<name>   # Filter by project
+bd ready                         # Ready work with blocker-aware semantics
+bd ready --claim                 # Atomically claim the first matching ready issue
 bd show <id>                     # Full details of a task
+bd show <id> --long              # Full details, including extended metadata
+bd show --current --long         # Current/last touched issue with metadata
 bd children <id>                 # List children of a parent
 ```
 
@@ -88,6 +94,57 @@ bd reopen <id>                   # Reopen if closed prematurely
 - Ephemeral/conversation-only tracking → use conversation context, not beads
 - `bd set-state ... state=...` is for operational metadata only; it does not change the task status shown in list.
 
+## Agent Session Tracking
+
+When a Beads task is worked in Claude Code, Codex, or another agent CLI, store the active session on the task as metadata. Do not invent session IDs yourself; let the tool create the session, then attach the discovered session ID to the bead.
+
+Use one shared metadata schema for all tools:
+
+```bash
+session_tool=codex|claude
+session_id=<tool-created-session-id>
+session_cwd=<absolute repo/worktree path>
+session_resume_cmd=<exact resume command>
+session_attached_at=<ISO timestamp>
+```
+
+Attach a session after starting or identifying it:
+
+```bash
+cd "$BEATS_DIR"
+bd update <id> --claim
+bd update <id> \
+  --set-metadata session_tool=codex \
+  --set-metadata session_id="$sid" \
+  --set-metadata session_cwd="$PWD" \
+  --set-metadata session_resume_cmd="cd $PWD && codex resume $sid" \
+  --set-metadata session_attached_at="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+bd note <id> "Attached codex session $sid"
+```
+
+For Claude, use the same keys and a Claude resume command:
+
+```bash
+bd update <id> \
+  --set-metadata session_tool=claude \
+  --set-metadata session_id="$sid" \
+  --set-metadata session_cwd="$PWD" \
+  --set-metadata session_resume_cmd="cd $PWD && claude --resume $sid" \
+  --set-metadata session_attached_at="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+```
+
+Find session-backed tasks:
+
+```bash
+bd list --has-metadata-key session_id --all --long
+bd list --metadata-field session_tool=codex --all --long
+bd list --metadata-field session_tool=claude --all --long
+bd show <id> --long
+bd show --current --long
+```
+
+Use task metadata as the source of truth. `bd kv` is global and not task-scoped, so do not use it for task sessions. `bd audit` is append-only history, not a jump table. Notes/comments are useful human breadcrumbs, but the resume command and session ID should live in metadata.
+
 ## Hierarchy & Organization
 
 ### When to use parent-child vs labels

package/skills/qa/playwright.md

@@ -49,6 +49,7 @@ This:
 - watches the Chrome process; when Chrome exits, commits the run profile back to the canonical profile and removes the run clone
 
 Each concurrent `open` gets its own user-data dir and CDP URL.
+The Chrome process is detached from the invoking shell, so it stays open across agent turn boundaries, Slack replies, and manual verification-code pauses. Reconnect later with the printed `PW_CDP_URL` or retrieve it with `status --run-id <run-id>`.
 
 Attach with Playwright when needed:
 
@@ -86,6 +87,7 @@ skills/qa/scripts/playwright-profile-clone.sh prepare
 skills/qa/scripts/playwright-profile-clone.sh open
 skills/qa/scripts/playwright-profile-clone.sh open --discard-on-close
 skills/qa/scripts/playwright-profile-clone.sh open --keep
+skills/qa/scripts/playwright-profile-clone.sh close --run-id <run-id> --wait
 skills/qa/scripts/playwright-profile-clone.sh status --run-id <run-id>
 skills/qa/scripts/playwright-profile-clone.sh commit --run-id <run-id>
 skills/qa/scripts/playwright-profile-clone.sh cleanup --run-id <run-id>
@@ -93,6 +95,7 @@ skills/qa/scripts/playwright-profile-clone.sh prune --keep 100
 ```
 
 The helper auto-prunes old run profiles after `prepare`/`open`. Default cap is `100` run dirs. Override it with `PLAYWRIGHT_PROFILE_MAX_RUNS=<count>`, or disable automatic pruning with `PLAYWRIGHT_PROFILE_MAX_RUNS=0` or `PLAYWRIGHT_PROFILE_MAX_RUNS=off`. Pruning skips the current run and any run with a tracked live Chrome PID.
+When browser work is complete, call `close --run-id <run-id> --wait`; this terminates the tracked Chrome process and lets the configured close behavior commit or discard the run.
 
 ## Quickstart: Open a Browser
 

package/skills/qa/scripts/playwright-profile-clone.sh

@@ -15,6 +15,7 @@ usage() {
 Usage:
   playwright-profile-clone.sh prepare [--run-id <hex>] [--primary <path>]
   playwright-profile-clone.sh open [--run-id <hex>] [--primary <path>] [--commit-on-close|--discard-on-close|--keep]
+  playwright-profile-clone.sh close [--run-id <hex>] [--wait]
   playwright-profile-clone.sh commit [--run-id <hex>]
   playwright-profile-clone.sh cleanup [--run-id <hex>]
   playwright-profile-clone.sh prune [--keep <count>|--off]
@@ -384,7 +385,7 @@ cmd_open() {
   chrome="$(chrome_path)"
   log_file="$RUNS_DIR/$run_id.chrome.log"
 
-  "$chrome" \
+  nohup "$chrome" \
     --user-data-dir="$run_dir" \
     --remote-debugging-port="$port" \
     --no-first-run \
@@ -439,18 +440,24 @@ start_close_watchdog() {
 
   [ "$close_action" != "keep" ] || return 0
 
-  (
+  nohup bash -c '
+    script_path="$1"
+    run_id="$2"
+    chrome_pid="$3"
+    close_action="$4"
+    log_file="$5"
+
     while kill -0 "$chrome_pid" 2>/dev/null; do
       sleep 0.2
     done
 
     if [ "$close_action" = "commit" ]; then
-      bash "$SCRIPT_PATH" commit --run-id "$run_id" --assume-closed >>"$log_file" 2>&1 &&
-        bash "$SCRIPT_PATH" cleanup --run-id "$run_id" >>"$log_file" 2>&1
+      bash "$script_path" commit --run-id "$run_id" --assume-closed >>"$log_file" 2>&1 &&
+        bash "$script_path" cleanup --run-id "$run_id" >>"$log_file" 2>&1
     elif [ "$close_action" = "discard" ]; then
-      bash "$SCRIPT_PATH" cleanup --run-id "$run_id" >>"$log_file" 2>&1
+      bash "$script_path" cleanup --run-id "$run_id" >>"$log_file" 2>&1
     fi
-  ) >/dev/null 2>&1 &
+  ' _ "$SCRIPT_PATH" "$run_id" "$chrome_pid" "$close_action" "$log_file" >/dev/null 2>&1 &
 }
 
 cmd_commit() {
@@ -470,6 +477,49 @@ cmd_commit() {
   commit_profile "$run_id" "$allow_running"
 }
 
+cmd_close() {
+  local run_id_arg=""
+  local wait_for_cleanup="false"
+  while [ "$#" -gt 0 ]; do
+    case "$1" in
+      --run-id) run_id_arg="${2:-}"; shift 2 ;;
+      --wait) wait_for_cleanup="true"; shift ;;
+      -h|--help) usage; exit 0 ;;
+      *) die "unknown close arg: $1" ;;
+    esac
+  done
+
+  local run_id
+  run_id="$(resolve_run_id_arg "$run_id_arg")"
+  load_state "$run_id"
+
+  [ -n "${PW_CHROME_PID:-}" ] || die "run id $run_id has no tracked Chrome PID"
+
+  if kill -0 "$PW_CHROME_PID" 2>/dev/null; then
+    kill "$PW_CHROME_PID" 2>/dev/null || true
+    echo "status=closing"
+  else
+    echo "status=already_closed"
+  fi
+  echo "run_id=$run_id"
+
+  if [ "$wait_for_cleanup" = "true" ]; then
+    local deadline=$((SECONDS + 30))
+    if [ "${PW_PROFILE_CLOSE_ACTION:-manual}" = "keep" ]; then
+      while kill -0 "$PW_CHROME_PID" 2>/dev/null && [ "$SECONDS" -lt "$deadline" ]; do
+        sleep 0.2
+      done
+      kill -0 "$PW_CHROME_PID" 2>/dev/null && die "timed out waiting for browser to close for run id $run_id"
+    else
+      while [ -e "$(state_file "$run_id")" ] && [ "$SECONDS" -lt "$deadline" ]; do
+        sleep 0.2
+      done
+      [ ! -e "$(state_file "$run_id")" ] || die "timed out waiting for close handling for run id $run_id"
+    fi
+    echo "status=closed"
+  fi
+}
+
 cmd_cleanup() {
   local run_id_arg=""
   while [ "$#" -gt 0 ]; do
@@ -523,6 +573,7 @@ main() {
   case "$command" in
     prepare) cmd_prepare "$@" ;;
     open) cmd_open "$@" ;;
+    close) cmd_close "$@" ;;
     commit) cmd_commit "$@" ;;
     cleanup) cmd_cleanup "$@" ;;
     prune) cmd_prune "$@" ;;