Flint Note

Instructions

Implementation Reference

• src/server/link-handlers.ts:22-74 (handler)

  Primary execution logic for the get_note_links tool: validates args, resolves vault/DB, checks note existence, extracts links via LinkExtractor.getLinksForNote, returns structured JSON response.

  handleGetNoteLinks = async (args: { identifier: string; vault_id?: string }) => {
    try {
      // Validate arguments
      validateToolArgs('get_note_links', args);
  
      const { hybridSearchManager } = await this.resolveVaultContext(args.vault_id);
      const db = await hybridSearchManager.getDatabaseConnection();
      const noteId = this.generateNoteIdFromIdentifier(args.identifier);
  
      // Check if note exists
      const note = await db.get('SELECT id FROM notes WHERE id = ?', [noteId]);
      if (!note) {
        throw new Error(`Note not found: ${args.identifier}`);
      }
  
      const links = await LinkExtractor.getLinksForNote(noteId, db);
  
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(
              {
                success: true,
                note_id: noteId,
                links: links
              },
              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.ts:1326-1356 (registration)

  MCP tool dispatch registration in CallToolRequestSchema handler switch statement. Maps 'get_note_links' calls to LinkHandlers.handleGetNoteLinks method.

  case 'get_note_links':
    return await this.linkHandlers.handleGetNoteLinks(
      args as unknown as { identifier: string; vault_id?: string }
    );
  
  case 'get_backlinks':
    return await this.linkHandlers.handleGetBacklinks(
      args as unknown as { identifier: string; vault_id?: string }
    );
  
  case 'find_broken_links':
    return await this.linkHandlers.handleFindBrokenLinks(
      args as unknown as { vault_id?: string }
    );
  
  case 'search_by_links':
    return await this.linkHandlers.handleSearchByLinks(
      args as unknown as {
        has_links_to?: string[];
        linked_from?: string[];
        external_domains?: string[];
        broken_links?: boolean;
        vault_id?: string;
      }
    );
  
  case 'migrate_links':
    return await this.linkHandlers.handleMigrateLinks(
      args as unknown as { force?: boolean; vault_id?: string }
    );

• src/server/tool-schemas.ts:871-889 (schema)

  Input schema definition for get_note_links tool, defining required 'identifier' parameter and optional 'vault_id'.

    name: 'get_note_links',
    description:
      'Get all links for a specific note (incoming, outgoing internal, and external)',
    inputSchema: {
      type: 'object',
      properties: {
        identifier: {
          type: 'string',
          description: 'Note identifier (type/filename format)'
        },
        vault_id: {
          type: 'string',
          description:
            'Optional vault ID to operate on. If not provided, uses the current active vault.'
        }
      },
      required: ['identifier']
    }
  },

• src/server/validation.ts:797-820 (schema)

  Runtime argument validation rules for get_note_links tool args, ensuring identifier format 'type/filename'.

  get_note_links: [
    {
      field: 'identifier',
      required: true,
      type: 'string',
      allowEmpty: false,
      customValidator: (value: any) => {
        if (!value.includes('/')) {
          return 'identifier must be in format "type/filename"';
        }
        const parts = value.split('/');
        if (parts.length !== 2 || !parts[0] || !parts[1]) {
          return 'identifier must be in format "type/filename" with both parts non-empty';
        }
        return null;
      }
    },
    {
      field: 'vault_id',
      required: false,
      type: 'string',
      allowEmpty: false
    }
  ],

• src/server.ts:158-162 (registration)

  Instantiation of LinkHandlers class instance used by get_note_links (and related link tools), injecting vault resolver and note ID generator.

  // Initialize link handlers
  this.linkHandlers = new LinkHandlers(
    this.#resolveVaultContext.bind(this),
    this.#generateNoteIdFromIdentifier.bind(this)
  );