Flint Note

Instructions

Implementation Reference

• src/server/link-handlers.ts:288-383 (handler)

  Core handler function for the 'migrate_links' MCP tool. Scans all notes in the vault, extracts links using LinkExtractor, stores them in note_links and external_links tables, handles errors per note, and returns migration statistics.

  handleMigrateLinks = async (args: { force?: boolean; vault_id?: string }) => {
    try {
      // Validate arguments
      validateToolArgs('migrate_links', args);
  
      const { hybridSearchManager } = await this.resolveVaultContext(args.vault_id);
      const db = await hybridSearchManager.getDatabaseConnection();
  
      // Check if migration is needed
      if (!args.force) {
        const existingLinks = await db.get<{ count: number }>(
          'SELECT COUNT(*) as count FROM note_links'
        );
        if (existingLinks && existingLinks.count > 0) {
          return {
            content: [
              {
                type: 'text',
                text: JSON.stringify(
                  {
                    success: false,
                    message:
                      'Link tables already contain data. Use force=true to migrate anyway.',
                    existing_links: existingLinks.count
                  },
                  null,
                  2
                )
              }
            ]
          };
        }
      }
  
      // Get all notes from the database
      const notes = await db.all<{ id: string; content: string }>(
        'SELECT id, content FROM notes'
      );
      let processedCount = 0;
      let errorCount = 0;
      const errors: string[] = [];
  
      for (const note of notes) {
        try {
          // Extract links from note content
          const extractionResult = LinkExtractor.extractLinks(note.content);
  
          // Store the extracted links
          await LinkExtractor.storeLinks(note.id, extractionResult, db);
          processedCount++;
        } catch (error) {
          errorCount++;
          const errorMessage = error instanceof Error ? error.message : 'Unknown error';
          errors.push(`${note.id}: ${errorMessage}`);
        }
      }
  
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(
              {
                success: true,
                message: 'Link migration completed',
                total_notes: notes.length,
                processed: processedCount,
                errors: errorCount,
                error_details: errors.length > 0 ? errors.slice(0, 10) : undefined // Limit error details to first 10
              },
              null,
              2
            )
          }
        ]
      };
    } catch (error) {
      const errorMessage = error instanceof Error ? error.message : 'Unknown error';
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(
              {
                success: false,
                error: errorMessage
              },
              null,
              2
            )
          }
        ],
        isError: true
      };
    }
  };

• src/server/tool-schemas.ts:951-970 (schema)

  JSON Schema definition for the 'migrate_links' tool inputs, defining optional 'force' boolean and 'vault_id' string parameters.

  {
    name: 'migrate_links',
    description:
      'Scan all existing notes and populate the link tables (one-time migration)',
    inputSchema: {
      type: 'object',
      properties: {
        force: {
          type: 'boolean',
          description: 'Force migration even if link tables already contain data',
          default: false
        },
        vault_id: {
          type: 'string',
          description:
            'Optional vault ID to operate on. If not provided, uses the current active vault.'
        }
      }
    }
  }

• src/server.ts:1352-1355 (registration)

  Registration of the 'migrate_links' tool handler in the MCP server's CallToolRequestSchema switch statement, dispatching to LinkHandlers.handleMigrateLinks.

  case 'migrate_links':
    return await this.linkHandlers.handleMigrateLinks(
      args as unknown as { force?: boolean; vault_id?: string }
    );

• src/server.ts:1208-1221 (registration)

  Tool metadata registration for 'migrate_links' in the MCP server's ListToolsRequestSchema response, including name, description, and input schema.

    name: 'migrate_links',
    description:
      'Scan all existing notes and populate the link tables (one-time migration)',
    inputSchema: {
      type: 'object',
      properties: {
        force: {
          type: 'boolean',
          description: 'Force migration even if link tables already contain data',
          default: false
        }
      }
    }
  }

• src/server/validation.ts:917-929 (schema)

  Validation rules used by validateToolArgs('migrate_links', args) for input argument checking.

  migrate_links: [
    {
      field: 'force',
      required: false,
      type: 'boolean'
    },
    {
      field: 'vault_id',
      required: false,
      type: 'string',
      allowEmpty: false
    }
  ],