@skillsmith/cli 0.6.2 → 0.6.3

package/dist/src/commands/telemetry.test.js

@@ -0,0 +1,401 @@
+/**
+ * @fileoverview Tests for `skillsmith telemetry` subcommands.
+ * @module @skillsmith/cli/commands/telemetry.test
+ * @see SMI-5021 Wave 3 Step 2 — plan lines 700, 703, 706
+ *
+ * Covers:
+ *   enable: fresh manifest → generates id, sets enabled=true; idempotent on re-run
+ *   disable: enabled manifest → sets enabled=false; anonymousId preserved
+ *   status: prints expected shape (ID tail only); detects + triggers rotation when backdated >365d
+ *   reset-id: rotates unconditionally; new id distinct; previous id populated
+ *   install-hook (mocked): adds PreToolUse+PostToolUse; idempotent; throws on foreign Skill matcher
+ *   uninstall-hook: removes only Skillsmith entries; preserves foreign hooks
+ *   install-hook --scope project: writes to ./.claude/settings.json
+ *
+ * Privacy invariant: idTail() — last 8 chars only, never full id.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+// ---------------------------------------------------------------------------
+// fs/promises mock (for manifest.ts)
+// ---------------------------------------------------------------------------
+const memfsAsync = {};
+vi.mock('fs/promises', () => ({
+    mkdir: vi.fn(async () => undefined),
+    writeFile: vi.fn(async (path, content) => {
+        memfsAsync[path] = content;
+    }),
+    rename: vi.fn(async (src, dst) => {
+        const content = memfsAsync[src];
+        if (content === undefined)
+            throw Object.assign(new Error(`ENOENT: ${src}`), { code: 'ENOENT' });
+        memfsAsync[dst] = content;
+        delete memfsAsync[src];
+    }),
+    readFile: vi.fn(async (path) => {
+        const content = memfsAsync[path];
+        if (content === undefined)
+            throw Object.assign(new Error(`ENOENT: ${path}`), { code: 'ENOENT' });
+        return content;
+    }),
+}));
+// ---------------------------------------------------------------------------
+// node:fs mock (for telemetry.helpers.ts — settings.json operations)
+// ---------------------------------------------------------------------------
+const memfsSync = {};
+vi.mock('node:fs', () => ({
+    existsSync: vi.fn((p) => p in memfsSync),
+    readFileSync: vi.fn((path) => {
+        const c = memfsSync[path];
+        if (c === undefined)
+            throw Object.assign(new Error(`ENOENT: ${path}`), { code: 'ENOENT' });
+        return c;
+    }),
+    writeFileSync: vi.fn((path, content) => {
+        memfsSync[path] = content;
+    }),
+    renameSync: vi.fn((src, dst) => {
+        const c = memfsSync[src];
+        if (c === undefined)
+            throw new Error(`ENOENT: ${src}`);
+        memfsSync[dst] = c;
+        delete memfsSync[src];
+    }),
+    mkdirSync: vi.fn(() => undefined),
+    chmodSync: vi.fn(() => undefined),
+    copyFileSync: vi.fn((src, dst) => {
+        memfsSync[dst] = memfsSync[src] ?? '# stub hook script';
+    }),
+    unlinkSync: vi.fn((p) => {
+        delete memfsSync[p];
+    }),
+    readdirSync: vi.fn(() => []),
+    statSync: vi.fn(() => ({ mtimeMs: Date.now() - 1000 })),
+}));
+// ---------------------------------------------------------------------------
+// Import after mocks are registered
+// ---------------------------------------------------------------------------
+import { runEnable, runDisable, runStatus, runResetId, runInstallHook, runUninstallHook, idTail, } from './telemetry.js';
+import { loadManifest, saveManifest, generateAnonymousId, } from '../utils/manifest.js';
+import { resolveSettingsPath } from './telemetry.helpers.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function daysAgo(n) {
+    return new Date(Date.now() - n * 86_400_000).toISOString();
+}
+async function seedManifest(telemetry) {
+    await saveManifest({ version: '1.0.0', installedSkills: {}, telemetry });
+}
+function captureConsole() {
+    const lines = [];
+    const origLog = console.log;
+    const origWarn = console.warn;
+    const origError = console.error;
+    vi.spyOn(console, 'log').mockImplementation((...args) => lines.push(args.join(' ')));
+    vi.spyOn(console, 'warn').mockImplementation((...args) => lines.push(args.join(' ')));
+    vi.spyOn(console, 'error').mockImplementation((...args) => lines.push(args.join(' ')));
+    return {
+        lines,
+        restore() {
+            console.log = origLog;
+            console.warn = origWarn;
+            console.error = origError;
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Setup / teardown
+// ---------------------------------------------------------------------------
+beforeEach(() => {
+    for (const k of Object.keys(memfsAsync))
+        delete memfsAsync[k];
+    for (const k of Object.keys(memfsSync))
+        delete memfsSync[k];
+    vi.clearAllMocks();
+});
+afterEach(() => {
+    for (const k of Object.keys(memfsAsync))
+        delete memfsAsync[k];
+    for (const k of Object.keys(memfsSync))
+        delete memfsSync[k];
+    vi.restoreAllMocks();
+});
+// ---------------------------------------------------------------------------
+// enable
+// ---------------------------------------------------------------------------
+describe('telemetry enable', () => {
+    it('generates an anonymousId and sets enabled=true on fresh manifest', async () => {
+        await runEnable();
+        const m = await loadManifest();
+        expect(m.telemetry?.enabled).toBe(true);
+        expect(m.telemetry?.anonymousId).toMatch(/^[0-9a-f]{64}$/);
+        expect(m.telemetry?.anonymousIdCreatedAt).toBeDefined();
+        expect(m.telemetry?.scope).toBe('personal');
+    });
+    it('is idempotent — second enable does not change the anonymousId', async () => {
+        await runEnable();
+        const firstId = (await loadManifest()).telemetry?.anonymousId;
+        await runEnable();
+        const secondId = (await loadManifest()).telemetry?.anonymousId;
+        expect(firstId).toBe(secondId);
+    });
+    it('does not overwrite an existing anonymousId when re-enabling after disable', async () => {
+        const existingId = generateAnonymousId();
+        await seedManifest({ enabled: false, anonymousId: existingId });
+        await runEnable();
+        const m = await loadManifest();
+        expect(m.telemetry?.anonymousId).toBe(existingId);
+        expect(m.telemetry?.enabled).toBe(true);
+    });
+});
+// ---------------------------------------------------------------------------
+// disable
+// ---------------------------------------------------------------------------
+describe('telemetry disable', () => {
+    it('sets enabled=false while preserving the anonymousId', async () => {
+        const id = generateAnonymousId();
+        await seedManifest({ enabled: true, anonymousId: id });
+        await runDisable();
+        const m = await loadManifest();
+        expect(m.telemetry?.enabled).toBe(false);
+        // anonymousId must be preserved for re-enable continuity (plan line 719)
+        expect(m.telemetry?.anonymousId).toBe(id);
+    });
+    it('is a no-op when already disabled', async () => {
+        await seedManifest({ enabled: false });
+        const cap = captureConsole();
+        try {
+            await runDisable();
+        }
+        finally {
+            cap.restore();
+        }
+        expect(cap.lines.some((l) => l.includes('already disabled'))).toBe(true);
+    });
+});
+// ---------------------------------------------------------------------------
+// status
+// ---------------------------------------------------------------------------
+describe('telemetry status', () => {
+    it('prints anonymousId-tail (last 8 chars) but not the full id', async () => {
+        const id = generateAnonymousId();
+        await seedManifest({
+            enabled: true,
+            anonymousId: id,
+            anonymousIdCreatedAt: new Date().toISOString(),
+            scope: 'personal',
+        });
+        const cap = captureConsole();
+        try {
+            await runStatus();
+        }
+        finally {
+            cap.restore();
+        }
+        const output = cap.lines.join('\n');
+        // Privacy: tail only
+        expect(output).toContain(`...${id.slice(-8)}`);
+        // Privacy: full id must not appear
+        expect(output).not.toContain(id);
+    });
+    it('triggers rotation and reports "rotation triggered" when anonymousIdCreatedAt > 365d ago', async () => {
+        const oldId = generateAnonymousId();
+        await seedManifest({
+            enabled: true,
+            anonymousId: oldId,
+            anonymousIdCreatedAt: daysAgo(400),
+        });
+        const cap = captureConsole();
+        try {
+            await runStatus();
+        }
+        finally {
+            cap.restore();
+        }
+        const output = cap.lines.join('\n');
+        expect(output.toLowerCase()).toContain('rotation triggered');
+        // The manifest should now have a new id
+        const m = await loadManifest();
+        expect(m.telemetry?.anonymousId).not.toBe(oldId);
+        expect(m.telemetry?.previousAnonymousId).toBe(oldId);
+    });
+    it('shows enabled=no when telemetry is disabled', async () => {
+        await seedManifest({ enabled: false });
+        const cap = captureConsole();
+        try {
+            await runStatus();
+        }
+        finally {
+            cap.restore();
+        }
+        const output = cap.lines.join('\n');
+        expect(output).toContain('no');
+        expect(output.toLowerCase()).toContain('enabled');
+    });
+});
+// ---------------------------------------------------------------------------
+// reset-id
+// ---------------------------------------------------------------------------
+describe('telemetry reset-id', () => {
+    it('rotates unconditionally even when id is young (< 365d)', async () => {
+        const currentId = generateAnonymousId();
+        await seedManifest({
+            enabled: true,
+            anonymousId: currentId,
+            anonymousIdCreatedAt: new Date().toISOString(), // brand new
+        });
+        await runResetId();
+        const m = await loadManifest();
+        expect(m.telemetry?.anonymousId).toBeDefined();
+        expect(m.telemetry?.anonymousId).not.toBe(currentId);
+    });
+    it('populates previousAnonymousId with the old id', async () => {
+        const currentId = generateAnonymousId();
+        await seedManifest({
+            enabled: true,
+            anonymousId: currentId,
+            anonymousIdCreatedAt: new Date().toISOString(),
+        });
+        await runResetId();
+        const m = await loadManifest();
+        expect(m.telemetry?.previousAnonymousId).toBe(currentId);
+    });
+    it('new id is distinct from current and previous', async () => {
+        const currentId = generateAnonymousId();
+        const previousId = generateAnonymousId();
+        await seedManifest({
+            enabled: true,
+            anonymousId: currentId,
+            previousAnonymousId: previousId,
+            anonymousIdCreatedAt: new Date().toISOString(),
+        });
+        await runResetId();
+        const m = await loadManifest();
+        const newId = m.telemetry?.anonymousId;
+        expect(newId).toBeDefined();
+        expect(newId).not.toBe(currentId);
+        expect(newId).not.toBe(previousId);
+    });
+    it('prints new ID tail (not full id) to stdout', async () => {
+        const currentId = generateAnonymousId();
+        await seedManifest({
+            enabled: true,
+            anonymousId: currentId,
+            anonymousIdCreatedAt: new Date().toISOString(),
+        });
+        const cap = captureConsole();
+        try {
+            await runResetId();
+        }
+        finally {
+            cap.restore();
+        }
+        const m = await loadManifest();
+        const newId = m.telemetry?.anonymousId;
+        if (!newId)
+            throw new Error('telemetry.anonymousId missing after runResetId');
+        const output = cap.lines.join('\n');
+        // Tail visible
+        expect(output).toContain(`...${newId.slice(-8)}`);
+        // Full new id NOT in output
+        expect(output).not.toContain(newId);
+    });
+});
+// Shared constant — used by both install-hook and uninstall-hook describe blocks.
+const HOOK_PATH_TEST = `${process.env['HOME'] ?? '/tmp'}/.skillsmith/hooks/skill-telemetry.sh`;
+// ---------------------------------------------------------------------------
+// install-hook
+// ---------------------------------------------------------------------------
+describe('telemetry install-hook', () => {
+    it('adds PreToolUse and PostToolUse Skill entries to empty settings.json', async () => {
+        // Seed template in memfsSync so copyFileSync does not throw
+        memfsSync['/stub/templates/skill-telemetry.sh'] = '#!/bin/sh\n';
+        // Mock existsSync to return true for template path
+        const { existsSync } = await import('node:fs');
+        existsSync.mockImplementation((p) => {
+            if (String(p).includes('skill-telemetry.sh') && !String(p).includes('.skillsmith/hooks'))
+                return true;
+            return p in memfsSync;
+        });
+        await runInstallHook({ scope: 'user' });
+        const settingsPath = resolveSettingsPath('user');
+        const raw = memfsSync[settingsPath];
+        expect(raw).toBeDefined();
+        const parsed = JSON.parse(raw);
+        expect(parsed.hooks.PreToolUse).toHaveLength(1);
+        expect(parsed.hooks.PostToolUse).toHaveLength(1);
+    });
+    it('is idempotent — installing twice does not add duplicate entries', async () => {
+        const { existsSync } = await import('node:fs');
+        existsSync.mockImplementation((p) => {
+            if (String(p).includes('skill-telemetry.sh') && !String(p).includes('.skillsmith/hooks'))
+                return true;
+            return p in memfsSync;
+        });
+        await runInstallHook({ scope: 'user' });
+        await runInstallHook({ scope: 'user' });
+        const settingsPath = resolveSettingsPath('user');
+        const parsed = JSON.parse(memfsSync[settingsPath]);
+        expect(parsed.hooks.PreToolUse).toHaveLength(1);
+    });
+    it('uses ./.claude/settings.json when scope is project', async () => {
+        const { existsSync } = await import('node:fs');
+        existsSync.mockImplementation((p) => {
+            if (String(p).includes('skill-telemetry.sh') && !String(p).includes('.skillsmith/hooks'))
+                return true;
+            return p in memfsSync;
+        });
+        await runInstallHook({ scope: 'project' });
+        const projectPath = resolveSettingsPath('project');
+        expect(memfsSync[projectPath]).toBeDefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// uninstall-hook
+// ---------------------------------------------------------------------------
+describe('telemetry uninstall-hook', () => {
+    it('removes only Skillsmith entries; does not touch foreign hooks', async () => {
+        // Seed settings with a Bash hook + Skillsmith Skill hook
+        const settingsPath = resolveSettingsPath('user');
+        memfsSync[settingsPath] = JSON.stringify({
+            hooks: {
+                PreToolUse: [
+                    { matcher: 'Bash', hooks: [{ type: 'command', command: 'echo bash' }] },
+                    { matcher: 'Skill', hooks: [{ type: 'command', command: `${HOOK_PATH_TEST} pre` }] },
+                ],
+                PostToolUse: [
+                    { matcher: 'Skill', hooks: [{ type: 'command', command: `${HOOK_PATH_TEST} post` }] },
+                ],
+            },
+        });
+        await runUninstallHook({ scope: 'user' });
+        const raw = memfsSync[settingsPath];
+        expect(raw).toBeDefined();
+        const parsed = JSON.parse(raw);
+        // Bash hook preserved
+        expect(parsed.hooks.PreToolUse.some((e) => e.matcher === 'Bash')).toBe(true);
+        // Skill hook removed
+        expect(parsed.hooks.PreToolUse.some((e) => e.matcher === 'Skill')).toBe(false);
+        expect(parsed.hooks.PostToolUse.some((e) => e.matcher === 'Skill')).toBe(false);
+    });
+});
+// ---------------------------------------------------------------------------
+// idTail — privacy invariant unit test
+// ---------------------------------------------------------------------------
+describe('idTail privacy invariant', () => {
+    it('returns only the last 8 characters of the id', () => {
+        const id = 'a'.repeat(56) + 'b'.repeat(8);
+        expect(idTail(id)).toBe('...bbbbbbbb');
+        expect(idTail(id)).not.toContain('a'.repeat(56));
+    });
+    it('returns (none) when id is undefined', () => {
+        expect(idTail(undefined)).toBe('(none)');
+    });
+    it('never leaks the full SHA-256 hex (64 chars) in the returned string', () => {
+        const id = generateAnonymousId();
+        const tail = idTail(id);
+        expect(tail.length).toBeLessThan(20); // "..." + 8 chars = 11 chars max
+        expect(tail).not.toBe(id);
+    });
+});
+//# sourceMappingURL=telemetry.test.js.map

package/dist/src/commands/telemetry.test.js.map

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

package/dist/src/index.js

@@ -19,7 +19,7 @@
  * - setup: Install skillsmith skill for /skillsmith slash command (SMI-824, renamed from install-skill)
  */
 import { Command } from 'commander';
-import { createSearchCommand, createListCommand, createUpdateCommand, createRemoveCommand, createInitCommand, createValidateCommand, createPublishCommand, createSubagentCommand, createTransformCommand, createMcpInitCommand, createAnalyzeCommand, createRecommendCommand, createSyncCommand, createInstallCommand, createInstallSkillCommand, createLoginCommand, createLogoutCommand, createWhoamiCommand, createDiffCommand, createPinCommand, createUnpinCommand, createAuditCommand, createCreateCommand, createInfoCommand, createImportCommand, createImportLocalCommand, createConfigCommand, } from './commands/index.js';
+import { createSearchCommand, createListCommand, createUpdateCommand, createRemoveCommand, createInitCommand, createValidateCommand, createPublishCommand, createSubagentCommand, createTransformCommand, createMcpInitCommand, createAnalyzeCommand, createRecommendCommand, createSyncCommand, createInstallCommand, createInstallSkillCommand, createLoginCommand, createLogoutCommand, createWhoamiCommand, createDiffCommand, createPinCommand, createUnpinCommand, createAuditCommand, createCreateCommand, createInfoCommand, createImportCommand, createImportLocalCommand, createConfigCommand, createTelemetryCommand, } from './commands/index.js';
 import { displayStartupHeader } from './utils/license.js';
 import { checkNodeVersion } from './utils/node-version.js';
 import { readFileSync } from 'fs';
@@ -107,5 +107,7 @@ program.addCommand(createCreateCommand());
 program.addCommand(createInfoCommand());
 // SMI-4590 Wave 4 PR 5/6: `sklx config get/set audit_mode`
 program.addCommand(createConfigCommand());
+// SMI-5021 Wave 3: telemetry opt-in + Claude Code hook management
+program.addCommand(createTelemetryCommand());
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/src/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/src/utils/manifest.d.ts

@@ -2,6 +2,7 @@
  * @fileoverview Thin manifest reader for the Skillsmith CLI
  * @module @skillsmith/cli/utils/manifest
  * @see SMI-skill-version-tracking Wave 2
+ * @see SMI-5012 Wave 3: telemetry block + annual anonymous_id rotation
  *
  * Reads (and optionally writes) the ~/.skillsmith/manifest.json file.
  * This mirrors the SkillManifest types defined in
@@ -10,6 +11,14 @@
  *
  * The CLI owns its own read path; write operations (pin/unpin) use
  * updateManifestEntry below which does an atomic temp-file rename.
+ *
+ * Concurrency note (v1): the atomic temp-file rename guarantees readers never
+ * see partial writes (POSIX rename(2) is atomic). A full file-lock (proper-lockfile)
+ * is NOT used here because proper-lockfile is not in the CLI's dependencies.
+ * v1 assumes single-writer-per-process; concurrent writers from the same machine
+ * (e.g., two concurrent `skillsmith telemetry` calls) may last-write-wins.
+ * This matches the shared-state matrix entry (plan line 715) which notes the
+ * proper-lockfile pattern but is aspirational for v2.
  */
 export interface SkillManifestEntry {
     id: string;
@@ -28,6 +37,41 @@ export interface SkillManifestEntry {
 export interface SkillManifest {
     version: string;
     installedSkills: Record<string, SkillManifestEntry>;
+    /** SMI-5012 W3: telemetry opt-in block. Absent on older configs; treated as { enabled: false }. */
+    telemetry?: TelemetryManifest;
+}
+/**
+ * Telemetry configuration stored in ~/.skillsmith/manifest.json.
+ *
+ * Schema is additive: older configs without this block continue to load
+ * (missing block is treated as { enabled: false } everywhere it is read).
+ *
+ * anonymous_id rotation policy (U6 / M7):
+ *   - Generated via SHA-256(crypto.randomUUID()) on first opt-in
+ *   - Auto-rotates after 365 days (checked on `skillsmith telemetry status`)
+ *   - One-week overlap window: previous id is retained in previousAnonymousId
+ *     until previousAnonymousIdRetiredAt so cross-rotation events can be joined
+ *   - Manual rotation: `skillsmith telemetry reset-id` (SMI-5021)
+ */
+export interface TelemetryManifest {
+    /** Whether telemetry is enabled. Always opt-in; default false. */
+    enabled: boolean;
+    /** SHA-256 hex of a random UUID; 64 hex chars. Present only when enabled. */
+    anonymousId?: string;
+    /** ISO-8601 date when anonymousId was generated. Enables annual rotation check. */
+    anonymousIdCreatedAt?: string;
+    /** Previous anonymousId retained for one-week overlap window after rotation. */
+    previousAnonymousId?: string;
+    /** ISO-8601 date after which previousAnonymousId can be swept. */
+    previousAnonymousIdRetiredAt?: string;
+    /** Telemetry scope. Default 'personal'. */
+    scope?: 'personal' | 'team';
+    /** Present when scope === 'team'. */
+    teamId?: string;
+    /** Override for staging. Default: prod events endpoint. */
+    endpoint?: string;
+    /** ISO-8601 date when the Claude Code hook was last installed. */
+    installedAt?: string;
 }
 export declare const MANIFEST_PATH: string;
 /**
@@ -43,4 +87,35 @@ export declare function saveManifest(manifest: SkillManifest): Promise<void>;
  * Load the manifest, apply an update function, and save atomically.
  */
 export declare function updateManifestEntry(updateFn: (manifest: SkillManifest) => SkillManifest): Promise<void>;
+/**
+ * Generate a new anonymous telemetry id.
+ *
+ * Returns SHA-256(crypto.randomUUID()) as a 64-character lowercase hex string.
+ * The UUID is not stored; only the hash reaches the wire (plan line 719).
+ */
+export declare function generateAnonymousId(): string;
+/**
+ * Returns true if the manifest's anonymousId should be rotated.
+ *
+ * Rotation is triggered when anonymousIdCreatedAt is older than 365 days.
+ * Returns false if the field is absent (id was never generated).
+ */
+export declare function shouldRotateAnonymousId(manifest: SkillManifest): boolean;
+/**
+ * Rotate the anonymous id.
+ *
+ * Moves the current id to previousAnonymousId with a 7-day retirement window,
+ * generates a fresh id, and updates anonymousIdCreatedAt to now.
+ * Returns a new TelemetryManifest — does NOT write to disk.
+ * Callers must persist via saveManifest / updateManifestEntry.
+ */
+export declare function rotateAnonymousId(manifest: SkillManifest): TelemetryManifest;
+/**
+ * Remove previousAnonymousId once its retirement window has passed.
+ *
+ * Should be called on every `skillsmith telemetry status` run and before
+ * each hook-script read. No-op if the window has not yet elapsed or if
+ * there is no previous id. Returns a new TelemetryManifest.
+ */
+export declare function sweepExpiredPreviousId(manifest: SkillManifest): TelemetryManifest;
 //# sourceMappingURL=manifest.d.ts.map

package/dist/src/utils/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/utils/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;CACpD;AAOD,eAAO,MAAM,aAAa,QAAwC,CAAA;AAMlE;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC,CAO3D;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,aAAa,GACnD,OAAO,CAAC,IAAI,CAAC,CAIf"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/utils/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAWH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;IACnD,mGAAmG;IACnG,SAAS,CAAC,EAAE,iBAAiB,CAAA;CAC9B;AAMD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAA;IAChB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mFAAmF;IACnF,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,gFAAgF;IAChF,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,kEAAkE;IAClE,4BAA4B,CAAC,EAAE,MAAM,CAAA;IACrC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,UAAU,GAAG,MAAM,CAAA;IAC3B,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAOD,eAAO,MAAM,aAAa,QAAwC,CAAA;AAMlE;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC,CAO3D;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,aAAa,GACnD,OAAO,CAAC,IAAI,CAAC,CAIf;AAUD;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAKxE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,iBAAiB,CAc5E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,aAAa,GAAG,iBAAiB,CAOjF"}