Melchizedek

Instructions

Implementation Reference

• src/tools/search.ts:47-66 (handler)

  The async handler function for 'm9k_search' that calls the underlying search utility.

  async ({ query, project, limit, since, until, order }) => {
    const currentSession = getStat(ctx.db, 'current_session_id') || undefined;
    const results = await search(
      ctx.db,
      {
        query,
        project,
        currentProject: ctx.currentProject,
        currentSession,
        limit,
        since,
        until,
        order,
      },
      ctx.searchContext,
    );
    return {
      content: [{ type: 'text' as const, text: JSON.stringify(results) }],
    };
  },

• src/tools/search.ts:12-46 (registration)

  Registration and schema definition for 'm9k_search' tool.

  server.registerTool(
    'm9k_search',
    {
      description:
        'Search indexed past conversations. Returns compact results with snippets. Results from the current project and session are boosted by default. Use m9k_context or m9k_full to drill down.',
      inputSchema: {
        query: z.string().describe('Search query (keywords or natural language)'),
        project: z
          .string()
          .optional()
          .describe('Filter by project path. Omit for cross-project search.'),
        limit: z.number().int().min(1).max(50).default(10).describe('Max results'),
        since: z.string().optional().describe('ISO-8601 date. Only results after this date.'),
        until: z
          .string()
          .optional()
          .describe('ISO-8601 date. Only results before this date (exclusive).'),
        order: z
          .enum(['score', 'date_asc', 'date_desc'])
          .default('score')
          .describe(
            'Sort order: score (relevance), date_asc (oldest first), date_desc (newest first)',
          ),
        source: z
          .enum(['conversations', 'git', 'files'])
          .optional()
          .describe('Filter by source type. Default: all sources.'),
      },
      annotations: {
        readOnlyHint: true,
        destructiveHint: false,
        idempotentHint: true,
        openWorldHint: false,
      },
    },