@office-ai/aioncli-core 0.30.0 → 0.30.1

package/dist/src/services/keychainTypes.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+/**
+ * Interface for OS-level secure storage operations.
+ * Note: Method names must match the underlying library (e.g. keytar)
+ * to support correct dynamic loading and schema validation.
+ */
+export interface Keychain {
+    getPassword(service: string, account: string): Promise<string | null>;
+    setPassword(service: string, account: string, password: string): Promise<void>;
+    deletePassword(service: string, account: string): Promise<boolean>;
+    findCredentials(service: string): Promise<Array<{
+        account: string;
+        password: string;
+    }>>;
+}
+/**
+ * Zod schema to validate that a module satisfies the Keychain interface.
+ */
+export declare const KeychainSchema: z.ZodObject<{
+    getPassword: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>;
+    setPassword: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>;
+    deletePassword: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>;
+    findCredentials: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    getPassword: (...args: unknown[]) => unknown;
+    setPassword: (...args: unknown[]) => unknown;
+    deletePassword: (...args: unknown[]) => unknown;
+    findCredentials: (...args: unknown[]) => unknown;
+}, {
+    getPassword: (...args: unknown[]) => unknown;
+    setPassword: (...args: unknown[]) => unknown;
+    deletePassword: (...args: unknown[]) => unknown;
+    findCredentials: (...args: unknown[]) => unknown;
+}>;
+export declare const KEYCHAIN_TEST_PREFIX = "__keychain_test__";
+export declare const SECRET_PREFIX = "__secret__";

package/dist/src/services/keychainTypes.js

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+/**
+ * Zod schema to validate that a module satisfies the Keychain interface.
+ */
+export const KeychainSchema = z.object({
+    getPassword: z.function(),
+    setPassword: z.function(),
+    deletePassword: z.function(),
+    findCredentials: z.function(),
+});
+export const KEYCHAIN_TEST_PREFIX = '__keychain_test__';
+export const SECRET_PREFIX = '__secret__';
+//# sourceMappingURL=keychainTypes.js.map

package/dist/src/services/keychainTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keychainTypes.js","sourceRoot":"","sources":["../../../src/services/keychainTypes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,WAAW,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzB,WAAW,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzB,cAAc,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5B,eAAe,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AACxD,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC"}

package/dist/src/services/trackerService.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type TrackerTask } from './trackerTypes.js';
+export declare class TrackerService {
+    readonly trackerDir: string;
+    private readonly tasksDir;
+    private initialized;
+    constructor(trackerDir: string);
+    private ensureInitialized;
+    /**
+     * Generates a 6-character hex ID.
+     */
+    private generateId;
+    /**
+     * Creates a new task and saves it to disk.
+     */
+    createTask(taskData: Omit<TrackerTask, 'id'>): Promise<TrackerTask>;
+    /**
+     * Helper to read and validate a JSON file.
+     */
+    private readJsonFile;
+    /**
+     * Reads a task by ID.
+     */
+    getTask(id: string): Promise<TrackerTask | null>;
+    /**
+     * Lists all tasks in the tracker.
+     */
+    listTasks(): Promise<TrackerTask[]>;
+    /**
+     * Updates an existing task and saves it to disk.
+     */
+    updateTask(id: string, updates: Partial<TrackerTask>): Promise<TrackerTask>;
+    /**
+     * Saves a task to disk.
+     */
+    private saveTask;
+    /**
+     * Validates that a task can be closed (all dependencies must be closed).
+     */
+    private validateCanClose;
+    /**
+     * Validates that there are no circular dependencies.
+     */
+    private validateNoCircularDependencies;
+}

package/dist/src/services/trackerService.js

@@ -0,0 +1,193 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { randomBytes } from 'node:crypto';
+import { debugLogger } from '../utils/debugLogger.js';
+import { coreEvents } from '../utils/events.js';
+import { TrackerTaskSchema, TaskStatus, } from './trackerTypes.js';
+import {} from 'zod';
+export class TrackerService {
+    trackerDir;
+    tasksDir;
+    initialized = false;
+    constructor(trackerDir) {
+        this.trackerDir = trackerDir;
+        this.tasksDir = trackerDir;
+    }
+    async ensureInitialized() {
+        if (!this.initialized) {
+            await fs.mkdir(this.tasksDir, { recursive: true });
+            this.initialized = true;
+        }
+    }
+    /**
+     * Generates a 6-character hex ID.
+     */
+    generateId() {
+        return randomBytes(3).toString('hex');
+    }
+    /**
+     * Creates a new task and saves it to disk.
+     */
+    async createTask(taskData) {
+        await this.ensureInitialized();
+        const id = this.generateId();
+        const task = {
+            ...taskData,
+            id,
+        };
+        if (task.parentId) {
+            const parentList = await this.listTasks();
+            if (!parentList.find((t) => t.id === task.parentId)) {
+                throw new Error(`Parent task with ID ${task.parentId} not found.`);
+            }
+        }
+        TrackerTaskSchema.parse(task);
+        await this.saveTask(task);
+        return task;
+    }
+    /**
+     * Helper to read and validate a JSON file.
+     */
+    async readJsonFile(filePath, schema) {
+        try {
+            const content = await fs.readFile(filePath, 'utf8');
+            const data = JSON.parse(content);
+            return schema.parse(data);
+        }
+        catch (error) {
+            if (error &&
+                typeof error === 'object' &&
+                'code' in error &&
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+                error.code === 'ENOENT') {
+                return null;
+            }
+            const fileName = path.basename(filePath);
+            debugLogger.warn(`Failed to read or parse task file ${fileName}:`, error);
+            coreEvents.emitFeedback('warning', `Task tracker encountered an issue reading ${fileName}. The data might be corrupted.`, error);
+            throw error;
+        }
+    }
+    /**
+     * Reads a task by ID.
+     */
+    async getTask(id) {
+        await this.ensureInitialized();
+        const taskPath = path.join(this.tasksDir, `${id}.json`);
+        return this.readJsonFile(taskPath, TrackerTaskSchema);
+    }
+    /**
+     * Lists all tasks in the tracker.
+     */
+    async listTasks() {
+        await this.ensureInitialized();
+        try {
+            const files = await fs.readdir(this.tasksDir);
+            const jsonFiles = files.filter((f) => f.endsWith('.json'));
+            const tasks = await Promise.all(jsonFiles.map(async (f) => {
+                const taskPath = path.join(this.tasksDir, f);
+                return this.readJsonFile(taskPath, TrackerTaskSchema);
+            }));
+            return tasks.filter((t) => t !== null);
+        }
+        catch (error) {
+            if (error &&
+                typeof error === 'object' &&
+                'code' in error &&
+                error.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
+        }
+    }
+    /**
+     * Updates an existing task and saves it to disk.
+     */
+    async updateTask(id, updates) {
+        const isClosing = updates.status === TaskStatus.CLOSED;
+        const changingDependencies = updates.dependencies !== undefined;
+        let taskMap;
+        if (isClosing || changingDependencies) {
+            const allTasks = await this.listTasks();
+            taskMap = new Map(allTasks.map((t) => [t.id, t]));
+        }
+        const task = taskMap ? taskMap.get(id) : await this.getTask(id);
+        if (!task) {
+            throw new Error(`Task with ID ${id} not found.`);
+        }
+        const updatedTask = { ...task, ...updates, id: task.id };
+        if (updatedTask.parentId) {
+            const parentExists = taskMap
+                ? taskMap.has(updatedTask.parentId)
+                : !!(await this.getTask(updatedTask.parentId));
+            if (!parentExists) {
+                throw new Error(`Parent task with ID ${updatedTask.parentId} not found.`);
+            }
+        }
+        if (taskMap) {
+            if (isClosing && task.status !== TaskStatus.CLOSED) {
+                this.validateCanClose(updatedTask, taskMap);
+            }
+            if (changingDependencies) {
+                taskMap.set(updatedTask.id, updatedTask);
+                this.validateNoCircularDependencies(updatedTask, taskMap);
+            }
+        }
+        TrackerTaskSchema.parse(updatedTask);
+        await this.saveTask(updatedTask);
+        return updatedTask;
+    }
+    /**
+     * Saves a task to disk.
+     */
+    async saveTask(task) {
+        const taskPath = path.join(this.tasksDir, `${task.id}.json`);
+        await fs.writeFile(taskPath, JSON.stringify(task, null, 2), 'utf8');
+    }
+    /**
+     * Validates that a task can be closed (all dependencies must be closed).
+     */
+    validateCanClose(task, taskMap) {
+        for (const depId of task.dependencies) {
+            const dep = taskMap.get(depId);
+            if (!dep) {
+                throw new Error(`Dependency ${depId} not found for task ${task.id}.`);
+            }
+            if (dep.status !== TaskStatus.CLOSED) {
+                throw new Error(`Cannot close task ${task.id} because dependency ${depId} is still ${dep.status}.`);
+            }
+        }
+    }
+    /**
+     * Validates that there are no circular dependencies.
+     */
+    validateNoCircularDependencies(task, taskMap) {
+        const visited = new Set();
+        const stack = new Set();
+        const check = (currentId) => {
+            if (stack.has(currentId)) {
+                throw new Error(`Circular dependency detected involving task ${currentId}.`);
+            }
+            if (visited.has(currentId)) {
+                return;
+            }
+            visited.add(currentId);
+            stack.add(currentId);
+            const currentTask = taskMap.get(currentId);
+            if (!currentTask) {
+                throw new Error(`Dependency ${currentId} not found.`);
+            }
+            for (const depId of currentTask.dependencies) {
+                check(depId);
+            }
+            stack.delete(currentId);
+        };
+        check(task.id);
+    }
+}
+//# sourceMappingURL=trackerService.js.map

package/dist/src/services/trackerService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackerService.js","sourceRoot":"","sources":["../../../src/services/trackerService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,UAAU,GAEX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAU,MAAM,KAAK,CAAC;AAE7B,MAAM,OAAO,cAAc;IAKJ;IAJJ,QAAQ,CAAS;IAE1B,WAAW,GAAG,KAAK,CAAC;IAE5B,YAAqB,UAAkB;QAAlB,eAAU,GAAV,UAAU,CAAQ;QACrC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC;IAC7B,CAAC;IAEO,KAAK,CAAC,iBAAiB;QAC7B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,UAAU;QAChB,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,QAAiC;QAChD,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC/B,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAgB;YACxB,GAAG,QAAQ;YACX,EAAE;SACH,CAAC;QAEF,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACpD,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,QAAQ,aAAa,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QAED,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY,CACxB,QAAgB,EAChB,MAAsB;QAEtB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACpD,MAAM,IAAI,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IACE,KAAK;gBACL,OAAO,KAAK,KAAK,QAAQ;gBACzB,MAAM,IAAI,KAAK;gBACf,uEAAuE;gBACtE,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAClD,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACzC,WAAW,CAAC,IAAI,CAAC,qCAAqC,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;YAC1E,UAAU,CAAC,YAAY,CACrB,SAAS,EACT,6CAA6C,QAAQ,gCAAgC,EACrF,KAAK,CACN,CAAC;YACF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,EAAU;QACtB,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC9C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YACnE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,CAAS,EAAE,EAAE;gBAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;gBAC7C,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;YACxD,CAAC,CAAC,CACH,CAAC;YACF,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAoB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IACE,KAAK;gBACL,OAAO,KAAK,KAAK,QAAQ;gBACzB,MAAM,IAAI,KAAK;gBACf,KAAK,CAAC,IAAI,KAAK,QAAQ,EACvB,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CACd,EAAU,EACV,OAA6B;QAE7B,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,CAAC;QACvD,MAAM,oBAAoB,GAAG,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC;QAEhE,IAAI,OAA6C,CAAC;QAElD,IAAI,SAAS,IAAI,oBAAoB,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACxC,OAAO,GAAG,IAAI,GAAG,CAAsB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAEhE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,WAAW,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;QAEzD,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;YACzB,MAAM,YAAY,GAAG,OAAO;gBAC1B,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC;gBACnC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;YACjD,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CACb,uBAAuB,WAAW,CAAC,QAAQ,aAAa,CACzD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;gBACnD,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAC9C,CAAC;YAED,IAAI,oBAAoB,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;gBACzC,IAAI,CAAC,8BAA8B,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QAED,iBAAiB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAErC,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACjC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,QAAQ,CAAC,IAAiB;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAC7D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACK,gBAAgB,CACtB,IAAiB,EACjB,OAAiC;QAEjC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CAAC,cAAc,KAAK,uBAAuB,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;YACxE,CAAC;YACD,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CACb,qBAAqB,IAAI,CAAC,EAAE,uBAAuB,KAAK,aAAa,GAAG,CAAC,MAAM,GAAG,CACnF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,8BAA8B,CACpC,IAAiB,EACjB,OAAiC;QAEjC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAEhC,MAAM,KAAK,GAAG,CAAC,SAAiB,EAAE,EAAE;YAClC,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CACb,+CAA+C,SAAS,GAAG,CAC5D,CAAC;YACJ,CAAC;YACD,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACvB,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAErB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC3C,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,cAAc,SAAS,aAAa,CAAC,CAAC;YACxD,CAAC;YACD,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,YAAY,EAAE,CAAC;gBAC7C,KAAK,CAAC,KAAK,CAAC,CAAC;YACf,CAAC;YAED,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC,CAAC;QAEF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;CACF"}

package/dist/src/services/trackerService.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/services/trackerService.test.js

@@ -0,0 +1,117 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { TrackerService } from './trackerService.js';
+import { TaskStatus, TaskType } from './trackerTypes.js';
+describe('TrackerService', () => {
+    let testTrackerDir;
+    let service;
+    beforeEach(async () => {
+        testTrackerDir = await fs.mkdtemp(path.join(os.tmpdir(), 'tracker-service-test-'));
+        service = new TrackerService(testTrackerDir);
+    });
+    afterEach(async () => {
+        await fs.rm(testTrackerDir, { recursive: true, force: true });
+    });
+    it('should create a task with a generated 6-char hex ID', async () => {
+        const taskData = {
+            title: 'Test Task',
+            description: 'Test Description',
+            type: TaskType.TASK,
+            status: TaskStatus.OPEN,
+            dependencies: [],
+        };
+        const task = await service.createTask(taskData);
+        expect(task.id).toMatch(/^[0-9a-f]{6}$/);
+        expect(task.title).toBe(taskData.title);
+        const savedTask = await service.getTask(task.id);
+        expect(savedTask).toEqual(task);
+    });
+    it('should list all tasks', async () => {
+        await service.createTask({
+            title: 'Task 1',
+            description: 'Desc 1',
+            type: TaskType.TASK,
+            status: TaskStatus.OPEN,
+            dependencies: [],
+        });
+        await service.createTask({
+            title: 'Task 2',
+            description: 'Desc 2',
+            type: TaskType.TASK,
+            status: TaskStatus.OPEN,
+            dependencies: [],
+        });
+        const tasks = await service.listTasks();
+        expect(tasks.length).toBe(2);
+        expect(tasks.map((t) => t.title)).toContain('Task 1');
+        expect(tasks.map((t) => t.title)).toContain('Task 2');
+    });
+    it('should update a task', async () => {
+        const task = await service.createTask({
+            title: 'Original Title',
+            description: 'Original Desc',
+            type: TaskType.TASK,
+            status: TaskStatus.OPEN,
+            dependencies: [],
+        });
+        const updated = await service.updateTask(task.id, {
+            title: 'New Title',
+            status: TaskStatus.IN_PROGRESS,
+        });
+        expect(updated.title).toBe('New Title');
+        expect(updated.status).toBe('in_progress');
+        expect(updated.description).toBe('Original Desc');
+        const retrieved = await service.getTask(task.id);
+        expect(retrieved).toEqual(updated);
+    });
+    it('should prevent closing a task if dependencies are not closed', async () => {
+        const dep = await service.createTask({
+            title: 'Dependency',
+            description: 'Must be closed first',
+            type: TaskType.TASK,
+            status: TaskStatus.OPEN,
+            dependencies: [],
+        });
+        const task = await service.createTask({
+            title: 'Main Task',
+            description: 'Depends on dep',
+            type: TaskType.TASK,
+            status: TaskStatus.OPEN,
+            dependencies: [dep.id],
+        });
+        await expect(service.updateTask(task.id, { status: TaskStatus.CLOSED })).rejects.toThrow(/Cannot close task/);
+        // Close dependency
+        await service.updateTask(dep.id, { status: TaskStatus.CLOSED });
+        // Now it should work
+        const updated = await service.updateTask(task.id, {
+            status: TaskStatus.CLOSED,
+        });
+        expect(updated.status).toBe('closed');
+    });
+    it('should detect circular dependencies', async () => {
+        const taskA = await service.createTask({
+            title: 'Task A',
+            description: 'A',
+            type: TaskType.TASK,
+            status: TaskStatus.OPEN,
+            dependencies: [],
+        });
+        const taskB = await service.createTask({
+            title: 'Task B',
+            description: 'B',
+            type: TaskType.TASK,
+            status: TaskStatus.OPEN,
+            dependencies: [taskA.id],
+        });
+        // Try to make A depend on B
+        await expect(service.updateTask(taskA.id, { dependencies: [taskB.id] })).rejects.toThrow(/Circular dependency detected/);
+    });
+});
+//# sourceMappingURL=trackerService.test.js.map

package/dist/src/services/trackerService.test.js.map

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

package/dist/src/services/trackerTypes.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+export declare enum TaskType {
+    EPIC = "epic",
+    TASK = "task",
+    BUG = "bug"
+}
+export declare const TaskTypeSchema: z.ZodNativeEnum<typeof TaskType>;
+export declare enum TaskStatus {
+    OPEN = "open",
+    IN_PROGRESS = "in_progress",
+    BLOCKED = "blocked",
+    CLOSED = "closed"
+}
+export declare const TaskStatusSchema: z.ZodNativeEnum<typeof TaskStatus>;
+export declare const TrackerTaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    type: z.ZodNativeEnum<typeof TaskType>;
+    status: z.ZodNativeEnum<typeof TaskStatus>;
+    parentId: z.ZodOptional<z.ZodString>;
+    dependencies: z.ZodArray<z.ZodString, "many">;
+    subagentSessionId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    type: TaskType;
+    status: TaskStatus;
+    id: string;
+    title: string;
+    dependencies: string[];
+    metadata?: Record<string, unknown> | undefined;
+    parentId?: string | undefined;
+    subagentSessionId?: string | undefined;
+}, {
+    description: string;
+    type: TaskType;
+    status: TaskStatus;
+    id: string;
+    title: string;
+    dependencies: string[];
+    metadata?: Record<string, unknown> | undefined;
+    parentId?: string | undefined;
+    subagentSessionId?: string | undefined;
+}>;
+export type TrackerTask = z.infer<typeof TrackerTaskSchema>;

package/dist/src/services/trackerTypes.js

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+export var TaskType;
+(function (TaskType) {
+    TaskType["EPIC"] = "epic";
+    TaskType["TASK"] = "task";
+    TaskType["BUG"] = "bug";
+})(TaskType || (TaskType = {}));
+export const TaskTypeSchema = z.nativeEnum(TaskType);
+export var TaskStatus;
+(function (TaskStatus) {
+    TaskStatus["OPEN"] = "open";
+    TaskStatus["IN_PROGRESS"] = "in_progress";
+    TaskStatus["BLOCKED"] = "blocked";
+    TaskStatus["CLOSED"] = "closed";
+})(TaskStatus || (TaskStatus = {}));
+export const TaskStatusSchema = z.nativeEnum(TaskStatus);
+export const TrackerTaskSchema = z.object({
+    id: z.string().length(6),
+    title: z.string(),
+    description: z.string(),
+    type: TaskTypeSchema,
+    status: TaskStatusSchema,
+    parentId: z.string().optional(),
+    dependencies: z.array(z.string()),
+    subagentSessionId: z.string().optional(),
+    metadata: z.record(z.unknown()).optional(),
+});
+//# sourceMappingURL=trackerTypes.js.map

package/dist/src/services/trackerTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackerTypes.js","sourceRoot":"","sources":["../../../src/services/trackerTypes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,yBAAa,CAAA;IACb,yBAAa,CAAA;IACb,uBAAW,CAAA;AACb,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB;AACD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AAErD,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,2BAAa,CAAA;IACb,yCAA2B,CAAA;IAC3B,iCAAmB,CAAA;IACnB,+BAAiB,CAAA;AACnB,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AACD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE,gBAAgB;IACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC"}

package/dist/src/telemetry/billingEvents.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import type { LogAttributes } from '@opentelemetry/api-logs';
+import type { BaseTelemetryEvent } from './types.js';
+import type { OverageStrategy } from '../billing/billing.js';
+/** Overage menu option that can be selected by the user */
+export type OverageOption = 'use_credits' | 'use_fallback' | 'manage' | 'stop' | 'get_credits';
+export declare const EVENT_OVERAGE_MENU_SHOWN = "gemini_cli.overage_menu_shown";
+export declare class OverageMenuShownEvent implements BaseTelemetryEvent {
+    'event.name': 'overage_menu_shown';
+    'event.timestamp': string;
+    model: string;
+    credit_balance: number;
+    overage_strategy: OverageStrategy;
+    constructor(model: string, creditBalance: number, overageStrategy: OverageStrategy);
+    toOpenTelemetryAttributes(config: Config): LogAttributes;
+    toLogBody(): string;
+}
+export declare const EVENT_OVERAGE_OPTION_SELECTED = "gemini_cli.overage_option_selected";
+export declare class OverageOptionSelectedEvent implements BaseTelemetryEvent {
+    'event.name': 'overage_option_selected';
+    'event.timestamp': string;
+    model: string;
+    selected_option: OverageOption;
+    credit_balance: number;
+    constructor(model: string, selectedOption: OverageOption, creditBalance: number);
+    toOpenTelemetryAttributes(config: Config): LogAttributes;
+    toLogBody(): string;
+}
+export declare const EVENT_EMPTY_WALLET_MENU_SHOWN = "gemini_cli.empty_wallet_menu_shown";
+export declare class EmptyWalletMenuShownEvent implements BaseTelemetryEvent {
+    'event.name': 'empty_wallet_menu_shown';
+    'event.timestamp': string;
+    model: string;
+    constructor(model: string);
+    toOpenTelemetryAttributes(config: Config): LogAttributes;
+    toLogBody(): string;
+}
+export declare const EVENT_CREDIT_PURCHASE_CLICK = "gemini_cli.credit_purchase_click";
+export declare class CreditPurchaseClickEvent implements BaseTelemetryEvent {
+    'event.name': 'credit_purchase_click';
+    'event.timestamp': string;
+    source: 'overage_menu' | 'empty_wallet_menu' | 'manage';
+    model: string;
+    constructor(source: 'overage_menu' | 'empty_wallet_menu' | 'manage', model: string);
+    toOpenTelemetryAttributes(config: Config): LogAttributes;
+    toLogBody(): string;
+}
+export declare const EVENT_CREDITS_USED = "gemini_cli.credits_used";
+export declare class CreditsUsedEvent implements BaseTelemetryEvent {
+    'event.name': 'credits_used';
+    'event.timestamp': string;
+    model: string;
+    credits_consumed: number;
+    credits_remaining: number;
+    constructor(model: string, creditsConsumed: number, creditsRemaining: number);
+    toOpenTelemetryAttributes(config: Config): LogAttributes;
+    toLogBody(): string;
+}
+export declare const EVENT_API_KEY_UPDATED = "gemini_cli.api_key_updated";
+export declare class ApiKeyUpdatedEvent implements BaseTelemetryEvent {
+    'event.name': 'api_key_updated';
+    'event.timestamp': string;
+    previous_auth_type: string;
+    new_auth_type: string;
+    constructor(previousAuthType: string, newAuthType: string);
+    toOpenTelemetryAttributes(config: Config): LogAttributes;
+    toLogBody(): string;
+}
+/** Union type of all billing-related telemetry events */
+export type BillingTelemetryEvent = OverageMenuShownEvent | OverageOptionSelectedEvent | EmptyWalletMenuShownEvent | CreditPurchaseClickEvent | CreditsUsedEvent | ApiKeyUpdatedEvent;