@neuraloom/contracts 0.0.0-stage → 0.1.23

package/dist/schemas/community/community-stage-transition.schema.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommunityStageTransitionSchema = void 0;
+const zod_1 = require("zod");
+const community_stage_1 = require("../../types/community-stage");
+exports.CommunityStageTransitionSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().uuid(),
+    ideaId: zod_1.z.string().uuid(),
+    fromStage: zod_1.z.enum(community_stage_1.COMMUNITY_IDEA_STAGES).nullable(),
+    toStage: zod_1.z.enum(community_stage_1.COMMUNITY_IDEA_STAGES),
+    reason: zod_1.z.string().optional(),
+    createdBy: zod_1.z.string().uuid(),
+    workflowRunId: zod_1.z.string().uuid().nullable(),
+    createdAt: zod_1.z.string().datetime(),
+    updatedAt: zod_1.z.string().datetime(),
+})
+    .strict();

package/dist/schemas/community/community-suggestion.schema.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+export declare const COMMUNITY_SUGGESTION_KINDS: readonly ["character", "scene", "legend", "other"];
+export declare const COMMUNITY_SUGGESTION_STATUSES: readonly ["pending", "accepted", "rejected"];
+export declare const CommunitySuggestionSchema: z.ZodObject<{
+    id: z.ZodString;
+    ideaId: z.ZodString;
+    userId: z.ZodString;
+    kind: z.ZodEnum<["character", "scene", "legend", "other"]>;
+    body: z.ZodString;
+    status: z.ZodEnum<["pending", "accepted", "rejected"]>;
+    editorialNote: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    status: "pending" | "accepted" | "rejected";
+    createdAt: string;
+    kind: "scene" | "other" | "character" | "legend";
+    updatedAt: string;
+    userId: string;
+    body: string;
+    ideaId: string;
+    editorialNote: string | null;
+}, {
+    id: string;
+    status: "pending" | "accepted" | "rejected";
+    createdAt: string;
+    kind: "scene" | "other" | "character" | "legend";
+    updatedAt: string;
+    userId: string;
+    body: string;
+    ideaId: string;
+    editorialNote: string | null;
+}>;
+export type CommunitySuggestion = z.infer<typeof CommunitySuggestionSchema>;

package/dist/schemas/community/community-suggestion.schema.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommunitySuggestionSchema = exports.COMMUNITY_SUGGESTION_STATUSES = exports.COMMUNITY_SUGGESTION_KINDS = void 0;
+const zod_1 = require("zod");
+exports.COMMUNITY_SUGGESTION_KINDS = [
+    'character',
+    'scene',
+    'legend',
+    'other',
+];
+exports.COMMUNITY_SUGGESTION_STATUSES = ['pending', 'accepted', 'rejected'];
+exports.CommunitySuggestionSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().uuid(),
+    ideaId: zod_1.z.string().uuid(),
+    userId: zod_1.z.string().uuid(),
+    kind: zod_1.z.enum(exports.COMMUNITY_SUGGESTION_KINDS),
+    body: zod_1.z.string().min(1),
+    status: zod_1.z.enum(exports.COMMUNITY_SUGGESTION_STATUSES),
+    editorialNote: zod_1.z.string().nullable(),
+    createdAt: zod_1.z.string().datetime(),
+    updatedAt: zod_1.z.string().datetime(),
+})
+    .strict();

package/dist/schemas/community/community-vote.schema.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export declare const CommunityVoteSchema: z.ZodObject<{
+    id: z.ZodString;
+    ideaId: z.ZodString;
+    userId: z.ZodString;
+    weight: z.ZodDefault<z.ZodNumber>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    createdAt: string;
+    weight: number;
+    updatedAt: string;
+    userId: string;
+    ideaId: string;
+}, {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    userId: string;
+    ideaId: string;
+    weight?: number | undefined;
+}>;
+export type CommunityVote = z.infer<typeof CommunityVoteSchema>;

package/dist/schemas/community/community-vote.schema.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommunityVoteSchema = void 0;
+const zod_1 = require("zod");
+exports.CommunityVoteSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().uuid(),
+    ideaId: zod_1.z.string().uuid(),
+    userId: zod_1.z.string().uuid(),
+    weight: zod_1.z.number().int().positive().default(1),
+    createdAt: zod_1.z.string().datetime(),
+    updatedAt: zod_1.z.string().datetime(),
+})
+    .strict();

package/dist/schemas/community/community-waitlist.schema.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export declare const CommunityWaitlistInsertSchema: z.ZodObject<{
+    email: z.ZodString;
+    source: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    email: string;
+    source?: string | undefined;
+}, {
+    email: string;
+    source?: string | undefined;
+}>;
+export type CommunityWaitlistInsert = z.infer<typeof CommunityWaitlistInsertSchema>;

package/dist/schemas/community/community-waitlist.schema.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommunityWaitlistInsertSchema = void 0;
+const zod_1 = require("zod");
+exports.CommunityWaitlistInsertSchema = zod_1.z
+    .object({
+    email: zod_1.z.string().email(),
+    source: zod_1.z.string().max(120).optional(),
+})
+    .strict();

package/dist/schemas/community/community-world-contribution.schema.d.ts

@@ -0,0 +1,102 @@
+import { z } from 'zod';
+/** Canonical contribution taxonomy for community.world rows (matches DB CHECK). */
+export declare const CommunityWorldContributionTypeSchema: z.ZodEnum<["lore", "scene", "character_concept", "location", "object", "rule", "mythology"]>;
+export type CommunityWorldContributionType = z.infer<typeof CommunityWorldContributionTypeSchema>;
+export declare const CommunityWorldContributionModerationStatusSchema: z.ZodEnum<["pending", "approved", "rejected"]>;
+export type CommunityWorldContributionModerationStatus = z.infer<typeof CommunityWorldContributionModerationStatusSchema>;
+export declare const CommunityWorldContributionPublicRowSchema: z.ZodObject<{
+    id: z.ZodString;
+    contribution_type: z.ZodEnum<["lore", "scene", "character_concept", "location", "object", "rule", "mythology"]>;
+    title: z.ZodString;
+    body: z.ZodString;
+    vote_score: z.ZodNumber;
+    created_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    created_at: string;
+    body: string;
+    contribution_type: "object" | "scene" | "location" | "rule" | "character_concept" | "lore" | "mythology";
+    vote_score: number;
+}, {
+    id: string;
+    title: string;
+    created_at: string;
+    body: string;
+    contribution_type: "object" | "scene" | "location" | "rule" | "character_concept" | "lore" | "mythology";
+    vote_score: number;
+}>;
+export type CommunityWorldContributionPublicRow = z.infer<typeof CommunityWorldContributionPublicRowSchema>;
+export declare const CommunityWorldContributionMineRowSchema: z.ZodObject<{
+    id: z.ZodString;
+    film_slug: z.ZodString;
+    contribution_type: z.ZodEnum<["lore", "scene", "character_concept", "location", "object", "rule", "mythology"]>;
+    title: z.ZodString;
+    moderation_status: z.ZodEnum<["pending", "approved", "rejected"]>;
+    created_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    created_at: string;
+    film_slug: string;
+    contribution_type: "object" | "scene" | "location" | "rule" | "character_concept" | "lore" | "mythology";
+    moderation_status: "pending" | "rejected" | "approved";
+}, {
+    id: string;
+    title: string;
+    created_at: string;
+    film_slug: string;
+    contribution_type: "object" | "scene" | "location" | "rule" | "character_concept" | "lore" | "mythology";
+    moderation_status: "pending" | "rejected" | "approved";
+}>;
+export type CommunityWorldContributionMineRow = z.infer<typeof CommunityWorldContributionMineRowSchema>;
+export declare const CommunityWorldSubmissionSelectOptionSchema: z.ZodObject<{
+    filmSlug: z.ZodString;
+    challengeTitle: z.ZodString;
+    posterUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    filmSlug: string;
+    challengeTitle: string;
+    posterUrl?: string | null | undefined;
+}, {
+    filmSlug: string;
+    challengeTitle: string;
+    posterUrl?: string | null | undefined;
+}>;
+export type CommunityWorldSubmissionSelectOption = z.infer<typeof CommunityWorldSubmissionSelectOptionSchema>;
+export declare const COMMUNITY_WORLD_CONTRIBUTION_TYPE_LABELS: Record<CommunityWorldContributionType, string>;
+export declare function communityWorldFilmSlugForChallengeSlug(challengeSlug: string): string;
+export declare function communityChallengeSlugForWorldFilmSlug(filmSlug: string): string;
+export declare const CommunityWorldContributeRequestSchema: z.ZodObject<{
+    film_slug: z.ZodString;
+    contribution_type: z.ZodEnum<["lore", "scene", "character_concept", "location", "object", "rule", "mythology"]>;
+    title: z.ZodString;
+    body: z.ZodString;
+    image_url: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, unknown>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    body: string;
+    film_slug: string;
+    contribution_type: "object" | "scene" | "location" | "rule" | "character_concept" | "lore" | "mythology";
+    image_url?: string | undefined;
+}, {
+    title: string;
+    body: string;
+    film_slug: string;
+    contribution_type: "object" | "scene" | "location" | "rule" | "character_concept" | "lore" | "mythology";
+    image_url?: unknown;
+}>;
+export declare const CommunityWorldContributeResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    film_slug: z.ZodString;
+    contribution_type: z.ZodEnum<["lore", "scene", "character_concept", "location", "object", "rule", "mythology"]>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    film_slug: string;
+    contribution_type: "object" | "scene" | "location" | "rule" | "character_concept" | "lore" | "mythology";
+}, {
+    id: string;
+    film_slug: string;
+    contribution_type: "object" | "scene" | "location" | "rule" | "character_concept" | "lore" | "mythology";
+}>;
+export type CommunityWorldContributeResponse = z.infer<typeof CommunityWorldContributeResponseSchema>;

package/dist/schemas/community/community-world-contribution.schema.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommunityWorldContributeResponseSchema = exports.CommunityWorldContributeRequestSchema = exports.COMMUNITY_WORLD_CONTRIBUTION_TYPE_LABELS = exports.CommunityWorldSubmissionSelectOptionSchema = exports.CommunityWorldContributionMineRowSchema = exports.CommunityWorldContributionPublicRowSchema = exports.CommunityWorldContributionModerationStatusSchema = exports.CommunityWorldContributionTypeSchema = void 0;
+exports.communityWorldFilmSlugForChallengeSlug = communityWorldFilmSlugForChallengeSlug;
+exports.communityChallengeSlugForWorldFilmSlug = communityChallengeSlugForWorldFilmSlug;
+const zod_1 = require("zod");
+/** Canonical contribution taxonomy for community.world rows (matches DB CHECK). */
+exports.CommunityWorldContributionTypeSchema = zod_1.z.enum([
+    'lore',
+    'scene',
+    'character_concept',
+    'location',
+    'object',
+    'rule',
+    'mythology',
+]);
+exports.CommunityWorldContributionModerationStatusSchema = zod_1.z.enum([
+    'pending',
+    'approved',
+    'rejected',
+]);
+exports.CommunityWorldContributionPublicRowSchema = zod_1.z.object({
+    id: zod_1.z.string().uuid(),
+    contribution_type: exports.CommunityWorldContributionTypeSchema,
+    title: zod_1.z.string(),
+    body: zod_1.z.string(),
+    vote_score: zod_1.z.number(),
+    created_at: zod_1.z.string(),
+});
+exports.CommunityWorldContributionMineRowSchema = zod_1.z.object({
+    id: zod_1.z.string().uuid(),
+    film_slug: zod_1.z.string(),
+    contribution_type: exports.CommunityWorldContributionTypeSchema,
+    title: zod_1.z.string(),
+    moderation_status: exports.CommunityWorldContributionModerationStatusSchema,
+    created_at: zod_1.z.string(),
+});
+exports.CommunityWorldSubmissionSelectOptionSchema = zod_1.z.object({
+    filmSlug: zod_1.z.string(),
+    challengeTitle: zod_1.z.string(),
+    posterUrl: zod_1.z.string().nullable().optional(),
+});
+exports.COMMUNITY_WORLD_CONTRIBUTION_TYPE_LABELS = {
+    lore: 'Lore',
+    scene: 'Scene',
+    character_concept: 'Character concept',
+    location: 'Location',
+    object: 'Object',
+    rule: 'Rule',
+    mythology: 'Mythology',
+};
+/** live community_challenges.slug → hub film_slug (`community_film_worlds`). */
+const CHALLENGE_SLUG_TO_FILM_SLUG = {
+    gearhaven: 'gearhaven',
+    aokujima: 'aokujima',
+    'aves-de-venecia': 'aves-de-venecia',
+    'mars-last-garden': 'mars-last-garden',
+    'madame-pickwick': 'picklewick-manor',
+};
+function communityWorldFilmSlugForChallengeSlug(challengeSlug) {
+    const k = challengeSlug.trim();
+    const mapped = CHALLENGE_SLUG_TO_FILM_SLUG[k];
+    if (typeof mapped === 'string')
+        return mapped;
+    return k;
+}
+function communityChallengeSlugForWorldFilmSlug(filmSlug) {
+    switch (filmSlug.trim()) {
+        case 'picklewick-manor':
+            return 'madame-pickwick';
+        default:
+            return filmSlug.trim();
+    }
+}
+exports.CommunityWorldContributeRequestSchema = zod_1.z.object({
+    film_slug: zod_1.z.string().min(1),
+    contribution_type: exports.CommunityWorldContributionTypeSchema,
+    title: zod_1.z.string(),
+    body: zod_1.z.string(),
+    image_url: zod_1.z.preprocess((v) => (v === '' ? undefined : v), zod_1.z.string().url().optional()),
+});
+exports.CommunityWorldContributeResponseSchema = zod_1.z.object({
+    id: zod_1.z.string().uuid(),
+    film_slug: zod_1.z.string(),
+    contribution_type: exports.CommunityWorldContributionTypeSchema,
+});

package/dist/schemas/community/credit-disclosure-variant.schema.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+/** Variant for {@link CreditDisclosure} marketing/legal surfaces (community.movie). */
+export declare const CreditDisclosureVariantSchema: z.ZodEnum<["short", "full"]>;
+export type CreditDisclosureVariant = z.infer<typeof CreditDisclosureVariantSchema>;

package/dist/schemas/community/credit-disclosure-variant.schema.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditDisclosureVariantSchema = void 0;
+const zod_1 = require("zod");
+/** Variant for {@link CreditDisclosure} marketing/legal surfaces (community.movie). */
+exports.CreditDisclosureVariantSchema = zod_1.z.enum(['short', 'full']);

package/dist/schemas/community/index.d.ts

@@ -0,0 +1,56 @@
+export * from './community-ad-capi.schema';
+export * from './credit-disclosure-variant.schema';
+export * from './community-actor-universe-vote.schema';
+export * from './community-billing-checkout.schema';
+export * from './community-membership-monthly-credits';
+export * from './community-challenge.schema';
+export * from './community-movie-world-cta.schema';
+export * from './community-movie-actor-blueprint.schema';
+export * from './community-movie-actor-card.schema';
+export * from './community-movie-actor-create-request.schema';
+export * from './community-movie-actor-create-response.schema';
+export * from './community-movie-actor-gate-result.schema';
+export * from './community-movie-actor-image-prompt-pack.schema';
+export * from './community-movie-actor-kg-seed.schema';
+export * from './community-movie-actor-option-selection.schema';
+export * from './community-movie-actor-portrait-url.schema';
+export * from './community-movie-canonical-character.schema';
+export * from './community-movie-gallery.schema';
+export * from './community-film-world-marketing.schema';
+export * from './community-content-translation.schema';
+export * from './community-film.schema';
+export * from './community-film-playback.schema';
+export * from './community-film-video-variant.schema';
+export * from './community-locale.schema';
+export * from './community-movie-world-cta.schema';
+export * from './community-world-contribution.schema';
+export * from './community-movie-actor-vote-response.schema';
+export * from './community-movie-gate-result.schema';
+export * from './community-movie-idea-card.schema';
+export * from './community-movie-idea-input.schema';
+export * from './community-movie-idea-structured.schema';
+export * from './community-movie-kg-seed.schema';
+export * from './community-idea.schema';
+export * from './community-idea-promote.schema';
+export * from './community-idea-submission.schema';
+export * from './community-actor-comment-body.schema';
+export * from './community-vote.schema';
+export * from './community-credit-transaction.schema';
+export * from './community-membership.schema';
+export * from './community-suggestion.schema';
+export * from './community-stage-transition.schema';
+export * from './community-slate.schema';
+export * from './community-development-room.schema';
+export * from './community-poll.schema';
+export * from './community-development-input.schema';
+export * from './community-moderation-flag.schema';
+export * from './community-waitlist.schema';
+export * from './community-signup-intake.schema';
+export * from './community-signup-intake.constants';
+export * from './community-idea-version.schema';
+export * from './community-movie-stage-transitions';
+export * from './community-production-operator.schema';
+export * from './community-referral.schema';
+export * from './community-partner-offers';
+export * from './community-partner.schema';
+export * from './community-email.schema';

package/dist/schemas/community/index.js

@@ -0,0 +1,72 @@
+"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-ad-capi.schema"), exports);
+__exportStar(require("./credit-disclosure-variant.schema"), exports);
+__exportStar(require("./community-actor-universe-vote.schema"), exports);
+__exportStar(require("./community-billing-checkout.schema"), exports);
+__exportStar(require("./community-membership-monthly-credits"), exports);
+__exportStar(require("./community-challenge.schema"), exports);
+__exportStar(require("./community-movie-world-cta.schema"), exports);
+__exportStar(require("./community-movie-actor-blueprint.schema"), exports);
+__exportStar(require("./community-movie-actor-card.schema"), exports);
+__exportStar(require("./community-movie-actor-create-request.schema"), exports);
+__exportStar(require("./community-movie-actor-create-response.schema"), exports);
+__exportStar(require("./community-movie-actor-gate-result.schema"), exports);
+__exportStar(require("./community-movie-actor-image-prompt-pack.schema"), exports);
+__exportStar(require("./community-movie-actor-kg-seed.schema"), exports);
+__exportStar(require("./community-movie-actor-option-selection.schema"), exports);
+__exportStar(require("./community-movie-actor-portrait-url.schema"), exports);
+__exportStar(require("./community-movie-canonical-character.schema"), exports);
+__exportStar(require("./community-movie-gallery.schema"), exports);
+__exportStar(require("./community-film-world-marketing.schema"), exports);
+__exportStar(require("./community-content-translation.schema"), exports);
+__exportStar(require("./community-film.schema"), exports);
+__exportStar(require("./community-film-playback.schema"), exports);
+__exportStar(require("./community-film-video-variant.schema"), exports);
+__exportStar(require("./community-locale.schema"), exports);
+__exportStar(require("./community-movie-world-cta.schema"), exports);
+__exportStar(require("./community-world-contribution.schema"), exports);
+__exportStar(require("./community-movie-actor-vote-response.schema"), exports);
+__exportStar(require("./community-movie-gate-result.schema"), exports);
+__exportStar(require("./community-movie-idea-card.schema"), exports);
+__exportStar(require("./community-movie-idea-input.schema"), exports);
+__exportStar(require("./community-movie-idea-structured.schema"), exports);
+__exportStar(require("./community-movie-kg-seed.schema"), exports);
+__exportStar(require("./community-idea.schema"), exports);
+__exportStar(require("./community-idea-promote.schema"), exports);
+__exportStar(require("./community-idea-submission.schema"), exports);
+__exportStar(require("./community-actor-comment-body.schema"), exports);
+__exportStar(require("./community-vote.schema"), exports);
+__exportStar(require("./community-credit-transaction.schema"), exports);
+__exportStar(require("./community-membership.schema"), exports);
+__exportStar(require("./community-suggestion.schema"), exports);
+__exportStar(require("./community-stage-transition.schema"), exports);
+__exportStar(require("./community-slate.schema"), exports);
+__exportStar(require("./community-development-room.schema"), exports);
+__exportStar(require("./community-poll.schema"), exports);
+__exportStar(require("./community-development-input.schema"), exports);
+__exportStar(require("./community-moderation-flag.schema"), exports);
+__exportStar(require("./community-waitlist.schema"), exports);
+__exportStar(require("./community-signup-intake.schema"), exports);
+__exportStar(require("./community-signup-intake.constants"), exports);
+__exportStar(require("./community-idea-version.schema"), exports);
+__exportStar(require("./community-movie-stage-transitions"), exports);
+__exportStar(require("./community-production-operator.schema"), exports);
+__exportStar(require("./community-referral.schema"), exports);
+__exportStar(require("./community-partner-offers"), exports);
+__exportStar(require("./community-partner.schema"), exports);
+__exportStar(require("./community-email.schema"), exports);

package/dist/schemas/cortex/bridge-envelope.schema.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Cortex × NeuraLoom bridge envelope — shared on every cross-app event (v1.0.0).
+ * Constitutional: types owned by @neuraloom/contracts only.
+ */
+import { z } from 'zod';
+export declare const CORTEX_BRIDGE_ENVELOPE_VERSION: "1.0.0";
+export declare const BridgeSourceSystemSchema: z.ZodEnum<["neuraloom", "cortex"]>;
+export type BridgeSourceSystem = z.infer<typeof BridgeSourceSystemSchema>;
+export declare const BridgeEventTypeSchema: z.ZodEnum<["GitHubReadRequest", "GitHubReadResult", "CodexExecutorRuntimeRequest", "CodexExecutorRuntimeResult", "CodexExecutorWorkflowRequest", "CodexExecutorWorkflowResult", "CodexExecutorAuthorizationRequest", "CodexExecutorAuthorizationResult", "RepoIntelligenceRequest", "RepoIntelligenceResult", "RepoFindingTask", "ImplementationPlanReady", "PullRequestReady", "ProofRunRecorded", "EngineeringCheckpointRecorded", "RenderProofRecorded", "GuardianViolationEvent", "CreativeWorkflowRequest", "CreativeWorkflowResult", "DocDraftReady", "DocDriftDetected", "PortfolioRepoLink", "TaskGithubIssueRequest", "ProductReleasePackageMvp", "FilmProductionPlanReady", "FilmCutReady", "CortexIngestionReceipt", "NeuraloomIngestionReceipt"]>;
+export type BridgeEventType = z.infer<typeof BridgeEventTypeSchema>;
+export declare const BridgeEnvelopeFieldsSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0.0">;
+    eventId: z.ZodString;
+    eventType: z.ZodEnum<["GitHubReadRequest", "GitHubReadResult", "CodexExecutorRuntimeRequest", "CodexExecutorRuntimeResult", "CodexExecutorWorkflowRequest", "CodexExecutorWorkflowResult", "CodexExecutorAuthorizationRequest", "CodexExecutorAuthorizationResult", "RepoIntelligenceRequest", "RepoIntelligenceResult", "RepoFindingTask", "ImplementationPlanReady", "PullRequestReady", "ProofRunRecorded", "EngineeringCheckpointRecorded", "RenderProofRecorded", "GuardianViolationEvent", "CreativeWorkflowRequest", "CreativeWorkflowResult", "DocDraftReady", "DocDriftDetected", "PortfolioRepoLink", "TaskGithubIssueRequest", "ProductReleasePackageMvp", "FilmProductionPlanReady", "FilmCutReady", "CortexIngestionReceipt", "NeuraloomIngestionReceipt"]>;
+    idempotencyKey: z.ZodString;
+    sourceSystem: z.ZodEnum<["neuraloom", "cortex"]>;
+    createdAt: z.ZodString;
+    brandSlug: z.ZodString;
+    productSlug: z.ZodOptional<z.ZodString>;
+    repoFullName: z.ZodOptional<z.ZodString>;
+    neuraloomProjectId: z.ZodOptional<z.ZodString>;
+    commitSha: z.ZodOptional<z.ZodString>;
+    payloadHash: z.ZodString;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: "1.0.0";
+    createdAt: string;
+    payload: Record<string, unknown>;
+    eventType: "GitHubReadRequest" | "GitHubReadResult" | "CodexExecutorRuntimeRequest" | "CodexExecutorRuntimeResult" | "CodexExecutorWorkflowRequest" | "CodexExecutorWorkflowResult" | "CodexExecutorAuthorizationRequest" | "CodexExecutorAuthorizationResult" | "RepoIntelligenceRequest" | "RepoIntelligenceResult" | "RepoFindingTask" | "ImplementationPlanReady" | "PullRequestReady" | "ProofRunRecorded" | "EngineeringCheckpointRecorded" | "RenderProofRecorded" | "GuardianViolationEvent" | "CreativeWorkflowRequest" | "CreativeWorkflowResult" | "DocDraftReady" | "DocDriftDetected" | "PortfolioRepoLink" | "TaskGithubIssueRequest" | "ProductReleasePackageMvp" | "FilmProductionPlanReady" | "FilmCutReady" | "CortexIngestionReceipt" | "NeuraloomIngestionReceipt";
+    brandSlug: string;
+    idempotencyKey: string;
+    eventId: string;
+    sourceSystem: "neuraloom" | "cortex";
+    payloadHash: string;
+    commitSha?: string | undefined;
+    neuraloomProjectId?: string | undefined;
+    repoFullName?: string | undefined;
+    productSlug?: string | undefined;
+}, {
+    schemaVersion: "1.0.0";
+    createdAt: string;
+    payload: Record<string, unknown>;
+    eventType: "GitHubReadRequest" | "GitHubReadResult" | "CodexExecutorRuntimeRequest" | "CodexExecutorRuntimeResult" | "CodexExecutorWorkflowRequest" | "CodexExecutorWorkflowResult" | "CodexExecutorAuthorizationRequest" | "CodexExecutorAuthorizationResult" | "RepoIntelligenceRequest" | "RepoIntelligenceResult" | "RepoFindingTask" | "ImplementationPlanReady" | "PullRequestReady" | "ProofRunRecorded" | "EngineeringCheckpointRecorded" | "RenderProofRecorded" | "GuardianViolationEvent" | "CreativeWorkflowRequest" | "CreativeWorkflowResult" | "DocDraftReady" | "DocDriftDetected" | "PortfolioRepoLink" | "TaskGithubIssueRequest" | "ProductReleasePackageMvp" | "FilmProductionPlanReady" | "FilmCutReady" | "CortexIngestionReceipt" | "NeuraloomIngestionReceipt";
+    brandSlug: string;
+    idempotencyKey: string;
+    eventId: string;
+    sourceSystem: "neuraloom" | "cortex";
+    payloadHash: string;
+    commitSha?: string | undefined;
+    neuraloomProjectId?: string | undefined;
+    repoFullName?: string | undefined;
+    productSlug?: string | undefined;
+}>;
+export type BridgeEnvelopeFields = z.infer<typeof BridgeEnvelopeFieldsSchema>;
+export declare function createBridgeEnvelope<TPayload extends Record<string, unknown>>(args: {
+    eventId: string;
+    eventType: BridgeEventType;
+    idempotencyKey: string;
+    sourceSystem: BridgeSourceSystem;
+    createdAt: string;
+    brandSlug: string;
+    payloadHash: string;
+    payload: TPayload;
+    productSlug?: string;
+    repoFullName?: string;
+    neuraloomProjectId?: string;
+    commitSha?: string;
+}): BridgeEnvelopeFields & {
+    payload: TPayload;
+};

package/dist/schemas/cortex/bridge-envelope.schema.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * Cortex × NeuraLoom bridge envelope — shared on every cross-app event (v1.0.0).
+ * Constitutional: types owned by @neuraloom/contracts only.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BridgeEnvelopeFieldsSchema = exports.BridgeEventTypeSchema = exports.BridgeSourceSystemSchema = exports.CORTEX_BRIDGE_ENVELOPE_VERSION = void 0;
+exports.createBridgeEnvelope = createBridgeEnvelope;
+const zod_1 = require("zod");
+exports.CORTEX_BRIDGE_ENVELOPE_VERSION = '1.0.0';
+exports.BridgeSourceSystemSchema = zod_1.z.enum(['neuraloom', 'cortex']);
+exports.BridgeEventTypeSchema = zod_1.z.enum([
+    'GitHubReadRequest',
+    'GitHubReadResult',
+    'CodexExecutorRuntimeRequest',
+    'CodexExecutorRuntimeResult',
+    'CodexExecutorWorkflowRequest',
+    'CodexExecutorWorkflowResult',
+    'CodexExecutorAuthorizationRequest',
+    'CodexExecutorAuthorizationResult',
+    'RepoIntelligenceRequest',
+    'RepoIntelligenceResult',
+    'RepoFindingTask',
+    'ImplementationPlanReady',
+    'PullRequestReady',
+    'ProofRunRecorded',
+    'EngineeringCheckpointRecorded',
+    'RenderProofRecorded',
+    'GuardianViolationEvent',
+    'CreativeWorkflowRequest',
+    'CreativeWorkflowResult',
+    'DocDraftReady',
+    'DocDriftDetected',
+    'PortfolioRepoLink',
+    'TaskGithubIssueRequest',
+    'ProductReleasePackageMvp',
+    'FilmProductionPlanReady',
+    'FilmCutReady',
+    'CortexIngestionReceipt',
+    'NeuraloomIngestionReceipt',
+]);
+exports.BridgeEnvelopeFieldsSchema = zod_1.z
+    .object({
+    schemaVersion: zod_1.z.literal(exports.CORTEX_BRIDGE_ENVELOPE_VERSION),
+    eventId: zod_1.z.string().uuid(),
+    eventType: exports.BridgeEventTypeSchema,
+    idempotencyKey: zod_1.z.string().min(1),
+    sourceSystem: exports.BridgeSourceSystemSchema,
+    createdAt: zod_1.z.string().datetime(),
+    brandSlug: zod_1.z.string().min(1),
+    productSlug: zod_1.z.string().min(1).optional(),
+    repoFullName: zod_1.z.string().min(1).optional(),
+    neuraloomProjectId: zod_1.z.string().uuid().optional(),
+    commitSha: zod_1.z.string().min(7).optional(),
+    payloadHash: zod_1.z.string().regex(/^[a-f0-9]{64}$/i),
+    payload: zod_1.z.record(zod_1.z.unknown()),
+})
+    .strict();
+function createBridgeEnvelope(args) {
+    return exports.BridgeEnvelopeFieldsSchema.parse({
+        schemaVersion: exports.CORTEX_BRIDGE_ENVELOPE_VERSION,
+        eventId: args.eventId,
+        eventType: args.eventType,
+        idempotencyKey: args.idempotencyKey,
+        sourceSystem: args.sourceSystem,
+        createdAt: args.createdAt,
+        brandSlug: args.brandSlug,
+        payloadHash: args.payloadHash,
+        payload: args.payload,
+        ...(args.productSlug !== undefined ? { productSlug: args.productSlug } : {}),
+        ...(args.repoFullName !== undefined ? { repoFullName: args.repoFullName } : {}),
+        ...(args.neuraloomProjectId !== undefined
+            ? { neuraloomProjectId: args.neuraloomProjectId }
+            : {}),
+        ...(args.commitSha !== undefined ? { commitSha: args.commitSha } : {}),
+    });
+}

package/dist/schemas/cortex/bridge-event-catalogue.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Machine-readable catalogue of Cortex × NeuraLoom bridge events.
+ */
+import type { BridgeEventType } from './bridge-envelope.schema';
+export type BridgeEventDirection = 'cortex_to_neuraloom' | 'neuraloom_to_cortex' | 'both';
+export type BridgeEventCatalogueEntry = {
+    eventType: BridgeEventType;
+    direction: BridgeEventDirection;
+    payloadSchemaVersion: '1.0.0';
+    description: string;
+};
+export declare const CORTEX_BRIDGE_EVENT_CATALOGUE: readonly BridgeEventCatalogueEntry[];
+export declare const CORTEX_TO_NEURALOOM_EVENT_TYPES: ("GitHubReadRequest" | "GitHubReadResult" | "CodexExecutorRuntimeRequest" | "CodexExecutorRuntimeResult" | "CodexExecutorWorkflowRequest" | "CodexExecutorWorkflowResult" | "CodexExecutorAuthorizationRequest" | "CodexExecutorAuthorizationResult" | "RepoIntelligenceRequest" | "RepoIntelligenceResult" | "RepoFindingTask" | "ImplementationPlanReady" | "PullRequestReady" | "ProofRunRecorded" | "EngineeringCheckpointRecorded" | "RenderProofRecorded" | "GuardianViolationEvent" | "CreativeWorkflowRequest" | "CreativeWorkflowResult" | "DocDraftReady" | "DocDriftDetected" | "PortfolioRepoLink" | "TaskGithubIssueRequest" | "ProductReleasePackageMvp" | "FilmProductionPlanReady" | "FilmCutReady" | "CortexIngestionReceipt" | "NeuraloomIngestionReceipt")[];
+export declare const NEURALOOM_TO_CORTEX_EVENT_TYPES: ("GitHubReadRequest" | "GitHubReadResult" | "CodexExecutorRuntimeRequest" | "CodexExecutorRuntimeResult" | "CodexExecutorWorkflowRequest" | "CodexExecutorWorkflowResult" | "CodexExecutorAuthorizationRequest" | "CodexExecutorAuthorizationResult" | "RepoIntelligenceRequest" | "RepoIntelligenceResult" | "RepoFindingTask" | "ImplementationPlanReady" | "PullRequestReady" | "ProofRunRecorded" | "EngineeringCheckpointRecorded" | "RenderProofRecorded" | "GuardianViolationEvent" | "CreativeWorkflowRequest" | "CreativeWorkflowResult" | "DocDraftReady" | "DocDriftDetected" | "PortfolioRepoLink" | "TaskGithubIssueRequest" | "ProductReleasePackageMvp" | "FilmProductionPlanReady" | "FilmCutReady" | "CortexIngestionReceipt" | "NeuraloomIngestionReceipt")[];