@cotal-ai/workspace 0.94.7 → 0.95.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/build/Release/win32-arm64/build.json +1 -1
- package/build/Release/win32-x64/build.json +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/dist/telemetry.d.ts +43 -0
- package/dist/telemetry.d.ts.map +1 -0
- package/dist/telemetry.js +106 -0
- package/dist/telemetry.js.map +1 -0
- package/package.json +2 -2
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"platform": "win32",
|
|
4
4
|
"arch": "arm64",
|
|
5
5
|
"nodeApi": 8,
|
|
6
|
-
"source": "
|
|
6
|
+
"source": "243916628e506008ba228fbb63b6af007e13d749",
|
|
7
7
|
"sourceHashes": {
|
|
8
8
|
"native/win32-process.c": "ecd93fe6cd562a61d30871cb5e640ca1c5e748cfe93c58e682680ecc9c906e50",
|
|
9
9
|
"native/node-sdk.json": "f08b87037df4d69c7d23f6527c4db45bcd246135ec1019c9fa4a265da65c2fd1",
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"platform": "win32",
|
|
4
4
|
"arch": "x64",
|
|
5
5
|
"nodeApi": 8,
|
|
6
|
-
"source": "
|
|
6
|
+
"source": "243916628e506008ba228fbb63b6af007e13d749",
|
|
7
7
|
"sourceHashes": {
|
|
8
8
|
"native/win32-process.c": "ecd93fe6cd562a61d30871cb5e640ca1c5e748cfe93c58e682680ecc9c906e50",
|
|
9
9
|
"native/node-sdk.json": "f08b87037df4d69c7d23f6527c4db45bcd246135ec1019c9fa4a265da65c2fd1",
|
package/dist/index.d.ts
CHANGED
|
@@ -40,6 +40,7 @@ export * from "./seat-checkpoint.js";
|
|
|
40
40
|
export * from "./space.js";
|
|
41
41
|
export * from "./space-segmentation.js";
|
|
42
42
|
export * from "./system-rotation.js";
|
|
43
|
+
export * from "./telemetry.js";
|
|
43
44
|
export * from "./win-cmd.js";
|
|
44
45
|
export * from "./pid.js";
|
|
45
46
|
export * from "./progress.js";
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AAEpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AAEpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -42,6 +42,7 @@ export * from "./seat-checkpoint.js";
|
|
|
42
42
|
export * from "./space.js";
|
|
43
43
|
export * from "./space-segmentation.js";
|
|
44
44
|
export * from "./system-rotation.js";
|
|
45
|
+
export * from "./telemetry.js";
|
|
45
46
|
export * from "./win-cmd.js";
|
|
46
47
|
export * from "./pid.js";
|
|
47
48
|
export * from "./progress.js";
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,2FAA2F;AAC3F,wDAAwD;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AAEpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,2FAA2F;AAC3F,wDAAwD;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AAEpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The anonymous usage telemetry settings of this machine: `<home>/telemetry.json`. The file holds
|
|
3
|
+
* the chosen level, a random install id that identifies nothing but this file, and the timestamps
|
|
4
|
+
* the CLI keys its one-time notice and its daily install event on. It never holds a credential.
|
|
5
|
+
*/
|
|
6
|
+
export declare const TELEMETRY_LEVELS: readonly ["off", "minimal", "regular"];
|
|
7
|
+
export type TelemetryLevel = (typeof TELEMETRY_LEVELS)[number];
|
|
8
|
+
export interface TelemetrySettings {
|
|
9
|
+
readonly v: 1;
|
|
10
|
+
readonly level: TelemetryLevel;
|
|
11
|
+
/** A uuid v4 minted when the file was created. */
|
|
12
|
+
readonly installId: string;
|
|
13
|
+
/** When the file was created; the install event reports the days since. */
|
|
14
|
+
readonly createdAt: string;
|
|
15
|
+
/** When the first-run notice was printed; unset until it was. */
|
|
16
|
+
readonly noticeShownAt?: string;
|
|
17
|
+
/** When the last install event was sent; one per UTC day. */
|
|
18
|
+
readonly lastInstallEventAt?: string;
|
|
19
|
+
}
|
|
20
|
+
/** Where the level came from: the file, or the environment variable that overrode it. */
|
|
21
|
+
export type TelemetrySource = "file" | "COTAL_TELEMETRY" | "DO_NOT_TRACK" | "COTAL_TELEMETRY_DISABLED";
|
|
22
|
+
export declare function telemetrySettingsPath(): string;
|
|
23
|
+
/** The settings file, created at `regular` with a fresh install id when there is none. */
|
|
24
|
+
export declare function readTelemetrySettings(): TelemetrySettings;
|
|
25
|
+
export declare function setTelemetryLevel(level: TelemetryLevel): TelemetrySettings;
|
|
26
|
+
export declare function markTelemetryNoticeShown(): TelemetrySettings;
|
|
27
|
+
export declare function markTelemetryInstallEvent(at: Date): TelemetrySettings;
|
|
28
|
+
/** The level the environment forces, with the variable that forces it, or `undefined` when none is
|
|
29
|
+
* set. `DO_NOT_TRACK` and `COTAL_TELEMETRY_DISABLED` force `off`; `COTAL_TELEMETRY` names a level,
|
|
30
|
+
* and any other value refuses. */
|
|
31
|
+
export declare function telemetryLevelFromEnv(env: NodeJS.ProcessEnv): {
|
|
32
|
+
level: TelemetryLevel;
|
|
33
|
+
source: Exclude<TelemetrySource, "file">;
|
|
34
|
+
} | undefined;
|
|
35
|
+
/** The level in force and where it comes from, with the settings file that holds the install id.
|
|
36
|
+
* The file is neither read nor created when the environment forces `off`, so a machine that opts
|
|
37
|
+
* out by environment keeps no install id. */
|
|
38
|
+
export declare function effectiveTelemetry(env: NodeJS.ProcessEnv): {
|
|
39
|
+
level: TelemetryLevel;
|
|
40
|
+
source: TelemetrySource;
|
|
41
|
+
settings?: TelemetrySettings;
|
|
42
|
+
};
|
|
43
|
+
//# sourceMappingURL=telemetry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AAEH,eAAO,MAAM,gBAAgB,wCAAyC,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IACd,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,yFAAyF;AACzF,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,iBAAiB,GAAG,cAAc,GAAG,0BAA0B,CAAC;AAEvG,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AA6CD,0FAA0F;AAC1F,wBAAgB,qBAAqB,IAAI,iBAAiB,CAEzD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB,CAE1E;AAED,wBAAgB,wBAAwB,IAAI,iBAAiB,CAE5D;AAED,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,IAAI,GAAG,iBAAiB,CAErE;AAID;;mCAEmC;AACnC,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,SAAS,CAO7I;AAED;;8CAE8C;AAC9C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAAE,CAK3I"}
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
2
|
+
import { readFileSync } from "node:fs";
|
|
3
|
+
import { join } from "node:path";
|
|
4
|
+
import { mkSecretDir, writeSecretFileAtomic } from "@cotal-ai/core";
|
|
5
|
+
import { homeCotalDir } from "./mesh-registry.js";
|
|
6
|
+
import { CommandFailure } from "./output.js";
|
|
7
|
+
/**
|
|
8
|
+
* The anonymous usage telemetry settings of this machine: `<home>/telemetry.json`. The file holds
|
|
9
|
+
* the chosen level, a random install id that identifies nothing but this file, and the timestamps
|
|
10
|
+
* the CLI keys its one-time notice and its daily install event on. It never holds a credential.
|
|
11
|
+
*/
|
|
12
|
+
export const TELEMETRY_LEVELS = ["off", "minimal", "regular"];
|
|
13
|
+
export function telemetrySettingsPath() {
|
|
14
|
+
return join(homeCotalDir(), "telemetry.json");
|
|
15
|
+
}
|
|
16
|
+
const isLevel = (value) => TELEMETRY_LEVELS.includes(value);
|
|
17
|
+
const isIso = (value) => typeof value === "string" && !Number.isNaN(Date.parse(value));
|
|
18
|
+
function invalid(problem) {
|
|
19
|
+
return new CommandFailure("refused", "SCHEMA_INVALID", `the telemetry settings file ${telemetrySettingsPath()} is invalid: ${problem}`, {
|
|
20
|
+
remedy: "fix the file, or move it away and run `cotal telemetry` to create a new one",
|
|
21
|
+
});
|
|
22
|
+
}
|
|
23
|
+
/** The settings as the file holds them, or `undefined` when there is no file. A file that does not
|
|
24
|
+
* validate refuses with `SCHEMA_INVALID` and is never replaced. */
|
|
25
|
+
function readFile() {
|
|
26
|
+
let text;
|
|
27
|
+
try {
|
|
28
|
+
text = readFileSync(telemetrySettingsPath(), "utf8");
|
|
29
|
+
}
|
|
30
|
+
catch (e) {
|
|
31
|
+
if (e.code === "ENOENT")
|
|
32
|
+
return undefined;
|
|
33
|
+
throw e;
|
|
34
|
+
}
|
|
35
|
+
let parsed;
|
|
36
|
+
try {
|
|
37
|
+
parsed = JSON.parse(text);
|
|
38
|
+
}
|
|
39
|
+
catch (e) {
|
|
40
|
+
throw invalid(`not JSON (${e.message})`);
|
|
41
|
+
}
|
|
42
|
+
if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
|
|
43
|
+
throw invalid("not an object");
|
|
44
|
+
const s = parsed;
|
|
45
|
+
if (s.v !== 1)
|
|
46
|
+
throw invalid("v must be 1");
|
|
47
|
+
if (!isLevel(s.level))
|
|
48
|
+
throw invalid("level must be off, minimal or regular");
|
|
49
|
+
if (typeof s.installId !== "string" || !/^[0-9a-f-]{36}$/.test(s.installId))
|
|
50
|
+
throw invalid("installId must be a uuid");
|
|
51
|
+
if (!isIso(s.createdAt))
|
|
52
|
+
throw invalid("createdAt must be a date");
|
|
53
|
+
if (s.noticeShownAt !== undefined && !isIso(s.noticeShownAt))
|
|
54
|
+
throw invalid("noticeShownAt must be a date");
|
|
55
|
+
if (s.lastInstallEventAt !== undefined && !isIso(s.lastInstallEventAt))
|
|
56
|
+
throw invalid("lastInstallEventAt must be a date");
|
|
57
|
+
for (const key of Object.keys(s))
|
|
58
|
+
if (!["v", "level", "installId", "createdAt", "noticeShownAt", "lastInstallEventAt"].includes(key))
|
|
59
|
+
throw invalid(`unknown key ${key}`);
|
|
60
|
+
return s;
|
|
61
|
+
}
|
|
62
|
+
function write(settings) {
|
|
63
|
+
mkSecretDir(homeCotalDir());
|
|
64
|
+
writeSecretFileAtomic(telemetrySettingsPath(), `${JSON.stringify(settings, null, 2)}\n`);
|
|
65
|
+
return settings;
|
|
66
|
+
}
|
|
67
|
+
/** The settings file, created at `regular` with a fresh install id when there is none. */
|
|
68
|
+
export function readTelemetrySettings() {
|
|
69
|
+
return readFile() ?? write({ v: 1, level: "regular", installId: randomUUID(), createdAt: new Date().toISOString() });
|
|
70
|
+
}
|
|
71
|
+
export function setTelemetryLevel(level) {
|
|
72
|
+
return write({ ...readTelemetrySettings(), level });
|
|
73
|
+
}
|
|
74
|
+
export function markTelemetryNoticeShown() {
|
|
75
|
+
return write({ ...readTelemetrySettings(), noticeShownAt: new Date().toISOString() });
|
|
76
|
+
}
|
|
77
|
+
export function markTelemetryInstallEvent(at) {
|
|
78
|
+
return write({ ...readTelemetrySettings(), lastInstallEventAt: at.toISOString() });
|
|
79
|
+
}
|
|
80
|
+
const truthy = (value) => value === "1" || value?.toLowerCase() === "true";
|
|
81
|
+
/** The level the environment forces, with the variable that forces it, or `undefined` when none is
|
|
82
|
+
* set. `DO_NOT_TRACK` and `COTAL_TELEMETRY_DISABLED` force `off`; `COTAL_TELEMETRY` names a level,
|
|
83
|
+
* and any other value refuses. */
|
|
84
|
+
export function telemetryLevelFromEnv(env) {
|
|
85
|
+
if (truthy(env.DO_NOT_TRACK))
|
|
86
|
+
return { level: "off", source: "DO_NOT_TRACK" };
|
|
87
|
+
if (truthy(env.COTAL_TELEMETRY_DISABLED))
|
|
88
|
+
return { level: "off", source: "COTAL_TELEMETRY_DISABLED" };
|
|
89
|
+
const named = env.COTAL_TELEMETRY;
|
|
90
|
+
if (named === undefined || named === "")
|
|
91
|
+
return undefined;
|
|
92
|
+
if (!isLevel(named))
|
|
93
|
+
throw new CommandFailure("refused", "USAGE_INVALID", "COTAL_TELEMETRY must be off, minimal or regular", { remedy: "unset it, or set it to one of those levels" });
|
|
94
|
+
return { level: named, source: "COTAL_TELEMETRY" };
|
|
95
|
+
}
|
|
96
|
+
/** The level in force and where it comes from, with the settings file that holds the install id.
|
|
97
|
+
* The file is neither read nor created when the environment forces `off`, so a machine that opts
|
|
98
|
+
* out by environment keeps no install id. */
|
|
99
|
+
export function effectiveTelemetry(env) {
|
|
100
|
+
const forced = telemetryLevelFromEnv(env);
|
|
101
|
+
if (forced?.level === "off")
|
|
102
|
+
return forced;
|
|
103
|
+
const settings = readTelemetrySettings();
|
|
104
|
+
return forced ? { ...forced, settings } : { level: settings.level, source: "file", settings };
|
|
105
|
+
}
|
|
106
|
+
//# sourceMappingURL=telemetry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cotal-ai/workspace",
|
|
3
3
|
"description": "Cotal machine-local workstation layer: the ~/.cotal mesh registry, target resolution, preflight, on-disk auth-path I/O, and the command-copy renderer — operator concerns over a local checkout, kept separate from the wire protocol in @cotal-ai/core.",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.95.0",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"repository": {
|
|
7
7
|
"type": "git",
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
}
|
|
19
19
|
},
|
|
20
20
|
"dependencies": {
|
|
21
|
-
"@cotal-ai/core": "0.
|
|
21
|
+
"@cotal-ai/core": "0.95.0",
|
|
22
22
|
"ajv": "^8.20.0",
|
|
23
23
|
"string-width": "^8.2.1",
|
|
24
24
|
"yaml": "^2.9.0",
|