decision-guardian 1.1.0

package/dist/cli/commands/check.js

@@ -0,0 +1,134 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCheck = runCheck;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const parser_1 = require("../../core/parser");
+const matcher_1 = require("../../core/matcher");
+const console_logger_1 = require("../../adapters/local/console-logger");
+const local_git_provider_1 = require("../../adapters/local/local-git-provider");
+const metrics_1 = require("../../core/metrics");
+const formatter_1 = require("../formatter");
+const sender_1 = require("../../telemetry/sender");
+const version_1 = require("../../version");
+async function runCheck(opts) {
+    const logger = new console_logger_1.ConsoleLogger();
+    const startTime = Date.now();
+    try {
+        const decisionPath = path.resolve(opts.decisionFile);
+        const isDir = fs.existsSync(decisionPath) && fs.statSync(decisionPath).isDirectory();
+        const parser = new parser_1.DecisionParser();
+        let parseResult;
+        if (isDir) {
+            logger.info(`Scanning directory: ${decisionPath}`);
+            parseResult = await parser.parseDirectory(decisionPath);
+        }
+        else {
+            if (!fs.existsSync(decisionPath)) {
+                logger.error(`Decision file not found: ${decisionPath}`);
+                logger.info('Run "decision-guardian init" to create one.');
+                process.exit(1);
+            }
+            logger.info(`Checking: ${decisionPath}`);
+            parseResult = await parser.parseFile(decisionPath);
+        }
+        if (parseResult.warnings.length > 0) {
+            parseResult.warnings.forEach((w) => logger.warning(w));
+        }
+        if (parseResult.errors.length > 0) {
+            parseResult.errors.forEach((e) => logger.error(`Line ${e.line}: ${e.message}`));
+            if (opts.failOnError) {
+                logger.error(`Check failed: ${parseResult.errors.length} parse errors found (fail-on-error enabled)`);
+                process.exit(1);
+            }
+        }
+        if (parseResult.decisions.length === 0) {
+            logger.warning('No decisions found in the specified path.');
+            process.exit(0);
+        }
+        logger.info(`Found ${parseResult.decisions.length} decisions`);
+        const gitConfig = {
+            mode: opts.mode,
+            baseBranch: opts.baseBranch,
+            cwd: process.cwd(),
+        };
+        const provider = new local_git_provider_1.LocalGitProvider(gitConfig);
+        const fileDiffs = await provider.getFileDiffs();
+        metrics_1.metrics.addFilesProcessed(fileDiffs.length);
+        if (fileDiffs.length === 0) {
+            logger.info('No changed files detected.');
+            process.exit(0);
+        }
+        logger.info(`${fileDiffs.length} files changed`);
+        const matcher = new matcher_1.FileMatcher(parseResult.decisions, logger);
+        let matches;
+        try {
+            matches = await matcher.findMatchesWithDiffs(fileDiffs);
+        }
+        catch {
+            const fileNames = fileDiffs.map((f) => f.filename);
+            matches = await matcher.findMatches(fileNames);
+        }
+        metrics_1.metrics.addMatchesFound(matches.length);
+        metrics_1.metrics.setDuration(Date.now() - startTime);
+        const grouped = matcher.groupBySeverity(matches);
+        metrics_1.metrics.addCriticalMatches(grouped.critical.length);
+        metrics_1.metrics.addWarningMatches(grouped.warning.length);
+        metrics_1.metrics.addInfoMatches(grouped.info.length);
+        console.log((0, formatter_1.formatMatchesTable)(matches));
+        const snapshot = metrics_1.metrics.getSnapshot();
+        console.log((0, formatter_1.formatSummary)({
+            filesProcessed: snapshot.files_processed,
+            decisionsEvaluated: parseResult.decisions.length,
+            matchesFound: snapshot.matches_found,
+            critical: grouped.critical.length,
+            warning: grouped.warning.length,
+            info: grouped.info.length,
+            durationMs: snapshot.duration_ms,
+        }));
+        (0, sender_1.sendTelemetry)('cli', snapshot, version_1.VERSION).catch(() => { });
+        if (opts.failOnCritical && grouped.critical.length > 0) {
+            logger.error(`${grouped.critical.length} critical violations found`);
+            process.exit(1);
+        }
+        process.exit(0);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error(`Check failed: ${message}`);
+        process.exit(1);
+    }
+}

package/dist/cli/commands/init.js

@@ -0,0 +1,58 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInit = runInit;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const paths_1 = require("../paths");
+function runInit(templateName) {
+    const targetDir = path.resolve('.decispher');
+    const targetFile = path.join(targetDir, 'decisions.md');
+    if (fs.existsSync(targetFile)) {
+        console.log(`\x1b[33m⚠\x1b[0m  ${targetFile} already exists. Skipping.`);
+        return;
+    }
+    const templatePath = path.join((0, paths_1.getTemplatesDir)(), `${templateName}.md`);
+    if (!fs.existsSync(templatePath)) {
+        console.error(`\x1b[31m✗\x1b[0m  Template "${templateName}" not found.`);
+        console.log('Available: basic, advanced-rules, security, database, api');
+        process.exit(1);
+    }
+    fs.mkdirSync(targetDir, { recursive: true });
+    fs.copyFileSync(templatePath, targetFile);
+    console.log(`\x1b[32m✔\x1b[0m  Created ${targetFile}`);
+    console.log(`   Template: ${templateName}`);
+    console.log(`\n   Edit the file to define your architectural decisions.`);
+}

package/dist/cli/commands/template.js

@@ -0,0 +1,70 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTemplate = runTemplate;
+exports.listTemplates = listTemplates;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const paths_1 = require("../paths");
+const AVAILABLE = ['basic', 'advanced-rules', 'security', 'database', 'api'];
+function runTemplate(name, outputPath) {
+    if (!AVAILABLE.includes(name)) {
+        console.error(`\x1b[31m✗\x1b[0m  Unknown template: "${name}"`);
+        listTemplates();
+        process.exit(1);
+    }
+    const templatePath = path.join((0, paths_1.getTemplatesDir)(), `${name}.md`);
+    if (!fs.existsSync(templatePath)) {
+        console.error(`\x1b[31m✗\x1b[0m  Template file missing: ${templatePath}`);
+        process.exit(1);
+    }
+    const content = fs.readFileSync(templatePath, 'utf-8');
+    if (outputPath) {
+        const resolved = path.resolve(outputPath);
+        fs.mkdirSync(path.dirname(resolved), { recursive: true });
+        fs.writeFileSync(resolved, content, 'utf-8');
+        console.log(`\x1b[32m✔\x1b[0m  Written to ${resolved}`);
+    }
+    else {
+        console.log(content);
+    }
+}
+function listTemplates() {
+    console.log('\nAvailable templates:');
+    for (const name of AVAILABLE) {
+        console.log(`  • ${name}`);
+    }
+    console.log('');
+}

package/dist/cli/formatter.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatMatchesTable = formatMatchesTable;
+exports.formatSummary = formatSummary;
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+const RED = '\x1b[31m';
+const YELLOW = '\x1b[33m';
+const GREEN = '\x1b[32m';
+const CYAN = '\x1b[36m';
+const GRAY = '\x1b[90m';
+const DIM = '\x1b[2m';
+const SEVERITY_ICON = {
+    critical: `${RED}●${RESET}`,
+    warning: `${YELLOW}●${RESET}`,
+    info: `${CYAN}●${RESET}`,
+};
+function formatMatchesTable(matches) {
+    if (matches.length === 0) {
+        return `\n  ${GREEN}✔${RESET} No decision violations found.\n`;
+    }
+    const lines = [];
+    lines.push('');
+    const grouped = groupBySeverity(matches);
+    if (grouped.critical.length > 0) {
+        lines.push(`  ${RED}${BOLD}Critical (${grouped.critical.length})${RESET}`);
+        for (const m of grouped.critical)
+            lines.push(formatRow(m));
+        lines.push('');
+    }
+    if (grouped.warning.length > 0) {
+        lines.push(`  ${YELLOW}${BOLD}Warning (${grouped.warning.length})${RESET}`);
+        for (const m of grouped.warning)
+            lines.push(formatRow(m));
+        lines.push('');
+    }
+    if (grouped.info.length > 0) {
+        lines.push(`  ${CYAN}${BOLD}Info (${grouped.info.length})${RESET}`);
+        for (const m of grouped.info)
+            lines.push(formatRow(m));
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function formatRow(match) {
+    const icon = SEVERITY_ICON[match.decision.severity] || SEVERITY_ICON.info;
+    const id = `${BOLD}${match.decision.id}${RESET}`;
+    const file = `${DIM}${match.file}${RESET}`;
+    const pattern = `${GRAY}${match.matchedPattern}${RESET}`;
+    return `    ${icon} ${id}  ${file}  ${pattern}`;
+}
+function formatSummary(stats) {
+    const lines = [];
+    lines.push(`  ${GRAY}─────────────────────────────${RESET}`);
+    lines.push(`  Files scanned:    ${BOLD}${stats.filesProcessed}${RESET}`);
+    lines.push(`  Decisions checked:${BOLD} ${stats.decisionsEvaluated}${RESET}`);
+    lines.push(`  Matches:          ${BOLD}${stats.matchesFound}${RESET} ${GRAY}(${stats.critical} critical, ${stats.warning} warning, ${stats.info} info)${RESET}`);
+    lines.push(`  Duration:         ${GRAY}${stats.durationMs}ms${RESET}`);
+    lines.push('');
+    return lines.join('\n');
+}
+function groupBySeverity(matches) {
+    return {
+        critical: matches.filter((m) => m.decision.severity === 'critical'),
+        warning: matches.filter((m) => m.decision.severity === 'warning'),
+        info: matches.filter((m) => m.decision.severity === 'info'),
+    };
+}