@buba_71/levit 0.3.4 → 0.8.2

package/dist/tests/services/decision_service.test.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = __importDefault(require("node:test"));
+const node_assert_1 = __importDefault(require("node:assert"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+const decision_service_1 = require("../../src/services/decision_service");
+(0, node_test_1.default)("DecisionService.createDecision generates correct structure", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "decision-service-test-"));
+    const decisionsDir = node_path_1.default.join(tempDir, ".levit", "decisions");
+    fs_extra_1.default.ensureDirSync(decisionsDir);
+    decision_service_1.DecisionService.createDecision(tempDir, {
+        title: "Test Architecture",
+        id: "005",
+        featureRef: ".levit/features/001.md"
+    });
+    const expectedFile = node_path_1.default.join(decisionsDir, "ADR-005-test-architecture.md");
+    node_assert_1.default.ok(fs_extra_1.default.existsSync(expectedFile));
+    const content = fs_extra_1.default.readFileSync(expectedFile, "utf-8");
+    node_assert_1.default.ok(content.includes("id: ADR-005"));
+    node_assert_1.default.ok(content.includes("depends_on: [.levit/features/001.md]"));
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});

package/dist/tests/services/feature_service.test.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = __importDefault(require("node:test"));
+const node_assert_1 = __importDefault(require("node:assert"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+const feature_service_1 = require("../../src/services/feature_service");
+(0, node_test_1.default)("FeatureService.createFeature generates correct file", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "feature-service-test-"));
+    const featuresDir = node_path_1.default.join(tempDir, ".levit", "features");
+    fs_extra_1.default.ensureDirSync(featuresDir);
+    feature_service_1.FeatureService.createFeature(tempDir, {
+        title: "Unit Test Feature",
+        slug: "unit-test-feature",
+        id: "999"
+    });
+    const expectedFile = node_path_1.default.join(featuresDir, "999-unit-test-feature.md");
+    node_assert_1.default.ok(fs_extra_1.default.existsSync(expectedFile));
+    const content = fs_extra_1.default.readFileSync(expectedFile, "utf-8");
+    node_assert_1.default.ok(content.includes("id: 999"));
+    // Slug is currently only used for filename, not in content
+    // assert.ok(content.includes("slug: unit-test-feature"));
+    node_assert_1.default.ok(content.includes("# INTENT: Unit Test Feature"));
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});
+(0, node_test_1.default)("FeatureService.createFeature auto-generates ID", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "feature-service-test-"));
+    const featuresDir = node_path_1.default.join(tempDir, ".levit", "features");
+    fs_extra_1.default.ensureDirSync(featuresDir);
+    feature_service_1.FeatureService.createFeature(tempDir, {
+        title: "Auto ID Feature",
+        slug: "auto-id"
+    });
+    // Should be 001-auto-id.md since directory is empty
+    const expectedFile = node_path_1.default.join(featuresDir, "001-auto-id.md");
+    node_assert_1.default.ok(fs_extra_1.default.existsSync(expectedFile));
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});

package/dist/tests/services/handoff_service.test.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = __importDefault(require("node:test"));
+const node_assert_1 = __importDefault(require("node:assert"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+const handoff_service_1 = require("../../src/services/handoff_service");
+(0, node_test_1.default)("HandoffService.createHandoff generates correct file name", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "handoff-service-test-"));
+    const handoffDir = node_path_1.default.join(tempDir, ".levit", "handoff");
+    fs_extra_1.default.ensureDirSync(handoffDir);
+    const date = new Date().toISOString().slice(0, 10);
+    handoff_service_1.HandoffService.createHandoff(tempDir, {
+        feature: ".levit/features/login.md",
+        role: "qa"
+    });
+    // format: YYYY-MM-DD-filename-role.md
+    const expectedFile = node_path_1.default.join(handoffDir, `${date}-login-qa.md`);
+    node_assert_1.default.ok(fs_extra_1.default.existsSync(expectedFile));
+    const content = fs_extra_1.default.readFileSync(expectedFile, "utf-8");
+    node_assert_1.default.ok(content.includes(`id: HAND-${date}-qa`));
+    node_assert_1.default.ok(content.includes("owner: qa"));
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});

package/dist/tests/services/manifest_service.test.js

@@ -0,0 +1,189 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = __importDefault(require("node:test"));
+const node_assert_1 = __importDefault(require("node:assert"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+const manifest_service_1 = require("../../src/services/manifest_service");
+(0, node_test_1.default)("ManifestService.read returns default manifest when file doesn't exist", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "manifest-test-"));
+    const manifest = manifest_service_1.ManifestService.read(tempDir);
+    node_assert_1.default.strictEqual(manifest.project.name, "my-project");
+    node_assert_1.default.strictEqual(manifest.version, "1.0.0");
+    node_assert_1.default.deepStrictEqual(manifest.features, []);
+    node_assert_1.default.deepStrictEqual(manifest.roles, []);
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});
+(0, node_test_1.default)("ManifestService.read reads existing manifest", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "manifest-test-"));
+    const manifestPath = node_path_1.default.join(tempDir, "levit.json");
+    const testManifest = {
+        version: "1.0.0",
+        project: {
+            name: "test-project",
+            description: "Test"
+        },
+        governance: {
+            autonomy_level: "medium",
+            risk_tolerance: "medium"
+        },
+        features: [],
+        roles: [],
+        constraints: {},
+        paths: {
+            features: "features",
+            decisions: ".levit/decisions",
+            handoffs: ".levit/handoff"
+        }
+    };
+    fs_extra_1.default.writeJsonSync(manifestPath, testManifest, { spaces: 2 });
+    const manifest = manifest_service_1.ManifestService.read(tempDir);
+    node_assert_1.default.strictEqual(manifest.project.name, "test-project");
+    node_assert_1.default.strictEqual(manifest.governance.autonomy_level, "medium");
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});
+(0, node_test_1.default)("ManifestService.write creates manifest file", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "manifest-test-"));
+    const manifestPath = node_path_1.default.join(tempDir, "levit.json");
+    const testManifest = {
+        version: "1.0.0",
+        project: {
+            name: "write-test"
+        },
+        governance: {
+            autonomy_level: "low",
+            risk_tolerance: "low"
+        },
+        features: [],
+        roles: [],
+        constraints: {},
+        paths: {
+            features: "features",
+            decisions: ".levit/decisions",
+            handoffs: ".levit/handoff"
+        }
+    };
+    manifest_service_1.ManifestService.write(tempDir, testManifest);
+    node_assert_1.default.ok(fs_extra_1.default.existsSync(manifestPath));
+    const written = fs_extra_1.default.readJsonSync(manifestPath);
+    node_assert_1.default.strictEqual(written.project.name, "write-test");
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});
+(0, node_test_1.default)("ManifestService.sync discovers features from filesystem", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "manifest-test-"));
+    const featuresDir = node_path_1.default.join(tempDir, ".levit", "features");
+    fs_extra_1.default.ensureDirSync(featuresDir);
+    // Create a test feature file
+    const featureContent = `---
+id: 001
+status: active
+owner: human
+last_updated: 2026-01-01
+risk_level: low
+depends_on: []
+---
+
+# INTENT: Test Feature
+`;
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(featuresDir, "001-test-feature.md"), featureContent);
+    const manifest = manifest_service_1.ManifestService.sync(tempDir);
+    node_assert_1.default.strictEqual(manifest.features.length, 1);
+    node_assert_1.default.strictEqual(manifest.features[0].id, "001");
+    node_assert_1.default.strictEqual(manifest.features[0].slug, "test-feature");
+    node_assert_1.default.strictEqual(manifest.features[0].title, "Test Feature");
+    node_assert_1.default.strictEqual(manifest.features[0].status, "active");
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});
+(0, node_test_1.default)("ManifestService.sync discovers roles from filesystem", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "manifest-test-"));
+    const rolesDir = node_path_1.default.join(tempDir, ".levit", "roles");
+    fs_extra_1.default.ensureDirSync(rolesDir);
+    // Create a test role file
+    const roleContent = `# Security Role
+This is the security role description.
+`;
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(rolesDir, "security.md"), roleContent);
+    const manifest = manifest_service_1.ManifestService.sync(tempDir);
+    node_assert_1.default.strictEqual(manifest.roles.length, 1);
+    node_assert_1.default.strictEqual(manifest.roles[0].name, "security");
+    node_assert_1.default.strictEqual(manifest.roles[0].description, "Security Role");
+    node_assert_1.default.strictEqual(manifest.roles[0].path, ".levit/roles/security.md");
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});
+(0, node_test_1.default)("ManifestService.sync ignores README files", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "manifest-test-"));
+    const featuresDir = node_path_1.default.join(tempDir, ".levit", "features");
+    fs_extra_1.default.ensureDirSync(featuresDir);
+    // Create README and INTENT files (should be ignored)
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(featuresDir, "README.md"), "# Features");
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(featuresDir, "INTENT.md"), "# Intent Template");
+    // Create actual feature
+    const featureContent = `---
+id: 001
+status: active
+owner: human
+last_updated: 2026-01-01
+risk_level: low
+depends_on: []
+---
+
+# INTENT: Real Feature
+`;
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(featuresDir, "001-real-feature.md"), featureContent);
+    const manifest = manifest_service_1.ManifestService.sync(tempDir);
+    node_assert_1.default.strictEqual(manifest.features.length, 1);
+    node_assert_1.default.strictEqual(manifest.features[0].slug, "real-feature");
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});
+(0, node_test_1.default)("ManifestService.sync handles missing directories gracefully", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "manifest-test-"));
+    // No features or roles directories
+    const manifest = manifest_service_1.ManifestService.sync(tempDir);
+    node_assert_1.default.deepStrictEqual(manifest.features, []);
+    node_assert_1.default.deepStrictEqual(manifest.roles, []);
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});
+(0, node_test_1.default)("ManifestService.sync handles features with invalid frontmatter gracefully", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "manifest-test-"));
+    const featuresDir = node_path_1.default.join(tempDir, ".levit", "features");
+    fs_extra_1.default.ensureDirSync(featuresDir);
+    // Create feature with invalid frontmatter (missing closing ---)
+    const invalidFeature = `---
+id: 001
+status: active
+# Missing closing delimiter
+
+# INTENT: Invalid Feature
+`;
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(featuresDir, "001-invalid.md"), invalidFeature);
+    // Should not throw, but feature might have default values
+    const manifest = manifest_service_1.ManifestService.sync(tempDir);
+    // Should still discover the file (by filename)
+    node_assert_1.default.strictEqual(manifest.features.length, 1);
+    node_assert_1.default.strictEqual(manifest.features[0].id, "001");
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});
+(0, node_test_1.default)("ManifestService.sync extracts title from INTENT header", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "manifest-test-"));
+    const featuresDir = node_path_1.default.join(tempDir, ".levit", "features");
+    fs_extra_1.default.ensureDirSync(featuresDir);
+    const featureContent = `---
+id: 002
+status: draft
+owner: human
+last_updated: 2026-01-01
+risk_level: medium
+depends_on: []
+---
+
+# INTENT: Complex Feature Title With Spaces
+`;
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(featuresDir, "002-complex.md"), featureContent);
+    const manifest = manifest_service_1.ManifestService.sync(tempDir);
+    node_assert_1.default.strictEqual(manifest.features[0].title, "Complex Feature Title With Spaces");
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});

package/dist/tests/services/validation_service.test.js

@@ -0,0 +1,196 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = __importDefault(require("node:test"));
+const node_assert_1 = __importDefault(require("node:assert"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+const validation_service_1 = require("../../src/services/validation_service");
+(0, node_test_1.default)("ValidationService reports errors if core directories are missing", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "validation-service-test-"));
+    // Validate empty dir
+    const result = validation_service_1.ValidationService.validate(tempDir);
+    // Expect invalid
+    node_assert_1.default.strictEqual(result.valid, false);
+    node_assert_1.default.ok(result.metrics.errors > 0, "Should have errors");
+    // Check specific error code presence
+    const missingDirs = result.issues.filter(i => i.code === "MISSING_DIRECTORY");
+    node_assert_1.default.ok(missingDirs.length > 0, "Should report missing directories");
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});
+(0, node_test_1.default)("ValidationService passes for valid structure", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "validation-service-succ-"));
+    // Scout scaffolding: .levit/features, .levit/decisions, .levit/handoff, core files
+    const dirs = [".levit/features", ".levit/decisions", ".levit/handoff"];
+    dirs.forEach(d => fs_extra_1.default.ensureDirSync(node_path_1.default.join(tempDir, d)));
+    const files = ["SOCIAL_CONTRACT.md", ".levit/AGENT_CONTRACT.md", ".levit/AGENT_ONBOARDING.md"];
+    files.forEach(f => fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, f), "content"));
+    const result = validation_service_1.ValidationService.validate(tempDir);
+    node_assert_1.default.strictEqual(result.valid, true);
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});
+(0, node_test_1.default)("ValidationService detects feature with invalid frontmatter", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "validation-service-test-"));
+    const featuresDir = node_path_1.default.join(tempDir, ".levit", "features");
+    fs_extra_1.default.ensureDirSync(featuresDir);
+    // Create core structure
+    fs_extra_1.default.ensureDirSync(node_path_1.default.join(tempDir, ".levit/decisions"));
+    fs_extra_1.default.ensureDirSync(node_path_1.default.join(tempDir, ".levit/handoff"));
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, "SOCIAL_CONTRACT.md"), "content");
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, ".levit/AGENT_CONTRACT.md"), "content");
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, ".levit/AGENT_ONBOARDING.md"), "content");
+    // Create feature with missing required fields
+    const invalidFeature = `---
+id: 001
+status: active
+# Missing: owner, last_updated, risk_level, depends_on
+
+# INTENT: Test Feature
+`;
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(featuresDir, "001-test.md"), invalidFeature);
+    const result = validation_service_1.ValidationService.validate(tempDir);
+    node_assert_1.default.strictEqual(result.valid, false);
+    const frontmatterErrors = result.issues.filter(i => i.code === "INVALID_FRONTMATTER");
+    node_assert_1.default.ok(frontmatterErrors.length > 0, "Should report invalid frontmatter");
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});
+(0, node_test_1.default)("ValidationService detects feature without INTENT header", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "validation-service-test-"));
+    const featuresDir = node_path_1.default.join(tempDir, ".levit", "features");
+    fs_extra_1.default.ensureDirSync(featuresDir);
+    // Create core structure
+    fs_extra_1.default.ensureDirSync(node_path_1.default.join(tempDir, ".levit/decisions"));
+    fs_extra_1.default.ensureDirSync(node_path_1.default.join(tempDir, ".levit/handoff"));
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, "SOCIAL_CONTRACT.md"), "content");
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, ".levit/AGENT_CONTRACT.md"), "content");
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, ".levit/AGENT_ONBOARDING.md"), "content");
+    // Create feature without INTENT header
+    const featureWithoutIntent = `---
+id: 001
+status: active
+owner: human
+last_updated: 2026-01-01
+risk_level: low
+depends_on: []
+---
+
+# Some other header
+`;
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(featuresDir, "001-test.md"), featureWithoutIntent);
+    const result = validation_service_1.ValidationService.validate(tempDir);
+    node_assert_1.default.strictEqual(result.valid, false);
+    const structureErrors = result.issues.filter(i => i.code === "INVALID_STRUCTURE");
+    node_assert_1.default.ok(structureErrors.length > 0, "Should report missing INTENT header");
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});
+(0, node_test_1.default)("ValidationService detects decision with invalid frontmatter", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "validation-service-test-"));
+    const decisionsDir = node_path_1.default.join(tempDir, ".levit/decisions");
+    fs_extra_1.default.ensureDirSync(decisionsDir);
+    // Create core structure
+    fs_extra_1.default.ensureDirSync(node_path_1.default.join(tempDir, ".levit", "features"));
+    fs_extra_1.default.ensureDirSync(node_path_1.default.join(tempDir, ".levit", "handoff"));
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, "SOCIAL_CONTRACT.md"), "content");
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, ".levit/AGENT_CONTRACT.md"), "content");
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, ".levit/AGENT_ONBOARDING.md"), "content");
+    // Create decision with invalid YAML
+    const invalidDecision = `---
+id: ADR-001
+status: draft
+owner: human
+last_updated: 2026-01-01
+risk_level: low
+depends_on: [invalid: yaml: syntax]
+---
+
+# ADR 001: Test
+`;
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(decisionsDir, "ADR-001-test.md"), invalidDecision);
+    const result = validation_service_1.ValidationService.validate(tempDir);
+    node_assert_1.default.strictEqual(result.valid, false);
+    const frontmatterErrors = result.issues.filter(i => i.code === "INVALID_FRONTMATTER");
+    node_assert_1.default.ok(frontmatterErrors.length > 0, "Should report invalid YAML");
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});
+(0, node_test_1.default)("ValidationService detects handoff with missing frontmatter", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "validation-service-test-"));
+    const handoffDir = node_path_1.default.join(tempDir, ".levit/handoff");
+    fs_extra_1.default.ensureDirSync(handoffDir);
+    // Create core structure
+    fs_extra_1.default.ensureDirSync(node_path_1.default.join(tempDir, ".levit", "features"));
+    fs_extra_1.default.ensureDirSync(node_path_1.default.join(tempDir, ".levit", "decisions"));
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, "SOCIAL_CONTRACT.md"), "content");
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, ".levit/AGENT_CONTRACT.md"), "content");
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, ".levit/AGENT_ONBOARDING.md"), "content");
+    // Create handoff without frontmatter
+    const handoffWithoutFrontmatter = `# Agent Handoff
+No frontmatter here
+`;
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(handoffDir, "2026-01-01-test.md"), handoffWithoutFrontmatter);
+    const result = validation_service_1.ValidationService.validate(tempDir);
+    node_assert_1.default.strictEqual(result.valid, false);
+    const frontmatterErrors = result.issues.filter(i => i.code === "INVALID_FRONTMATTER");
+    node_assert_1.default.ok(frontmatterErrors.length > 0, "Should report missing frontmatter");
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});
+(0, node_test_1.default)("ValidationService reports warning when no features exist", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "validation-service-test-"));
+    const featuresDir = node_path_1.default.join(tempDir, ".levit", "features");
+    fs_extra_1.default.ensureDirSync(featuresDir);
+    // Create core structure
+    fs_extra_1.default.ensureDirSync(node_path_1.default.join(tempDir, ".levit/decisions"));
+    fs_extra_1.default.ensureDirSync(node_path_1.default.join(tempDir, ".levit/handoff"));
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, "SOCIAL_CONTRACT.md"), "content");
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, ".levit/AGENT_CONTRACT.md"), "content");
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, ".levit/AGENT_ONBOARDING.md"), "content");
+    // No features in features directory
+    const result = validation_service_1.ValidationService.validate(tempDir);
+    node_assert_1.default.strictEqual(result.valid, true, "Should be valid (only warning)");
+    node_assert_1.default.ok(result.metrics.warnings > 0, "Should have warnings");
+    const noFeaturesWarning = result.issues.find(i => i.code === "NO_FEATURES");
+    node_assert_1.default.ok(noFeaturesWarning, "Should report no features warning");
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});
+(0, node_test_1.default)("ValidationService counts files scanned correctly", () => {
+    const tempDir = fs_extra_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "validation-service-test-"));
+    const featuresDir = node_path_1.default.join(tempDir, ".levit", "features");
+    fs_extra_1.default.ensureDirSync(featuresDir);
+    // Create core structure
+    fs_extra_1.default.ensureDirSync(node_path_1.default.join(tempDir, ".levit/decisions"));
+    fs_extra_1.default.ensureDirSync(node_path_1.default.join(tempDir, ".levit/handoff"));
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, "SOCIAL_CONTRACT.md"), "content");
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, ".levit/AGENT_CONTRACT.md"), "content");
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, ".levit/AGENT_ONBOARDING.md"), "content");
+    // Create valid feature
+    const validFeature = `---
+id: 001
+status: active
+owner: human
+last_updated: 2026-01-01
+risk_level: low
+depends_on: []
+---
+
+# INTENT: Test Feature
+`;
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(featuresDir, "001-test.md"), validFeature);
+    // Create valid decision
+    const validDecision = `---
+id: ADR-001
+status: draft
+owner: human
+last_updated: 2026-01-01
+risk_level: low
+depends_on: []
+---
+
+# ADR 001: Test Decision
+`;
+    fs_extra_1.default.writeFileSync(node_path_1.default.join(tempDir, ".levit/decisions", "ADR-001-test.md"), validDecision);
+    const result = validation_service_1.ValidationService.validate(tempDir);
+    node_assert_1.default.strictEqual(result.metrics.filesScanned, 2, "Should scan 2 files (1 feature + 1 decision)");
+    fs_extra_1.default.rmSync(tempDir, { recursive: true, force: true });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buba_71/levit",
-  "version": "0.3.4",
+  "version": "0.8.2",
   "description": "Hybrid starter kit for Antigravity projects",
   "author": "David BUBA",
   "license": "MIT",
@@ -19,14 +19,19 @@
   "main": "dist/src/init.js",
   "scripts": {
     "build": "tsc && chmod +x dist/bin/cli.js",
+    "prepublishOnly": "npm run build",
     "start": "node dist/bin/cli.js",
     "test": "npm run build && node --test dist/tests"
   },
   "dependencies": {
-    "fs-extra": "^11.2.0"
+    "fs-extra": "^11.2.0",
+    "js-yaml": "^4.1.1",
+    "chalk": "^4.1.2",
+    "cli-table3": "^0.6.5"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.11.0",
     "typescript": "^5.3.0"
   }

package/templates/default/.github/workflows/README.md

@@ -0,0 +1,56 @@
+# GitHub Actions Workflows
+
+This directory contains CI/CD workflows for levit-kit projects.
+
+## Available Workflows
+
+### `levit-validate.yml`
+
+Validates the levit-kit project structure on every push and pull request.
+
+**What it does**:
+- Runs `levit validate` to check project structure
+- Fails the build if validation errors are found
+- Uploads validation results as artifacts
+- Displays results in GitHub Actions summary
+
+**When it runs**:
+- On pushes to `main`, `master`, or `develop` branches
+- On pull requests targeting these branches
+
+**How to use**:
+1. This workflow is automatically included in levit-kit projects
+2. No configuration needed - it works out of the box
+3. Customize the `on:` section if you use different branch names
+
+**Customization**:
+Edit `.github/workflows/levit-validate.yml` to:
+- Change branch names
+- Add additional validation steps
+- Integrate with other workflows
+- Add notifications
+
+## Adding Custom Workflows
+
+You can add additional workflows for:
+- Feature status checks
+- Decision record validation
+- Handoff completeness checks
+- Custom evals
+
+Example structure:
+```yaml
+name: Custom Validation
+on: [push, pull_request]
+jobs:
+  custom-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - run: your-custom-script.sh
+```
+
+---
+
+*For more information, see the [levit-kit documentation](https://github.com/buba71/levit-kit).*
+

package/templates/default/.github/workflows/levit-validate.yml

@@ -0,0 +1,93 @@
+name: Validate Levit Project
+
+on:
+  push:
+    branches: [ main, master, develop ]
+  pull_request:
+    branches: [ main, master, develop ]
+
+jobs:
+  validate:
+    name: Validate levit-kit Structure
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+      
+      - name: Validate levit-kit structure
+        id: validate
+        run: |
+          npx @buba_71/levit validate --json > validation.json 2>&1 || VALIDATION_EXIT=$?
+          if [ -n "$VALIDATION_EXIT" ]; then
+            echo "validation_failed=true" >> $GITHUB_OUTPUT
+          else
+            echo "validation_failed=false" >> $GITHUB_OUTPUT
+          fi
+      
+      - name: Display validation results
+        if: always()
+        run: |
+          if [ -f validation.json ]; then
+            echo "## Validation Results" >> $GITHUB_STEP_SUMMARY
+            echo '```json' >> $GITHUB_STEP_SUMMARY
+            cat validation.json >> $GITHUB_STEP_SUMMARY
+            echo '```' >> $GITHUB_STEP_SUMMARY
+            
+            # Check for errors in JSON output
+            ERRORS=$(node -e "
+              try {
+                const fs = require('fs');
+                const content = fs.readFileSync('validation.json', 'utf8');
+                const lines = content.split('\\n').filter(l => l.trim());
+                let errorCount = 0;
+                for (const line of lines) {
+                  try {
+                    const obj = JSON.parse(line);
+                    // Check for ERROR level or validation failure messages
+                    if (obj.level === 'ERROR' || 
+                        (obj.message && (
+                          obj.message.toLowerCase().includes('error') ||
+                          obj.message.toLowerCase().includes('validation failed') ||
+                          obj.message.toLowerCase().includes('failed')
+                        ))) {
+                      errorCount++;
+                    }
+                  } catch (e) {
+                    // Non-JSON lines might be error messages
+                    if (line.toLowerCase().includes('error') || line.toLowerCase().includes('failed')) {
+                      errorCount++;
+                    }
+                  }
+                }
+                console.log(errorCount);
+              } catch (e) {
+                console.log('0');
+              }
+            " || echo "0")
+            
+            if [ "$ERRORS" -gt 0 ] || [ "${{ steps.validate.outputs.validation_failed }}" == "true" ]; then
+              echo "❌ Validation failed"
+              exit 1
+            else
+              echo "✅ Validation passed"
+            fi
+          else
+            echo "⚠️ No validation output found"
+            exit 1
+          fi
+      
+      - name: Upload validation results
+        if: always()
+        uses: actions/upload-artifact@v3
+        with:
+          name: validation-results
+          path: validation.json
+          if-no-files-found: ignore
+