devflow-kit 1.4.0 → 1.6.0

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.6.0] - 2026-03-19
+
+### Added
+- **Ambient agent orchestration**: ORCHESTRATED tier spawns agent pipelines for IMPLEMENT, DEBUG, PLAN intents
+- **Orchestration skills**: `implementation-orchestration`, `debug-orchestration`, `plan-orchestration` for ambient agent pipelines
+- **`knowledge-persistence` skill** (#145) — extraction procedure, lock protocol, loading instructions for project knowledge
+- **Knowledge loading phase** (#145) — `/debug`, `/specify`, `/self-review` now load project knowledge at startup
+- **Pitfall recording phase** (#145) — `/code-review`, `/resolve` record pitfalls to `.memory/knowledge/pitfalls.md`
+- **Knowledge directory** (#145) — `.memory/knowledge/` with `decisions.md` (ADR-NNN, append-only) and `pitfalls.md` (area-specific gotchas)
+
+### Changed
+- **Ambient mode**: Three depth tiers (QUICK/GUIDED/ORCHESTRATED) replacing old QUICK/GUIDED/ELEVATE
+- **Ambient mode**: GUIDED tier for small-scope IMPLEMENT (≤2 files), simple DEBUG, focused PLAN, and REVIEW — main session with skills + Simplifier
+- **Ambient mode**: BUILD intent renamed to IMPLEMENT for clarity
+- **Coder agent**: Added `test-driven-development` and `search-first` to permanent skills
+- **Command phase numbering** (#145) — renumbered fractional phases to sequential integers across 12 command files
+
+### Fixed
+- **Agent metadata** (#146) — fixed `subagent_type` in debug, added missing YAML frontmatter
+- **Plugin count** (#146) — corrected to "8 core + 9 optional"
+- **Skills catalog** (#146) — cataloged 3 missing skills in reference
+- **Debug command** (#147) — removed non-standard `name=` parameter
+- **Plugin descriptions** (#147, #148) — synced across plugin.json, plugins.ts, marketplace.json
+- **Simplifier agent** (#148) — added Output/Boundaries sections
+- **Plugin metadata** (#148) — added homepage/repository/license/keywords to 3 plugins
+
+### Removed
+- **`/ambient` command**: Ambient mode is now hook-only. Use `devflow ambient --enable` to activate.
+
+### Behavioral Changes
+- EXPLORE intent now always classifies as QUICK (was split QUICK/GUIDED)
+- Simple text edits ("Update the README") classify as QUICK (was BUILD/GUIDED)
+- Debug agent budget cap removed — agents scale to investigation needs
+
+---
+
+## [1.5.0] - 2026-03-13
+
+### Added
+- **Search-first skill** (#111) — New skill enforcing research before building custom utility code. 4-phase loop: Need Analysis → Search (via Explore subagent) → Evaluate → Decide (Adopt/Extend/Compose/Build)
+- **Reviewer confidence thresholds** (#113) — Each review finding now includes a visible confidence score (0-100%). Only ≥80% findings appear in main sections; lower-confidence items go to a capped Suggestions section. Adds consolidation rules to group similar issues and skip stylistic preferences
+- **Version manifest** (#91) — Tracks installed version, plugins, and features in `manifest.json`. Enables upgrade detection during `devflow init` and shows install status in `devflow list`
+
+### Fixed
+- **Synthesizer review glob** — Fixed `${REVIEW_BASE_DIR}/*-report.*.md` glob that matched zero reviewer files; now uses `${REVIEW_BASE_DIR}/*.md` with self-exclusion
+
+---
+
 ## [1.4.0] - 2026-03-09
 
 ### Added
@@ -853,6 +901,9 @@ devflow init
 
 ---
 
+[Unreleased]: https://github.com/dean0x/devflow/compare/v1.4.0...HEAD
+[1.6.0]: https://github.com/dean0x/devflow/compare/v1.5.0...v1.6.0
+[1.5.0]: https://github.com/dean0x/devflow/compare/v1.4.0...v1.5.0
 [1.4.0]: https://github.com/dean0x/devflow/compare/v1.3.3...v1.4.0
 [1.3.3]: https://github.com/dean0x/devflow/compare/v1.3.2...v1.3.3
 [1.3.2]: https://github.com/dean0x/devflow/compare/v1.3.1...v1.3.2

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
-- **30 quality skills** — 8 auto-activating core, 8 optional language/ecosystem, plus specialized review and agent skills
+- **35 quality skills** — 9 auto-activating core, 8 optional language/ecosystem, plus specialized review, agent, and orchestration skills
 
 ## Quick Start
 
@@ -48,7 +48,7 @@ Then in Claude Code:
 | `devflow-resolve` | `/resolve` | Process review issues — fix or defer to tech debt |
 | `devflow-debug` | `/debug` | Parallel hypothesis debugging |
 | `devflow-self-review` | `/self-review` | Self-review workflow (Simplifier + Scrutinizer) |
-| `devflow-ambient` | `/ambient` | Ambient mode — auto-loads relevant skills based on each prompt |
+| `devflow-ambient` | (hook) | Ambient mode — intent classification with agent orchestration |
 | `devflow-core-skills` | (auto) | Auto-activating quality enforcement skills |
 
 ## Command Details
@@ -120,6 +120,7 @@ The `devflow-core-skills` plugin provides quality enforcement skills that activa
 | `test-driven-development` | Implementing new features (RED-GREEN-REFACTOR) |
 | `test-patterns` | Writing or modifying tests |
 | `input-validation` | Creating API endpoints |
+| `search-first` | Adding utilities, helpers, or infrastructure code |
 
 ## Language & Ecosystem Plugins
 
@@ -197,7 +198,10 @@ DevFlow creates project documentation in `.docs/` and working memory in `.memory
 .memory/
 ├── WORKING-MEMORY.md         # Auto-maintained by Stop hook
 ├── PROJECT-PATTERNS.md       # Accumulated patterns across sessions
-└── backup.json               # Pre-compact git state snapshot
+├── backup.json               # Pre-compact git state snapshot
+└── knowledge/
+    ├── decisions.md           # Architectural decisions (ADR-NNN, append-only)
+    └── pitfalls.md            # Known pitfalls (area-specific gotchas)
 ```
 
 ## Workflow Examples

package/dist/commands/ambient.js

@@ -122,7 +122,7 @@ export const ambientCommand = new Command('ambient')
         }
         await fs.writeFile(settingsPath, updated, 'utf-8');
         p.log.success('Ambient mode enabled — UserPromptSubmit hook registered');
-        p.log.info(color.dim('Relevant skills will now auto-load based on each prompt'));
+        p.log.info(color.dim('Skills auto-load and agents orchestrate based on each prompt'));
     }
     if (options.disable) {
         const updated = removeAmbientHook(settingsContent);

package/dist/commands/init.js

@@ -15,6 +15,7 @@ import { detectPlatform, detectShell, getProfilePath, getSafeDeleteInfo, hasSafe
 import { generateSafeDeleteBlock, installToProfile, removeFromProfile, getInstalledVersion, SAFE_DELETE_BLOCK_VERSION } from '../utils/safe-delete-install.js';
 import { addAmbientHook } from './ambient.js';
 import { addMemoryHooks, removeMemoryHooks } from './memory.js';
+import { readManifest, writeManifest, resolvePluginList, detectUpgrade } from '../utils/manifest.js';
 // Re-export pure functions for tests (canonical source is post-install.ts)
 export { substituteSettingsTemplate, computeGitignoreAppend, applyTeamsConfig, stripTeamsConfig, mergeDenyList } from '../utils/post-install.js';
 export { addAmbientHook, removeAmbientHook, hasAmbientHook } from './ambient.js';
@@ -61,7 +62,7 @@ export const initCommand = new Command('init')
     .option('--plugin <names>', 'Install specific plugin(s), comma-separated (e.g., implement,code-review)')
     .option('--teams', 'Enable Agent Teams (peer debate, adversarial review)')
     .option('--no-teams', 'Disable Agent Teams (use parallel subagents instead)')
-    .option('--ambient', 'Enable ambient mode (auto-loads relevant skills for every prompt)')
+    .option('--ambient', 'Enable ambient mode (classifies intent, loads skills, orchestrates agents)')
     .option('--no-ambient', 'Disable ambient mode')
     .option('--memory', 'Enable working memory (session context preservation)')
     .option('--no-memory', 'Disable working memory hooks')
@@ -175,7 +176,7 @@ export const initCommand = new Command('init')
         const ambientChoice = await p.select({
             message: 'Enable ambient mode?',
             options: [
-                { value: true, label: 'Yes (Recommended)', hint: 'Auto-loads relevant skills for each prompt' },
+                { value: true, label: 'Yes (Recommended)', hint: 'Classifies intent, loads skills, orchestrates agents' },
                 { value: false, label: 'No', hint: 'Full control — load skills manually' },
             ],
         });
@@ -238,6 +239,17 @@ export const initCommand = new Command('init')
         p.log.error(`Path configuration error: ${error instanceof Error ? error.message : error}`);
         process.exit(1);
     }
+    // Check existing manifest for upgrade detection
+    const existingManifest = await readManifest(devflowDir);
+    if (existingManifest) {
+        const upgrade = detectUpgrade(version, existingManifest.version);
+        if (upgrade.isUpgrade) {
+            s.message(`Upgrading from v${upgrade.previousVersion} to v${version}`);
+        }
+        else if (upgrade.isSameVersion) {
+            s.message('Reinstalling same version');
+        }
+    }
     // Validate target directory
     s.message('Validating target directory');
     if (scope === 'local') {
@@ -519,6 +531,23 @@ export const initCommand = new Command('init')
         p.log.info(`Deduplication: ${skillsMap.size} unique skills (from ${totalSkillDeclarations} declarations)`);
         p.log.info(`Deduplication: ${agentsMap.size} unique agents (from ${totalAgentDeclarations} declarations)`);
     }
+    // Write installation manifest for upgrade tracking (non-fatal — install already succeeded)
+    const installedPluginNames = pluginsToInstall.map(pl => pl.name);
+    const now = new Date().toISOString();
+    const manifestData = {
+        version,
+        plugins: resolvePluginList(installedPluginNames, existingManifest, !!options.plugin),
+        scope,
+        features: { teams: teamsEnabled, ambient: ambientEnabled, memory: memoryEnabled },
+        installedAt: existingManifest?.installedAt ?? now,
+        updatedAt: now,
+    };
+    try {
+        await writeManifest(devflowDir, manifestData);
+    }
+    catch (error) {
+        p.log.warn(`Failed to write installation manifest (install succeeded): ${error instanceof Error ? error.message : error}`);
+    }
     p.outro(color.green('Ready! Run any command in Claude Code to get started.'));
 });
 //# sourceMappingURL=init.js.map

package/dist/commands/list.d.ts

@@ -1,3 +1,24 @@
 import { Command } from 'commander';
+import { type ManifestData } from '../utils/manifest.js';
+/**
+ * Format manifest feature flags into a human-readable comma-separated string.
+ * Returns 'none' when no features are enabled.
+ */
+export declare function formatFeatures(features: ManifestData['features']): string;
+/**
+ * Determine effective installation scope based on which manifest was found.
+ * Local scope takes precedence when a local manifest exists.
+ */
+export declare function resolveScope(localManifest: ManifestData | null): 'user' | 'local';
+/**
+ * Compute the install status indicator for a plugin.
+ * Returns 'installed', 'not_installed', or 'unknown' (when no manifest exists).
+ */
+export declare function getPluginInstallStatus(pluginName: string, installedPlugins: ReadonlySet<string>, hasManifest: boolean): 'installed' | 'not_installed' | 'unknown';
+/**
+ * Format the commands portion of a plugin entry.
+ * Returns the comma-separated command list or '(skills only)' for skill-only plugins.
+ */
+export declare function formatPluginCommands(commands: string[]): string;
 export declare const listCommand: Command;
 //# sourceMappingURL=list.d.ts.map

package/dist/commands/list.js

@@ -2,19 +2,87 @@ import { Command } from 'commander';
 import * as p from '@clack/prompts';
 import color from 'picocolors';
 import { DEVFLOW_PLUGINS } from '../plugins.js';
+import { getDevFlowDirectory } from '../utils/paths.js';
+import { getGitRoot } from '../utils/git.js';
+import { readManifest } from '../utils/manifest.js';
+import * as path from 'path';
+/**
+ * Format manifest feature flags into a human-readable comma-separated string.
+ * Returns 'none' when no features are enabled.
+ */
+export function formatFeatures(features) {
+    return [
+        features.teams ? 'teams' : null,
+        features.ambient ? 'ambient' : null,
+        features.memory ? 'memory' : null,
+    ].filter(Boolean).join(', ') || 'none';
+}
+/**
+ * Determine effective installation scope based on which manifest was found.
+ * Local scope takes precedence when a local manifest exists.
+ */
+export function resolveScope(localManifest) {
+    return localManifest ? 'local' : 'user';
+}
+/**
+ * Compute the install status indicator for a plugin.
+ * Returns 'installed', 'not_installed', or 'unknown' (when no manifest exists).
+ */
+export function getPluginInstallStatus(pluginName, installedPlugins, hasManifest) {
+    if (!hasManifest)
+        return 'unknown';
+    return installedPlugins.has(pluginName) ? 'installed' : 'not_installed';
+}
+/**
+ * Format the commands portion of a plugin entry.
+ * Returns the comma-separated command list or '(skills only)' for skill-only plugins.
+ */
+export function formatPluginCommands(commands) {
+    return commands.length > 0 ? commands.join(', ') : '(skills only)';
+}
 export const listCommand = new Command('list')
     .description('List available DevFlow plugins')
-    .action(() => {
+    .action(async () => {
     p.intro(color.bgCyan(color.black(' DevFlow Plugins ')));
+    // Resolve user manifest and git root in parallel (independent I/O)
+    const userDevflowDir = getDevFlowDirectory();
+    const [gitRoot, userManifest] = await Promise.all([
+        getGitRoot(),
+        readManifest(userDevflowDir),
+    ]);
+    const localDevflowDir = gitRoot ? path.join(gitRoot, '.devflow') : null;
+    const localManifest = localDevflowDir ? await readManifest(localDevflowDir) : null;
+    const manifest = localManifest ?? userManifest;
+    // Show install status if manifest exists
+    if (manifest) {
+        const installedAt = new Date(manifest.installedAt).toLocaleDateString();
+        const updatedAt = new Date(manifest.updatedAt).toLocaleDateString();
+        const scope = resolveScope(localManifest);
+        const features = formatFeatures(manifest.features);
+        p.note(`${color.dim('Version:')}  ${color.cyan(`v${manifest.version}`)}\n` +
+            `${color.dim('Scope:')}    ${scope}\n` +
+            `${color.dim('Features:')} ${features}\n` +
+            `${color.dim('Installed:')} ${installedAt}` +
+            (installedAt !== updatedAt ? `  ${color.dim('Updated:')} ${updatedAt}` : ''), 'Installation');
+    }
+    const installedPlugins = new Set(manifest?.plugins ?? []);
+    const hasManifest = manifest !== null;
     const maxNameLen = Math.max(...DEVFLOW_PLUGINS.map(p => p.name.length));
     const pluginList = DEVFLOW_PLUGINS
         .map(plugin => {
-        const cmds = plugin.commands.length > 0 ? plugin.commands.join(', ') : '(skills only)';
+        const cmds = formatPluginCommands(plugin.commands);
         const optionalTag = plugin.optional ? color.dim(' (optional)') : '';
-        return `${color.cyan(plugin.name.padEnd(maxNameLen + 2))}${color.dim(plugin.description)}${optionalTag}\n${' '.repeat(maxNameLen + 2)}${color.yellow(cmds)}`;
+        const status = getPluginInstallStatus(plugin.name, installedPlugins, hasManifest);
+        const installedTag = status === 'installed' ? color.green(' ✓')
+            : status === 'not_installed' ? color.dim(' ✗')
+                : '';
+        return `${color.cyan(plugin.name.padEnd(maxNameLen + 2))}${color.dim(plugin.description)}${optionalTag}${installedTag}\n${' '.repeat(maxNameLen + 2)}${color.yellow(cmds)}`;
     })
         .join('\n\n');
     p.note(pluginList, 'Available plugins');
+    if (!manifest) {
+        p.log.info(color.dim('Run `devflow init` for install tracking'));
+    }
     p.outro(color.dim('Install with: npx devflow-kit init --plugin=<name>'));
 });
 //# sourceMappingURL=list.js.map

package/dist/plugins.js

@@ -7,59 +7,59 @@
 export const DEVFLOW_PLUGINS = [
     {
         name: 'devflow-core-skills',
-        description: 'Auto-activating quality enforcement (foundation layer)',
+        description: 'Auto-activating quality enforcement skills - foundation layer for all DevFlow plugins',
         commands: [],
         agents: [],
-        skills: ['core-patterns', 'docs-framework', 'git-safety', 'git-workflow', 'github-patterns', 'input-validation', 'test-driven-development', 'test-patterns'],
+        skills: ['core-patterns', 'docs-framework', 'git-safety', 'git-workflow', 'github-patterns', 'input-validation', 'search-first', 'test-driven-development', 'test-patterns'],
     },
     {
         name: 'devflow-specify',
-        description: 'Interactive feature specification',
+        description: 'Interactive feature specification - creates well-defined GitHub issues',
         commands: ['/specify'],
         agents: ['skimmer', 'synthesizer'],
         skills: ['agent-teams'],
     },
     {
         name: 'devflow-implement',
-        description: 'Complete task implementation workflow',
+        description: 'Complete task implementation workflow with exploration, planning, and coding',
         commands: ['/implement'],
         agents: ['git', 'skimmer', 'synthesizer', 'coder', 'simplifier', 'scrutinizer', 'shepherd', 'validator'],
-        skills: ['agent-teams', 'implementation-patterns', 'self-review'],
+        skills: ['agent-teams', 'implementation-patterns', 'knowledge-persistence', 'self-review'],
     },
     {
         name: 'devflow-code-review',
-        description: 'Comprehensive code review',
+        description: 'Comprehensive code review with parallel specialized agents',
         commands: ['/code-review'],
         agents: ['git', 'reviewer', 'synthesizer'],
-        skills: ['agent-teams', 'architecture-patterns', 'complexity-patterns', 'consistency-patterns', 'database-patterns', 'dependencies-patterns', 'documentation-patterns', 'performance-patterns', 'regression-patterns', 'review-methodology', 'security-patterns', 'test-patterns'],
+        skills: ['agent-teams', 'architecture-patterns', 'complexity-patterns', 'consistency-patterns', 'database-patterns', 'dependencies-patterns', 'documentation-patterns', 'knowledge-persistence', 'performance-patterns', 'regression-patterns', 'review-methodology', 'security-patterns', 'test-patterns'],
     },
     {
         name: 'devflow-resolve',
-        description: 'Process and fix review issues',
+        description: 'Process and fix code review issues with risk assessment',
         commands: ['/resolve'],
         agents: ['git', 'resolver', 'simplifier'],
-        skills: ['agent-teams', 'implementation-patterns', 'security-patterns'],
+        skills: ['agent-teams', 'implementation-patterns', 'knowledge-persistence', 'security-patterns'],
     },
     {
         name: 'devflow-debug',
-        description: 'Debugging with competing hypotheses',
+        description: 'Debugging workflows with competing hypothesis investigation using agent teams',
         commands: ['/debug'],
-        agents: ['git'],
-        skills: ['agent-teams', 'git-safety'],
+        agents: ['git', 'synthesizer'],
+        skills: ['agent-teams', 'git-safety', 'knowledge-persistence'],
     },
     {
         name: 'devflow-self-review',
-        description: 'Self-review workflow (Simplifier + Scrutinizer)',
+        description: 'Self-review workflow: Simplifier + Scrutinizer for code quality',
         commands: ['/self-review'],
         agents: ['simplifier', 'scrutinizer', 'validator'],
         skills: ['self-review', 'core-patterns'],
     },
     {
         name: 'devflow-ambient',
-        description: 'Ambient mode — auto-loads relevant skills based on each prompt',
+        description: 'Ambient mode — intent classification with proportional agent orchestration',
         commands: ['/ambient'],
-        agents: [],
-        skills: ['ambient-router'],
+        agents: ['coder', 'validator', 'simplifier', 'scrutinizer', 'shepherd', 'skimmer', 'reviewer'],
+        skills: ['ambient-router', 'implementation-orchestration', 'debug-orchestration', 'plan-orchestration'],
     },
     {
         name: 'devflow-audit-claude',
@@ -71,7 +71,7 @@ export const DEVFLOW_PLUGINS = [
     },
     {
         name: 'devflow-typescript',
-        description: 'TypeScript language patterns (type safety, generics, utility types)',
+        description: 'TypeScript language patterns - type safety, generics, utility types, type guards',
         commands: [],
         agents: [],
         skills: ['typescript'],
@@ -79,7 +79,7 @@ export const DEVFLOW_PLUGINS = [
     },
     {
         name: 'devflow-react',
-        description: 'React framework patterns (hooks, state, composition, performance)',
+        description: 'React framework patterns - hooks, state management, composition, performance',
         commands: [],
         agents: [],
         skills: ['react'],
@@ -87,7 +87,7 @@ export const DEVFLOW_PLUGINS = [
     },
     {
         name: 'devflow-accessibility',
-        description: 'Web accessibility patterns (WCAG, ARIA, keyboard navigation)',
+        description: 'Web accessibility patterns - WCAG compliance, ARIA roles, keyboard navigation, focus management',
         commands: [],
         agents: [],
         skills: ['accessibility'],
@@ -95,7 +95,7 @@ export const DEVFLOW_PLUGINS = [
     },
     {
         name: 'devflow-frontend-design',
-        description: 'Frontend design patterns (typography, color, spacing, motion)',
+        description: 'Frontend design patterns - typography, color systems, spacing, motion, responsive design',
         commands: [],
         agents: [],
         skills: ['frontend-design'],
@@ -103,7 +103,7 @@ export const DEVFLOW_PLUGINS = [
     },
     {
         name: 'devflow-go',
-        description: 'Go language patterns (error handling, interfaces, concurrency)',
+        description: 'Go language patterns - error handling, interfaces, concurrency, package design',
         commands: [],
         agents: [],
         skills: ['go'],
@@ -111,7 +111,7 @@ export const DEVFLOW_PLUGINS = [
     },
     {
         name: 'devflow-java',
-        description: 'Java language patterns (records, sealed classes, composition)',
+        description: 'Java language patterns - records, sealed classes, composition, modern Java features',
         commands: [],
         agents: [],
         skills: ['java'],
@@ -119,7 +119,7 @@ export const DEVFLOW_PLUGINS = [
     },
     {
         name: 'devflow-python',
-        description: 'Python language patterns (type hints, protocols, data modeling)',
+        description: 'Python language patterns - type hints, protocols, dataclasses, async programming',
         commands: [],
         agents: [],
         skills: ['python'],
@@ -127,7 +127,7 @@ export const DEVFLOW_PLUGINS = [
     },
     {
         name: 'devflow-rust',
-        description: 'Rust language patterns (ownership, error handling, type system)',
+        description: 'Rust language patterns - ownership, borrowing, error handling, type-driven design',
         commands: [],
         agents: [],
         skills: ['rust'],

package/dist/utils/manifest.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Manifest data tracked for each DevFlow installation.
+ */
+export interface ManifestData {
+    version: string;
+    plugins: string[];
+    scope: 'user' | 'local';
+    features: {
+        teams: boolean;
+        ambient: boolean;
+        memory: boolean;
+    };
+    installedAt: string;
+    updatedAt: string;
+}
+/**
+ * Read and parse the manifest file. Returns null if missing or corrupt.
+ */
+export declare function readManifest(devflowDir: string): Promise<ManifestData | null>;
+/**
+ * Write manifest to disk. Creates parent directory if needed.
+ */
+export declare function writeManifest(devflowDir: string, data: ManifestData): Promise<void>;
+/**
+ * Merge new plugins into existing plugin list (union, no duplicates).
+ * Preserves order: existing plugins first, then new ones appended.
+ */
+export declare function mergeManifestPlugins(existing: string[], newPlugins: string[]): string[];
+/**
+ * Detect upgrade/downgrade/same version status.
+ */
+export interface UpgradeInfo {
+    isUpgrade: boolean;
+    isDowngrade: boolean;
+    isSameVersion: boolean;
+    previousVersion: string | null;
+}
+/**
+ * Resolve the final plugin list for a manifest write.
+ * On partial installs (--plugin flag), merge newly installed plugins into
+ * the existing manifest's plugin list. On full installs, replace entirely.
+ */
+export declare function resolvePluginList(installedPluginNames: string[], existingManifest: ManifestData | null, isPartialInstall: boolean): string[];
+export declare function detectUpgrade(currentVersion: string, installedVersion: string | null): UpgradeInfo;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/utils/manifest.js

@@ -0,0 +1,100 @@
+import { promises as fs } from 'fs';
+import * as path from 'path';
+/**
+ * Read and parse the manifest file. Returns null if missing or corrupt.
+ */
+export async function readManifest(devflowDir) {
+    const manifestPath = path.join(devflowDir, 'manifest.json');
+    try {
+        const content = await fs.readFile(manifestPath, 'utf-8');
+        const data = JSON.parse(content);
+        if (!data.version ||
+            !Array.isArray(data.plugins) ||
+            !data.scope ||
+            typeof data.features !== 'object' ||
+            data.features === null ||
+            typeof data.features.teams !== 'boolean' ||
+            typeof data.features.ambient !== 'boolean' ||
+            typeof data.features.memory !== 'boolean' ||
+            typeof data.installedAt !== 'string' ||
+            typeof data.updatedAt !== 'string') {
+            return null;
+        }
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write manifest to disk. Creates parent directory if needed.
+ */
+export async function writeManifest(devflowDir, data) {
+    await fs.mkdir(devflowDir, { recursive: true });
+    const manifestPath = path.join(devflowDir, 'manifest.json');
+    await fs.writeFile(manifestPath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Merge new plugins into existing plugin list (union, no duplicates).
+ * Preserves order: existing plugins first, then new ones appended.
+ */
+export function mergeManifestPlugins(existing, newPlugins) {
+    const merged = [...existing];
+    for (const plugin of newPlugins) {
+        if (!merged.includes(plugin)) {
+            merged.push(plugin);
+        }
+    }
+    return merged;
+}
+/**
+ * Compare two semver strings. Returns -1, 0, or 1.
+ * Handles simple x.y.z versions; returns null for unparseable input.
+ *
+ * Note: Pre-release suffixes (e.g., `-beta.1`, `-rc.2`) are silently ignored.
+ * `1.0.0-beta.1` and `1.0.0` compare as equal. Build metadata is also ignored.
+ */
+function compareSemver(a, b) {
+    const parse = (v) => {
+        const match = v.match(/^v?(\d+)\.(\d+)\.(\d+)/);
+        return match ? [Number(match[1]), Number(match[2]), Number(match[3])] : [];
+    };
+    const pa = parse(a);
+    const pb = parse(b);
+    if (pa.length === 0 || pb.length === 0)
+        return null;
+    for (let i = 0; i < 3; i++) {
+        if (pa[i] > pb[i])
+            return 1;
+        if (pa[i] < pb[i])
+            return -1;
+    }
+    return 0;
+}
+/**
+ * Resolve the final plugin list for a manifest write.
+ * On partial installs (--plugin flag), merge newly installed plugins into
+ * the existing manifest's plugin list. On full installs, replace entirely.
+ */
+export function resolvePluginList(installedPluginNames, existingManifest, isPartialInstall) {
+    if (existingManifest && isPartialInstall) {
+        return mergeManifestPlugins(existingManifest.plugins, installedPluginNames);
+    }
+    return installedPluginNames;
+}
+export function detectUpgrade(currentVersion, installedVersion) {
+    if (!installedVersion) {
+        return { isUpgrade: false, isDowngrade: false, isSameVersion: false, previousVersion: null };
+    }
+    const cmp = compareSemver(currentVersion, installedVersion);
+    if (cmp === null) {
+        return { isUpgrade: false, isDowngrade: false, isSameVersion: false, previousVersion: installedVersion };
+    }
+    return {
+        isUpgrade: cmp > 0,
+        isDowngrade: cmp < 0,
+        isSameVersion: cmp === 0,
+        previousVersion: installedVersion,
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/utils/post-install.js

@@ -425,11 +425,16 @@ export async function createMemoryDir(verbose, cwd) {
     const memoryDir = path.join(cwd ?? process.cwd(), '.memory');
     try {
         await fs.mkdir(memoryDir, { recursive: true });
+        await fs.mkdir(path.join(memoryDir, 'knowledge'), { recursive: true });
         if (verbose) {
             p.log.success('.memory/ directory ready');
         }
     }
-    catch { /* may already exist */ }
+    catch (e) {
+        if (verbose) {
+            p.log.warn(`Failed to create .memory/ directory: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
 }
 /**
  * Migrate memory files from .docs/ to .memory/.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devflow-kit",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Agentic Development Toolkit for Claude Code - Enhance AI-assisted development with intelligent commands and workflows",
   "type": "module",
   "bin": {

package/plugins/devflow-accessibility/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "Dean0x"
   },
-  "version": "1.4.0",
+  "version": "1.6.0",
   "homepage": "https://github.com/dean0x/devflow",
   "repository": "https://github.com/dean0x/devflow",
   "license": "MIT",