@neuraloom/contracts 0.0.0-stage → 0.1.23

package/dist/schemas/community/community-movie-gate-result.schema.d.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+export declare const CommunityMovieGateResultSchema: z.ZodObject<{
+    outcome: z.ZodEnum<["allowed", "blocked"]>;
+    gates: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        ok: z.ZodBoolean;
+        detail: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        ok: boolean;
+        detail?: string | undefined;
+    }, {
+        id: string;
+        ok: boolean;
+        detail?: string | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    gates: {
+        id: string;
+        ok: boolean;
+        detail?: string | undefined;
+    }[];
+    outcome: "blocked" | "allowed";
+}, {
+    gates: {
+        id: string;
+        ok: boolean;
+        detail?: string | undefined;
+    }[];
+    outcome: "blocked" | "allowed";
+}>;
+export declare const CommunityMovieModerationResultSchema: z.ZodObject<{
+    decision: z.ZodEnum<["approved", "rejected", "pending"]>;
+    reasons: z.ZodArray<z.ZodString, "many">;
+    reviewerNotes: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    decision: "pending" | "rejected" | "approved";
+    reasons: string[];
+    reviewerNotes?: string | undefined;
+}, {
+    decision: "pending" | "rejected" | "approved";
+    reasons: string[];
+    reviewerNotes?: string | undefined;
+}>;
+export type CommunityMovieGateResult = z.infer<typeof CommunityMovieGateResultSchema>;
+export type CommunityMovieModerationResult = z.infer<typeof CommunityMovieModerationResultSchema>;

package/dist/schemas/community/community-movie-gate-result.schema.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommunityMovieModerationResultSchema = exports.CommunityMovieGateResultSchema = void 0;
+const zod_1 = require("zod");
+exports.CommunityMovieGateResultSchema = zod_1.z
+    .object({
+    outcome: zod_1.z.enum(['allowed', 'blocked']),
+    gates: zod_1.z.array(zod_1.z
+        .object({
+        id: zod_1.z.string().min(1).max(128),
+        ok: zod_1.z.boolean(),
+        detail: zod_1.z.string().max(800).optional(),
+    })
+        .strict()),
+})
+    .strict();
+exports.CommunityMovieModerationResultSchema = zod_1.z
+    .object({
+    decision: zod_1.z.enum(['approved', 'rejected', 'pending']),
+    reasons: zod_1.z.array(zod_1.z.string().max(320)),
+    reviewerNotes: zod_1.z.string().max(2000).optional(),
+})
+    .strict();

package/dist/schemas/community/community-movie-idea-card.schema.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+/** Compact card for pitch explore / Idea Forge previews. */
+export declare const CommunityMovieIdeaCardSchema: z.ZodObject<{
+    ideaId: z.ZodString;
+    title: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+    hook: z.ZodString;
+    toneTags: z.ZodArray<z.ZodString, "many">;
+    audienceHint: z.ZodOptional<z.ZodString>;
+    riskLevel: z.ZodLiteral<"low">;
+    publicSafe: z.ZodLiteral<true>;
+}, "strict", z.ZodTypeAny, {
+    title: string;
+    riskLevel: "low";
+    ideaId: string;
+    publicSafe: true;
+    hook: string;
+    toneTags: string[];
+    slug?: string | undefined;
+    audienceHint?: string | undefined;
+}, {
+    title: string;
+    riskLevel: "low";
+    ideaId: string;
+    publicSafe: true;
+    hook: string;
+    toneTags: string[];
+    slug?: string | undefined;
+    audienceHint?: string | undefined;
+}>;
+export type CommunityMovieIdeaCard = z.infer<typeof CommunityMovieIdeaCardSchema>;

package/dist/schemas/community/community-movie-idea-card.schema.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommunityMovieIdeaCardSchema = void 0;
+const zod_1 = require("zod");
+/** Compact card for pitch explore / Idea Forge previews. */
+exports.CommunityMovieIdeaCardSchema = zod_1.z
+    .object({
+    ideaId: zod_1.z.string().uuid(),
+    title: zod_1.z.string().min(1).max(120),
+    slug: zod_1.z.string().min(1).max(160).optional(),
+    hook: zod_1.z.string().max(320),
+    toneTags: zod_1.z.array(zod_1.z.string().max(48)).max(12),
+    audienceHint: zod_1.z.string().max(240).optional(),
+    riskLevel: zod_1.z.literal('low'),
+    publicSafe: zod_1.z.literal(true),
+})
+    .strict();

package/dist/schemas/community/community-movie-idea-input.schema.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+/** Idea Forge — raw member input before structuring / moderation. */
+export declare const CommunityMovieIdeaInputSchema: z.ZodObject<{
+    title: z.ZodString;
+    idea: z.ZodString;
+    preferredTone: z.ZodOptional<z.ZodString>;
+    targetAudience: z.ZodOptional<z.ZodString>;
+    inspirationTags: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    title: string;
+    idea: string;
+    inspirationTags: string[];
+    targetAudience?: string | undefined;
+    preferredTone?: string | undefined;
+}, {
+    title: string;
+    idea: string;
+    inspirationTags: string[];
+    targetAudience?: string | undefined;
+    preferredTone?: string | undefined;
+}>;
+export type CommunityMovieIdeaInput = z.infer<typeof CommunityMovieIdeaInputSchema>;

package/dist/schemas/community/community-movie-idea-input.schema.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommunityMovieIdeaInputSchema = void 0;
+const zod_1 = require("zod");
+/** Idea Forge — raw member input before structuring / moderation. */
+exports.CommunityMovieIdeaInputSchema = zod_1.z
+    .object({
+    title: zod_1.z.string().min(1).max(120),
+    idea: zod_1.z.string().min(1).max(1500),
+    preferredTone: zod_1.z.string().max(160).optional(),
+    targetAudience: zod_1.z.string().max(400).optional(),
+    inspirationTags: zod_1.z.array(zod_1.z.string().max(48)).max(24),
+})
+    .strict();

package/dist/schemas/community/community-movie-idea-structured.schema.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+/**
+ * Structured idea payload for safe auto-publish path (Forge pipeline).
+ * `publicSafe` + `riskLevel: low` gate automatic promotion to public pitch eligibility.
+ */
+export declare const CommunityMovieIdeaStructuredSchema: z.ZodObject<{
+    publicSafe: z.ZodLiteral<true>;
+    riskLevel: z.ZodLiteral<"low">;
+    refinedTitle: z.ZodString;
+    refinedLogline: z.ZodString;
+    themeBullets: z.ZodArray<z.ZodString, "many">;
+    audienceSketch: z.ZodOptional<z.ZodString>;
+    toneKeywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    comparableFilms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    riskLevel: "low";
+    publicSafe: true;
+    refinedTitle: string;
+    refinedLogline: string;
+    themeBullets: string[];
+    audienceSketch?: string | undefined;
+    toneKeywords?: string[] | undefined;
+    comparableFilms?: string[] | undefined;
+}, {
+    riskLevel: "low";
+    publicSafe: true;
+    refinedTitle: string;
+    refinedLogline: string;
+    themeBullets: string[];
+    audienceSketch?: string | undefined;
+    toneKeywords?: string[] | undefined;
+    comparableFilms?: string[] | undefined;
+}>;
+export type CommunityMovieIdeaStructured = z.infer<typeof CommunityMovieIdeaStructuredSchema>;

package/dist/schemas/community/community-movie-idea-structured.schema.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommunityMovieIdeaStructuredSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Structured idea payload for safe auto-publish path (Forge pipeline).
+ * `publicSafe` + `riskLevel: low` gate automatic promotion to public pitch eligibility.
+ */
+exports.CommunityMovieIdeaStructuredSchema = zod_1.z
+    .object({
+    publicSafe: zod_1.z.literal(true),
+    riskLevel: zod_1.z.literal('low'),
+    refinedTitle: zod_1.z.string().min(1).max(120),
+    refinedLogline: zod_1.z.string().min(1).max(600),
+    themeBullets: zod_1.z.array(zod_1.z.string().max(160)).min(1).max(12),
+    audienceSketch: zod_1.z.string().max(500).optional(),
+    toneKeywords: zod_1.z.array(zod_1.z.string().max(48)).max(16).optional(),
+    comparableFilms: zod_1.z.array(zod_1.z.string().max(120)).max(8).optional(),
+})
+    .strict();

package/dist/schemas/community/community-movie-kg-seed.schema.d.ts

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+/** Mirrors `community_kg_nodes.node_type` CHECK constraint (PascalCase). */
+export declare const COMMUNITY_KG_NODE_TYPES: readonly ["Idea", "Theme", "Character", "Location", "Object", "Conflict", "Tone", "Audience", "Contribution", "Comment", "VoteSignal", "Actor", "VoiceArchetype", "VisualArchetype", "Trait", "Flaw", "Desire", "SignatureObject", "ColorPalette", "CostumeElement", "GenreFit", "ActorAsset"];
+/** Mirrors `community_kg_edges.relation` CHECK constraint. */
+export declare const COMMUNITY_KG_EDGE_RELATIONS: readonly ["HAS_THEME", "HAS_CHARACTER", "HAS_LOCATION", "HAS_OBJECT", "HAS_CONFLICT", "HAS_TONE", "TARGETS_AUDIENCE", "SUPPORTED_BY", "SUGGESTS", "EXPANDS", "VOTED_FOR", "COMMENTED_ON", "HAS_ROLE", "HAS_VOICE", "HAS_VISUAL_ARCHETYPE", "HAS_TRAIT", "HAS_FLAW", "HAS_DESIRE", "HAS_OBJECT_REL", "USES_PALETTE", "WEARS", "FITS_GENRE", "SUGGESTED_FOR_IDEA", "SELECTED_FOR_PROJECT", "HAS_ASSET"];
+export declare const CommunityKgNodeTypeSchema: z.ZodEnum<["Idea", "Theme", "Character", "Location", "Object", "Conflict", "Tone", "Audience", "Contribution", "Comment", "VoteSignal", "Actor", "VoiceArchetype", "VisualArchetype", "Trait", "Flaw", "Desire", "SignatureObject", "ColorPalette", "CostumeElement", "GenreFit", "ActorAsset"]>;
+export declare const CommunityKgEdgeRelationSchema: z.ZodEnum<["HAS_THEME", "HAS_CHARACTER", "HAS_LOCATION", "HAS_OBJECT", "HAS_CONFLICT", "HAS_TONE", "TARGETS_AUDIENCE", "SUPPORTED_BY", "SUGGESTS", "EXPANDS", "VOTED_FOR", "COMMENTED_ON", "HAS_ROLE", "HAS_VOICE", "HAS_VISUAL_ARCHETYPE", "HAS_TRAIT", "HAS_FLAW", "HAS_DESIRE", "HAS_OBJECT_REL", "USES_PALETTE", "WEARS", "FITS_GENRE", "SUGGESTED_FOR_IDEA", "SELECTED_FOR_PROJECT", "HAS_ASSET"]>;
+export declare const CommunityMovieKGSeedSchema: z.ZodObject<{
+    nodes: z.ZodArray<z.ZodObject<{
+        clientKey: z.ZodString;
+        nodeType: z.ZodEnum<["Idea", "Theme", "Character", "Location", "Object", "Conflict", "Tone", "Audience", "Contribution", "Comment", "VoteSignal", "Actor", "VoiceArchetype", "VisualArchetype", "Trait", "Flaw", "Desire", "SignatureObject", "ColorPalette", "CostumeElement", "GenreFit", "ActorAsset"]>;
+        label: z.ZodString;
+        data: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strict", z.ZodTypeAny, {
+        data: Record<string, unknown>;
+        label: string;
+        nodeType: "Idea" | "Theme" | "Character" | "Location" | "Object" | "Conflict" | "Tone" | "Audience" | "Contribution" | "Comment" | "VoteSignal" | "Actor" | "VoiceArchetype" | "VisualArchetype" | "Trait" | "Flaw" | "Desire" | "SignatureObject" | "ColorPalette" | "CostumeElement" | "GenreFit" | "ActorAsset";
+        clientKey: string;
+    }, {
+        label: string;
+        nodeType: "Idea" | "Theme" | "Character" | "Location" | "Object" | "Conflict" | "Tone" | "Audience" | "Contribution" | "Comment" | "VoteSignal" | "Actor" | "VoiceArchetype" | "VisualArchetype" | "Trait" | "Flaw" | "Desire" | "SignatureObject" | "ColorPalette" | "CostumeElement" | "GenreFit" | "ActorAsset";
+        clientKey: string;
+        data?: Record<string, unknown> | undefined;
+    }>, "many">;
+    edges: z.ZodArray<z.ZodObject<{
+        fromClientKey: z.ZodString;
+        toClientKey: z.ZodString;
+        relation: z.ZodEnum<["HAS_THEME", "HAS_CHARACTER", "HAS_LOCATION", "HAS_OBJECT", "HAS_CONFLICT", "HAS_TONE", "TARGETS_AUDIENCE", "SUPPORTED_BY", "SUGGESTS", "EXPANDS", "VOTED_FOR", "COMMENTED_ON", "HAS_ROLE", "HAS_VOICE", "HAS_VISUAL_ARCHETYPE", "HAS_TRAIT", "HAS_FLAW", "HAS_DESIRE", "HAS_OBJECT_REL", "USES_PALETTE", "WEARS", "FITS_GENRE", "SUGGESTED_FOR_IDEA", "SELECTED_FOR_PROJECT", "HAS_ASSET"]>;
+        weight: z.ZodOptional<z.ZodNumber>;
+        data: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strict", z.ZodTypeAny, {
+        data: Record<string, unknown>;
+        relation: "SUPPORTED_BY" | "HAS_THEME" | "HAS_CHARACTER" | "HAS_LOCATION" | "HAS_OBJECT" | "HAS_CONFLICT" | "HAS_TONE" | "TARGETS_AUDIENCE" | "SUGGESTS" | "EXPANDS" | "VOTED_FOR" | "COMMENTED_ON" | "HAS_ROLE" | "HAS_VOICE" | "HAS_VISUAL_ARCHETYPE" | "HAS_TRAIT" | "HAS_FLAW" | "HAS_DESIRE" | "HAS_OBJECT_REL" | "USES_PALETTE" | "WEARS" | "FITS_GENRE" | "SUGGESTED_FOR_IDEA" | "SELECTED_FOR_PROJECT" | "HAS_ASSET";
+        fromClientKey: string;
+        toClientKey: string;
+        weight?: number | undefined;
+    }, {
+        relation: "SUPPORTED_BY" | "HAS_THEME" | "HAS_CHARACTER" | "HAS_LOCATION" | "HAS_OBJECT" | "HAS_CONFLICT" | "HAS_TONE" | "TARGETS_AUDIENCE" | "SUGGESTS" | "EXPANDS" | "VOTED_FOR" | "COMMENTED_ON" | "HAS_ROLE" | "HAS_VOICE" | "HAS_VISUAL_ARCHETYPE" | "HAS_TRAIT" | "HAS_FLAW" | "HAS_DESIRE" | "HAS_OBJECT_REL" | "USES_PALETTE" | "WEARS" | "FITS_GENRE" | "SUGGESTED_FOR_IDEA" | "SELECTED_FOR_PROJECT" | "HAS_ASSET";
+        fromClientKey: string;
+        toClientKey: string;
+        data?: Record<string, unknown> | undefined;
+        weight?: number | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    nodes: {
+        data: Record<string, unknown>;
+        label: string;
+        nodeType: "Idea" | "Theme" | "Character" | "Location" | "Object" | "Conflict" | "Tone" | "Audience" | "Contribution" | "Comment" | "VoteSignal" | "Actor" | "VoiceArchetype" | "VisualArchetype" | "Trait" | "Flaw" | "Desire" | "SignatureObject" | "ColorPalette" | "CostumeElement" | "GenreFit" | "ActorAsset";
+        clientKey: string;
+    }[];
+    edges: {
+        data: Record<string, unknown>;
+        relation: "SUPPORTED_BY" | "HAS_THEME" | "HAS_CHARACTER" | "HAS_LOCATION" | "HAS_OBJECT" | "HAS_CONFLICT" | "HAS_TONE" | "TARGETS_AUDIENCE" | "SUGGESTS" | "EXPANDS" | "VOTED_FOR" | "COMMENTED_ON" | "HAS_ROLE" | "HAS_VOICE" | "HAS_VISUAL_ARCHETYPE" | "HAS_TRAIT" | "HAS_FLAW" | "HAS_DESIRE" | "HAS_OBJECT_REL" | "USES_PALETTE" | "WEARS" | "FITS_GENRE" | "SUGGESTED_FOR_IDEA" | "SELECTED_FOR_PROJECT" | "HAS_ASSET";
+        fromClientKey: string;
+        toClientKey: string;
+        weight?: number | undefined;
+    }[];
+}, {
+    nodes: {
+        label: string;
+        nodeType: "Idea" | "Theme" | "Character" | "Location" | "Object" | "Conflict" | "Tone" | "Audience" | "Contribution" | "Comment" | "VoteSignal" | "Actor" | "VoiceArchetype" | "VisualArchetype" | "Trait" | "Flaw" | "Desire" | "SignatureObject" | "ColorPalette" | "CostumeElement" | "GenreFit" | "ActorAsset";
+        clientKey: string;
+        data?: Record<string, unknown> | undefined;
+    }[];
+    edges: {
+        relation: "SUPPORTED_BY" | "HAS_THEME" | "HAS_CHARACTER" | "HAS_LOCATION" | "HAS_OBJECT" | "HAS_CONFLICT" | "HAS_TONE" | "TARGETS_AUDIENCE" | "SUGGESTS" | "EXPANDS" | "VOTED_FOR" | "COMMENTED_ON" | "HAS_ROLE" | "HAS_VOICE" | "HAS_VISUAL_ARCHETYPE" | "HAS_TRAIT" | "HAS_FLAW" | "HAS_DESIRE" | "HAS_OBJECT_REL" | "USES_PALETTE" | "WEARS" | "FITS_GENRE" | "SUGGESTED_FOR_IDEA" | "SELECTED_FOR_PROJECT" | "HAS_ASSET";
+        fromClientKey: string;
+        toClientKey: string;
+        data?: Record<string, unknown> | undefined;
+        weight?: number | undefined;
+    }[];
+}>;
+export type CommunityMovieKGSeed = z.infer<typeof CommunityMovieKGSeedSchema>;

package/dist/schemas/community/community-movie-kg-seed.schema.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommunityMovieKGSeedSchema = exports.CommunityKgEdgeRelationSchema = exports.CommunityKgNodeTypeSchema = exports.COMMUNITY_KG_EDGE_RELATIONS = exports.COMMUNITY_KG_NODE_TYPES = void 0;
+const zod_1 = require("zod");
+/** Mirrors `community_kg_nodes.node_type` CHECK constraint (PascalCase). */
+exports.COMMUNITY_KG_NODE_TYPES = [
+    'Idea',
+    'Theme',
+    'Character',
+    'Location',
+    'Object',
+    'Conflict',
+    'Tone',
+    'Audience',
+    'Contribution',
+    'Comment',
+    'VoteSignal',
+    'Actor',
+    'VoiceArchetype',
+    'VisualArchetype',
+    'Trait',
+    'Flaw',
+    'Desire',
+    'SignatureObject',
+    'ColorPalette',
+    'CostumeElement',
+    'GenreFit',
+    'ActorAsset',
+];
+/** Mirrors `community_kg_edges.relation` CHECK constraint. */
+exports.COMMUNITY_KG_EDGE_RELATIONS = [
+    'HAS_THEME',
+    'HAS_CHARACTER',
+    'HAS_LOCATION',
+    'HAS_OBJECT',
+    'HAS_CONFLICT',
+    'HAS_TONE',
+    'TARGETS_AUDIENCE',
+    'SUPPORTED_BY',
+    'SUGGESTS',
+    'EXPANDS',
+    'VOTED_FOR',
+    'COMMENTED_ON',
+    'HAS_ROLE',
+    'HAS_VOICE',
+    'HAS_VISUAL_ARCHETYPE',
+    'HAS_TRAIT',
+    'HAS_FLAW',
+    'HAS_DESIRE',
+    'HAS_OBJECT_REL',
+    'USES_PALETTE',
+    'WEARS',
+    'FITS_GENRE',
+    'SUGGESTED_FOR_IDEA',
+    'SELECTED_FOR_PROJECT',
+    'HAS_ASSET',
+];
+exports.CommunityKgNodeTypeSchema = zod_1.z.enum(exports.COMMUNITY_KG_NODE_TYPES);
+exports.CommunityKgEdgeRelationSchema = zod_1.z.enum(exports.COMMUNITY_KG_EDGE_RELATIONS);
+exports.CommunityMovieKGSeedSchema = zod_1.z
+    .object({
+    nodes: zod_1.z
+        .array(zod_1.z
+        .object({
+        clientKey: zod_1.z.string().min(1).max(128),
+        nodeType: exports.CommunityKgNodeTypeSchema,
+        label: zod_1.z.string().min(1).max(512),
+        data: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).default({}),
+    })
+        .strict())
+        .max(256),
+    edges: zod_1.z
+        .array(zod_1.z
+        .object({
+        fromClientKey: zod_1.z.string().min(1).max(128),
+        toClientKey: zod_1.z.string().min(1).max(128),
+        relation: exports.CommunityKgEdgeRelationSchema,
+        weight: zod_1.z.number().finite().optional(),
+        data: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).default({}),
+    })
+        .strict())
+        .max(512),
+})
+    .strict();

package/dist/schemas/community/community-movie-stage-transitions.d.ts

@@ -0,0 +1,15 @@
+import type { CommunityIdeaStage } from '../../types/community-stage';
+/**
+ * Canonical stage transition map for Community Movie ideas.
+ * Used by transitionCommunityMovieStage() to validate allowed moves.
+ * No stage change is permitted unless the transition appears in this map.
+ *
+ * Constitutional ref: CM-8 (traceability) — transitions must be audited.
+ */
+export declare const COMMUNITY_MOVIE_STAGE_TRANSITIONS: Readonly<Record<CommunityIdeaStage, readonly CommunityIdeaStage[]>>;
+/**
+ * Returns true if the transition from `from` to `to` is allowed.
+ */
+export declare function isStageTransitionAllowed(from: CommunityIdeaStage, to: CommunityIdeaStage): boolean;
+/** Alias matching the import used in community.movie API routes. */
+export declare const isAllowedCommunityStageTransition: typeof isStageTransitionAllowed;

package/dist/schemas/community/community-movie-stage-transitions.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAllowedCommunityStageTransition = exports.COMMUNITY_MOVIE_STAGE_TRANSITIONS = void 0;
+exports.isStageTransitionAllowed = isStageTransitionAllowed;
+/**
+ * Canonical stage transition map for Community Movie ideas.
+ * Used by transitionCommunityMovieStage() to validate allowed moves.
+ * No stage change is permitted unless the transition appears in this map.
+ *
+ * Constitutional ref: CM-8 (traceability) — transitions must be audited.
+ */
+exports.COMMUNITY_MOVIE_STAGE_TRANSITIONS = {
+    draft_submission: ['moderation_review', 'archived'],
+    moderation_review: ['public_pitch', 'rejected', 'draft_submission'],
+    public_pitch: ['weekly_shortlist', 'archived'],
+    weekly_shortlist: ['monthly_top_10', 'public_pitch'],
+    monthly_top_10: ['development_room', 'public_pitch', 'archived'],
+    development_room: ['script_lab', 'archived'],
+    script_lab: ['trailer_lab', 'development_room'],
+    trailer_lab: ['production_candidate', 'script_lab'],
+    production_candidate: ['in_production', 'trailer_lab', 'archived'],
+    in_production: ['released', 'archived'],
+    released: ['archived'],
+    archived: [],
+    rejected: [],
+};
+/**
+ * Returns true if the transition from `from` to `to` is allowed.
+ */
+function isStageTransitionAllowed(from, to) {
+    const allowed = exports.COMMUNITY_MOVIE_STAGE_TRANSITIONS[from];
+    return allowed.includes(to);
+}
+/** Alias matching the import used in community.movie API routes. */
+exports.isAllowedCommunityStageTransition = isStageTransitionAllowed;

package/dist/schemas/community/community-movie-world-cta.schema.d.ts

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+export declare const CommunityMovieWorldCtaSchema: z.ZodObject<{
+    filmSlug: z.ZodString;
+    worldTitle: z.ZodString;
+    filmTitle: z.ZodString;
+    protagonist: z.ZodString;
+    storyCta: z.ZodString;
+    ideaPrompt: z.ZodString;
+    successCopy: z.ZodString;
+    tagline: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    filmSlug: string;
+    worldTitle: string;
+    filmTitle: string;
+    protagonist: string;
+    storyCta: string;
+    ideaPrompt: string;
+    successCopy: string;
+    tagline: string;
+}, {
+    filmSlug: string;
+    worldTitle: string;
+    filmTitle: string;
+    protagonist: string;
+    storyCta: string;
+    ideaPrompt: string;
+    successCopy: string;
+    tagline: string;
+}>;
+export type CommunityMovieWorldCta = z.infer<typeof CommunityMovieWorldCtaSchema>;
+export declare const COMMUNITY_MOVIE_WORLD_CTAS: {
+    readonly gearhaven: {
+        readonly filmSlug: "gearhaven";
+        readonly worldTitle: "Gearhaven";
+        readonly filmTitle: "Professor Vex and the Tomorrow Engine";
+        readonly protagonist: "Professor Aurelius Vex";
+        readonly storyCta: "Invent Tomorrow's Next Accident";
+        readonly ideaPrompt: "What should Professor Vex accidentally bring back from tomorrow next? Invent a machine, citizen, future accident, or impossible invention.";
+        readonly successCopy: "Your invention has been logged in Professor Vex's laboratory. This may have been unwise.";
+        readonly tagline: "Tomorrow is far too important to leave to geniuses.";
+    };
+    readonly 'mars-last-garden': {
+        readonly filmSlug: "mars-last-garden";
+        readonly worldTitle: "Mars: The Last Garden";
+        readonly filmTitle: "Mars: The Last Garden";
+        readonly protagonist: "Sol Reye and Bramble-9";
+        readonly storyCta: "Plant Something Impossible";
+        readonly ideaPrompt: "What should Sol Reye and Bramble-9 discover next on Mars? Create a Martian plant, helper robot, hidden greenhouse room, lost seed vault, or old message from the Bloom project.";
+        readonly successCopy: "Your idea has been planted in the Mars story garden.";
+        readonly tagline: "A seed kept safe remains a seed. A seed planted becomes a world.";
+    };
+    readonly 'madame-pickwick': {
+        readonly filmSlug: "madame-pickwick";
+        readonly worldTitle: "Picklewick Manor";
+        readonly filmTitle: "Madame Picklewick's Monster Hotel";
+        readonly protagonist: "Madame Prudence Picklewick";
+        readonly storyCta: "Create a Monster Guest";
+        readonly ideaPrompt: "What monster should check into Picklewick Manor next? Give them a name, a habit, a breakfast preference, an embarrassing weakness, and one deeply inconvenient room requirement.";
+        readonly successCopy: "Your guest has been added to the Picklewick Manor reservation book. Madame is already displeased.";
+        readonly tagline: "Create a monster. Check it in. Madame will cope.";
+    };
+    readonly 'aves-de-venecia': {
+        readonly filmSlug: "aves-de-venecia";
+        readonly worldTitle: "Aves de Venecia";
+        readonly filmTitle: "Aves de Venecia";
+        readonly protagonist: "Mateo Arango";
+        readonly storyCta: "Create a Bird for Mateo";
+        readonly ideaPrompt: "What bird should Mateo meet next in the mountains of Venecia? Give it a name, a call, a personality, and the lesson it teaches him about the sky.";
+        readonly successCopy: "Your bird has joined Mateo's sky.";
+        readonly tagline: "The birds were waiting in the wind.";
+    };
+};
+export declare function getCommunityMovieWorldCta(slugOrAlias: string): CommunityMovieWorldCta;
+/** Maps marketing aliases and film slugs to `community_challenges.slug` when a world CTA exists. */
+export declare function canonicalCommunityMovieChallengeSlug(slugOrAlias: string): string;

package/dist/schemas/community/community-movie-world-cta.schema.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMUNITY_MOVIE_WORLD_CTAS = exports.CommunityMovieWorldCtaSchema = void 0;
+exports.getCommunityMovieWorldCta = getCommunityMovieWorldCta;
+exports.canonicalCommunityMovieChallengeSlug = canonicalCommunityMovieChallengeSlug;
+const zod_1 = require("zod");
+exports.CommunityMovieWorldCtaSchema = zod_1.z
+    .object({
+    filmSlug: zod_1.z.string().min(1),
+    worldTitle: zod_1.z.string().min(1),
+    filmTitle: zod_1.z.string().min(1),
+    protagonist: zod_1.z.string().min(1),
+    storyCta: zod_1.z.string().min(1),
+    ideaPrompt: zod_1.z.string().min(1),
+    successCopy: zod_1.z.string().min(1),
+    tagline: zod_1.z.string().min(1),
+})
+    .strict();
+exports.COMMUNITY_MOVIE_WORLD_CTAS = {
+    gearhaven: {
+        filmSlug: 'gearhaven',
+        worldTitle: 'Gearhaven',
+        filmTitle: 'Professor Vex and the Tomorrow Engine',
+        protagonist: 'Professor Aurelius Vex',
+        storyCta: "Invent Tomorrow's Next Accident",
+        ideaPrompt: 'What should Professor Vex accidentally bring back from tomorrow next? Invent a machine, citizen, future accident, or impossible invention.',
+        successCopy: "Your invention has been logged in Professor Vex's laboratory. This may have been unwise.",
+        tagline: 'Tomorrow is far too important to leave to geniuses.',
+    },
+    'mars-last-garden': {
+        filmSlug: 'mars-last-garden',
+        worldTitle: 'Mars: The Last Garden',
+        filmTitle: 'Mars: The Last Garden',
+        protagonist: 'Sol Reye and Bramble-9',
+        storyCta: 'Plant Something Impossible',
+        ideaPrompt: 'What should Sol Reye and Bramble-9 discover next on Mars? Create a Martian plant, helper robot, hidden greenhouse room, lost seed vault, or old message from the Bloom project.',
+        successCopy: 'Your idea has been planted in the Mars story garden.',
+        tagline: 'A seed kept safe remains a seed. A seed planted becomes a world.',
+    },
+    'madame-pickwick': {
+        filmSlug: 'madame-pickwick',
+        worldTitle: 'Picklewick Manor',
+        filmTitle: "Madame Picklewick's Monster Hotel",
+        protagonist: 'Madame Prudence Picklewick',
+        storyCta: 'Create a Monster Guest',
+        ideaPrompt: 'What monster should check into Picklewick Manor next? Give them a name, a habit, a breakfast preference, an embarrassing weakness, and one deeply inconvenient room requirement.',
+        successCopy: 'Your guest has been added to the Picklewick Manor reservation book. Madame is already displeased.',
+        tagline: 'Create a monster. Check it in. Madame will cope.',
+    },
+    'aves-de-venecia': {
+        filmSlug: 'aves-de-venecia',
+        worldTitle: 'Aves de Venecia',
+        filmTitle: 'Aves de Venecia',
+        protagonist: 'Mateo Arango',
+        storyCta: 'Create a Bird for Mateo',
+        ideaPrompt: 'What bird should Mateo meet next in the mountains of Venecia? Give it a name, a call, a personality, and the lesson it teaches him about the sky.',
+        successCopy: "Your bird has joined Mateo's sky.",
+        tagline: 'The birds were waiting in the wind.',
+    },
+};
+const COMMUNITY_MOVIE_WORLD_CTA_ALIASES = {
+    'professor-vex': 'gearhaven',
+    'mars-the-last-garden': 'mars-last-garden',
+    'picklewick-manor': 'madame-pickwick',
+};
+function getCommunityMovieWorldCta(slugOrAlias) {
+    const key = slugOrAlias.trim();
+    const canonicalKey = (COMMUNITY_MOVIE_WORLD_CTA_ALIASES[key] ?? key);
+    const entry = exports.COMMUNITY_MOVIE_WORLD_CTAS[canonicalKey];
+    if (!entry) {
+        throw new Error(`unknown_community_movie_world_cta:${key}`);
+    }
+    return exports.CommunityMovieWorldCtaSchema.parse(entry);
+}
+/** Maps marketing aliases and film slugs to `community_challenges.slug` when a world CTA exists. */
+function canonicalCommunityMovieChallengeSlug(slugOrAlias) {
+    try {
+        return getCommunityMovieWorldCta(slugOrAlias).filmSlug;
+    }
+    catch {
+        return slugOrAlias.trim();
+    }
+}

package/dist/schemas/community/community-partner-offers.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+/** Canonical partner slugs for co-marketing landing pages. */
+export declare const CommunityPartnerSlugSchema: z.ZodEnum<["exploretalent"]>;
+export type CommunityPartnerSlug = z.infer<typeof CommunityPartnerSlugSchema>;
+export type CommunityPartnerOffer = {
+    readonly slug: CommunityPartnerSlug;
+    readonly displayName: string;
+    readonly signupBonusCredits: number;
+    readonly paidTrialDays: number;
+};
+export declare const COMMUNITY_PARTNER_OFFERS: Record<CommunityPartnerSlug, CommunityPartnerOffer>;
+export declare function isCommunityPartnerSlug(value: string): value is CommunityPartnerSlug;
+export declare function getCommunityPartnerOffer(slug: CommunityPartnerSlug): CommunityPartnerOffer;

package/dist/schemas/community/community-partner-offers.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMUNITY_PARTNER_OFFERS = exports.CommunityPartnerSlugSchema = void 0;
+exports.isCommunityPartnerSlug = isCommunityPartnerSlug;
+exports.getCommunityPartnerOffer = getCommunityPartnerOffer;
+const zod_1 = require("zod");
+/** Canonical partner slugs for co-marketing landing pages. */
+exports.CommunityPartnerSlugSchema = zod_1.z.enum(['exploretalent']);
+exports.COMMUNITY_PARTNER_OFFERS = {
+    exploretalent: {
+        slug: 'exploretalent',
+        displayName: 'ExploreTalent',
+        signupBonusCredits: 100,
+        paidTrialDays: 90,
+    },
+};
+function isCommunityPartnerSlug(value) {
+    return exports.CommunityPartnerSlugSchema.safeParse(value).success;
+}
+function getCommunityPartnerOffer(slug) {
+    return exports.COMMUNITY_PARTNER_OFFERS[slug];
+}