@buba_71/levit 0.3.3 → 0.3.4

package/dist/bin/cli.js

@@ -4,18 +4,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const init_1 = require("../src/init");
+const init_1 = require("../src/commands/init");
+const version_1 = require("../src/core/version");
 const node_path_1 = __importDefault(require("node:path"));
-const fs_extra_1 = __importDefault(require("fs-extra"));
-function getVersion() {
-    try {
-        const packageJson = fs_extra_1.default.readJsonSync(node_path_1.default.join(__dirname, "..", "..", "package.json"));
-        return packageJson.version;
-    }
-    catch {
-        return "unknown";
-    }
-}
 function showHelp() {
     console.log(`
 Usage: levit [command] [options]
@@ -35,7 +26,7 @@ function main() {
         process.exit(0);
     }
     if (args.includes("-v") || args.includes("--version")) {
-        console.log(`levit-kit v${getVersion()}`);
+        console.log(`levit-kit v${(0, version_1.getVersion)()}`);
         process.exit(0);
     }
     if (args[0] === "init") {

package/dist/src/commands/init.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initProject = initProject;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const paths_1 = require("../core/paths");
+const version_1 = require("../core/version");
+const init_1 = require("../init");
+/**
+ * Initializes a new project by copying the default template.
+ *
+ * @param projectName The name of the project to create
+ * @param targetPath The absolute path where the project should be created
+ */
+function initProject(projectName, targetPath) {
+    const templatePath = (0, paths_1.getTemplatePath)("default");
+    const version = (0, version_1.getVersion)();
+    if (!projectName) {
+        throw new Error("Project name is required.");
+    }
+    // Ensure project name is valid for a directory
+    if (!/^[a-z0-9-_]+$/i.test(projectName)) {
+        throw new Error("Invalid project name. Use only letters, numbers, dashes, and underscores.");
+    }
+    if (fs_extra_1.default.existsSync(targetPath)) {
+        throw new Error(`Directory "${projectName}" already exists.`);
+    }
+    if (!fs_extra_1.default.existsSync(templatePath)) {
+        throw new Error(`Default template not found at ${templatePath}`);
+    }
+    try {
+        (0, init_1.generateProject)(targetPath, "default");
+        console.log("");
+        console.log(`🚀 levit-kit v${version}`);
+        console.log("");
+        console.log("  ✔ Structure initialized");
+        console.log("  ✔ Conventions applied");
+        console.log("");
+        console.log(`✨ Project "${projectName}" is ready for development.`);
+        console.log("");
+        console.log("Next steps:");
+        console.log(`  1. cd ${projectName}`);
+        console.log("  2. Review SOCIAL_CONTRACT.md to understand the foundations");
+        console.log("  3. Define your first feature in features/README.md");
+        console.log("");
+    }
+    catch (error) {
+        // Attempt clean up if directory was created but copy failed
+        if (fs_extra_1.default.existsSync(targetPath) && fs_extra_1.default.readdirSync(targetPath).length === 0) {
+            fs_extra_1.default.rmSync(targetPath, { recursive: true, force: true });
+        }
+        throw error;
+    }
+}

package/dist/src/core/paths.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPackageRoot = getPackageRoot;
+exports.getTemplatesPath = getTemplatesPath;
+exports.getTemplatePath = getTemplatePath;
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Resolves the root directory of the levit-kit package.
+ * Assuming this file is at src/core/paths.ts,
+ * after compilation it will be at dist/src/core/paths.js.
+ */
+function getPackageRoot() {
+    return node_path_1.default.resolve(__dirname, "..", "..", "..");
+}
+/**
+ * Returns the absolute path to the templates directory.
+ */
+function getTemplatesPath() {
+    return node_path_1.default.join(getPackageRoot(), "templates");
+}
+/**
+ * Returns the absolute path to a specific template.
+ */
+function getTemplatePath(templateName = "default") {
+    return node_path_1.default.join(getTemplatesPath(), templateName);
+}

package/dist/src/core/version.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVersion = getVersion;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const paths_1 = require("./paths");
+/**
+ * Reads and returns the version from the package.json.
+ */
+function getVersion() {
+    try {
+        const packageJsonPath = node_path_1.default.join((0, paths_1.getPackageRoot)(), "package.json");
+        const packageJson = fs_extra_1.default.readJsonSync(packageJsonPath);
+        return packageJson.version || "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}

package/dist/src/init.js

@@ -3,49 +3,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.initProject = initProject;
+exports.generateProject = generateProject;
 const fs_extra_1 = __importDefault(require("fs-extra"));
-const node_path_1 = __importDefault(require("node:path"));
-function getPackageRoot() {
-    // Use __dirname to reliably locate the package root relative to this file
-    // compiled file is in dist/src/init.js, so we go up two levels to reach package root
-    return node_path_1.default.resolve(__dirname, "..", "..");
-}
-function getVersion() {
-    try {
-        const packageJson = fs_extra_1.default.readJsonSync(node_path_1.default.join(getPackageRoot(), "package.json"));
-        return packageJson.version;
-    }
-    catch {
-        return "0.0.0";
-    }
-}
-function initProject(projectName, targetPath) {
-    const packageRoot = getPackageRoot();
-    const templatePath = node_path_1.default.join(packageRoot, "templates", "default");
-    const version = getVersion();
-    if (!projectName) {
-        throw new Error("Project name is required.");
-    }
-    if (fs_extra_1.default.existsSync(targetPath)) {
-        throw new Error(`Directory "${projectName}" already exists.`);
-    }
+const paths_1 = require("./core/paths");
+/**
+ * Core generation logic for a new project.
+ * Responsible only for file system operations.
+ */
+function generateProject(targetPath, templateName = "default") {
+    const templatePath = (0, paths_1.getTemplatePath)(templateName);
     if (!fs_extra_1.default.existsSync(templatePath)) {
-        throw new Error(`Default template not found at ${templatePath}`);
+        throw new Error(`Template "${templateName}" not found.`);
+    }
+    if (fs_extra_1.default.existsSync(targetPath) && fs_extra_1.default.readdirSync(targetPath).length > 0) {
+        throw new Error(`Target directory "${targetPath}" is not empty.`);
     }
     fs_extra_1.default.ensureDirSync(targetPath);
     fs_extra_1.default.copySync(templatePath, targetPath);
-    console.log("");
-    console.log(`🚀 levit-kit v${version}`);
-    console.log("");
-    console.log("  ✔ Project directory created");
-    console.log("  ✔ Template copied");
-    console.log("");
-    console.log(`✨ Project "${projectName}" initialized successfully.`);
-    console.log("");
-    console.log("Next steps:");
-    console.log(`  - cd ${projectName}`);
-    console.log("  - Read SOCIAL_CONTRACT.md");
-    console.log("  - Start defining features");
-    console.log("");
 }

package/dist/tests/init.test.js

@@ -8,7 +8,8 @@ const node_assert_1 = __importDefault(require("node:assert"));
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const node_os_1 = __importDefault(require("node:os"));
-const init_1 = require("../src/init");
+const node_child_process_1 = require("node:child_process");
+const init_1 = require("../src/commands/init");
 function exists(p) {
     return node_fs_1.default.existsSync(p);
 }
@@ -26,8 +27,32 @@ function exists(p) {
     node_assert_1.default.ok(exists(node_path_1.default.join(projectPath, "roles")));
     node_assert_1.default.ok(exists(node_path_1.default.join(projectPath, "pipelines")));
     node_assert_1.default.ok(exists(node_path_1.default.join(projectPath, "docs")));
+    node_assert_1.default.ok(exists(node_path_1.default.join(projectPath, "roles", "README.md")), "Roles README should exist");
+    // New files assertions
+    node_assert_1.default.ok(exists(node_path_1.default.join(projectPath, ".gitignore")), ".gitignore should exist");
+    node_assert_1.default.ok(exists(node_path_1.default.join(projectPath, "package.json")), "package.json should exist");
     // Agent boundaries
     node_assert_1.default.ok(exists(node_path_1.default.join(projectPath, "agents", "AGENTS.md")), "Agent guidelines should exist");
     // Feature contract
     node_assert_1.default.ok(exists(node_path_1.default.join(projectPath, "features", "README.md")), "Feature README should exist");
+    // Clean up
+    node_fs_1.default.rmSync(tempDir, { recursive: true, force: true });
+});
+(0, node_test_1.default)("CLI --help works", () => {
+    const output = (0, node_child_process_1.execSync)("node dist/bin/cli.js --help").toString();
+    node_assert_1.default.ok(output.includes("Usage: levit [command] [options]"));
+    node_assert_1.default.ok(output.includes("init <project-name>"));
+});
+(0, node_test_1.default)("CLI --version works", () => {
+    const output = (0, node_child_process_1.execSync)("node dist/bin/cli.js --version").toString();
+    node_assert_1.default.ok(output.startsWith("levit-kit v"));
+});
+(0, node_test_1.default)("CLI name validation works", () => {
+    try {
+        (0, node_child_process_1.execSync)("node dist/bin/cli.js init invalid/name");
+        node_assert_1.default.fail("Should have failed with invalid name");
+    }
+    catch (error) {
+        node_assert_1.default.ok(error.stderr.toString().includes("Error: Invalid project name"));
+    }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buba_71/levit",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Hybrid starter kit for Antigravity projects",
   "author": "David BUBA",
   "license": "MIT",

package/templates/default/agents/AGENTS.md

@@ -10,4 +10,11 @@ Agents are not allowed to:
 - restructure the repository
 - introduce implicit behavior
 
+---
+
+## Related Resources
+
+- [Project Roles](../roles/README.md): Understand the specific responsibilities within this project.
+- [Feature Contracts](../features/README.md): High-level intents and constraints for new developments.
+
 When unsure, agents must ask for human validation.

package/templates/default/pipelines/README.md

@@ -6,3 +6,5 @@ Add pipelines only when:
 - the need is explicit
 - the impact is understood
 - the behavior is documented
+
+Favor **modular CI/CD configurations** that remain intelligible and decoupled from the business logic.

package/templates/default/roles/README.md

@@ -0,0 +1,13 @@
+# Project Roles
+
+This directory contains the definitions of human and agent roles within this project.
+
+## Available Roles
+
+- [DevOps](devops.md): Infrastructure, deployment, and operational requirements.
+- [QA](qa.md): Quality standards, testing expectations, and validation criteria.
+- [Security](security.md): Threat assumptions and security constraints.
+
+## Goal
+
+The goal of defining roles is to **reduce ambiguity**. Each role document should clearly state its boundaries and responsibilities to facilitate collaboration between humans and AI agents.