asynthetic 0.1.0-beta

package/dist/store/supabase-store.js

@@ -0,0 +1,61 @@
+/**
+ * Supabase (Postgres) store. Reads the three tables defined in schema/schema.sql
+ * and reassembles rows into the same MigrationMap shape the local store serves.
+ */
+import { createClient } from '@supabase/supabase-js';
+import { toSummary } from './store.js';
+function rowToMap(row) {
+    return {
+        ecosystem: row.ecosystem,
+        package: row.package,
+        from_version: row.from_version,
+        to_version: row.to_version,
+        summary: row.summary,
+        breaking_changes: [...row.breaking_changes]
+            .sort((a, b) => a.position - b.position)
+            .map(({ position: _position, affected_symbols, ...bc }) => ({
+            ...bc,
+            affected_symbols: affected_symbols ?? [],
+        })),
+        deprecations: row.deprecations,
+        source_urls: row.source_urls,
+        last_verified: row.last_verified,
+        status: row.status,
+    };
+}
+const SELECT = '*, breaking_changes(*), deprecations(*)';
+export class SupabaseStore {
+    url;
+    client;
+    constructor(url, key) {
+        this.url = url;
+        this.client = createClient(url, key, { auth: { persistSession: false } });
+    }
+    async getMapsForPackage(ecosystem, pkg) {
+        const { data, error } = await this.client
+            .from('migrations')
+            .select(SELECT)
+            .eq('ecosystem', ecosystem)
+            .ilike('package', pkg.trim()) // no wildcards -> case-insensitive equality
+            .neq('status', 'stale');
+        if (error)
+            throw new Error(`Supabase query failed: ${error.message}`);
+        return (data ?? []).map(rowToMap);
+    }
+    async listMaps() {
+        const { data, error } = await this.client
+            .from('migrations')
+            .select('ecosystem, package, from_version, to_version, status, last_verified')
+            .neq('status', 'stale')
+            .order('package');
+        if (error)
+            throw new Error(`Supabase query failed: ${error.message}`);
+        return (data ?? []);
+    }
+    describe() {
+        return `Supabase (${this.url})`;
+    }
+}
+// Re-exported here so map assembly stays reusable by scripts/seed.ts.
+export { toSummary };
+//# sourceMappingURL=supabase-store.js.map

package/dist/store/supabase-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase-store.js","sourceRoot":"","sources":["../../src/store/supabase-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAuB,MAAM,uBAAuB,CAAC;AAE1E,OAAO,EAAE,SAAS,EAAwC,MAAM,YAAY,CAAC;AAkC7E,SAAS,QAAQ,CAAC,GAAiB;IACjC,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,gBAAgB,EAAE,CAAC,GAAG,GAAG,CAAC,gBAAgB,CAAC;aACxC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;aACvC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YAC1D,GAAG,EAAE;YACL,gBAAgB,EAAE,gBAAgB,IAAI,EAAE;SACzC,CAAC,CAAC;QACL,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,MAAM,EAAE,GAAG,CAAC,MAAM;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,MAAM,GAAG,yCAAyC,CAAC;AAEzD,MAAM,OAAO,aAAa;IAIL;IAHF,MAAM,CAAiB;IAExC,YACmB,GAAW,EAC5B,GAAW;QADM,QAAG,GAAH,GAAG,CAAQ;QAG5B,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,SAAiB,EAAE,GAAW;QACpD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM;aACtC,IAAI,CAAC,YAAY,CAAC;aAClB,MAAM,CAAC,MAAM,CAAC;aACd,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;aAC1B,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,4CAA4C;aACzE,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC1B,IAAI,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,OAAQ,CAAC,IAAI,IAAI,EAAE,CAA+B,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM;aACtC,IAAI,CAAC,YAAY,CAAC;aAClB,MAAM,CAAC,qEAAqE,CAAC;aAC7E,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC;aACtB,KAAK,CAAC,SAAS,CAAC,CAAC;QACpB,IAAI,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,OAAO,CAAC,IAAI,IAAI,EAAE,CAAiB,CAAC;IACtC,CAAC;IAED,QAAQ;QACN,OAAO,aAAa,IAAI,CAAC,GAAG,GAAG,CAAC;IAClC,CAAC;CACF;AAED,sEAAsE;AACtE,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/types/migration-map.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Asynthetic — migration-map types.
+ *
+ * These mirror schema/schema.sql exactly. The Zod schema at the bottom validates
+ * map JSON files (data/maps/**) before they are inserted into Postgres, so a
+ * malformed hand-curated map fails at ingestion, not at serve time.
+ */
+import * as z from 'zod/v4';
+export type Ecosystem = 'npm';
+export type ChangeCategory = 'signature-change' | 'removal' | 'deprecation' | 'behavior-change' | 'config-change' | 'import-change' | 'rename';
+export type MigrationStatus = 'draft' | 'verified' | 'stale';
+export interface BreakingChange {
+    title: string;
+    description: string;
+    category: ChangeCategory;
+    /** Functions/exports/config keys affected. Empty when the change is package-wide. */
+    affected_symbols: string[];
+    before_code: string | null;
+    after_code: string | null;
+    /** Plain-language "how to fix". */
+    migration_note: string;
+    /** Per-change citation; falls back to MigrationMap.source_urls when null. */
+    source_url: string | null;
+}
+export interface Deprecation {
+    symbol: string;
+    replacement: string | null;
+    removal_timeline: string | null;
+    note: string | null;
+}
+export interface MigrationMap {
+    ecosystem: Ecosystem;
+    package: string;
+    /** Concrete semver the map was verified from (e.g. "1.29.0"). */
+    from_version: string;
+    /** Concrete semver the map was verified to (e.g. "2.0.0-beta.2"). */
+    to_version: string;
+    summary: string;
+    breaking_changes: BreakingChange[];
+    deprecations: Deprecation[];
+    source_urls: string[];
+    /** ISO date (YYYY-MM-DD) the sources were last checked against this map. */
+    last_verified: string;
+    status: MigrationStatus;
+}
+export declare const BreakingChangeSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodString;
+    category: z.ZodEnum<{
+        "signature-change": "signature-change";
+        removal: "removal";
+        deprecation: "deprecation";
+        "behavior-change": "behavior-change";
+        "config-change": "config-change";
+        "import-change": "import-change";
+        rename: "rename";
+    }>;
+    affected_symbols: z.ZodArray<z.ZodString>;
+    before_code: z.ZodNullable<z.ZodString>;
+    after_code: z.ZodNullable<z.ZodString>;
+    migration_note: z.ZodString;
+    source_url: z.ZodNullable<z.ZodURL>;
+}, z.core.$strip>;
+export declare const DeprecationSchema: z.ZodObject<{
+    symbol: z.ZodString;
+    replacement: z.ZodNullable<z.ZodString>;
+    removal_timeline: z.ZodNullable<z.ZodString>;
+    note: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const MigrationMapSchema: z.ZodObject<{
+    ecosystem: z.ZodLiteral<"npm">;
+    package: z.ZodString;
+    from_version: z.ZodString;
+    to_version: z.ZodString;
+    summary: z.ZodString;
+    breaking_changes: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        description: z.ZodString;
+        category: z.ZodEnum<{
+            "signature-change": "signature-change";
+            removal: "removal";
+            deprecation: "deprecation";
+            "behavior-change": "behavior-change";
+            "config-change": "config-change";
+            "import-change": "import-change";
+            rename: "rename";
+        }>;
+        affected_symbols: z.ZodArray<z.ZodString>;
+        before_code: z.ZodNullable<z.ZodString>;
+        after_code: z.ZodNullable<z.ZodString>;
+        migration_note: z.ZodString;
+        source_url: z.ZodNullable<z.ZodURL>;
+    }, z.core.$strip>>;
+    deprecations: z.ZodArray<z.ZodObject<{
+        symbol: z.ZodString;
+        replacement: z.ZodNullable<z.ZodString>;
+        removal_timeline: z.ZodNullable<z.ZodString>;
+        note: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    source_urls: z.ZodArray<z.ZodURL>;
+    last_verified: z.ZodISODate;
+    status: z.ZodEnum<{
+        draft: "draft";
+        verified: "verified";
+        stale: "stale";
+    }>;
+}, z.core.$strip>;

package/dist/types/migration-map.js

@@ -0,0 +1,48 @@
+/**
+ * Asynthetic — migration-map types.
+ *
+ * These mirror schema/schema.sql exactly. The Zod schema at the bottom validates
+ * map JSON files (data/maps/**) before they are inserted into Postgres, so a
+ * malformed hand-curated map fails at ingestion, not at serve time.
+ */
+// zod/v4 subpath: the v1 MCP SDK pairs with the Zod v3 API (used for tool inputs
+// in src/index.ts), while this ingestion validator uses the v4 API. zod@^3.25
+// ships both, so one installed package serves both consumers.
+import * as z from 'zod/v4';
+export const BreakingChangeSchema = z.object({
+    title: z.string().min(1),
+    description: z.string().min(1),
+    category: z.enum([
+        'signature-change',
+        'removal',
+        'deprecation',
+        'behavior-change',
+        'config-change',
+        'import-change',
+        'rename',
+    ]),
+    affected_symbols: z.array(z.string().min(1)),
+    before_code: z.string().min(1).nullable(),
+    after_code: z.string().min(1).nullable(),
+    migration_note: z.string().min(1),
+    source_url: z.url().nullable(),
+});
+export const DeprecationSchema = z.object({
+    symbol: z.string().min(1),
+    replacement: z.string().min(1).nullable(),
+    removal_timeline: z.string().min(1).nullable(),
+    note: z.string().min(1).nullable(),
+});
+export const MigrationMapSchema = z.object({
+    ecosystem: z.literal('npm'),
+    package: z.string().min(1),
+    from_version: z.string().min(1),
+    to_version: z.string().min(1),
+    summary: z.string().min(1),
+    breaking_changes: z.array(BreakingChangeSchema).min(1),
+    deprecations: z.array(DeprecationSchema),
+    source_urls: z.array(z.url()).min(1),
+    last_verified: z.iso.date(),
+    status: z.enum(['draft', 'verified', 'stale']),
+});
+//# sourceMappingURL=migration-map.js.map

package/dist/types/migration-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-map.js","sourceRoot":"","sources":["../../src/types/migration-map.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,iFAAiF;AACjF,8EAA8E;AAC9E,8DAA8D;AAC9D,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAoD5B,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;QACf,kBAAkB;QAClB,SAAS;QACT,aAAa;QACb,iBAAiB;QACjB,eAAe;QACf,eAAe;QACf,QAAQ;KACT,CAAC;IACF,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,UAAU,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,aAAa,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;CAC/C,CAAmC,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "asynthetic",
+  "version": "0.1.0-beta",
+  "description": "Asynthetic — MCP server that gives AI coding agents verified migration maps for fast-moving libraries: exactly what breaks between two versions and how to fix it.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "mcp-server",
+    "migration",
+    "breaking-changes",
+    "upgrade",
+    "semver",
+    "ai-agents"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/asyntheticai/asynthetic.git"
+  },
+  "homepage": "https://github.com/asyntheticai/asynthetic#readme",
+  "bugs": {
+    "url": "https://github.com/asyntheticai/asynthetic/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "bin": {
+    "asynthetic": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "data/maps"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "seed": "tsx scripts/seed.ts",
+    "smoke": "npm run build && tsx scripts/smoke.ts",
+    "inspect": "npm run build && npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@supabase/supabase-js": "^2.49.0",
+    "express": "^5.2.1",
+    "semver": "^7.8.5",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^22.10.0",
+    "@types/semver": "^7.7.1",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  }
+}