teryt-mcp 0.1.1 → 0.1.3

package/dist/app-DumxnZvs.d.ts

@@ -0,0 +1,21 @@
+import * as _mcp_craftman_core from '@mcp-craftman/core';
+import { RuntimeConfig } from '@mcp-craftman/node';
+
+type DatasetCode = "TERC" | "SIMC" | "ULIC" | "WMRODZ";
+
+type SourceFile = {
+    readonly dataset: DatasetCode;
+    readonly content: Uint8Array;
+    readonly sourceUrl: string;
+    readonly stateDate: string;
+};
+type TerytSource = {
+    readonly download: (dataset: DatasetCode) => Promise<SourceFile>;
+};
+
+type CreateAppOverrides = {
+    readonly syncSource?: TerytSource;
+};
+declare function createApp(config?: RuntimeConfig, overrides?: CreateAppOverrides): _mcp_craftman_core.McpApp;
+
+export { createApp as c };

package/dist/{chunk-GSWKF6BK.js → chunk-LDGYCOB4.js}

@@ -1,8 +1,11 @@
+// src/version.ts
+var terytMcpVersion = "0.1.3";
+
 // src/features/server-status/application/get-server-status.ts
 function getServerStatus(input) {
   return {
     serverName: "teryt-mcp",
-    serverVersion: "0.1.0",
+    serverVersion: terytMcpVersion,
     frameworkVersion: input.frameworkVersion,
     transport: input.transport,
     dataDir: input.dataDir,
@@ -68,210 +71,6 @@ function createServerStatusTool(input) {
 import { createMcpApp } from "@mcp-craftman/core";
 import { loadRuntimeConfig } from "@mcp-craftman/node";
 
-// src/features/get-place/infrastructure/in-memory-place-details-repository.ts
-var fixturePlaces = [
-  {
-    id: "0009876",
-    name: "Boles\u0142awiec",
-    stateDate: "2026-01-01",
-    unitId: "02-01-01-1"
-  },
-  {
-    id: "0012345",
-    name: "Stara Wie\u015B",
-    stateDate: "2026-01-01",
-    unitId: "02-01-02-2"
-  }
-];
-var InMemoryPlaceDetailsRepository = class {
-  async getPlace(id) {
-    return fixturePlaces.find((place) => place.id === id) ?? null;
-  }
-};
-
-// src/features/get-street/infrastructure/in-memory-street-details-repository.ts
-var fixtureStreets = [
-  {
-    code: "0000123",
-    id: "0009876-0000123",
-    name: "Marsza\u0142kowska",
-    placeId: "0009876",
-    stateDate: "2026-01-01"
-  },
-  {
-    code: "0000456",
-    id: "0009876-0000456",
-    name: "Rynek",
-    placeId: "0009876",
-    stateDate: "2026-01-01"
-  }
-];
-var InMemoryStreetDetailsRepository = class {
-  async getStreet(id) {
-    return fixtureStreets.find((street) => street.id === id || street.code === id) ?? null;
-  }
-};
-
-// src/features/get-unit/infrastructure/in-memory-unit-details-repository.ts
-var fixtureStateDate = "2026-01-01";
-var fixtureUnits = [
-  {
-    id: "02",
-    name: "DOLNO\u015AL\u0104SKIE",
-    stateDate: fixtureStateDate,
-    type: "wojew\xF3dztwo"
-  },
-  {
-    id: "02-01-01-1",
-    name: "Boles\u0142awiec",
-    stateDate: fixtureStateDate,
-    type: "gmina miejska"
-  },
-  {
-    id: "02-01-02-2",
-    name: "Boles\u0142awiec",
-    stateDate: fixtureStateDate,
-    type: "gmina wiejska"
-  }
-];
-var InMemoryUnitDetailsRepository = class {
-  async getUnit(id) {
-    return fixtureUnits.find((unit) => unit.id === id) ?? null;
-  }
-};
-
-// src/features/resolve-address/infrastructure/in-memory-address-repository.ts
-var fixturePlace = {
-  id: "0009876",
-  name: "Boles\u0142awiec"
-};
-var fixtureStateDate2 = "2026-01-01";
-var fixtureUnit = {
-  id: "02-01-01-1",
-  name: "Boles\u0142awiec",
-  type: "gmina miejska"
-};
-var fixtureAddresses = [
-  {
-    id: "0009876-0000123",
-    place: fixturePlace,
-    stateDate: fixtureStateDate2,
-    street: {
-      code: "0000123",
-      id: "0009876-0000123",
-      name: "Marsza\u0142kowska"
-    },
-    unit: fixtureUnit
-  },
-  {
-    id: "0009876-0000456",
-    place: fixturePlace,
-    stateDate: fixtureStateDate2,
-    street: {
-      code: "0000456",
-      id: "0009876-0000456",
-      name: "Rynek"
-    },
-    unit: fixtureUnit
-  }
-];
-var InMemoryAddressRepository = class {
-  async listAddresses() {
-    return fixtureAddresses;
-  }
-};
-
-// src/features/search-places/infrastructure/in-memory-place-repository.ts
-var fixtureStateDate3 = "2026-01-01";
-var fixturePlaces2 = [
-  {
-    id: "0009876",
-    name: "Boles\u0142awiec",
-    stateDate: fixtureStateDate3,
-    unitId: "02-01-01-1"
-  },
-  {
-    id: "0011111",
-    name: "Krak\xF3w",
-    stateDate: fixtureStateDate3,
-    unitId: "12-61-01-1"
-  },
-  {
-    id: "0012222",
-    name: "Warszawa",
-    stateDate: fixtureStateDate3,
-    unitId: "14-65-01-1"
-  },
-  {
-    id: "0012345",
-    name: "Stara Wie\u015B",
-    stateDate: fixtureStateDate3,
-    unitId: "02-01-02-2"
-  },
-  {
-    id: "0013333",
-    name: "D\u0105browa",
-    stateDate: fixtureStateDate3,
-    unitId: "24-01-01-2"
-  }
-];
-var InMemoryPlaceRepository = class {
-  async listPlaces() {
-    return fixturePlaces2;
-  }
-};
-
-// src/features/search-streets/infrastructure/in-memory-street-repository.ts
-var fixtureStreets2 = [
-  {
-    code: "0000123",
-    id: "0009876-0000123",
-    name: "Marsza\u0142kowska",
-    placeId: "0009876",
-    stateDate: "2026-01-01"
-  },
-  {
-    code: "0000456",
-    id: "0009876-0000456",
-    name: "Rynek",
-    placeId: "0009876",
-    stateDate: "2026-01-01"
-  }
-];
-var InMemoryStreetRepository = class {
-  async listStreets() {
-    return fixtureStreets2;
-  }
-};
-
-// src/features/search-units/infrastructure/in-memory-unit-repository.ts
-var fixtureStateDate4 = "2026-01-01";
-var fixtureUnits2 = [
-  {
-    id: "02",
-    name: "DOLNO\u015AL\u0104SKIE",
-    stateDate: fixtureStateDate4,
-    type: "wojew\xF3dztwo"
-  },
-  {
-    id: "02-01-01-1",
-    name: "Boles\u0142awiec",
-    stateDate: fixtureStateDate4,
-    type: "gmina miejska"
-  },
-  {
-    id: "02-01-02-2",
-    name: "Boles\u0142awiec",
-    stateDate: fixtureStateDate4,
-    type: "gmina wiejska"
-  }
-];
-var InMemoryUnitRepository = class {
-  async listUnits() {
-    return fixtureUnits2;
-  }
-};
-
 // src/features/source-status/infrastructure/eteryt-source-catalog.ts
 var SOURCE_URL = "https://eteryt.stat.gov.pl/eTeryt/";
 var EterytSourceCatalog = class {
@@ -817,7 +616,7 @@ function insertStreets(db, rows) {
         `${row.values.SYM ?? ""}-${row.values.SYM_UL ?? ""}`,
         row.values.SYM ?? "",
         row.values.SYM_UL ?? "",
-        [row.values.CECHA, row.values.NAZWA_1, row.values.NAZWA_2].filter(Boolean).join(" "),
+        [row.values.NAZWA_1, row.values.NAZWA_2].filter(Boolean).join(" "),
         row.values.SYM ?? "",
         row.values.STAN_NA ?? ""
       ]);
@@ -834,7 +633,7 @@ function findImport(imports, dataset) {
   return imported;
 }
 function createUnitId2(values) {
-  return [values.WOJ ?? "", values.POW ?? "", values.GMI ?? "", values.RODZ ?? values.RODZ_GMI ?? ""].join("-");
+  return [values.WOJ, values.POW, values.GMI, values.RODZ ?? values.RODZ_GMI].filter(Boolean).join("-");
 }
 
 // src/features/sync-database/infrastructure/sqlite-database-builder.ts
@@ -934,6 +733,176 @@ function rollback(db) {
   }
 }
 
+// src/features/sync-database/infrastructure/sqlite-query.ts
+import { readFile as readFile2 } from "fs/promises";
+import { join as join5 } from "path";
+import initSqlJs2 from "sql.js";
+var sqlJs2;
+async function withTerytDatabase(dataDir, callback) {
+  let content;
+  try {
+    content = await readFile2(join5(dataDir, "teryt.sqlite"));
+  } catch (error) {
+    if (isMissingFile2(error)) {
+      const db2 = await createEmptyDatabase();
+      try {
+        return callback(db2);
+      } finally {
+        db2.close();
+      }
+    }
+    throw error;
+  }
+  const SQL = await loadSqlJs2();
+  const db = new SQL.Database(content);
+  try {
+    return callback(db);
+  } finally {
+    db.close();
+  }
+}
+function queryOne(db, sql, params, map) {
+  return queryMany(db, sql, params, map)[0] ?? null;
+}
+function queryMany(db, sql, params, map) {
+  const statement = db.prepare(sql);
+  const rows = [];
+  try {
+    statement.bind([...params]);
+    while (statement.step()) {
+      rows.push(map(statement.getAsObject()));
+    }
+  } finally {
+    statement.free();
+  }
+  return rows;
+}
+async function createEmptyDatabase() {
+  const SQL = await loadSqlJs2();
+  const db = new SQL.Database();
+  db.run("CREATE TABLE places (id TEXT, name TEXT, stateDate TEXT, unitId TEXT)");
+  db.run("CREATE TABLE streets (SYM_UL TEXT, id TEXT, name TEXT, placeId TEXT, stateDate TEXT)");
+  db.run("CREATE TABLE units (id TEXT, name TEXT, stateDate TEXT, type TEXT)");
+  return db;
+}
+function loadSqlJs2() {
+  sqlJs2 ??= initSqlJs2();
+  return sqlJs2;
+}
+function isMissingFile2(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+
+// src/features/sync-database/infrastructure/sqlite-teryt-repository.ts
+var SqliteTerytRepository = class {
+  constructor(dataDir) {
+    this.dataDir = dataDir;
+  }
+  dataDir;
+  async getPlace(id) {
+    return withTerytDatabase(this.dataDir, (db) => queryOne(db, "SELECT id, name, stateDate, unitId FROM places WHERE id = ?", [id], mapPlace));
+  }
+  async getStreet(id) {
+    return withTerytDatabase(
+      this.dataDir,
+      (db) => queryOne(
+        db,
+        "SELECT SYM_UL AS code, id, name, placeId, stateDate FROM streets WHERE id = ? OR SYM_UL = ?",
+        [id, id],
+        mapStreet
+      )
+    );
+  }
+  async getUnit(id) {
+    return withTerytDatabase(this.dataDir, (db) => queryOne(db, "SELECT id, name, stateDate, type FROM units WHERE id = ?", [id], mapUnit));
+  }
+  async listAddresses() {
+    return withTerytDatabase(
+      this.dataDir,
+      (db) => queryMany(
+        db,
+        `SELECT
+          streets.id AS id,
+          streets.stateDate AS stateDate,
+          streets.SYM_UL AS streetCode,
+          streets.name AS streetName,
+          places.id AS placeId,
+          places.name AS placeName,
+          units.id AS unitId,
+          units.name AS unitName,
+          units.type AS unitType
+        FROM streets
+        JOIN places ON places.id = streets.placeId
+        JOIN units ON units.id = places.unitId
+        ORDER BY places.name, streets.name, streets.id`,
+        [],
+        mapAddress
+      )
+    );
+  }
+  async listPlaces() {
+    return withTerytDatabase(this.dataDir, (db) => queryMany(db, "SELECT id, name, stateDate, unitId FROM places ORDER BY name, id", [], mapPlace));
+  }
+  async listStreets() {
+    return withTerytDatabase(
+      this.dataDir,
+      (db) => queryMany(db, "SELECT SYM_UL AS code, id, name, placeId, stateDate FROM streets ORDER BY name, id", [], mapStreet)
+    );
+  }
+  async listUnits() {
+    return withTerytDatabase(this.dataDir, (db) => queryMany(db, "SELECT id, name, stateDate, type FROM units ORDER BY name, id", [], mapUnit));
+  }
+};
+function mapPlace(row) {
+  return {
+    id: readText(row.id),
+    name: readText(row.name),
+    stateDate: readText(row.stateDate),
+    unitId: readText(row.unitId)
+  };
+}
+function mapStreet(row) {
+  return {
+    code: readText(row.code),
+    id: readText(row.id),
+    name: readText(row.name),
+    placeId: readText(row.placeId),
+    stateDate: readText(row.stateDate)
+  };
+}
+function mapUnit(row) {
+  return {
+    id: readText(row.id),
+    name: readText(row.name),
+    stateDate: readText(row.stateDate),
+    type: readText(row.type)
+  };
+}
+function mapAddress(row) {
+  const streetId = readText(row.id);
+  return {
+    id: streetId,
+    place: {
+      id: readText(row.placeId),
+      name: readText(row.placeName)
+    },
+    stateDate: readText(row.stateDate),
+    street: {
+      code: readText(row.streetCode),
+      id: streetId,
+      name: readText(row.streetName)
+    },
+    unit: {
+      id: readText(row.unitId),
+      name: readText(row.unitName),
+      type: readText(row.unitType)
+    }
+  };
+}
+function readText(value) {
+  return typeof value === "string" ? value : "";
+}
+
 // src/mcp/registry.ts
 import { createCapabilityRegistry } from "@mcp-craftman/core";
 
@@ -1295,7 +1264,7 @@ function normalizeName(value) {
 }
 
 // src/features/resolve-address/mcp/resolve-address.tool.ts
-import { defineTool as defineTool6, readOptionalNumberField, readRequiredStringField as readRequiredStringField4 } from "@mcp-craftman/core";
+import { defineTool as defineTool6, readQueryLimitInput } from "@mcp-craftman/core";
 function createResolveAddressTool(dependencies) {
   return defineTool6({
     inputSchema,
@@ -1308,7 +1277,7 @@ function createResolveAddressTool(dependencies) {
       readOnlyHint: true
     },
     handler: async (input) => ({
-      structuredContent: await resolveAddress(parseInput4(input), dependencies)
+      structuredContent: await resolveAddress(readQueryLimitInput(input, "resolve_address"), dependencies)
     })
   });
 }
@@ -1420,14 +1389,6 @@ var outputSchema = {
   },
   required: ["addresses", "stateDate"]
 };
-function parseInput4(input) {
-  const query = readRequiredStringField4(input, "query", "resolve_address");
-  const limit = readOptionalNumberField(input, "limit", "resolve_address");
-  return {
-    limit,
-    query
-  };
-}
 
 // src/features/search-places/application/search-places.ts
 var DEFAULT_LIMIT2 = 20;
@@ -1502,7 +1463,7 @@ function normalizeName2(value) {
 }
 
 // src/features/search-places/mcp/search-places.tool.ts
-import { defineTool as defineTool7, readOptionalNumberField as readOptionalNumberField2, readRequiredStringField as readRequiredStringField5 } from "@mcp-craftman/core";
+import { defineTool as defineTool7, readQueryLimitInput as readQueryLimitInput2 } from "@mcp-craftman/core";
 function createSearchPlacesTool(dependencies) {
   return defineTool7({
     name: "search_places",
@@ -1578,18 +1539,10 @@ function createSearchPlacesTool(dependencies) {
       readOnlyHint: true
     },
     handler: async (input) => ({
-      structuredContent: await searchPlaces(parseInput5(input), dependencies)
+      structuredContent: await searchPlaces(readQueryLimitInput2(input, "search_places"), dependencies)
     })
   });
 }
-function parseInput5(input) {
-  const query = readRequiredStringField5(input, "query", "search_places");
-  const limit = readOptionalNumberField2(input, "limit", "search_places");
-  return {
-    limit,
-    query
-  };
-}
 
 // src/features/search-streets/application/search-streets.ts
 var DEFAULT_LIMIT3 = 20;
@@ -1664,7 +1617,7 @@ function normalizeName3(value) {
 }
 
 // src/features/search-streets/mcp/search-streets.tool.ts
-import { defineTool as defineTool8, readOptionalNumberField as readOptionalNumberField3, readRequiredStringField as readRequiredStringField6 } from "@mcp-craftman/core";
+import { defineTool as defineTool8, readQueryLimitInput as readQueryLimitInput3 } from "@mcp-craftman/core";
 function createSearchStreetsTool(dependencies) {
   return defineTool8({
     inputSchema: inputSchema2,
@@ -1677,7 +1630,7 @@ function createSearchStreetsTool(dependencies) {
       readOnlyHint: true
     },
     handler: async (input) => ({
-      structuredContent: await searchStreets(parseInput6(input), dependencies)
+      structuredContent: await searchStreets(readQueryLimitInput3(input, "search_streets"), dependencies)
     })
   });
 }
@@ -1749,14 +1702,6 @@ var outputSchema2 = {
   },
   required: ["stateDate", "streets"]
 };
-function parseInput6(input) {
-  const query = readRequiredStringField6(input, "query", "search_streets");
-  const limit = readOptionalNumberField3(input, "limit", "search_streets");
-  return {
-    limit,
-    query
-  };
-}
 
 // src/features/search-units/application/search-units.ts
 var DEFAULT_LIMIT4 = 20;
@@ -1831,7 +1776,7 @@ function normalizeName4(value) {
 }
 
 // src/features/search-units/mcp/search-units.tool.ts
-import { defineTool as defineTool9, readOptionalNumberField as readOptionalNumberField4, readRequiredStringField as readRequiredStringField7 } from "@mcp-craftman/core";
+import { defineTool as defineTool9, readQueryLimitInput as readQueryLimitInput4 } from "@mcp-craftman/core";
 function createSearchUnitsTool(dependencies) {
   return defineTool9({
     name: "search_units",
@@ -1907,18 +1852,10 @@ function createSearchUnitsTool(dependencies) {
       readOnlyHint: true
     },
     handler: async (input) => ({
-      structuredContent: await searchUnits(parseInput7(input), dependencies)
+      structuredContent: await searchUnits(readQueryLimitInput4(input, "search_units"), dependencies)
     })
   });
 }
-function parseInput7(input) {
-  const query = readRequiredStringField7(input, "query", "search_units");
-  const limit = readOptionalNumberField4(input, "limit", "search_units");
-  return {
-    limit,
-    query
-  };
-}
 
 // src/features/source-status/application/get-source-status.ts
 async function getSourceStatus(input) {
@@ -2346,20 +2283,21 @@ function createApp(config = loadRuntimeConfig(), overrides = {}) {
   const syncLockStore = new FileLockStore(config.dataDir);
   const syncManifestStore = new JsonSyncManifestStore(config.dataDir);
   const syncSource = overrides.syncSource ?? new EterytSource();
+  const terytRepository = new SqliteTerytRepository(config.dataDir);
   return createMcpApp({
     name: "teryt-mcp",
-    version: "0.1.0",
+    version: terytMcpVersion,
     registry: createRegistry({
       config,
       manifestStore,
       sourceCatalog,
-      addressRepository: new InMemoryAddressRepository(),
-      placeDetailsRepository: new InMemoryPlaceDetailsRepository(),
-      placeRepository: new InMemoryPlaceRepository(),
-      streetDetailsRepository: new InMemoryStreetDetailsRepository(),
-      streetRepository: new InMemoryStreetRepository(),
-      unitDetailsRepository: new InMemoryUnitDetailsRepository(),
-      unitRepository: new InMemoryUnitRepository(),
+      addressRepository: terytRepository,
+      placeDetailsRepository: terytRepository,
+      placeRepository: terytRepository,
+      streetDetailsRepository: terytRepository,
+      streetRepository: terytRepository,
+      unitDetailsRepository: terytRepository,
+      unitRepository: terytRepository,
       sync: {
         databaseBuilder: new SqliteDatabaseBuilder(),
         fileStore: syncFileStore,
@@ -2372,16 +2310,35 @@ function createApp(config = loadRuntimeConfig(), overrides = {}) {
   });
 }
 
-// src/server/serve.ts
-import { loadRuntimeConfig as loadRuntimeConfig2, serveMcpApp } from "@mcp-craftman/node";
-async function serve(config = loadRuntimeConfig2()) {
-  return serveMcpApp(createApp, {
-    config
-  });
+// src/runtime/config.ts
+import { homedir } from "os";
+import { resolve } from "path";
+import { loadRuntimeConfig as loadRuntimeConfig2 } from "@mcp-craftman/node";
+function loadTerytRuntimeConfig(env = process.env) {
+  const config = loadRuntimeConfig2(env);
+  return {
+    ...config,
+    dataDir: resolveTerytDataDir(env)
+  };
+}
+function resolveTerytDataDir(env) {
+  if (env.MCP_DATA_DIR) {
+    return resolve(env.MCP_DATA_DIR);
+  }
+  if (env.XDG_CACHE_HOME) {
+    return resolve(env.XDG_CACHE_HOME, "teryt-mcp");
+  }
+  if (process.platform === "darwin") {
+    return resolve(homedir(), "Library", "Caches", "teryt-mcp");
+  }
+  if (process.platform === "win32" && env.LOCALAPPDATA) {
+    return resolve(env.LOCALAPPDATA, "teryt-mcp");
+  }
+  return resolve(homedir(), ".cache", "teryt-mcp");
 }
 
 export {
   getServerStatus,
   createApp,
-  serve
+  loadTerytRuntimeConfig
 };

package/dist/chunk-R2QUAOGP.js

@@ -0,0 +1,16 @@
+import {
+  createApp,
+  loadTerytRuntimeConfig
+} from "./chunk-LDGYCOB4.js";
+
+// src/server/serve.ts
+import { serveMcpApp } from "@mcp-craftman/node";
+async function serve(config = loadTerytRuntimeConfig()) {
+  return serveMcpApp(createApp, {
+    config
+  });
+}
+
+export {
+  serve
+};

package/dist/cli.d.ts

@@ -1,23 +1,7 @@
 #!/usr/bin/env node
-import { RuntimeConfig, CliIo } from '@mcp-craftman/node';
-import * as _mcp_craftman_core from '@mcp-craftman/core';
-
-type DatasetCode = "TERC" | "SIMC" | "ULIC" | "WMRODZ";
-
-type SourceFile = {
-    readonly dataset: DatasetCode;
-    readonly content: Uint8Array;
-    readonly sourceUrl: string;
-    readonly stateDate: string;
-};
-type TerytSource = {
-    readonly download: (dataset: DatasetCode) => Promise<SourceFile>;
-};
-
-type CreateAppOverrides = {
-    readonly syncSource?: TerytSource;
-};
-declare function createApp(config?: RuntimeConfig, overrides?: CreateAppOverrides): _mcp_craftman_core.McpApp;
+import { CliIo } from '@mcp-craftman/node';
+import { c as createApp } from './app-DumxnZvs.js';
+import '@mcp-craftman/core';
 
 type TerytCliIo = CliIo & {
     readonly appFactory?: typeof createApp;

package/dist/cli.js

@@ -1,15 +1,17 @@
 #!/usr/bin/env node
+import {
+  serve
+} from "./chunk-R2QUAOGP.js";
 import {
   createApp,
   getServerStatus,
-  serve
-} from "./chunk-GSWKF6BK.js";
+  loadTerytRuntimeConfig
+} from "./chunk-LDGYCOB4.js";
 
 // src/cli.ts
 import {
   createDefaultCliIo,
   isCliEntrypoint,
-  loadRuntimeConfig,
   writeCliToolStructuredContent,
   writeJson
 } from "@mcp-craftman/node";
@@ -17,11 +19,11 @@ import { mcpCraftmanCoreVersion } from "@mcp-craftman/core";
 async function runCli(argv = process.argv.slice(2), io = defaultIo()) {
   const [command, ...args] = argv;
   if (command === "serve") {
-    await serve(loadRuntimeConfig(io.env));
+    await serve(loadTerytRuntimeConfig(io.env));
     return;
   }
   if (command === "status") {
-    const config = loadRuntimeConfig(io.env);
+    const config = loadTerytRuntimeConfig(io.env);
     writeJson(
       io.stdout,
       getServerStatus({
@@ -47,7 +49,10 @@ async function runCli(argv = process.argv.slice(2), io = defaultIo()) {
   throw new Error(`Unknown command: ${command ?? "<missing>"}`);
 }
 async function writeCliToolResult(stream, toolName, input, io) {
-  await writeCliToolStructuredContent(stream, io.appFactory ?? createApp, toolName, input, io.env);
+  await writeCliToolStructuredContent(stream, io.appFactory ?? createApp, toolName, input, {
+    ...io.env,
+    MCP_DATA_DIR: loadTerytRuntimeConfig(io.env).dataDir
+  });
 }
 function defaultIo() {
   return createDefaultCliIo();

package/dist/main.js

@@ -1,6 +1,7 @@
 import {
   serve
-} from "./chunk-GSWKF6BK.js";
+} from "./chunk-R2QUAOGP.js";
+import "./chunk-LDGYCOB4.js";
 
 // src/main.ts
 await serve();

package/dist/postinstall.d.ts

@@ -0,0 +1,15 @@
+import { c as createApp } from './app-DumxnZvs.js';
+import '@mcp-craftman/core';
+import '@mcp-craftman/node';
+
+type PostinstallIo = {
+    readonly env: NodeJS.ProcessEnv;
+    readonly stderr: NodeJS.WritableStream;
+};
+type PostinstallOptions = {
+    readonly appFactory?: typeof createApp;
+    readonly io?: PostinstallIo;
+};
+declare function runPostinstallSync(options?: PostinstallOptions): Promise<void>;
+
+export { runPostinstallSync };

package/dist/postinstall.js

@@ -0,0 +1,42 @@
+import {
+  createApp,
+  loadTerytRuntimeConfig
+} from "./chunk-LDGYCOB4.js";
+
+// src/postinstall.ts
+import { callTool } from "@mcp-craftman/core";
+import { isCliEntrypoint } from "@mcp-craftman/node";
+var skipValues = /* @__PURE__ */ new Set(["1", "true", "yes"]);
+async function runPostinstallSync(options = {}) {
+  const io = options.io ?? {
+    env: process.env,
+    stderr: process.stderr
+  };
+  if (skipValues.has((io.env.TERYT_MCP_SKIP_POSTINSTALL_SYNC ?? "").toLowerCase())) {
+    io.stderr.write("teryt-mcp postinstall: skipping initial sync.\n");
+    return;
+  }
+  const config = loadTerytRuntimeConfig(io.env);
+  const appFactory = options.appFactory ?? createApp;
+  const result = await callTool(appFactory(config), "sync_database", {
+    mode: "missing"
+  });
+  const status = readStatus(result.structuredContent);
+  io.stderr.write(`teryt-mcp postinstall: initial sync ${status} in ${config.dataDir}.
+`);
+}
+function readStatus(content) {
+  if (typeof content === "object" && content !== null && "status" in content && typeof content.status === "string") {
+    return content.status;
+  }
+  return "completed";
+}
+if (isCliEntrypoint("postinstall.js")) {
+  runPostinstallSync().catch((error) => {
+    process.stderr.write(`teryt-mcp postinstall: initial sync failed: ${error instanceof Error ? error.message : String(error)}
+`);
+  });
+}
+export {
+  runPostinstallSync
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teryt-mcp",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "private": false,
   "description": "MCP server for the official Polish TERYT registry.",
   "type": "module",
@@ -15,7 +15,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@mcp-craftman/core": "^0.1.2",
+    "@mcp-craftman/core": "^0.1.3",
     "@mcp-craftman/node": "^0.1.2",
     "fflate": "^0.8.3",
     "sql.js": "^1.14.1"
@@ -38,7 +38,8 @@
     "node": ">=20.19.0"
   },
   "scripts": {
-    "build": "tsup src/main.ts src/cli.ts --format esm --dts --clean",
+    "build": "tsup src/main.ts src/cli.ts src/postinstall.ts --format esm --dts --clean",
+    "postinstall": "node dist/postinstall.js",
     "quality": "mcp-craftman quality",
     "test": "vitest run"
   }