@withpica/mcp-server
Version:
MCP Server for withPICA — enables AI assistants to interact with your withPICA music catalog
48 lines • 1.9 kB
TypeScript
/**
* Creator Question Atlas — ADR-226 Decision 1.
*
* Source-of-truth registry mapping natural creator questions to the
* canonical PICA tool / prompt resolution. Read by:
*
* - lint Rule 11 (Phase 7) — to validate every `vernacular_kind:'creator-entry'`
* tool's `Use when the user asks` block cites questions that resolve here
* - the Atlas-taxonomy coupling lint (Decision 12, Phase 7) — `natural_domain`
* must match `discovery.ts` CATEGORIES membership for the resolved tool
* - `scripts/intent-resolution-eval.ts` — drives the eval harness corpus
* - the Phase-3 description rewrite — `Use when the user asks` blocks pull
* question + synonym strings from here
*
* Forward references to Phase-5-created tools/prompts are marked inline.
* Phase 7's lint extension reads those comments and skips them in the
* resolution check.
*
* `natural_domain` is required when `resolves_to.kind === 'tool'`. Omitted
* for prompt resolutions because prompts orchestrate cross-domain tools and
* don't fit a single `discovery.ts` category.
*
* Custody-related entries (49-50) intentionally surface routing only and
* carry no algorithmic detail — see `.claude/rules/ip-protection.md`.
*/
export type VernacularKind = "creator-entry" | "internal" | "specialist";
export interface AtlasFallback {
message: string;
next_tool: string;
}
export type AtlasResolution = {
kind: "tool";
name: string;
default_args?: Record<string, unknown>;
} | {
kind: "prompt";
name: string;
};
export interface AtlasEntry {
question: string;
synonyms: string[];
/** Required when `resolves_to.kind === 'tool'`; omitted for prompts. */
natural_domain?: string;
resolves_to: AtlasResolution;
fallback_when_empty?: AtlasFallback;
}
export declare const ATLAS: AtlasEntry[];
//# sourceMappingURL=creator-question-atlas.d.ts.map