@mindfoldhq/trellis 0.1.0

package/dist/templates/scripts/add-session.sh.txt

@@ -0,0 +1,384 @@
+#!/bin/bash
+# Add a new session to progress file and update index.md
+#
+# Usage:
+#   ./.trellis/scripts/add-session.sh --title "Title" --commit "hash" --summary "Summary"
+#   echo "content" | ./.trellis/scripts/add-session.sh --title "Title" --commit "hash"
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common/paths.sh"
+source "$SCRIPT_DIR/common/developer.sh"
+
+MAX_LINES=2000
+TODAY=$(date +%Y-%m-%d)
+
+# Ensure developer is initialized
+ensure_developer
+
+DEVELOPER=$(get_developer)
+REPO_ROOT=$(get_repo_root)
+DEV_DIR="$REPO_ROOT/$DIR_WORKFLOW/$DIR_PROGRESS/$DEVELOPER"
+INDEX_FILE="$DEV_DIR/index.md"
+
+# =============================================================================
+# Helper Functions
+# =============================================================================
+
+get_latest_progress_info() {
+  local latest_file=""
+  local latest_num=0
+
+  for f in "$DEV_DIR"/progress-*.md; do
+    if [[ -f "$f" ]]; then
+      local num=$(basename "$f" | sed 's/progress-\([0-9]*\)\.md/\1/')
+      if [[ "$num" -gt "$latest_num" ]]; then
+        latest_num=$num
+        latest_file="$f"
+      fi
+    fi
+  done
+
+  if [[ -n "$latest_file" ]]; then
+    local lines=$(wc -l < "$latest_file" | tr -d ' ')
+    echo "$latest_file:$latest_num:$lines"
+  else
+    echo ":0:0"
+  fi
+}
+
+get_current_session() {
+  local line=$(grep "Total Sessions" "$INDEX_FILE" 2>/dev/null | head -1)
+  echo "$line" | sed 's/.*: //' | tr -d ' '
+}
+
+count_progress_files() {
+  local result=""
+  local progress_info=$(get_latest_progress_info)
+  local active_num=$(echo "$progress_info" | cut -d: -f2)
+  local active_file="progress-$active_num.md"
+
+  for f in $(ls -v "$DEV_DIR"/progress-*.md 2>/dev/null | sort -t- -k2 -n -r); do
+    if [[ -f "$f" ]]; then
+      local filename=$(basename "$f")
+      local lines=$(wc -l < "$f" | tr -d ' ')
+
+      local status="Archived"
+      if [[ "$filename" == "$active_file" ]]; then
+        status="Active"
+      fi
+
+      result="${result}| \`$filename\` | ~$lines | $status |
+"
+    fi
+  done
+  echo "$result" | sed '/^$/d'
+}
+
+create_new_progress_file() {
+  local num=$1
+  local prev_num=$((num - 1))
+  local new_file="$DEV_DIR/progress-$num.md"
+
+  cat > "$new_file" << EOF
+# Agent Progress - $DEVELOPER (Part $num)
+
+> Continuation from \`progress-$prev_num.md\` (archived at ~$MAX_LINES lines)
+> Started: $TODAY
+
+---
+
+EOF
+  echo "$new_file"
+}
+
+generate_session_content() {
+  local session_num=$1
+  local title=$2
+  local commit=$3
+  local summary=$4
+  local extra_content=$5
+
+  local commit_table=""
+  if [[ -n "$commit" && "$commit" != "-" ]]; then
+    commit_table="| Hash | Message |
+|------|---------|"
+    IFS=',' read -ra COMMITS <<< "$commit"
+    for c in "${COMMITS[@]}"; do
+      c=$(echo "$c" | tr -d ' ')
+      commit_table="$commit_table
+| \`$c\` | (see git log) |"
+    done
+  else
+    commit_table="(No commits - planning session)"
+  fi
+
+  cat << EOF
+
+## Session $session_num: $title
+
+**Date**: $TODAY
+**Feature**: $title
+
+### Summary
+
+$summary
+
+### Main Changes
+
+$extra_content
+
+### Git Commits
+
+$commit_table
+
+### Testing
+
+- [OK] (Add test results)
+
+### Status
+
+[OK] **Completed**
+
+### Next Steps
+
+- None - feature complete
+EOF
+}
+
+# =============================================================================
+# Update Index.md
+# =============================================================================
+
+update_index() {
+  local title="$1"
+  local commit="$2"
+  local new_session="$3"
+  local active_file="$4"
+
+  # Format commit for display
+  local commit_display="-"
+  if [[ -n "$commit" && "$commit" != "-" ]]; then
+    commit_display=$(echo "$commit" | sed 's/,/, /g' | sed 's/\([a-f0-9]\{7,\}\)/`\1`/g')
+  fi
+
+  local files_table=$(count_progress_files)
+
+  echo "Updating index.md for session $new_session..."
+  echo "  Title: $title"
+  echo "  Commit: $commit_display"
+  echo "  Active File: $active_file"
+  echo ""
+
+  if ! grep -q "@@@auto:current-status" "$INDEX_FILE"; then
+    echo "Error: Markers not found in index.md. Please ensure markers exist." >&2
+    exit 1
+  fi
+
+  local tmp_file=$(mktemp)
+
+  local in_current_status=false
+  local in_active_documents=false
+  local in_session_history=false
+  local header_written=false
+
+  while IFS= read -r line || [[ -n "$line" ]]; do
+    if [[ "$line" == *"@@@auto:current-status"* ]]; then
+      echo "$line" >> "$tmp_file"
+      in_current_status=true
+      echo "- **Active File**: \`$active_file\`" >> "$tmp_file"
+      echo "- **Total Sessions**: $new_session" >> "$tmp_file"
+      echo "- **Last Active**: $TODAY" >> "$tmp_file"
+      continue
+    fi
+
+    if [[ "$line" == *"@@@/auto:current-status"* ]]; then
+      in_current_status=false
+      echo "$line" >> "$tmp_file"
+      continue
+    fi
+
+    if [[ "$line" == *"@@@auto:active-documents"* ]]; then
+      echo "$line" >> "$tmp_file"
+      in_active_documents=true
+      echo "| File | Lines | Status |" >> "$tmp_file"
+      echo "|------|-------|--------|" >> "$tmp_file"
+      echo "$files_table" >> "$tmp_file"
+      continue
+    fi
+
+    if [[ "$line" == *"@@@/auto:active-documents"* ]]; then
+      in_active_documents=false
+      echo "$line" >> "$tmp_file"
+      continue
+    fi
+
+    if [[ "$line" == *"@@@auto:session-history"* ]]; then
+      echo "$line" >> "$tmp_file"
+      in_session_history=true
+      header_written=false
+      continue
+    fi
+
+    if [[ "$line" == *"@@@/auto:session-history"* ]]; then
+      in_session_history=false
+      echo "$line" >> "$tmp_file"
+      continue
+    fi
+
+    if $in_current_status; then
+      continue
+    fi
+
+    if $in_active_documents; then
+      continue
+    fi
+
+    if $in_session_history; then
+      echo "$line" >> "$tmp_file"
+      if [[ "$line" == "|---"* ]] && ! $header_written; then
+        echo "| $new_session | $TODAY | $title | $commit_display |" >> "$tmp_file"
+        header_written=true
+      fi
+      continue
+    fi
+
+    echo "$line" >> "$tmp_file"
+  done < "$INDEX_FILE"
+
+  mv "$tmp_file" "$INDEX_FILE"
+
+  echo "[OK] Updated index.md successfully!"
+}
+
+# =============================================================================
+# Main Function
+# =============================================================================
+
+add_session() {
+  local title=""
+  local commit="-"
+  local summary="(Add summary)"
+  local content_file=""
+  local extra_content="(Add details)"
+
+  while [[ $# -gt 0 ]]; do
+    case $1 in
+      --title)
+        title="$2"
+        shift 2
+        ;;
+      --commit)
+        commit="$2"
+        shift 2
+        ;;
+      --summary)
+        summary="$2"
+        shift 2
+        ;;
+      --content-file)
+        content_file="$2"
+        shift 2
+        ;;
+      *)
+        shift
+        ;;
+    esac
+  done
+
+  if [[ -z "$title" ]]; then
+    echo "Error: --title is required" >&2
+    echo "Usage: $0 --title \"Session Title\" [--commit \"hash1,hash2\"] [--summary \"Brief summary\"]" >&2
+    exit 1
+  fi
+
+  if [[ -n "$content_file" && -f "$content_file" ]]; then
+    extra_content=$(cat "$content_file")
+  elif [[ ! -t 0 ]]; then
+    extra_content=$(cat)
+  fi
+
+  local progress_info=$(get_latest_progress_info)
+  local current_file=$(echo "$progress_info" | cut -d: -f1)
+  local current_num=$(echo "$progress_info" | cut -d: -f2)
+  local current_lines=$(echo "$progress_info" | cut -d: -f3)
+  local current_session=$(get_current_session)
+  local new_session=$((current_session + 1))
+
+  local session_content=$(generate_session_content "$new_session" "$title" "$commit" "$summary" "$extra_content")
+  local content_lines=$(echo "$session_content" | wc -l | tr -d ' ')
+
+  echo "========================================" >&2
+  echo "ADD SESSION" >&2
+  echo "========================================" >&2
+  echo "" >&2
+  echo "Session: $new_session" >&2
+  echo "Title: $title" >&2
+  echo "Commit: $commit" >&2
+  echo "" >&2
+  echo "Current progress file: progress-$current_num.md" >&2
+  echo "Current lines: $current_lines" >&2
+  echo "New content lines: $content_lines" >&2
+  echo "Total after append: $((current_lines + content_lines))" >&2
+  echo "" >&2
+
+  local target_file="$current_file"
+  local target_num=$current_num
+
+  if [[ $((current_lines + content_lines)) -gt $MAX_LINES ]]; then
+    target_num=$((current_num + 1))
+    echo "[!] Exceeds $MAX_LINES lines, creating progress-$target_num.md" >&2
+    target_file=$(create_new_progress_file "$target_num")
+    echo "Created: $target_file" >&2
+  fi
+
+  echo "$session_content" >> "$target_file"
+  echo "[OK] Appended session to $(basename "$target_file")" >&2
+
+  echo "" >&2
+
+  # Update index.md directly
+  local active_file="progress-$target_num.md"
+  update_index "$title" "$commit" "$new_session" "$active_file"
+
+  echo "" >&2
+  echo "========================================" >&2
+  echo "[OK] Session $new_session added successfully!" >&2
+  echo "========================================" >&2
+  echo "" >&2
+  echo "Files updated:" >&2
+  echo "  - $(basename "$target_file")" >&2
+  echo "  - index.md" >&2
+}
+
+show_help() {
+  echo "Usage: $0 --title \"Title\" [options]"
+  echo ""
+  echo "Add a new session to progress file and update index.md automatically."
+  echo ""
+  echo "Options:"
+  echo "  --title TEXT       Session title (required)"
+  echo "  --commit HASHES    Comma-separated commit hashes (optional)"
+  echo "  --summary TEXT     Brief summary of the session (optional)"
+  echo "  --content-file     Path to file with detailed content (optional)"
+  echo ""
+  echo "You can also pipe content via stdin:"
+  echo "  echo \"Details\" | $0 --title \"Title\" --commit \"abc123\""
+  echo ""
+  echo "Examples:"
+  echo "  $0 --title \"Fix login bug\" --commit \"abc1234\" --summary \"Fixed auth issue\""
+}
+
+# =============================================================================
+# Main Entry
+# =============================================================================
+
+case "${1:-}" in
+  --help|-h|help)
+    show_help
+    ;;
+  *)
+    add_session "$@"
+    ;;
+esac

package/dist/templates/scripts/common/developer.sh.txt

@@ -0,0 +1,130 @@
+#!/bin/bash
+# Developer management utilities
+#
+# Usage: source this file in other scripts
+#   source "$(dirname "$0")/common/developer.sh"
+#
+# Provides:
+#   init_developer     - Initialize developer
+#   ensure_developer   - Ensure developer is initialized (exit if not)
+#   show_developer_info - Show developer information
+
+# Ensure paths.sh is loaded
+if ! type get_repo_root &>/dev/null; then
+  source "$(dirname "${BASH_SOURCE[0]}")/paths.sh"
+fi
+
+# =============================================================================
+# Developer Initialization
+# =============================================================================
+
+init_developer() {
+  local name="$1"
+  local repo_root="${2:-$(get_repo_root)}"
+
+  if [[ -z "$name" ]]; then
+    echo "Error: developer name is required" >&2
+    return 1
+  fi
+
+  local dev_file="$repo_root/$DIR_WORKFLOW/$FILE_DEVELOPER"
+  local progress_dir="$repo_root/$DIR_WORKFLOW/$DIR_PROGRESS/$name"
+
+  # Create .developer file
+  cat > "$dev_file" << EOF
+name=$name
+initialized_at=$(date -Iseconds)
+EOF
+
+  # Create directory structure
+  mkdir -p "$progress_dir/$DIR_FEATURES"
+  mkdir -p "$progress_dir/$DIR_FEATURES/$DIR_ARCHIVE"
+
+  # Create initial progress file
+  local progress_file="$progress_dir/progress-1.md"
+  if [[ ! -f "$progress_file" ]]; then
+    cat > "$progress_file" << PROGRESS_EOF
+# Agent Progress - $name (Part 1)
+
+> AI development session progress tracking
+> Started: $(date +%Y-%m-%d)
+
+---
+
+PROGRESS_EOF
+  fi
+
+  # Create index.md with markers for auto-update
+  local index_file="$progress_dir/index.md"
+  if [[ ! -f "$index_file" ]]; then
+    cat > "$index_file" << INDEX_EOF
+# Agent Progress Index - $name
+
+> Progress tracking for AI development sessions.
+
+---
+
+## Current Status
+
+<!-- @@@auto:current-status -->
+- **Active File**: \`progress-1.md\`
+- **Total Sessions**: 0
+- **Last Active**: -
+<!-- @@@/auto:current-status -->
+
+---
+
+## Active Documents
+
+<!-- @@@auto:active-documents -->
+| File | Lines | Status |
+|------|-------|--------|
+| \`progress-1.md\` | ~0 | Active |
+<!-- @@@/auto:active-documents -->
+
+---
+
+## Session History
+
+<!-- @@@auto:session-history -->
+| # | Date | Title | Commits |
+|---|------|-------|---------|
+<!-- @@@/auto:session-history -->
+
+---
+
+## Notes
+
+- Sessions are appended to progress files
+- New progress file created when current exceeds 2000 lines
+- Use \`add-session.sh\` to record sessions
+INDEX_EOF
+  fi
+
+  echo "Developer initialized: $name"
+  echo "  .developer file: $dev_file"
+  echo "  Progress dir: $progress_dir"
+}
+
+ensure_developer() {
+  local repo_root="${1:-$(get_repo_root)}"
+
+  if ! check_developer "$repo_root"; then
+    echo "Error: Developer not initialized." >&2
+    echo "Run: ./.trellis/scripts/init-developer.sh <your-name>" >&2
+    exit 1
+  fi
+}
+
+show_developer_info() {
+  local repo_root="${1:-$(get_repo_root)}"
+  local developer=$(get_developer "$repo_root")
+
+  if [[ -z "$developer" ]]; then
+    echo "Developer: (not initialized)"
+  else
+    echo "Developer: $developer"
+    echo "Features dir: $(get_features_dir "$repo_root")"
+    echo "Progress dir: $(get_progress_dir "$repo_root")"
+  fi
+}