@10et/cli 1.0.0

package/scripts/commit-gtm.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+#
+# commit-gtm.sh - Commit changes to GTM repo (knowledge, content, etc.)
+#
+# Usage:
+#   ./scripts/commit-gtm.sh "commit message"
+#
+# This commits to the GTM repo (not the product submodule):
+# - knowledge/
+# - content/
+# - suggestions/
+# - previews/
+# - etc.
+
+set -e
+
+if [[ -z "$1" ]]; then
+    echo "Usage: $0 \"commit message\""
+    exit 1
+fi
+
+COMMIT_MSG="$1"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+echo "📝 Committing to GTM repo..."
+echo ""
+
+cd "$REPO_ROOT"
+
+# Show what will be committed (exclude all submodules)
+echo "Changes to commit:"
+git status --short | grep -v "^M. product" | grep -v "^M. runner" || true
+echo ""
+
+# Stage all changes except submodules (product, runner, etc.)
+git add knowledge/ content/ suggestions/ previews/ CLAUDE.md .jfl/ scripts/ .gitmodules 2>/dev/null || true
+
+# Use pathspec exclusion to ensure no submodules are staged
+git reset HEAD product/ runner/ 2>/dev/null || true
+
+# Check if there's anything to commit
+if git diff --cached --quiet; then
+    echo "⚠️  No changes to commit (excluding product submodule)"
+    echo "   Use ./scripts/commit-product.sh for product changes"
+    exit 0
+fi
+
+# Commit
+git commit -m "$COMMIT_MSG"
+
+# Push
+git push origin main
+
+echo ""
+echo "✅ GTM changes committed and pushed!"

package/scripts/commit-product.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+#
+# commit-product.sh - Commit changes to product submodule
+#
+# Usage:
+#   ./scripts/commit-product.sh "commit message"
+#
+# This handles all the submodule commit logic:
+# - cd to product submodule
+# - stage changes
+# - commit
+# - push to origin
+# - update parent repo reference
+
+set -e
+
+if [[ -z "$1" ]]; then
+    echo "Usage: $0 \"commit message\""
+    exit 1
+fi
+
+COMMIT_MSG="$1"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+PRODUCT_DIR="$REPO_ROOT/product"
+
+echo "📦 Committing to product submodule..."
+echo ""
+
+# Go to product submodule
+cd "$PRODUCT_DIR"
+
+# Check if on a branch
+CURRENT_BRANCH=$(git branch --show-current)
+if [[ -z "$CURRENT_BRANCH" ]]; then
+    echo "⚠️  You're in detached HEAD state"
+    echo "   Checking out main first..."
+    git checkout main
+fi
+
+# Show what will be committed
+echo "Changes to commit:"
+git status --short
+echo ""
+
+# Stage all changes
+git add -A
+
+# Commit
+git commit -m "$COMMIT_MSG"
+
+# Push
+git push origin main
+
+# Update parent repo reference
+cd "$REPO_ROOT"
+git add product
+git commit -m "chore: update product submodule
+
+Latest commit: $(cd product && git log -1 --oneline)
+
+Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
+git push origin main
+
+echo ""
+echo "✅ Product changes committed and pushed!"
+echo "   Submodule: $PRODUCT_DIR"
+echo "   Parent updated to track latest"

package/scripts/context-query.sh

@@ -0,0 +1,45 @@
+#!/bin/bash
+#
+# Helper script to query Context Hub
+#
+# Usage:
+#   ./scripts/context-query.sh                    # Get all context
+#   ./scripts/context-query.sh search "session"   # Search for term
+#   ./scripts/context-query.sh status             # Show status
+#
+
+ACTION="${1:-all}"
+QUERY="$2"
+TOKEN=$(cat .jfl/context-hub.token 2>/dev/null)
+
+if [ -z "$TOKEN" ]; then
+  echo "Error: No token found. Is Context Hub running?"
+  echo "Run: jfl context-hub start"
+  exit 1
+fi
+
+case "$ACTION" in
+  status)
+    curl -s -H "Authorization: Bearer $TOKEN" \
+      http://localhost:4242/api/context/status | python3 -m json.tool
+    ;;
+
+  search)
+    if [ -z "$QUERY" ]; then
+      echo "Usage: $0 search <query>"
+      exit 1
+    fi
+    curl -s -X POST \
+      -H "Authorization: Bearer $TOKEN" \
+      -H "Content-Type: application/json" \
+      -d "{\"query\": \"$QUERY\", \"maxItems\": 10}" \
+      http://localhost:4242/api/context/search | python3 -m json.tool
+    ;;
+
+  all|*)
+    curl -s -X POST \
+      -H "Authorization: Bearer $TOKEN" \
+      -H "Content-Type: application/json" \
+      http://localhost:4242/api/context | python3 -m json.tool
+    ;;
+esac

package/scripts/destroy-fleet.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+# destroy-fleet.sh — Tear down all VMs in a wave
+#
+# Usage:
+#   ./scripts/destroy-fleet.sh [WAVE_ID]
+#
+# Stops and deletes all agent-WAVEID-* VMs.
+# Run collect-tuples.sh FIRST to save training data.
+
+set -euo pipefail
+
+WAVE_ID=${1:-""}
+
+if [ -z "${WAVE_ID}" ]; then
+  echo "Usage: ./scripts/destroy-fleet.sh <WAVE_ID>"
+  echo ""
+  echo "Active waves:"
+  prlctl list -a 2>/dev/null | grep "agent-" | sed 's/.*agent-\([0-9]*\)-.*/  \1/' | sort -u
+  exit 1
+fi
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  Destroying fleet — Wave ${WAVE_ID}"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+DESTROYED=0
+for vm in $(prlctl list -a 2>/dev/null | grep "agent-${WAVE_ID}-" | awk '{print $1}'); do
+  echo -n "  [${vm}] "
+  prlctl stop "${vm}" --kill 2>/dev/null || true
+  prlctl delete "${vm}" 2>/dev/null || true
+  echo "destroyed"
+  DESTROYED=$((DESTROYED + 1))
+done
+
+echo ""
+echo "  Destroyed ${DESTROYED} VMs"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/scripts/generate-changesets.sh

@@ -0,0 +1,113 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Generates changeset files from conventional commit messages.
+#
+# Reads commits since the last git tag (or since initial commit) and creates
+# .changeset/<hash>.md files for each feat:/fix:/perf: commit.
+#
+# Commit message format → bump level:
+#   feat!: ...          → major
+#   fix!: ...           → major
+#   BREAKING CHANGE     → major
+#   feat: ...           → minor
+#   fix: ...            → patch
+#   perf: ...           → patch
+#   docs: ...           → skipped
+#   chore: ...          → skipped
+#   ci: ...             → skipped
+#   test: ...           → skipped
+#   refactor: ...       → skipped (no user-facing change)
+#   auto: ...           → skipped
+#   save: ...           → skipped
+#   session: ...        → skipped
+#   merge: ...          → skipped
+#
+# Usage:
+#   ./scripts/generate-changesets.sh          # auto-detect last tag
+#   ./scripts/generate-changesets.sh v0.3.0   # explicit base ref
+#   DRY_RUN=1 ./scripts/generate-changesets.sh  # preview without writing
+
+PKG_NAME=$(node -p "require('./package.json').name")
+CHANGESET_DIR=".changeset"
+
+# Find the base ref (last tag, or root commit)
+if [ -n "${1:-}" ]; then
+  BASE_REF="$1"
+elif git describe --tags --abbrev=0 HEAD 2>/dev/null; then
+  BASE_REF=$(git describe --tags --abbrev=0 HEAD 2>/dev/null)
+else
+  BASE_REF=$(git rev-list --max-parents=0 HEAD)
+fi
+
+echo "Base: $BASE_REF"
+echo "Package: $PKG_NAME"
+echo "---"
+
+CREATED=0
+SKIPPED=0
+
+while IFS= read -r line; do
+  HASH=$(echo "$line" | cut -d' ' -f1)
+  MSG=$(echo "$line" | cut -d' ' -f2-)
+
+  # Determine bump level from commit message
+  LEVEL=""
+  SUMMARY=""
+
+  # Check for breaking changes first
+  if echo "$MSG" | grep -qiE '^(feat|fix|refactor|perf)!:'; then
+    LEVEL="major"
+    SUMMARY=$(echo "$MSG" | sed -E 's/^[a-z]+!:\s*//')
+  elif echo "$MSG" | grep -qi 'BREAKING CHANGE'; then
+    LEVEL="major"
+    SUMMARY="$MSG"
+  elif echo "$MSG" | grep -qE '^feat(\(.+\))?:'; then
+    LEVEL="minor"
+    SUMMARY=$(echo "$MSG" | sed -E 's/^feat(\([^)]+\))?:\s*//')
+  elif echo "$MSG" | grep -qE '^fix(\(.+\))?:'; then
+    LEVEL="patch"
+    SUMMARY=$(echo "$MSG" | sed -E 's/^fix(\([^)]+\))?:\s*//')
+  elif echo "$MSG" | grep -qE '^perf(\(.+\))?:'; then
+    LEVEL="patch"
+    SUMMARY=$(echo "$MSG" | sed -E 's/^perf(\([^)]+\))?:\s*//')
+  fi
+
+  # Skip non-release commits
+  if [ -z "$LEVEL" ]; then
+    SKIPPED=$((SKIPPED + 1))
+    continue
+  fi
+
+  # Generate a short hash for the filename
+  SHORT=$(echo "$HASH" | cut -c1-8)
+  FILENAME="$CHANGESET_DIR/commit-$SHORT.md"
+
+  # Skip if changeset already exists for this commit
+  if [ -f "$FILENAME" ]; then
+    echo "  skip (exists): $SHORT $MSG"
+    SKIPPED=$((SKIPPED + 1))
+    continue
+  fi
+
+  if [ "${DRY_RUN:-}" = "1" ]; then
+    echo "  would create ($LEVEL): $SUMMARY"
+  else
+    mkdir -p "$CHANGESET_DIR"
+    cat > "$FILENAME" <<EOF
+---
+"$PKG_NAME": $LEVEL
+---
+
+$SUMMARY
+EOF
+    echo "  created ($LEVEL): $SUMMARY"
+  fi
+
+  CREATED=$((CREATED + 1))
+
+done < <(git log --oneline "$BASE_REF"..HEAD --no-merges --reverse)
+
+echo "---"
+echo "Created: $CREATED changesets"
+echo "Skipped: $SKIPPED commits"

package/scripts/jfl-ide.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+# JFL Agent IDE Launcher
+# Usage: jfl ide [layout]
+#   jfl ide         → default dev layout
+#   jfl ide dev     → developer layout
+#   jfl ide lead    → engineering lead layout
+#   jfl ide portfolio → portfolio owner layout
+#   jfl ide onboard → onboarding layout
+
+set -e
+
+LAYOUT="${1:-dev}"
+PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+LAYOUTS_DIR="$PROJECT_ROOT/.jfl/layouts"
+
+# Check tmux-ide is installed
+if ! command -v tmux-ide &>/dev/null; then
+  echo "tmux-ide not found. Installing..."
+  npm install -g tmux-ide
+fi
+
+# Check layout exists
+if [ "$LAYOUT" = "default" ] || [ -f "$PROJECT_ROOT/ide.yml" ] && [ "$LAYOUT" = "dev" ] && [ ! -f "$LAYOUTS_DIR/$LAYOUT.yml" ]; then
+  echo "🚀 Launching JFL IDE (default layout)"
+  cd "$PROJECT_ROOT"
+  tmux-ide
+  exit 0
+fi
+
+LAYOUT_FILE="$LAYOUTS_DIR/$LAYOUT.yml"
+if [ ! -f "$LAYOUT_FILE" ]; then
+  echo "❌ Layout not found: $LAYOUT"
+  echo ""
+  echo "Available layouts:"
+  for f in "$LAYOUTS_DIR"/*.yml; do
+    name=$(basename "$f" .yml)
+    echo "  - $name"
+  done
+  exit 1
+fi
+
+echo "🚀 Launching JFL IDE ($LAYOUT layout)"
+
+# Copy layout to project root as ide.yml (tmux-ide expects it there)
+cp "$LAYOUT_FILE" "$PROJECT_ROOT/ide.yml"
+
+cd "$PROJECT_ROOT"
+tmux-ide

package/scripts/migrate-to-branch-sessions.sh

@@ -0,0 +1,201 @@
+#!/usr/bin/env bash
+#
+# migrate-to-branch-sessions.sh - Migrate from worktree-based to branch-based sessions
+#
+# This script helps existing JFL users migrate to the new simplified session model.
+# It handles:
+# - Saving uncommitted work from worktrees
+# - Merging session branches to main
+# - Removing worktree directories
+# - Cleaning up metadata files
+#
+# @purpose Migration from worktree sessions to branch-only sessions
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_DIR="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+WORKTREES_DIR="$REPO_DIR/worktrees"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  JFL Migration: Worktree → Branch-Based Sessions"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "This will migrate your project from worktree-based sessions to"
+echo "simpler branch-based sessions."
+echo ""
+echo "What this does:"
+echo "  1. Save any uncommitted work in worktrees"
+echo "  2. Merge session branches to main"
+echo "  3. Remove worktree directories"
+echo "  4. Clean up metadata files"
+echo ""
+
+# Check if worktrees exist
+if [[ ! -d "$WORKTREES_DIR" ]]; then
+    echo -e "${GREEN}✓${NC} No worktrees directory found - nothing to migrate"
+    exit 0
+fi
+
+# Count worktrees
+worktree_count=$(find "$WORKTREES_DIR" -maxdepth 1 -type d -name "session-*" 2>/dev/null | wc -l | tr -d ' ')
+
+if [[ $worktree_count -eq 0 ]]; then
+    echo -e "${GREEN}✓${NC} No worktrees found - nothing to migrate"
+    echo ""
+    echo "Cleaning up empty worktrees directory..."
+    rmdir "$WORKTREES_DIR" 2>/dev/null || true
+    exit 0
+fi
+
+echo -e "${YELLOW}⚠${NC}  Found $worktree_count worktree(s) to migrate"
+echo ""
+
+# Ensure we're on main branch
+current_branch=$(git branch --show-current 2>/dev/null || echo "")
+if [[ "$current_branch" != "main" ]]; then
+    echo "Switching to main branch..."
+    git checkout main 2>/dev/null || {
+        echo -e "${RED}✗${NC} Failed to checkout main branch"
+        echo "  Please switch to main manually and run this script again"
+        exit 1
+    }
+fi
+
+# Step 1: Save uncommitted work in worktrees
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  Step 1: Checking for uncommitted work"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+for wt in "$WORKTREES_DIR"/session-*; do
+    if [[ -d "$wt" ]]; then
+        session_name=$(basename "$wt")
+        cd "$wt"
+
+        if git status --porcelain 2>/dev/null | grep -q .; then
+            echo -e "${YELLOW}⚠${NC}  Uncommitted work in $session_name"
+            git status --short
+            echo ""
+            echo "  Committing changes..."
+            git add -A
+            git commit -m "migration: auto-save uncommitted work before migration" || true
+            echo -e "${GREEN}✓${NC}  Changes saved"
+            echo ""
+        else
+            echo -e "${GREEN}✓${NC}  $session_name - no uncommitted changes"
+        fi
+
+        cd "$REPO_DIR"
+    fi
+done
+
+# Step 2: Merge session branches to main
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  Step 2: Merging session branches"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# Get all session branches
+session_branches=$(git branch | grep "session-" | sed 's/^[* ]*//' || true)
+
+if [[ -z "$session_branches" ]]; then
+    echo -e "${GREEN}✓${NC} No session branches to merge"
+else
+    for branch in $session_branches; do
+        echo "Merging $branch..."
+
+        # Try to merge
+        if git merge --no-edit "$branch" 2>/dev/null; then
+            echo -e "${GREEN}✓${NC} Merged $branch"
+
+            # Delete the branch
+            git branch -D "$branch" 2>/dev/null || true
+        else
+            # Merge conflicts - show them and skip
+            echo -e "${RED}✗${NC} Conflicts merging $branch"
+            echo ""
+            echo "  Conflicting files:"
+            git diff --name-only --diff-filter=U 2>/dev/null | sed 's/^/    - /'
+            echo ""
+            echo "  Aborting this merge - you'll need to merge $branch manually"
+            git merge --abort 2>/dev/null || true
+            echo ""
+        fi
+    done
+fi
+
+# Step 3: Clean up worktrees
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  Step 3: Removing worktrees"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# Prune worktrees from git
+echo "Pruning worktree references..."
+git worktree prune 2>/dev/null || true
+
+# Remove worktree directories
+if [[ -d "$WORKTREES_DIR" ]]; then
+    echo "Removing worktrees directory..."
+    rm -rf "$WORKTREES_DIR" 2>/dev/null || {
+        echo -e "${YELLOW}⚠${NC}  Could not remove $WORKTREES_DIR automatically"
+        echo "  Please remove it manually: rm -rf $WORKTREES_DIR"
+    }
+    echo -e "${GREEN}✓${NC} Worktrees directory removed"
+fi
+
+# Step 4: Clean up metadata
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  Step 4: Cleaning up metadata"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# Remove worktree metadata files
+rm -f "$REPO_DIR/.jfl/current-worktree.txt" 2>/dev/null || true
+rm -f "$REPO_DIR/.jfl/worktree-path.txt" 2>/dev/null || true
+
+echo -e "${GREEN}✓${NC} Metadata cleaned up"
+
+# Step 5: Summary
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  Migration Complete!"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo -e "${GREEN}✓${NC} Migration completed successfully"
+echo ""
+echo "What changed:"
+echo "  • Worktree directories removed"
+echo "  • Session branches merged to main (where possible)"
+echo "  • Metadata files cleaned up"
+echo ""
+echo "What's next:"
+echo "  • New sessions will use simple branch-based isolation"
+echo "  • No more worktree complexity or background processes"
+echo "  • Run 'git status' to verify everything is clean"
+echo ""
+
+# Check for remaining session branches that weren't merged
+remaining_branches=$(git branch | grep "session-" | sed 's/^[* ]*//' || true)
+if [[ -n "$remaining_branches" ]]; then
+    echo -e "${YELLOW}⚠${NC}  Note: Some session branches still exist (had conflicts):"
+    echo "$remaining_branches" | sed 's/^/    - /'
+    echo ""
+    echo "  You can merge or delete these manually:"
+    echo "    git merge <branch-name>   # to merge"
+    echo "    git branch -D <branch-name>   # to delete"
+    echo ""
+fi