@stackbilt/cli 0.4.1 → 0.5.0

package/dist/git-helpers.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * Shared git invocation helpers.
+ *
+ * Centralizes all child-process git calls behind a single `runGit()` that
+ * uses `shell: true` for cross-platform PATH resolution (fixes WSL, CMD,
+ * PowerShell parity — see ADX-005 F2).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGit = runGit;
+exports.isGitRepo = isGitRepo;
+exports.hasCommits = hasCommits;
+exports.getGitErrorMessage = getGitErrorMessage;
+exports.parseCommitMetadata = parseCommitMetadata;
+exports.parseChangedFilesByCommit = parseChangedFilesByCommit;
+exports.getRecentCommitRange = getRecentCommitRange;
+const node_child_process_1 = require("node:child_process");
+// ---------------------------------------------------------------------------
+// Core git invocation
+// ---------------------------------------------------------------------------
+/**
+ * Run a git command and return its stdout.
+ *
+ * Uses `shell: true` so that the OS shell resolves the `git` binary via
+ * PATH.  This is the key cross-platform fix: `execFileSync` *without* a
+ * shell can fail on WSL/Windows when git lives in a PATH entry the Node
+ * process doesn't see directly.
+ */
+function runGit(args) {
+    return (0, node_child_process_1.execFileSync)('git', args, {
+        encoding: 'utf-8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+        maxBuffer: 10 * 1024 * 1024,
+        shell: true,
+    });
+}
+/** Returns `true` when the current working directory is inside a git work tree. */
+function isGitRepo() {
+    try {
+        runGit(['rev-parse', '--is-inside-work-tree']);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Returns `true` when the repository has at least one commit (HEAD exists). */
+function hasCommits() {
+    try {
+        runGit(['rev-parse', '--verify', 'HEAD']);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Error formatting
+// ---------------------------------------------------------------------------
+/** Extract a human-readable message from a git child-process error. */
+function getGitErrorMessage(error) {
+    const fallback = 'Unknown git error.';
+    if (!(error instanceof Error))
+        return fallback;
+    const execError = error;
+    if (execError.stderr) {
+        const stderr = execError.stderr.toString().trim();
+        if (stderr.length > 0) {
+            return stderr;
+        }
+    }
+    if (execError.message) {
+        return execError.message.trim();
+    }
+    return fallback;
+}
+// ---------------------------------------------------------------------------
+// Commit log parsing (shared by audit, validate, why)
+// ---------------------------------------------------------------------------
+/**
+ * Parse `git log --format=%H%x1f%an%x1f%aI%x1f%B%x1e` output into commit
+ * metadata (without file lists).
+ */
+function parseCommitMetadata(logOutput) {
+    const commits = [];
+    for (const rawRecord of logOutput.split('\x1e')) {
+        const record = rawRecord.trim();
+        if (!record)
+            continue;
+        const [sha = '', author = '', timestamp = '', ...messageParts] = record.split('\x1f');
+        if (!sha)
+            continue;
+        commits.push({
+            sha: sha.trim(),
+            author: author.trim(),
+            timestamp: timestamp.trim(),
+            message: messageParts.join('\x1f').replace(/\r\n/g, '\n').replace(/\n+$/, ''),
+        });
+    }
+    return commits;
+}
+/**
+ * Parse `git log --name-only --format=%H` output into a Map of SHA → changed
+ * file paths.
+ */
+function parseChangedFilesByCommit(logOutput) {
+    const filesBySha = new Map();
+    let currentSha = '';
+    for (const rawLine of logOutput.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line)
+            continue;
+        if (/^[a-f0-9]{40}$/i.test(line)) {
+            currentSha = line;
+            if (!filesBySha.has(currentSha)) {
+                filesBySha.set(currentSha, []);
+            }
+            continue;
+        }
+        if (!currentSha)
+            continue;
+        const files = filesBySha.get(currentSha);
+        if (!files || files.includes(line))
+            continue;
+        files.push(line);
+    }
+    return filesBySha;
+}
+// ---------------------------------------------------------------------------
+// Commit range helpers (shared by audit, validate)
+// ---------------------------------------------------------------------------
+/** Return a short recent-commits range like `HEAD~5..HEAD`. */
+function getRecentCommitRange() {
+    try {
+        const count = Number.parseInt(runGit(['rev-list', '--count', 'HEAD']).trim(), 10);
+        if (!Number.isFinite(count) || count <= 1) {
+            return 'HEAD';
+        }
+        const span = Math.min(5, count - 1);
+        return `HEAD~${span}..HEAD`;
+    }
+    catch {
+        return 'HEAD';
+    }
+}
+//# sourceMappingURL=git-helpers.js.map

package/dist/git-helpers.js.map

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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuDH,eAAO,MAAM,SAAS;;;;CAIZ,CAAC;AAEX,qBAAa,QAAS,SAAQ,KAAK;aAGf,QAAQ,EAAE,MAAM;gBADhC,OAAO,EAAE,MAAM,EACC,QAAQ,GAAE,MAAgC;CAK7D;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwDzD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2DH,eAAO,MAAM,SAAS;;;;CAIZ,CAAC;AAEX,qBAAa,QAAS,SAAQ,KAAK;aAGf,QAAQ,EAAE,MAAM;gBADhC,OAAO,EAAE,MAAM,EACC,QAAQ,GAAE,MAAgC;CAK7D;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAqGzD"}

package/dist/index.js

@@ -22,6 +22,9 @@ const why_1 = require("./commands/why");
 const hook_1 = require("./commands/hook");
 const adf_1 = require("./commands/adf");
 const bootstrap_1 = require("./commands/bootstrap");
+const telemetry_1 = require("./commands/telemetry");
+const telemetry_2 = require("./telemetry");
+const flags_1 = require("./flags");
 const package_json_1 = __importDefault(require("../package.json"));
 const CLI_VERSION = package_json_1.default.version;
 const HELP = `
@@ -45,9 +48,10 @@ Usage:
                                    Install git commit-msg hook for trailer normalization
   charter hook install --pre-commit [--force]
                                    Install git pre-commit hook for ADF evidence gate
-  charter adf <subcommand>         ADF context format tools (init, fmt, patch, bundle, sync, evidence, migrate)
+  charter adf <subcommand>         ADF context format tools (init, fmt, patch, create, bundle, sync, evidence, migrate, metrics)
+  charter telemetry report         Local telemetry summary (passive CLI observability)
   charter why                      Explain why teams adopt Charter and expected ROI
-  charter doctor                   Check CLI + config health
+  charter doctor [--adf-only]      Check CLI + config health (or ADF-only wiring checks)
   charter --help                   Show this help
   charter --version                Show version
 
@@ -76,61 +80,97 @@ class CLIError extends Error {
 }
 exports.CLIError = CLIError;
 async function run(args) {
-    if (args.includes('--help') || args.includes('-h')) {
-        console.log(HELP);
-        return exports.EXIT_CODE.SUCCESS;
-    }
-    if (args.includes('--version') || args.includes('-v')) {
-        console.log(`charter v${CLI_VERSION}`);
-        return exports.EXIT_CODE.SUCCESS;
-    }
-    const format = getFlag(args, '--format') || 'text';
-    if (format !== 'text' && format !== 'json') {
-        throw new CLIError(`Invalid --format value: ${format}. Use text or json.`);
-    }
-    const options = {
-        configPath: getFlag(args, '--config') || '.charter',
-        format,
-        ciMode: args.includes('--ci'),
-        yes: args.includes('--yes'),
+    const start = Date.now();
+    const configPath = (0, flags_1.getFlag)(args, '--config') || '.charter';
+    const rawFormat = (0, flags_1.getFlag)(args, '--format') || 'text';
+    const ciMode = args.includes('--ci');
+    const yes = args.includes('--yes');
+    const writeTelemetry = (exitCode, errorName) => {
+        (0, telemetry_2.recordTelemetryEvent)(configPath, {
+            args,
+            format: rawFormat,
+            ciMode,
+            durationMs: Date.now() - start,
+            exitCode,
+            errorName,
+        });
     };
-    if (args.length === 0 || args[0].startsWith('-')) {
-        return (0, why_1.quickstartCommand)(options);
+    try {
+        if (args.includes('--help') || args.includes('-h')) {
+            console.log(HELP);
+            writeTelemetry(exports.EXIT_CODE.SUCCESS);
+            return exports.EXIT_CODE.SUCCESS;
+        }
+        if (args.includes('--version') || args.includes('-v')) {
+            console.log(`charter v${CLI_VERSION}`);
+            writeTelemetry(exports.EXIT_CODE.SUCCESS);
+            return exports.EXIT_CODE.SUCCESS;
+        }
+        if (rawFormat !== 'text' && rawFormat !== 'json') {
+            throw new CLIError(`Invalid --format value: ${rawFormat}. Use text or json.`);
+        }
+        const options = {
+            configPath,
+            format: rawFormat,
+            ciMode,
+            yes,
+        };
+        let exitCode;
+        if (args.length === 0 || args[0].startsWith('-')) {
+            exitCode = await (0, why_1.quickstartCommand)(options);
+            writeTelemetry(exitCode);
+            return exitCode;
+        }
+        const command = args[0];
+        const restArgs = args.slice(1);
+        switch (command) {
+            case 'bootstrap':
+                exitCode = await (0, bootstrap_1.bootstrapCommand)(options, restArgs);
+                break;
+            case 'setup':
+                exitCode = await (0, setup_1.setupCommand)(options, restArgs);
+                break;
+            case 'init':
+                exitCode = await (0, init_1.initCommand)(options, restArgs);
+                break;
+            case 'validate':
+                exitCode = await (0, validate_1.validateCommand)(options, restArgs);
+                break;
+            case 'audit':
+                exitCode = await (0, audit_1.auditCommand)(options, restArgs);
+                break;
+            case 'drift':
+                exitCode = await (0, drift_1.driftCommand)(options, restArgs);
+                break;
+            case 'classify':
+                exitCode = await (0, classify_1.classifyCommand)(options, restArgs);
+                break;
+            case 'why':
+                exitCode = await (0, why_1.whyCommand)(options);
+                break;
+            case 'doctor':
+                exitCode = await (0, doctor_1.doctorCommand)(options, restArgs);
+                break;
+            case 'hook':
+                exitCode = await (0, hook_1.hookCommand)(options, restArgs);
+                break;
+            case 'adf':
+                exitCode = await (0, adf_1.adfCommand)(options, restArgs);
+                break;
+            case 'telemetry':
+                exitCode = await (0, telemetry_1.telemetryCommand)(options, restArgs);
+                break;
+            default:
+                throw new CLIError(`Unknown command: ${command}\n${HELP}`);
+        }
+        writeTelemetry(exitCode);
+        return exitCode;
     }
-    const command = args[0];
-    const restArgs = args.slice(1);
-    switch (command) {
-        case 'bootstrap':
-            return (0, bootstrap_1.bootstrapCommand)(options, restArgs);
-        case 'setup':
-            return (0, setup_1.setupCommand)(options, restArgs);
-        case 'init':
-            return (0, init_1.initCommand)(options, restArgs);
-        case 'validate':
-            return (0, validate_1.validateCommand)(options, restArgs);
-        case 'audit':
-            return (0, audit_1.auditCommand)(options, restArgs);
-        case 'drift':
-            return (0, drift_1.driftCommand)(options, restArgs);
-        case 'classify':
-            return (0, classify_1.classifyCommand)(options, restArgs);
-        case 'why':
-            return (0, why_1.whyCommand)(options);
-        case 'doctor':
-            return (0, doctor_1.doctorCommand)(options);
-        case 'hook':
-            return (0, hook_1.hookCommand)(options, restArgs);
-        case 'adf':
-            return (0, adf_1.adfCommand)(options, restArgs);
-        default:
-            throw new CLIError(`Unknown command: ${command}\n${HELP}`);
-    }
-}
-function getFlag(args, flag) {
-    const idx = args.indexOf(flag);
-    if (idx !== -1 && idx + 1 < args.length) {
-        return args[idx + 1];
+    catch (err) {
+        const exitCode = err instanceof CLIError ? err.exitCode : exports.EXIT_CODE.RUNTIME_ERROR;
+        const errorName = err instanceof Error ? err.name : 'UnknownError';
+        writeTelemetry(exitCode, errorName);
+        throw err;
     }
-    return undefined;
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/telemetry.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CLI telemetry (local-first, append-only).
+ *
+ * Writes command execution metadata to .charter/telemetry/events.ndjson
+ * with no prompt/content capture.
+ */
+export interface CliTelemetryEvent {
+    version: 1;
+    timestamp: string;
+    commandPath: string;
+    flags: string[];
+    format: string;
+    ciMode: boolean;
+    durationMs: number;
+    exitCode: number;
+    success: boolean;
+    errorName?: string;
+}
+export interface RecordEventInput {
+    args: string[];
+    format: string;
+    ciMode: boolean;
+    durationMs: number;
+    exitCode: number;
+    errorName?: string;
+}
+export declare function recordTelemetryEvent(configPath: string, input: RecordEventInput): void;
+export declare function inferCommandPath(args: string[]): string;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAuBtF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAUvD"}

package/dist/telemetry.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * CLI telemetry (local-first, append-only).
+ *
+ * Writes command execution metadata to .charter/telemetry/events.ndjson
+ * with no prompt/content capture.
+ */
+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.recordTelemetryEvent = recordTelemetryEvent;
+exports.inferCommandPath = inferCommandPath;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+function recordTelemetryEvent(configPath, input) {
+    try {
+        const telemetryDir = path.join(configPath, 'telemetry');
+        const telemetryFile = path.join(telemetryDir, 'events.ndjson');
+        fs.mkdirSync(telemetryDir, { recursive: true });
+        const event = {
+            version: 1,
+            timestamp: new Date().toISOString(),
+            commandPath: inferCommandPath(input.args),
+            flags: extractFlagNames(input.args),
+            format: input.format,
+            ciMode: input.ciMode,
+            durationMs: input.durationMs,
+            exitCode: input.exitCode,
+            success: input.exitCode === 0,
+            errorName: input.errorName,
+        };
+        fs.appendFileSync(telemetryFile, `${JSON.stringify(event)}\n`);
+    }
+    catch {
+        // Telemetry is best-effort and must never block command execution.
+    }
+}
+function inferCommandPath(args) {
+    if (args.length === 0 || args[0].startsWith('-')) {
+        return 'quickstart';
+    }
+    const command = args[0];
+    if ((command === 'adf' || command === 'hook' || command === 'telemetry') && args[1] && !args[1].startsWith('-')) {
+        return `${command}.${args[1]}`;
+    }
+    return command;
+}
+function extractFlagNames(args) {
+    const flags = [];
+    for (const arg of args) {
+        if (arg.startsWith('-')) {
+            flags.push(arg);
+        }
+    }
+    return [...new Set(flags)];
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BH,oDAuBC;AAED,4CAUC;AA5DD,4CAA8B;AAC9B,gDAAkC;AAwBlC,SAAgB,oBAAoB,CAAC,UAAkB,EAAE,KAAuB;IAC9E,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACxD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;QAC/D,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhD,MAAM,KAAK,GAAsB;YAC/B,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,WAAW,EAAE,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC;YACzC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC;YACnC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,OAAO,EAAE,KAAK,CAAC,QAAQ,KAAK,CAAC;YAC7B,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC;QAEF,EAAE,CAAC,cAAc,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;AACH,CAAC;AAED,SAAgB,gBAAgB,CAAC,IAAc;IAC7C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,WAAW,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAChH,OAAO,GAAG,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAc;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stackbilt/cli",
   "sideEffects": false,
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Charter CLI — repo-level governance checks",
   "bin": {
     "charter": "./dist/bin.js"
@@ -35,13 +35,13 @@
     "access": "public"
   },
   "dependencies": {
-    "@stackbilt/classify": "^0.4.1",
-    "@stackbilt/core": "^0.4.1",
-    "@stackbilt/types": "^0.4.1",
-    "@stackbilt/git": "^0.4.1",
-    "@stackbilt/validate": "^0.4.1",
-    "@stackbilt/drift": "^0.4.1",
-    "@stackbilt/adf": "^0.4.1"
+    "@stackbilt/core": "^0.5.0",
+    "@stackbilt/git": "^0.5.0",
+    "@stackbilt/classify": "^0.5.0",
+    "@stackbilt/types": "^0.5.0",
+    "@stackbilt/drift": "^0.5.0",
+    "@stackbilt/adf": "^0.5.0",
+    "@stackbilt/validate": "^0.5.0"
   },
   "license": "Apache-2.0",
   "scripts": {