@vybestack/llxprt-code-tools 0.10.0-nightly.260613.1adad3b34

package/dist/src/utils/schemaValidator.js

@@ -0,0 +1,275 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P11
+ * @requirement:REQ-PKG-BOUNDARY
+ */
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Package-local SchemaValidator for tool parameter validation.
+ *
+ * This is a self-contained copy of the SchemaValidator utility that
+ * was in packages/core/src/utils/schemaValidator.ts. It uses the `ajv`
+ * package directly with zero core imports.
+ *
+ * Tool files (tools.ts, ripGrep.ts, todo-pause.ts) need schema validation
+ * for their parameter schemas. Moving this utility into the tools package
+ * eliminates the core dependency.
+ */
+// ajv v8 does not declare package "exports", so subpath imports like
+// "ajv/dist/2020" are the only supported way to pull in the draft-2020-12
+// build. See https://ajv.js.org/json-schema.html#draft-2020-12
+// eslint-disable-next-line import/no-internal-modules
+import Ajv2020Pkg from 'ajv/dist/2020.js';
+import AjvPkg from 'ajv';
+// Ajv's ESM/CJS interop: default/namespace dual export.
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const Ajv2020Class = Ajv2020Pkg.default ?? Ajv2020Pkg;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const AjvClass = AjvPkg.default ?? AjvPkg;
+/**
+ * The JSON Schema draft-07 meta-schema, inlined verbatim from ajv's
+ * `dist/refs/json-schema-draft-07.json`.
+ *
+ * This is inlined (rather than resolved via `createRequire` or a JSON
+ * import) so that it survives esbuild bundling into `bundle/llxprt.js`
+ * unchanged.
+ */
+const draft07MetaSchema = {
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    $id: 'http://json-schema.org/draft-07/schema#',
+    title: 'Core schema meta-schema',
+    definitions: {
+        schemaArray: {
+            type: 'array',
+            minItems: 1,
+            items: { $ref: '#' },
+        },
+        nonNegativeInteger: {
+            type: 'integer',
+            minimum: 0,
+        },
+        nonNegativeIntegerDefault0: {
+            allOf: [{ $ref: '#/definitions/nonNegativeInteger' }, { default: 0 }],
+        },
+        simpleTypes: {
+            enum: [
+                'array',
+                'boolean',
+                'integer',
+                'null',
+                'number',
+                'object',
+                'string',
+            ],
+        },
+        stringArray: {
+            type: 'array',
+            items: { type: 'string' },
+            uniqueItems: true,
+            default: [],
+        },
+    },
+    type: ['object', 'boolean'],
+    properties: {
+        $id: { type: 'string', format: 'uri-reference' },
+        $schema: { type: 'string', format: 'uri' },
+        $ref: { type: 'string', format: 'uri-reference' },
+        $comment: { type: 'string' },
+        title: { type: 'string' },
+        description: { type: 'string' },
+        default: true,
+        readOnly: { type: 'boolean', default: false },
+        examples: { type: 'array', items: true },
+        multipleOf: { type: 'number', exclusiveMinimum: 0 },
+        maximum: { type: 'number' },
+        exclusiveMaximum: { type: 'number' },
+        minimum: { type: 'number' },
+        exclusiveMinimum: { type: 'number' },
+        maxLength: { $ref: '#/definitions/nonNegativeInteger' },
+        minLength: { $ref: '#/definitions/nonNegativeIntegerDefault0' },
+        pattern: { type: 'string', format: 'regex' },
+        additionalItems: { $ref: '#' },
+        items: {
+            anyOf: [{ $ref: '#' }, { $ref: '#/definitions/schemaArray' }],
+            default: true,
+        },
+        maxItems: { $ref: '#/definitions/nonNegativeInteger' },
+        minItems: { $ref: '#/definitions/nonNegativeIntegerDefault0' },
+        uniqueItems: { type: 'boolean', default: false },
+        contains: { $ref: '#' },
+        maxProperties: { $ref: '#/definitions/nonNegativeInteger' },
+        minProperties: { $ref: '#/definitions/nonNegativeIntegerDefault0' },
+        required: { $ref: '#/definitions/stringArray' },
+        additionalProperties: { $ref: '#' },
+        definitions: {
+            type: 'object',
+            additionalProperties: { $ref: '#' },
+            default: {},
+        },
+        properties: {
+            type: 'object',
+            additionalProperties: { $ref: '#' },
+            default: {},
+        },
+        patternProperties: {
+            type: 'object',
+            additionalProperties: { $ref: '#' },
+            propertyNames: { format: 'regex' },
+            default: {},
+        },
+        dependencies: {
+            type: 'object',
+            additionalProperties: {
+                anyOf: [{ $ref: '#' }, { $ref: '#/definitions/stringArray' }],
+            },
+        },
+        propertyNames: { $ref: '#' },
+        const: true,
+        enum: {
+            type: 'array',
+            items: true,
+            minItems: 1,
+            uniqueItems: true,
+        },
+        type: {
+            anyOf: [
+                { $ref: '#/definitions/simpleTypes' },
+                {
+                    type: 'array',
+                    items: { $ref: '#/definitions/simpleTypes' },
+                    minItems: 1,
+                    uniqueItems: true,
+                },
+            ],
+        },
+        format: { type: 'string' },
+        contentMediaType: { type: 'string' },
+        contentEncoding: { type: 'string' },
+        if: { $ref: '#' },
+        then: { $ref: '#' },
+        else: { $ref: '#' },
+        allOf: { $ref: '#/definitions/schemaArray' },
+        anyOf: { $ref: '#/definitions/schemaArray' },
+        oneOf: { $ref: '#/definitions/schemaArray' },
+        not: { $ref: '#' },
+    },
+    default: true,
+};
+// See: https://ajv.js.org/options.html#strict-mode-options
+const ajvOptions = { strictSchema: false };
+/**
+ * Two Ajv instances because draft-07 and draft-2020-12 are NOT
+ * behaviourally compatible. See the long comment in the core version
+ * of this file for details.
+ */
+const ajValidator2020 = new Ajv2020Class(ajvOptions);
+ajValidator2020.addMetaSchema(draft07MetaSchema);
+const ajValidator07 = new AjvClass(ajvOptions);
+/** Register custom formats on a given Ajv instance. */
+function registerCustomFormats(instance) {
+    instance.addFormat('google-duration', {
+        type: 'string',
+        validate: () => true,
+    });
+    instance.addFormat('google-fieldmask', {
+        type: 'string',
+        validate: () => true,
+    });
+    instance.addFormat('something-totally-custom', {
+        type: 'string',
+        validate: () => true,
+    });
+    // eslint-disable-next-line sonarjs/regular-expr -- Static regex reviewed for lint hardening.
+    instance.addFormat('date', /^\d{4}-\d{2}-\d{2}$/);
+}
+registerCustomFormats(ajValidator2020);
+registerCustomFormats(ajValidator07);
+/** Returns true if the declared `$schema` URI refers to JSON Schema draft-07. */
+function isDraft07SchemaUri(uri) {
+    return typeof uri === 'string' && /\/draft-07\/schema/.test(uri);
+}
+/**
+ * Package-local SchemaValidator utility for tool parameter validation.
+ * Zero core imports — uses ajv directly.
+ */
+export class SchemaValidator {
+    static validate(schema, data) {
+        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
+        if (!schema) {
+            return null;
+        }
+        if (typeof data !== 'object' || data === null) {
+            return 'Value of params must be an object';
+        }
+        const extSchema = schema;
+        if (extSchema.requireOne) {
+            for (const oneOfGroup of extSchema.requireOne) {
+                const hasOne = oneOfGroup.some((prop) => data[prop] !== undefined &&
+                    data[prop] !== null &&
+                    data[prop] !== '');
+                if (!hasOne) {
+                    return `params must have at least one of required properties: ${oneOfGroup.join(', ')}`;
+                }
+            }
+        }
+        const declaredSchemaUri = extSchema.$schema;
+        const instance = isDraft07SchemaUri(declaredSchemaUri)
+            ? ajValidator07
+            : ajValidator2020;
+        const ajvSchema = { ...extSchema };
+        delete ajvSchema.requireOne;
+        delete ajvSchema.$schema;
+        const validate = instance.compile(ajvSchema);
+        const valid = validate(data);
+        if (valid === false &&
+            validate.errors != null &&
+            validate.errors.length > 0) {
+            return SchemaValidator.formatErrors(validate.errors);
+        }
+        return null;
+    }
+    static formatPath(rawPath) {
+        if (rawPath === '') {
+            return 'params';
+        }
+        const normalized = rawPath
+            .replace(/\[(\d+)\]/g, '/$1')
+            .replace(/\.+/g, '/')
+            .replace(/\/+/g, '/')
+            .replace(/^\/+/, '');
+        return `params/${normalized}`;
+    }
+    static formatErrors(errors) {
+        const formattedErrors = errors.map((err) => {
+            /* eslint-disable @typescript-eslint/no-explicit-any */
+            const instancePath = err.instancePath;
+            const dataPath = err.dataPath;
+            /* eslint-enable @typescript-eslint/no-explicit-any */
+            const path = (typeof instancePath === 'string' && instancePath !== ''
+                ? instancePath
+                : null) ??
+                (typeof dataPath === 'string' && dataPath !== '' ? dataPath : null) ??
+                '';
+            const basePath = SchemaValidator.formatPath(path);
+            const message = err.message ?? 'is invalid';
+            return `${basePath} ${message}`;
+        });
+        const errorTextRaw = formattedErrors.join('; ');
+        const replaced = typeof errorTextRaw === 'string' && errorTextRaw !== ''
+            ? errorTextRaw.replace(/\bshould\b/gi, 'must')
+            : null;
+        let errorText = replaced ?? errorTextRaw;
+        if (typeof errorText === 'string' && errorText !== '') {
+            errorText = errorText.replace(/must NOT be shorter than (\d+) characters/gi, 'must NOT have fewer than $1 characters');
+            if (/anyOf/i.test(errorText) &&
+                !/must match a schema in anyOf/i.test(errorText)) {
+                errorText = `${errorText}; must match a schema in anyOf`;
+            }
+        }
+        return errorText;
+    }
+}
+//# sourceMappingURL=schemaValidator.js.map

package/dist/src/utils/schemaValidator.js.map

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

package/dist/src/utils/terminalSerializer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P11
+ * @requirement:REQ-PKG-BOUNDARY
+ */
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Tools-owned structural type for terminal output.
+ *
+ * Replaces import of AnsiOutput from packages/core/src/utils/terminalSerializer.
+ * The full AnsiOutput type requires @xterm/headless which is a core dependency.
+ * Moved tool files that need AnsiOutput in their interfaces should use this
+ * package-local type instead.
+ *
+ * The type is structurally equivalent: an array of lines, where each line
+ * is an array of tokens. This avoids the @xterm/headless dependency while
+ * maintaining interface compatibility.
+ */
+export interface AnsiToken {
+    text: string;
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+    dim: boolean;
+    inverse: boolean;
+    fg: string;
+    bg: string;
+}
+export type AnsiLine = AnsiToken[];
+export type AnsiOutput = AnsiLine[];

package/dist/src/utils/terminalSerializer.js

@@ -0,0 +1,6 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P11
+ * @requirement:REQ-PKG-BOUNDARY
+ */
+export {};
+//# sourceMappingURL=terminalSerializer.js.map

package/dist/src/utils/terminalSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalSerializer.js","sourceRoot":"","sources":["../../../src/utils/terminalSerializer.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/utils/todoContextTracker.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare class TodoContextTracker {
+    private activeTodoId;
+    static forAgent(sessionId: string, agentId: string): TodoContextTracker;
+    setActiveTodo(todoId: string | null): void;
+    clearActiveTodo(): void;
+    getActiveTodo(): string | null;
+}

package/dist/src/utils/todoContextTracker.js

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const trackers = new Map();
+export class TodoContextTracker {
+    activeTodoId = null;
+    static forAgent(sessionId, agentId) {
+        const key = `${sessionId}:${agentId}`;
+        let tracker = trackers.get(key);
+        if (!tracker) {
+            tracker = new TodoContextTracker();
+            trackers.set(key, tracker);
+        }
+        return tracker;
+    }
+    setActiveTodo(todoId) {
+        this.activeTodoId = todoId;
+    }
+    clearActiveTodo() {
+        this.activeTodoId = null;
+    }
+    getActiveTodo() {
+        return this.activeTodoId;
+    }
+}
+//# sourceMappingURL=todoContextTracker.js.map

package/dist/src/utils/todoContextTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todoContextTracker.js","sourceRoot":"","sources":["../../../src/utils/todoContextTracker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA8B,CAAC;AAEvD,MAAM,OAAO,kBAAkB;IACrB,YAAY,GAAkB,IAAI,CAAC;IAE3C,MAAM,CAAC,QAAQ,CAAC,SAAiB,EAAE,OAAe;QAChD,MAAM,GAAG,GAAG,GAAG,SAAS,IAAI,OAAO,EAAE,CAAC;QACtC,IAAI,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACnC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,aAAa,CAAC,MAAqB;QACjC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;IAC7B,CAAC;IAED,eAAe;QACb,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;CACF"}

package/dist/src/utils/todoFormatter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type Todo, type TodoToolCall } from '../types/todo-schemas.js';
+export interface GroupedToolCall {
+    toolCall: TodoToolCall;
+    count: number;
+}
+export interface TodoFormatterOptions {
+    header?: string;
+    includeSummary?: boolean;
+    maxToolCalls?: number;
+    getLiveToolCalls?: (todoId: string) => TodoToolCall[];
+}
+/**
+ * Groups consecutive identical tool calls to create a concise textual representation.
+ */
+export declare const groupToolCalls: (toolCalls: TodoToolCall[]) => GroupedToolCall[];
+/**
+ * Produces a textual representation of todos that mirrors the information shown in the Ink Todo panel.
+ */
+export declare const formatTodoListForDisplay: (todos: Todo[], options?: TodoFormatterOptions) => string;

package/dist/src/utils/todoFormatter.js

@@ -0,0 +1,157 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const STATUS_ICONS = {
+    in_progress: '→',
+    pending: '○',
+    completed: '',
+};
+const STATUS_ORDER = {
+    in_progress: 0,
+    pending: 1,
+    completed: 2,
+};
+const DEFAULT_HEADER = '## Todo Progress';
+const DEFAULT_MAX_TOOL_CALLS = 5;
+/**
+ * Groups consecutive identical tool calls to create a concise textual representation.
+ */
+export const groupToolCalls = (toolCalls) => {
+    if (toolCalls.length === 0) {
+        return [];
+    }
+    const grouped = [];
+    let currentGroup = {
+        toolCall: toolCalls[0],
+        count: 1,
+    };
+    for (let i = 1; i < toolCalls.length; i++) {
+        const current = toolCalls[i];
+        const previous = currentGroup.toolCall;
+        if (current.name === previous.name &&
+            JSON.stringify(current.parameters) === JSON.stringify(previous.parameters)) {
+            currentGroup.count++;
+        }
+        else {
+            grouped.push(currentGroup);
+            currentGroup = {
+                toolCall: current,
+                count: 1,
+            };
+        }
+    }
+    grouped.push(currentGroup);
+    return grouped;
+};
+const formatParameters = (parameters) => {
+    const segments = [];
+    const MAX_LENGTH = 40;
+    for (const [key, value] of Object.entries(parameters)) {
+        if (typeof value === 'string') {
+            let displayValue = value;
+            if (key === 'file_path' ||
+                key === 'absolute_path' ||
+                value.includes('/')) {
+                // eslint-disable-next-line sonarjs/nested-control-flow -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+                if (displayValue.length > MAX_LENGTH) {
+                    displayValue = '...' + displayValue.slice(-(MAX_LENGTH - 3));
+                }
+            }
+            else if (displayValue.length > MAX_LENGTH) {
+                displayValue = `${displayValue.substring(0, MAX_LENGTH - 3)}...`;
+            }
+            segments.push(`${key}: '${displayValue}'`);
+        }
+        else {
+            const jsonValue = JSON.stringify(value);
+            const displayValue = jsonValue.length > MAX_LENGTH
+                ? `${jsonValue.substring(0, MAX_LENGTH - 3)}...`
+                : jsonValue;
+            segments.push(`${key}: ${displayValue}`);
+        }
+    }
+    return segments.join(', ');
+};
+const pushToolCalls = (lines, toolCalls, indent, maxToolCalls) => {
+    if (toolCalls.length === 0) {
+        return;
+    }
+    const grouped = groupToolCalls(toolCalls);
+    if (grouped.length > maxToolCalls) {
+        const overflow = grouped.length - maxToolCalls;
+        lines.push(`${indent}↳ ...${overflow} more tool calls...`);
+    }
+    const visible = grouped.slice(-maxToolCalls);
+    for (const group of visible) {
+        const params = formatParameters(group.toolCall.parameters);
+        const countText = group.count > 1 ? ` ${group.count}x` : '';
+        lines.push(`${indent}↳ ${group.toolCall.name}(${params})${countText}`.trimEnd());
+    }
+};
+const calculateStats = (todos) => ({
+    total: todos.length,
+    completed: todos.filter((todo) => todo.status === 'completed').length,
+    inProgress: todos.filter((todo) => todo.status === 'in_progress').length,
+    pending: todos.filter((todo) => todo.status === 'pending').length,
+});
+const formatTodoEntry = (todo) => {
+    const marker = STATUS_ICONS[todo.status];
+    const currentSuffix = todo.status === 'in_progress' ? ' ← current' : '';
+    const statusText = todo.status === 'in_progress' ? ' (in_progress)' : '';
+    return `${marker} ${todo.content}${statusText}${currentSuffix}`;
+};
+const mergeToolCalls = (todo, getLiveToolCalls) => {
+    const baseCalls = todo.toolCalls ?? [];
+    if (!getLiveToolCalls) {
+        return baseCalls;
+    }
+    const seen = new Set(baseCalls.map((call) => call.id));
+    const liveCalls = getLiveToolCalls(todo.id).filter((call) => {
+        if (seen.has(call.id)) {
+            return false;
+        }
+        seen.add(call.id);
+        return true;
+    });
+    return [...baseCalls, ...liveCalls];
+};
+/**
+ * Produces a textual representation of todos that mirrors the information shown in the Ink Todo panel.
+ */
+export const formatTodoListForDisplay = (todos, options = {}) => {
+    const header = options.header ?? DEFAULT_HEADER;
+    const maxToolCalls = options.maxToolCalls ?? DEFAULT_MAX_TOOL_CALLS;
+    const includeSummary = options.includeSummary ?? true;
+    if (todos.length === 0) {
+        return `${header}\n\nNo todos found.\n\nUse todo_write to create a task list when working on multi-step projects.`;
+    }
+    const lines = [header, ''];
+    if (includeSummary) {
+        const stats = calculateStats(todos);
+        lines.push(`${stats.total} tasks: ${stats.completed} completed, ${stats.inProgress} in progress, ${stats.pending} pending`);
+        lines.push('');
+    }
+    const orderedTodos = orderTodos(todos);
+    for (const todo of orderedTodos) {
+        lines.push(formatTodoEntry(todo));
+        if (todo.subtasks) {
+            for (const subtask of todo.subtasks) {
+                lines.push(`  • ${subtask.content}`);
+                // eslint-disable-next-line sonarjs/nested-control-flow -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+                if (subtask.toolCalls && subtask.toolCalls.length > 0) {
+                    pushToolCalls(lines, subtask.toolCalls, '    ', maxToolCalls);
+                }
+            }
+        }
+        const combinedToolCalls = mergeToolCalls(todo, options.getLiveToolCalls);
+        pushToolCalls(lines, combinedToolCalls, '  ', maxToolCalls);
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd();
+};
+const orderTodos = (todos) => 
+// Sort by status only, preserving original array order within each status group
+[...todos].sort((a, b) => STATUS_ORDER[a.status] - STATUS_ORDER[b.status]);
+//# sourceMappingURL=todoFormatter.js.map

package/dist/src/utils/todoFormatter.js.map

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

package/dist/src/utils/todoReminderService.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Todo } from '../types/todo-schemas.js';
+export interface TodoStateChange {
+    added: Todo[];
+    removed: Todo[];
+    statusChanged: Array<{
+        todo: Todo;
+        oldStatus: Todo['status'];
+        newStatus: Todo['status'];
+    }>;
+}
+export declare class TodoReminderService {
+    private static readonly EMPTY_TODO_REMINDER;
+    calculateStateChange(oldTodos: Todo[], newTodos: Todo[]): TodoStateChange;
+    shouldGenerateReminder(stateChange: TodoStateChange): boolean;
+    getReminderForStateChange(stateChange: TodoStateChange): string | undefined;
+    getReminderForEmptyTodos(isComplexTask: boolean): string;
+}

package/dist/src/utils/todoReminderService.js

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export class TodoReminderService {
+    static EMPTY_TODO_REMINDER = `This is a reminder that your todo list is currently empty. DO NOT mention this to the user explicitly because they are already aware. If you are working on tasks that would benefit from a todo list please use the TodoWrite tool to create one. If not, please feel free to ignore. Again do not mention this message to the user.`;
+    calculateStateChange(oldTodos, newTodos) {
+        const oldById = new Map(oldTodos.map((todo) => [todo.id, todo]));
+        const newById = new Map(newTodos.map((todo) => [todo.id, todo]));
+        const added = newTodos.filter((todo) => !oldById.has(todo.id));
+        const removed = oldTodos.filter((todo) => !newById.has(todo.id));
+        const statusChanged = newTodos.flatMap((todo) => {
+            const oldTodo = oldById.get(todo.id);
+            if (!oldTodo || oldTodo.status === todo.status) {
+                return [];
+            }
+            return [
+                {
+                    todo,
+                    oldStatus: oldTodo.status,
+                    newStatus: todo.status,
+                },
+            ];
+        });
+        return { added, removed, statusChanged };
+    }
+    shouldGenerateReminder(stateChange) {
+        return (stateChange.added.length > 0 ||
+            stateChange.removed.length > 0 ||
+            stateChange.statusChanged.length > 0);
+    }
+    getReminderForStateChange(stateChange) {
+        if (!this.shouldGenerateReminder(stateChange)) {
+            return undefined;
+        }
+        return 'Todo list updated. Continue using TodoWrite to keep progress current.';
+    }
+    getReminderForEmptyTodos(isComplexTask) {
+        return isComplexTask ? TodoReminderService.EMPTY_TODO_REMINDER : '';
+    }
+}
+//# sourceMappingURL=todoReminderService.js.map

package/dist/src/utils/todoReminderService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todoReminderService.js","sourceRoot":"","sources":["../../../src/utils/todoReminderService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,MAAM,OAAO,mBAAmB;IACtB,MAAM,CAAU,mBAAmB,GAAG,uUAAuU,CAAC;IAEtX,oBAAoB,CAAC,QAAgB,EAAE,QAAgB;QACrD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAEjE,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACjE,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC/C,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,OAAO;gBACL;oBACE,IAAI;oBACJ,SAAS,EAAE,OAAO,CAAC,MAAM;oBACzB,SAAS,EAAE,IAAI,CAAC,MAAM;iBACvB;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAC3C,CAAC;IAED,sBAAsB,CAAC,WAA4B;QACjD,OAAO,CACL,WAAW,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YAC5B,WAAW,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YAC9B,WAAW,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CACrC,CAAC;IACJ,CAAC;IAED,yBAAyB,CAAC,WAA4B;QACpD,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,WAAW,CAAC,EAAE,CAAC;YAC9C,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,uEAAuE,CAAC;IACjF,CAAC;IAED,wBAAwB,CAAC,aAAsB;QAC7C,OAAO,aAAa,CAAC,CAAC,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,CAAC"}