@buba_71/levit 0.3.4 → 0.8.2

package/README.md

@@ -1,6 +1,6 @@
 # levit-kit
 
-Hybrid starter kit for **Antigravity** projects  
+Hybrid starter kit for **AI-Driven Development (AIDD)** projects  
 (template + CLI + agentic conventions)
 
 ---
@@ -22,7 +22,7 @@ Hybrid starter kit for **Antigravity** projects
 
 ## Why levit-kit exists
 
-Levit-kit provides a **clean, readable, and predictable starting point** for initiating projects with Google Antigravity.
+Levit-kit provides a **clean, readable, and predictable starting point** for initiating projects with **AI-Driven Development (AIDD)**.
 
 It does not attempt to automate development, orchestrate agents, or generate business logic.
 
@@ -34,7 +34,8 @@ Its role is simple:
 ## What levit-kit does
 
 - Initializes a standardized project structure
-- Installs explicit conventions
+- Installs explicit conventions for **AI-Driven Development (AIDD)**
+- Provides a protocol for Human-AI collaboration (Intents, Decisions, Evals)
 - Facilitates human and agent onboarding
 - Reduces unnecessary variability between projects
 
@@ -57,25 +58,209 @@ These limits are intentional.
 Levit-kit is used **once**, at the very beginning of a project.
 
 ```bash
+# Default template (generic)
+npx @buba_71/levit init my-project
+
+# Symfony template
+npx @buba_71/levit init my-project symfony
+
+# Interactive template selection (if multiple templates available)
 npx @buba_71/levit init my-project
 ```
 
 ### Commands & Options
 
-- `init <name>`: Initializes a new project in the specified directory.
+- `init <name> [template]`: Initializes a new project in the specified directory. Optionally specify a template (default, symfony).
+- `feature new`: Creates a new feature intent (auto-assigns ID).
+- `feature list`: Lists all features with their status.
+- `feature status <id> <status>`: Updates a feature's status.
+- `decision new`: Creates a new Architecture Decision Record (ADR) (auto-assigns ID).
+- `handoff new`: Creates a workspace handoff brief for an agent.
+- `validate`: Validates project structure and cognitive scaffolding.
+- `--json`: Outputs machine-readable JSON (works with all commands).
 - `-v, --version`: Displays the current version.
 - `-h, --help`: Displays the help message.
 
+### Available Templates
+
+- **default**: Generic template for any type of project (structure only)
+- **symfony**: Template with Symfony-specific guidelines in `.levit/AGENT_ONBOARDING.md` (structure only)
+
+> **Important**: Templates provide **structure and governance**, not business logic or framework files.
+> For Symfony projects, create your Symfony application separately (e.g., `composer create-project symfony/skeleton`)
+> and integrate it with the Levit-Kit structure.
+
 ### What happens during init?
 
 The `init` command:
 1. Creates a new project directory.
-2. Copies the **default levit-kit template**.
-3. Includes a base `.gitignore` and `package.json`.
-4. Exits immediately.
+2. Copies the **levit-kit template** (structure only, no business logic).
+3. Generates a **`levit.json` manifest** with project metadata, governance rules, discovered roles, and constraints.
+4. Includes a base `.gitignore`.
+5. Exits immediately.
+
+> **Note**: Templates provide only the **AIDD governance structure** (`.levit/` directory with all governance), 
+> not project-specific configuration files. You should create your project files (package.json, composer.json, etc.) 
+> separately according to your needs.
+
+The `levit.json` file serves as the **central machine-readable contract** for AI agents, containing:
+- Project name and description
+- Governance settings (autonomy level, risk tolerance)
+- Active features and available roles
+- Technical constraints (file size limits, allowed dependencies, forbidden patterns)
+- Paths to key directories
 
 Levit-kit does not remain in the project after initialization and installs no dependencies.
 
+
+---
+
+## The AIDD Workflow (Human + Agent)
+
+Levit-kit installs a cognitive pipeline in your project:
+
+1.  **Human Intent**: You define *what* you want using `levit feature new`.
+2.  **Agent Onboarding**: Your AI reads `.levit/AGENT_ONBOARDING.md` to learn your rules.
+3.  **Collaborative Decision**: The agent or human proposes technical choices using `levit decision new` (stored in `.levit/decisions/`).
+4.  **Handoff**: You package the task for an agent using `levit handoff new`.
+5.  **Verification**: You or the agent run quality tests in `.levit/evals/`.
+6.  **Review**: The agent submits its work following the protocol in `.levit/workflows/`.
+
+> **📖 New to managing AI agents?** After initializing a project, read `HUMAN_AGENT_MANAGER.md` for a comprehensive guide on effectively managing AI agents, including best practices, anti-patterns, and troubleshooting.
+>
+> **🔄 Migrating an existing project?** See `MIGRATION_GUIDE.md` for step-by-step instructions on adopting levit-kit in your existing codebase.
+>
+> **🚀 Setting up CI/CD?** Templates for GitHub Actions and GitLab CI are included in all projects for automatic validation.
+
+---
+
+## Examples
+
+### Example 1: Creating a New Feature
+
+```bash
+# Interactive mode (prompts for input)
+$ levit feature new
+Feature title: User Authentication
+Feature slug [user-authentication]: 
+Created .levit/features/001-user-authentication.md
+
+# Non-interactive mode (with flags)
+$ levit feature new --title "User Authentication" --slug user-authentication --yes
+Created .levit/features/001-user-authentication.md
+```
+
+The created feature file includes:
+- Frontmatter with metadata (id, status, owner, risk_level, etc.)
+- Template sections: Vision, Success Criteria, Boundaries, Technical Constraints, Agent Task
+
+### Example 2: Creating an Architecture Decision
+
+```bash
+# Link a decision to a feature
+$ levit decision new --title "Use PostgreSQL for user data" --feature .levit/features/001-user-authentication.md --yes
+Created .levit/decisions/ADR-001-use-postgresql-for-user-data.md
+
+# Auto-assign ID
+$ levit decision new --title "Implement JWT authentication" --yes
+Created .levit/decisions/ADR-002-implement-jwt-authentication.md
+```
+
+### Example 3: Creating an Agent Handoff
+
+```bash
+# Handoff a feature to a developer agent
+$ levit handoff new --feature .levit/features/001-user-authentication.md --role developer --yes
+Created .levit/handoff/2026-01-01-001-user-authentication-developer.md
+
+# Handoff to security reviewer
+$ levit handoff new --feature .levit/features/001-user-authentication.md --role security --yes
+Created .levit/handoff/2026-01-01-001-user-authentication-security.md
+```
+
+### Example 4: Validating Project Structure
+
+```bash
+# Human-readable output
+$ levit validate
+🔍 Validating project cognitive scaffolding...
+✨ All cognitive scaffolding checks passed!
+
+# JSON output (for automation)
+$ levit validate --json
+{"level":"INFO","message":"🔍 Validating project cognitive scaffolding...","timestamp":"2026-01-01T12:00:00.000Z"}
+{"level":"INFO","message":"✨ All cognitive scaffolding checks passed!","timestamp":"2026-01-01T12:00:00.000Z"}
+```
+
+### Example 5: Complete Workflow
+
+Here's a complete workflow from feature creation to agent handoff:
+
+```bash
+# 1. Initialize project
+$ npx @buba_71/levit init my-api-project
+$ cd my-api-project
+
+# 2. Create a feature
+$ levit feature new --title "API Rate Limiting" --slug api-rate-limiting --yes
+Created .levit/features/001-api-rate-limiting.md
+
+# 3. Create a technical decision
+$ levit decision new --title "Use Redis for rate limiting" --feature .levit/features/001-api-rate-limiting.md --yes
+Created .levit/decisions/ADR-001-use-redis-for-rate-limiting.md
+
+# 4. Handoff to developer
+$ levit handoff new --feature .levit/features/001-api-rate-limiting.md --role developer --yes
+Created .levit/handoff/2026-01-01-001-api-rate-limiting-developer.md
+
+# 5. Agent reads handoff and implements
+# (Agent reads .levit/handoff/2026-01-01-001-api-rate-limiting-developer.md)
+
+# 6. Validate after implementation
+$ levit validate
+🔍 Validating project cognitive scaffolding...
+✨ All cognitive scaffolding checks passed!
+```
+
+### Example 6: Working with the Manifest
+
+The `levit.json` manifest is automatically synced when you create features or decisions. You can also manually inspect it:
+
+```json
+{
+  "version": "1.0.0",
+  "project": {
+    "name": "my-api-project",
+    "description": "AI-Driven Development project powered by levit-kit"
+  },
+  "governance": {
+    "autonomy_level": "low",
+    "risk_tolerance": "low"
+  },
+  "features": [
+    {
+      "id": "001",
+      "slug": "api-rate-limiting",
+      "status": "active",
+      "title": "API Rate Limiting",
+      "path": ".levit/features/001-api-rate-limiting.md"
+    }
+  ],
+  "roles": [
+    {
+      "name": "developer",
+      "description": "Developer Role",
+      "path": "roles/developer.md"
+    }
+  ],
+  "constraints": {
+    "max_file_size": 1000000,
+    "allowed_dependencies": [],
+    "forbidden_patterns": []
+  }
+}
+```
+
 ---
 
 ## Where does the levit command come from?

package/dist/bin/cli.js

@@ -5,22 +5,37 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const init_1 = require("../src/commands/init");
+const decision_1 = require("../src/commands/decision");
+const feature_1 = require("../src/commands/feature");
+const handoff_1 = require("../src/commands/handoff");
+const validate_1 = require("../src/commands/validate");
 const version_1 = require("../src/core/version");
 const node_path_1 = __importDefault(require("node:path"));
+const logger_1 = require("../src/core/logger");
+const errors_1 = require("../src/core/errors");
+const error_helper_1 = require("../src/core/error_helper");
 function showHelp() {
-    console.log(`
+    logger_1.Logger.info(`
 Usage: levit [command] [options]
 
 Commands:
   init <project-name>    Initialize a new levit project
+  feature new            Create a new feature intent file (wizard)
+  decision new           Create a new decision record (wizard)
+  handoff new            Create an agent handoff brief (wizard)
+  validate               Validate project cognitive scaffolding (cognitive linter)
 
 Options:
   -v, --version          Show version number
   -h, --help             Show help
+  --json                 Output in JSON format
 `);
 }
-function main() {
+async function main() {
     const args = process.argv.slice(2);
+    if (args.includes("--json")) {
+        logger_1.Logger.setJsonMode(true);
+    }
     if (args.includes("-h") || args.includes("--help") || args.length === 0) {
         showHelp();
         process.exit(0);
@@ -29,31 +44,59 @@ function main() {
         console.log(`levit-kit v${(0, version_1.getVersion)()}`);
         process.exit(0);
     }
-    if (args[0] === "init") {
-        const projectName = args[1];
-        if (!projectName) {
-            console.error("Error: Project name is required.");
-            console.error("Usage: levit init <project-name>");
-            process.exit(1);
-        }
-        // Basic validation: ensure it's a valid directory name
-        if (!/^[a-z0-9-_]+$/i.test(projectName)) {
-            console.error("Error: Invalid project name. Use only letters, numbers, dashes, and underscores.");
-            process.exit(1);
+    const command = args[0];
+    try {
+        switch (command) {
+            case "init":
+                const projectName = args[1];
+                const templateName = args[2] || undefined;
+                if (!projectName) {
+                    throw new errors_1.LevitError(errors_1.LevitErrorCode.MISSING_REQUIRED_ARG, "Project name is required. Usage: levit init <project-name> [template]");
+                }
+                await (0, init_1.initProject)(projectName, node_path_1.default.resolve(process.cwd(), projectName), templateName);
+                break;
+            case "feature":
+                await (0, feature_1.featureCommand)(args.slice(1), process.cwd());
+                break;
+            case "decision":
+                await (0, decision_1.decisionCommand)(args.slice(1), process.cwd());
+                break;
+            case "handoff":
+                await (0, handoff_1.handoffCommand)(args.slice(1), process.cwd());
+                break;
+            case "validate":
+                await (0, validate_1.validateCommand)(args.slice(1), process.cwd());
+                break;
+            default:
+                (0, error_helper_1.displayError)(new errors_1.LevitError(errors_1.LevitErrorCode.INVALID_COMMAND, `Unknown command "${command}"`));
+                logger_1.Logger.info("");
+                showHelp();
+                process.exit(1);
         }
-        const targetPath = node_path_1.default.resolve(process.cwd(), projectName);
-        try {
-            (0, init_1.initProject)(projectName, targetPath);
+    }
+    catch (error) {
+        if (error instanceof errors_1.LevitError) {
+            (0, error_helper_1.displayError)(error);
         }
-        catch (error) {
-            console.error(error instanceof Error ? `Error: ${error.message}` : "Unexpected error");
-            process.exit(1);
+        else {
+            const isJsonMode = logger_1.Logger.getJsonMode();
+            if (isJsonMode) {
+                logger_1.Logger.error(JSON.stringify({
+                    error: {
+                        code: "UNEXPECTED_ERROR",
+                        message: error instanceof Error ? error.message : "Unexpected error",
+                        details: error instanceof Error ? error.stack : String(error),
+                    },
+                }));
+            }
+            else {
+                logger_1.Logger.error(error instanceof Error ? error.message : "Unexpected error");
+                if (error instanceof Error && error.stack) {
+                    logger_1.Logger.debug(error.stack);
+                }
+            }
         }
-    }
-    else {
-        console.error(`Error: Unknown command "${args[0]}"`);
-        showHelp();
         process.exit(1);
     }
 }
-main();
+void main();

package/dist/src/commands/decision.js

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decisionCommand = decisionCommand;
+const promises_1 = __importDefault(require("node:readline/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const levit_project_1 = require("../core/levit_project");
+const cli_args_1 = require("../core/cli_args");
+const logger_1 = require("../core/logger");
+const decision_service_1 = require("../services/decision_service");
+const errors_1 = require("../core/errors");
+const table_1 = require("../core/table");
+const ids_1 = require("../core/ids");
+function normalizeSlug(input) {
+    return input
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-_]/g, "")
+        .replace(/\s+/g, "-");
+}
+async function decisionCommand(argv, cwd) {
+    const { positional, flags } = (0, cli_args_1.parseArgs)(argv);
+    const sub = positional[0];
+    if (sub !== "new") {
+        throw new errors_1.LevitError(errors_1.LevitErrorCode.INVALID_COMMAND, 'Usage: levit decision new [--title "..."] [--id "001"]');
+    }
+    const projectRoot = (0, levit_project_1.requireLevitProjectRoot)(cwd);
+    const yes = (0, cli_args_1.getBooleanFlag)(flags, "yes");
+    const overwrite = (0, cli_args_1.getBooleanFlag)(flags, "force");
+    const isJsonMode = logger_1.Logger.getJsonMode();
+    let title = (0, cli_args_1.getStringFlag)(flags, "title");
+    let id = (0, cli_args_1.getStringFlag)(flags, "id");
+    const featureRef = (0, cli_args_1.getStringFlag)(flags, "feature");
+    if (!yes) {
+        const rl = promises_1.default.createInterface({ input: process.stdin, output: process.stdout });
+        if (!title) {
+            title = (await rl.question("Decision title: ")).trim();
+        }
+        await rl.close();
+    }
+    if (!title) {
+        throw new errors_1.LevitError(errors_1.LevitErrorCode.MISSING_REQUIRED_ARG, "Missing --title");
+    }
+    // Generate ID if not provided
+    if (!id) {
+        const baseDir = node_path_1.default.join(projectRoot, ".levit", "decisions");
+        id = (0, ids_1.nextSequentialId)(baseDir, /^ADR-(\d+)-/);
+    }
+    // Preview before creation
+    if (!yes && !isJsonMode) {
+        const slug = normalizeSlug(title);
+        const decisionPath = node_path_1.default.relative(projectRoot, node_path_1.default.join(projectRoot, ".levit", "decisions", `ADR-${id}-${slug}.md`));
+        const preview = (0, table_1.createBox)("Decision Preview", {
+            "ID": `ADR-${id}`,
+            "Title": title,
+            "Feature": featureRef || "(none)",
+            "Path": decisionPath
+        });
+        logger_1.Logger.info("");
+        logger_1.Logger.info(preview);
+        logger_1.Logger.info("");
+        const rl = promises_1.default.createInterface({ input: process.stdin, output: process.stdout });
+        const confirm = await rl.question("Create this decision? [y/N]: ");
+        await rl.close();
+        if (confirm.toLowerCase() !== "y" && confirm.toLowerCase() !== "yes") {
+            logger_1.Logger.info("Cancelled.");
+            return;
+        }
+    }
+    const createdPath = decision_service_1.DecisionService.createDecision(projectRoot, { title, featureRef, id, overwrite });
+    logger_1.Logger.success(`Created ${createdPath}`);
+}

package/dist/src/commands/feature.js

@@ -0,0 +1,159 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.featureCommand = featureCommand;
+const promises_1 = __importDefault(require("node:readline/promises"));
+const chalk_1 = __importDefault(require("chalk"));
+const node_path_1 = __importDefault(require("node:path"));
+const levit_project_1 = require("../core/levit_project");
+const cli_args_1 = require("../core/cli_args");
+const logger_1 = require("../core/logger");
+const feature_service_1 = require("../services/feature_service");
+const errors_1 = require("../core/errors");
+const table_1 = require("../core/table");
+const ids_1 = require("../core/ids");
+function normalizeSlug(input) {
+    return input
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-_]/g, "")
+        .replace(/\s+/g, "-");
+}
+async function featureCommand(argv, cwd) {
+    const { positional, flags } = (0, cli_args_1.parseArgs)(argv);
+    const sub = positional[0];
+    const projectRoot = (0, levit_project_1.requireLevitProjectRoot)(cwd);
+    switch (sub) {
+        case "new":
+            await handleFeatureNew(projectRoot, flags);
+            break;
+        case "list":
+            handleFeatureList(projectRoot, flags);
+            break;
+        case "status":
+            await handleFeatureStatus(projectRoot, positional.slice(1), flags);
+            break;
+        default:
+            throw new errors_1.LevitError(errors_1.LevitErrorCode.INVALID_COMMAND, 'Usage: levit feature <new|list|status> [options]\n' +
+                '  new: Create a new feature\n' +
+                '  list: List all features\n' +
+                '  status: Update feature status (usage: levit feature status <id> <status>)');
+    }
+}
+async function handleFeatureNew(projectRoot, flags) {
+    const yes = (0, cli_args_1.getBooleanFlag)(flags, "yes");
+    const overwrite = (0, cli_args_1.getBooleanFlag)(flags, "force");
+    const isJsonMode = logger_1.Logger.getJsonMode();
+    let title = (0, cli_args_1.getStringFlag)(flags, "title");
+    let slug = (0, cli_args_1.getStringFlag)(flags, "slug");
+    let id = (0, cli_args_1.getStringFlag)(flags, "id");
+    if (!yes) {
+        const rl = promises_1.default.createInterface({ input: process.stdin, output: process.stdout });
+        if (!title) {
+            title = (await rl.question("Feature title: ")).trim();
+        }
+        if (!slug) {
+            const computed = normalizeSlug(title || "");
+            slug = (await rl.question(`Feature slug [${computed}]: `)).trim() || computed;
+        }
+        await rl.close();
+    }
+    if (!title) {
+        throw new errors_1.LevitError(errors_1.LevitErrorCode.MISSING_REQUIRED_ARG, "Missing --title");
+    }
+    if (!slug) {
+        throw new errors_1.LevitError(errors_1.LevitErrorCode.MISSING_REQUIRED_ARG, "Missing --slug");
+    }
+    // Generate ID if not provided
+    if (!id) {
+        const baseDir = node_path_1.default.join(projectRoot, ".levit", "features");
+        id = (0, ids_1.nextSequentialId)(baseDir, /^(\d+)-/);
+    }
+    // Preview before creation
+    if (!yes && !isJsonMode) {
+        const featurePath = node_path_1.default.relative(projectRoot, node_path_1.default.join(projectRoot, ".levit", "features", `${id}-${slug}.md`));
+        const preview = (0, table_1.createBox)("Feature Preview", {
+            "ID": id,
+            "Title": title,
+            "Slug": slug,
+            "Path": featurePath
+        });
+        logger_1.Logger.info("");
+        logger_1.Logger.info(preview);
+        logger_1.Logger.info("");
+        const rl = promises_1.default.createInterface({ input: process.stdin, output: process.stdout });
+        const confirm = await rl.question("Create this feature? [y/N]: ");
+        await rl.close();
+        if (confirm.toLowerCase() !== "y" && confirm.toLowerCase() !== "yes") {
+            logger_1.Logger.info("Cancelled.");
+            return;
+        }
+    }
+    const createdPath = feature_service_1.FeatureService.createFeature(projectRoot, { title, slug, id, overwrite });
+    logger_1.Logger.success(`Created ${createdPath}`);
+}
+function handleFeatureList(projectRoot, flags) {
+    const features = feature_service_1.FeatureService.listFeatures(projectRoot);
+    const isJsonMode = logger_1.Logger.getJsonMode();
+    if (features.length === 0) {
+        logger_1.Logger.info("No features found.");
+        return;
+    }
+    // Create formatted table
+    const table = (0, table_1.createTable)(["ID", "Status", "Title"]);
+    for (const feature of features) {
+        // Color status based on value
+        let statusDisplay = feature.status;
+        switch (feature.status) {
+            case "active":
+                statusDisplay = isJsonMode ? "active" : chalk_1.default.green("● active");
+                break;
+            case "draft":
+                statusDisplay = isJsonMode ? "draft" : chalk_1.default.yellow("○ draft");
+                break;
+            case "deprecated":
+                statusDisplay = isJsonMode ? "deprecated" : chalk_1.default.red("× deprecated");
+                break;
+            case "completed":
+                statusDisplay = isJsonMode ? "completed" : chalk_1.default.cyan("✓ completed");
+                break;
+        }
+        table.push([
+            feature.id,
+            statusDisplay,
+            feature.title
+        ]);
+    }
+    if (!isJsonMode) {
+        logger_1.Logger.info("");
+        logger_1.Logger.info(chalk_1.default.bold("Features:"));
+    }
+    (0, table_1.renderTable)(table, isJsonMode);
+    if (!isJsonMode) {
+        logger_1.Logger.info(`\nTotal: ${chalk_1.default.bold(features.length.toString())} feature(s)`);
+        logger_1.Logger.info("");
+    }
+    else {
+        logger_1.Logger.info(JSON.stringify({ total: features.length }));
+    }
+}
+async function handleFeatureStatus(projectRoot, args, flags) {
+    const featureId = args[0] || (0, cli_args_1.getStringFlag)(flags, "id");
+    let newStatus = args[1] || (0, cli_args_1.getStringFlag)(flags, "status");
+    if (!featureId) {
+        throw new errors_1.LevitError(errors_1.LevitErrorCode.MISSING_REQUIRED_ARG, "Missing feature ID. Usage: levit feature status <id> <status>");
+    }
+    const validStatuses = ['active', 'draft', 'deprecated', 'completed'];
+    if (!newStatus) {
+        const rl = promises_1.default.createInterface({ input: process.stdin, output: process.stdout });
+        newStatus = (await rl.question(`New status [active|draft|deprecated|completed]: `)).trim();
+        await rl.close();
+    }
+    if (!validStatuses.includes(newStatus)) {
+        throw new errors_1.LevitError(errors_1.LevitErrorCode.VALIDATION_FAILED, `Invalid status "${newStatus}". Must be one of: ${validStatuses.join(", ")}`);
+    }
+    feature_service_1.FeatureService.updateFeatureStatus(projectRoot, featureId, newStatus);
+    logger_1.Logger.info(`Updated feature ${featureId} status to "${newStatus}"`);
+}

package/dist/src/commands/handoff.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handoffCommand = handoffCommand;
+const promises_1 = __importDefault(require("node:readline/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const levit_project_1 = require("../core/levit_project");
+const cli_args_1 = require("../core/cli_args");
+const logger_1 = require("../core/logger");
+const handoff_service_1 = require("../services/handoff_service");
+const errors_1 = require("../core/errors");
+const table_1 = require("../core/table");
+function isoDate() {
+    return new Date().toISOString().slice(0, 10);
+}
+async function handoffCommand(argv, cwd) {
+    const { positional, flags } = (0, cli_args_1.parseArgs)(argv);
+    const sub = positional[0];
+    if (sub !== "new") {
+        throw new errors_1.LevitError(errors_1.LevitErrorCode.INVALID_COMMAND, "Usage: levit handoff new --feature <.levit/features/001-...md> [--role developer|qa|security|devops]");
+    }
+    const projectRoot = (0, levit_project_1.requireLevitProjectRoot)(cwd);
+    const yes = (0, cli_args_1.getBooleanFlag)(flags, "yes");
+    const overwrite = (0, cli_args_1.getBooleanFlag)(flags, "force");
+    const isJsonMode = logger_1.Logger.getJsonMode();
+    let feature = (0, cli_args_1.getStringFlag)(flags, "feature");
+    let role = (0, cli_args_1.getStringFlag)(flags, "role");
+    if (!yes) {
+        const rl = promises_1.default.createInterface({ input: process.stdin, output: process.stdout });
+        if (!feature) {
+            feature = (await rl.question("Feature path (e.g. .levit/features/001-...md): ")).trim();
+        }
+        if (!role) {
+            role = (await rl.question("Role [developer]: ")).trim() || "developer";
+        }
+        await rl.close();
+    }
+    if (!feature) {
+        throw new errors_1.LevitError(errors_1.LevitErrorCode.MISSING_REQUIRED_ARG, "Missing --feature");
+    }
+    if (!role) {
+        role = "developer";
+    }
+    // Preview before creation
+    if (!yes && !isJsonMode) {
+        const safeRole = role.trim().toLowerCase();
+        const date = isoDate();
+        const fileName = `${date}-${node_path_1.default.basename(feature, node_path_1.default.extname(feature))}-${safeRole}.md`;
+        const handoffPath = node_path_1.default.relative(projectRoot, node_path_1.default.join(projectRoot, ".levit", "handoff", fileName));
+        const preview = (0, table_1.createBox)("Handoff Preview", {
+            "Date": date,
+            "Feature": feature,
+            "Role": safeRole,
+            "Path": handoffPath
+        });
+        logger_1.Logger.info("");
+        logger_1.Logger.info(preview);
+        logger_1.Logger.info("");
+        const rl = promises_1.default.createInterface({ input: process.stdin, output: process.stdout });
+        const confirm = await rl.question("Create this handoff? [y/N]: ");
+        await rl.close();
+        if (confirm.toLowerCase() !== "y" && confirm.toLowerCase() !== "yes") {
+            logger_1.Logger.info("Cancelled.");
+            return;
+        }
+    }
+    const createdPath = handoff_service_1.HandoffService.createHandoff(projectRoot, { feature, role, overwrite });
+    logger_1.Logger.success(`Created ${createdPath}`);
+}