@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/analytics/community-movie/telemetry-record.schema.d.ts

@@ -0,0 +1,157 @@
+import { z } from 'zod';
+export declare const CommunityTelemetryPersistSchema: z.ZodObject<{
+    event_name: z.ZodEnum<["page_view", "homepage_view", "consent_updated", "sign_up", "signup_started", "signup_completed", "engaged_free_user", "login", "view_challenge", "view_world", "world_page_view", "world_cta_click", "view_idea", "view_actor", "trailer_play", "trailer_complete_25", "trailer_complete_50", "trailer_complete_75", "trailer_complete_100", "idea_form_started", "pricing_viewed", "upgrade_clicked", "begin_checkout", "checkout_started", "checkout_abandoned", "subscription_started", "contribution_submitted", "idea_submitted", "submit_idea", "challenge_completed", "create_character", "vote_cast", "onboarding_complete", "waitlist_joined", "create_project", "join_challenge", "referral_link_visit", "referral_attribution_set", "referral_signup_converted", "referral_reward_issued", "partner_signup_redeemed", "email_dispatch_queued", "email_dispatch_sent", "email_dispatch_failed", "email_unsubscribed", "ad_capi_dispatched", "ad_capi_failed", "watch_page_view", "film_play", "film_progress_25", "film_progress_50", "film_progress_75", "film_complete", "film_error", "watchlist_add", "watchlist_remove", "content_reaction_set", "content_rating_set", "feedback_submitted", "future_movie_view", "character_view", "pwa_install_prompt_shown", "pwa_install_prompt_accepted", "pwa_install_prompt_dismissed", "pwa_launch", "founding_viewer_offer_viewed", "founding_viewer_checkout_started", "creator_upgrade_clicked"]>;
+    event_domain: z.ZodString;
+    user_id: z.ZodNullable<z.ZodString>;
+    session_id: z.ZodNullable<z.ZodString>;
+    event_params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    attribution: z.ZodNullable<z.ZodObject<{
+        utm_source: z.ZodOptional<z.ZodString>;
+        utm_medium: z.ZodOptional<z.ZodString>;
+        utm_campaign: z.ZodOptional<z.ZodString>;
+        utm_term: z.ZodOptional<z.ZodString>;
+        utm_content: z.ZodOptional<z.ZodString>;
+        gclid: z.ZodOptional<z.ZodString>;
+        gbraid: z.ZodOptional<z.ZodString>;
+        wbraid: z.ZodOptional<z.ZodString>;
+        referrer: z.ZodOptional<z.ZodString>;
+        landing_path: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        gclid?: string | undefined;
+        utm_source?: string | undefined;
+        utm_medium?: string | undefined;
+        utm_campaign?: string | undefined;
+        utm_content?: string | undefined;
+        utm_term?: string | undefined;
+        gbraid?: string | undefined;
+        wbraid?: string | undefined;
+        referrer?: string | undefined;
+        landing_path?: string | undefined;
+    }, {
+        gclid?: string | undefined;
+        utm_source?: string | undefined;
+        utm_medium?: string | undefined;
+        utm_campaign?: string | undefined;
+        utm_content?: string | undefined;
+        utm_term?: string | undefined;
+        gbraid?: string | undefined;
+        wbraid?: string | undefined;
+        referrer?: string | undefined;
+        landing_path?: string | undefined;
+    }>>;
+    source: z.ZodEnum<["browser", "server", "measurement_protocol"]>;
+}, "strict", z.ZodTypeAny, {
+    source: "browser" | "server" | "measurement_protocol";
+    event_name: "login" | "signup_completed" | "checkout_started" | "idea_submitted" | "page_view" | "homepage_view" | "consent_updated" | "sign_up" | "signup_started" | "engaged_free_user" | "view_challenge" | "view_world" | "world_page_view" | "world_cta_click" | "view_idea" | "view_actor" | "trailer_play" | "trailer_complete_25" | "trailer_complete_50" | "trailer_complete_75" | "trailer_complete_100" | "idea_form_started" | "pricing_viewed" | "upgrade_clicked" | "begin_checkout" | "checkout_abandoned" | "subscription_started" | "contribution_submitted" | "submit_idea" | "challenge_completed" | "create_character" | "vote_cast" | "onboarding_complete" | "waitlist_joined" | "create_project" | "join_challenge" | "referral_link_visit" | "referral_attribution_set" | "referral_signup_converted" | "referral_reward_issued" | "partner_signup_redeemed" | "email_dispatch_queued" | "email_dispatch_sent" | "email_dispatch_failed" | "email_unsubscribed" | "ad_capi_dispatched" | "ad_capi_failed" | "watch_page_view" | "film_play" | "film_progress_25" | "film_progress_50" | "film_progress_75" | "film_complete" | "film_error" | "watchlist_add" | "watchlist_remove" | "content_reaction_set" | "content_rating_set" | "feedback_submitted" | "future_movie_view" | "character_view" | "pwa_install_prompt_shown" | "pwa_install_prompt_accepted" | "pwa_install_prompt_dismissed" | "pwa_launch" | "founding_viewer_offer_viewed" | "founding_viewer_checkout_started" | "creator_upgrade_clicked";
+    user_id: string | null;
+    session_id: string | null;
+    attribution: {
+        gclid?: string | undefined;
+        utm_source?: string | undefined;
+        utm_medium?: string | undefined;
+        utm_campaign?: string | undefined;
+        utm_content?: string | undefined;
+        utm_term?: string | undefined;
+        gbraid?: string | undefined;
+        wbraid?: string | undefined;
+        referrer?: string | undefined;
+        landing_path?: string | undefined;
+    } | null;
+    event_params: Record<string, unknown>;
+    event_domain: string;
+}, {
+    source: "browser" | "server" | "measurement_protocol";
+    event_name: "login" | "signup_completed" | "checkout_started" | "idea_submitted" | "page_view" | "homepage_view" | "consent_updated" | "sign_up" | "signup_started" | "engaged_free_user" | "view_challenge" | "view_world" | "world_page_view" | "world_cta_click" | "view_idea" | "view_actor" | "trailer_play" | "trailer_complete_25" | "trailer_complete_50" | "trailer_complete_75" | "trailer_complete_100" | "idea_form_started" | "pricing_viewed" | "upgrade_clicked" | "begin_checkout" | "checkout_abandoned" | "subscription_started" | "contribution_submitted" | "submit_idea" | "challenge_completed" | "create_character" | "vote_cast" | "onboarding_complete" | "waitlist_joined" | "create_project" | "join_challenge" | "referral_link_visit" | "referral_attribution_set" | "referral_signup_converted" | "referral_reward_issued" | "partner_signup_redeemed" | "email_dispatch_queued" | "email_dispatch_sent" | "email_dispatch_failed" | "email_unsubscribed" | "ad_capi_dispatched" | "ad_capi_failed" | "watch_page_view" | "film_play" | "film_progress_25" | "film_progress_50" | "film_progress_75" | "film_complete" | "film_error" | "watchlist_add" | "watchlist_remove" | "content_reaction_set" | "content_rating_set" | "feedback_submitted" | "future_movie_view" | "character_view" | "pwa_install_prompt_shown" | "pwa_install_prompt_accepted" | "pwa_install_prompt_dismissed" | "pwa_launch" | "founding_viewer_offer_viewed" | "founding_viewer_checkout_started" | "creator_upgrade_clicked";
+    user_id: string | null;
+    session_id: string | null;
+    attribution: {
+        gclid?: string | undefined;
+        utm_source?: string | undefined;
+        utm_medium?: string | undefined;
+        utm_campaign?: string | undefined;
+        utm_content?: string | undefined;
+        utm_term?: string | undefined;
+        gbraid?: string | undefined;
+        wbraid?: string | undefined;
+        referrer?: string | undefined;
+        landing_path?: string | undefined;
+    } | null;
+    event_params: Record<string, unknown>;
+    event_domain: string;
+}>;
+export type CommunityTelemetryPersist = z.infer<typeof CommunityTelemetryPersistSchema>;
+export declare const CommunityTelemetryClientIngestSchema: z.ZodObject<{
+    event_name: z.ZodEnum<["page_view", "homepage_view", "consent_updated", "sign_up", "signup_started", "signup_completed", "engaged_free_user", "login", "view_challenge", "view_world", "world_page_view", "world_cta_click", "view_idea", "view_actor", "trailer_play", "trailer_complete_25", "trailer_complete_50", "trailer_complete_75", "trailer_complete_100", "idea_form_started", "pricing_viewed", "upgrade_clicked", "begin_checkout", "checkout_started", "checkout_abandoned", "subscription_started", "contribution_submitted", "idea_submitted", "submit_idea", "challenge_completed", "create_character", "vote_cast", "onboarding_complete", "waitlist_joined", "create_project", "join_challenge", "referral_link_visit", "referral_attribution_set", "referral_signup_converted", "referral_reward_issued", "partner_signup_redeemed", "email_dispatch_queued", "email_dispatch_sent", "email_dispatch_failed", "email_unsubscribed", "ad_capi_dispatched", "ad_capi_failed", "watch_page_view", "film_play", "film_progress_25", "film_progress_50", "film_progress_75", "film_complete", "film_error", "watchlist_add", "watchlist_remove", "content_reaction_set", "content_rating_set", "feedback_submitted", "future_movie_view", "character_view", "pwa_install_prompt_shown", "pwa_install_prompt_accepted", "pwa_install_prompt_dismissed", "pwa_launch", "founding_viewer_offer_viewed", "founding_viewer_checkout_started", "creator_upgrade_clicked"]>;
+    event_params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    session_id: z.ZodString;
+    client_timestamp: z.ZodString;
+    attribution: z.ZodOptional<z.ZodObject<{
+        utm_source: z.ZodOptional<z.ZodString>;
+        utm_medium: z.ZodOptional<z.ZodString>;
+        utm_campaign: z.ZodOptional<z.ZodString>;
+        utm_term: z.ZodOptional<z.ZodString>;
+        utm_content: z.ZodOptional<z.ZodString>;
+        gclid: z.ZodOptional<z.ZodString>;
+        gbraid: z.ZodOptional<z.ZodString>;
+        wbraid: z.ZodOptional<z.ZodString>;
+        referrer: z.ZodOptional<z.ZodString>;
+        landing_path: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        gclid?: string | undefined;
+        utm_source?: string | undefined;
+        utm_medium?: string | undefined;
+        utm_campaign?: string | undefined;
+        utm_content?: string | undefined;
+        utm_term?: string | undefined;
+        gbraid?: string | undefined;
+        wbraid?: string | undefined;
+        referrer?: string | undefined;
+        landing_path?: string | undefined;
+    }, {
+        gclid?: string | undefined;
+        utm_source?: string | undefined;
+        utm_medium?: string | undefined;
+        utm_campaign?: string | undefined;
+        utm_content?: string | undefined;
+        utm_term?: string | undefined;
+        gbraid?: string | undefined;
+        wbraid?: string | undefined;
+        referrer?: string | undefined;
+        landing_path?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    event_name: "login" | "signup_completed" | "checkout_started" | "idea_submitted" | "page_view" | "homepage_view" | "consent_updated" | "sign_up" | "signup_started" | "engaged_free_user" | "view_challenge" | "view_world" | "world_page_view" | "world_cta_click" | "view_idea" | "view_actor" | "trailer_play" | "trailer_complete_25" | "trailer_complete_50" | "trailer_complete_75" | "trailer_complete_100" | "idea_form_started" | "pricing_viewed" | "upgrade_clicked" | "begin_checkout" | "checkout_abandoned" | "subscription_started" | "contribution_submitted" | "submit_idea" | "challenge_completed" | "create_character" | "vote_cast" | "onboarding_complete" | "waitlist_joined" | "create_project" | "join_challenge" | "referral_link_visit" | "referral_attribution_set" | "referral_signup_converted" | "referral_reward_issued" | "partner_signup_redeemed" | "email_dispatch_queued" | "email_dispatch_sent" | "email_dispatch_failed" | "email_unsubscribed" | "ad_capi_dispatched" | "ad_capi_failed" | "watch_page_view" | "film_play" | "film_progress_25" | "film_progress_50" | "film_progress_75" | "film_complete" | "film_error" | "watchlist_add" | "watchlist_remove" | "content_reaction_set" | "content_rating_set" | "feedback_submitted" | "future_movie_view" | "character_view" | "pwa_install_prompt_shown" | "pwa_install_prompt_accepted" | "pwa_install_prompt_dismissed" | "pwa_launch" | "founding_viewer_offer_viewed" | "founding_viewer_checkout_started" | "creator_upgrade_clicked";
+    session_id: string;
+    event_params: Record<string, unknown>;
+    client_timestamp: string;
+    attribution?: {
+        gclid?: string | undefined;
+        utm_source?: string | undefined;
+        utm_medium?: string | undefined;
+        utm_campaign?: string | undefined;
+        utm_content?: string | undefined;
+        utm_term?: string | undefined;
+        gbraid?: string | undefined;
+        wbraid?: string | undefined;
+        referrer?: string | undefined;
+        landing_path?: string | undefined;
+    } | undefined;
+}, {
+    event_name: "login" | "signup_completed" | "checkout_started" | "idea_submitted" | "page_view" | "homepage_view" | "consent_updated" | "sign_up" | "signup_started" | "engaged_free_user" | "view_challenge" | "view_world" | "world_page_view" | "world_cta_click" | "view_idea" | "view_actor" | "trailer_play" | "trailer_complete_25" | "trailer_complete_50" | "trailer_complete_75" | "trailer_complete_100" | "idea_form_started" | "pricing_viewed" | "upgrade_clicked" | "begin_checkout" | "checkout_abandoned" | "subscription_started" | "contribution_submitted" | "submit_idea" | "challenge_completed" | "create_character" | "vote_cast" | "onboarding_complete" | "waitlist_joined" | "create_project" | "join_challenge" | "referral_link_visit" | "referral_attribution_set" | "referral_signup_converted" | "referral_reward_issued" | "partner_signup_redeemed" | "email_dispatch_queued" | "email_dispatch_sent" | "email_dispatch_failed" | "email_unsubscribed" | "ad_capi_dispatched" | "ad_capi_failed" | "watch_page_view" | "film_play" | "film_progress_25" | "film_progress_50" | "film_progress_75" | "film_complete" | "film_error" | "watchlist_add" | "watchlist_remove" | "content_reaction_set" | "content_rating_set" | "feedback_submitted" | "future_movie_view" | "character_view" | "pwa_install_prompt_shown" | "pwa_install_prompt_accepted" | "pwa_install_prompt_dismissed" | "pwa_launch" | "founding_viewer_offer_viewed" | "founding_viewer_checkout_started" | "creator_upgrade_clicked";
+    session_id: string;
+    event_params: Record<string, unknown>;
+    client_timestamp: string;
+    attribution?: {
+        gclid?: string | undefined;
+        utm_source?: string | undefined;
+        utm_medium?: string | undefined;
+        utm_campaign?: string | undefined;
+        utm_content?: string | undefined;
+        utm_term?: string | undefined;
+        gbraid?: string | undefined;
+        wbraid?: string | undefined;
+        referrer?: string | undefined;
+        landing_path?: string | undefined;
+    } | undefined;
+}>;
+export type CommunityTelemetryClientIngest = z.infer<typeof CommunityTelemetryClientIngestSchema>;

package/dist/analytics/community-movie/telemetry-record.schema.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommunityTelemetryClientIngestSchema = exports.CommunityTelemetryPersistSchema = void 0;
+const zod_1 = require("zod");
+const attribution_schema_1 = require("./attribution.schema");
+const event_names_1 = require("./event-names");
+exports.CommunityTelemetryPersistSchema = zod_1.z
+    .object({
+    event_name: zod_1.z.enum(event_names_1.COMMUNITY_MOVIE_ANALYTICS_EVENT_NAMES),
+    event_domain: zod_1.z.string().max(64),
+    user_id: zod_1.z.string().uuid().nullable(),
+    session_id: zod_1.z.string().max(128).nullable(),
+    event_params: zod_1.z.record(zod_1.z.unknown()),
+    attribution: attribution_schema_1.CommunityAttributionSchema.nullable(),
+    source: zod_1.z.enum(event_names_1.COMMUNITY_TELEMETRY_SOURCES),
+})
+    .strict();
+exports.CommunityTelemetryClientIngestSchema = zod_1.z
+    .object({
+    event_name: zod_1.z.enum(event_names_1.COMMUNITY_MOVIE_ANALYTICS_EVENT_NAMES),
+    event_params: zod_1.z.record(zod_1.z.unknown()),
+    session_id: zod_1.z.string().min(8).max(128),
+    client_timestamp: zod_1.z.string().datetime(),
+    attribution: attribution_schema_1.CommunityAttributionSchema.optional(),
+})
+    .strict();

package/dist/analytics/index.d.ts

@@ -0,0 +1 @@
+export * from './community-movie/index';

package/dist/analytics/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./community-movie/index"), exports);

package/dist/community/actor-builder-options.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+/**
+ * Wave-1 Actor Builder registries (community.movie).
+ * Bootstrap option IDs — reconcile against launch sprint plan artifact when available.
+ */
+export declare const ACTOR_ARCHETYPES: readonly ["outsider_with_moral_compass", "reluctant_mentor", "trickster_truth_teller", "quiet_guardian", "burned_idealist", "soft_power_manipulator", "earnest_true_believer", "survivor_pragmatist", "prodigy_running_from_home", "wounded_healer", "loyal_enforcer", "chaotic_catalyst"];
+export declare const VOICE_ARCHETYPES: readonly ["warm_elder", "dry_wit_side_eye", "velvet_antagonist", "earnest_youth", "gravel_truth_teller", "airy_mystic", "clipped_professional", "honeyed_persuader", "breathless_idealist", "smoky_noir_narrator", "gentle_apology_voice", "command_stage_whisper"];
+/** Provider-side voice identifiers — never expose choice mapping publicly in UI beyond selection IDs. */
+export declare const VOICE_ARCHETYPE_TO_PROVIDER_VOICE_ID: Readonly<Record<(typeof VOICE_ARCHETYPES)[number], string>>;
+export declare const GENRE_FITS: readonly ["arthouse_drama", "psychological_thriller", "romantic_drama", "science_fiction", "folkloric_fantasy", "folk_horror", "warm_comedy", "documentary_tone", "neo_noir_crime", "historical_epic", "magical_realism", "coming_of_age"];
+export declare const PERSONALITY_TRAITS: readonly ["stubborn_loyalty", "radical_curiosity", "quiet_discipline", "volatile_honesty", "meticulous_planner", "impulsive_rescuer", "deep_empathy", "emotionally_guarded", "ambitious_to_a_fault", "tender_under_pressure", "playful_deflector", "skeptical_of_authority"];
+export declare const FLAWS: readonly ["pride_as_armor", "conflict_avoidance", "envy_of_peers", "reckless_sacrifice", "dangerous_naivete", "cynical_spiral", "control_as_care", "martyrdom_complex", "hunger_for_validation", "denial_of_need", "resentment_cache", "over_identifies_with_job"];
+export declare const DESIRES: readonly ["belong_without_erasing_self", "justice_that_costs_something", "redemption_without_performance", "survival_with_dignity", "truth_even_if_it_hurts", "love_that_does_not_own", "legacy_that_protects_others", "freedom_from_past_version", "forgiveness_they_cannot_voice", "power_used_to_protect_weak", "peace_inside_chaos", "repair_a_broken_bond"];
+export declare const VISUAL_ARCHETYPES: readonly ["noir_silhouette_and_rim", "pastoral_soft_grain", "neon_edge_city_haze", "regency_clean_lines", "brutalist_concrete_grey", "coastal_washed_light", "festival_vermilion_accent", "monochrome_icon", "golden_hour_oil_glow", "clinical_white_blue_bias", "midnight_blue_and_brass", "paper_texture_matte"];
+export declare const COSTUME_ELEMENTS: readonly ["drape_weighted_coat", "ritual_layered_gown", "scuffed_work_boots", "tailored_suit_with_frayed_collar", "folk_patterned_obi", "single_focus_pendant", "ink_stained_cuffs", "patchwork_uniform_tailoring", "weatherproof_field_gear", "statement_scarf_wrapped_twice", "ancestor_ring_visible", "deliberately_plain_everything_else"];
+export declare const SIGNATURE_OBJECTS: readonly ["paper_lantern_with_crack", "handheld_compass_that_lies", "worn_notebook_of_sketches", "brass_skeleton_key", "bone_handle_knife_never_used", "heirloom_fan_half_broken", "cracked_phone_with_one_photo", "offering_bowl_always_full", "metronome_as_talisman", "rusted_whistle_on_chain", "folded_map_with_false_coastline", "empty_picture_frame_carried"];
+export declare const COLOR_PALETTES: readonly ["amber_on_indigo_depth", "charcoal_with_bleeding_rose", "sage_and_sea_moss", "bone_black_and_sepia_lift", "teal_rust_and_oyster_white", "porcelain_jade_and_smoke", "blood_red_accents_on_slate", "sunlit_wheat_and_denim_shadow", "ultraviolet_midnight_lift", "paper_white_and_sumi_ink", "copper_patina_and_ivory", "cool_grey_with_single_gold_hit"];
+export declare const AGE_BANDS: readonly ["child", "teen", "young_adult", "adult", "middle_aged", "elder"];
+export declare const RELATIONSHIP_HOOKS: readonly ["estranged_sibling_mirror", "reluctant_ally_by_circumstance", "secret_benefactor_with_terms", "rival_who_reflects_flaws", "found_family_anchor", "mentor_student_roles_reversed", "old_friend_with_unspoken_debt", "authority_figure_softened_by_loss", "romantic_tension_never_named", "antagonist_who_thinks_they_are_saving_you", "blood_oath_without_consent", "rival_who_protects_you_in_secret"];
+export declare const ActorArchetypeSchema: z.ZodEnum<["outsider_with_moral_compass", "reluctant_mentor", "trickster_truth_teller", "quiet_guardian", "burned_idealist", "soft_power_manipulator", "earnest_true_believer", "survivor_pragmatist", "prodigy_running_from_home", "wounded_healer", "loyal_enforcer", "chaotic_catalyst"]>;
+export declare const VoiceArchetypeSchema: z.ZodEnum<["warm_elder", "dry_wit_side_eye", "velvet_antagonist", "earnest_youth", "gravel_truth_teller", "airy_mystic", "clipped_professional", "honeyed_persuader", "breathless_idealist", "smoky_noir_narrator", "gentle_apology_voice", "command_stage_whisper"]>;
+export declare const GenreFitSchema: z.ZodEnum<["arthouse_drama", "psychological_thriller", "romantic_drama", "science_fiction", "folkloric_fantasy", "folk_horror", "warm_comedy", "documentary_tone", "neo_noir_crime", "historical_epic", "magical_realism", "coming_of_age"]>;
+export declare const PersonalityTraitSchema: z.ZodEnum<["stubborn_loyalty", "radical_curiosity", "quiet_discipline", "volatile_honesty", "meticulous_planner", "impulsive_rescuer", "deep_empathy", "emotionally_guarded", "ambitious_to_a_fault", "tender_under_pressure", "playful_deflector", "skeptical_of_authority"]>;
+export declare const FlawSchema: z.ZodEnum<["pride_as_armor", "conflict_avoidance", "envy_of_peers", "reckless_sacrifice", "dangerous_naivete", "cynical_spiral", "control_as_care", "martyrdom_complex", "hunger_for_validation", "denial_of_need", "resentment_cache", "over_identifies_with_job"]>;
+export declare const DesireSchema: z.ZodEnum<["belong_without_erasing_self", "justice_that_costs_something", "redemption_without_performance", "survival_with_dignity", "truth_even_if_it_hurts", "love_that_does_not_own", "legacy_that_protects_others", "freedom_from_past_version", "forgiveness_they_cannot_voice", "power_used_to_protect_weak", "peace_inside_chaos", "repair_a_broken_bond"]>;
+export declare const VisualArchetypeSchema: z.ZodEnum<["noir_silhouette_and_rim", "pastoral_soft_grain", "neon_edge_city_haze", "regency_clean_lines", "brutalist_concrete_grey", "coastal_washed_light", "festival_vermilion_accent", "monochrome_icon", "golden_hour_oil_glow", "clinical_white_blue_bias", "midnight_blue_and_brass", "paper_texture_matte"]>;
+export declare const CostumeElementSchema: z.ZodEnum<["drape_weighted_coat", "ritual_layered_gown", "scuffed_work_boots", "tailored_suit_with_frayed_collar", "folk_patterned_obi", "single_focus_pendant", "ink_stained_cuffs", "patchwork_uniform_tailoring", "weatherproof_field_gear", "statement_scarf_wrapped_twice", "ancestor_ring_visible", "deliberately_plain_everything_else"]>;
+export declare const SignatureObjectSchema: z.ZodEnum<["paper_lantern_with_crack", "handheld_compass_that_lies", "worn_notebook_of_sketches", "brass_skeleton_key", "bone_handle_knife_never_used", "heirloom_fan_half_broken", "cracked_phone_with_one_photo", "offering_bowl_always_full", "metronome_as_talisman", "rusted_whistle_on_chain", "folded_map_with_false_coastline", "empty_picture_frame_carried"]>;
+export declare const ColorPaletteSchema: z.ZodEnum<["amber_on_indigo_depth", "charcoal_with_bleeding_rose", "sage_and_sea_moss", "bone_black_and_sepia_lift", "teal_rust_and_oyster_white", "porcelain_jade_and_smoke", "blood_red_accents_on_slate", "sunlit_wheat_and_denim_shadow", "ultraviolet_midnight_lift", "paper_white_and_sumi_ink", "copper_patina_and_ivory", "cool_grey_with_single_gold_hit"]>;
+export declare const AgeBandSchema: z.ZodEnum<["child", "teen", "young_adult", "adult", "middle_aged", "elder"]>;
+export declare const RelationshipHookSchema: z.ZodEnum<["estranged_sibling_mirror", "reluctant_ally_by_circumstance", "secret_benefactor_with_terms", "rival_who_reflects_flaws", "found_family_anchor", "mentor_student_roles_reversed", "old_friend_with_unspoken_debt", "authority_figure_softened_by_loss", "romantic_tension_never_named", "antagonist_who_thinks_they_are_saving_you", "blood_oath_without_consent", "rival_who_protects_you_in_secret"]>;
+export type ActorArchetypeId = z.infer<typeof ActorArchetypeSchema>;
+export type VoiceArchetypeId = z.infer<typeof VoiceArchetypeSchema>;
+export type GenreFitId = z.infer<typeof GenreFitSchema>;
+export type PersonalityTraitId = z.infer<typeof PersonalityTraitSchema>;
+export type FlawId = z.infer<typeof FlawSchema>;
+export type DesireId = z.infer<typeof DesireSchema>;
+export type VisualArchetypeId = z.infer<typeof VisualArchetypeSchema>;
+export type CostumeElementId = z.infer<typeof CostumeElementSchema>;
+export type SignatureObjectId = z.infer<typeof SignatureObjectSchema>;
+export type ColorPaletteId = z.infer<typeof ColorPaletteSchema>;
+export type AgeBandId = z.infer<typeof AgeBandSchema>;
+export type RelationshipHookId = z.infer<typeof RelationshipHookSchema>;

package/dist/community/actor-builder-options.js

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RelationshipHookSchema = exports.AgeBandSchema = exports.ColorPaletteSchema = exports.SignatureObjectSchema = exports.CostumeElementSchema = exports.VisualArchetypeSchema = exports.DesireSchema = exports.FlawSchema = exports.PersonalityTraitSchema = exports.GenreFitSchema = exports.VoiceArchetypeSchema = exports.ActorArchetypeSchema = exports.RELATIONSHIP_HOOKS = exports.AGE_BANDS = exports.COLOR_PALETTES = exports.SIGNATURE_OBJECTS = exports.COSTUME_ELEMENTS = exports.VISUAL_ARCHETYPES = exports.DESIRES = exports.FLAWS = exports.PERSONALITY_TRAITS = exports.GENRE_FITS = exports.VOICE_ARCHETYPE_TO_PROVIDER_VOICE_ID = exports.VOICE_ARCHETYPES = exports.ACTOR_ARCHETYPES = void 0;
+const zod_1 = require("zod");
+/**
+ * Wave-1 Actor Builder registries (community.movie).
+ * Bootstrap option IDs — reconcile against launch sprint plan artifact when available.
+ */
+exports.ACTOR_ARCHETYPES = [
+    'outsider_with_moral_compass',
+    'reluctant_mentor',
+    'trickster_truth_teller',
+    'quiet_guardian',
+    'burned_idealist',
+    'soft_power_manipulator',
+    'earnest_true_believer',
+    'survivor_pragmatist',
+    'prodigy_running_from_home',
+    'wounded_healer',
+    'loyal_enforcer',
+    'chaotic_catalyst',
+];
+exports.VOICE_ARCHETYPES = [
+    'warm_elder',
+    'dry_wit_side_eye',
+    'velvet_antagonist',
+    'earnest_youth',
+    'gravel_truth_teller',
+    'airy_mystic',
+    'clipped_professional',
+    'honeyed_persuader',
+    'breathless_idealist',
+    'smoky_noir_narrator',
+    'gentle_apology_voice',
+    'command_stage_whisper',
+];
+/** Provider-side voice identifiers — never expose choice mapping publicly in UI beyond selection IDs. */
+exports.VOICE_ARCHETYPE_TO_PROVIDER_VOICE_ID = {
+    warm_elder: 'placeholder-elevenlabs-warm-elder',
+    dry_wit_side_eye: 'placeholder-elevenlabs-dry-wit',
+    velvet_antagonist: 'placeholder-elevenlabs-velvet-antagonist',
+    earnest_youth: 'placeholder-elevenlabs-earnest-youth',
+    gravel_truth_teller: 'placeholder-elevenlabs-gravel-truth',
+    airy_mystic: 'placeholder-elevenlabs-airy-mystic',
+    clipped_professional: 'placeholder-elevenlabs-clipped-pro',
+    honeyed_persuader: 'placeholder-elevenlabs-honeyed',
+    breathless_idealist: 'placeholder-elevenlabs-breathless',
+    smoky_noir_narrator: 'placeholder-elevenlabs-smoky-noir',
+    gentle_apology_voice: 'placeholder-elevenlabs-gentle-apology',
+    command_stage_whisper: 'placeholder-elevenlabs-command-whisper',
+};
+exports.GENRE_FITS = [
+    'arthouse_drama',
+    'psychological_thriller',
+    'romantic_drama',
+    'science_fiction',
+    'folkloric_fantasy',
+    'folk_horror',
+    'warm_comedy',
+    'documentary_tone',
+    'neo_noir_crime',
+    'historical_epic',
+    'magical_realism',
+    'coming_of_age',
+];
+exports.PERSONALITY_TRAITS = [
+    'stubborn_loyalty',
+    'radical_curiosity',
+    'quiet_discipline',
+    'volatile_honesty',
+    'meticulous_planner',
+    'impulsive_rescuer',
+    'deep_empathy',
+    'emotionally_guarded',
+    'ambitious_to_a_fault',
+    'tender_under_pressure',
+    'playful_deflector',
+    'skeptical_of_authority',
+];
+exports.FLAWS = [
+    'pride_as_armor',
+    'conflict_avoidance',
+    'envy_of_peers',
+    'reckless_sacrifice',
+    'dangerous_naivete',
+    'cynical_spiral',
+    'control_as_care',
+    'martyrdom_complex',
+    'hunger_for_validation',
+    'denial_of_need',
+    'resentment_cache',
+    'over_identifies_with_job',
+];
+exports.DESIRES = [
+    'belong_without_erasing_self',
+    'justice_that_costs_something',
+    'redemption_without_performance',
+    'survival_with_dignity',
+    'truth_even_if_it_hurts',
+    'love_that_does_not_own',
+    'legacy_that_protects_others',
+    'freedom_from_past_version',
+    'forgiveness_they_cannot_voice',
+    'power_used_to_protect_weak',
+    'peace_inside_chaos',
+    'repair_a_broken_bond',
+];
+exports.VISUAL_ARCHETYPES = [
+    'noir_silhouette_and_rim',
+    'pastoral_soft_grain',
+    'neon_edge_city_haze',
+    'regency_clean_lines',
+    'brutalist_concrete_grey',
+    'coastal_washed_light',
+    'festival_vermilion_accent',
+    'monochrome_icon',
+    'golden_hour_oil_glow',
+    'clinical_white_blue_bias',
+    'midnight_blue_and_brass',
+    'paper_texture_matte',
+];
+exports.COSTUME_ELEMENTS = [
+    'drape_weighted_coat',
+    'ritual_layered_gown',
+    'scuffed_work_boots',
+    'tailored_suit_with_frayed_collar',
+    'folk_patterned_obi',
+    'single_focus_pendant',
+    'ink_stained_cuffs',
+    'patchwork_uniform_tailoring',
+    'weatherproof_field_gear',
+    'statement_scarf_wrapped_twice',
+    'ancestor_ring_visible',
+    'deliberately_plain_everything_else',
+];
+exports.SIGNATURE_OBJECTS = [
+    'paper_lantern_with_crack',
+    'handheld_compass_that_lies',
+    'worn_notebook_of_sketches',
+    'brass_skeleton_key',
+    'bone_handle_knife_never_used',
+    'heirloom_fan_half_broken',
+    'cracked_phone_with_one_photo',
+    'offering_bowl_always_full',
+    'metronome_as_talisman',
+    'rusted_whistle_on_chain',
+    'folded_map_with_false_coastline',
+    'empty_picture_frame_carried',
+];
+exports.COLOR_PALETTES = [
+    'amber_on_indigo_depth',
+    'charcoal_with_bleeding_rose',
+    'sage_and_sea_moss',
+    'bone_black_and_sepia_lift',
+    'teal_rust_and_oyster_white',
+    'porcelain_jade_and_smoke',
+    'blood_red_accents_on_slate',
+    'sunlit_wheat_and_denim_shadow',
+    'ultraviolet_midnight_lift',
+    'paper_white_and_sumi_ink',
+    'copper_patina_and_ivory',
+    'cool_grey_with_single_gold_hit',
+];
+exports.AGE_BANDS = [
+    'child',
+    'teen',
+    'young_adult',
+    'adult',
+    'middle_aged',
+    'elder',
+];
+exports.RELATIONSHIP_HOOKS = [
+    'estranged_sibling_mirror',
+    'reluctant_ally_by_circumstance',
+    'secret_benefactor_with_terms',
+    'rival_who_reflects_flaws',
+    'found_family_anchor',
+    'mentor_student_roles_reversed',
+    'old_friend_with_unspoken_debt',
+    'authority_figure_softened_by_loss',
+    'romantic_tension_never_named',
+    'antagonist_who_thinks_they_are_saving_you',
+    'blood_oath_without_consent',
+    'rival_who_protects_you_in_secret',
+];
+exports.ActorArchetypeSchema = zod_1.z.enum(exports.ACTOR_ARCHETYPES);
+exports.VoiceArchetypeSchema = zod_1.z.enum(exports.VOICE_ARCHETYPES);
+exports.GenreFitSchema = zod_1.z.enum(exports.GENRE_FITS);
+exports.PersonalityTraitSchema = zod_1.z.enum(exports.PERSONALITY_TRAITS);
+exports.FlawSchema = zod_1.z.enum(exports.FLAWS);
+exports.DesireSchema = zod_1.z.enum(exports.DESIRES);
+exports.VisualArchetypeSchema = zod_1.z.enum(exports.VISUAL_ARCHETYPES);
+exports.CostumeElementSchema = zod_1.z.enum(exports.COSTUME_ELEMENTS);
+exports.SignatureObjectSchema = zod_1.z.enum(exports.SIGNATURE_OBJECTS);
+exports.ColorPaletteSchema = zod_1.z.enum(exports.COLOR_PALETTES);
+exports.AgeBandSchema = zod_1.z.enum(exports.AGE_BANDS);
+exports.RelationshipHookSchema = zod_1.z.enum(exports.RELATIONSHIP_HOOKS);

package/dist/constants/AGENT_MCP_PERMISSIONS.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 🛡️ Agent MCP Permissions - Single Source of Truth
+ * Constitutional compliance: Defines which agents can execute which MCP tools
+ * Sprint 14: Governance layer for Model Context Protocol operations
+ */
+export declare const AGENT_MCP_PERMISSIONS: Record<string, string[]>;
+/**
+ * Check if an agent has permission to execute a specific MCP command
+ * Constitutional: Enforces agent governance layer
+ */
+export declare function hasAgentPermission(agentRole: string, command: string): boolean;
+/**
+ * Get all allowed MCP tools for an agent role
+ */
+export declare function getAgentPermissions(agentRole: string): string[];
+/**
+ * List all registered agent roles
+ */
+export declare function listAgentRoles(): string[];
+/**
+ * Validate permission configuration (used in tests/CI)
+ */
+export declare function validatePermissions(): {
+    valid: boolean;
+    errors: string[];
+};

package/dist/constants/AGENT_MCP_PERMISSIONS.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * 🛡️ Agent MCP Permissions - Single Source of Truth
+ * Constitutional compliance: Defines which agents can execute which MCP tools
+ * Sprint 14: Governance layer for Model Context Protocol operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_MCP_PERMISSIONS = void 0;
+exports.hasAgentPermission = hasAgentPermission;
+exports.getAgentPermissions = getAgentPermissions;
+exports.listAgentRoles = listAgentRoles;
+exports.validatePermissions = validatePermissions;
+exports.AGENT_MCP_PERMISSIONS = {
+    'spec-engineer': [
+        'mcp supabase execute-sql',
+        'mcp supabase list-tables',
+        'mcp github create-issue',
+    ],
+    'system-architect': [
+        'mcp supabase execute-sql',
+        'mcp supabase list-tables',
+        'mcp github list-repos',
+        'mcp vercel list-projects',
+        'mcp vercel list-deployments',
+    ],
+    'task-analyst': [
+        'mcp supabase execute-sql',
+        'mcp supabase list-tables',
+    ],
+    'code-implementer': [
+        'mcp supabase execute-sql',
+        'mcp github create-pr',
+        'mcp github push-files',
+        'mcp github create-branch',
+        'mcp vercel deploy',
+    ],
+    'code-reviewer': [
+        'mcp supabase execute-sql',
+        'mcp github get-pr',
+        'mcp github list-pr-files',
+        'mcp github get-pr-status',
+        'mcp playwright browser-snapshot',
+        'mcp playwright browser-navigate',
+    ],
+    'compliance-officer': [
+        'mcp supabase list-tables',
+        'mcp supabase execute-sql',
+        'mcp vercel get-logs',
+        'mcp github search-code',
+        'mcp github search-issues',
+    ],
+    'project-analyst': [
+        'mcp supabase execute-sql',
+        'mcp github list-commits',
+        'mcp github list-pull-requests',
+        'mcp vercel list-deployments',
+    ],
+    'infra-architect': [
+        'mcp supabase apply-migration',
+        'mcp supabase list-tables',
+        'mcp vercel deploy',
+        'mcp vercel create-project',
+        'mcp github create-repo',
+        'mcp github list-repos',
+    ],
+};
+/**
+ * Check if an agent has permission to execute a specific MCP command
+ * Constitutional: Enforces agent governance layer
+ */
+function hasAgentPermission(agentRole, command) {
+    const permissions = exports.AGENT_MCP_PERMISSIONS[agentRole];
+    if (!permissions) {
+        return false; // Unknown agent - deny by default
+    }
+    // Check exact match or wildcard pattern
+    return permissions.some(pattern => {
+        if (command === pattern)
+            return true;
+        if (pattern.endsWith('*')) {
+            const prefix = pattern.slice(0, -1);
+            return command.startsWith(prefix);
+        }
+        return false;
+    });
+}
+/**
+ * Get all allowed MCP tools for an agent role
+ */
+function getAgentPermissions(agentRole) {
+    return exports.AGENT_MCP_PERMISSIONS[agentRole] || [];
+}
+/**
+ * List all registered agent roles
+ */
+function listAgentRoles() {
+    return Object.keys(exports.AGENT_MCP_PERMISSIONS);
+}
+/**
+ * Validate permission configuration (used in tests/CI)
+ */
+function validatePermissions() {
+    const errors = [];
+    for (const [role, permissions] of Object.entries(exports.AGENT_MCP_PERMISSIONS)) {
+        if (!Array.isArray(permissions)) {
+            errors.push(`Invalid permissions for role '${role}': not an array`);
+            continue;
+        }
+        for (const permission of permissions) {
+            if (typeof permission !== 'string') {
+                errors.push(`Invalid permission in role '${role}': ${permission} is not a string`);
+            }
+            if (!permission.startsWith('mcp ')) {
+                errors.push(`Invalid permission in role '${role}': '${permission}' must start with 'mcp '`);
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}