@stackbilt/cli 0.4.2 → 0.5.0

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.2",
+  "version": "0.5.0",
   "description": "Charter CLI — repo-level governance checks",
   "bin": {
     "charter": "./dist/bin.js"
@@ -35,13 +35,13 @@
     "access": "public"
   },
   "dependencies": {
-    "@stackbilt/git": "^0.4.2",
-    "@stackbilt/types": "^0.4.2",
-    "@stackbilt/classify": "^0.4.2",
-    "@stackbilt/core": "^0.4.2",
-    "@stackbilt/drift": "^0.4.2",
-    "@stackbilt/adf": "^0.4.2",
-    "@stackbilt/validate": "^0.4.2"
+    "@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": {