ctxflow 1.0.0 → 1.0.1

package/README.md

@@ -0,0 +1,172 @@
+```
+ ██████╗████████╗██╗  ██╗███████╗██╗      ██████╗ ██╗    ██╗
+██╔════╝╚══██╔══╝╚██╗██╔╝██╔════╝██║     ██╔═══██╗██║    ██║
+██║        ██║    ╚███╔╝ █████╗  ██║     ██║   ██║██║ █╗ ██║
+██║        ██║    ██╔██╗ ██╔══╝  ██║     ██║   ██║██║███╗██║
+╚██████╗   ██║   ██╔╝ ██╗██║     ███████╗╚██████╔╝╚███╔███╔╝
+ ╚═════╝   ╚═╝   ╚═╝  ╚═╝╚═╝     ╚══════╝ ╚═════╝  ╚══╝╚══╝
+```
+
+<p align="center">
+  <strong>Context scaffolding for AI agent-driven development.</strong><br/>
+  <sub>Give your AI the context it needs — before it starts guessing.</sub>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/npm/v/ctxflow?color=a855f7&label=npm" alt="npm version"/>
+  <img src="https://img.shields.io/node/v/ctxflow?color=06b6d4&label=node" alt="node version"/>
+  <img src="https://img.shields.io/npm/l/ctxflow?color=a855f7" alt="license"/>
+  <img src="https://img.shields.io/npm/dm/ctxflow?color=06b6d4" alt="downloads"/>
+</p>
+
+---
+
+## The problem
+
+You open your AI coding assistant and ask it to implement a feature.
+It starts writing code — but it doesn't know your stack, your constraints, your architecture decisions, or what's already been agreed upon.
+
+So it guesses. And you spend the next hour correcting it.
+
+**ctxflow fixes this.**
+
+It scaffolds structured context files your AI can read before touching a single line of code: requirements, task plans, architectural decisions, and project-wide rules — all in plain Markdown, all version-controlled alongside your code.
+
+---
+
+## Install
+
+```bash
+npm install -g ctxflow
+```
+
+---
+
+## Quick start
+
+```bash
+# 1. Initialise your project (once)
+ctxflow init
+
+# 2. Create a feature context before you start coding
+ctxflow new user-authentication
+
+# 3. Fill in requirements.md — your AI reads this first
+# 4. Check progress at any time
+ctxflow status user-authentication
+```
+
+Or just run `ctxflow` for the full interactive menu.
+
+---
+
+## What gets created
+
+### `ctxflow init`
+
+```
+CLAUDE.md               ← AI instructions: stack, architecture, approvals, rules
+```
+
+**CLAUDE.md** is the single source of truth your AI assistant reads on every session.
+It contains your stack, architecture overview, approved libraries, and non-negotiable rules.
+
+### `ctxflow new <feature>`
+
+```
+docs/features/<feature>/
+  requirements.md       ← Why this feature exists, constraints, acceptance criteria
+  plan.md               ← Tasks (checkboxes), file structure, open questions
+```
+
+---
+
+## Interactive menu
+
+Run `ctxflow` with no arguments for a full interactive experience:
+
+```
+  What would you like to do?
+
+  [1]  New feature      — scaffold a new feature context
+  [2]  Init project     — create CLAUDE.md + /docs structure
+  [3]  List features    — show all existing plans
+  [4]  Status           — check tasks in a feature plan
+  [5]  Help             — show usage and documentation
+
+  Ctrl+C to exit
+```
+
+Press a number key to execute instantly — no Enter needed.
+
+---
+
+## CLI reference
+
+| Command | Description |
+|--------|-------------|
+| `ctxflow` | Launch interactive menu |
+| `ctxflow init` | Scaffold `CLAUDE.md` + `docs/` in the current directory |
+| `ctxflow new <feature>` | Create a feature context under `docs/features/<feature>/` |
+| `ctxflow list` | List all feature contexts with creation dates |
+| `ctxflow status <feature>` | Show task completion progress for a feature |
+
+---
+
+## The workflow
+
+```
+1. ctxflow init          →  Write CLAUDE.md once. Define your stack, rules, boundaries.
+2. ctxflow new <feature> →  Before every feature: scaffold requirements + plan.
+3. Fill requirements.md  →  Context, constraints, acceptance criteria. Your AI reads this.
+4. Code the feature      →  AI works with full context. No guessing.
+5. Check tasks off       →  Mark [ ] → [x] in plan.md as you go.
+6. ctxflow status        →  See exactly where you are at any time.
+```
+
+---
+
+## Why this works
+
+AI coding assistants are only as useful as the context they receive. Without structured context:
+
+| Without ctxflow | With ctxflow |
+|----------------|--------------|
+| Agent guesses at your stack | Agent reads your exact stack from `CLAUDE.md` |
+| Unapproved libraries sneak in | `CLAUDE.md` lists exactly what's approved |
+| Requirements drift mid-feature | `requirements.md` is the single source of truth |
+| Agent asks you the same questions every session | Context is version-controlled and always available |
+
+---
+
+## Works with any AI assistant
+
+ctxflow is **assistant-agnostic**. The generated files are plain Markdown that any AI can read:
+
+- **Claude** (reads `CLAUDE.md` natively)
+- **GitHub Copilot**
+- **Cursor**
+- **Windsurf**
+- **Codeium**
+- Any tool that supports reading project files
+
+---
+
+## Works with any language or framework
+
+ctxflow generates language-agnostic context files.
+Whether you're building in Java, Python, Go, Rust, TypeScript, or Ruby —
+fill in your stack, and your AI gets the right context.
+
+---
+
+## Requirements
+
+- Node.js 18+
+- Works on macOS, Linux, Windows
+
+---
+
+## License
+
+MIT © ctxflow contributors

package/bin/ctxflow.js

@@ -1,2 +1,5 @@
 #!/usr/bin/env node
-console.log("ctxflow v0.1.0");
+import('../dist/index.js').catch(err => {
+  console.error('Error:', err.message);
+  process.exit(1);
+});

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function initCommand(cwd?: string): Promise<boolean>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAqCA,wBAAsB,WAAW,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAsBvE"}

package/dist/commands/init.js

@@ -0,0 +1,61 @@
+import { join } from 'path';
+import chalk from 'chalk';
+import { readTemplate, renderTemplate, writeFile, pathExists } from '../utils/fs.js';
+import { logger } from '../utils/logger.js';
+const TODAY = new Date().toISOString().split('T')[0];
+async function confirmOverwrite() {
+    return new Promise((resolve) => {
+        const stdin = process.stdin;
+        process.stdout.write(`  ${chalk.yellow('CLAUDE.md already exists.')} ${chalk.white('Overwrite?')}` +
+            chalk.gray('  Enter = yes  /  Esc = no  '));
+        if (!stdin.isTTY) {
+            stdin.once('data', (c) => resolve(c.toString().trim().toLowerCase() === 'y'));
+            return;
+        }
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.once('data', (chunk) => {
+            stdin.setRawMode(false);
+            stdin.pause();
+            const key = chunk.toString();
+            process.stdout.write('\n');
+            if (key === '\x03')
+                process.exit(0); // Ctrl+C → exit
+            if (key === '\x1b') {
+                resolve(false);
+                return;
+            } // Esc → no
+            if (key === '\r' || key === '\n') {
+                resolve(true);
+                return;
+            } // Enter → yes
+            if (key.toLowerCase() === 'y') {
+                resolve(true);
+                return;
+            }
+            resolve(false); // anything else → no
+        });
+    });
+}
+// Returns true = completed, false = aborted (Esc / no)
+export async function initCommand(cwd = process.cwd()) {
+    const claudePath = join(cwd, 'CLAUDE.md');
+    if (await pathExists(claudePath)) {
+        const yes = await confirmOverwrite();
+        if (!yes) {
+            console.log('');
+            logger.warn('Aborted — nothing changed.');
+            return false;
+        }
+    }
+    const vars = { date: TODAY };
+    const claudeTpl = await readTemplate('CLAUDE.md.hbs');
+    await writeFile(claudePath, renderTemplate(claudeTpl, vars));
+    logger.success('Project initialised!');
+    logger.blank();
+    logger.file('CLAUDE.md');
+    logger.blank();
+    logger.info('Edit CLAUDE.md to fill in your stack, architecture, and approvals.');
+    return true;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/commands/list.d.ts

@@ -0,0 +1,2 @@
+export declare function listCommand(cwd?: string): Promise<void>;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAKA,wBAAsB,WAAW,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCpE"}

package/dist/commands/list.js

@@ -0,0 +1,32 @@
+import { join } from 'path';
+import chalk from 'chalk';
+import { readDir, statFile, pathExists } from '../utils/fs.js';
+import { logger } from '../utils/logger.js';
+export async function listCommand(cwd = process.cwd()) {
+    const plansDir = join(cwd, 'docs', 'features');
+    if (!(await pathExists(plansDir))) {
+        logger.warn('No docs/features directory found. Run `ctxflow init` first.');
+        return;
+    }
+    const features = await readDir(plansDir);
+    if (features.length === 0) {
+        logger.info('No features yet. Run `ctxflow new <feature>` to create one.');
+        return;
+    }
+    const rows = await Promise.all(features.map(async (name) => {
+        const stat = await statFile(join(plansDir, name, 'plan.md'));
+        const created = stat ? stat.birthtime.toISOString().split('T')[0] : '—';
+        return { name, created };
+    }));
+    console.log('');
+    console.log(chalk.magenta('  Feature').padEnd(36) +
+        chalk.magenta('Created'));
+    console.log('  ' + chalk.gray('─'.repeat(46)));
+    for (const row of rows) {
+        console.log(chalk.cyan('  ' + row.name).padEnd(38) +
+            chalk.gray(row.created));
+    }
+    console.log('');
+    logger.info(`${rows.length} feature${rows.length === 1 ? '' : 's'} found.`);
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAE/C,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QAC3E,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEzC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QAC3E,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAC5B,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACxE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CACzB,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAE/C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CACxB,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,WAAW,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;AAC9E,CAAC"}

package/dist/commands/new.d.ts

@@ -0,0 +1,2 @@
+export declare function newCommand(featureName: string, cwd?: string): Promise<void>;
+//# sourceMappingURL=new.d.ts.map

package/dist/commands/new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"AAUA,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,SAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCxF"}

package/dist/commands/new.js

@@ -0,0 +1,36 @@
+import { join } from 'path';
+import { readTemplate, renderTemplate, writeFile, pathExists } from '../utils/fs.js';
+import { logger } from '../utils/logger.js';
+const TODAY = new Date().toISOString().split('T')[0];
+function slugify(name) {
+    return name.trim().toLowerCase().replace(/\s+/g, '-').replace(/[^a-z0-9-]/g, '');
+}
+export async function newCommand(featureName, cwd = process.cwd()) {
+    const slug = slugify(featureName);
+    if (!slug) {
+        logger.error('Invalid feature name.');
+        return;
+    }
+    const dir = join(cwd, 'docs', 'features', slug);
+    if (await pathExists(dir)) {
+        logger.warn(`Feature "${slug}" already exists at docs/features/${slug}`);
+        logger.info('Edit the existing files or choose a different name.');
+        return;
+    }
+    const vars = { feature: featureName.trim(), date: TODAY };
+    const [reqTpl, planTpl] = await Promise.all([
+        readTemplate('requirements.md.hbs'),
+        readTemplate('plan.md.hbs'),
+    ]);
+    await Promise.all([
+        writeFile(join(dir, 'requirements.md'), renderTemplate(reqTpl, vars)),
+        writeFile(join(dir, 'plan.md'), renderTemplate(planTpl, vars)),
+    ]);
+    logger.success(`Feature "${featureName.trim()}" created!`);
+    logger.blank();
+    logger.file(`docs/features/${slug}/requirements.md`);
+    logger.file(`docs/features/${slug}/plan.md`);
+    logger.blank();
+    logger.info('Start by filling in requirements.md before writing any code.');
+}
+//# sourceMappingURL=new.js.map

package/dist/commands/new.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new.js","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAErD,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,WAAmB,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACvE,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACtC,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IAEhD,IAAI,MAAM,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,qCAAqC,IAAI,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;QACnE,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAE1D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1C,YAAY,CAAC,qBAAqB,CAAC;QACnC,YAAY,CAAC,aAAa,CAAC;KAC5B,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,EAAE,cAAc,CAAC,MAAM,EAAG,IAAI,CAAC,CAAC;QACtE,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,EAAU,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;KACvE,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,YAAY,WAAW,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC3D,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,kBAAkB,CAAC,CAAC;IACrD,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,UAAU,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,MAAM,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;AAC9E,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,2 @@
+export declare function statusCommand(featureName: string, cwd?: string): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAoBA,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,SAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC3F"}

package/dist/commands/status.js

@@ -0,0 +1,46 @@
+import { join } from 'path';
+import chalk from 'chalk';
+import { pathExists, readFileContent } from '../utils/fs.js';
+import { logger } from '../utils/logger.js';
+function parseTasks(content) {
+    const tasks = [];
+    const pattern = /^- \[([xX ])\] (.+)$/gm;
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+        tasks.push({ done: match[1].toLowerCase() === 'x', text: match[2] });
+    }
+    return tasks;
+}
+export async function statusCommand(featureName, cwd = process.cwd()) {
+    const planPath = join(cwd, 'docs', 'features', featureName, 'plan.md');
+    if (!(await pathExists(planPath))) {
+        logger.error(`Feature "${featureName}" not found at docs/features/${featureName}/plan.md`);
+        return;
+    }
+    const content = await readFileContent(planPath);
+    const tasks = parseTasks(content);
+    if (tasks.length === 0) {
+        logger.warn('No tasks found in plan.md (no `- [ ]` or `- [x]` lines).');
+        return;
+    }
+    const done = tasks.filter(t => t.done).length;
+    const total = tasks.length;
+    const percent = Math.round((done / total) * 100);
+    const bar = buildBar(done, total);
+    console.log('');
+    console.log(chalk.cyan(`  ${featureName}`));
+    console.log(`  ${bar}  ${chalk.white(`${done}/${total}`)} ${chalk.gray(`(${percent}%)`)}`);
+    console.log('');
+    for (const task of tasks) {
+        const icon = task.done ? chalk.green('✅') : chalk.gray('⬜');
+        const label = task.done ? chalk.gray(task.text) : chalk.white(task.text);
+        console.log(`  ${icon}  ${label}`);
+    }
+    console.log('');
+}
+function buildBar(done, total, width = 20) {
+    const filled = Math.round((done / total) * width);
+    const empty = width - filled;
+    return chalk.cyan('█'.repeat(filled)) + chalk.gray('░'.repeat(empty));
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,71 @@
+import { Command, CommanderError } from 'commander';
+import { showBanner } from './ui/banner.js';
+import { showMenu, showHelp } from './ui/menu.js';
+import { initCommand } from './commands/init.js';
+import { newCommand } from './commands/new.js';
+import { listCommand } from './commands/list.js';
+import { statusCommand } from './commands/status.js';
+import { logger } from './utils/logger.js';
+const program = new Command();
+program
+    .name('ctxflow')
+    .description('Context scaffolding for AI agent-driven development')
+    .version('1.0.0')
+    .exitOverride()
+    .configureOutput({ outputError: () => { } }); // suppress commander's raw error lines
+program
+    .command('init')
+    .description('Create CLAUDE.md and docs/ structure in the current project')
+    .action(async () => {
+    showBanner();
+    await initCommand();
+});
+program
+    .command('new <feature>')
+    .description('Scaffold docs/plans/<feature>/ with requirements, plan, and decisions files')
+    .action(async (feature) => {
+    showBanner();
+    await newCommand(feature);
+});
+program
+    .command('list')
+    .description('List all feature plans in docs/plans/')
+    .action(async () => {
+    showBanner();
+    await listCommand();
+});
+program
+    .command('status <feature>')
+    .description('Show task completion status for a feature plan')
+    .action(async (feature) => {
+    showBanner();
+    await statusCommand(feature);
+});
+// Unknown command (no dash) → show help
+program.on('command:*', () => {
+    showBanner();
+    showHelp();
+    process.exit(1);
+});
+if (process.argv.length <= 2) {
+    showMenu().catch((err) => {
+        logger.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    });
+}
+else {
+    program.parseAsync(process.argv).catch((err) => {
+        if (err instanceof CommanderError) {
+            // --version / --help already printed their output cleanly
+            if (err.exitCode === 0)
+                process.exit(0);
+            // Unknown option (dashes) → show help
+            showBanner();
+            showHelp();
+            process.exit(1);
+        }
+        logger.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/templates/CLAUDE.md.hbs

@@ -0,0 +1,47 @@
+# CLAUDE.md
+
+> This file is read by AI coding assistants (Claude, Copilot, etc.) to understand the project context. Keep it accurate and up to date.
+
+## Stack
+
+- Language:   <!-- e.g. Java 21, Python 3.12, Go 1.23, Node.js 22 -->
+- Framework:  <!-- e.g. Spring Boot, Django, Gin, Express -->
+- Testing:    <!-- e.g. JUnit 5, pytest, Go test, Vitest -->
+
+## Project structure
+
+```
+/
+├── src/           # Source code
+├── tests/         # Test files
+├── docs/
+│   └── features/  # Feature context (managed by ctxflow)
+└── CLAUDE.md      # This file
+```
+
+## Architecture
+
+<!-- Describe the high-level architecture: main components, data flow, key boundaries.
+     Update this when structure changes. -->
+
+## Approvals
+
+<!-- Authoritative list of approved dependencies. Check before adding anything new. -->
+
+| Library / Tool | Version | Purpose |
+|---------------|---------|---------|
+|               |         |         |
+
+## Rules (non-negotiable)
+
+1. Read `docs/features/<feature>/requirements.md` BEFORE implementing any feature.
+2. Write tests before marking a task as complete.
+3. Check **## Approvals** before adding any new dependency.
+4. Keep this file updated when the stack or rules change.
+
+## What NOT to do
+
+- Do NOT add libraries not in **## Approvals** without updating it first.
+- Do NOT commit to main/master directly — use feature branches and code review.
+- Do NOT skip requirements.md when starting a feature.
+- Do NOT change architecture without updating **## Architecture** in this file.

package/dist/templates/approved-libs.md.hbs

@@ -0,0 +1,34 @@
+# Approved libraries
+
+> Last updated: {{date}}
+>
+> Authoritative list of approved dependencies.
+> Before adding any library, update this file and get it reviewed.
+
+## Production dependencies
+
+| Library | Version | Purpose | Added by |
+|---------|---------|---------|---------|
+|         |         |         |          |
+
+## Development dependencies
+
+| Library | Version | Purpose | Added by |
+|---------|---------|---------|---------|
+|         |         |         |          |
+
+## Evaluation criteria
+
+Before approving a new library:
+
+1. Actively maintained? (last commit < 6 months)
+2. TypeScript support?
+3. License compatible with this project?
+4. Acceptable bundle size impact?
+5. Does an already-approved library cover this need?
+
+## Rejected libraries
+
+| Library | Reason | Alternative |
+|---------|--------|------------|
+|         |        |             |

package/dist/templates/architecture.md.hbs

@@ -0,0 +1,42 @@
+# Architecture
+
+> Last updated: {{date}}
+
+## Overview
+
+<!-- High-level description of the system: what it does, who uses it, how it's deployed -->
+
+## Components
+
+<!-- Main modules / services and their responsibilities -->
+
+### Component 1
+
+- **Purpose:**
+- **Technology:**
+- **Exposes:**
+
+## Data flow
+
+<!-- How does data move through the system? (narrative or Mermaid diagram) -->
+
+```mermaid
+graph TD
+    A[Client] --> B[API Layer]
+    B --> C[Business Logic]
+    C --> D[Database]
+```
+
+## Key decisions
+
+<!-- Link to feature decisions.md files for major choices -->
+
+- See `docs/plans/<feature>/decisions.md`
+
+## External dependencies
+
+<!-- Third-party services, APIs, or infrastructure this system relies on -->
+
+| Service | Purpose | Owner |
+|---------|---------|-------|
+|         |         |       |

package/dist/templates/decisions.md.hbs

@@ -0,0 +1,26 @@
+# Decisions log: {{feature}}
+
+> Log every significant architectural or technical decision here.
+> One entry per decision. Add to the top (newest first).
+
+---
+
+## {{date}} — [Decision title]
+
+**Context:** What problem were you solving, and what constraints existed?
+
+**Decision:** What did you decide to do?
+
+**Alternatives considered:**
+
+1. Option A — why rejected
+2. Option B — why rejected
+
+**Consequences:**
+
+- ✅ Benefit or positive consequence
+- ⚠️ Trade-off or risk to monitor
+
+---
+
+<!-- Copy the block above for each new decision -->

package/dist/templates/plan.md.hbs

@@ -0,0 +1,24 @@
+# Plan: {{feature}}
+
+> Created: {{date}}
+> Status: In progress
+
+## Tasks
+
+<!-- Add tasks specific to this feature -->
+
+- [ ]
+
+## File structure
+
+<!-- Files to create or modify for this feature -->
+
+```
+{{feature}}/
+├──
+└──
+```
+
+## Notes
+
+<!-- Open questions, blockers, or context for the AI agent -->

package/dist/templates/project-decisions.md.hbs

@@ -0,0 +1,27 @@
+# Project decisions log
+
+> Project-wide architectural and technical decisions.
+> Feature-specific decisions live in `docs/features/<feature>/decisions.md`.
+> Add entries here for cross-cutting choices that affect the whole codebase.
+
+---
+
+## {{date}} — [Decision title]
+
+**Context:** What problem were you solving, and what constraints existed?
+
+**Decision:** What did you decide to do?
+
+**Alternatives considered:**
+
+1. Option A — why rejected
+2. Option B — why rejected
+
+**Consequences:**
+
+- ✅ Benefit or positive consequence
+- ⚠️ Trade-off or risk to monitor
+
+---
+
+<!-- Copy the block above for each new project-level decision -->

package/dist/templates/requirements.md.hbs

@@ -0,0 +1,35 @@
+# Requirements: {{feature}}
+
+> Created: {{date}}
+> Status: Draft
+
+## Context
+
+<!-- Why is this feature needed? What user problem does it solve? What is the business motivation? -->
+
+## Stack
+
+<!-- Which parts of the stack does this feature touch? -->
+
+-
+-
+
+## Constraints
+
+<!-- Technical, time, or business constraints that affect implementation -->
+
+-
+-
+
+## Out of scope
+
+<!-- What is explicitly NOT part of this feature (to avoid scope creep) -->
+
+-
+-
+
+## Acceptance criteria
+
+- [ ]
+- [ ]
+- [ ]

package/dist/ui/banner.d.ts

@@ -0,0 +1,2 @@
+export declare function showBanner(): void;
+//# sourceMappingURL=banner.d.ts.map

package/dist/ui/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/ui/banner.ts"],"names":[],"mappings":"AAMA,wBAAgB,UAAU,IAAI,IAAI,CAiBjC"}

package/dist/ui/banner.js

@@ -0,0 +1,22 @@
+import figlet from 'figlet';
+import gradient from 'gradient-string';
+import chalk from 'chalk';
+const PURPLE_CYAN = ['#9B59B6', '#7C3AED', '#2563EB', '#06B6D4'];
+export function showBanner() {
+    let art;
+    try {
+        art = figlet.textSync('CTXFLOW', { font: 'ANSI Shadow' });
+    }
+    catch {
+        art = figlet.textSync('CTXFLOW', { font: 'Big' });
+    }
+    const g = gradient(PURPLE_CYAN);
+    const sep = gradient(['#9B59B6', '#06B6D4'])('─'.repeat(60));
+    console.log('');
+    console.log(g.multiline(art));
+    console.log(chalk.cyan('  Context Scaffolding for AI Agent Development'));
+    console.log(chalk.gray('  v1.0.0'));
+    console.log(`  ${sep}`);
+    console.log('');
+}
+//# sourceMappingURL=banner.js.map

package/dist/ui/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../src/ui/banner.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AACvC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAEjE,MAAM,UAAU,UAAU;IACxB,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAE7D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACxB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/ui/menu.d.ts

@@ -0,0 +1,3 @@
+export declare function showMenu(): Promise<void>;
+export declare function showHelp(): void;
+//# sourceMappingURL=menu.d.ts.map

package/dist/ui/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../src/ui/menu.ts"],"names":[],"mappings":"AAuJA,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAyB9C;AA+DD,wBAAgB,QAAQ,IAAI,IAAI,CAU/B"}

package/dist/ui/menu.js

@@ -0,0 +1,222 @@
+import chalk from 'chalk';
+import { showBanner } from './banner.js';
+import { initCommand } from '../commands/init.js';
+import { newCommand } from '../commands/new.js';
+import { listCommand } from '../commands/list.js';
+import { statusCommand } from '../commands/status.js';
+import { readDir, pathExists } from '../utils/fs.js';
+import { join } from 'path';
+const MAIN_CHOICES = [
+    { key: '1', label: 'New feature', desc: '— scaffold a new feature context', value: 'new' },
+    { key: '2', label: 'Init project', desc: '— create CLAUDE.md + /docs structure', value: 'init' },
+    { key: '3', label: 'List features', desc: '— show all existing plans', value: 'list' },
+    { key: '4', label: 'Status', desc: '— check tasks in a feature plan', value: 'status' },
+    { key: '5', label: 'Help', desc: '— show usage and documentation', value: 'help' },
+];
+// ─── raw input primitives ────────────────────────────────────────────────────
+async function pressKey() {
+    return new Promise((resolve) => {
+        const stdin = process.stdin;
+        if (!stdin.isTTY) {
+            stdin.once('data', (c) => resolve(c.toString().trim()[0] ?? ''));
+            return;
+        }
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.once('data', (chunk) => {
+            const key = chunk.toString();
+            stdin.setRawMode(false);
+            stdin.pause();
+            if (key === '\x03')
+                process.exit(0); // Ctrl+C always exits
+            resolve(key);
+        });
+    });
+}
+// Custom text input: Esc → null, Ctrl+C → exit, Enter (non-empty) → string
+async function readLine(prompt) {
+    return new Promise((resolve) => {
+        const stdin = process.stdin;
+        let buf = '';
+        process.stdout.write(prompt);
+        if (!stdin.isTTY) {
+            stdin.once('data', (c) => {
+                const t = c.toString().split('\n')[0]?.trim() ?? '';
+                resolve(t.length > 0 ? t : null);
+            });
+            return;
+        }
+        stdin.setRawMode(true);
+        stdin.resume();
+        const cleanup = () => {
+            stdin.setRawMode(false);
+            stdin.pause();
+            stdin.removeListener('data', onData);
+        };
+        const onData = (chunk) => {
+            const key = chunk.toString();
+            if (key === '\x03') { // Ctrl+C → exit
+                cleanup();
+                process.stdout.write('\n');
+                process.exit(0);
+            }
+            if (key === '\x1b') { // Esc → go back
+                cleanup();
+                process.stdout.write('\n');
+                resolve(null);
+                return;
+            }
+            if (key.startsWith('\x1b'))
+                return; // arrow keys / other sequences → ignore
+            if (key === '\r' || key === '\n') { // Enter
+                if (buf.trim().length === 0)
+                    return; // empty → do nothing
+                cleanup();
+                process.stdout.write('\n');
+                resolve(buf.trim());
+                return;
+            }
+            if (key === '\x7f' || key === '\b') { // Backspace
+                if (buf.length > 0) {
+                    buf = buf.slice(0, -1);
+                    process.stdout.write('\b \b');
+                }
+                return;
+            }
+            if (key.charCodeAt(0) >= 32) { // printable char
+                buf += key;
+                process.stdout.write(key);
+            }
+        };
+        stdin.on('data', onData);
+    });
+}
+// ─── menu rendering ──────────────────────────────────────────────────────────
+function renderChoices(message, choices, hint) {
+    console.log(chalk.cyan(`  ${message}\n`));
+    for (const c of choices) {
+        const k = chalk.magenta(`[${c.key}]`);
+        const l = chalk.white(c.label.padEnd(16));
+        const d = chalk.gray(c.desc);
+        console.log(`  ${k}  ${l}${d}`);
+    }
+    if (hint)
+        console.log(`\n  ${chalk.gray(hint)}`);
+    console.log('');
+}
+async function pickFromList(message, choices, opts = {}) {
+    const valid = new Set(choices.map(c => c.key));
+    renderChoices(message, choices, opts.hint);
+    while (true) {
+        const key = await pressKey();
+        if (key === '\x1b') {
+            if (opts.escBack) {
+                console.log('');
+                return null;
+            }
+            continue; // main menu: ignore Esc
+        }
+        if (!valid.has(key))
+            continue;
+        const choice = choices.find(c => c.key === key);
+        console.log(chalk.gray(`  ${choice.label}`));
+        console.log('');
+        return choice.value;
+    }
+}
+// ─── public menu loop ────────────────────────────────────────────────────────
+async function pressAnyKey() {
+    console.log(chalk.gray('\n  Press any key to return to menu...'));
+    await pressKey();
+}
+export async function showMenu() {
+    let needsWait = false;
+    while (true) {
+        if (needsWait)
+            await pressAnyKey();
+        showBanner();
+        const action = await pickFromList('What would you like to do?', MAIN_CHOICES, { hint: 'Ctrl+C to exit' });
+        if (action === null) {
+            needsWait = false;
+            continue;
+        }
+        console.log('');
+        let result = 'done';
+        switch (action) {
+            case 'new':
+                result = await handleNew();
+                break;
+            case 'init':
+                result = await handleInit();
+                break;
+            case 'list':
+                await listCommand();
+                break;
+            case 'status':
+                result = await handleStatus();
+                break;
+            case 'help':
+                showHelp();
+                break;
+        }
+        needsWait = result === 'done';
+    }
+}
+// ─── sub-flows ───────────────────────────────────────────────────────────────
+async function handleNew() {
+    const name = await readLine(`  ${chalk.cyan('?')} ${chalk.white('Feature name')}  ${chalk.gray('(Esc to go back)')}  `);
+    if (name === null)
+        return 'back'; // Esc → skip wait, re-render immediately
+    console.log('');
+    await newCommand(name);
+    return 'done';
+}
+async function handleInit() {
+    const completed = await initCommand();
+    return completed ? 'done' : 'back';
+}
+async function handleStatus() {
+    const cwd = process.cwd();
+    const claudePath = join(cwd, 'CLAUDE.md');
+    const featuresDir = join(cwd, 'docs', 'features');
+    if (!(await pathExists(claudePath))) {
+        console.log(chalk.yellow('  ⚠ ctxflow not initialised here. Run `ctxflow init` first.'));
+        return 'done';
+    }
+    const features = await readDir(featuresDir);
+    if (features.length === 0) {
+        console.log(chalk.green('  ✓ ctxflow is active.') + chalk.gray('  No features added yet.'));
+        console.log(chalk.gray('    Run `ctxflow new <feature>` to create your first one.'));
+        return 'done';
+    }
+    console.log(chalk.green('  ✓ ctxflow is active.') +
+        chalk.gray(`  ${features.length} feature${features.length === 1 ? '' : 's'} found.\n`));
+    const KEYS = ['1', '2', '3', '4', '5', '6', '7', '8', '9'];
+    const slice = features.slice(0, 9);
+    if (features.length > 9) {
+        console.log(chalk.cyan('  ℹ Showing first 9. Use `ctxflow status <name>` for the rest.\n'));
+    }
+    const choices = slice.map((f, i) => ({
+        key: KEYS[i],
+        label: f,
+        desc: '',
+        value: f,
+    }));
+    const feature = await pickFromList('Which feature?', choices, { escBack: true });
+    if (!feature)
+        return 'back'; // Esc → skip wait
+    await statusCommand(feature);
+    return 'done';
+}
+export function showHelp() {
+    console.log(chalk.cyan('  Usage'));
+    console.log('');
+    console.log(`  ${chalk.magenta('ctxflow')}                     ${chalk.gray('→ show interactive menu')}`);
+    console.log(`  ${chalk.magenta('ctxflow init')}                ${chalk.gray('→ create CLAUDE.md + docs/ structure')}`);
+    console.log(`  ${chalk.magenta('ctxflow new')} ${chalk.cyan('<feature>')}    ${chalk.gray('→ scaffold docs/features/<feature>/')}`);
+    console.log(`  ${chalk.magenta('ctxflow list')}                ${chalk.gray('→ list all features')}`);
+    console.log(`  ${chalk.magenta('ctxflow status')} ${chalk.cyan('<feature>')} ${chalk.gray('→ show task progress for a feature')}`);
+    console.log('');
+    console.log('');
+}
+//# sourceMappingURL=menu.js.map

package/dist/ui/menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../../src/ui/menu.ts"],"names":[],"mappings":"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"}

package/dist/utils/fs.d.ts

@@ -0,0 +1,11 @@
+export declare const TEMPLATES_DIR: string;
+export declare function renderTemplate(template: string, vars: Record<string, string>): string;
+export declare function readTemplate(name: string): Promise<string>;
+export declare function writeFile(filePath: string, content: string): Promise<void>;
+export declare function pathExists(filePath: string): Promise<boolean>;
+export declare function readDir(dirPath: string): Promise<string[]>;
+export declare function readFileContent(filePath: string): Promise<string>;
+export declare function statFile(filePath: string): Promise<{
+    birthtime: Date;
+} | null>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,aAAa,QAAqC,CAAC;AAEhE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAErF;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhE;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnE;AAED,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOhE;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEvE;AAED,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE,GAAG,IAAI,CAAC,CAMpF"}

package/dist/utils/fs.js

@@ -0,0 +1,40 @@
+import fsExtra from 'fs-extra';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export const TEMPLATES_DIR = join(__dirname, '..', 'templates');
+export function renderTemplate(template, vars) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_, key) => vars[key] ?? `{{${key}}}`);
+}
+export async function readTemplate(name) {
+    return fsExtra.readFile(join(TEMPLATES_DIR, name), 'utf-8');
+}
+export async function writeFile(filePath, content) {
+    await fsExtra.ensureDir(dirname(filePath));
+    await fsExtra.writeFile(filePath, content, 'utf-8');
+}
+export async function pathExists(filePath) {
+    return fsExtra.pathExists(filePath);
+}
+export async function readDir(dirPath) {
+    try {
+        const entries = await fsExtra.readdir(dirPath, { withFileTypes: true });
+        return entries.filter(e => e.isDirectory()).map(e => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+export async function readFileContent(filePath) {
+    return fsExtra.readFile(filePath, 'utf-8');
+}
+export async function statFile(filePath) {
+    try {
+        return await fsExtra.stat(filePath);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAErC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAEhE,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,IAA4B;IAC3E,OAAO,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IAC/D,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3C,MAAM,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,OAAO,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAe;IAC3C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,OAAO,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,9 @@
+export declare const logger: {
+    success: (msg: string) => void;
+    error: (msg: string) => void;
+    warn: (msg: string) => void;
+    info: (msg: string) => void;
+    file: (path: string) => void;
+    blank: () => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM;mBACF,MAAM;iBACN,MAAM;gBACN,MAAM;gBACN,MAAM;iBACL,MAAM;;CAEvB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,10 @@
+import chalk from 'chalk';
+export const logger = {
+    success: (msg) => console.log(chalk.green('✓') + ' ' + chalk.white(msg)),
+    error: (msg) => console.log(chalk.red('✗') + ' ' + chalk.red(msg)),
+    warn: (msg) => console.log(chalk.yellow('⚠') + ' ' + chalk.yellow(msg)),
+    info: (msg) => console.log(chalk.cyan('ℹ') + ' ' + chalk.white(msg)),
+    file: (path) => console.log(chalk.magenta('  →') + ' ' + chalk.gray(path)),
+    blank: () => console.log(''),
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChF,KAAK,EAAI,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5E,IAAI,EAAK,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClF,IAAI,EAAK,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/E,IAAI,EAAK,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrF,KAAK,EAAI,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;CAC/B,CAAC"}

package/package.json

@@ -1,10 +1,17 @@
 {
   "name": "ctxflow",
-  "version": "1.0.0",
-  "description": "Context scaffolding for AI agents",
+  "version": "1.0.1",
+  "description": "Context scaffolding for AI agent-driven development",
+  "type": "module",
   "bin": {
     "ctxflow": "bin/ctxflow.js"
   },
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc && node scripts/post-build.mjs",
+    "dev": "tsc --watch",
+    "start": "node bin/ctxflow.js"
+  },
   "keywords": [
     "ai",
     "context",
@@ -12,5 +19,24 @@
     "claude",
     "agents"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "files": ["bin", "dist"],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "figlet": "^1.7.0",
+    "fs-extra": "^11.2.0",
+    "gradient-string": "^3.0.0",
+    "inquirer": "^9.2.0"
+  },
+  "devDependencies": {
+    "@types/figlet": "^1.5.8",
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  }
 }