@withpica/mcp-server 1.3.0

package/dist/resources/index.js

@@ -0,0 +1,510 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { ResourceError } from "@withpica/mcp-utils";
+import { readFileSync } from "fs";
+import { join } from "path";
+import { WITHPICA_PRIMER } from "./llms-primer.js";
+import { WELCOME_MARKDOWN } from "./welcome.js";
+import { AGENT_GUIDE_AUTHENTICATED, AGENT_GUIDE_LOBBY } from "./agent-guide.js";
+import { REQUIRED_SCHEMAS } from "./required-schemas.generated.js";
+import { UPLOAD_HTML } from "../apps/upload.js";
+import { DOWNLOAD_HTML } from "../apps/download.js";
+import { RELEASE_HTML } from "../apps/release.js";
+import { PICA_STORAGE_CONNECT_DOMAINS } from "../apps/shared.js";
+export class ResourceRegistry {
+    pica;
+    config;
+    constructor(pica, config) {
+        this.pica = pica;
+        this.config = config;
+    }
+    /**
+     * List all available resources
+     */
+    listResources() {
+        const resources = [
+            {
+                uri: "pica://welcome",
+                name: "Welcome to PICA",
+                description: "Getting started guide — how to sign in and what you can do",
+                mimeType: "text/markdown",
+            },
+            {
+                uri: "pica://docs/agent-guide",
+                name: "Agent Guide — How to Use PICA",
+                description: "Workflow-by-workflow guide for agents — what tools to call in what order, common gotchas, pointers to schema resources. Lobby mode returns a sign-in-focused variant; authenticated mode returns the full workflow map.",
+                mimeType: "text/markdown",
+            },
+        ];
+        if (this.config?.lobbyMode || !this.pica) {
+            return resources;
+        }
+        resources.push({
+            uri: "llms://primer",
+            name: "PICA Domain Primer",
+            description: "Plain-language description of PICA's domain model, entity relationships, and recommended agent workflows. Read this first.",
+            mimeType: "text/markdown",
+        }, {
+            uri: "works://list",
+            name: "All Works",
+            description: "Complete list of musical works in the catalog",
+            mimeType: "application/json",
+        }, {
+            uri: "people://list",
+            name: "All People",
+            description: "Complete list of people (artists, composers, etc.)",
+            mimeType: "application/json",
+        }, {
+            uri: "recordings://list",
+            name: "All Recordings",
+            description: "Complete list of recordings",
+            mimeType: "application/json",
+        }, {
+            uri: "catalog://stats",
+            name: "Catalog Statistics",
+            description: "Statistics and metrics about the catalog",
+            mimeType: "application/json",
+        }, {
+            uri: "catalog://health",
+            name: "Catalog Health (PICA Score)",
+            description: "PICA Score — composite legibility index (0-100) with grade, 4-pillar breakdown, and actionable suggestions",
+            mimeType: "application/json",
+        }, {
+            uri: "workspace://context",
+            name: "Workspace Context",
+            description: "Aggregated workspace orientation — org info, catalog stats, health score, and top priorities in one call",
+            mimeType: "application/json",
+        }, {
+            uri: "events://recent",
+            name: "Recent Events",
+            description: "Recent webhook delivery events — what happened in this workspace recently",
+            mimeType: "application/json",
+        }, {
+            uri: "api://openapi",
+            name: "OpenAPI Specification",
+            description: "OpenAPI 3.1 spec for the top 20 PICA API endpoints — works, people, recordings, agreements, credits, search, health",
+            mimeType: "text/yaml",
+        }, {
+            uri: "ui://pica/upload",
+            name: "Upload Files",
+            description: "Generic file upload card — drop zone for audio, photos, documents, anything",
+            mimeType: "text/html;profile=mcp-app",
+        }, {
+            uri: "ui://pica/download",
+            name: "Download File",
+            description: "File download card — shows file metadata and a download button",
+            mimeType: "text/html;profile=mcp-app",
+        }, {
+            uri: "ui://pica/release",
+            name: "Release Card",
+            description: "Release rich-render card — cover art + markdown summary (ADR-208 Phase 3 Primitive D, Phase 3 stub)",
+            mimeType: "text/html;profile=mcp-app",
+        }, {
+            uri: "pica://schemas/work-required",
+            name: "Required Fields — Register a Work",
+            description: "Required + recommended fields, CHECK enums, and companion-call orchestration for pica_works_create. Read before calling the work-create workflow.",
+            mimeType: "application/json",
+        }, {
+            uri: "pica://schemas/recording-required",
+            name: "Required Fields — Register a Recording",
+            description: "Required + recommended fields, CHECK enums, and companion-call orchestration for pica_recordings_create.",
+            mimeType: "application/json",
+        }, {
+            uri: "pica://schemas/work-credits-required",
+            name: "Required Fields — Attach Work Credits",
+            description: "Per-row required fields and CHECK enums for pica_credits_update (writer/composer/publisher splits, sum to 100).",
+            mimeType: "application/json",
+        }, {
+            uri: "pica://schemas/recording-credits-required",
+            name: "Required Fields — Attach Recording Credits",
+            description: "Per-row required fields and the role enum for pica_recording_credits_update (MainArtist / FeaturedArtist / Producer / Engineer / etc.).",
+            mimeType: "application/json",
+        }, {
+            uri: "pica://schemas/person-required",
+            name: "Required Fields — Register a Person",
+            description: "Required + recommended fields for pica_people_create (writers, performers, publishers; identifiers settable inline).",
+            mimeType: "application/json",
+        }, {
+            uri: "pica://schemas/audio-upload-required",
+            name: "Required Fields — Upload Audio (3-Step Chain)",
+            description: "Required fields per step of the audio-upload chain (pica_audio_presigned_upload → pica_audio_complete_upload → pica_audio_analyze + poll), plus audio_files file_type / classification CHECK enums.",
+            mimeType: "application/json",
+        }, {
+            uri: "pica://schemas/enrichment-resolve-required",
+            name: "Required Fields — Run Enrichment",
+            description: "Required fields for pica_resolve_work / _person / _recording and the proposals review chain (list → apply / reject). Includes enrichment_proposals entity_type / status / proposal_action enums.",
+            mimeType: "application/json",
+        }, {
+            uri: "pica://schemas/agreement-required",
+            name: "Required Fields — Create an Agreement",
+            description: "Required + recommended fields for pica_agreements_create plus link-work and template-render companions. Includes agreements agreement_type / status / other_party_type CHECK enums.",
+            mimeType: "application/json",
+        }, {
+            uri: "pica://schemas/multimedia-required",
+            name: "Required Fields — Add Multimedia",
+            description: "Required fields for pica_multimedia_create and the import / YouTube / link-work companions. Includes multimedia_items content_type / classification CHECK enums.",
+            mimeType: "application/json",
+        }, {
+            uri: "pica://schemas/export-required",
+            name: "Required Fields — Export the Catalog",
+            description: "Five export destinations (CSV, song-registration, industry-ready, CAR, AI-consent) with destination guidance.",
+            mimeType: "application/json",
+        }, {
+            uri: "pica://schemas/claim-required",
+            name: "Required Fields — Claim a Discovery",
+            description: "Required fields for pica_discoveries_query and the typed claim verbs (credit / custody / artist), plus the generic discoveries_review surface. Includes discovered_credits / _custody / _artists status + match_basis + custody_type CHECK enums.",
+            mimeType: "application/json",
+        }, {
+            uri: "pica://schemas/session-required",
+            name: "Required Fields — Log a Studio Session",
+            description: "Required + recommended fields for pica_sessions_create plus the pica_sessions_types lookup companion. Status values are documented but not DB-CHECK-enforced.",
+            mimeType: "application/json",
+        }, {
+            uri: "pica://schemas/split-sheet-required",
+            name: "Required Fields — Generate a Split Sheet (Publishing)",
+            description: "Required fields for pica_split_sheet_generate. Pre-condition: writer credits on the work must total 100%. Companion calls cover send / get / list.",
+            mimeType: "application/json",
+        }, {
+            uri: "pica://schemas/recording-splits-required",
+            name: "Required Fields — Assign Master Ownership Splits",
+            description: "Required + recommended fields for pica_recording_splits_create. Includes recording_splits split_type + role CHECK enums. Distinct from publishing splits on works.",
+            mimeType: "application/json",
+        });
+        return resources;
+    }
+    /**
+     * Read a resource by URI
+     */
+    async readResource(uri) {
+        switch (uri) {
+            case "pica://welcome":
+                return {
+                    contents: [
+                        {
+                            uri: "pica://welcome",
+                            mimeType: "text/markdown",
+                            text: WELCOME_MARKDOWN,
+                        },
+                    ],
+                };
+            case "pica://docs/agent-guide": {
+                const lobby = this.config?.lobbyMode || !this.pica;
+                return {
+                    contents: [
+                        {
+                            uri: "pica://docs/agent-guide",
+                            mimeType: "text/markdown",
+                            text: lobby ? AGENT_GUIDE_LOBBY : AGENT_GUIDE_AUTHENTICATED,
+                        },
+                    ],
+                };
+            }
+            default:
+                break;
+        }
+        if (!this.pica) {
+            throw new ResourceError(`Resource not available in lobby mode: ${uri}`);
+        }
+        switch (uri) {
+            case "llms://primer":
+                return {
+                    contents: [
+                        {
+                            uri: "llms://primer",
+                            mimeType: "text/markdown",
+                            text: WITHPICA_PRIMER,
+                        },
+                    ],
+                };
+            case "works://list":
+                return await this.getWorksList();
+            case "people://list":
+                return await this.getPeopleList();
+            case "recordings://list":
+                return await this.getRecordingsList();
+            case "catalog://stats":
+                return await this.getCatalogStats();
+            case "catalog://health":
+                return await this.getCatalogHealth();
+            case "workspace://context":
+                return await this.getWorkspaceContext();
+            case "events://recent":
+                return await this.getRecentEvents();
+            case "api://openapi":
+                return this.getOpenAPISpec();
+            case "ui://pica/upload":
+                return {
+                    contents: [
+                        {
+                            uri: "ui://pica/upload",
+                            mimeType: "text/html;profile=mcp-app",
+                            text: UPLOAD_HTML,
+                            _meta: {
+                                ui: {
+                                    csp: {
+                                        connectDomains: PICA_STORAGE_CONNECT_DOMAINS,
+                                    },
+                                },
+                            },
+                        },
+                    ],
+                };
+            case "ui://pica/download":
+                return {
+                    contents: [
+                        {
+                            uri: "ui://pica/download",
+                            mimeType: "text/html;profile=mcp-app",
+                            text: DOWNLOAD_HTML,
+                            _meta: {
+                                ui: {
+                                    csp: {
+                                        connectDomains: PICA_STORAGE_CONNECT_DOMAINS,
+                                    },
+                                },
+                            },
+                        },
+                    ],
+                };
+            case "ui://pica/release":
+                return {
+                    contents: [
+                        {
+                            uri: "ui://pica/release",
+                            mimeType: "text/html;profile=mcp-app",
+                            text: RELEASE_HTML,
+                        },
+                    ],
+                };
+            case "pica://schemas/work-required":
+            case "pica://schemas/recording-required":
+            case "pica://schemas/work-credits-required":
+            case "pica://schemas/recording-credits-required":
+            case "pica://schemas/person-required":
+            case "pica://schemas/audio-upload-required":
+            case "pica://schemas/enrichment-resolve-required":
+            case "pica://schemas/agreement-required":
+            case "pica://schemas/multimedia-required":
+            case "pica://schemas/export-required":
+            case "pica://schemas/claim-required":
+            case "pica://schemas/session-required":
+            case "pica://schemas/split-sheet-required":
+            case "pica://schemas/recording-splits-required": {
+                const key = uri.replace("pica://schemas/", "");
+                const body = REQUIRED_SCHEMAS[key];
+                if (!body)
+                    throw new ResourceError(`Schema not found: ${uri}`);
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: "application/json",
+                            text: JSON.stringify(body, null, 2),
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new ResourceError(`Resource not found: ${uri}`);
+        }
+    }
+    /**
+     * Get OpenAPI specification resource
+     */
+    getOpenAPISpec() {
+        // Try multiple paths to find the spec file
+        const possiblePaths = [
+            join(process.cwd(), "docs/api/openapi.yaml"),
+            join(process.cwd(), "../docs/api/openapi.yaml"),
+        ];
+        for (const specPath of possiblePaths) {
+            try {
+                const yamlContent = readFileSync(specPath, "utf-8");
+                return {
+                    contents: [
+                        {
+                            uri: "api://openapi",
+                            mimeType: "text/yaml",
+                            text: yamlContent,
+                        },
+                    ],
+                };
+            }
+            catch {
+                // Try next path
+            }
+        }
+        throw new ResourceError("OpenAPI spec not found. Expected at docs/api/openapi.yaml");
+    }
+    /**
+     * Get works list resource
+     */
+    async getWorksList() {
+        const works = await this.pica.works.list({ limit: 1000 });
+        return {
+            contents: [
+                {
+                    uri: "works://list",
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        total: works.length,
+                        works: works.map((work) => ({
+                            id: work.id,
+                            title: work.title,
+                            work_type: work.work_type,
+                            iswc: work.iswc,
+                            is_verified: work.is_verified,
+                            duration_seconds: work.duration_seconds,
+                        })),
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * Get people list resource
+     */
+    async getPeopleList() {
+        const people = await this.pica.people.list({ limit: 1000 });
+        return {
+            contents: [
+                {
+                    uri: "people://list",
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        total: people.length,
+                        people: people.map((person) => ({
+                            id: person.id,
+                            first_name: person.first_name,
+                            last_name: person.last_name,
+                            email: person.email,
+                            isni: person.isni,
+                            musicbrainz_id: person.musicbrainz_id,
+                        })),
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * Get recordings list resource
+     */
+    async getRecordingsList() {
+        const recordings = await this.pica.recordings.list({ limit: 1000 });
+        return {
+            contents: [
+                {
+                    uri: "recordings://list",
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        total: recordings.length,
+                        recordings: recordings.map((recording) => ({
+                            id: recording.id,
+                            title: recording.title,
+                            isrc: recording.isrc,
+                            duration_seconds: recording.duration_seconds,
+                            work_id: recording.work_id,
+                        })),
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * Get catalog statistics resource
+     */
+    async getCatalogStats() {
+        const [works, people, recordings] = await Promise.all([
+            this.pica.works.list({ limit: 1000 }),
+            this.pica.people.list({ limit: 1000 }),
+            this.pica.recordings.list({ limit: 1000 }),
+        ]);
+        const stats = {
+            overview: {
+                total_works: works.length,
+                total_people: people.length,
+                total_recordings: recordings.length,
+                last_updated: new Date().toISOString(),
+            },
+            works: {
+                total: works.length,
+                verified: works.filter((w) => w.is_verified).length,
+                unverified: works.filter((w) => !w.is_verified).length,
+                with_iswc: works.filter((w) => w.iswc).length,
+                by_type: {
+                    composition: works.filter((w) => w.work_type === "composition")
+                        .length,
+                    arrangement: works.filter((w) => w.work_type === "arrangement")
+                        .length,
+                    adaptation: works.filter((w) => w.work_type === "adaptation").length,
+                    translation: works.filter((w) => w.work_type === "translation")
+                        .length,
+                },
+            },
+            people: {
+                total: people.length,
+                with_email: people.filter((p) => p.email).length,
+                with_isni: people.filter((p) => p.isni).length,
+                with_musicbrainz: people.filter((p) => p.musicbrainz_id).length,
+            },
+            recordings: {
+                total: recordings.length,
+                with_isrc: recordings.filter((r) => r.isrc).length,
+            },
+        };
+        return {
+            contents: [
+                {
+                    uri: "catalog://stats",
+                    mimeType: "application/json",
+                    text: JSON.stringify(stats, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * Get catalog health (PICA Score) resource
+     */
+    async getCatalogHealth() {
+        const score = await this.pica.picaScore.get();
+        return {
+            contents: [
+                {
+                    uri: "catalog://health",
+                    mimeType: "application/json",
+                    text: JSON.stringify(score, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * Get workspace context resource — aggregated orientation for agents
+     */
+    async getWorkspaceContext() {
+        const context = await this.pica.workspace.getContext();
+        return {
+            contents: [
+                {
+                    uri: "workspace://context",
+                    mimeType: "application/json",
+                    text: JSON.stringify(context, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * Get recent events resource — webhook deliveries
+     */
+    async getRecentEvents() {
+        const events = await this.pica.workspace.getRecentEvents(20);
+        return {
+            contents: [
+                {
+                    uri: "events://recent",
+                    mimeType: "application/json",
+                    text: JSON.stringify(events, null, 2),
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"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"}

package/dist/resources/llms-primer.d.ts

@@ -0,0 +1,2 @@
+export declare const WITHPICA_PRIMER = "# PICA \u2014 Music Catalog Management Platform\n\nPICA helps music creators and publishers manage their catalog metadata,\ntrack royalties, and prepare works for registration with collection societies.\n\n## Core Entities\n\n### Work\nA musical composition (song, piece, library track). The central entity.\n- Has: title, ISWC, work_type (song/library/demo), genre, mood, BPM, key\n- Relationships: has many credits (writers/composers), has many recordings,\n  has many agreements, may have audio files, may have multimedia\n- Identifiers: ISWC (global), Tunecode (PRS), CAE/IPI (writer)\n\n### Person\nA human involved in music \u2014 writer, composer, performer, producer, publisher.\n- Has: name, email, IPI number, ISNI, MusicBrainz ID, PRO affiliation\n- Relationships: credited on many works, may have recordings, may have agreements\n- Can be enriched via: ISNI, MusicBrainz, Wikidata\n\n### Recording\nA specific audio capture of a work \u2014 the master/sound recording side.\n- Has: title, ISRC, duration, artist, label\n- Relationships: belongs to one work, has credits (performers/producers)\n- Distinct from the work: a work is the composition, a recording is the performance\n\n### Agreement\nA contract governing rights to works \u2014 publishing, sync, distribution.\n- Has: title, type, parties, dates, territory, terms\n- Relationships: covers many works\n- Types: publishing_admin, co_publishing, master_recording, sub_publishing,\n  admin_only, distribution, library_music, production, artist_contract,\n  termination, report, other\n\n### Import Document\nA canonical representation of an ingested file (royalty statement, CSV import).\n- Has: source (16 formats \u2014 PROs: PRS, ASCAP, BMI, SESAC, SOCAN, APRA, GEMA, SACEM; NROs: PPL, SoundExchange, GVL; Mechanical: MCPS; Distributors: DistroKid, TuneCore, CD Baby; Revenue: YouTube Content ID), period, line items, field mappings, warnings\n- Immutable snapshot of the import event \u2014 not a live view\n- Use pica_import_documents_list to find them, pica_import_documents_get to read\n\n## First Connection\n\nIf you're connecting to this workspace for the first time or don't know where to start,\ninvoke the **workspace-autopilot** prompt. It reads the workspace state and routes you\nto the most valuable workflow automatically.\n\n## Recommended Workflows\n\n1. **Catalog audit**: pica_catalog_stats \u2192 pica_works_query({ health_filter: \"needs_attention\" }) \u2192 pica_works_inspect({ sections: [\"completeness\"] })\n2. **Enrichment**: pica_enrichment_candidates \u2192 pica_resolve_work (fans out across Spotify/MLC/MusicBrainz/etc.) \u2192 pica_works_inspect (verify)\n3. **Statement reconciliation**: pica_import_documents_query \u2192 pica_import_documents_inspect({ sections: [\"diff\"] })\n4. **Duplicate cleanup**: pica_find_duplicates \u2192 review \u2192 pica_merge_duplicates\n5. **Registration readiness**: pica_works_inspect({ sections: [\"registration\"] }) \u2192 fix gaps \u2192 pica_export_song_registration\n\n## Key Concepts\n\n- **Organisation**: Multi-tenant \u2014 all data scoped to one org. Never cross org boundaries.\n- **PICA Score**: Composite catalog legibility index (0-100, grade A-F). Four pillars:\n  identification, documentation, registration, completeness.\n- **Enrichment cascade**: When an identifier is added, external sources\n  (MusicBrainz, ISNI, MLC) are queried automatically to fill gaps.\n- **Credits**: Work credits (writers/composers with splits) are distinct from\n  recording credits (performers/producers). Different tables, different role enums.\n  Work credit roles: writer, composer, arranger, lyricist, producer, performer.\n  Recording credit roles: Writer, Composer, Producer, Performer (PascalCase).\n";
+//# sourceMappingURL=llms-primer.d.ts.map

package/dist/resources/llms-primer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-primer.d.ts","sourceRoot":"","sources":["../../src/resources/llms-primer.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,0qHAiE3B,CAAC"}

package/dist/resources/llms-primer.js

@@ -0,0 +1,68 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+export const WITHPICA_PRIMER = `# PICA — Music Catalog Management Platform
+
+PICA helps music creators and publishers manage their catalog metadata,
+track royalties, and prepare works for registration with collection societies.
+
+## Core Entities
+
+### Work
+A musical composition (song, piece, library track). The central entity.
+- Has: title, ISWC, work_type (song/library/demo), genre, mood, BPM, key
+- Relationships: has many credits (writers/composers), has many recordings,
+  has many agreements, may have audio files, may have multimedia
+- Identifiers: ISWC (global), Tunecode (PRS), CAE/IPI (writer)
+
+### Person
+A human involved in music — writer, composer, performer, producer, publisher.
+- Has: name, email, IPI number, ISNI, MusicBrainz ID, PRO affiliation
+- Relationships: credited on many works, may have recordings, may have agreements
+- Can be enriched via: ISNI, MusicBrainz, Wikidata
+
+### Recording
+A specific audio capture of a work — the master/sound recording side.
+- Has: title, ISRC, duration, artist, label
+- Relationships: belongs to one work, has credits (performers/producers)
+- Distinct from the work: a work is the composition, a recording is the performance
+
+### Agreement
+A contract governing rights to works — publishing, sync, distribution.
+- Has: title, type, parties, dates, territory, terms
+- Relationships: covers many works
+- Types: publishing_admin, co_publishing, master_recording, sub_publishing,
+  admin_only, distribution, library_music, production, artist_contract,
+  termination, report, other
+
+### Import Document
+A canonical representation of an ingested file (royalty statement, CSV import).
+- Has: source (16 formats — PROs: PRS, ASCAP, BMI, SESAC, SOCAN, APRA, GEMA, SACEM; NROs: PPL, SoundExchange, GVL; Mechanical: MCPS; Distributors: DistroKid, TuneCore, CD Baby; Revenue: YouTube Content ID), period, line items, field mappings, warnings
+- Immutable snapshot of the import event — not a live view
+- Use pica_import_documents_list to find them, pica_import_documents_get to read
+
+## First Connection
+
+If you're connecting to this workspace for the first time or don't know where to start,
+invoke the **workspace-autopilot** prompt. It reads the workspace state and routes you
+to the most valuable workflow automatically.
+
+## Recommended Workflows
+
+1. **Catalog audit**: pica_catalog_stats → pica_works_query({ health_filter: "needs_attention" }) → pica_works_inspect({ sections: ["completeness"] })
+2. **Enrichment**: pica_enrichment_candidates → pica_resolve_work (fans out across Spotify/MLC/MusicBrainz/etc.) → pica_works_inspect (verify)
+3. **Statement reconciliation**: pica_import_documents_query → pica_import_documents_inspect({ sections: ["diff"] })
+4. **Duplicate cleanup**: pica_find_duplicates → review → pica_merge_duplicates
+5. **Registration readiness**: pica_works_inspect({ sections: ["registration"] }) → fix gaps → pica_export_song_registration
+
+## Key Concepts
+
+- **Organisation**: Multi-tenant — all data scoped to one org. Never cross org boundaries.
+- **PICA Score**: Composite catalog legibility index (0-100, grade A-F). Four pillars:
+  identification, documentation, registration, completeness.
+- **Enrichment cascade**: When an identifier is added, external sources
+  (MusicBrainz, ISNI, MLC) are queried automatically to fill gaps.
+- **Credits**: Work credits (writers/composers with splits) are distinct from
+  recording credits (performers/producers). Different tables, different role enums.
+  Work credit roles: writer, composer, arranger, lyricist, producer, performer.
+  Recording credit roles: Writer, Composer, Producer, Performer (PascalCase).
+`;
+//# sourceMappingURL=llms-primer.js.map

package/dist/resources/llms-primer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-primer.js","sourceRoot":"","sources":["../../src/resources/llms-primer.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiE9B,CAAC"}