@mthanhlm/autodev 0.4.4 → 0.5.0

package/commands/autodev/cleanup.md

@@ -1,23 +0,0 @@
----
-name: autodev:cleanup
-description: Clean or archive autodev state with an interactive prompt
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash
-  - AskUserQuestion
-  - Grep
-  - Glob
----
-<objective>
-Offer interactive cleanup choices for `.autodev/`, with archive-first behavior.
-</objective>
-
-<execution_context>
-@~/.claude/autodev/workflows/cleanup.md
-</execution_context>
-
-<process>
-Execute the workflow in @~/.claude/autodev/workflows/cleanup.md end-to-end.
-</process>

package/commands/autodev/execute-phase.md

@@ -1,29 +0,0 @@
----
-name: autodev:execute-phase
-description: Execute exactly one active-track task at a time, preferring a fresh foreground agent with clean fallback when unavailable
-argument-hint: "[phase-number]"
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash
-  - Grep
-  - Glob
-  - TodoWrite
-  - AskUserQuestion
-  - Agent
----
-<objective>
-Execute exactly one task-sized unit for the active phase, then stop at the post-task checkpoint.
-</objective>
-
-<execution_context>
-@~/.claude/autodev/workflows/execute-phase.md
-@~/.claude/autodev/templates/summary.md
-@~/.claude/autodev/templates/task-summary.md
-@~/.claude/autodev/agents/autodev-task-worker.md
-</execution_context>
-
-<process>
-Execute the workflow in @~/.claude/autodev/workflows/execute-phase.md end-to-end.
-</process>

package/commands/autodev/explore-codebase.md

@@ -1,33 +0,0 @@
----
-name: autodev:explore-codebase
-description: Map an existing codebase, preferring foreground delegated agents with clean fallback when unavailable
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash
-  - Grep
-  - Glob
-  - AskUserQuestion
-  - Agent
----
-<objective>
-Explore the current repository, use foreground codebase agents when available, and write the brownfield map into `.autodev/codebase/`.
-</objective>
-
-<execution_context>
-@~/.claude/autodev/workflows/explore-codebase.md
-@~/.claude/autodev/templates/codebase/structure.md
-@~/.claude/autodev/templates/codebase/domain.md
-@~/.claude/autodev/templates/codebase/runtime.md
-@~/.claude/autodev/templates/codebase/quality.md
-@~/.claude/autodev/templates/codebase/summary.md
-@~/.claude/autodev/agents/autodev-codebase-structure.md
-@~/.claude/autodev/agents/autodev-codebase-domain.md
-@~/.claude/autodev/agents/autodev-codebase-runtime.md
-@~/.claude/autodev/agents/autodev-codebase-quality.md
-</execution_context>
-
-<process>
-Execute the workflow in @~/.claude/autodev/workflows/explore-codebase.md end-to-end.
-</process>

package/commands/autodev/help.md

@@ -1,18 +0,0 @@
----
-name: autodev:help
-description: Show the compact autodev command reference
-allowed-tools:
-  - Read
-  - Bash
----
-<objective>
-Show the autodev command reference, with `/autodev` as the main entrypoint.
-</objective>
-
-<execution_context>
-@~/.claude/autodev/workflows/help.md
-</execution_context>
-
-<process>
-Output the reference from @~/.claude/autodev/workflows/help.md directly.
-</process>

package/commands/autodev/new-project.md

@@ -1,30 +0,0 @@
----
-name: autodev:new-project
-description: Initialize autodev project state and create the first active track
-argument-hint: "[project and current track goals]"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - AskUserQuestion
-  - Grep
-  - Glob
----
-<objective>
-Create the `.autodev/` project state for a new or existing codebase, then create the first active track.
-</objective>
-
-<execution_context>
-@~/.claude/autodev/workflows/new-project.md
-@~/.claude/autodev/templates/config.json
-@~/.claude/autodev/templates/project.md
-@~/.claude/autodev/templates/project-state.md
-@~/.claude/autodev/templates/track.md
-@~/.claude/autodev/templates/requirements.md
-@~/.claude/autodev/templates/roadmap.md
-@~/.claude/autodev/templates/track-state.md
-</execution_context>
-
-<process>
-Execute the workflow in @~/.claude/autodev/workflows/new-project.md end-to-end.
-</process>

package/commands/autodev/plan-phase.md

@@ -1,26 +0,0 @@
----
-name: autodev:plan-phase
-description: Create a practical phase plan and break it into reviewable task files
-argument-hint: "[phase-number]"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - AskUserQuestion
-  - Grep
-  - Glob
-  - WebFetch
----
-<objective>
-Create or update a single executable phase plan under the active track in `.autodev/tracks/<track>/phases/`, plus task files for controlled execution.
-</objective>
-
-<execution_context>
-@~/.claude/autodev/workflows/plan-phase.md
-@~/.claude/autodev/templates/plan.md
-@~/.claude/autodev/templates/task.md
-</execution_context>
-
-<process>
-Execute the workflow in @~/.claude/autodev/workflows/plan-phase.md end-to-end.
-</process>

package/commands/autodev/progress.md

@@ -1,18 +0,0 @@
----
-name: autodev:progress
-description: Show the current autodev status for the project
-allowed-tools:
-  - Read
-  - Bash
----
-<objective>
-Render the current `.autodev/` progress, active track, and next recommended route.
-</objective>
-
-<execution_context>
-@~/.claude/autodev/workflows/progress.md
-</execution_context>
-
-<process>
-Execute the workflow in @~/.claude/autodev/workflows/progress.md end-to-end.
-</process>

package/commands/autodev/review-phase.md

@@ -1,29 +0,0 @@
----
-name: autodev:review-phase
-description: Run a review pass for code quality, security, integration, and product polish, preferring foreground agents when available
-argument-hint: "[phase-number]"
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash
-  - Grep
-  - Glob
-  - Agent
----
-<objective>
-Run the automatic review bundle for one executed phase and write a single review artifact.
-</objective>
-
-<execution_context>
-@~/.claude/autodev/workflows/review-phase.md
-@~/.claude/autodev/templates/review.md
-@~/.claude/autodev/agents/autodev-review-quality.md
-@~/.claude/autodev/agents/autodev-review-security.md
-@~/.claude/autodev/agents/autodev-review-integration.md
-@~/.claude/autodev/agents/autodev-review-polish.md
-</execution_context>
-
-<process>
-Execute the workflow in @~/.claude/autodev/workflows/review-phase.md end-to-end.
-</process>

package/commands/autodev/review-task.md

@@ -1,25 +0,0 @@
----
-name: autodev:review-task
-description: Pause after one completed task so the user can review it before any further phase execution
-argument-hint: "[phase-number]"
-allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - Bash
-  - Grep
-  - Glob
-  - AskUserQuestion
-  - TodoWrite
----
-<objective>
-Review one completed task and decide whether to continue execution, revise the phase, or stop here.
-</objective>
-
-<execution_context>
-@~/.claude/autodev/workflows/review-task.md
-</execution_context>
-
-<process>
-Execute the workflow in @~/.claude/autodev/workflows/review-task.md end-to-end.
-</process>

package/commands/autodev/verify-work.md

@@ -1,24 +0,0 @@
----
-name: autodev:verify-work
-description: Run lightweight user acceptance testing for a reviewed phase
-argument-hint: "[phase-number]"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - AskUserQuestion
-  - Grep
-  - Glob
----
-<objective>
-Record manual verification for one reviewed phase and keep the next step clear, including gap recovery when needed.
-</objective>
-
-<execution_context>
-@~/.claude/autodev/workflows/verify-work.md
-@~/.claude/autodev/templates/uat.md
-</execution_context>
-
-<process>
-Execute the workflow in @~/.claude/autodev/workflows/verify-work.md end-to-end.
-</process>

package/hooks/autodev-context-monitor.js

@@ -1,59 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { readProjectConfig } = require('./autodev-paths.js');
-
-const WARNING_THRESHOLD = 35;
-const CRITICAL_THRESHOLD = 20;
-
-let input = '';
-const stdinTimeout = setTimeout(() => process.exit(0), 10000);
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', chunk => {
-  input += chunk;
-});
-process.stdin.on('end', () => {
-  clearTimeout(stdinTimeout);
-
-  try {
-    const data = JSON.parse(input);
-    const cwd = data.cwd || process.cwd();
-    const config = readProjectConfig(cwd);
-    if (config && config.hooks?.context_warnings === false) {
-      process.exit(0);
-    }
-
-    const sessionId = data.session_id;
-    if (!sessionId || /[/\\]|\.\./.test(sessionId)) {
-      process.exit(0);
-    }
-
-    const metricsPath = path.join(os.tmpdir(), `claude-ctx-${sessionId}.json`);
-    if (!fs.existsSync(metricsPath)) {
-      process.exit(0);
-    }
-
-    const metrics = JSON.parse(fs.readFileSync(metricsPath, 'utf8'));
-    const remaining = metrics.remaining_percentage;
-    const used = metrics.used_pct;
-
-    if (typeof remaining !== 'number' || remaining > WARNING_THRESHOLD) {
-      process.exit(0);
-    }
-
-    const additionalContext = remaining <= CRITICAL_THRESHOLD
-      ? `CONTEXT CRITICAL: usage is at ${used}%. Wrap up the current step, avoid new exploration, and tell the user context is low.`
-      : `CONTEXT WARNING: usage is at ${used}%. Finish the current step cleanly and avoid starting new complex work.`;
-
-    process.stdout.write(JSON.stringify({
-      hookSpecificOutput: {
-        hookEventName: 'PostToolUse',
-        additionalContext
-      }
-    }));
-  } catch {
-    process.exit(0);
-  }
-});

package/hooks/autodev-phase-boundary.sh

@@ -1,49 +0,0 @@
-#!/bin/bash
-
-find_workspace_root() {
-  local cursor
-  cursor="$(pwd -P)"
-  local git_root=""
-
-  while true; do
-    if [ -d "$cursor/.autodev" ]; then
-      printf '%s\n' "$cursor"
-      return 0
-    fi
-
-    if [ -z "$git_root" ] && [ -e "$cursor/.git" ]; then
-      git_root="$cursor"
-    fi
-
-    if [ "$cursor" = "/" ]; then
-      break
-    fi
-
-    cursor="$(dirname "$cursor")"
-  done
-
-  if [ -n "$git_root" ]; then
-    printf '%s\n' "$git_root"
-    return 0
-  fi
-
-  return 1
-}
-
-WORKSPACE_ROOT="$(find_workspace_root)" || exit 0
-CONFIG="$WORKSPACE_ROOT/.autodev/config.json"
-
-[ -f "$CONFIG" ] || exit 0
-
-ENABLED=$(node -e "const fs=require('fs');const p=process.argv[1];try{const c=JSON.parse(fs.readFileSync(p,'utf8'));process.stdout.write(c.hooks?.phase_boundary===false?'0':'1')}catch{process.stdout.write('0')}" "$CONFIG" 2>/dev/null)
-if [ "$ENABLED" != "1" ]; then
-  exit 0
-fi
-
-INPUT=$(cat)
-FILE=$(echo "$INPUT" | node -e "let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{try{const t=JSON.parse(d).tool_input||{};process.stdout.write(t.file_path||t.path||'')}catch{}})" 2>/dev/null)
-
-if [[ "$FILE" == *.autodev/* ]] || [[ "$FILE" == .autodev/* ]]; then
-  echo ".autodev file updated: $FILE"
-  echo "Check whether STATE.md or the current summary also needs an update."
-fi

package/hooks/autodev-prompt-guard.js

@@ -1,78 +0,0 @@
-#!/usr/bin/env node
-
-const path = require('path');
-
-const PATTERNS = [
-  /ignore\s+(all\s+)?previous\s+instructions/i,
-  /ignore\s+(all\s+)?above\s+instructions/i,
-  /disregard\s+(all\s+)?previous/i,
-  /override\s+(system|previous)\s+(prompt|instructions)/i,
-  /you\s+are\s+now\s+(?:a|an|the)\s+/i,
-  /<\/?(?:system|assistant|human)>/i
-];
-
-function extractWrittenContent(toolInput) {
-  if (!toolInput || typeof toolInput !== 'object') {
-    return '';
-  }
-
-  if (typeof toolInput.content === 'string' && toolInput.content) {
-    return toolInput.content;
-  }
-
-  if (typeof toolInput.new_string === 'string' && toolInput.new_string) {
-    return toolInput.new_string;
-  }
-
-  if (Array.isArray(toolInput.edits)) {
-    return toolInput.edits
-      .map(edit => edit?.new_string || '')
-      .filter(Boolean)
-      .join('\n');
-  }
-
-  return '';
-}
-
-let input = '';
-const stdinTimeout = setTimeout(() => process.exit(0), 3000);
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', chunk => {
-  input += chunk;
-});
-process.stdin.on('end', () => {
-  clearTimeout(stdinTimeout);
-
-  try {
-    const data = JSON.parse(input);
-    if (!['Write', 'Edit', 'MultiEdit'].includes(data.tool_name)) {
-      process.exit(0);
-    }
-
-    const filePath = data.tool_input?.file_path || data.tool_input?.path || '';
-    if (!filePath.includes('.autodev/')) {
-      process.exit(0);
-    }
-
-    const content = extractWrittenContent(data.tool_input);
-    if (!content) {
-      process.exit(0);
-    }
-
-    const findings = PATTERNS.filter(pattern => pattern.test(content));
-    if (findings.length === 0) {
-      process.exit(0);
-    }
-
-    process.stdout.write(JSON.stringify({
-      hookSpecificOutput: {
-        hookEventName: 'PreToolUse',
-        additionalContext:
-          `PROMPT WARNING: content being written to ${path.basename(filePath)} looks like instruction text. ` +
-          'Review it before treating it as trusted workflow state.'
-      }
-    }));
-  } catch {
-    process.exit(0);
-  }
-});

package/hooks/autodev-read-guard.js

@@ -1,42 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-const { readProjectConfig } = require('./autodev-paths.js');
-
-let input = '';
-const stdinTimeout = setTimeout(() => process.exit(0), 3000);
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', chunk => {
-  input += chunk;
-});
-process.stdin.on('end', () => {
-  clearTimeout(stdinTimeout);
-
-  try {
-    const data = JSON.parse(input);
-    if (!['Write', 'Edit', 'MultiEdit'].includes(data.tool_name)) {
-      process.exit(0);
-    }
-
-    const config = readProjectConfig(data.cwd || process.cwd());
-    if (config && config.hooks?.read_guard === false) {
-      process.exit(0);
-    }
-
-    const filePath = data.tool_input?.file_path || data.tool_input?.path || '';
-    if (!filePath || !fs.existsSync(filePath)) {
-      process.exit(0);
-    }
-
-    process.stdout.write(JSON.stringify({
-      hookSpecificOutput: {
-        hookEventName: 'PreToolUse',
-        additionalContext:
-          `READ BEFORE EDIT: ${path.basename(filePath)} already exists. Make sure you have read it before editing.`
-      }
-    }));
-  } catch {
-    process.exit(0);
-  }
-});

package/hooks/autodev-session-state.sh

@@ -1,51 +0,0 @@
-#!/bin/bash
-
-find_workspace_root() {
-  local cursor
-  cursor="$(pwd -P)"
-  local git_root=""
-
-  while true; do
-    if [ -d "$cursor/.autodev" ]; then
-      printf '%s\n' "$cursor"
-      return 0
-    fi
-
-    if [ -z "$git_root" ] && [ -e "$cursor/.git" ]; then
-      git_root="$cursor"
-    fi
-
-    if [ "$cursor" = "/" ]; then
-      break
-    fi
-
-    cursor="$(dirname "$cursor")"
-  done
-
-  if [ -n "$git_root" ]; then
-    printf '%s\n' "$git_root"
-    return 0
-  fi
-
-  return 1
-}
-
-WORKSPACE_ROOT="$(find_workspace_root)" || exit 0
-CONFIG="$WORKSPACE_ROOT/.autodev/config.json"
-STATE="$WORKSPACE_ROOT/.autodev/STATE.md"
-
-[ -f "$CONFIG" ] || exit 0
-
-ENABLED=$(node -e "const fs=require('fs');const p=process.argv[1];try{const c=JSON.parse(fs.readFileSync(p,'utf8'));process.stdout.write(c.hooks?.session_state===false?'0':'1')}catch{process.stdout.write('0')}" "$CONFIG" 2>/dev/null)
-if [ "$ENABLED" != "1" ]; then
-  exit 0
-fi
-
-echo "## autodev state"
-echo ""
-
-if [ -f "$STATE" ]; then
-  head -20 "$STATE"
-else
-  echo "No .autodev/STATE.md yet. Start with /autodev."
-fi

package/hooks/autodev-statusline.js

@@ -1,83 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { findAutodevRoot } = require('./autodev-paths.js');
-
-function readStateFields(cwd) {
-  try {
-    const autodevRoot = findAutodevRoot(cwd);
-    const statePath = autodevRoot ? path.join(autodevRoot, 'STATE.md') : null;
-
-    if (!statePath) {
-      return {
-        currentTask: '',
-        currentTaskStatus: '',
-        runMode: ''
-      };
-    }
-
-    const content = fs.readFileSync(statePath, 'utf8');
-    const currentTask = content.match(/^Current Task:\s*(.+)$/mi)?.[1]?.trim() || '';
-    const currentTaskStatus = content.match(/^Current Task Status:\s*(.+)$/mi)?.[1]?.trim() || '';
-    const runMode = content.match(/^Run Mode:\s*(.+)$/mi)?.[1]?.trim() || '';
-    return {
-      currentTask: currentTask && currentTask !== 'none' ? currentTask : '',
-      currentTaskStatus: currentTaskStatus && currentTaskStatus !== 'idle' ? currentTaskStatus : '',
-      runMode: runMode === 'auto' ? 'auto' : ''
-    };
-  } catch {
-    return {
-      currentTask: '',
-      currentTaskStatus: '',
-      runMode: ''
-    };
-  }
-}
-
-let input = '';
-const stdinTimeout = setTimeout(() => process.exit(0), 3000);
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', chunk => {
-  input += chunk;
-});
-process.stdin.on('end', () => {
-  clearTimeout(stdinTimeout);
-
-  try {
-    const data = JSON.parse(input);
-    const model = data.model?.display_name || 'Claude';
-    const currentDir = data.workspace?.current_dir || process.cwd();
-    const remaining = data.context_window?.remaining_percentage;
-    const sessionId = data.session_id || '';
-    const taskState = readStateFields(currentDir);
-
-    let contextLabel = '';
-    if (typeof remaining === 'number') {
-      const used = Math.max(0, Math.min(100, Math.round(100 - remaining)));
-      const filled = Math.floor(used / 10);
-      const bar = `${'█'.repeat(filled)}${'░'.repeat(10 - filled)}`;
-      contextLabel = ` ${bar} ${used}%`;
-
-      if (sessionId && !/[/\\]|\.\./.test(sessionId)) {
-        const bridgePath = path.join(os.tmpdir(), `claude-ctx-${sessionId}.json`);
-        fs.writeFileSync(bridgePath, JSON.stringify({
-          session_id: sessionId,
-          remaining_percentage: remaining,
-          used_pct: used,
-          timestamp: Math.floor(Date.now() / 1000)
-        }));
-      }
-    }
-
-    const modeLabel = taskState.runMode ? ` | ${taskState.runMode}` : '';
-    const taskLabel = taskState.currentTask
-      ? ` | task ${taskState.currentTask}${taskState.currentTaskStatus ? ` (${taskState.currentTaskStatus})` : ''}`
-      : '';
-
-    process.stdout.write(`${model} | ${path.basename(currentDir)}${modeLabel}${taskLabel}${contextLabel}`);
-  } catch {
-    process.exit(0);
-  }
-});

package/hooks/autodev-workflow-guard.js

@@ -1,43 +0,0 @@
-#!/usr/bin/env node
-
-const path = require('path');
-const { readProjectConfig } = require('./autodev-paths.js');
-
-let input = '';
-const stdinTimeout = setTimeout(() => process.exit(0), 3000);
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', chunk => {
-  input += chunk;
-});
-process.stdin.on('end', () => {
-  clearTimeout(stdinTimeout);
-
-  try {
-    const data = JSON.parse(input);
-    if (!['Write', 'Edit', 'MultiEdit'].includes(data.tool_name)) {
-      process.exit(0);
-    }
-
-    const cwd = data.cwd || process.cwd();
-    const config = readProjectConfig(cwd);
-    if (!config || config.hooks?.workflow_guard === false) {
-      process.exit(0);
-    }
-
-    const filePath = data.tool_input?.file_path || data.tool_input?.path || '';
-    if (!filePath || filePath.includes('.autodev/')) {
-      process.exit(0);
-    }
-
-    process.stdout.write(JSON.stringify({
-      hookSpecificOutput: {
-        hookEventName: 'PreToolUse',
-        additionalContext:
-          `WORKFLOW ADVISORY: you are editing ${path.basename(filePath)} outside .autodev state files. ` +
-          'If this belongs to the current phase, keep STATE.md, task summaries, and the phase summary aligned.'
-      }
-    }));
-  } catch {
-    process.exit(0);
-  }
-});