procedure-cli 0.1.11 → 0.1.13

package/dist/steps/project-info.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-info.js","sourceRoot":"","sources":["../../src/steps/project-info.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"project-info.js","sourceRoot":"","sources":["../../src/steps/project-info.tsx"],"names":[],"mappings":"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"}

package/docs/PRD.md

@@ -2,7 +2,7 @@
 
 ## Vision
 
-Empower developers to start projects with production-ready documentation and architecture decisions from day one, reducing onboarding time and ensuring best practices are baked in.
+Empower developers to start projects with production-ready documentation and architecture decisions from day one, reducing onboarding time and ensuring best practices are baked in from the first commit.
 
 ## Problem
 
@@ -24,46 +24,53 @@ Empower developers to start projects with production-ready documentation and arc
 ## Core Features
 
 **F-001: Interactive Project Wizard**
-- 7-step guided setup with timeline progress view
-- Validates input, provides sensible defaults
-- Timeline preview shows estimated completion time
+- 7-step guided setup with Catppuccin Mocha timeline UI
+- `┌`/`└` corners wrap the full flow; animated dot on active step
+- Empty-directory guard: warns when cwd has files and continues — Step 6 overwrite confirmation handles conflicts
+- Validates required fields; ESC exits at any point; Enter exits on completion
+- In-step field navigation: `Tab` = next field, `Shift+Tab` = previous field, `Enter` = confirm; `↑`/`↓` retain their option-navigation role inside selects
 
 **F-002: CLAUDE.md Generation**
-- Code style and import conventions
-- Build & test commands
-- Architecture decisions and rationale
-- Workflow guidance (planning, verification, bug fixing)
+- Code style and import conventions (from preset or manual config)
+- Build, test, typecheck, lint, and pre-PR commands
+- Architecture pattern with auto-generated best-practice notes
+- Workflow guidance (planning, verification, bug fixing, elegance)
 - Lessons learned section (AI-updatable)
 
 **F-003: PRD.md Generation**
 - Vision, problem statement, target users
-- Core features (F-001 through F-006 format)
-- Non-goals and success metrics
-- Tech stack table
-- Open questions placeholder
+- Core features (F-001 format), non-goals, tech stack table
+- Success metrics placeholder, open questions section
 
 **F-004: USER-STORIES.md Generation**
 - Gherkin-formatted acceptance criteria
 - "As a / I want / So that" narrative format
 - Feature scenarios with Given/When/Then
-- Supports 9+ standard scenarios (full scaffolding, quick start, powerline, etc.)
+- Scaffolded from wizard-collected core features and user context
 
 **F-005: Environment & Config Files**
 - `.env.example` template with user-specified variables
-- `.gitignore` with language/framework-specific rules
+- `.gitignore` with language/framework-specific defaults
 
-**F-006: Powerline Integration (Optional)**
-- Shell prompt styling and configuration
-- Powerline font detection and fallbacks
-- Theme color selection during setup
+**F-006: QuickStart Presets**
+- 6 one-click presets: TypeScript+Node, Next.js, React SPA, Python+FastAPI, Go, React Native+Expo
+- Each preset pre-fills stack, build, test, typecheck, lint, and pre-PR commands
+- "Configure manually →" option for custom language/framework/code-style
+
+**F-007: Setup & Tooling Integration (Optional)**
+Each option is explained before the yes/no prompt:
+- **Claude Powerline** — live status bar (git branch, context %, session cost, active tools); deployed via `npx` per session, no global install
+- **Git repository** — `git init` + initial commit containing all generated files
+- **npm release scripts** — creates `~/bin/<project>-release`; adds `release:patch`, `release:minor`, `release:major` to `package.json`; adapts commands to selected package manager
 
 ### Visual Style
 
-- **Banner:** ASCII header with "Procedure CLI" branding
-- **Timeline:** Vertical step indicators (pending → active → completed)
-- **Colors:** Cyan for highlights, green for success, dim gray for secondary info
-- **Icons:** ✔ (completed), ► (active), ○ (pending)
-- **Spacing:** Single-line padding, clean box layouts via Ink
+- **Theme:** Catppuccin Mocha Dark (mauve active, green complete, sapphire headers, overlay1 gutter)
+- **Layout:** `┌`/`│`/`└` vertical timeline with `┌` before step 1 and `└` after step 7
+- **Active step:** Animated dot cycling `◆ → ◈ → ◇ → ◈` at 350 ms
+- **Completed step:** `◇` (green); summary displayed on separate `│  ` line below
+- **Select menus:** Sliding window (5 visible at a time), `↑`/`↓` scroll indicators, `↑↓ move, enter select` hint
+- **Multi-select:** `●` selected, `○` unselected, space to toggle, enter to confirm; custom "Other" option via text input
 
 ## Non-Goals
 
@@ -72,46 +79,52 @@ Empower developers to start projects with production-ready documentation and arc
 - Database schema generation
 - Frontend component scaffolding
 - Package template marketplace
+- `--quick` or `--update` CLI flags (wizard is always interactive)
+- Partial regeneration of individual files
 
 ## Tech Stack
 
 | Component | Technology | Purpose |
 |-----------|-----------|---------|
 | **Runtime** | Node.js + TypeScript | Type-safe CLI |
-| **UI** | Ink + React | Interactive CLI rendering |
+| **UI** | Ink 6 + React 19 | Interactive terminal rendering |
 | **Templating** | Handlebars | Dynamic file generation |
-| **AI** | ai-sdk + OpenAI | Future: GPT-assisted prompts (optional) |
-| **Build** | tsc | Minimal, fast compilation |
+| **AI** | Vercel AI SDK 6, Z.ai, OpenAI | Optional AI-assisted generation |
+| **Build** | tsc | Fast compilation, strict mode |
 
 ## 7 Wizard Steps (Detailed)
 
 ### Step 1: Project Info
-- Inputs: Project name, description, package manager preference, license
-- Output: Basic project metadata
+- Inputs: Project name (required), description (required), package manager (select), license (select)
+- Outputs: Project metadata used across all generated files
 
 ### Step 2: Stack & Style
-- Inputs: Language, framework, code style (strict mode, imports, naming, error handling)
-- Output: Stack summary and style guide anchors
+- Inputs: QuickStart preset selection, or manual language + framework + code-style multi-selects
+- Outputs: Stack and style data; presets also pre-fill Step 3 commands
 
 ### Step 3: Build & Test
-- Inputs: Build, test, typecheck, lint, PR check commands
-- Output: Development commands for CLAUDE.md
+- Inputs: Build, test, typecheck, lint, pre-PR commands (pre-filled if preset chosen)
+- Outputs: Development commands section in CLAUDE.md
 
 ### Step 4: Architecture
-- Inputs: Architecture pattern, architectural decisions, detailed notes
-- Output: Architecture section for CLAUDE.md
+- Inputs: Architecture pattern selection (7 options)
+- Outputs: Architecture section in CLAUDE.md with auto-generated best-practice notes
 
 ### Step 5: Product Context
-- Inputs: Problem statement (5 bullets), target users table, core features, non-goals, tech stack, user stories
-- Output: PRD.md and USER-STORIES.md data
+- Inputs: Problem statement, target users, tech stack (multi-select, prefilled from Step 2), core features (multi-select + custom), non-goals
+- Outputs: Data for PRD.md and USER-STORIES.md
 
 ### Step 6: Generation
-- Automatic: Compile answers into CLAUDE.md, PRD.md, USER-STORIES.md, .env.example, .gitignore
-- Output: Files written to project directory with timestamps
+- Shows full summary of all collected inputs grouped by section
+- Warns about any existing files that will be overwritten
+- Confirm → writes all files; Skip → exits without writing
+- Outputs: CLAUDE.md, README.md, docs/PRD.md, docs/USER-STORIES.md, .env.example, .gitignore
 
-### Step 7: Powerline (Optional)
-- Inputs: Enable powerline, font selection, theme colors
-- Output: Shell configuration and setup instructions
+### Step 7: Setup (Optional)
+- Three sequential yes/no prompts (Powerline, Git, Release scripts)
+- Each explained in detail before asking
+- All three can be independently enabled or skipped
+- Outputs: `.claude/` powerline config, git repo with initial commit, `~/bin/<project>-release`, updated `package.json`
 
 ## Success Metrics
 
@@ -123,8 +136,6 @@ Empower developers to start projects with production-ready documentation and arc
 
 ## Open Questions
 
-- Should we support multiple AI models (Claude, GPT-4, local LLMs)?
-- Auto-generate user stories from feature descriptions?
+- Should we support multiple AI models (Claude, GPT-4, local LLMs) for assisted generation?
 - Integration with GitHub Actions for CI/CD template generation?
 - Support for monorepo scaffolding (workspaces)?
-- Interactive feature validation via AI (e.g., "Validate that F-001 and F-002 don't overlap")?

package/docs/USER-STORIES.md

@@ -10,70 +10,133 @@
 
 ```gherkin
 Scenario: User completes full 7-step wizard
-  Given a developer runs `npx procedure-cli`
+  Given a developer runs `npx @b3awesome/procedure` in an empty directory
   When they answer all wizard questions (project info, stack, build, architecture, product context)
-  Then CLAUDE.md, PRD.md, USER-STORIES.md, .env.example, and .gitignore are created
-  And a success message displays with project name and generated files
+  And confirm generation in Step 6
+  Then CLAUDE.md, README.md, PRD.md, USER-STORIES.md, .env.example, and .gitignore are created
+  And a success message displays with the project name and generated files listed
+  And pressing Enter exits the CLI
 ```
 
 ```gherkin
 Scenario: Wizard validates required inputs
   Given the user is on Step 1 (Project Info)
-  When they leave the project name empty and try to continue
-  Then validation error shows and they must re-enter
-  And "Next" button remains disabled until valid
+  When they leave the project name empty and press Enter
+  Then a validation error shows inline
+  And the wizard does not advance until a valid name is entered
 ```
 
-## US-002: Quick Start Mode
+```gherkin
+Scenario: User skips generation
+  Given the user reaches Step 6 (Generation)
+  When they press N at the "Proceed?" prompt
+  Then no files are written to disk
+  And the final summary states "Generation was skipped — no files were written"
+```
+
+## US-002: Empty Directory Guard
+
+**As a** developer protecting an existing project
+**I want** the CLI to refuse to run in a non-empty directory
+**So that** I don't accidentally overwrite my existing files
 
-**As a** developer in a hurry
-**I want** to scaffold a project with minimal questions
-**So that** I can start coding in under 2 minutes
+### Feature: Pre-flight Directory Check
 
-### Feature: QuickStart Shortcuts
+```gherkin
+Scenario: CLI warns when directory has existing files and continues
+  Given a developer runs `npx @b3awesome/procedure` in a directory with files
+  When the CLI starts
+  Then a warning is printed listing up to 3 found files/directories
+  And a recommendation to use an empty directory is shown
+  And the wizard renders normally so the user can proceed
+  And Step 6 (Generation) will list any files that would be overwritten before confirmation
+```
 
 ```gherkin
-Scenario: Quick mode with sensible defaults
-  Given the developer runs `npx procedure-cli --quick`
-  When they provide only project name and description
-  Then defaults are used for tech stack, build commands, architecture
-  And files are generated immediately
+Scenario: CLI starts normally in an empty directory
+  Given a developer runs `npx @b3awesome/procedure` in an empty directory
+  When the CLI starts
+  Then the wizard renders with the banner and Step 1 active
 ```
 
-## US-003: Advanced Configuration
+## US-003: QuickStart Presets
 
-**As a** team lead defining standards
-**I want** to customize every section of the generated docs
-**So that** the output matches our team's coding standards and practices
+**As a** developer who knows their stack
+**I want** to pick a preset and have all commands pre-filled
+**So that** I can scaffold a project in under 2 minutes without typing every command
+
+### Feature: Stack & Style Presets
+
+```gherkin
+Scenario: User selects a QuickStart preset
+  Given the user is on Step 2 (Stack & Style)
+  When they navigate to "TypeScript + Node.js" and press Enter
+  Then Step 2 completes immediately with language, framework, and code style set
+  And Step 3 (Build & Test) opens with build, test, typecheck, lint, and PR commands pre-filled
+```
+
+```gherkin
+Scenario: User switches to manual configuration
+  Given the user is on Step 2 (Stack & Style) in QuickStart mode
+  When they navigate to "Configure manually →" and press Enter
+  Then they are shown the language multi-select
+  And then the framework multi-select
+  And then the code style multi-select
+  And can choose any combination with custom "Other" input
+```
+
+```gherkin
+Scenario: Preset list shows scrollable options
+  Given the user is on Step 2 (Stack & Style)
+  When the preset list renders
+  Then 5 presets are visible at a time
+  And "↓ more" appears when additional options are below the visible window
+  And pressing ↓ scrolls the window to reveal more presets
+```
+
+## US-004: Advanced Manual Configuration
+
+**As a** team lead defining custom standards
+**I want** to configure language, framework, and code style manually
+**So that** the output matches our team's exact conventions
 
 ### Feature: Detailed Customization
 
 ```gherkin
-Scenario: Full control over architecture and style
-  Given the user is on Step 4 (Architecture)
-  When they describe architecture decisions and code style details
-  Then CLAUDE.md includes the exact text in the Architecture and Code Style sections
-  And next steps reference these decisions
+Scenario: Full control over stack and style
+  Given the user selects "Configure manually →" in Step 2
+  When they choose multiple languages (e.g. TypeScript + Python)
+  And choose multiple frameworks (e.g. Next.js + FastAPI)
+  And select code style conventions with a custom "Other" rule
+  Then CLAUDE.md includes the exact languages, frameworks, and conventions chosen
 ```
 
-## US-004: Powerline Setup Integration
+## US-005: Generation Review and Confirmation
 
-**As a** shell enthusiast
-**I want** to configure powerline font and prompt styling during setup
-**So that** my terminal matches my project's branding
+**As a** developer reviewing before committing
+**I want** to see a full summary of all my inputs before files are written
+**So that** I can catch mistakes without having to edit generated files
 
-### Feature: Shell Prompt Customization
+### Feature: Generation Summary Screen
 
 ```gherkin
-Scenario: User enables powerline during Step 7
-  Given the wizard is on Step 7 (Powerline)
-  When they select "Yes, set up powerline"
-  Then they choose fonts (Noto Sans Mono, Fira Code, custom)
-  And pick a theme color (blue, green, purple)
-  And setup instructions are displayed
+Scenario: Generation step shows all collected inputs
+  Given the user reaches Step 6 (Generation)
+  When the summary renders
+  Then it shows Project Info, Stack & Style, Build & Test, Architecture, and Product Context
+  And it lists all 6 files that will be generated
+  And it warns "⚠ Will overwrite: <filename>" for any files that already exist
 ```
 
-## US-005: PRD Generation with Features
+```gherkin
+Scenario: Overwrite warning shown for existing files
+  Given the target directory already contains CLAUDE.md
+  When the user reaches Step 6 (Generation)
+  Then a peach-colored warning lists CLAUDE.md as a file that will be overwritten
+  And the user must confirm before any writing occurs
+```
+
+## US-006: PRD Generation with Full Context
 
 **As a** product manager
 **I want** the PRD to capture vision, problem, users, and core features
@@ -84,19 +147,12 @@ Scenario: User enables powerline during Step 7
 ```gherkin
 Scenario: PRD includes all required sections
   Given the user completes Step 5 (Product Context)
-  When they provide vision, problem statement, user table, and core features
-  Then PRD.md contains:
-    | Section | Content |
-    | Vision | User's description |
-    | Problem | 5 bullet points |
-    | Users | Table with roles and value |
-    | Core Features | F-001 through F-006 format |
-    | Non-Goals | Explicit out-of-scope items |
-    | Tech Stack | Table with technologies |
-    | Success Metrics | Measurable outcomes |
+  When they provide problem statement, user context, core features, and non-goals
+  Then PRD.md contains Vision, Problem, Users, Core Features, Non-Goals, Tech Stack, and Success Metrics
+  And core features are formatted as F-001 through F-NNN entries
 ```
 
-## US-006: User Stories with Gherkin Format
+## US-007: User Stories with Gherkin Format
 
 **As a** QA engineer
 **I want** user stories with Gherkin acceptance criteria
@@ -105,77 +161,164 @@ Scenario: PRD includes all required sections
 ### Feature: Structured User Stories
 
 ```gherkin
-Scenario: User stories include Given/When/Then
+Scenario: USER-STORIES.md includes Gherkin scenarios
   Given the user provides core features in Step 5
   When files are generated in Step 6
-  Then USER-STORIES.md contains:
-    - US-001 through US-009 headers
-    - "As a / I want / So that" format
-    - Feature: [name] sections
-    - Multiple Scenario: blocks with Gherkin syntax
+  Then USER-STORIES.md contains US-NNN headers with "As a / I want / So that" format
+  And each story includes one or more Scenario blocks with Given/When/Then syntax
 ```
 
-## US-007: Git Initialization
+## US-008: Visual Timeline Progress
+
+**As a** new user
+**I want** to see a visual timeline of all steps with clear current-step indication
+**So that** I always know where I am and what's left
 
-**As a** developer starting fresh
-**I want** the wizard to optionally initialize git with a sensible .gitignore
-**So that** I don't accidentally commit build artifacts or secrets
+### Feature: Timeline Progress Indicator
 
-### Feature: Git Setup
+```gherkin
+Scenario: Timeline shows completed, active, and pending steps
+  Given the user is on Step 3 (Build & Test)
+  When they view the terminal
+  Then the timeline shows:
+    - ◇ Project Info (green, completed, with summary below)
+    - ◇ Stack & Style (green, completed, with summary below)
+    - ◆ Build & Test (mauve animated dot, active)
+    - ○ Architecture (dim, pending)
+    - ○ Product Context (dim, pending)
+    - ○ Generation (dim, pending)
+    - ○ Setup (dim, pending)
+  And ┌ appears before step 1 and └ appears after step 7
+```
 
 ```gherkin
-Scenario: Git repo is initialized with language-specific ignores
-  Given the user completes the wizard
-  When they select "Initialize git repo" (optional prompt)
-  Then `git init` runs automatically
-  And .gitignore is committed with language/framework rules
-  And initial commit message is "chore: initialize project with Procedure CLI"
+Scenario: Completed step summary appears below step name
+  Given the user completes Step 1 (Project Info)
+  When the timeline advances to Step 2
+  Then below "Project Info" on a separate │ line, the summary shows the entered name and description
 ```
 
-## US-008: Partial Scaffolding & Regeneration
+## US-009: Optional Tooling Setup
 
-**As a** developer iterating on docs
-**I want** to re-run the wizard and update only certain files
-**So that** I can refine PRD and user stories without re-answering all questions
+**As a** developer setting up a new project
+**I want** to optionally initialize git, configure Claude Powerline, and add release scripts
+**So that** my project has proper version control and publish tooling from day one
 
-### Feature: Selective Regeneration
+### Feature: Setup Step
 
 ```gherkin
-Scenario: User reruns wizard to update PRD only
-  Given a project was scaffolded previously
-  When they run `npx procedure-cli --update prd`
-  Then only Step 5 (Product Context) runs
-  And PRD.md and USER-STORIES.md are regenerated
-  And CLAUDE.md remains unchanged
+Scenario: User enables all three setup options
+  Given the wizard is on Step 7 (Setup)
+  When the user answers Yes to Powerline, Yes to Git, and Yes to release scripts
+  Then .claude/ powerline configuration is created
+  And git init runs and an initial commit is made with the generated files
+  And ~/bin/<project>-release is created with the correct package manager commands
+  And package.json is created (or updated) with release:patch, release:minor, and release:major scripts
 ```
 
-## US-009: Visual Timeline with Estimated Completion
+```gherkin
+Scenario: Each setup option is explained before asking
+  Given the wizard is on Step 7 (Setup)
+  When the Powerline question renders
+  Then an explanation is shown describing what Powerline does before the yes/no prompt
+  And the same applies to the Git and release script questions
+```
 
-**As a** new user
-**I want** to see a visual timeline of remaining steps with time estimate
-**So that** I know how long the setup will take
+```gherkin
+Scenario: Git init is skipped gracefully when nothing to commit
+  Given the user enables Git setup
+  When git init runs but there are no files to commit (generation was skipped)
+  Then a warning message is shown explaining why the commit was skipped
+  And the setup step completes without error
+```
 
-### Feature: Timeline Progress Indicator
+```gherkin
+Scenario: Release script skipped when it already exists
+  Given ~/bin/<project>-release already exists
+  When the user enables release script setup
+  Then a message confirms the existing script was skipped
+  And package.json release scripts are still applied if not already present
+```
+
+## US-010: In-Step Field Navigation
+
+**As a** developer who made a typo in a previous field
+**I want** to navigate back and forward between inputs within the current step
+**So that** I can fix mistakes without restarting the step from scratch
+
+### Feature: ↑/↓ Field Navigation
+
+```gherkin
+Scenario: User navigates back to a previous field within a step
+  Given the user is on Step 3 (Build & Test) with "Test command" active
+  When they press Shift+Tab
+  Then "Build command" becomes active again with its previously saved value restored
+  And "Test command" becomes invisible (not yet re-confirmed)
+```
+
+```gherkin
+Scenario: User navigates forward using Tab
+  Given the user has gone back to "Build command" in Step 3
+  When they press Tab
+  Then the current value (typed or previously saved) is kept
+  And "Test command" becomes active again
+```
+
+```gherkin
+Scenario: Tab on a required empty field shows error
+  Given the user is on "Build command" in Step 3
+  And the field is empty with no saved value
+  When they press Tab
+  Then a validation error is shown
+  And the field index does not advance
+```
+
+```gherkin
+Scenario: Navigation hint is shown below each input field
+  Given the user is on any input field within a step
+  When the field renders
+  Then a hint line shows the available navigation keys
+  And "Shift+Tab prev" is omitted when on the first field
+  And "Tab next" is replaced by "Tab / Enter confirm" on the last field
+```
+
+```gherkin
+Scenario: Tab and Shift+Tab work on select fields too
+  Given the user is on "Package manager" select (Step 1)
+  When they press Shift+Tab
+  Then the "Description" text input becomes active again
+  When they press Tab
+  Then the "License" select becomes active
+  And ↑↓ continue to navigate options within the select as normal
+```
+
+```gherkin
+Scenario: Shift+Tab in Setup step navigates between confirm questions
+  Given the user is on the "Initialize git repo?" question in Step 7
+  When they press Shift+Tab
+  Then the "Set up Powerline?" question is shown again
+  And the user can re-answer it
+```
+
+## US-011: Escape and Graceful Exit
+
+**As a** developer who changed their mind
+**I want** to exit the wizard at any point
+**So that** I don't have to complete all steps or kill the process manually
+
+### Feature: ESC to Exit
 
 ```gherkin
-Scenario: Timeline shows current step and estimated completion
-  Given the user is on Step 3 of 7
-  When they view the sidebar
-  Then they see:
-    - ✔ Step 1: Project Info (completed)
-    - ✔ Step 2: Stack & Style (completed)
-    - ► Step 3: Build & Test (active)
-    - ○ Step 4: Architecture (pending)
-    - ○ Step 5: Product Context (pending)
-    - ○ Step 6: Generation (pending)
-    - ○ Step 7: Powerline (pending)
-  And "Est. time remaining: 8 minutes" is displayed
+Scenario: ESC exits the wizard at any step
+  Given the user is anywhere in the 7-step wizard
+  When they press Escape
+  Then the CLI exits cleanly with no files written
 ```
 
 ```gherkin
-Scenario: Step completion summary is shown in timeline
-  Given the user completes Step 1
-  When they move to Step 2
-  Then the timeline shows "Project Info — my-project — my description"
-  And a checkmark indicates completion
+Scenario: Enter exits after completion
+  Given the wizard has completed all 7 steps
+  When the final success screen is shown
+  Then pressing Enter exits the CLI
+  And the final timeline shows all steps as completed with their summaries
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "procedure-cli",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "CLI-based AI Agent powered by AI SDK 6, Z.ai, and OpenAI",
   "type": "module",
   "bin": {

package/src/cli.tsx

@@ -1,6 +1,19 @@
 #!/usr/bin/env node
 import React from "react";
 import { render } from "ink";
+import { readdirSync } from "node:fs";
 import App from "./app.js";
 
+const entries = readdirSync(process.cwd()).filter((e) => e !== ".DS_Store");
+if (entries.length > 0) {
+  const sample = entries.slice(0, 3).join(", ");
+  const extra = entries.length > 3 ? `, +${entries.length - 3} more` : "";
+  console.error(`\nWarning: current directory is not empty.`);
+  console.error(`  Found: ${sample}${extra}`);
+  console.error(`  Existing files can be overwritten during Step 6 (Generation).`);
+  console.error(`  Recommended for a fresh project:`);
+  console.error(`    mkdir my-project && cd my-project`);
+  console.error(`    npx procedure-cli   (or: npx @b3awesome/procedure)\n`);
+}
+
 render(<App />);