Method execute

src/tools/builtin/memory.ts:109–133

(args: z.infer<typeof ForgetArgs>, ctx: ToolContext)

  argsSchema = ForgetArgs;

  async execute(args: z.infer<typeof ForgetArgs>, ctx: ToolContext): Promise<ToolResult> {
    const cwd = ctx.cwd ?? process.cwd();
    const scope = args.scope ?? 'project';
    if (!args.fact_contains && !args.all) {
      return {
        content: '[FORGET_NEEDS_TARGET] Pass either `fact_contains: "<substring>"` to target specific facts, or `all: true` to clear everything in this scope.',
        isError: true,
      };
    }
    const store = getSessionStore();
    const db = (store as any).db as { prepare: (sql: string) => any };
    // User facts live under the '*' sentinel cwd; project facts under the real cwd.
    const scopeWhere = scope === 'user' ? `scope = 'user'` : `cwd = ? AND scope = 'project'`;
    const scopeArgs = scope === 'user' ? [] : [cwd];
    const label = scope === 'user' ? 'user memory' : cwd;
    const { exportMemory } = await import('../../context/memory-mirror.js');
    if (args.all) {
      const result = db.prepare(`DELETE FROM session_facts WHERE ${scopeWhere}`).run(...scopeArgs);
      await exportMemory(cwd); // keep the MEMORY.md mirror in sync
      return { content: `Forgot ${result.changes} fact(s) from ${label}.` };
    }
    const result = db.prepare(`DELETE FROM session_facts WHERE ${scopeWhere} AND fact LIKE ?`).run(...scopeArgs, `%${args.fact_contains}%`);
    await exportMemory(cwd); // keep the MEMORY.md mirror in sync
    return { content: `Forgot ${result.changes} fact(s) matching "${args.fact_contains}" from ${label}.` };
  }
}