devflow-kit 1.7.0 → 1.8.1

package/CHANGELOG.md

@@ -5,6 +5,54 @@ All notable changes to DevFlow will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.8.1] - 2026-03-22
+
+### Changed
+- **Init wizard**: individual feature prompts with explanatory notes replace extras multiselect
+- **Init wizard**: scope-aware `.claudeignore` batch install across all discovered projects (user scope)
+- **Init wizard**: project discovery via `~/.claude/history.jsonl` to find all Claude-used git repos
+- **Init wizard**: managed settings sudo confirmation moved to prompt phase (before spinner)
+- **Init wizard**: safe-delete prompt moved to prompt phase for uninterrupted install
+
+### Added
+- `--hud` flag for `devflow init` to explicitly enable HUD
+- `discoverProjectGitRoots()` utility for finding projects from Claude history
+
+### Removed
+- Extras multiselect (`buildExtrasOptions`) — replaced by individual feature prompts
+
+---
+
+## [1.8.0] - 2026-03-22
+
+### Added
+- **Configurable HUD** replacing bash statusline — 14 components, on/off model (#155)
+- **HUD components**: directory, git branch, ahead/behind, diff stats, release info, worktree count, model, context usage, version badge, session duration, session cost, usage quota, todo progress, config counts
+- **`--hud-only` flag** for standalone HUD install
+- **`--no-hud` flag** to skip HUD during init
+- **`devflow hud` command** (--status, --enable, --disable, --detail, --no-detail)
+- **Version upgrade notification**: `✦ Devflow vX.Y.Z · update: npx devflow-kit init` (yellow, always visible even when HUD disabled)
+- **Skill shadowing docs** and HUD options added to README (#156)
+- **Simplifier agent** — 8 structured slop detection categories (#120)
+- **Scrutinizer agent** — stub detection patterns with reference file (#121)
+- **Shepherd agent** — goal-backward verification, artifact depth checking, stub type, re-verification (#124)
+
+### Changed
+- Init flow: HUD preset picker (5 options) → simple yes/no confirm
+- `--disable` keeps statusLine registered (version badge still renders)
+- Manifest `features.hud` field: `string|false` → `boolean`
+
+### Fixed
+- HUD base branch detection matching raw commit hashes from reflog (#156)
+- HUD comparing main vs main (0/0 always) — now compares against origin/main
+
+### Removed
+- HUD preset system (minimal/classic/standard/full)
+- `--configure`, `--preset`, `--hud <preset>` flags
+- `speed`, `tool-activity`, `agent-activity` components
+
+---
+
 ## [1.7.0] - 2026-03-20
 
 ### Added
@@ -928,6 +976,8 @@ devflow init
 ---
 
 [Unreleased]: https://github.com/dean0x/devflow/compare/v1.4.0...HEAD
+[1.8.1]: https://github.com/dean0x/devflow/compare/v1.8.0...v1.8.1
+[1.8.0]: https://github.com/dean0x/devflow/compare/v1.7.0...v1.8.0
 [1.7.0]: https://github.com/dean0x/devflow/compare/v1.6.1...v1.7.0
 [1.6.1]: https://github.com/dean0x/devflow/compare/v1.6.0...v1.6.1
 [1.6.0]: https://github.com/dean0x/devflow/compare/v1.5.0...v1.6.0

package/README.md

@@ -24,7 +24,7 @@ DevFlow adds structured commands that handle the full lifecycle: specify feature
 - **Full-lifecycle implementation** — spec, explore, plan, code, validate, refine in one command
 - **Automatic session memory** — survives restarts, `/clear`, and context compaction
 - **Parallel debugging** — competing hypotheses investigated simultaneously
-- **Version notifications** — statusline shows an update badge when a newer version is available
+- **Version notifications** — HUD shows `✦ Devflow vX.Y.Z · update: npx devflow-kit init` when a newer version is available
 - **35 quality skills** — 9 auto-activating core, 8 optional language/ecosystem, plus specialized review, agent, and orchestration skills
 
 ## Quick Start
@@ -248,8 +248,38 @@ Session context is saved and restored automatically via Working Memory hooks —
 | `--teams` / `--no-teams` | Enable/disable Agent Teams (experimental, default: off) |
 | `--ambient` / `--no-ambient` | Enable/disable ambient mode (default: on) |
 | `--memory` / `--no-memory` | Enable/disable working memory (default: on) |
+| `--hud` / `--no-hud` | Enable/disable HUD status line (default: on) |
+| `--hud-only` | Install only the HUD (no plugins, hooks, or extras) |
 | `--verbose` | Show detailed output |
 
+### HUD Options
+
+| Command | Description |
+|---------|-------------|
+| `npx devflow-kit hud --status` | Show current HUD config |
+| `npx devflow-kit hud --enable` | Enable HUD |
+| `npx devflow-kit hud --disable` | Disable HUD (version notifications still appear) |
+| `npx devflow-kit hud --detail` | Show tool/agent descriptions |
+| `npx devflow-kit hud --no-detail` | Hide tool/agent descriptions |
+
+### Skill Shadowing
+
+Override any DevFlow skill with your own version. Shadowed skills survive `devflow init` — they won't be overwritten on reinstall or upgrade.
+
+```bash
+# Create a personal override (copies current version as reference)
+npx devflow-kit skills shadow core-patterns
+
+# Edit your override
+vim ~/.claude/skills/core-patterns/SKILL.md
+
+# List all overrides
+npx devflow-kit skills list-shadowed
+
+# Remove override (next init restores DevFlow's version)
+npx devflow-kit skills unshadow core-patterns
+```
+
 ### Uninstall Options
 
 | Option | Description |

package/dist/cli.js

@@ -9,6 +9,7 @@ import { listCommand } from './commands/list.js';
 import { ambientCommand } from './commands/ambient.js';
 import { memoryCommand } from './commands/memory.js';
 import { skillsCommand } from './commands/skills.js';
+import { hudCommand } from './commands/hud.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 // Read version from package.json
@@ -19,7 +20,7 @@ program
     .description('Agentic Development Toolkit for Claude Code\n\nEnhance your AI-assisted development with intelligent commands and workflows.')
     .version(packageJson.version, '-v, --version', 'Display version number')
     .helpOption('-h, --help', 'Display help information')
-    .addHelpText('after', '\nExamples:\n  $ devflow init                       Install all DevFlow plugins\n  $ devflow init --plugin=implement    Install specific plugin\n  $ devflow init --plugin=implement,review  Install multiple plugins\n  $ devflow list                       List available plugins\n  $ devflow ambient --enable           Enable always-on ambient mode\n  $ devflow memory --status            Check working memory state\n  $ devflow uninstall                  Remove DevFlow from Claude Code\n  $ devflow --version                  Show version\n  $ devflow --help                     Show help\n\nDocumentation:\n  https://github.com/dean0x/devflow#readme');
+    .addHelpText('after', '\nExamples:\n  $ devflow init                       Install all DevFlow plugins\n  $ devflow init --plugin=implement    Install specific plugin\n  $ devflow init --plugin=implement,review  Install multiple plugins\n  $ devflow list                       List available plugins\n  $ devflow ambient --enable           Enable always-on ambient mode\n  $ devflow memory --status            Check working memory state\n  $ devflow hud --configure            Configure HUD preset\n  $ devflow uninstall                  Remove DevFlow from Claude Code\n  $ devflow --version                  Show version\n  $ devflow --help                     Show help\n\nDocumentation:\n  https://github.com/dean0x/devflow#readme');
 // Register commands
 program.addCommand(initCommand);
 program.addCommand(uninstallCommand);
@@ -27,6 +28,7 @@ program.addCommand(listCommand);
 program.addCommand(ambientCommand);
 program.addCommand(memoryCommand);
 program.addCommand(skillsCommand);
+program.addCommand(hudCommand);
 // Handle no command
 program.action(() => {
     program.help();

package/dist/commands/hud.d.ts

@@ -0,0 +1,22 @@
+import { Command } from 'commander';
+/**
+ * Add the HUD statusLine to settings JSON.
+ * Idempotent — returns unchanged JSON if HUD already set.
+ * Upgrades legacy statusline.sh to hud.sh automatically.
+ */
+export declare function addHudStatusLine(settingsJson: string, devflowDir: string): string;
+/**
+ * Remove the HUD statusLine from settings JSON.
+ * Idempotent — returns unchanged JSON if statusLine not present or not DevFlow.
+ */
+export declare function removeHudStatusLine(settingsJson: string): string;
+/**
+ * Check if the statusLine in settings JSON points to the DevFlow HUD.
+ */
+export declare function hasHudStatusLine(settingsJson: string): boolean;
+/**
+ * Check if an existing statusLine belongs to a non-DevFlow tool.
+ */
+export declare function hasNonDevFlowStatusLine(settingsJson: string): boolean;
+export declare const hudCommand: Command;
+//# sourceMappingURL=hud.d.ts.map

package/dist/commands/hud.js

@@ -0,0 +1,180 @@
+import { Command } from 'commander';
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import * as p from '@clack/prompts';
+import color from 'picocolors';
+import { getClaudeDirectory, getDevFlowDirectory } from '../utils/paths.js';
+import { HUD_COMPONENTS, loadConfig, saveConfig, } from '../hud/config.js';
+/**
+ * Add the HUD statusLine to settings JSON.
+ * Idempotent — returns unchanged JSON if HUD already set.
+ * Upgrades legacy statusline.sh to hud.sh automatically.
+ */
+export function addHudStatusLine(settingsJson, devflowDir) {
+    const settings = JSON.parse(settingsJson);
+    const hudCommand = path.join(devflowDir, 'scripts', 'hud.sh');
+    // Already pointing to this exact HUD — nothing to do
+    if (settings.statusLine?.command === hudCommand) {
+        return settingsJson;
+    }
+    // If there's a non-DevFlow statusLine, don't overwrite (caller should check first)
+    if (settings.statusLine && !isDevFlowStatusLine(settings.statusLine)) {
+        return settingsJson;
+    }
+    settings.statusLine = {
+        type: 'command',
+        command: hudCommand,
+    };
+    return JSON.stringify(settings, null, 2) + '\n';
+}
+/**
+ * Remove the HUD statusLine from settings JSON.
+ * Idempotent — returns unchanged JSON if statusLine not present or not DevFlow.
+ */
+export function removeHudStatusLine(settingsJson) {
+    const settings = JSON.parse(settingsJson);
+    if (!settings.statusLine) {
+        return settingsJson;
+    }
+    // Only remove if it's a DevFlow HUD/statusline
+    if (!isDevFlowStatusLine(settings.statusLine)) {
+        return settingsJson;
+    }
+    delete settings.statusLine;
+    return JSON.stringify(settings, null, 2) + '\n';
+}
+/**
+ * Check if the statusLine in settings JSON points to the DevFlow HUD.
+ */
+export function hasHudStatusLine(settingsJson) {
+    const settings = JSON.parse(settingsJson);
+    if (!settings.statusLine)
+        return false;
+    return isDevFlowStatusLine(settings.statusLine);
+}
+/**
+ * Check if an existing statusLine belongs to DevFlow (HUD or legacy statusline).
+ * Matches paths containing 'hud.sh', 'statusline.sh', or a '/devflow/' directory segment.
+ */
+function isDevFlowStatusLine(statusLine) {
+    const cmd = statusLine.command ?? '';
+    return (cmd.includes('hud.sh') ||
+        cmd.includes('statusline.sh') ||
+        cmd.includes('/devflow/') ||
+        cmd.includes('\\devflow\\'));
+}
+/**
+ * Check if an existing statusLine belongs to a non-DevFlow tool.
+ */
+export function hasNonDevFlowStatusLine(settingsJson) {
+    const settings = JSON.parse(settingsJson);
+    if (!settings.statusLine?.command)
+        return false;
+    return !isDevFlowStatusLine(settings.statusLine);
+}
+export const hudCommand = new Command('hud')
+    .description('Configure the HUD (status line)')
+    .option('--status', 'Show current HUD config')
+    .option('--detail', 'Show tool/agent descriptions in HUD')
+    .option('--no-detail', 'Hide tool/agent descriptions')
+    .option('--enable', 'Enable HUD in settings')
+    .option('--disable', 'Disable HUD (remove statusLine)')
+    .action(async (options) => {
+    const hasFlag = options.status ||
+        options.enable ||
+        options.disable ||
+        options.detail !== undefined;
+    if (!hasFlag) {
+        p.intro(color.bgCyan(color.white(' HUD ')));
+        p.note(`${color.cyan('devflow hud --detail')}      Show tool/agent descriptions\n` +
+            `${color.cyan('devflow hud --no-detail')}   Hide tool/agent descriptions\n` +
+            `${color.cyan('devflow hud --status')}      Show current config\n` +
+            `${color.cyan('devflow hud --enable')}      Enable HUD in settings\n` +
+            `${color.cyan('devflow hud --disable')}     Remove HUD from settings`, 'Usage');
+        p.note(`${HUD_COMPONENTS.length} components: ${HUD_COMPONENTS.join(', ')}`, 'Components');
+        p.outro(color.dim('Toggle with --enable / --disable'));
+        return;
+    }
+    if (options.status) {
+        const config = loadConfig();
+        p.intro(color.bgCyan(color.white(' HUD Status ')));
+        p.note(`${color.dim('Enabled:')}    ${config.enabled ? color.green('yes') : color.dim('no')}\n` +
+            `${color.dim('Detail:')}     ${config.detail ? color.green('on') : color.dim('off')}\n` +
+            `${color.dim('Components:')} ${HUD_COMPONENTS.length}`, 'Current config');
+        // Check settings.json
+        const claudeDir = getClaudeDirectory();
+        const settingsPath = path.join(claudeDir, 'settings.json');
+        try {
+            const content = await fs.readFile(settingsPath, 'utf-8');
+            const enabled = hasHudStatusLine(content);
+            p.log.info(`Status line: ${enabled ? color.green('enabled') : color.dim('disabled')}`);
+        }
+        catch {
+            p.log.info(`Status line: ${color.dim('no settings.json found')}`);
+        }
+        return;
+    }
+    if (options.detail !== undefined) {
+        const config = loadConfig();
+        config.detail = options.detail;
+        saveConfig(config);
+        p.log.success(`HUD detail ${config.detail ? 'enabled' : 'disabled'}`);
+        return;
+    }
+    if (options.enable) {
+        const claudeDir = getClaudeDirectory();
+        const settingsPath = path.join(claudeDir, 'settings.json');
+        let settingsContent;
+        try {
+            settingsContent = await fs.readFile(settingsPath, 'utf-8');
+        }
+        catch {
+            settingsContent = '{}';
+        }
+        // Ensure statusLine is registered
+        if (!hasHudStatusLine(settingsContent)) {
+            // Check for non-DevFlow statusLine
+            if (hasNonDevFlowStatusLine(settingsContent)) {
+                const settings = JSON.parse(settingsContent);
+                p.log.warn(`Existing statusLine found: ${color.dim(settings.statusLine?.command ?? 'unknown')}`);
+                if (process.stdin.isTTY) {
+                    const overwrite = await p.confirm({
+                        message: 'Replace existing statusLine with DevFlow HUD?',
+                        initialValue: false,
+                    });
+                    if (p.isCancel(overwrite) || !overwrite) {
+                        p.log.info('HUD not enabled — existing statusLine preserved');
+                        return;
+                    }
+                }
+                else {
+                    p.log.info('Non-interactive mode — skipping (existing statusLine would be overwritten)');
+                    return;
+                }
+            }
+            const devflowDir = getDevFlowDirectory();
+            const updated = addHudStatusLine(settingsContent, devflowDir);
+            await fs.writeFile(settingsPath, updated, 'utf-8');
+        }
+        // Update config
+        const config = loadConfig();
+        if (config.enabled) {
+            p.log.info('HUD already enabled');
+            return;
+        }
+        saveConfig({ ...config, enabled: true });
+        p.log.success('HUD enabled');
+        p.log.info(color.dim('Restart Claude Code to see the HUD'));
+    }
+    if (options.disable) {
+        const config = loadConfig();
+        if (!config.enabled) {
+            p.log.info('HUD already disabled');
+            return;
+        }
+        saveConfig({ ...config, enabled: false });
+        p.log.success('HUD disabled');
+        p.log.info(color.dim('Version upgrade notifications will still appear'));
+    }
+});
+//# sourceMappingURL=hud.js.map

package/dist/commands/init.d.ts

@@ -1,8 +1,9 @@
 import { Command } from 'commander';
 import { type PluginDefinition } from '../plugins.js';
-export { substituteSettingsTemplate, computeGitignoreAppend, applyTeamsConfig, stripTeamsConfig, mergeDenyList } from '../utils/post-install.js';
+export { substituteSettingsTemplate, computeGitignoreAppend, applyTeamsConfig, stripTeamsConfig, mergeDenyList, discoverProjectGitRoots } from '../utils/post-install.js';
 export { addAmbientHook, removeAmbientHook, hasAmbientHook } from './ambient.js';
 export { addMemoryHooks, removeMemoryHooks, hasMemoryHooks } from './memory.js';
+export { addHudStatusLine, removeHudStatusLine, hasHudStatusLine } from './hud.js';
 /**
  * Parse a comma-separated plugin selection string into normalized plugin names.
  * Validates against known plugins; returns invalid names as errors.
@@ -11,16 +12,5 @@ export declare function parsePluginSelection(input: string, validPlugins: Plugin
     selected: string[];
     invalid: string[];
 };
-export type ExtraId = 'settings' | 'claudeignore' | 'gitignore' | 'docs' | 'safe-delete';
-interface ExtraOption {
-    value: ExtraId;
-    label: string;
-    hint: string;
-}
-/**
- * Build the list of configuration extras available for the given scope/git context.
- * Pure function — no I/O, no side effects.
- */
-export declare function buildExtrasOptions(scope: 'user' | 'local', gitRoot: string | null): ExtraOption[];
 export declare const initCommand: Command;
 //# sourceMappingURL=init.d.ts.map