@mthanhlm/autodev 0.2.0 → 0.2.2

package/PUBLISH.md

@@ -26,7 +26,7 @@ npm pack
 Check the tarball contents:
 
 ```bash
-tar -tf mthanhlm-autodev-0.2.0.tgz
+tar -tf mthanhlm-autodev-0.2.2.tgz
 ```
 
 ## First Public Publish

package/autodev/bin/autodev-tools.cjs

@@ -328,7 +328,8 @@ function buildRoute(cwd) {
   if (!projectExists) {
     return {
       kind: 'init_project',
-      command: '/autodev-new-project',
+      command: '/autodev',
+      manualCommand: '/autodev-new-project',
       reason: existingCodebase ? 'existing_code_detected_without_project_state' : 'project_state_missing',
       projectType
     };
@@ -337,7 +338,8 @@ function buildRoute(cwd) {
   if (projectType === 'brownfield' && !codebaseMapExists) {
     return {
       kind: 'explore_codebase',
-      command: '/autodev-explore-codebase',
+      command: '/autodev',
+      manualCommand: '/autodev-explore-codebase',
       reason: 'brownfield_project_needs_codebase_map',
       projectType
     };
@@ -347,6 +349,7 @@ function buildRoute(cwd) {
     return {
       kind: 'track_select',
       command: '/autodev',
+      manualCommand: null,
       reason: tracks.length > 0 ? 'no_active_track_selected' : 'no_tracks_created',
       projectType
     };
@@ -357,6 +360,7 @@ function buildRoute(cwd) {
     return {
       kind: 'track_setup',
       command: '/autodev',
+      manualCommand: null,
       reason: 'active_track_missing_required_artifacts',
       projectType,
       trackSlug: activeTrack
@@ -368,6 +372,7 @@ function buildRoute(cwd) {
     return {
       kind: 'track_setup',
       command: '/autodev',
+      manualCommand: null,
       reason: 'active_track_has_no_phases',
       projectType,
       trackSlug: activeTrack
@@ -378,7 +383,8 @@ function buildRoute(cwd) {
   if (nextReview && config.workflow.review_after_execute !== false) {
     return {
       kind: 'review_phase',
-      command: `/autodev-review-phase ${nextReview.number}`,
+      command: '/autodev',
+      manualCommand: `/autodev-review-phase ${nextReview.number}`,
       reason: 'phase_executed_but_not_reviewed',
       projectType,
       trackSlug: activeTrack,
@@ -390,7 +396,8 @@ function buildRoute(cwd) {
   if (nextVerify) {
     return {
       kind: 'verify_phase',
-      command: `/autodev-verify-work ${nextVerify.number}`,
+      command: '/autodev',
+      manualCommand: `/autodev-verify-work ${nextVerify.number}`,
       reason: 'phase_reviewed_but_not_verified',
       projectType,
       trackSlug: activeTrack,
@@ -402,7 +409,8 @@ function buildRoute(cwd) {
   if (nextExecute) {
     return {
       kind: 'execute_phase',
-      command: `/autodev-execute-phase ${nextExecute.number}`,
+      command: '/autodev',
+      manualCommand: `/autodev-execute-phase ${nextExecute.number}`,
       reason: 'phase_planned_but_not_executed',
       projectType,
       trackSlug: activeTrack,
@@ -414,7 +422,8 @@ function buildRoute(cwd) {
   if (nextPlan) {
     return {
       kind: 'plan_phase',
-      command: `/autodev-plan-phase ${nextPlan.number}`,
+      command: '/autodev',
+      manualCommand: `/autodev-plan-phase ${nextPlan.number}`,
       reason: 'phase_not_planned',
       projectType,
       trackSlug: activeTrack,
@@ -424,7 +433,8 @@ function buildRoute(cwd) {
 
   return {
     kind: 'track_complete',
-    command: '/autodev-cleanup',
+    command: '/autodev',
+    manualCommand: '/autodev-cleanup',
     reason: 'active_track_fully_verified',
     projectType,
     trackSlug: activeTrack
@@ -460,7 +470,8 @@ function buildProgress(cwd) {
       verified: phases.filter(phase => phase.uatExists).length
     },
     route,
-    nextCommand: route.command
+    nextCommand: route.command,
+    manualNextCommand: route.manualCommand || null
   };
 }
 
@@ -482,10 +493,11 @@ function renderProgressTable(progress) {
     `Reviewed: ${progress.counts.reviewed}`,
     `Verified: ${progress.counts.verified}`,
     `Next: ${progress.route.command}`,
+    progress.route.manualCommand ? `Manual Shortcut: ${progress.route.manualCommand}` : null,
     '',
     '| Phase | Type | Name | Plan | Summary | Review | UAT | Status |',
     '| --- | --- | --- | --- | --- | --- | --- | --- |'
-  ];
+  ].filter(Boolean);
 
   for (const phase of progress.phases) {
     lines.push(
@@ -514,6 +526,67 @@ function codebasePaths(cwd) {
   return Object.fromEntries(CODEBASE_FILES.map(name => [name.replace(/\.md$/, ''), path.join(codebaseDir, name)]));
 }
 
+function buildStatus(cwd) {
+  const paths = rootPaths(cwd);
+  const route = buildRoute(cwd);
+  const config = loadConfig(cwd);
+  const existingCodebase = detectExistingCodebase(cwd);
+  const projectType = config.project.type || (existingCodebase ? 'brownfield' : 'greenfield');
+  const activeTrack = readActiveTrack(cwd);
+  const tracks = listTracks(cwd);
+
+  return {
+    cwd,
+    autodev_exists: fileExists(paths.root),
+    project_exists: fileExists(paths.project),
+    existing_code_detected: existingCodebase,
+    project_type: projectType,
+    project_path: paths.project,
+    project_state_path: paths.state,
+    active_track_path: paths.activeTrack,
+    active_track: activeTrack,
+    track_count: tracks.length,
+    tracks: tracks.map(track => ({
+      slug: track.slug,
+      name: track.name,
+      active: track.active
+    })),
+    codebase_map_exists: fileExists(paths.codebaseSummary),
+    route
+  };
+}
+
+function buildCleanupPayload(cwd) {
+  const paths = rootPaths(cwd);
+  const route = buildRoute(cwd);
+  const activeTrack = readActiveTrack(cwd);
+  const track = trackPaths(cwd, activeTrack);
+  const phases = activeTrack ? listPhases(cwd, activeTrack) : [];
+  const verifiedPhases = phases.filter(phase => phase.uatExists);
+  const completedPhases = phases.filter(phase => phase.summaryExists || phase.reviewExists || phase.uatExists);
+
+  return {
+    cwd,
+    autodev_exists: fileExists(paths.root),
+    project_exists: fileExists(paths.project),
+    project_state_path: paths.state,
+    active_track_path: paths.activeTrack,
+    active_track: activeTrack,
+    track_path: track ? track.dir : null,
+    track_state_path: track ? track.state : null,
+    phases_dir: track ? track.phasesDir : null,
+    archive_root: path.join(paths.root, 'archive'),
+    route,
+    phase_counts: {
+      total: phases.length,
+      completed: completedPhases.length,
+      verified: verifiedPhases.length
+    },
+    verified_phase_numbers: verifiedPhases.map(phase => phase.number),
+    verified_phase_dirs: verifiedPhases.map(phase => phase.dir)
+  };
+}
+
 function initPayload(cwd, mode, requestedPhase) {
   const paths = rootPaths(cwd);
   const config = loadConfig(cwd);
@@ -614,6 +687,16 @@ function main() {
     return;
   }
 
+  if (command === 'status') {
+    printJson(buildStatus(cwd));
+    return;
+  }
+
+  if (command === 'cleanup') {
+    printJson(buildCleanupPayload(cwd));
+    return;
+  }
+
   if (command === 'route') {
     const mode = rest[0] || 'json';
     const route = buildRoute(cwd);
@@ -646,8 +729,10 @@ if (require.main === module) {
 
 module.exports = {
   autodevDir,
+  buildCleanupPayload,
   buildProgress,
   buildRoute,
+  buildStatus,
   detectExistingCodebase,
   initPayload,
   listPhases,

package/autodev/workflows/autodev.md

@@ -14,10 +14,10 @@ Use `/autodev` as the single entrypoint for the normal workflow. Route automatic
 1. Run:
 
 ```bash
-node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init autodev
+node "$HOME/.claude/autodev/bin/autodev-tools.cjs" status
 ```
 
-2. Inspect the returned `route.kind`, `project_type`, `tracks`, and active phase data.
+2. Inspect the returned `route.kind`, `project_type`, `tracks`, and active track data.
 
 3. Route as follows, and complete the selected workflow in the same turn:
    - `init_project`: perform the new-project workflow.
@@ -27,7 +27,9 @@ node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init autodev
    - `review_phase`: perform the review-phase workflow.
    - `verify_phase`: perform the verify-work workflow.
 
-4. If the route is `track_select` or `track_setup`, handle it directly:
+4. Do not stop after identifying a brownfield codebase route. If the route is `explore_codebase`, perform the exploration as part of the same `/autodev` run instead of telling the user to switch commands.
+
+5. If the route is `track_select` or `track_setup`, handle it directly:
    - If tracks exist, ask whether to continue one of them or create a new track.
    - If no tracks exist, ask only for the current initiative name, desired outcome, and likely phase types.
    - Create or repair:
@@ -45,18 +47,18 @@ node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init autodev
 
    - After track setup, continue in the same turn by re-running the route logic mentally and executing the next step.
 
-5. If the route is `track_complete`, ask whether the user wants to:
+6. If the route is `track_complete`, ask whether the user wants to:
    - start a new track
    - run cleanup
    - stop here
 
-6. When the user chooses a new track at step 5, create it immediately and continue routing in the same turn.
+7. When the user chooses a new track at step 6, create it immediately and continue routing in the same turn.
 
-7. Every time you finish a routed step, keep both project-level and track-level state aligned. Default the state files to `Next Command: /autodev`.
+8. Every time you finish a routed step, keep both project-level and track-level state aligned. Default the state files to `Next Command: /autodev`.
 
-8. End with:
+9. End with:
    - what step you completed
    - the current route reason in plain language
    - `/autodev` as the default next command
-   - the matching manual shortcut when useful
+   - the matching manual shortcut only as an optional escape hatch
 </process>

package/autodev/workflows/cleanup.md

@@ -13,12 +13,13 @@ Clean or archive autodev state without flags. Prefer preserving useful project c
 1. Run:
 
 ```bash
-node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init autodev
+node "$HOME/.claude/autodev/bin/autodev-tools.cjs" cleanup
 ```
 
 2. If no `.autodev/` project exists, stop and say there is nothing to clean.
 
-3. Ask the user to choose one action:
+3. Use the `AskUserQuestion` tool for the choice below. Do not ask this in plain assistant text.
+   Ask the user to choose one action:
    - archive completed phase artifacts only
    - archive the current track and clear the active selection
    - delete all `.autodev/` state
@@ -35,7 +36,7 @@ node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init autodev
    - update `.autodev/STATE.md` to `Current Step: track-selection` and `Next Command: /autodev`
 
 6. For `delete all .autodev state`:
-   - ask the user to type `DELETE AUTODEV`
+   - use the `AskUserQuestion` tool to ask the user to type `DELETE AUTODEV`
    - only then remove `.autodev/`
 
 7. End with:

package/autodev/workflows/explore-codebase.md

@@ -53,5 +53,5 @@ node "$HOME/.claude/autodev/bin/autodev-tools.cjs" init explore-codebase
    - the biggest structural insight
    - the biggest risk
    - `/autodev` as the next command
-   - `/autodev-plan-phase <n>` as the manual shortcut when obvious
+   - `/autodev-plan-phase <n>` only as the optional manual shortcut when obvious
 </process>

package/autodev/workflows/new-project.md

@@ -83,7 +83,7 @@ Each phase must include:
    - `Next Command: /autodev`
    - current ISO timestamp
 
-13. If the project is brownfield, do not fake a codebase map. Leave that for `/autodev-explore-codebase`, and make that the default next step. Otherwise, the next step is planning phase 1.
+13. If the project is brownfield, do not fake a codebase map. Continue into codebase exploration inside `/autodev` by default. Mention `/autodev-explore-codebase` only as a manual shortcut. Otherwise, the next step is planning phase 1 through `/autodev`.
 
 14. End with a short summary and direct the user to `/autodev`. Mention the manual shortcut only if useful.
 </process>

package/autodev/workflows/progress.md

@@ -13,5 +13,5 @@ node "$HOME/.claude/autodev/bin/autodev-tools.cjs" progress table
 
 3. If a project exists, add one short line after the table with:
    - `/autodev` as the default next command
-   - the routed manual shortcut from the table when useful
+   - the routed manual shortcut from the table only when useful
 </process>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mthanhlm/autodev",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "A lean Claude Code workflow system with a single entrypoint, brownfield codebase mapping, and read-only git.",
   "bin": {
     "autodev": "bin/install.js"