@codeyam/codeyam-cli 0.1.12 → 0.1.13

package/codeyam-cli/src/commands/editorIsolateArgs.js

@@ -0,0 +1,25 @@
+/**
+ * Parse component names for `codeyam editor isolate`.
+ *
+ * Supports multiple calling conventions:
+ *   codeyam editor isolate "A B C"     → json="A B C", extras=[]
+ *   codeyam editor isolate A B C       → json="A", extras=["editor","B","C"]
+ *   codeyam editor isolate A,B,C       → json="A,B,C", extras=[]
+ *   codeyam editor isolate A           → json="A", extras=[]
+ */
+export function parseIsolateArgs(json, extras) {
+    const names = [];
+    // Split json arg by whitespace or commas
+    if (json) {
+        names.push(...json.split(/[\s,]+/).filter(Boolean));
+    }
+    // Collect extra positional args, filtering out "editor"
+    for (const arg of extras) {
+        if (typeof arg === 'string' && arg !== 'editor') {
+            names.push(arg);
+        }
+    }
+    // Deduplicate while preserving order
+    return [...new Set(names)];
+}
+//# sourceMappingURL=editorIsolateArgs.js.map

package/codeyam-cli/src/commands/editorIsolateArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorIsolateArgs.js","sourceRoot":"","sources":["../../../../src/commands/editorIsolateArgs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAwB,EACxB,MAA2B;IAE3B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,yCAAyC;IACzC,IAAI,IAAI,EAAE,CAAC;QACT,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,wDAAwD;IACxD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/codeyam-cli/src/commands/telemetry.js

@@ -0,0 +1,37 @@
+import chalk from 'chalk';
+import { isTelemetryEnabled, setTelemetryEnabled, getDistinctId, } from "../utils/telemetry.js";
+const telemetryCommand = {
+    command: 'telemetry [subcommand]',
+    describe: 'Manage anonymous usage telemetry',
+    builder: (yargs) => {
+        return yargs.positional('subcommand', {
+            type: 'string',
+            choices: ['status', 'enable', 'disable'],
+            describe: 'Subcommand to run',
+        });
+    },
+    handler: (argv) => {
+        switch (argv.subcommand) {
+            case 'enable':
+                setTelemetryEnabled(true);
+                console.log(chalk.green('Telemetry enabled.'));
+                break;
+            case 'disable':
+                setTelemetryEnabled(false);
+                console.log(chalk.yellow('Telemetry disabled.'));
+                break;
+            case 'status':
+            default: {
+                const enabled = isTelemetryEnabled();
+                const id = getDistinctId();
+                console.log(`Telemetry: ${enabled ? chalk.green('enabled') : chalk.yellow('disabled')}`);
+                console.log(`Anonymous ID: ${chalk.dim(id)}`);
+                console.log(chalk.dim('\nRun "codeyam telemetry disable" to opt out.'));
+                console.log(chalk.dim('Set DO_NOT_TRACK=1 or CODEYAM_TELEMETRY=0 to disable via env.'));
+                break;
+            }
+        }
+    },
+};
+export default telemetryCommand;
+//# sourceMappingURL=telemetry.js.map

package/codeyam-cli/src/commands/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../../../src/commands/telemetry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAM5B,MAAM,gBAAgB,GAAyC;IAC7D,OAAO,EAAE,wBAAwB;IACjC,QAAQ,EAAE,kCAAkC;IAC5C,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QACjB,OAAO,KAAK,CAAC,UAAU,CAAC,YAAY,EAAE;YACpC,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAU;YACjD,QAAQ,EAAE,mBAAmB;SAC9B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QAChB,QAAQ,IAAI,CAAC,UAAU,EAAE,CAAC;YACxB,KAAK,QAAQ;gBACX,mBAAmB,CAAC,IAAI,CAAC,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;gBAC/C,MAAM;YACR,KAAK,SAAS;gBACZ,mBAAmB,CAAC,KAAK,CAAC,CAAC;gBAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC;gBACjD,MAAM;YACR,KAAK,QAAQ,CAAC;YACd,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;gBACrC,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;gBAC3B,OAAO,CAAC,GAAG,CACT,cAAc,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAC5E,CAAC;gBACF,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC9C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC,CAAC;gBACxE,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CACP,+DAA+D,CAChE,CACF,CAAC;gBACF,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/codeyam-cli/src/utils/__tests__/editorEntityChangeStatus.test.js

@@ -120,5 +120,75 @@ describe('computeEntityChangeStatusForEditor', () => {
             formatDate: { status: 'edited' },
         });
     });
+    describe('pre-computed parameter deduplication', () => {
+        it('should use pre-computed scanPageFilePaths result instead of calling it', async () => {
+            const precomputed = {
+                map: { Home: 'app/page.tsx' },
+                allFiles: ['app/page.tsx'],
+            };
+            mockGetGitStatus.mockReturnValue([
+                { path: 'app/page.tsx', status: 'modified' },
+            ]);
+            mockLoadEntities.mockResolvedValue([]);
+            const result = await computeEntityChangeStatusForEditor({
+                projectRoot: '/test',
+                scenarioInputs: [{ url: '/' }],
+                precomputedPageFilePaths: precomputed,
+            });
+            expect(mockScanPageFilePaths).not.toHaveBeenCalled();
+            expect(result.pageEntityNames).toContain('Home');
+            expect(result.entityChangeStatus['Home']).toEqual({ status: 'edited' });
+        });
+        it('should use pre-computed gitFiles instead of calling getGitStatusForProject', async () => {
+            const precomputedGitFiles = [{ path: 'src/Card.tsx', status: 'modified' }];
+            const result = await computeEntityChangeStatusForEditor({
+                projectRoot: '/test',
+                scenarioInputs: [
+                    { componentName: 'Card', componentPath: 'src/Card.tsx' },
+                ],
+                precomputedGitFiles,
+            });
+            expect(mockGetGitStatus).not.toHaveBeenCalled();
+            expect(result.entityChangeStatus).toEqual({
+                Card: { status: 'edited' },
+            });
+        });
+        it('should use pre-computed entities instead of calling initializeEnvironment + loadEntities', async () => {
+            const precomputedEntities = [
+                {
+                    name: 'Button',
+                    filePath: 'src/Button.tsx',
+                    importedExports: [{ name: 'Icon', filePath: 'src/Icon.tsx' }],
+                },
+            ];
+            mockGetGitStatus.mockReturnValue([
+                { path: 'src/Icon.tsx', status: 'modified' },
+            ]);
+            const result = await computeEntityChangeStatusForEditor({
+                projectRoot: '/test',
+                scenarioInputs: [
+                    { componentName: 'Button', componentPath: 'src/Button.tsx' },
+                ],
+                precomputedEntities,
+            });
+            expect(mockInitEnv).not.toHaveBeenCalled();
+            expect(mockLoadEntities).not.toHaveBeenCalled();
+        });
+        it('should fall back to computing values when pre-computed params not provided', async () => {
+            mockScanPageFilePaths.mockReturnValue({ map: {}, allFiles: [] });
+            mockGetGitStatus.mockReturnValue([
+                { path: 'src/X.tsx', status: 'added' },
+            ]);
+            mockLoadEntities.mockResolvedValue([]);
+            await computeEntityChangeStatusForEditor({
+                projectRoot: '/test',
+                scenarioInputs: [{ componentName: 'X', componentPath: 'src/X.tsx' }],
+            });
+            expect(mockScanPageFilePaths).toHaveBeenCalled();
+            expect(mockGetGitStatus).toHaveBeenCalled();
+            expect(mockInitEnv).toHaveBeenCalled();
+            expect(mockLoadEntities).toHaveBeenCalled();
+        });
+    });
 });
 //# sourceMappingURL=editorEntityChangeStatus.test.js.map

package/codeyam-cli/src/utils/__tests__/editorEntityChangeStatus.test.js.map

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

package/codeyam-cli/src/utils/__tests__/telemetry.test.js

@@ -0,0 +1,159 @@
+import fs from 'fs';
+import os from 'os';
+import crypto from 'crypto';
+import path from 'path';
+// Mock posthog-node before importing module under test
+const mockCapture = jest.fn();
+const mockFlush = jest.fn().mockResolvedValue(undefined);
+const MockPostHog = jest.fn().mockImplementation(() => ({
+    capture: mockCapture,
+    flush: mockFlush,
+}));
+jest.mock('posthog-node', () => ({
+    PostHog: MockPostHog,
+}));
+import { isTelemetryEnabled, captureEvent, getDistinctId, setTelemetryEnabled, hasNoticeBeenShown, markNoticeShown, _resetForTesting, } from "../telemetry.js";
+describe('telemetry', () => {
+    const originalEnv = process.env;
+    beforeEach(() => {
+        _resetForTesting();
+        jest.clearAllMocks();
+        process.env = { ...originalEnv };
+        delete process.env.DO_NOT_TRACK;
+        delete process.env.CODEYAM_TELEMETRY;
+        delete process.env.CI;
+        jest.spyOn(os, 'homedir').mockReturnValue('/mock-home');
+        jest
+            .spyOn(crypto, 'randomUUID')
+            .mockReturnValue('test-uuid-1234');
+        jest.spyOn(fs, 'readFileSync').mockImplementation(() => {
+            throw new Error('ENOENT');
+        });
+        jest.spyOn(fs, 'writeFileSync').mockImplementation(() => { });
+        jest
+            .spyOn(fs, 'mkdirSync')
+            .mockImplementation(() => undefined);
+    });
+    afterEach(() => {
+        process.env = originalEnv;
+        jest.restoreAllMocks();
+    });
+    describe('isTelemetryEnabled', () => {
+        it('returns true by default when no config exists', () => {
+            expect(isTelemetryEnabled()).toBe(true);
+        });
+        it('returns false when DO_NOT_TRACK=1', () => {
+            process.env.DO_NOT_TRACK = '1';
+            expect(isTelemetryEnabled()).toBe(false);
+        });
+        it('returns false when CODEYAM_TELEMETRY=0', () => {
+            process.env.CODEYAM_TELEMETRY = '0';
+            expect(isTelemetryEnabled()).toBe(false);
+        });
+        it('returns false when CI=true', () => {
+            process.env.CI = 'true';
+            expect(isTelemetryEnabled()).toBe(false);
+        });
+        it('returns false when config has enabled: false', () => {
+            jest.spyOn(fs, 'readFileSync').mockReturnValue(JSON.stringify({
+                enabled: false,
+                distinctId: 'abc',
+                noticeShown: true,
+            }));
+            expect(isTelemetryEnabled()).toBe(false);
+        });
+        it('returns true when config has enabled: true', () => {
+            jest.spyOn(fs, 'readFileSync').mockReturnValue(JSON.stringify({
+                enabled: true,
+                distinctId: 'abc',
+                noticeShown: true,
+            }));
+            expect(isTelemetryEnabled()).toBe(true);
+        });
+    });
+    describe('captureEvent', () => {
+        it('does not call PostHog when telemetry is disabled', () => {
+            process.env.DO_NOT_TRACK = '1';
+            captureEvent('cli_command', { command: 'init' });
+            expect(mockCapture).not.toHaveBeenCalled();
+        });
+        it('calls PostHog capture with correct data when enabled', () => {
+            jest.spyOn(fs, 'readFileSync').mockReturnValue(JSON.stringify({
+                enabled: true,
+                distinctId: 'user-123',
+                noticeShown: true,
+            }));
+            captureEvent('cli_command', { command: 'init' });
+            expect(mockCapture).toHaveBeenCalledWith({
+                distinctId: 'user-123',
+                event: 'cli_command',
+                properties: { command: 'init' },
+            });
+        });
+        it('never throws even if PostHog fails', () => {
+            mockCapture.mockImplementation(() => {
+                throw new Error('network error');
+            });
+            jest.spyOn(fs, 'readFileSync').mockReturnValue(JSON.stringify({
+                enabled: true,
+                distinctId: 'user-123',
+                noticeShown: true,
+            }));
+            expect(() => captureEvent('cli_command', { command: 'init' })).not.toThrow();
+        });
+    });
+    describe('getDistinctId', () => {
+        it('generates and persists a UUID when none exists', () => {
+            const id = getDistinctId();
+            expect(id).toBe('test-uuid-1234');
+            expect(fs.writeFileSync).toHaveBeenCalled();
+            const writtenContent = JSON.parse(fs.writeFileSync.mock.calls[0][1]);
+            expect(writtenContent.distinctId).toBe('test-uuid-1234');
+        });
+        it('returns existing UUID from config', () => {
+            jest.spyOn(fs, 'readFileSync').mockReturnValue(JSON.stringify({
+                enabled: true,
+                distinctId: 'existing-id',
+                noticeShown: false,
+            }));
+            const id = getDistinctId();
+            expect(id).toBe('existing-id');
+            expect(fs.writeFileSync).not.toHaveBeenCalled();
+        });
+    });
+    describe('setTelemetryEnabled', () => {
+        it('writes config with enabled: false', () => {
+            setTelemetryEnabled(false);
+            const writtenContent = JSON.parse(fs.writeFileSync.mock.calls[0][1]);
+            expect(writtenContent.enabled).toBe(false);
+        });
+        it('writes config with enabled: true', () => {
+            setTelemetryEnabled(true);
+            const writtenContent = JSON.parse(fs.writeFileSync.mock.calls[0][1]);
+            expect(writtenContent.enabled).toBe(true);
+        });
+        it('creates ~/.codeyam directory if needed', () => {
+            setTelemetryEnabled(true);
+            expect(fs.mkdirSync).toHaveBeenCalledWith(path.join('/mock-home', '.codeyam'), { recursive: true });
+        });
+    });
+    describe('hasNoticeBeenShown / markNoticeShown', () => {
+        it('returns false when no config exists', () => {
+            expect(hasNoticeBeenShown()).toBe(false);
+        });
+        it('returns true when config has noticeShown: true', () => {
+            jest.spyOn(fs, 'readFileSync').mockReturnValue(JSON.stringify({
+                enabled: true,
+                distinctId: 'abc',
+                noticeShown: true,
+            }));
+            expect(hasNoticeBeenShown()).toBe(true);
+        });
+        it('markNoticeShown writes config with noticeShown: true', () => {
+            markNoticeShown();
+            const writtenContent = JSON.parse(fs.writeFileSync.mock.calls[0][1]);
+            expect(writtenContent.noticeShown).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=telemetry.test.js.map

package/codeyam-cli/src/utils/__tests__/telemetry.test.js.map

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

package/codeyam-cli/src/utils/editorEntityChangeStatus.js

@@ -15,21 +15,27 @@ import { detectFirstFeature, scanPageFilePaths, } from "./entityChangeStatus.ser
 import { buildChangedFilesMap, buildEntityInfosFromScenarios, buildEntityInfosFromGlossary, computeEntityChangeStatus, } from "./entityChangeStatus.js";
 export async function computeEntityChangeStatusForEditor(params) {
     const { projectRoot, scenarioInputs, glossaryInputs } = params;
-    const { map: pageFilePaths } = scanPageFilePaths(projectRoot);
+    const pageFileResult = params.precomputedPageFilePaths ?? scanPageFilePaths(projectRoot);
+    const pageFilePaths = pageFileResult.map;
     const pageEntityNames = new Set(Object.keys(pageFilePaths));
-    const gitFiles = getGitStatusForProject();
+    const gitFiles = params.precomputedGitFiles ?? getGitStatusForProject();
     if (gitFiles.length === 0) {
         return { entityChangeStatus: {}, pageEntityNames };
     }
     const isFirstFeature = detectFirstFeature(projectRoot);
     const changedFiles = buildChangedFilesMap(gitFiles, isFirstFeature);
     let entitiesWithMetadata = [];
-    try {
-        await initializeEnvironment();
-        entitiesWithMetadata = (await loadEntities({})) || [];
+    if (params.precomputedEntities) {
+        entitiesWithMetadata = params.precomputedEntities;
     }
-    catch {
-        // Non-fatal — just won't have importedBy data
+    else {
+        try {
+            await initializeEnvironment();
+            entitiesWithMetadata = (await loadEntities({})) || [];
+        }
+        catch {
+            // Non-fatal — just won't have importedBy data
+        }
     }
     const scenarioEntityInfos = buildEntityInfosFromScenarios(scenarioInputs, pageFilePaths, entitiesWithMetadata);
     let entityInfos = scenarioEntityInfos;

package/codeyam-cli/src/utils/editorEntityChangeStatus.js.map

@@ -1 +1 @@
-{"version":3,"file":"editorEntityChangeStatus.js","sourceRoot":"","sources":["../../../../src/utils/editorEntityChangeStatus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,4BAA4B,EAC5B,yBAAyB,GAI1B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,kCAAkC,CAAC,MAIxD;IAIC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IAC/D,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC9D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpE,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC;IAC1C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,kBAAkB,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,cAAc,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,oBAAoB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAEpE,IAAI,oBAAoB,GAAU,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,qBAAqB,EAAE,CAAC;QAC9B,oBAAoB,GAAG,CAAC,MAAM,YAAY,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;IAChD,CAAC;IAED,MAAM,mBAAmB,GAAG,6BAA6B,CACvD,cAAc,EACd,aAAa,EACb,oBAAoB,CACrB,CAAC;IAEF,IAAI,WAAW,GAAG,mBAAmB,CAAC;IAEtC,IAAI,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,MAAM,mBAAmB,GAAG,4BAA4B,CACtD,cAAc,EACd,aAAa,CACd,CAAC;QACF,WAAW,GAAG,CAAC,GAAG,mBAAmB,EAAE,GAAG,mBAAmB,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,kBAAkB,GAAG,yBAAyB,CAClD,YAAY,EACZ,WAAW,CACZ,CAAC;IACF,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,CAAC;AACjD,CAAC"}
+{"version":3,"file":"editorEntityChangeStatus.js","sourceRoot":"","sources":["../../../../src/utils/editorEntityChangeStatus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,4BAA4B,EAC5B,yBAAyB,GAK1B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,kCAAkC,CAAC,MAWxD;IAIC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IAE/D,MAAM,cAAc,GAClB,MAAM,CAAC,wBAAwB,IAAI,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACpE,MAAM,aAAa,GAAG,cAAc,CAAC,GAAG,CAAC;IACzC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpE,MAAM,QAAQ,GAAG,MAAM,CAAC,mBAAmB,IAAI,sBAAsB,EAAE,CAAC;IACxE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,kBAAkB,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,cAAc,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,oBAAoB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAEpE,IAAI,oBAAoB,GAAU,EAAE,CAAC;IACrC,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC/B,oBAAoB,GAAG,MAAM,CAAC,mBAAmB,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,MAAM,qBAAqB,EAAE,CAAC;YAC9B,oBAAoB,GAAG,CAAC,MAAM,YAAY,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;QAChD,CAAC;IACH,CAAC;IAED,MAAM,mBAAmB,GAAG,6BAA6B,CACvD,cAAc,EACd,aAAa,EACb,oBAAoB,CACrB,CAAC;IAEF,IAAI,WAAW,GAAG,mBAAmB,CAAC;IAEtC,IAAI,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,MAAM,mBAAmB,GAAG,4BAA4B,CACtD,cAAc,EACd,aAAa,CACd,CAAC;QACF,WAAW,GAAG,CAAC,GAAG,mBAAmB,EAAE,GAAG,mBAAmB,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,kBAAkB,GAAG,yBAAyB,CAClD,YAAY,EACZ,WAAW,CACZ,CAAC;IACF,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,CAAC;AACjD,CAAC"}

package/codeyam-cli/src/utils/telemetry.js

@@ -0,0 +1,106 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import crypto from 'crypto';
+import { PostHog } from 'posthog-node';
+// Public, write-only API key — safe to embed (same as dashboard client JS)
+const POSTHOG_API_KEY = 'phc_A31jab4KZfelVaNmdtni7kJ8996BgECSmDp2Qdk2FbK';
+const POSTHOG_HOST = 'https://us.i.posthog.com';
+let cachedConfig = null;
+let posthogClient = null;
+function getConfigPath() {
+    return path.join(os.homedir(), '.codeyam', 'telemetry.json');
+}
+function readConfig() {
+    if (cachedConfig)
+        return cachedConfig;
+    try {
+        const content = fs.readFileSync(getConfigPath(), 'utf-8');
+        const parsed = JSON.parse(content);
+        cachedConfig = {
+            enabled: parsed.enabled ?? true,
+            distinctId: parsed.distinctId ?? '',
+            noticeShown: parsed.noticeShown ?? false,
+        };
+        return cachedConfig;
+    }
+    catch {
+        cachedConfig = { enabled: true, distinctId: '', noticeShown: false };
+        return cachedConfig;
+    }
+}
+function writeConfig(config) {
+    const configPath = getConfigPath();
+    const dir = path.dirname(configPath);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    cachedConfig = config;
+}
+export function isTelemetryEnabled() {
+    if (process.env.DO_NOT_TRACK === '1')
+        return false;
+    if (process.env.CODEYAM_TELEMETRY === '0')
+        return false;
+    if (process.env.CI === 'true')
+        return false;
+    const config = readConfig();
+    return config.enabled !== false;
+}
+export function getDistinctId() {
+    const config = readConfig();
+    if (config.distinctId)
+        return config.distinctId;
+    const id = crypto.randomUUID();
+    writeConfig({ ...config, distinctId: id });
+    return id;
+}
+export function setTelemetryEnabled(enabled) {
+    const config = readConfig();
+    writeConfig({ ...config, enabled });
+}
+export function hasNoticeBeenShown() {
+    return readConfig().noticeShown;
+}
+export function markNoticeShown() {
+    const config = readConfig();
+    writeConfig({ ...config, noticeShown: true });
+}
+function getPostHogClient() {
+    if (posthogClient)
+        return posthogClient;
+    try {
+        posthogClient = new PostHog(POSTHOG_API_KEY, {
+            host: POSTHOG_HOST,
+            flushAt: 1,
+            flushInterval: 5000,
+        });
+        return posthogClient;
+    }
+    catch {
+        return null;
+    }
+}
+export function captureEvent(event, properties) {
+    if (!isTelemetryEnabled())
+        return;
+    try {
+        const client = getPostHogClient();
+        if (!client)
+            return;
+        client.capture({
+            distinctId: getDistinctId(),
+            event,
+            properties,
+        });
+        client.flush().catch(() => { });
+    }
+    catch {
+        // Fire-and-forget, never throw
+    }
+}
+/** Reset module state — for testing only */
+export function _resetForTesting() {
+    cachedConfig = null;
+    posthogClient = null;
+}
+//# sourceMappingURL=telemetry.js.map

package/codeyam-cli/src/utils/telemetry.js.map

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

package/codeyam-cli/src/utils/telemetryMiddleware.js

@@ -0,0 +1,22 @@
+import chalk from 'chalk';
+import { isTelemetryEnabled, captureEvent, hasNoticeBeenShown, markNoticeShown, } from "./telemetry.js";
+import { cliVersion } from "./versionInfo.js";
+/**
+ * Yargs middleware that fires a telemetry event for every CLI invocation
+ * and shows a one-time opt-out notice on first run.
+ */
+export function telemetryMiddleware(argv) {
+    // Show one-time notice on first run
+    if (isTelemetryEnabled() && !hasNoticeBeenShown()) {
+        console.log(chalk.dim('CodeYam collects anonymous usage data to improve the product. ' +
+            'Run "codeyam telemetry disable" to opt out.'));
+        markNoticeShown();
+    }
+    captureEvent('cli_command', {
+        command: String(argv._[0] ?? '$0'),
+        cli_version: cliVersion,
+        os_platform: process.platform,
+        node_version: process.version,
+    });
+}
+//# sourceMappingURL=telemetryMiddleware.js.map

package/codeyam-cli/src/utils/telemetryMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetryMiddleware.js","sourceRoot":"","sources":["../../../../src/utils/telemetryMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAGnC;IACC,oCAAoC;IACpC,IAAI,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAClD,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CACP,gEAAgE;YAC9D,6CAA6C,CAChD,CACF,CAAC;QACF,eAAe,EAAE,CAAC;IACpB,CAAC;IAED,YAAY,CAAC,aAAa,EAAE;QAC1B,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAClC,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE,OAAO,CAAC,QAAQ;QAC7B,YAAY,EAAE,OAAO,CAAC,OAAO;KAC9B,CAAC,CAAC;AACL,CAAC"}

package/codeyam-cli/src/webserver/__tests__/editorProxy.test.js

@@ -465,6 +465,34 @@ describe('editorProxy', () => {
             // No config at all — returns empty string, no watcher needed
             expect(buildLocalStorageScript(null, 'scenario-1')).toBe('');
         });
+        it('should re-seed localStorage when scenario data changes even if ID is the same', () => {
+            // BUG: When a scenario is re-registered with updated data (e.g., adding
+            // collections to articles), the scenario ID stays the same. The guard
+            // checked only the ID, so the browser skipped re-seeding and showed stale
+            // data. The screenshot (captured by Playwright with a fresh browser)
+            // showed the new data, but the live preview didn't.
+            const { buildLocalStorageScript } = require('../editorProxy');
+            const originalData = {
+                articles: '[{"id":"a1","title":"Test"}]',
+            };
+            const updatedData = {
+                articles: '[{"id":"a1","title":"Test","collectionIds":["c1"]}]',
+                collections: '[{"id":"c1","name":"Dev"}]',
+            };
+            const script1 = buildLocalStorageScript(originalData, 'scenario-abc');
+            const script2 = buildLocalStorageScript(updatedData, 'scenario-abc');
+            // Both scripts use the same scenario ID
+            expect(script1).toContain('scenario-abc');
+            expect(script2).toContain('scenario-abc');
+            // The guard values must be DIFFERENT so the browser re-seeds
+            // Extract the guard comparison value from each script
+            const guardPattern = /__codeyam_ls_sid__.*?===\s*([^\)]+)\)/;
+            const guard1 = script1.match(guardPattern)?.[1];
+            const guard2 = script2.match(guardPattern)?.[1];
+            expect(guard1).toBeDefined();
+            expect(guard2).toBeDefined();
+            expect(guard1).not.toEqual(guard2);
+        });
     });
     describe('localStorage injection in HTML responses', () => {
         it('should inject localStorage script before health script in HTML', () => {