@10et/cli 1.0.0

package/scripts/postinstall.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+/**
+ * JFL CLI Postinstall Script
+ *
+ * Installs bundled tools that enhance the JFL experience:
+ * - ralph-tui: AI agent loop orchestrator for autonomous task execution
+ *
+ * These tools require Bun runtime. If Bun is not installed,
+ * we'll show instructions but continue (tools are optional).
+ */
+
+import { execSync, spawnSync } from "child_process";
+import { platform } from "os";
+
+const TOOLS = [
+  {
+    name: "pi",
+    package: "@mariozechner/pi-coding-agent",
+    description: "Pi coding agent runtime",
+    requiresBun: false,
+    minVersion: "0.57.0",
+  },
+  {
+    name: "ralph-tui",
+    package: "ralph-tui",
+    description: "AI agent loop orchestrator",
+    requiresBun: true,
+  },
+];
+
+function hasBun() {
+  try {
+    execSync("bun --version", { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function hasCommand(cmd) {
+  try {
+    execSync(`which ${cmd}`, { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function installWithBun(pkg) {
+  try {
+    console.log(`  Installing ${pkg}...`);
+    execSync(`bun install -g ${pkg}`, { stdio: "inherit" });
+    return true;
+  } catch (error) {
+    console.error(`  Failed to install ${pkg}: ${error.message}`);
+    return false;
+  }
+}
+
+function installWithNpm(pkg) {
+  try {
+    console.log(`  Installing ${pkg}...`);
+    execSync(`npm install -g ${pkg}`, { stdio: "inherit" });
+    return true;
+  } catch (error) {
+    console.error(`  Failed to install ${pkg}: ${error.message}`);
+    return false;
+  }
+}
+
+function getInstalledVersion(cmd) {
+  try {
+    return execSync(`${cmd} --version`, { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+  } catch {
+    return null;
+  }
+}
+
+function isVersionSufficient(installed, minimum) {
+  if (!installed || !minimum) return true;
+  const iParts = installed.split(".").map(Number);
+  const mParts = minimum.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((iParts[i] || 0) > (mParts[i] || 0)) return true;
+    if ((iParts[i] || 0) < (mParts[i] || 0)) return false;
+  }
+  return true; // equal
+}
+
+function main() {
+  console.log("\n🚀 JFL CLI - Setting up bundled tools...\n");
+
+  const bunInstalled = hasBun();
+
+  for (const tool of TOOLS) {
+    if (tool.requiresBun && !bunInstalled) {
+      console.log(`⏭️  Skipping ${tool.name} (requires Bun)`);
+      continue;
+    }
+
+    // Check if already installed
+    if (hasCommand(tool.name)) {
+      const version = getInstalledVersion(tool.name);
+      if (tool.minVersion && version && !isVersionSufficient(version, tool.minVersion)) {
+        console.log(`⬆️  ${tool.name} v${version} → updating (min: ${tool.minVersion})`);
+      } else {
+        console.log(`✅ ${tool.name} already installed${version ? ` (v${version})` : ""}`);
+        continue;
+      }
+    }
+
+    console.log(`📦 Installing ${tool.name} - ${tool.description}`);
+    const success = tool.requiresBun
+      ? installWithBun(tool.package)
+      : installWithNpm(tool.package);
+
+    if (success) {
+      const version = getInstalledVersion(tool.name);
+      console.log(`✅ ${tool.name} installed${version ? ` (v${version})` : ""}\n`);
+    } else {
+      console.log(`⚠️  ${tool.name} installation failed (optional)\n`);
+    }
+  }
+
+  console.log("🎉 JFL CLI setup complete!\n");
+  console.log("Available tools:");
+  console.log("  jfl          - Main CLI");
+  if (hasCommand("pi")) {
+    console.log("  pi           - Coding agent runtime");
+  }
+  if (hasCommand("ralph-tui")) {
+    console.log("  ralph-tui    - AI agent loop orchestrator");
+  }
+  console.log("");
+
+  // Check for Clawdbot integration
+  if (hasCommand("clawdbot")) {
+    console.log("🦞 Clawdbot detected!");
+    console.log("");
+    console.log("Add JFL to Telegram/Slack/Discord:");
+    console.log("  jfl clawdbot install");
+    console.log("");
+  }
+}
+
+main();

package/scripts/pp-branch-pr.sh

@@ -0,0 +1,133 @@
+#!/bin/bash
+# scripts/pp-branch-pr.sh
+#
+# Wraps Peter Parker agent execution in git branch + PR workflow.
+# Creates a branch, runs the agent, commits changes, opens a PR,
+# and posts a pr:created event to the hub.
+#
+# Called by flow engine spawn action or directly.
+#
+# Usage: pp-branch-pr.sh <task-description> [hub-url] [hub-token]
+
+set -euo pipefail
+
+TASK="${1:?Usage: pp-branch-pr.sh <task-description> [hub-url] [hub-token]}"
+HUB_URL="${2:-}"
+HUB_TOKEN="${3:-}"
+BRANCH_NAME="pp/fix-$(date +%s)"
+BASE_BRANCH="main"
+
+if [ -z "$HUB_URL" ] && [ -f ".jfl/context-hub.port" ]; then
+  PORT=$(cat .jfl/context-hub.port)
+  HUB_URL="http://localhost:${PORT}"
+fi
+if [ -z "$HUB_TOKEN" ] && [ -f ".jfl/context-hub.token" ]; then
+  HUB_TOKEN=$(cat .jfl/context-hub.token)
+fi
+
+echo "PP: Creating branch ${BRANCH_NAME}"
+
+# 1. Create branch from clean main
+git fetch origin "${BASE_BRANCH}" 2>/dev/null || true
+git checkout -b "${BRANCH_NAME}" "origin/${BASE_BRANCH}" 2>/dev/null || git checkout -b "${BRANCH_NAME}" "${BASE_BRANCH}"
+
+# 2. Run Peter Parker
+echo "PP: Running agent on task: ${TASK}"
+jfl peter run --task "${TASK}"
+
+# 3. Check if anything changed
+if git diff --quiet HEAD && [ -z "$(git ls-files --others --exclude-standard)" ]; then
+  echo "PP: No changes made, cleaning up"
+  git checkout "${BASE_BRANCH}" 2>/dev/null || true
+  git branch -D "${BRANCH_NAME}" 2>/dev/null || true
+  exit 0
+fi
+
+# 4. Commit with provenance signing
+git add -A
+
+AGENT_ID="peter-parker"
+AGENT_SESSION="${BRANCH_NAME}"
+AGENT_TIMESTAMP="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+
+# Compute provenance hash from staged diff + agent identity
+PROVENANCE_KEY_PATH=".jfl/provenance-key"
+if [ ! -f "${PROVENANCE_KEY_PATH}" ]; then
+  mkdir -p .jfl
+  openssl rand -hex 32 > "${PROVENANCE_KEY_PATH}"
+  chmod 600 "${PROVENANCE_KEY_PATH}"
+fi
+PROVENANCE_KEY=$(cat "${PROVENANCE_KEY_PATH}")
+STAGED_DIFF=$(git diff --cached)
+PROVENANCE_PAYLOAD="${AGENT_ID}
+${AGENT_TIMESTAMP}
+${STAGED_DIFF}"
+PROVENANCE_HASH="sha256:$(printf '%s' "${PROVENANCE_PAYLOAD}" | openssl dgst -sha256 -hmac "${PROVENANCE_KEY}" | awk '{print $NF}')"
+
+COMMIT_MSG="fix(pp): ${TASK}
+
+Agent-Id: ${AGENT_ID}
+Agent-Session: ${AGENT_SESSION}
+Provenance-Hash: ${PROVENANCE_HASH}
+Agent-Timestamp: ${AGENT_TIMESTAMP}"
+
+git commit -m "${COMMIT_MSG}"
+
+# 5. Push
+git push -u origin "${BRANCH_NAME}"
+
+# 6. Create PR
+PR_TITLE="PP: $(echo "${TASK}" | head -c 60)"
+PR_BODY="## Auto-generated by Peter Parker
+
+**Task:** ${TASK}
+**Branch:** \`${BRANCH_NAME}\`
+
+### Eval Suite
+This PR will be evaluated by the CI eval suite.
+Auto-merge will trigger if eval score improves over baseline.
+
+---
+*Generated by JFL self-driving loop*"
+
+PR_URL=$(gh pr create \
+  --title "${PR_TITLE}" \
+  --body "${PR_BODY}" \
+  --base "${BASE_BRANCH}" \
+  --head "${BRANCH_NAME}" \
+  --label "pp-generated" 2>&1) || {
+  echo "PP: Label may not exist, retrying without label"
+  PR_URL=$(gh pr create \
+    --title "${PR_TITLE}" \
+    --body "${PR_BODY}" \
+    --base "${BASE_BRANCH}" \
+    --head "${BRANCH_NAME}" 2>&1)
+}
+
+echo "PP: PR created at ${PR_URL}"
+
+# 7. Post event to hub
+if [ -n "${HUB_URL}" ]; then
+  TASK_JSON=$(printf '%s' "${TASK}" | python3 -c 'import sys,json; print(json.dumps(sys.stdin.read().strip()))')
+
+  CURL_ARGS=(-s -X POST "${HUB_URL}/api/events" -H "Content-Type: application/json")
+  if [ -n "${HUB_TOKEN}" ]; then
+    CURL_ARGS+=(-H "Authorization: Bearer ${HUB_TOKEN}")
+  fi
+  CURL_ARGS+=(-d "{
+    \"type\": \"pr:created\",
+    \"source\": \"peter-parker\",
+    \"data\": {
+      \"task\": ${TASK_JSON},
+      \"pr_url\": \"${PR_URL}\",
+      \"branch\": \"${BRANCH_NAME}\"
+    }
+  }")
+
+  curl "${CURL_ARGS[@]}" 2>/dev/null || echo "PP: Warning - could not post event to hub"
+fi
+
+# 8. Return to base branch
+git checkout "${BASE_BRANCH}" 2>/dev/null || true
+
+echo "PP: Done"

package/scripts/pp-branch-pr.sh.bak

@@ -0,0 +1,115 @@
+#!/bin/bash
+# scripts/pp-branch-pr.sh
+#
+# Wraps Peter Parker agent execution in git branch + PR workflow.
+# Creates a branch, runs the agent, commits changes, opens a PR,
+# and posts a pr:created event to the hub.
+#
+# Called by flow engine spawn action or directly.
+#
+# Usage: pp-branch-pr.sh <task-description> [hub-url] [hub-token]
+
+set -euo pipefail
+
+TASK="${1:?Usage: pp-branch-pr.sh <task-description> [hub-url] [hub-token]}"
+HUB_URL="${2:-}"
+HUB_TOKEN="${3:-}"
+BRANCH_NAME="pp/fix-$(date +%s)"
+BASE_BRANCH="main"
+
+if [ -z "$HUB_URL" ] && [ -f ".jfl/context-hub.port" ]; then
+  PORT=$(cat .jfl/context-hub.port)
+  HUB_URL="http://localhost:${PORT}"
+fi
+if [ -z "$HUB_TOKEN" ] && [ -f ".jfl/context-hub.token" ]; then
+  HUB_TOKEN=$(cat .jfl/context-hub.token)
+fi
+
+echo "PP: Creating branch ${BRANCH_NAME}"
+
+# 1. Create branch from clean main
+git fetch origin "${BASE_BRANCH}" 2>/dev/null || true
+git checkout -b "${BRANCH_NAME}" "origin/${BASE_BRANCH}" 2>/dev/null || git checkout -b "${BRANCH_NAME}" "${BASE_BRANCH}"
+
+# 2. Run Peter Parker
+echo "PP: Running agent on task: ${TASK}"
+jfl peter run --task "${TASK}"
+
+# 3. Check if anything changed
+if git diff --quiet HEAD && [ -z "$(git ls-files --others --exclude-standard)" ]; then
+  echo "PP: No changes made, cleaning up"
+  git checkout "${BASE_BRANCH}" 2>/dev/null || true
+  git branch -D "${BRANCH_NAME}" 2>/dev/null || true
+  exit 0
+fi
+
+# 4. Commit
+git add -A
+COMMIT_MSG="fix(pp): ${TASK}
+
+Agent: peter-parker
+Branch: ${BRANCH_NAME}
+Auto-generated by JFL self-driving loop
+
+Co-authored-by: Peter Parker <pp@jfl.dev>"
+
+git commit -m "${COMMIT_MSG}"
+
+# 5. Push
+git push -u origin "${BRANCH_NAME}"
+
+# 6. Create PR
+PR_TITLE="PP: $(echo "${TASK}" | head -c 60)"
+PR_BODY="## Auto-generated by Peter Parker
+
+**Task:** ${TASK}
+**Branch:** \`${BRANCH_NAME}\`
+
+### Eval Suite
+This PR will be evaluated by the CI eval suite.
+Auto-merge will trigger if eval score improves over baseline.
+
+---
+*Generated by JFL self-driving loop*"
+
+PR_URL=$(gh pr create \
+  --title "${PR_TITLE}" \
+  --body "${PR_BODY}" \
+  --base "${BASE_BRANCH}" \
+  --head "${BRANCH_NAME}" \
+  --label "pp-generated" 2>&1) || {
+  echo "PP: Label may not exist, retrying without label"
+  PR_URL=$(gh pr create \
+    --title "${PR_TITLE}" \
+    --body "${PR_BODY}" \
+    --base "${BASE_BRANCH}" \
+    --head "${BRANCH_NAME}" 2>&1)
+}
+
+echo "PP: PR created at ${PR_URL}"
+
+# 7. Post event to hub
+if [ -n "${HUB_URL}" ]; then
+  TASK_JSON=$(printf '%s' "${TASK}" | python3 -c 'import sys,json; print(json.dumps(sys.stdin.read().strip()))')
+
+  CURL_ARGS=(-s -X POST "${HUB_URL}/api/events" -H "Content-Type: application/json")
+  if [ -n "${HUB_TOKEN}" ]; then
+    CURL_ARGS+=(-H "Authorization: Bearer ${HUB_TOKEN}")
+  fi
+  CURL_ARGS+=(-d "{
+    \"type\": \"pr:created\",
+    \"source\": \"peter-parker\",
+    \"data\": {
+      \"task\": ${TASK_JSON},
+      \"pr_url\": \"${PR_URL}\",
+      \"branch\": \"${BRANCH_NAME}\"
+    }
+  }")
+
+  curl "${CURL_ARGS[@]}" 2>/dev/null || echo "PP: Warning - could not post event to hub"
+fi
+
+# 8. Return to base branch
+git checkout "${BASE_BRANCH}" 2>/dev/null || true
+
+echo "PP: Done"

package/scripts/session/auto-commit.sh

@@ -0,0 +1,297 @@
+#!/bin/bash
+#
+# Auto-commit script for JFL projects
+# Runs in background, commits changes at specified interval
+#
+# Usage:
+#   ./scripts/session/auto-commit.sh start [INTERVAL]  # Start (default 120s)
+#   ./scripts/session/auto-commit.sh stop              # Stop background process
+#   ./scripts/session/auto-commit.sh status            # Check if running
+#   ./scripts/session/auto-commit.sh once              # Run once (for testing)
+#
+# Merges best of:
+# - Original JFL auto-commit (smart messages, author detection, pull first)
+# - Session protection (push after, product handling, faster interval)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# Use current working directory (where script is called from), not script location
+REPO_DIR="$(pwd)"
+PID_FILE="$REPO_DIR/.jfl/auto-commit.pid"
+LOG_FILE="$REPO_DIR/.jfl/auto-commit.log"
+INTERVAL=${2:-120}  # Default 2 minutes (was 5 in original)
+
+mkdir -p "$REPO_DIR/.jfl"
+cd "$REPO_DIR" || exit 1
+
+# Critical paths to always include
+CRITICAL_PATHS=(
+    "knowledge/"
+    "previews/"
+    "content/"
+    "suggestions/"
+    "CLAUDE.md"
+    ".jfl/journal/"
+    ".jfl/config.json"
+)
+
+do_commit() {
+    # Pull latest first (sync with team) - from original
+    git pull --rebase --quiet 2>/dev/null || true
+
+    # Build paths string
+    local paths=""
+    for p in "${CRITICAL_PATHS[@]}"; do
+        if [ -e "$p" ]; then
+            paths="$paths $p"
+        fi
+    done
+
+    # Check for changes
+    if [[ -z $(git status --porcelain $paths 2>/dev/null) ]]; then
+        return 0  # Nothing to commit
+    fi
+
+    # Get list of changed files for commit message - from original
+    CHANGED=$(git status --porcelain $paths | head -5 | awk '{print $2}' | tr '\n' ', ' | sed 's/,$//')
+    CHANGE_COUNT=$(git status --porcelain $paths | wc -l | tr -d ' ')
+
+    # Try to identify who's working (check recent suggestions files) - from original
+    AUTHOR="auto"
+    RECENT_SUGGESTION=$(ls -t suggestions/*.md 2>/dev/null | head -1)
+    if [[ -n "$RECENT_SUGGESTION" ]]; then
+        AUTHOR=$(basename "$RECENT_SUGGESTION" .md)
+    fi
+
+    # Generate commit message - from original style
+    if [[ $CHANGE_COUNT -gt 5 ]]; then
+        MSG="$AUTHOR: auto-save ($CHANGE_COUNT files including $CHANGED...)"
+    else
+        MSG="$AUTHOR: auto-save ($CHANGED)"
+    fi
+
+    # Commit
+    git add $paths
+    git commit -m "$MSG" || return 0
+
+    # Push after commit to current branch
+    local current_branch=$(git branch --show-current)
+    git push origin "$current_branch" 2>/dev/null || echo "[$(date '+%H:%M:%S')] Push failed - will retry"
+
+    echo "[$(date '+%H:%M:%S')] Committed: $MSG"
+}
+
+# Commit and push changes in ALL submodules with feature branches
+commit_submodules_if_changes() {
+    local submodules_dir="$REPO_DIR/.jfl/submodules"
+
+    # If no submodules directory, fall back to legacy product-only handling
+    if [[ ! -d "$submodules_dir" ]]; then
+        # Legacy: check for product-branch file
+        local product_branch_file="$REPO_DIR/.jfl/product-branch"
+        if [[ -f "$product_branch_file" ]]; then
+            commit_single_submodule "product" "$(cat "$product_branch_file")"
+        fi
+        return 0
+    fi
+
+    # Iterate through all submodule branch files (use find for nested paths like libs/mylib)
+    while IFS= read -r -d '' branch_file; do
+        if [[ -f "$branch_file" ]]; then
+            # Get submodule path by stripping the prefix directory
+            local submodule_path="${branch_file#$submodules_dir/}"
+            local target_branch=$(cat "$branch_file")
+            commit_single_submodule "$submodule_path" "$target_branch"
+        fi
+    done < <(find "$submodules_dir" -type f -print0 2>/dev/null)
+}
+
+# Commit changes in a single submodule
+commit_single_submodule() {
+    local submodule_path="$1"
+    local target_branch="$2"
+    local full_path="$REPO_DIR/$submodule_path"
+
+    # Resolve symlink if needed
+    if [[ -L "$full_path" ]]; then
+        full_path=$(cd "$full_path" 2>/dev/null && pwd) || return 0
+    fi
+
+    # Check if submodule has git
+    if [[ -d "$full_path/.git" ]] || [[ -f "$full_path/.git" ]]; then
+        cd "$full_path"
+
+        if [[ -n $(git status --porcelain 2>/dev/null) ]]; then
+            # Make sure we're on the right branch
+            local current_branch=$(git branch --show-current 2>/dev/null)
+            if [[ "$current_branch" != "$target_branch" ]] && [[ "$target_branch" != "main" ]]; then
+                git checkout "$target_branch" 2>/dev/null || true
+            fi
+
+            git add -A
+            git commit -m "auto: $submodule_path save ($(date '+%Y-%m-%d %H:%M'))" || true
+
+            # Push to feature branch (NOT main)
+            if [[ "$target_branch" != "main" ]]; then
+                git push origin "$target_branch" 2>/dev/null || true
+                echo "[$(date '+%H:%M:%S')] $submodule_path committed to branch: $target_branch"
+            else
+                # No feature branch - warn but don't push to main
+                echo "[$(date '+%H:%M:%S')] $submodule_path committed locally (no feature branch set)"
+            fi
+        fi
+
+        cd "$REPO_DIR"
+    fi
+}
+
+# Graceful shutdown handler - ensures final commit before exit
+graceful_shutdown() {
+    echo "[$(date '+%H:%M:%S')] Received shutdown signal - saving final changes..." >> "$LOG_FILE" 2>&1
+
+    # Run final commit to save any pending work
+    {
+        do_commit
+        commit_submodules_if_changes
+    } >> "$LOG_FILE" 2>&1
+
+    # Run session cleanup (auto-merge and remove worktree if safe)
+    if [[ -f "$SCRIPT_DIR/session-cleanup.sh" ]]; then
+        echo "[$(date '+%H:%M:%S')] Running session cleanup..." >> "$LOG_FILE" 2>&1
+        bash "$SCRIPT_DIR/session-cleanup.sh" >> "$LOG_FILE" 2>&1 || true
+    fi
+
+    echo "[$(date '+%H:%M:%S')] Shutdown complete." >> "$LOG_FILE" 2>&1
+    rm -f "$PID_FILE"
+    exit 0
+}
+
+start_daemon() {
+    if [[ -f "$PID_FILE" ]]; then
+        local pid=$(cat "$PID_FILE")
+        if kill -0 "$pid" 2>/dev/null; then
+            echo "Auto-commit already running (PID: $pid)"
+            return 0
+        fi
+        rm -f "$PID_FILE"
+    fi
+
+    echo "Starting auto-commit daemon (interval: ${INTERVAL}s)..."
+
+    # Run in background with signal handling
+    # Close inherited file descriptors so parent doesn't wait for us
+    (
+        exec </dev/null >/dev/null 2>&1
+
+        # Trap signals for graceful shutdown (added SIGHUP for terminal close)
+        trap graceful_shutdown SIGINT SIGTERM SIGQUIT SIGHUP
+
+        # Track parent process to detect when Claude dies
+        INITIAL_PPID=$PPID
+
+        while true; do
+            {
+                # Check if parent process (Claude) is still alive
+                if ! kill -0 "$INITIAL_PPID" 2>/dev/null; then
+                    echo "[$(date '+%H:%M:%S')] Parent process died (PPID $INITIAL_PPID) - running cleanup..."
+                    graceful_shutdown
+                fi
+
+                echo "[$(date '+%H:%M:%S')] Checking for changes..."
+                do_commit
+                commit_submodules_if_changes
+            } >> "$LOG_FILE" 2>&1
+            sleep "$INTERVAL"
+        done
+    ) &
+
+    DAEMON_PID=$!
+    echo "$DAEMON_PID" > "$PID_FILE"
+    echo "Auto-commit started (PID: $DAEMON_PID)"
+    echo "Log: $LOG_FILE"
+}
+
+stop_daemon() {
+    if [[ -f "$PID_FILE" ]]; then
+        local pid=$(cat "$PID_FILE")
+        if kill -0 "$pid" 2>/dev/null; then
+            echo "Stopping auto-commit (PID: $pid)..."
+
+            # Send SIGTERM for graceful shutdown (runs final commit)
+            kill -TERM "$pid" 2>/dev/null
+
+            # Wait up to 10 seconds for graceful shutdown
+            local wait_count=0
+            while kill -0 "$pid" 2>/dev/null && [ $wait_count -lt 20 ]; do
+                sleep 0.5
+                wait_count=$((wait_count + 1))
+            done
+
+            # If still running after timeout, force kill
+            if kill -0 "$pid" 2>/dev/null; then
+                echo "Graceful shutdown timed out, forcing..."
+                kill -9 "$pid" 2>/dev/null
+                rm -f "$PID_FILE"
+            fi
+
+            echo "Stopped."
+        else
+            echo "Process not running (stale PID file)"
+            rm -f "$PID_FILE"
+        fi
+    else
+        echo "Auto-commit not running"
+    fi
+}
+
+show_status() {
+    if [[ -f "$PID_FILE" ]]; then
+        local pid=$(cat "$PID_FILE")
+        if kill -0 "$pid" 2>/dev/null; then
+            echo "Auto-commit running (PID: $pid)"
+            echo "Interval: ${INTERVAL}s"
+            echo "Log: $LOG_FILE"
+            echo ""
+            echo "Recent activity:"
+            tail -5 "$LOG_FILE" 2>/dev/null || echo "  (no log yet)"
+            return 0
+        fi
+    fi
+    echo "Auto-commit not running"
+    return 1
+}
+
+run_once() {
+    echo "Running single commit check..."
+    do_commit
+    commit_submodules_if_changes
+    echo "Done."
+}
+
+case "${1:-}" in
+    start)
+        start_daemon
+        ;;
+    stop)
+        stop_daemon
+        ;;
+    status)
+        show_status
+        ;;
+    once)
+        run_once
+        ;;
+    *)
+        echo "Auto-commit for JFL projects"
+        echo ""
+        echo "Usage:"
+        echo "  $0 start [INTERVAL]  Start daemon (default: 120s)"
+        echo "  $0 stop              Stop daemon"
+        echo "  $0 status            Show status"
+        echo "  $0 once              Run once"
+        echo ""
+        echo "Examples:"
+        echo "  $0 start 60          Start with 1-minute interval"
+        echo "  $0 start             Start with 2-minute interval"
+        exit 1
+        ;;
+esac