@ansvar/ch-farm-grants-mcp 0.1.0

package/src/tools/search-application-guidance.ts

@@ -0,0 +1,59 @@
+import { buildMeta } from '../metadata.js';
+import { validateJurisdiction } from '../jurisdiction.js';
+import { ftsSearch, type Database } from '../db.js';
+
+interface GuidanceArgs {
+  query: string;
+  jurisdiction?: string;
+}
+
+export function handleSearchApplicationGuidance(db: Database, args: GuidanceArgs) {
+  const jv = validateJurisdiction(args.jurisdiction);
+  if (!jv.valid) return jv.error;
+
+  // Search across grants for application-related content
+  const results = ftsSearch(db, args.query, 20);
+
+  // Also return general application guidance
+  const guidance = {
+    general_process: [
+      'Gesuch beim kantonalen Landwirtschaftsamt einreichen (vor Baubeginn)',
+      'Vorabklaerung mit kantonaler Fachstelle empfohlen',
+      'Kostenvoranschlag und Plaene beilegen',
+      'Baubewilligung der Gemeinde erforderlich (separat)',
+      'Bauausfuehrung erst nach Bewilligung beginnen — sonst kein Beitrag',
+      'Abrechnung nach Fertigstellung mit Rechnungsbelegen',
+      'AGRIDEA-Beratung fuer Projektentwicklung verfuegbar',
+    ],
+    required_documents: [
+      'Gesuchsformular (kantonal)',
+      'Betriebskonzept / Businessplan',
+      'Bau- und Situationsplaene',
+      'Kostenvoranschlag (3 Offerten bei grossen Projekten)',
+      'Finanzierungsplan (Eigenkapital, Kredit, Beitraege)',
+      'Bodennutzungsplan / SAK-Berechnung',
+      'Baubewilligung oder Vorentscheid',
+      'Bei Gemeinschaftsprojekten: Statuten / Vereinbarung',
+    ],
+    contact_points: [
+      { role: 'Kantonales Landwirtschaftsamt', description: 'Erstanlaufstelle, Gesuchseinreichung, kantonale Beitraege' },
+      { role: 'AGRIDEA', description: 'Projektberatung, Machbarkeitsstudien, Wirtschaftlichkeitsberechnungen', url: 'https://www.agridea.ch' },
+      { role: 'Schweizer Berghilfe', description: 'Ergaenzende private Foerderung fuer Bergbetriebe', url: 'https://www.berghilfe.ch' },
+      { role: 'BLW Strukturverbesserungen', description: 'Bundesebene, Investitionskredite', url: 'https://www.blw.admin.ch/blw/de/home/instrumente/strukturverbesserungen.html' },
+    ],
+  };
+
+  return {
+    query: args.query,
+    jurisdiction: jv.jurisdiction,
+    search_results_count: results.length,
+    search_results: results.map(r => ({
+      title: r.title,
+      body: r.body,
+      grant_type: r.grant_type,
+      relevance_rank: r.rank,
+    })),
+    application_guidance: guidance,
+    _meta: buildMeta(),
+  };
+}

package/src/tools/search-grants.ts

@@ -0,0 +1,35 @@
+import { buildMeta } from '../metadata.js';
+import { validateJurisdiction } from '../jurisdiction.js';
+import { ftsSearch, type Database } from '../db.js';
+
+interface SearchArgs {
+  query: string;
+  grant_type?: string;
+  jurisdiction?: string;
+  limit?: number;
+}
+
+export function handleSearchGrants(db: Database, args: SearchArgs) {
+  const jv = validateJurisdiction(args.jurisdiction);
+  if (!jv.valid) return jv.error;
+
+  const limit = Math.min(args.limit ?? 20, 50);
+  let results = ftsSearch(db, args.query, limit);
+
+  if (args.grant_type) {
+    results = results.filter(r => r.grant_type.toLowerCase() === args.grant_type!.toLowerCase());
+  }
+
+  return {
+    query: args.query,
+    jurisdiction: jv.jurisdiction,
+    results_count: results.length,
+    results: results.map(r => ({
+      title: r.title,
+      body: r.body,
+      grant_type: r.grant_type,
+      relevance_rank: r.rank,
+    })),
+    _meta: buildMeta(),
+  };
+}

package/tests/db.test.ts

@@ -0,0 +1,69 @@
+import { describe, test, expect, beforeAll, afterAll } from 'vitest';
+import { createDatabase, type Database } from '../src/db.js';
+import { existsSync, unlinkSync } from 'fs';
+
+const TEST_DB = 'tests/test-database.db';
+
+describe('database layer', () => {
+  let db: Database;
+
+  beforeAll(() => {
+    db = createDatabase(TEST_DB);
+  });
+
+  afterAll(() => {
+    db.close();
+    if (existsSync(TEST_DB)) unlinkSync(TEST_DB);
+  });
+
+  test('creates database with db_metadata table', () => {
+    const row = db.get<{ value: string }>(
+      'SELECT value FROM db_metadata WHERE key = ?',
+      ['schema_version']
+    );
+    expect(row?.value).toBe('1.0');
+  });
+
+  test('FTS5 search_index exists', () => {
+    const result = db.all<{ name: string }>(
+      "SELECT name FROM sqlite_master WHERE type='table' AND name='search_index'"
+    );
+    expect(result).toHaveLength(1);
+  });
+
+  test('journal mode is DELETE', () => {
+    const row = db.get<{ journal_mode: string }>('PRAGMA journal_mode');
+    expect(row?.journal_mode).toBe('delete');
+  });
+
+  test('foreign keys are enabled', () => {
+    const row = db.get<{ foreign_keys: number }>('PRAGMA foreign_keys');
+    expect(row?.foreign_keys).toBe(1);
+  });
+
+  test('all domain tables exist', () => {
+    const tables = ['grants', 'grant_options', 'eligibility_rules', 'application_deadlines'];
+    for (const table of tables) {
+      const result = db.all<{ name: string }>(
+        `SELECT name FROM sqlite_master WHERE type='table' AND name='${table}'`
+      );
+      expect(result, `table ${table} should exist`).toHaveLength(1);
+    }
+  });
+
+  test('mcp_name metadata is set', () => {
+    const row = db.get<{ value: string }>(
+      'SELECT value FROM db_metadata WHERE key = ?',
+      ['mcp_name']
+    );
+    expect(row?.value).toBe('Switzerland Farm Grants MCP');
+  });
+
+  test('jurisdiction metadata is CH', () => {
+    const row = db.get<{ value: string }>(
+      'SELECT value FROM db_metadata WHERE key = ?',
+      ['jurisdiction']
+    );
+    expect(row?.value).toBe('CH');
+  });
+});

package/tests/helpers/seed-db.ts

@@ -0,0 +1,188 @@
+import { createDatabase, type Database } from '../../src/db.js';
+
+export function createSeededDatabase(dbPath: string): Database {
+  const db = createDatabase(dbPath);
+
+  // --- Grants ---
+  const grants: [string, string, string, string, number | null, number | null, number | null, string | null, string, string][] = [
+    [
+      'ik-oekonomiegebaeude',
+      'Investitionskredit Oekonomiegebaeude',
+      'investitionskredit',
+      'Zinsloses Darlehen des Bundes fuer den Bau oder Umbau von Oekonomiegebaeuden (Staelle, Scheunen, Remisen).',
+      null,
+      null,
+      20,
+      JSON.stringify({ bergzone_i: '+10% Beitragssatz', bergzone_ii: '+15% Beitragssatz', soemmerungsgebiet: '+20% Beitragssatz' }),
+      'SVV Art. 44 ff.; BLW Weisungen Investitionskredite',
+      'DE',
+    ],
+    [
+      'beitrag-stallbau',
+      'Beitrag Stallbau',
+      'beitrag',
+      'Bundesbeitrag fuer den Neubau oder Umbau von Staellen. Beitragssatz abhaengig von Zone und Tierkategorie.',
+      30,
+      200000,
+      null,
+      JSON.stringify({ huegelzone: '+5% Beitragssatz', bergzone_i: '+10% Beitragssatz' }),
+      'SVV Art. 18 ff.',
+      'DE',
+    ],
+    [
+      'meliorationsbeitrag-wegebau',
+      'Meliorationsbeitrag Wegebau',
+      'meliorationsbeitrag',
+      'Beitrag fuer den Bau und Unterhalt von landwirtschaftlichen Gueterwegen und Erschliessungsstrassen.',
+      40,
+      500000,
+      null,
+      null,
+      'SVV Art. 14 ff.',
+      'DE',
+    ],
+    [
+      'pre-regionale-entwicklung',
+      'Projekt zur regionalen Entwicklung (PRE)',
+      'pre',
+      'Foerderung von Projekten zur regionalen Entwicklung in laendlichen Gebieten.',
+      50,
+      1000000,
+      8,
+      null,
+      'SVV Art. 93 ff.; LwG Art. 93',
+      'DE',
+    ],
+    [
+      'starthilfe-junglandwirte',
+      'Starthilfe Junglandwirte',
+      'starthilfe',
+      'Zinsloses Darlehen oder Beitrag fuer Junglandwirte bei Betriebsuebernahme.',
+      null,
+      250000,
+      15,
+      null,
+      'SVV Art. 86 ff.',
+      'DE',
+    ],
+    [
+      'ressourcenprogramm-ammoniak',
+      'Ressourcenprogramm Ammoniakreduktion',
+      'ressourcenprogramm',
+      'Beitraege fuer Massnahmen zur Reduktion von Ammoniakemissionen in der Landwirtschaft.',
+      80,
+      null,
+      6,
+      null,
+      'LwG Art. 77a/77b',
+      'DE',
+    ],
+    [
+      'gewaesserschutz-nitrat',
+      'Gewaesserschutzprojekt Nitratreduktion',
+      'gewaesserschutz',
+      'Beitraege fuer Massnahmen zur Reduktion von Nitratbelastung in Gewaessern.',
+      80,
+      null,
+      6,
+      null,
+      'GSchG Art. 62a',
+      'DE',
+    ],
+  ];
+
+  for (const [id, name, grantType, desc, rate, maxAmt, duration, zoneBonus, legalBasis, lang] of grants) {
+    db.run(
+      `INSERT INTO grants (id, name, grant_type, description, federal_rate_pct, max_amount, duration_years, zone_bonus, legal_basis, language, jurisdiction)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'CH')`,
+      [id, name, grantType, desc, rate, maxAmt, duration, zoneBonus, legalBasis, lang]
+    );
+  }
+
+  // --- Grant Options ---
+  const grantOptions: [string, string, string, string, string][] = [
+    ['ik-oekonomiegebaeude', 'Neubau Milchviehstall', 'Neubau eines BTS-konformen Milchviehstalls', 'Darlehen bis max. anrechenbare Kosten', 'BTS-Konformitaet erforderlich'],
+    ['ik-oekonomiegebaeude', 'Umbau Scheune', 'Umbau bestehender Oekonomiegebaeude', 'Darlehen bis max. anrechenbare Kosten', 'Baubewilligung erforderlich'],
+    ['beitrag-stallbau', 'Laufstall Milchvieh', 'Beitrag fuer Laufstallsysteme mit BTS', '30% der anrechenbaren Kosten', 'Min. 20 GVE'],
+    ['beitrag-stallbau', 'Anbindestall Umbau', 'Beitrag fuer Umbau von Anbinde- zu Laufstallhaltung', '35% der anrechenbaren Kosten', 'Verbesserung Tierwohl nachweisen'],
+    ['meliorationsbeitrag-wegebau', 'Gueterweg Neubau', 'Neubau landwirtschaftlicher Gueterwege', '40% der anrechenbaren Kosten', 'Erschliessung von min. 3 Betrieben'],
+    ['pre-regionale-entwicklung', 'Verarbeitung und Vermarktung', 'Regionale Verarbeitungs- und Vermarktungsprojekte', 'Bis 50% Bundesbeitrag', 'Min. 5 Betriebe beteiligt'],
+  ];
+
+  for (const [grantId, optionName, desc, rate, conditions] of grantOptions) {
+    db.run(
+      `INSERT INTO grant_options (grant_id, option_name, description, rate, conditions)
+       VALUES (?, ?, ?, ?, ?)`,
+      [grantId, optionName, desc, rate, conditions]
+    );
+  }
+
+  // --- Eligibility Rules ---
+  const eligibilityRules: [string, string | null, string | null, string | null, string][] = [
+    ['ik-oekonomiegebaeude', 'milchwirtschaft', 'stallbau', null, 'Betrieb muss SAK-Mindestgroesse erfuellen (mind. 1.0 SAK)'],
+    ['ik-oekonomiegebaeude', 'bergbetrieb', 'stallbau', 'bergzone_i', 'Betrieb im Berggebiet, SAK 0.75 genuegend'],
+    ['ik-oekonomiegebaeude', 'alle', 'hofduengerlager', null, 'Gewaesserschutzkonformitaet nachweisen'],
+    ['beitrag-stallbau', 'milchwirtschaft', 'stallbau', null, 'BTS-Konformitaet, min. 20 GVE'],
+    ['beitrag-stallbau', 'mutterkuhhaltung', 'stallbau', null, 'BTS-Konformitaet, min. 15 GVE'],
+    ['beitrag-stallbau', 'bergbetrieb', 'stallbau', 'bergzone_i', 'BTS-Konformitaet, min. 10 GVE im Berggebiet'],
+    ['meliorationsbeitrag-wegebau', 'alle', 'wegebau', null, 'Erschliessung von min. 3 Betrieben, Traegerschaft erforderlich'],
+    ['starthilfe-junglandwirte', 'junglandwirt', null, null, 'Max. 35 Jahre alt bei Betriebsuebernahme, landwirtschaftliche Ausbildung'],
+    ['pre-regionale-entwicklung', 'gemeinschaft', null, null, 'Min. 5 Betriebe, Traegerschaft, regionale Wertschoepfung'],
+    ['ressourcenprogramm-ammoniak', 'alle', null, null, 'Teilnahme an kantonal genehmigtem Ressourcenprogramm'],
+    ['gewaesserschutz-nitrat', 'ackerbau', null, null, 'Betrieb in Projektperimeter eines Gewaesserschutzprojekts'],
+  ];
+
+  for (const [grantId, farmType, investType, zone, req] of eligibilityRules) {
+    db.run(
+      `INSERT INTO eligibility_rules (grant_id, farm_type, investment_type, zone, requirement)
+       VALUES (?, ?, ?, ?, ?)`,
+      [grantId, farmType, investType, zone, req]
+    );
+  }
+
+  // --- Application Deadlines ---
+  const deadlines: [string, string | null, string | null, string | null][] = [
+    ['ik-oekonomiegebaeude', null, null, 'Gesuch jederzeit beim kantonalen Landwirtschaftsamt einreichen'],
+    ['ik-oekonomiegebaeude', 'BE', '2026-03-31', 'Kanton Bern: Frist 31. Maerz fuer Fruehjahrsrunde'],
+    ['ik-oekonomiegebaeude', 'ZH', '2026-06-30', 'Kanton Zuerich: Frist 30. Juni'],
+    ['beitrag-stallbau', null, null, 'Gesuch vor Baubeginn einreichen'],
+    ['beitrag-stallbau', 'GR', '2026-04-30', 'Kanton Graubuenden: Frist 30. April'],
+    ['starthilfe-junglandwirte', null, null, 'Innerhalb 2 Jahren nach Betriebsuebernahme'],
+    ['pre-regionale-entwicklung', null, null, 'Projektskizze beim BLW einreichen, keine feste Frist'],
+  ];
+
+  for (const [grantId, canton, deadline, notes] of deadlines) {
+    db.run(
+      `INSERT INTO application_deadlines (grant_id, canton, deadline_date, notes)
+       VALUES (?, ?, ?, ?)`,
+      [grantId, canton, deadline, notes]
+    );
+  }
+
+  // --- FTS5 Search Index ---
+  const ftsData: [string, string, string, string][] = [
+    ['Investitionskredit Oekonomiegebaeude', 'Zinsloses Darlehen fuer Stallbau, Scheunenbau, Remisen. SVV Art. 44. Laufzeit 20 Jahre. BTS-konforme Staelle bevorzugt.', 'investitionskredit', 'CH'],
+    ['Beitrag Stallbau', 'Bundesbeitrag fuer Neubau oder Umbau von Staellen. Beitragssatz 30% in der Talzone, hoeher im Berggebiet. BTS Tierwohl.', 'beitrag', 'CH'],
+    ['Meliorationsbeitrag Wegebau', 'Beitrag fuer landwirtschaftliche Gueterwege und Erschliessungsstrassen. Beitragssatz 40%.', 'meliorationsbeitrag', 'CH'],
+    ['PRE Regionale Entwicklung', 'Projekte zur regionalen Entwicklung in laendlichen Gebieten. Verarbeitung, Vermarktung, Agrotourismus.', 'pre', 'CH'],
+    ['Starthilfe Junglandwirte', 'Zinsloses Darlehen fuer Junglandwirte bei Betriebsuebernahme. Max. 35 Jahre. Landwirtschaftliche Ausbildung.', 'starthilfe', 'CH'],
+    ['Ressourcenprogramm Ammoniak', 'Beitraege zur Reduktion von Ammoniakemissionen. LwG Art. 77a. Schleppschlauch, Abdeckung Guellelager.', 'ressourcenprogramm', 'CH'],
+    ['Gewaesserschutz Nitrat', 'Beitraege zur Reduktion von Nitratbelastung. GSchG Art. 62a. Extensivierung in Projektperimetern.', 'gewaesserschutz', 'CH'],
+    ['Hofduengerlager Investitionskredit', 'Darlehen fuer Bau und Erweiterung von Guellegruben, Mistplatten. Gewaesserschutzkonformitaet.', 'investitionskredit', 'CH'],
+    ['Alpgebaeude Sanierung Berggebiet', 'Investitionskredit und Beitrag fuer Sanierung von Alpgebaeuden. Erhoehte Saetze im Soemmerungsgebiet.', 'beitrag', 'CH'],
+    ['Kaeserei Gemeinschaftsprojekt', 'Investitionskredit fuer Bau oder Umbau von Alpkaesereien. Gemeinschaftliche Traegerschaft.', 'investitionskredit', 'CH'],
+  ];
+
+  for (const [title, body, grantType, jurisdiction] of ftsData) {
+    db.run(
+      `INSERT INTO search_index (title, body, grant_type, jurisdiction) VALUES (?, ?, ?, ?)`,
+      [title, body, grantType, jurisdiction]
+    );
+  }
+
+  // --- Metadata ---
+  db.run("INSERT OR REPLACE INTO db_metadata (key, value) VALUES ('last_ingest', '2026-04-05')", []);
+  db.run("INSERT OR REPLACE INTO db_metadata (key, value) VALUES ('build_date', '2026-04-05')", []);
+
+  return db;
+}

package/tests/jurisdiction.test.ts

@@ -0,0 +1,35 @@
+import { describe, test, expect } from 'vitest';
+import { validateJurisdiction, SUPPORTED_JURISDICTIONS } from '../src/jurisdiction.js';
+
+describe('jurisdiction validation', () => {
+  test('accepts CH', () => {
+    const result = validateJurisdiction('CH');
+    expect(result).toEqual({ valid: true, jurisdiction: 'CH' });
+  });
+
+  test('defaults to CH when undefined', () => {
+    const result = validateJurisdiction(undefined);
+    expect(result).toEqual({ valid: true, jurisdiction: 'CH' });
+  });
+
+  test('rejects unsupported jurisdiction', () => {
+    const result = validateJurisdiction('DE');
+    expect(result).toEqual({
+      valid: false,
+      error: {
+        error: 'jurisdiction_not_supported',
+        supported: ['CH'],
+        message: 'This server currently covers Switzerland. More jurisdictions are planned.',
+      },
+    });
+  });
+
+  test('normalises lowercase input', () => {
+    const result = validateJurisdiction('ch');
+    expect(result).toEqual({ valid: true, jurisdiction: 'CH' });
+  });
+
+  test('SUPPORTED_JURISDICTIONS contains CH', () => {
+    expect(SUPPORTED_JURISDICTIONS).toContain('CH');
+  });
+});

package/tests/tools/about.test.ts

@@ -0,0 +1,23 @@
+import { describe, test, expect } from 'vitest';
+import { handleAbout } from '../../src/tools/about.js';
+
+describe('about tool', () => {
+  test('returns server metadata', () => {
+    const result = handleAbout();
+    expect(result.name).toBe('Switzerland Farm Grants MCP');
+    expect(result.description).toContain('SVV');
+    expect(result.description).toContain('Investitionskredite');
+    expect(result.jurisdiction).toEqual(['CH']);
+    expect(result.tools_count).toBe(10);
+    expect(result.links).toHaveProperty('homepage');
+    expect(result.links).toHaveProperty('repository');
+    expect(result._meta).toHaveProperty('disclaimer');
+  });
+
+  test('data_sources lists all sources', () => {
+    const result = handleAbout();
+    expect(result.data_sources).toContain('Strukturverbesserungsverordnung (SVV, SR 913.1)');
+    expect(result.data_sources).toContain('BLW Weisungen Investitionskredite und Beitraege');
+    expect(result.data_sources.length).toBe(4);
+  });
+});

package/tests/tools/check-freshness.test.ts

@@ -0,0 +1,53 @@
+import { describe, test, expect, beforeAll, afterAll } from 'vitest';
+import { handleCheckFreshness } from '../../src/tools/check-freshness.js';
+import { createDatabase, type Database } from '../../src/db.js';
+import { existsSync, unlinkSync } from 'fs';
+
+const TEST_DB = 'tests/test-check-freshness.db';
+
+describe('check_data_freshness tool', () => {
+  let db: Database;
+
+  beforeAll(() => {
+    db = createDatabase(TEST_DB);
+  });
+
+  afterAll(() => {
+    db.close();
+    if (existsSync(TEST_DB)) unlinkSync(TEST_DB);
+  });
+
+  test('returns unknown when no ingest date', () => {
+    const result = handleCheckFreshness(db);
+    expect(result.status).toBe('unknown');
+    expect(result.days_since_ingest).toBeNull();
+  });
+
+  test('returns fresh when recently ingested', () => {
+    const today = new Date().toISOString().split('T')[0];
+    db.run("INSERT OR REPLACE INTO db_metadata (key, value) VALUES ('last_ingest', ?)", [today]);
+
+    const result = handleCheckFreshness(db);
+    expect(result.status).toBe('fresh');
+    expect(result.days_since_ingest).toBeLessThanOrEqual(1);
+  });
+
+  test('returns stale when old ingest', () => {
+    db.run("INSERT OR REPLACE INTO db_metadata (key, value) VALUES ('last_ingest', '2025-01-01')", []);
+
+    const result = handleCheckFreshness(db);
+    expect(result.status).toBe('stale');
+    expect(result.days_since_ingest).toBeGreaterThan(90);
+  });
+
+  test('includes refresh command', () => {
+    const result = handleCheckFreshness(db);
+    expect(result.refresh_command).toContain('gh workflow run');
+    expect(result.refresh_command).toContain('ch-farm-grants-mcp');
+  });
+
+  test('includes schema_version', () => {
+    const result = handleCheckFreshness(db);
+    expect(result.schema_version).toBe('1.0');
+  });
+});

package/tests/tools/list-sources.test.ts

@@ -0,0 +1,47 @@
+import { describe, test, expect, beforeAll, afterAll } from 'vitest';
+import { handleListSources } from '../../src/tools/list-sources.js';
+import { createDatabase, type Database } from '../../src/db.js';
+import { existsSync, unlinkSync } from 'fs';
+
+const TEST_DB = 'tests/test-list-sources.db';
+
+describe('list_sources tool', () => {
+  let db: Database;
+
+  beforeAll(() => {
+    db = createDatabase(TEST_DB);
+  });
+
+  afterAll(() => {
+    db.close();
+    if (existsSync(TEST_DB)) unlinkSync(TEST_DB);
+  });
+
+  test('returns 4 data sources', () => {
+    const result = handleListSources(db);
+    expect(result.sources).toHaveLength(4);
+  });
+
+  test('first source is SVV', () => {
+    const result = handleListSources(db);
+    expect(result.sources[0].name).toContain('SVV');
+    expect(result.sources[0].authority).toContain('BLW');
+  });
+
+  test('all sources have required fields', () => {
+    const result = handleListSources(db);
+    for (const source of result.sources) {
+      expect(source).toHaveProperty('name');
+      expect(source).toHaveProperty('authority');
+      expect(source).toHaveProperty('official_url');
+      expect(source).toHaveProperty('license');
+      expect(source).toHaveProperty('update_frequency');
+    }
+  });
+
+  test('includes _meta with disclaimer', () => {
+    const result = handleListSources(db);
+    expect(result._meta).toHaveProperty('disclaimer');
+    expect(result._meta.server).toBe('ch-farm-grants-mcp');
+  });
+});

package/tests/tools/search-grants.test.ts

@@ -0,0 +1,57 @@
+import { describe, test, expect, beforeAll, afterAll } from 'vitest';
+import { handleSearchGrants } from '../../src/tools/search-grants.js';
+import { createSeededDatabase } from '../helpers/seed-db.js';
+import type { Database } from '../../src/db.js';
+import { existsSync, unlinkSync } from 'fs';
+
+const TEST_DB = 'tests/test-search-grants.db';
+
+describe('search_grants tool', () => {
+  let db: Database;
+
+  beforeAll(() => {
+    db = createSeededDatabase(TEST_DB);
+  });
+
+  afterAll(() => {
+    db.close();
+    if (existsSync(TEST_DB)) unlinkSync(TEST_DB);
+  });
+
+  test('returns results for Investitionskredit query', () => {
+    const result = handleSearchGrants(db, { query: 'Investitionskredit' });
+    expect(result).toHaveProperty('results_count');
+    expect((result as { results_count: number }).results_count).toBeGreaterThan(0);
+  });
+
+  test('returns results for Stallbau query', () => {
+    const result = handleSearchGrants(db, { query: 'Stallbau' });
+    expect(result).toHaveProperty('results_count');
+    expect((result as { results_count: number }).results_count).toBeGreaterThan(0);
+  });
+
+  test('respects grant_type filter', () => {
+    const result = handleSearchGrants(db, { query: 'Darlehen Beitrag Stallbau Investitionskredit', grant_type: 'beitrag' });
+    const typed = result as { results: { grant_type: string }[] };
+    for (const r of typed.results) {
+      expect(r.grant_type).toBe('beitrag');
+    }
+  });
+
+  test('rejects unsupported jurisdiction', () => {
+    const result = handleSearchGrants(db, { query: 'Stallbau', jurisdiction: 'DE' });
+    expect(result).toHaveProperty('error', 'jurisdiction_not_supported');
+  });
+
+  test('limits results', () => {
+    const result = handleSearchGrants(db, { query: 'Investitionskredit Beitrag Stallbau Wegebau PRE Starthilfe Ressourcenprogramm Gewaesserschutz', limit: 3 });
+    const typed = result as { results: unknown[] };
+    expect(typed.results.length).toBeLessThanOrEqual(3);
+  });
+
+  test('returns _meta with disclaimer', () => {
+    const result = handleSearchGrants(db, { query: 'Stallbau' });
+    expect(result).toHaveProperty('_meta');
+    expect((result as { _meta: { disclaimer: string } })._meta.disclaimer).toBeTruthy();
+  });
+});

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests", "scripts"]
+}