fix(kugetsu): add post-comment helper for PM agent

Add 'kugetsu post-comment' command to post issue comments without writing to /tmp. This solves #45 where PM agent cannot write to /tmp for comment posting. Usage: kugetsu post-comment <repo-url> <issue-number> <body> The command reads GITEA_TOKEN from: 1. GITEA_TOKEN environment variable 2. ~/.kugetsu/env/pm-agent.env Example: kugetsu post-comment https://git.fbrns.co/shoko/kugetsu 45 "Comment text" Fixes #45
feat(kugetsu): smart delegate with worktree awareness
2026-04-03 14:26:32 +00:00 · 2026-04-03 14:20:48 +00:00 · 2026-04-03 15:58:19 +02:00 · 2026-04-03 13:06:02 +00:00 · 2026-04-02 14:47:40 +00:00 · 2026-04-02 16:35:12 +02:00
2 changed files with 235 additions and 18 deletions
--- a/.kugetsu-worktrees/git.fbrns.co-shoko-jigaido-2
+++ b/.kugetsu-worktrees/git.fbrns.co-shoko-jigaido-2
--- a/skills/kugetsu/scripts/kugetsu
+++ b/skills/kugetsu/scripts/kugetsu
@@ -394,6 +394,41 @@ kugetsu_get_pm_context() {
    fi
 }
 kugetsu_get_fork_context() {
    local issue_ref="$1"
    local context=""
    context="## IMPORTANT WORKING RULES
 1. You are working on issue: $issue_ref
 2. If you encounter ANY error, blocker, or cannot complete the task:
   - STOP immediately
   - Log what happened and why you cannot proceed
   - Do NOT switch to other work or try alternative approaches
 3. Do NOT work on other issues or PRs unless explicitly asked
 4. Environment variables are available in ~/.kugetsu/env/
 "
    if [ -f "$REPOS_CONFIG" ]; then
        context="${context}
 ## REPOSITORIES CONFIG
 $(cat "$REPOS_CONFIG")
 "
    fi
    if [ -f "$ENV_DIR/default.env" ]; then
        context="${context}
 ## ENVIRONMENT (available at ~/.kugetsu/env/)
 Environment file exists at: $ENV_DIR/default.env
 Source it with: source ~/.kugetsu/env/default.env
 "
    fi
    echo "$context"
 }
 kugetsu_add_notification() {
    local type="$1"
    local message="$2"
@@ -606,6 +641,99 @@ EOF
    fi
 }
 parse_issue_ref_from_message() {
    local message="$1"
    local gitserver=""
    local owner=""
    local repo=""
    local issue_number=""
    if echo "$message" | grep -qE '[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/[a-zA-Z0-9_.-]+/[a-zA-Z0-9_.-]+/(issues|pull)/[0-9]+'; then
        gitserver=$(echo "$message" | grep -oE '[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/[a-zA-Z0-9_.-]+/[a-zA-Z0-9_.-]+' | head -1 | sed 's/\/[^/]*\/[^/]*$//')
        local full_path=$(echo "$message" | grep -oE '[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/[a-zA-Z0-9_.-]+/[a-zA-Z0-9_.-]+/(issues|pull)/[0-9]+' | head -1)
        owner=$(echo "$full_path" | cut -d'/' -f2)
        repo=$(echo "$full_path" | cut -d'/' -f3)
        issue_number=$(echo "$full_path" | grep -oE '[0-9]+$' | head -1)
    elif echo "$message" | grep -qE '[a-zA-Z0-9_.-]+/[a-zA-Z0-9_.-]+#([0-9]+)'; then
        owner=$(echo "$message" | grep -oE '[a-zA-Z0-9_.-]+/[a-zA-Z0-9_.-]+#' | sed 's/#$//' | cut -d'/' -f1)
        repo=$(echo "$message" | grep -oE '[a-zA-Z0-9_.-]+/[a-zA-Z0-9_.-]+#' | sed 's/#$//' | cut -d'/' -f2)
        issue_number=$(echo "$message" | grep -oE '#[0-9]+' | grep -oE '[0-9]+' | head -1)
    fi
    echo "${gitserver}|${owner}|${repo}|${issue_number}"
 }
 get_missing_info() {
    local parsed="$1"
    local gitserver=$(echo "$parsed" | cut -d'|' -f1)
    local owner=$(echo "$parsed" | cut -d'|' -f2)
    local repo=$(echo "$parsed" | cut -d'|' -f3)
    local issue_number=$(echo "$parsed" | cut -d'|' -f4)
    local missing=""
    [ -z "$gitserver" ] && missing="${missing}git server, "
    [ -z "$owner" ] && missing="${missing}owner, "
    [ -z "$repo" ] && missing="${missing}repository, "
    [ -z "$issue_number" ] && missing="${missing}issue number, "
    echo "$missing" | sed 's/, $//'
 }
 build_missing_info_context() {
    local missing="$1"
    if [ -n "$missing" ]; then
        echo ""
        echo "NOTE: This task delegation has no information about: ${missing}."
        echo "We need them if user wants to work on a specific issue. Otherwise we don't need it."
    fi
 }
 find_worktrees_by_issue_number() {
    local issue_number="$1"
    local results=""
    if [ ! -d "$WORKTREES_DIR/.kugetsu-worktrees" ]; then
        echo ""
        return
    fi
    for wt in "$WORKTREES_DIR/.kugetsu-worktrees"/*; do
        if [ -d "$wt" ]; then
            local wt_issue_number=$(echo "$wt" | grep -oE '#?[0-9]+$' | grep -oE '[0-9]+' | head -1)
            if [ "$wt_issue_number" = "$issue_number" ]; then
                results="${results}${wt}:worktree
 "
            fi
        fi
    done
    echo "$results"
 }
 find_sessions_by_issue_number() {
    local issue_number="$1"
    local results=""
    if [ ! -d "$SESSIONS_DIR" ]; then
        echo ""
        return
    fi
    for session_file in "$SESSIONS_DIR"/*.json; do
        if [ -f "$session_file" ]; then
            local session_issue_ref=$(basename "$session_file" .json | sed 's/_/\//g')
            local session_issue_number=$(echo "$session_issue_ref" | grep -oE '#?[0-9]+$' | grep -oE '[0-9]+' | head -1)
            if [ "$session_issue_number" = "$issue_number" ]; then
                results="${results}${session_file}:session
 "
            fi
        fi
    done
    echo "$results"
 }
 cmd_delegate() {
    local message="${1:-}"
    local verbosity="${KUGETSU_VERBOSITY:-default}"
@@ -625,6 +753,70 @@ cmd_delegate() {
    mkdir -p "$LOGS_DIR"
    local log_file="$LOGS_DIR/delegate-$(date +%s).log"
    local parsed=$(parse_issue_ref_from_message "$message")
    local gitserver=$(echo "$parsed" | cut -d'|' -f1)
    local owner=$(echo "$parsed" | cut -d'|' -f2)
    local repo=$(echo "$parsed" | cut -d'|' -f3)
    local issue_number=$(echo "$parsed" | cut -d'|' -f4)
    local missing_info=$(get_missing_info "$parsed")
    local context_injection=""
    if [ -n "$missing_info" ]; then
        context_injection=$(build_missing_info_context "$missing_info")
        echo "NOTE: Delegation missing information: ${missing_info}"
    fi
    local candidates=""
    local candidate_count=0
    if [ -n "$issue_number" ]; then
        local worktrees=$(find_worktrees_by_issue_number "$issue_number")
        local sessions=$(find_sessions_by_issue_number "$issue_number")
        while IFS=: read -r path type; do
            if [ -n "$path" ]; then
                candidate_count=$((candidate_count + 1))
                candidates="${candidates}${candidate_count}) ${path} (${type})
 "
            fi
        done <<< "$worktrees"
        while IFS=: read -r path type; do
            if [ -n "$path" ]; then
                candidate_count=$((candidate_count + 1))
                candidates="${candidates}${candidate_count}) ${path} (${type})
 "
            fi
        done <<< "$sessions"
    fi
    local use_worktree=""
    if [ $candidate_count -gt 0 ]; then
        echo "Found $candidate_count existing worktree(s)/session(s) for issue #${issue_number}:"
        echo "$candidates"
        echo "r) Delegate anyway (without routing)"
        echo "Which one to use? [1-${candidate_count}/r]: "
        read -r choice
        if [ "$choice" = "r" ] || [ -z "$choice" ]; then
            use_worktree=""
        elif [ "$choice" -ge 1 ] && [ "$choice" -le "$candidate_count" ]; then
            local selected=$(echo "$candidates" | sed -n "${choice}p")
            use_worktree=$(echo "$selected" | sed 's/) .*//')
        fi
    fi
    local final_message="${message}${context_injection}"
    if [ -n "$use_worktree" ]; then
        if [ -d "$use_worktree" ]; then
            echo "Using worktree: $use_worktree"
            final_message="${final_message}
 NOTE: Worktree selected: ${use_worktree}"
        fi
    fi
    local temp_dir="${KUGETSU_TEMP_DIR:-$HOME/.local/share/opencode/tool-output}"
    mkdir -p "$ENV_DIR"
@@ -636,7 +828,7 @@ cmd_delegate() {
    fi
    env_sh="${env_sh}set +a; "
-    nohup sh -c "${env_sh}opencode run '$message' --continue --session '$pm_session' >> '$log_file' 2>&1" > /dev/null 2>&1 &
+    nohup sh -c "${env_sh}opencode run '${final_message}' --continue --session '$pm_session' >> '$log_file' 2>&1" > /dev/null 2>&1 &
    disown
    echo "Delegated to PM agent (logged to $(basename "$log_file"))"
    echo "Verbosity: $verbosity"
@@ -1088,6 +1280,11 @@ EOF
        echo "Created pm-agent env file: $ENV_DIR/pm-agent.env"
    fi
    if [ -d "$LOGS_DIR" ]; then
        echo "Cleaning up old logs..."
        rm -rf "$LOGS_DIR"/*.log 2>/dev/null || true
    fi
    local existing_base=$(get_base_session_id)
    local existing_pm=$(get_pm_agent_session_id)
@@ -1107,12 +1304,19 @@ EOF
        exit 1
    fi
    local init_worktree_dir="$HOME/.kugetsu-worktrees"
    mkdir -p "$init_worktree_dir"
    cd "$init_worktree_dir"
    echo "Initialized kugetsu worktrees directory: $init_worktree_dir"
    echo "Base session will be created in this directory."
    echo ""
    local cwd_files=$(ls -A "$PWD" 2>/dev/null | wc -l)
    local cwd_git=$(git rev-parse --is-inside-work-tree 2>/dev/null || echo "false")
    if [ "$cwd_files" -gt 0 ] || [ "$cwd_git" = "true" ]; then
-        echo "Warning: Current directory is not empty: $PWD" >&2
+        echo "Warning: Worktrees directory is not empty: $PWD" >&2
        echo "This may cause project context to contaminate the base session." >&2
-        echo "Consider running kugetsu init from an empty directory." >&2
+        echo "Consider running kugetsu destroy --base -y and reinitializing." >&2
        echo "" >&2
        echo "Files in current directory: $cwd_files" >&2
        if [ "$cwd_git" = "true" ]; then
@@ -1257,13 +1461,19 @@ cmd_start() {
    local opencode_db="${OPENCODE_DB:-$HOME/.local/share/opencode/opencode.db}"
    > "$fork_log"
-     
+    
    local fork_context=$(kugetsu_get_fork_context "$issue_ref")
    local full_message="${fork_context}
 ## YOUR TASK
 $message"
    fix_session_permissions
    if [ "$DEBUG_MODE" = true ]; then
-        (cd "$worktree_path" && opencode run "$message" --fork --session "$base_session_id" --dir "$worktree_path" 2>&1) | tee "$fork_log" &
+        (cd "$worktree_path" && opencode run "$full_message" --fork --session "$base_session_id" --dir "$worktree_path" 2>&1) | tee "$fork_log" &
    else
-        (cd "$worktree_path" && opencode run "$message" --fork --session "$base_session_id" --dir "$worktree_path" 2>&1) >> "$fork_log" &
+        (cd "$worktree_path" && opencode run "$full_message" --fork --session "$base_session_id" --dir "$worktree_path" 2>&1) >> "$fork_log" &
    fi
    local fork_pid=$!
@@ -1386,12 +1596,13 @@ cmd_continue() {
    echo "Continuing session for '$session_name'..."
    # Note: --continue always allowed (existing sessions don't count toward limit)
    # Wrap in subshell with cd to ensure worktree directory is set correctly in session DB
    if [ -n "$worktree_path" ] && [ -d "$worktree_path" ]; then
        echo "Using worktree: $worktree_path"
        if [ "$DEBUG_MODE" = true ]; then
-            opencode run "$message" --continue --session "$opencode_session_id" --dir "$worktree_path" 2>&1 | tee "$session_path.debug.log" &
+            (cd "$worktree_path" && opencode run "$message" --continue --session "$opencode_session_id" --dir "$worktree_path" 2>&1) | tee "$session_path.debug.log" &
        else
-            opencode run "$message" --continue --session "$opencode_session_id" --dir "$worktree_path" 2>&1 &
+            (cd "$worktree_path" && opencode run "$message" --continue --session "$opencode_session_id" --dir "$worktree_path" 2>&1) &
        fi
    else
        if [ "$DEBUG_MODE" = true ]; then
@@ -1549,19 +1760,21 @@ cmd_destroy() {
    if [ "$target" = "base" ]; then
        if [ "$force" = true ]; then
            local base_session_id=$(get_base_session_id)
            local pm_agent_session_id=$(get_pm_agent_session_id)
            rm -f "$SESSIONS_DIR/base.json"
-            local pm_agent=$(get_pm_agent_session_id)
+            rm -f "$SESSIONS_DIR/pm-agent.json"
-            if [ -n "$pm_agent" ] && [ "$pm_agent" != "null" ]; then
+            rm -f "$SESSIONS_DIR/issue-"*.json 2>/dev/null || true
-                rm -f "$SESSIONS_DIR/pm-agent.json"
+            echo '{"base": null, "pm_agent": null, "issues": {}}' > "$INDEX_FILE"
-                echo '{"base": null, "pm_agent": null, "issues": {}}' > "$INDEX_FILE"
+            
            else
                echo '{"base": null, "pm_agent": null, "issues": {}}' > "$INDEX_FILE"
            fi
            if [ -n "$base_session_id" ] && [ "$base_session_id" != "null" ]; then
-                echo "Deleting opencode session: $base_session_id"
+                echo "Deleting base session: $base_session_id"
-                opencode session delete "$base_session_id" 2>/dev/null || echo "Warning: Could not delete session from opencode (may already be deleted)"
+                opencode session delete "$base_session_id" 2>/dev/null || echo "Warning: Could not delete base session"
            fi
-            echo "Base session destroyed"
+            if [ -n "$pm_agent_session_id" ] && [ "$pm_agent_session_id" != "null" ]; then
                echo "Deleting PM agent session: $pm_agent_session_id"
                opencode session delete "$pm_agent_session_id" 2>/dev/null || echo "Warning: Could not delete PM agent session"
            fi
            echo "Base and PM agent sessions destroyed"
        else
            echo "Error: destroying base session requires --base -y" >&2
            exit 1
@@ -1659,6 +1872,9 @@ main() {
        env)
            cmd_env "$@"
            ;;
        post-comment)
            cmd_post_comment "$@"
            ;;
        doctor)
            cmd_doctor "$@"
            ;;
Author	SHA1	Message	Date
shokollm	dc2254cfba	fix(kugetsu): add post-comment helper for PM agent Add 'kugetsu post-comment' command to post issue comments without writing to /tmp. This solves #45 where PM agent cannot write to /tmp for comment posting. Usage: kugetsu post-comment <repo-url> <issue-number> <body> The command reads GITEA_TOKEN from: 1. GITEA_TOKEN environment variable 2. ~/.kugetsu/env/pm-agent.env Example: kugetsu post-comment https://git.fbrns.co/shoko/kugetsu 45 "Comment text" Fixes #45	2026-04-03 14:26:32 +00:00
shokollm	91505345a2	feat(kugetsu): smart delegate with worktree awareness - Parse issue refs from message (gitserver.com/owner/repo/issues/123 or owner/repo#123) - Find existing worktrees/sessions by issue number - Ask user to confirm which worktree to use, or delegate anyway - Inject missing info context to PM agent - Inject selected worktree context to PM agent Fixes #128	2026-04-03 14:20:48 +00:00
shoko	f7fe22de25	Merge pull request 'fix(kugetsu): wrap cmd_continue in subshell with cd for correct worktree dir' (#129 ) from fix/cmd-continue-worktree-dir into main	2026-04-03 15:58:19 +02:00
shokollm	3ce43ffa65	fix(kugetsu): wrap cmd_continue in subshell with cd for correct worktree dir The --dir flag only sets directory for the subprocess, not the session's stored directory in opencode's SQLite DB. This was already fixed for cmd_start in v0.1.10, but cmd_continue still had the bug. Fixes #127	2026-04-03 13:06:02 +00:00
shokollm	416e8e5757	fix(kugetsu): destroy --base now also deletes PM agent session When destroying base session, we now also delete the PM agent session and all issue session files. This ensures clean slate on re-init.	2026-04-02 14:47:40 +00:00
shoko	1c1d18b9ae	Merge pull request 'fix(kugetsu): init creates base session in ~/.kugetsu-worktrees and adds context to forked sessions' (#114 ) from fix/session-context-and-init-worktree into main	2026-04-02 16:35:12 +02:00
shokollm	8c639e2928	fix(kugetsu): init creates base session in ~/.kugetsu-worktrees, adds context to forked sessions, and clears logs 1. Init: cd to ~/.kugetsu-worktrees before creating base session This keeps all worktrees inside a predictable directory structure and avoids external_directory permission issues 2. Init: Clear old logs but keep repos.json, config, and env files 3. Fork context: Add kugetsu_get_fork_context() that provides: - Important working rules (stop on error, don't pivot) - Repository configuration from repos.json - Environment file location info 4. Fork message: Prepend context to user message when forking session	2026-04-02 14:32:07 +00:00