@dinyangetoh/codeplug-cli 0.1.0

package/dist/models/ModelRegistry.js

@@ -0,0 +1,76 @@
+const MODEL_REGISTRY = {
+    classifier: {
+        default: {
+            huggingFaceId: 'microsoft/codebert-base',
+            dtype: 'q8',
+            sizeEstimateMb: 130,
+            description: 'CodeBERT-base for code pattern classification',
+        },
+        lite: {
+            huggingFaceId: 'huggingface/CodeBERTa-small-v1',
+            dtype: 'q8',
+            sizeEstimateMb: 35,
+            description: 'CodeBERTa-small for lightweight classification',
+        },
+    },
+    summarizer: {
+        default: {
+            huggingFaceId: 'facebook/bart-large-cnn',
+            dtype: 'q4',
+            sizeEstimateMb: 800,
+            description: 'BART-large-CNN for abstractive summarization',
+        },
+        lite: {
+            huggingFaceId: 'sshleifer/distilbart-cnn-6-6',
+            dtype: 'q4',
+            sizeEstimateMb: 284,
+            description: 'DistilBART for lightweight summarization',
+        },
+    },
+    extractor: {
+        default: {
+            huggingFaceId: 'distilbert-base-cased-distilled-squad',
+            dtype: 'q8',
+            sizeEstimateMb: 66,
+            description: 'DistilBERT for Q&A extraction',
+        },
+        lite: {
+            huggingFaceId: 'distilbert-base-cased-distilled-squad',
+            dtype: 'q8',
+            sizeEstimateMb: 66,
+            description: 'DistilBERT for Q&A extraction (same in both tiers)',
+        },
+    },
+    ner: {
+        default: {
+            huggingFaceId: 'dslim/bert-base-NER',
+            dtype: 'q8',
+            sizeEstimateMb: 110,
+            description: 'BERT-base-NER for entity recognition',
+        },
+        lite: {
+            huggingFaceId: 'dslim/distilbert-NER',
+            dtype: 'q8',
+            sizeEstimateMb: 35,
+            description: 'DistilBERT-NER for lightweight entity recognition',
+        },
+    },
+};
+export function getModelSpec(role, tier) {
+    return MODEL_REGISTRY[role][tier];
+}
+export function getAllModelSpecs(tier) {
+    const result = {};
+    for (const role of Object.keys(MODEL_REGISTRY)) {
+        result[role] = MODEL_REGISTRY[role][tier];
+    }
+    return result;
+}
+export function getTotalDiskEstimate(tier) {
+    let total = 0;
+    for (const role of Object.keys(MODEL_REGISTRY)) {
+        total += MODEL_REGISTRY[role][tier].sizeEstimateMb;
+    }
+    return total;
+}
+//# sourceMappingURL=ModelRegistry.js.map

package/dist/models/ModelRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelRegistry.js","sourceRoot":"","sources":["../../src/models/ModelRegistry.ts"],"names":[],"mappings":"AAWA,MAAM,cAAc,GAAoD;IACtE,UAAU,EAAE;QACV,OAAO,EAAE;YACP,aAAa,EAAE,yBAAyB;YACxC,KAAK,EAAE,IAAI;YACX,cAAc,EAAE,GAAG;YACnB,WAAW,EAAE,+CAA+C;SAC7D;QACD,IAAI,EAAE;YACJ,aAAa,EAAE,gCAAgC;YAC/C,KAAK,EAAE,IAAI;YACX,cAAc,EAAE,EAAE;YAClB,WAAW,EAAE,gDAAgD;SAC9D;KACF;IACD,UAAU,EAAE;QACV,OAAO,EAAE;YACP,aAAa,EAAE,yBAAyB;YACxC,KAAK,EAAE,IAAI;YACX,cAAc,EAAE,GAAG;YACnB,WAAW,EAAE,8CAA8C;SAC5D;QACD,IAAI,EAAE;YACJ,aAAa,EAAE,8BAA8B;YAC7C,KAAK,EAAE,IAAI;YACX,cAAc,EAAE,GAAG;YACnB,WAAW,EAAE,0CAA0C;SACxD;KACF;IACD,SAAS,EAAE;QACT,OAAO,EAAE;YACP,aAAa,EAAE,uCAAuC;YACtD,KAAK,EAAE,IAAI;YACX,cAAc,EAAE,EAAE;YAClB,WAAW,EAAE,+BAA+B;SAC7C;QACD,IAAI,EAAE;YACJ,aAAa,EAAE,uCAAuC;YACtD,KAAK,EAAE,IAAI;YACX,cAAc,EAAE,EAAE;YAClB,WAAW,EAAE,oDAAoD;SAClE;KACF;IACD,GAAG,EAAE;QACH,OAAO,EAAE;YACP,aAAa,EAAE,qBAAqB;YACpC,KAAK,EAAE,IAAI;YACX,cAAc,EAAE,GAAG;YACnB,WAAW,EAAE,sCAAsC;SACpD;QACD,IAAI,EAAE;YACJ,aAAa,EAAE,sBAAsB;YACrC,KAAK,EAAE,IAAI;YACX,cAAc,EAAE,EAAE;YAClB,WAAW,EAAE,mDAAmD;SACjE;KACF;CACF,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,IAAe,EAAE,IAAe;IAC3D,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAe;IAC9C,MAAM,MAAM,GAAG,EAAkC,CAAC;IAClD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAgB,EAAE,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAe;IAClD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAgB,EAAE,CAAC;QAC9D,KAAK,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC;IACrD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/storage/ConventionStore.d.ts

@@ -0,0 +1,11 @@
+import type { Convention } from '../config/types.js';
+export declare class ConventionStore {
+    private projectRoot;
+    private filePath;
+    private dirPath;
+    constructor(projectRoot: string);
+    exists(): Promise<boolean>;
+    load(): Promise<Convention[]>;
+    save(conventions: Convention[]): Promise<void>;
+}
+//# sourceMappingURL=ConventionStore.d.ts.map

package/dist/storage/ConventionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConventionStore.d.ts","sourceRoot":"","sources":["../../src/storage/ConventionStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,oBAAoB,CAAC;AAItE,qBAAa,eAAe;IAId,OAAO,CAAC,WAAW;IAH/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEJ,WAAW,EAAE,MAAM;IAKjC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAI1B,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAM7B,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAerD"}

package/dist/storage/ConventionStore.js

@@ -0,0 +1,37 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { conventionsFileSchema } from '../config/ConventionSchema.js';
+import { CODEPLUG_DIR, CONVENTIONS_FILE } from '../config/defaults.js';
+export class ConventionStore {
+    projectRoot;
+    filePath;
+    dirPath;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+        this.dirPath = join(projectRoot, CODEPLUG_DIR);
+        this.filePath = join(this.dirPath, CONVENTIONS_FILE);
+    }
+    async exists() {
+        return existsSync(this.filePath);
+    }
+    async load() {
+        const raw = await readFile(this.filePath, 'utf-8');
+        const parsed = conventionsFileSchema.parse(JSON.parse(raw));
+        return parsed.conventions;
+    }
+    async save(conventions) {
+        if (!existsSync(this.dirPath)) {
+            await mkdir(this.dirPath, { recursive: true });
+        }
+        const now = new Date().toISOString();
+        const file = {
+            version: '1.0',
+            created: now,
+            updated: now,
+            conventions,
+        };
+        await writeFile(this.filePath, JSON.stringify(file, null, 2), 'utf-8');
+    }
+}
+//# sourceMappingURL=ConventionStore.js.map

package/dist/storage/ConventionStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConventionStore.js","sourceRoot":"","sources":["../../src/storage/ConventionStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEvE,MAAM,OAAO,eAAe;IAIN;IAHZ,QAAQ,CAAS;IACjB,OAAO,CAAS;IAExB,YAAoB,WAAmB;QAAnB,gBAAW,GAAX,WAAW,CAAQ;QACrC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,OAAO,MAAM,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,WAAyB;QAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,GAAoB;YAC5B,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,GAAG;YACZ,WAAW;SACZ,CAAC;QAEF,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;CACF"}

package/dist/storage/ScoreStore.d.ts

@@ -0,0 +1,18 @@
+import type { ScoreRecord } from '../config/types.js';
+export declare class ScoreStore {
+    private projectRoot;
+    private dbPath;
+    private dirPath;
+    private db;
+    constructor(projectRoot: string);
+    private getDb;
+    private persist;
+    save(record: ScoreRecord): Promise<void>;
+    getLatest(): Promise<ScoreRecord | null>;
+    getHistory(weeks: number): Promise<ScoreRecord[]>;
+    printTrend(): Promise<void>;
+    private rowToRecord;
+    private objectToRecord;
+    close(): void;
+}
+//# sourceMappingURL=ScoreStore.d.ts.map

package/dist/storage/ScoreStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScoreStore.d.ts","sourceRoot":"","sources":["../../src/storage/ScoreStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA4BtD,qBAAa,UAAU;IAKT,OAAO,CAAC,WAAW;IAJ/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,EAAE,CAAwB;gBAEd,WAAW,EAAE,MAAM;YAKzB,KAAK;YAiBL,OAAO;IAWf,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IASxC,SAAS,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAOxC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAkBjD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBjC,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,cAAc;IAUtB,KAAK,IAAI,IAAI;CAMd"}

package/dist/storage/ScoreStore.js

@@ -0,0 +1,112 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { CODEPLUG_DIR, SCORE_DB_FILE } from '../config/defaults.js';
+const CREATE_TABLE_SQL = `
+  CREATE TABLE IF NOT EXISTS scores (
+    id TEXT PRIMARY KEY,
+    project_hash TEXT,
+    score INTEGER,
+    breakdown_json TEXT,
+    created_at TEXT
+  )
+`;
+export class ScoreStore {
+    projectRoot;
+    dbPath;
+    dirPath;
+    db = null;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+        this.dirPath = join(projectRoot, CODEPLUG_DIR);
+        this.dbPath = join(this.dirPath, SCORE_DB_FILE);
+    }
+    async getDb() {
+        if (this.db)
+            return this.db;
+        const initSqlJs = (await import('sql.js')).default;
+        const SQL = await initSqlJs();
+        if (existsSync(this.dbPath)) {
+            const buffer = await readFile(this.dbPath);
+            this.db = new SQL.Database(buffer);
+        }
+        else {
+            this.db = new SQL.Database();
+        }
+        this.db.run(CREATE_TABLE_SQL);
+        return this.db;
+    }
+    async persist() {
+        if (!this.db)
+            return;
+        if (!existsSync(this.dirPath)) {
+            await mkdir(this.dirPath, { recursive: true });
+        }
+        const data = this.db.export();
+        await writeFile(this.dbPath, Buffer.from(data));
+    }
+    async save(record) {
+        const db = await this.getDb();
+        db.run('INSERT OR REPLACE INTO scores (id, project_hash, score, breakdown_json, created_at) VALUES (?, ?, ?, ?, ?)', [record.id, record.projectHash, record.score, JSON.stringify(record.breakdown), record.createdAt]);
+        await this.persist();
+    }
+    async getLatest() {
+        const db = await this.getDb();
+        const results = db.exec('SELECT * FROM scores ORDER BY created_at DESC LIMIT 1');
+        if (results.length === 0 || results[0].values.length === 0)
+            return null;
+        return this.rowToRecord(results[0].columns, results[0].values[0]);
+    }
+    async getHistory(weeks) {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - weeks * 7);
+        const db = await this.getDb();
+        const stmt = db.prepare('SELECT * FROM scores WHERE created_at >= ? ORDER BY created_at ASC');
+        stmt.bind([cutoff.toISOString()]);
+        const records = [];
+        while (stmt.step()) {
+            const row = stmt.getAsObject();
+            records.push(this.objectToRecord(row));
+        }
+        stmt.free();
+        return records;
+    }
+    async printTrend() {
+        const { TrendTracker } = await import('../core/scorer/TrendTracker.js');
+        const chalk = (await import('chalk')).default;
+        const tracker = new TrendTracker();
+        const history = await this.getHistory(12);
+        if (history.length === 0) {
+            console.log(chalk.yellow('No score history yet. Run `codeplug convention audit` to record scores.'));
+            return;
+        }
+        console.log(chalk.bold('\n\ud83d\udcca Score Trend\n'));
+        console.log(tracker.renderTrendChart(history));
+        const trend = tracker.computeTrend(history);
+        const icon = trend === 'improving' ? '\ud83d\udcc8' : trend === 'declining' ? '\ud83d\udcc9' : '\u27a1\ufe0f';
+        console.log(`\nTrend: ${icon} ${trend}\n`);
+    }
+    rowToRecord(columns, values) {
+        const row = {};
+        for (let i = 0; i < columns.length; i++) {
+            row[columns[i]] = values[i];
+        }
+        return this.objectToRecord(row);
+    }
+    objectToRecord(row) {
+        return {
+            id: row['id'],
+            projectHash: row['project_hash'],
+            score: row['score'],
+            breakdown: JSON.parse(row['breakdown_json']),
+            createdAt: row['created_at'],
+        };
+    }
+    close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+}
+//# sourceMappingURL=ScoreStore.js.map

package/dist/storage/ScoreStore.js.map

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

package/dist/storage/ViolationStore.d.ts

@@ -0,0 +1,11 @@
+import type { Violation } from '../config/types.js';
+export declare class ViolationStore {
+    private projectRoot;
+    private filePath;
+    private dirPath;
+    constructor(projectRoot: string);
+    exists(): Promise<boolean>;
+    load(): Promise<Violation[]>;
+    save(violations: Violation[]): Promise<void>;
+}
+//# sourceMappingURL=ViolationStore.d.ts.map

package/dist/storage/ViolationStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViolationStore.d.ts","sourceRoot":"","sources":["../../src/storage/ViolationStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGpD,qBAAa,cAAc;IAIb,OAAO,CAAC,WAAW;IAH/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEJ,WAAW,EAAE,MAAM;IAKjC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAI1B,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAM5B,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAMnD"}

package/dist/storage/ViolationStore.js

@@ -0,0 +1,30 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { CODEPLUG_DIR, VIOLATIONS_FILE } from '../config/defaults.js';
+export class ViolationStore {
+    projectRoot;
+    filePath;
+    dirPath;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+        this.dirPath = join(projectRoot, CODEPLUG_DIR);
+        this.filePath = join(this.dirPath, VIOLATIONS_FILE);
+    }
+    async exists() {
+        return existsSync(this.filePath);
+    }
+    async load() {
+        if (!existsSync(this.filePath))
+            return [];
+        const raw = await readFile(this.filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    async save(violations) {
+        if (!existsSync(this.dirPath)) {
+            await mkdir(this.dirPath, { recursive: true });
+        }
+        await writeFile(this.filePath, JSON.stringify(violations, null, 2), 'utf-8');
+    }
+}
+//# sourceMappingURL=ViolationStore.js.map

package/dist/storage/ViolationStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViolationStore.js","sourceRoot":"","sources":["../../src/storage/ViolationStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEtE,MAAM,OAAO,cAAc;IAIL;IAHZ,QAAQ,CAAS;IACjB,OAAO,CAAS;IAExB,YAAoB,WAAmB;QAAnB,gBAAW,GAAX,WAAW,CAAQ;QACrC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAuB;QAChC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;CACF"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@dinyangetoh/codeplug-cli",
+  "version": "0.1.0",
+  "description": "The source of truth for codebase understanding & governance",
+  "type": "module",
+  "main": "dist/cli/index.js",
+  "bin": {
+    "codeplug": "dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "coverage": "vitest run --coverage",
+    "lint": "eslint src/ --ext .ts",
+    "lint:fix": "eslint src/ --ext .ts --fix",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "codebase",
+    "conventions",
+    "governance",
+    "documentation",
+    "cli",
+    "ai",
+    "ml"
+  ],
+  "author": "David Inyang-Etoh (dinyangetoh)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dinyangetoh/codeplug-cli.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "dependencies": {
+    "commander": "^13.1.0",
+    "@inquirer/prompts": "^7.3.2",
+    "@babel/parser": "^7.26.9",
+    "@babel/traverse": "^7.26.9",
+    "@babel/types": "^7.26.9",
+    "@huggingface/transformers": "^3.3.3",
+    "sql.js": "^1.12.0",
+    "simple-git": "^3.27.0",
+    "globby": "^14.0.2",
+    "zod": "^3.24.2",
+    "chalk": "^5.4.1",
+    "ora": "^8.2.0",
+    "openai": "^4.85.4"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "@types/node": "^22.13.4",
+    "@types/babel__traverse": "^7.20.6",
+    "vitest": "^3.0.5",
+    "@vitest/coverage-v8": "^3.0.5",
+    "eslint": "^9.20.0",
+    "@eslint/js": "^9.20.0",
+    "typescript-eslint": "^8.24.1"
+  }
+}

package/templates/claude/CLAUDE.md.hbs

@@ -0,0 +1,15 @@
+# Project Conventions
+
+{{#each sections}}
+## {{title}}
+
+{{#each rules}}
+- {{severityIcon}} **[{{severity}}]** {{rule}}
+{{#if examples}}
+  - Examples: {{examples}}
+{{/if}}
+{{/each}}
+
+{{/each}}
+---
+_Generated by CodePlug_

package/templates/copilot/copilot-instructions.md.hbs

@@ -0,0 +1,13 @@
+# GitHub Copilot Instructions
+
+These instructions describe the coding conventions for this project.
+Follow them when generating or suggesting code.
+
+{{#each sections}}
+## {{title}}
+
+{{#each rules}}
+- **{{prefix}}**: {{rule}}
+{{/each}}
+
+{{/each}}

package/templates/cursor/conventions.mdc.hbs

@@ -0,0 +1,16 @@
+---
+description: Project coding conventions detected by CodePlug
+globs:
+alwaysApply: true
+---
+
+# Project Conventions
+
+{{#each sections}}
+## {{title}}
+
+{{#each rules}}
+- **[{{severity}}]** {{rule}}
+{{/each}}
+
+{{/each}}