aidevops 2.143.0 → 2.145.0

package/VERSION

@@ -1 +1 @@
-2.143.0
+2.145.0

package/aidevops.sh

@@ -3,7 +3,7 @@
 # AI DevOps Framework CLI
 # Usage: aidevops <command> [options]
 #
-# Version: 2.143.0
+# Version: 2.145.0
 
 set -euo pipefail
 
@@ -1295,18 +1295,119 @@ EOF
 	# Plugins deploy to ~/.aidevops/agents/<namespace>/ (namespaced, no collisions)
 	print_success "Created .aidevops.json"
 
-	# Create .agents symlink (or migrate from legacy .agent)
-	if [[ -L "$project_root/.agent" || -d "$project_root/.agent" ]]; then
-		# Migrate legacy .agent symlink to .agents
-		rm -f "$project_root/.agent"
-		ln -s "$AGENTS_DIR" "$project_root/.agents"
-		print_success "Migrated .agent -> .agents symlink"
-	elif [[ ! -e "$project_root/.agents" ]]; then
-		print_info "Creating .agents symlink..."
-		ln -s "$AGENTS_DIR" "$project_root/.agents"
-		print_success "Created .agents -> $AGENTS_DIR"
+	# Derive repo name for scaffolding
+	# In worktrees, basename gives the worktree dir name (e.g., "repo-chore-foo"),
+	# not the actual repo name. Prefer: git remote URL > main worktree basename > cwd basename.
+	local repo_name
+	local remote_url
+	remote_url=$(git -C "$project_root" remote get-url origin 2>/dev/null || true)
+	if [[ -n "$remote_url" ]]; then
+		repo_name=$(basename "$remote_url" .git)
 	else
-		print_warning ".agents already exists, skipping symlink"
+		# No remote — try main worktree path (first line of `git worktree list`)
+		local main_wt
+		main_wt=$(git -C "$project_root" worktree list --porcelain 2>/dev/null | head -1 | sed 's/^worktree //')
+		if [[ -n "$main_wt" ]]; then
+			repo_name=$(basename "$main_wt")
+		else
+			repo_name=$(basename "$project_root")
+		fi
+	fi
+
+	# Create .agents/ directory for project-specific agent context
+	# (The aidevops framework is loaded globally via ~/.aidevops/agents/ — this
+	# directory is for project-specific agents, conventions, and architecture docs)
+	if [[ -L "$project_root/.agents" ]]; then
+		# Migrate legacy symlink to real directory
+		rm -f "$project_root/.agents"
+		print_info "Removed legacy .agents symlink (framework is loaded globally now)"
+	fi
+	# Also clean up legacy .agent symlink/directory
+	if [[ -L "$project_root/.agent" ]]; then
+		rm -f "$project_root/.agent"
+		print_info "Removed legacy .agent symlink"
+	elif [[ -d "$project_root/.agent" && ! -d "$project_root/.agents" ]]; then
+		mv "$project_root/.agent" "$project_root/.agents"
+		print_success "Migrated .agent/ -> .agents/ directory"
+	fi
+
+	if [[ ! -d "$project_root/.agents" ]]; then
+		mkdir -p "$project_root/.agents"
+		print_success "Created .agents/ directory"
+	fi
+
+	# Scaffold .agents/AGENTS.md if missing
+	if [[ ! -f "$project_root/.agents/AGENTS.md" ]]; then
+		cat >"$project_root/.agents/AGENTS.md" <<'AGENTSEOF'
+# Agent Instructions
+
+This directory contains project-specific agent context. The [aidevops](https://aidevops.sh)
+framework is loaded separately via the global config (`~/.aidevops/agents/`).
+
+## Purpose
+
+Files in `.agents/` provide project-specific instructions that AI assistants
+read when working in this repository. Use this for:
+
+- Domain-specific conventions not covered by the framework
+- Project architecture decisions and patterns
+- API design rules, data models, naming conventions
+- Integration details (third-party services, deployment targets)
+
+## Adding Agents
+
+Create `.md` files in this directory for domain-specific context:
+
+```text
+.agents/
+  AGENTS.md              # This file - overview and index
+  api-patterns.md        # API design conventions
+  deployment.md          # Deployment procedures
+  data-model.md          # Database schema and relationships
+```
+
+Each file is read on demand by AI assistants when relevant to the task.
+AGENTSEOF
+		print_success "Created .agents/AGENTS.md"
+	fi
+
+	# Scaffold root AGENTS.md if missing
+	if [[ ! -f "$project_root/AGENTS.md" ]]; then
+		cat >"$project_root/AGENTS.md" <<ROOTAGENTSEOF
+# $repo_name
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- **Build**: \`# TODO: add build command\`
+- **Test**: \`# TODO: add test command\`
+- **Deploy**: \`# TODO: add deploy command\`
+
+## Project Overview
+
+<!-- Brief description of what this project does and why it exists. -->
+
+## Architecture
+
+<!-- Key architectural decisions, tech stack, directory structure. -->
+
+## Conventions
+
+- Commits: [Conventional Commits](https://www.conventionalcommits.org/)
+- Branches: \`feature/\`, \`bugfix/\`, \`hotfix/\`, \`refactor/\`, \`chore/\`
+
+## Key Files
+
+| File | Purpose |
+|------|---------|
+| \`.agents/AGENTS.md\` | Project-specific agent instructions |
+| \`TODO.md\` | Task tracking |
+| \`CHANGELOG.md\` | Version history |
+
+<!-- AI-CONTEXT-END -->
+ROOTAGENTSEOF
+		print_success "Created AGENTS.md"
 	fi
 
 	# Create planning files if enabled
@@ -1534,28 +1635,68 @@ SOPSEOF
 		fi
 	fi
 
-	# Add to .gitignore if needed
+	# Add aidevops runtime artifacts to .gitignore
+	# Note: .agents/ itself is NOT ignored — it contains committed project-specific agents.
+	# Only runtime artifacts (loop state, tmp, memory) are ignored.
 	local gitignore="$project_root/.gitignore"
 	if [[ -f "$gitignore" ]]; then
-		if ! grep -q "^\.agents$" "$gitignore" 2>/dev/null; then
+		local gitignore_updated=false
+
+		# Remove legacy bare ".agents" entry if present (was added by older versions)
+		if grep -q "^\.agents$" "$gitignore" 2>/dev/null; then
+			sed -i '' '/^\.agents$/d' "$gitignore" 2>/dev/null ||
+				sed -i '/^\.agents$/d' "$gitignore" 2>/dev/null || true
+			# Also remove the "# aidevops" comment if it's now orphaned
+			sed -i '' '/^# aidevops$/{ N; /^# aidevops\n$/d; }' "$gitignore" 2>/dev/null || true
+			print_info "Removed legacy bare .agents from .gitignore (now tracked)"
+			gitignore_updated=true
+		fi
+
+		# Remove legacy bare ".agent" entry if present
+		if grep -q "^\.agent$" "$gitignore" 2>/dev/null; then
+			sed -i '' '/^\.agent$/d' "$gitignore" 2>/dev/null ||
+				sed -i '/^\.agent$/d' "$gitignore" 2>/dev/null || true
+			gitignore_updated=true
+		fi
+
+		# Add runtime artifact ignores
+		if ! grep -q "^\.agents/loop-state/" "$gitignore" 2>/dev/null; then
 			{
 				echo ""
-				echo "# aidevops"
-				echo ".agents"
+				echo "# aidevops runtime artifacts"
+				echo ".agents/loop-state/"
+				echo ".agents/tmp/"
+				echo ".agents/memory/"
 			} >>"$gitignore"
-			print_success "Added .agents to .gitignore"
-			# Also add legacy .agent for backward compatibility
-			if ! grep -q "^\.agent$" "$gitignore" 2>/dev/null; then
-				echo ".agent" >>"$gitignore"
+			print_success "Added .agents/ runtime artifact ignores to .gitignore"
+			gitignore_updated=true
+		fi
+
+		# Add .aidevops.json to gitignore (local config, not committed).
+		# If .aidevops.json is already tracked by git (committed by older framework
+		# versions), untrack it first — adding a tracked file to .gitignore is a
+		# no-op and the file keeps showing in git diff on every re-init (#2570 bug 3).
+		if ! grep -q "^\.aidevops\.json$" "$gitignore" 2>/dev/null; then
+			if git -C "$project_root" ls-files --error-unmatch .aidevops.json &>/dev/null; then
+				git -C "$project_root" rm --cached .aidevops.json &>/dev/null || true
+				print_info "Untracked .aidevops.json from git (was committed by older version)"
 			fi
+			echo ".aidevops.json" >>"$gitignore"
+			gitignore_updated=true
 		fi
+
 		# Add .beads if beads is enabled
 		if [[ "$enable_beads" == "true" ]]; then
 			if ! grep -q "^\.beads$" "$gitignore" 2>/dev/null; then
 				echo ".beads" >>"$gitignore"
 				print_success "Added .beads to .gitignore"
+				gitignore_updated=true
 			fi
 		fi
+
+		if [[ "$gitignore_updated" == "true" ]]; then
+			print_info "Updated .gitignore"
+		fi
 	fi
 
 	# Generate collaborator pointer files (lightweight AGENTS.md references)
@@ -1606,6 +1747,43 @@ SOPSEOF
 	# Register repo in repos.json
 	register_repo "$project_root" "$aidevops_version" "$features_list"
 
+	# Auto-commit initialized files so they don't linger as mystery unstaged
+	# changes (#2570 bug 2). Collect all files that cmd_init creates/modifies.
+	local init_files=()
+	[[ -f "$project_root/.gitignore" ]] && init_files+=(".gitignore")
+	[[ -d "$project_root/.agents" ]] && init_files+=(".agents/")
+	[[ -f "$project_root/AGENTS.md" ]] && init_files+=("AGENTS.md")
+	[[ -f "$project_root/TODO.md" ]] && init_files+=("TODO.md")
+	[[ -d "$project_root/todo" ]] && init_files+=("todo/")
+	[[ -f "$project_root/MODELS.md" ]] && init_files+=("MODELS.md")
+	[[ -f "$project_root/LICENCE" ]] && init_files+=("LICENCE")
+	[[ -f "$project_root/CHANGELOG.md" ]] && init_files+=("CHANGELOG.md")
+	[[ -f "$project_root/README.md" ]] && init_files+=("README.md")
+	[[ -f "$project_root/.cursorrules" ]] && init_files+=(".cursorrules")
+	[[ -f "$project_root/.windsurfrules" ]] && init_files+=(".windsurfrules")
+	[[ -f "$project_root/.clinerules" ]] && init_files+=(".clinerules")
+	[[ -d "$project_root/.github" ]] && init_files+=(".github/")
+	[[ -f "$project_root/.sops.yaml" ]] && init_files+=(".sops.yaml")
+	[[ -d "$project_root/schemas" ]] && init_files+=("schemas/")
+	[[ -d "$project_root/migrations" ]] && init_files+=("migrations/")
+	[[ -d "$project_root/seeds" ]] && init_files+=("seeds/")
+
+	local committed=false
+	if [[ ${#init_files[@]} -gt 0 ]]; then
+		# Stage all init files (--force not needed; .aidevops.json is gitignored above)
+		if git -C "$project_root" add -- "${init_files[@]}" 2>/dev/null; then
+			# Only commit if there are staged changes
+			if ! git -C "$project_root" diff --cached --quiet 2>/dev/null; then
+				if git -C "$project_root" commit -m "chore: initialize aidevops v${aidevops_version}" 2>/dev/null; then
+					committed=true
+					print_success "Committed initialized files"
+				else
+					print_warning "Auto-commit failed (pre-commit hook rejected?)"
+				fi
+			fi
+		fi
+	fi
+
 	echo ""
 	print_success "AI DevOps initialized!"
 	echo ""
@@ -1620,19 +1798,31 @@ SOPSEOF
 	[[ -f "$project_root/MODELS.md" ]] && echo "  ✓ MODELS.md (per-repo model performance leaderboard)"
 	echo ""
 	echo "Next steps:"
+	local step=1
+	if [[ "$committed" != "true" ]]; then
+		echo "  ${step}. Commit the initialized files: git add -A && git commit -m 'chore: initialize aidevops'"
+		((step++))
+	fi
 	if [[ "$enable_beads" == "true" ]]; then
-		echo "  1. Add tasks to TODO.md with dependencies (blocked-by:t001)"
-		echo "  2. Run /ready to see unblocked tasks"
-		echo "  3. Run /sync-beads to sync with Beads graph"
-		echo "  4. Use 'bd' CLI for graph visualization"
+		echo "  ${step}. Add tasks to TODO.md with dependencies (blocked-by:t001)"
+		((step++))
+		echo "  ${step}. Run /ready to see unblocked tasks"
+		((step++))
+		echo "  ${step}. Run /sync-beads to sync with Beads graph"
+		((step++))
+		echo "  ${step}. Use 'bd' CLI for graph visualization"
 	elif [[ "$enable_database" == "true" ]]; then
-		echo "  1. Add schema files to schemas/"
-		echo "  2. Run diff to generate migrations"
-		echo "  3. See .agents/workflows/sql-migrations.md"
+		echo "  ${step}. Add schema files to schemas/"
+		((step++))
+		echo "  ${step}. Run diff to generate migrations"
+		((step++))
+		echo "  ${step}. See .agents/workflows/sql-migrations.md"
 	else
-		echo "  1. Add tasks to TODO.md"
-		echo "  2. Use /create-prd for complex features"
-		echo "  3. Use /feature to start development"
+		echo "  ${step}. Add tasks to TODO.md"
+		((step++))
+		echo "  ${step}. Use /create-prd for complex features"
+		((step++))
+		echo "  ${step}. Use /feature to start development"
 	fi
 
 	return 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aidevops",
-  "version": "2.143.0",
+  "version": "2.145.0",
   "description": "AI DevOps Framework - AI-assisted development workflows, code quality, and deployment automation",
   "type": "module",
   "bin": {

package/setup.sh

@@ -10,7 +10,7 @@ shopt -s inherit_errexit 2>/dev/null || true
 # AI Assistant Server Access Framework Setup Script
 # Helps developers set up the framework for their infrastructure
 #
-# Version: 2.143.0
+# Version: 2.145.0
 #
 # Quick Install:
 #   npm install -g aidevops && aidevops update          (recommended)

package/templates/opencode-config-agents.md

@@ -3,7 +3,7 @@ Add ~/.aidevops/agents/AGENTS.md to context for AI DevOps capabilities.
 ## aidevops Framework Status
 
 **On conversation start**:
-1. If you have Bash tool: Run `bash ~/.aidevops/agents/scripts/aidevops-update-check.sh`
+1. If you have Bash tool: Run `bash ~/.aidevops/agents/scripts/aidevops-update-check.sh --interactive`
 2. If no Bash tool: Read `~/.aidevops/cache/session-greeting.txt` (cached by agents with Bash)
 3. Parse the first line of output (format: `aidevops v{version} running in {app} v{app_version} | {repo}`). Greet with: "Hi!\n\nWe're running https://aidevops.sh v{version} in {app} v{app_version}.\n\nWhat would you like to work on?"
 4. Then respond to the user's actual message