vonosan-cli 0.1.0

package/dist/header-generator.d.ts

@@ -0,0 +1,34 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+/**
+ * Generates the Bonifade Technologies file header comment string.
+ *
+ * @param _filePath - reserved for future per-file metadata (unused today)
+ */
+export declare function generateHeader(_filePath: string): string;
+/**
+ * Returns `true` when the file content already contains the Bonifade header.
+ */
+export declare function hasHeader(content: string): boolean;
+/**
+ * Injects the Bonifade header at the top of `content` if it is missing.
+ * Preserves all existing content unchanged.
+ *
+ * @param filePath - path used to generate the header (passed to generateHeader)
+ * @param content  - current file content
+ * @returns the (possibly modified) file content
+ */
+export declare function injectHeader(filePath: string, content: string): string;
+/**
+ * Reads a file from disk, injects the header if missing, and writes it back.
+ * Returns `true` when the file was modified, `false` when it already had a header.
+ */
+export declare function fixHeaderInFile(filePath: string): boolean;
+//# sourceMappingURL=header-generator.d.ts.map

package/dist/header-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-generator.d.ts","sourceRoot":"","sources":["../src/header-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAaxD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAWtE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMzD"}

package/dist/header-generator.js

@@ -0,0 +1,77 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+/** The canonical header marker — used to detect existing headers */
+const HEADER_MARKER = '🏢 Company Name: Bonifade Technologies';
+/**
+ * Returns today's date as YYYY-MM-DD.
+ */
+function today() {
+    return new Date().toISOString().slice(0, 10);
+}
+/**
+ * Generates the Bonifade Technologies file header comment string.
+ *
+ * @param _filePath - reserved for future per-file metadata (unused today)
+ */
+export function generateHeader(_filePath) {
+    const date = today();
+    return [
+        '/**',
+        ' * ──────────────────────────────────────────────────────────────────',
+        ' * 🏢 Company Name: Bonifade Technologies',
+        ' * 👨‍💻 Developer: Bowofade Oyerinde',
+        ' * 🐙 GitHub: oyenet1',
+        ` * 📅 Created Date: ${date}`,
+        ` * 🔄 Updated Date: ${date}`,
+        ' * ──────────────────────────────────────────────────────────────────',
+        ' */',
+    ].join('\n');
+}
+/**
+ * Returns `true` when the file content already contains the Bonifade header.
+ */
+export function hasHeader(content) {
+    return content.includes(HEADER_MARKER);
+}
+/**
+ * Injects the Bonifade header at the top of `content` if it is missing.
+ * Preserves all existing content unchanged.
+ *
+ * @param filePath - path used to generate the header (passed to generateHeader)
+ * @param content  - current file content
+ * @returns the (possibly modified) file content
+ */
+export function injectHeader(filePath, content) {
+    if (hasHeader(content))
+        return content;
+    const header = generateHeader(filePath);
+    // Preserve a leading shebang line if present
+    if (content.startsWith('#!')) {
+        const newlineIdx = content.indexOf('\n');
+        const shebang = content.slice(0, newlineIdx + 1);
+        const rest = content.slice(newlineIdx + 1);
+        return `${shebang}${header}\n\n${rest}`;
+    }
+    return `${header}\n\n${content}`;
+}
+/**
+ * Reads a file from disk, injects the header if missing, and writes it back.
+ * Returns `true` when the file was modified, `false` when it already had a header.
+ */
+export function fixHeaderInFile(filePath) {
+    const original = readFileSync(filePath, 'utf8');
+    const updated = injectHeader(filePath, original);
+    if (updated === original)
+        return false;
+    writeFileSync(filePath, updated, 'utf8');
+    return true;
+}
+//# sourceMappingURL=header-generator.js.map

package/dist/header-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-generator.js","sourceRoot":"","sources":["../src/header-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAErD,oEAAoE;AACpE,MAAM,aAAa,GAAG,wCAAwC,CAAA;AAE9D;;GAEG;AACH,SAAS,KAAK;IACZ,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,MAAM,IAAI,GAAG,KAAK,EAAE,CAAA;IACpB,OAAO;QACL,KAAK;QACL,uEAAuE;QACvE,2CAA2C;QAC3C,uCAAuC;QACvC,uBAAuB;QACvB,uBAAuB,IAAI,EAAE;QAC7B,uBAAuB,IAAI,EAAE;QAC7B,uEAAuE;QACvE,KAAK;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAA;AACxC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,OAAe;IAC5D,IAAI,SAAS,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAA;IACtC,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;IACvC,6CAA6C;IAC7C,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACxC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAAA;QAChD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAA;QAC1C,OAAO,GAAG,OAAO,GAAG,MAAM,OAAO,IAAI,EAAE,CAAA;IACzC,CAAC;IACD,OAAO,GAAG,MAAM,OAAO,OAAO,EAAE,CAAA;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC/C,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAChD,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACtC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;IACxC,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+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":";AAEA;;;;;;;;GAQG"}

package/dist/index.js

@@ -0,0 +1,177 @@
+#!/usr/bin/env node
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+/**
+ * @vonosan/cli — Artisan-style CLI for the Vonosan framework.
+ *
+ * Command router: maps `vonosan <command>` to the appropriate handler.
+ */
+import { runLint } from './commands/lint.js';
+import { runFixHeaders } from './commands/fix-headers.js';
+import { runFixLogs } from './commands/fix-logs.js';
+import { runAudit } from './commands/audit.js';
+import { runEnvAdd } from './commands/env-add.js';
+import { runBranchNew } from './commands/branch-new.js';
+import { runBranchFinish } from './commands/branch-finish.js';
+import { runCommit } from './commands/commit.js';
+import { runMigrateRun, runMigrateRollback, runMigrateStatus, runMigrateReset, runMigrateFresh, runMigrateMake, } from './commands/migrate.js';
+import { runDbPush, runDbStudio, runDbSeed } from './commands/db.js';
+import { runSchemaSync } from './commands/schema-sync.js';
+import { runMakeModule, runMakeVersion, runMakeService, runMakeController, runMakeDto, runMakeRoutes, runMakeSchema, runMakeMiddleware, runMakePage, runMakeComponent, runMakeComposable, runMakeStore, runMakeMigration, runMakeSeed, runMakeTest, runMakeNotification, runMakeResource, runMakePolicy, runMakeJob, runMakeEmail, runMakeHelper, } from './commands/make.js';
+import { runAdd } from './commands/add.js';
+import { runJobsRun } from './commands/jobs.js';
+import { runUpgradeCheck, runUpgradeApply } from './commands/upgrade.js';
+import { runTest, runTestClean } from './commands/test.js';
+const COMMANDS = {
+    // Linting & auditing
+    lint: runLint,
+    'fix:headers': runFixHeaders,
+    'fix:logs': runFixLogs,
+    audit: runAudit,
+    // Environment
+    'env:add': runEnvAdd,
+    // Git automation
+    'branch:new': runBranchNew,
+    'branch:finish': runBranchFinish,
+    commit: runCommit,
+    // Migrations
+    'migrate:run': runMigrateRun,
+    'migrate:rollback': runMigrateRollback,
+    'migrate:status': runMigrateStatus,
+    'migrate:reset': runMigrateReset,
+    'migrate:fresh': runMigrateFresh,
+    'migrate:make': runMigrateMake,
+    // Database
+    'db:push': runDbPush,
+    'db:studio': runDbStudio,
+    'db:seed': runDbSeed,
+    // Schema
+    'schema:sync': runSchemaSync,
+    // Code generators
+    'make:module': runMakeModule,
+    'make:version': runMakeVersion,
+    'make:service': runMakeService,
+    'make:controller': runMakeController,
+    'make:dto': runMakeDto,
+    'make:routes': runMakeRoutes,
+    'make:schema': runMakeSchema,
+    'make:middleware': runMakeMiddleware,
+    'make:page': runMakePage,
+    'make:component': runMakeComponent,
+    'make:composable': runMakeComposable,
+    'make:store': runMakeStore,
+    'make:migration': runMakeMigration,
+    'make:seed': runMakeSeed,
+    'make:test': runMakeTest,
+    'make:notification': runMakeNotification,
+    'make:resource': runMakeResource,
+    'make:policy': runMakePolicy,
+    'make:job': runMakeJob,
+    'make:email': runMakeEmail,
+    'make:helper': runMakeHelper,
+    // Module installer
+    add: runAdd,
+    // Jobs
+    'jobs:run': runJobsRun,
+    // Upgrade
+    'upgrade:check': runUpgradeCheck,
+    'upgrade:apply-codemods': runUpgradeApply,
+    // Test
+    test: runTest,
+    'test:clean': runTestClean,
+};
+// ─── Help text ────────────────────────────────────────────────────────────────
+function printHelp() {
+    process.stdout.write(`
+\x1b[1mVono CLI\x1b[0m — Artisan-style tooling for the Vonosan framework
+
+\x1b[33mUsage:\x1b[0m  vonosan <command> [args] [options]
+
+\x1b[33mLinting & Auditing:\x1b[0m
+  vonosan lint [src]              Scan for header, log, naming, versioning, DRY violations
+  vonosan fix:headers [src]       Inject missing Bonifade headers
+  vonosan fix:logs [src]          Replace console.* with Logger.*
+  vonosan audit [--fix]           Full audit; exits 0 (clean) or 1 (violations)
+
+\x1b[33mEnvironment:\x1b[0m
+  vonosan env:add <KEY> [desc]    Append key to .env and .env.example
+
+\x1b[33mGit Automation:\x1b[0m
+  vonosan branch:new <name>       Create feature/<name> branch
+  vonosan branch:finish           Merge feature branch into parent
+  vonosan commit "<message>"      Validate Conventional Commits and commit
+
+\x1b[33mMigrations:\x1b[0m
+  vonosan migrate:run             Apply pending migrations
+  vonosan migrate:rollback        Roll back last migration
+  vonosan migrate:status          Show migration status
+  vonosan migrate:reset           Rollback all, then re-run
+  vonosan migrate:fresh [--seed]  Drop all, re-run, optionally seed
+  vonosan migrate:make <name>     Sync schema barrel + generate migration
+
+\x1b[33mDatabase:\x1b[0m
+  vonosan db:push                 Push schema to DB (no migration file)
+  vonosan db:studio               Open Drizzle Studio
+  vonosan db:seed [name]          Run seed files
+
+\x1b[33mSchema:\x1b[0m
+  vonosan schema:sync             Regenerate src/db/schema.ts barrel
+
+\x1b[33mCode Generators:\x1b[0m
+  vonosan make:module <name>      Generate full module scaffold
+  vonosan make:version <v>        Generate new API version namespace
+  vonosan make:service <name>     Generate service file
+  vonosan make:controller <name>  Generate controller file
+  vonosan make:dto <name>         Generate DTO + Zod schema
+  vonosan make:routes <name>      Generate routes file
+  vonosan make:schema <name>      Generate Drizzle schema
+  vonosan make:middleware <name>  Generate middleware
+  vonosan make:page <m/Page>      Generate .page.vue
+  vonosan make:component <m/C>    Generate Vue component
+  vonosan make:composable <m/use> Generate composable
+  vonosan make:store <name>       Generate Pinia store
+  vonosan make:migration <name>   Generate SQL migration file
+  vonosan make:seed <name>        Generate seed file
+  vonosan make:test <name>        Generate test file
+  vonosan make:notification <n>   Generate notification
+  vonosan make:resource <name>    Generate resource transformer
+  vonosan make:policy <name>      Generate policy class
+  vonosan make:job <name>         Generate cron job
+  vonosan make:email <name>       Generate email template
+  vonosan make:helper <name>      Generate shared helper
+
+\x1b[33mModule Installer:\x1b[0m
+  vonosan add <module>            Install @vonosan/<module> and update config
+  vonosan add <module> --eject    Copy module source into src/modules/<module>/
+
+\x1b[33mJobs:\x1b[0m
+  vonosan jobs:run <name>         Execute a named cron job immediately
+`);
+}
+// ─── Entry point ─────────────────────────────────────────────────────────────
+async function main() {
+    const [, , command, ...args] = process.argv;
+    if (!command || command === '--help' || command === '-h' || command === 'help') {
+        printHelp();
+        return;
+    }
+    const handler = COMMANDS[command];
+    if (!handler) {
+        process.stderr.write(`\x1b[31mUnknown command: "${command}"\x1b[0m\n`);
+        process.stderr.write(`Run \x1b[1mvono --help\x1b[0m to see available commands.\n`);
+        process.exit(1);
+    }
+    await handler(args);
+}
+main().catch((err) => {
+    process.stderr.write(`\x1b[31mFatal error: ${String(err)}\x1b[0m\n`);
+    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/linter/env-parity.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+export interface EnvParityResult {
+    /** Keys present in .env but missing from .env.example */
+    missingInExample: string[];
+    /** Keys present in .env.example but missing from .env */
+    missingInEnv: string[];
+}
+/**
+ * Parses an env file and returns the set of defined keys.
+ * Ignores blank lines and comment lines (starting with #).
+ */
+export declare function parseEnvKeys(content: string): Set<string>;
+/**
+ * Compares `.env` and `.env.example` keys in `projectRoot`.
+ *
+ * Returns lists of keys missing from each file.
+ * If `.env` does not exist, returns empty lists (no error — per Requirement 8.4).
+ */
+export declare function checkEnvParity(projectRoot: string): EnvParityResult;
+//# sourceMappingURL=env-parity.d.ts.map

package/dist/linter/env-parity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-parity.d.ts","sourceRoot":"","sources":["../../src/linter/env-parity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,yDAAyD;IACzD,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAWzD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAwBnE"}

package/dist/linter/env-parity.js

@@ -0,0 +1,59 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Parses an env file and returns the set of defined keys.
+ * Ignores blank lines and comment lines (starting with #).
+ */
+export function parseEnvKeys(content) {
+    const keys = new Set();
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eqIdx = trimmed.indexOf('=');
+        if (eqIdx === -1)
+            continue;
+        const key = trimmed.slice(0, eqIdx).trim();
+        if (key)
+            keys.add(key);
+    }
+    return keys;
+}
+/**
+ * Compares `.env` and `.env.example` keys in `projectRoot`.
+ *
+ * Returns lists of keys missing from each file.
+ * If `.env` does not exist, returns empty lists (no error — per Requirement 8.4).
+ */
+export function checkEnvParity(projectRoot) {
+    const envPath = join(projectRoot, '.env');
+    const examplePath = join(projectRoot, '.env.example');
+    if (!existsSync(envPath)) {
+        return { missingInExample: [], missingInEnv: [] };
+    }
+    const envKeys = parseEnvKeys(readFileSync(envPath, 'utf8'));
+    const exampleKeys = existsSync(examplePath)
+        ? parseEnvKeys(readFileSync(examplePath, 'utf8'))
+        : new Set();
+    const missingInExample = [];
+    const missingInEnv = [];
+    for (const key of envKeys) {
+        if (!exampleKeys.has(key))
+            missingInExample.push(key);
+    }
+    for (const key of exampleKeys) {
+        if (!envKeys.has(key))
+            missingInEnv.push(key);
+    }
+    return { missingInExample, missingInEnv };
+}
+//# sourceMappingURL=env-parity.js.map

package/dist/linter/env-parity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-parity.js","sourceRoot":"","sources":["../../src/linter/env-parity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAShC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAC3B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAQ;QACjD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAClC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,SAAQ;QAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAA;QAC1C,IAAI,GAAG;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACxB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAA;IAErD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAA;IACnD,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;IAC3D,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QACzC,CAAC,CAAC,YAAY,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACjD,CAAC,CAAC,IAAI,GAAG,EAAU,CAAA;IAErB,MAAM,gBAAgB,GAAa,EAAE,CAAA;IACrC,MAAM,YAAY,GAAa,EAAE,CAAA;IAEjC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACvD,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC/C,CAAC;IAED,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,CAAA;AAC3C,CAAC"}

package/dist/linter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+export type LintRule = 'header-missing' | 'console-log' | 'naming-snake-case-response' | 'versioning-missing-prefix' | 'dry-violation';
+export interface LintResult {
+    file: string;
+    line: number;
+    rule: LintRule;
+    message: string;
+}
+/**
+ * Scans all `.ts` and `.vue` files under `srcDir` and returns all lint violations.
+ *
+ * @param srcDir - absolute or relative path to the project's `src/` directory
+ */
+export declare function lintProject(srcDir: string): Promise<LintResult[]>;
+//# sourceMappingURL=linter.d.ts.map

package/dist/linter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../src/linter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,MAAM,MAAM,QAAQ,GAChB,gBAAgB,GAChB,aAAa,GACb,4BAA4B,GAC5B,2BAA2B,GAC3B,eAAe,CAAA;AAEnB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAsLD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAwBvE"}

package/dist/linter.js

@@ -0,0 +1,207 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { readFileSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import fg from 'fast-glob';
+import { hasHeader } from './header-generator.js';
+// ─── Individual rule checkers ─────────────────────────────────────────────────
+/**
+ * Rule: every .ts / .vue file must start with the Bonifade header.
+ */
+function checkHeader(filePath, content) {
+    if (hasHeader(content))
+        return [];
+    return [
+        {
+            file: filePath,
+            line: 1,
+            rule: 'header-missing',
+            message: `Missing Bonifade Technologies file header. Run \`vonosan fix:headers\` to auto-fix.`,
+        },
+    ];
+}
+/**
+ * Rule: no raw console.log / console.warn / console.error / console.debug.
+ * Files containing `// @vonosan-ignore-logs` are skipped entirely.
+ */
+function checkConsoleLogs(filePath, content) {
+    if (content.includes('// @vonosan-ignore-logs'))
+        return [];
+    const results = [];
+    const lines = content.split('\n');
+    const consoleRe = /\bconsole\.(log|warn|error|debug|info)\s*\(/;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Skip the logger.ts file itself — it is the ONE allowed place
+        if (filePath.includes('logger.ts'))
+            continue;
+        if (consoleRe.test(line)) {
+            const match = line.match(consoleRe);
+            results.push({
+                file: filePath,
+                line: i + 1,
+                rule: 'console-log',
+                message: `Raw \`console.${match[1]}()\` detected. Use \`Logger.${match[1]}()\` from vonosan/server instead.`,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Rule: API response objects must not contain snake_case keys.
+ * Heuristic: looks for `{ some_key:` patterns inside return statements in
+ * controller / service files.
+ */
+function checkNamingConventions(filePath, content) {
+    // Only check controller / service files
+    if (!filePath.match(/\.(controller|service)\.ts$/))
+        return [];
+    const results = [];
+    const lines = content.split('\n');
+    // Matches object literal keys that are snake_case (contain underscore)
+    const snakeCaseKeyRe = /\b([a-z][a-z0-9]*(?:_[a-z0-9]+)+)\s*:/;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const match = line.match(snakeCaseKeyRe);
+        if (match) {
+            results.push({
+                file: filePath,
+                line: i + 1,
+                rule: 'naming-snake-case-response',
+                message: `API response key \`${match[1]}\` uses snake_case. Convert to camelCase using \`toCamel()\`.`,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Rule: all routes must be nested under a versioned prefix like /api/v1/.
+ * Only checks *.routes.ts files.
+ */
+function checkVersioning(filePath, content) {
+    if (!filePath.endsWith('.routes.ts'))
+        return [];
+    const results = [];
+    const lines = content.split('\n');
+    // Matches route definitions that start with a path not under /api/v<n>
+    // e.g. app.get('/users', ...) — missing /api/v1 prefix
+    const routeDefRe = /\.(get|post|put|patch|delete|all)\s*\(\s*['"`](\/[^'"`]*)/;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const match = line.match(routeDefRe);
+        if (match) {
+            const path = match[2];
+            if (!path.match(/^\/api\/v\d+/)) {
+                results.push({
+                    file: filePath,
+                    line: i + 1,
+                    rule: 'versioning-missing-prefix',
+                    message: `Route \`${path}\` is not nested under a versioned prefix (e.g. /api/v1/). All routes must be versioned.`,
+                });
+            }
+        }
+    }
+    return results;
+}
+// ─── DRY violation detector ───────────────────────────────────────────────────
+/**
+ * Extracts function bodies from a TypeScript file.
+ * Returns a map of normalised body → list of { file, line }.
+ */
+function extractFunctionBodies(filePath, content) {
+    const bodies = new Map();
+    const lines = content.split('\n');
+    // Simple heuristic: find `function` or arrow function declarations and
+    // capture the block body between matching braces.
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (/\bfunction\b|\=\s*\(.*\)\s*=>/.test(line) && line.includes('{')) {
+            // Collect body until matching closing brace
+            let depth = 0;
+            let body = '';
+            for (let j = i; j < lines.length; j++) {
+                for (const ch of lines[j]) {
+                    if (ch === '{')
+                        depth++;
+                    else if (ch === '}')
+                        depth--;
+                }
+                body += lines[j] + '\n';
+                if (depth === 0 && j > i)
+                    break;
+            }
+            // Normalise whitespace for comparison
+            const normalised = body.replace(/\s+/g, ' ').trim();
+            if (normalised.length > 40) {
+                // Only flag non-trivial bodies
+                bodies.set(normalised, i + 1);
+            }
+        }
+    }
+    return bodies;
+}
+/**
+ * Rule: identical function bodies in 2+ module files = DRY violation.
+ */
+function checkDryViolations(files) {
+    // Map: normalised body → list of { file, line }
+    const bodyMap = new Map();
+    for (const { path: filePath, content } of files) {
+        // Only check module files
+        if (!filePath.includes('/modules/'))
+            continue;
+        const bodies = extractFunctionBodies(filePath, content);
+        for (const [body, line] of bodies) {
+            const existing = bodyMap.get(body) ?? [];
+            existing.push({ file: filePath, line });
+            bodyMap.set(body, existing);
+        }
+    }
+    const results = [];
+    for (const [, occurrences] of bodyMap) {
+        if (occurrences.length >= 2) {
+            for (const { file, line } of occurrences) {
+                results.push({
+                    file,
+                    line,
+                    rule: 'dry-violation',
+                    message: `Identical function body found in ${occurrences.length} files. Extract to a shared utility in src/shared/utils/.`,
+                });
+            }
+        }
+    }
+    return results;
+}
+// ─── Main linter entry point ──────────────────────────────────────────────────
+/**
+ * Scans all `.ts` and `.vue` files under `srcDir` and returns all lint violations.
+ *
+ * @param srcDir - absolute or relative path to the project's `src/` directory
+ */
+export async function lintProject(srcDir) {
+    const pattern = join(srcDir, '**/*.{ts,vue}').replace(/\\/g, '/');
+    const filePaths = await fg(pattern, { absolute: true, ignore: ['**/node_modules/**', '**/dist/**'] });
+    const fileContents = [];
+    for (const filePath of filePaths) {
+        const content = readFileSync(filePath, 'utf8');
+        fileContents.push({ path: relative(process.cwd(), filePath), content });
+    }
+    const results = [];
+    for (const { path: filePath, content } of fileContents) {
+        results.push(...checkHeader(filePath, content));
+        results.push(...checkConsoleLogs(filePath, content));
+        results.push(...checkNamingConventions(filePath, content));
+        results.push(...checkVersioning(filePath, content));
+    }
+    // DRY check needs all files at once
+    results.push(...checkDryViolations(fileContents));
+    return results;
+}
+//# sourceMappingURL=linter.js.map