@vantageos/event-schemas 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VantageOS Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# @vantageos/event-schemas
+
+Versioned event schema registry for Vantage Immo feature MCPs.
+
+## What it is
+
+A code-side schema registry. No Convex tables. No event bus.
+Provides typed validators, type-guards, and helpers so feature MCPs can publish
+validated events into the host app's `intakeEvents` table without re-implementing
+validation logic.
+
+## Schemas
+
+| Schema ID | Convex Validator | Type-guard | Status | Variants |
+|---|---|---|---|---|
+| `intake.event.v1` | `IntakeEventV1Schema` | `isIntakeEventV1` | Production | `mail`, `document`, `contract`, `candidature`, `external-event` |
+| `task.complete.v1` | `TaskCompleteV1Schema` | `isTaskCompleteV1` | Placeholder (Sigma API 5 v2 roadmap) | `normal`, `auto-resolved` |
+
+## Usage
+
+```typescript
+import {
+  publishEvent,
+  isIntakeEventV1,
+  IntakeEventV1Schema,
+} from "@vantageos/event-schemas";
+
+// 1. Validate and get typed payload (runtime type-guard)
+const result = publishEvent("intake.event.v1", isIntakeEventV1, rawPayload);
+if (!result.ok) {
+  throw new Error(`Event validation failed: ${result.error}`);
+}
+
+// 2. result.payload is typed as IntakeEventV1
+// 3. Insert into host app's intakeEvents table (Component does NOT insert)
+await ctx.db.insert("intakeEvents", {
+  orgId: result.payload.orgId,
+  // ...
+});
+
+// validatePayload directly
+import { validatePayload, isIntakeEventMailV1 } from "@vantageos/event-schemas";
+const check = validatePayload(isIntakeEventMailV1, unknownValue);
+if (check.ok) {
+  console.log(check.value.sujet); // typed as IntakeEventMailV1
+}
+```
+
+## Convex schema args
+
+Use the exported Convex validators in function args:
+
+```typescript
+import { v } from "convex/values";
+import { IntakeEventV1Schema } from "@vantageos/event-schemas";
+
+export const myMutation = mutation({
+  args: { event: IntakeEventV1Schema },
+  // ...
+});
+```
+
+## Rules
+
+- No `v.any()` at any public boundary.
+- All exported symbols carry a `V1` version suffix.
+- `publishEvent` validates but never inserts — the host app owns the table.
+- `registerSchema` throws on duplicate IDs — one schema per version.
+
+## License
+
+MIT

package/convex.config.ts

@@ -0,0 +1,24 @@
+/**
+ * @vantage/event-schemas — Convex Component definition
+ *
+ * This Component carries the code-side registry of versioned event schemas
+ * consumed by feature MCPs (F7 briefing matinal, F8 reporting, F11 candidature, etc.).
+ *
+ * It is NOT an event bus. It provides:
+ *   - Versioned schema validators (discriminated unions, no v.any())
+ *   - validatePayload() helper: type-safe validation before publish
+ *   - publishEvent() helper: validate + return typed payload ready for db.insert
+ *
+ * The Component owns zero Convex tables. All persistence is delegated to the
+ * host app (vantage-immo convex/schema.ts — intakeEvents table).
+ *
+ * Source: decisions/c2-spec-schema-2026-05-21.md §4 CF2
+ * Flag: Eta F-Xi-1 (risk B4 — implicit cross-feature coupling via data lake)
+ * ADR: vantage-memory/decisions/c1-public-apis-design-2026-05-21.md §"Hors scope C1.v1"
+ */
+
+import { defineComponent } from "convex/server";
+
+const eventSchemas = defineComponent("eventSchemas");
+
+export default eventSchemas;

package/dist/index.d.ts

@@ -0,0 +1,146 @@
+/**
+ * @vantageos/event-schemas — public API
+ *
+ * Versioned event schema registry for Vantage Immo feature MCPs.
+ * Code-side validators only — no Convex tables owned by this Component.
+ *
+ * Exports:
+ *   - Versioned schemas: IntakeEventV1Schema, TaskCompleteV1Schema
+ *   - Sub-validators per variant (vIntakeEvent*V1, vTaskComplete*V1)
+ *   - TypeScript types derived from validators
+ *   - Helpers: registerSchema, validatePayload, publishEvent
+ *
+ * Feature MCPs import this package to publish validated events into
+ * the host app's intakeEvents table without re-implementing validation.
+ *
+ * Source: decisions/c2-spec-schema-2026-05-21.md §4 CF2
+ */
+export { IntakeEventV1Schema, vIntakeEventMailV1, vIntakeEventDocumentV1, vIntakeEventContractV1, vIntakeEventCandidatureV1, vIntakeEventExternalV1, } from "./schemas/intake-event-v1.js";
+export type { IntakeEventV1, IntakeEventMailV1, IntakeEventDocumentV1, IntakeEventContractV1, IntakeEventCandidatureV1, IntakeEventExternalV1, } from "./schemas/intake-event-v1.js";
+export { TaskCompleteV1Schema, vTaskCompleteNormalV1, vTaskCompleteAutoResolvedV1, } from "./schemas/task-complete-v1.js";
+export type { TaskCompleteV1, TaskCompleteNormalV1, TaskCompleteAutoResolvedV1, } from "./schemas/task-complete-v1.js";
+/**
+ * A SchemaEntry pairs a stable schema ID with a runtime type-guard function.
+ * The type-guard is responsible for structural validation of an unknown value.
+ *
+ * Using type-guard functions (rather than Convex Validator runtime methods,
+ * which are not exposed publicly) keeps this package portable and avoids
+ * coupling to Convex internals.
+ */
+export type SchemaEntry<T> = {
+    schemaId: string;
+    guard: (value: unknown) => value is T;
+};
+/**
+ * registerSchema — register a versioned schema by its type-guard function.
+ *
+ * @param schemaId  Stable string identifier e.g. "intake.event.v1", "task.complete.v1"
+ * @param guard     Type-guard function: (value: unknown) => value is T
+ *
+ * Throws if the schemaId is already registered (prevents silent override).
+ * Feature MCPs call this at module init to declare the schemas they produce/consume.
+ *
+ * @example
+ *   import { registerSchema, isIntakeEventV1 } from "@vantageos/event-schemas";
+ *   registerSchema("intake.event.v1", isIntakeEventV1);
+ */
+export declare function registerSchema<T>(schemaId: string, guard: (value: unknown) => value is T): void;
+/**
+ * getRegisteredSchemaIds — list all registered schema IDs.
+ * Useful for debugging and audit.
+ */
+export declare function getRegisteredSchemaIds(): string[];
+/**
+ * ValidationResult — discriminated union returned by validatePayload.
+ */
+export type ValidationResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * validatePayload — validate an unknown payload against a type-guard function.
+ *
+ * Returns a discriminated result — never throws on validation failure.
+ *
+ * @param guard   Type-guard: (value: unknown) => value is T
+ * @param payload Raw unknown value to validate
+ *
+ * @example
+ *   import { validatePayload, isIntakeEventV1 } from "@vantageos/event-schemas";
+ *   const result = validatePayload(isIntakeEventV1, rawPayload);
+ *   if (!result.ok) { logger.warn(result.error); return; }
+ *   const event = result.value; // typed as IntakeEventV1
+ */
+export declare function validatePayload<T>(guard: (value: unknown) => value is T, payload: unknown): ValidationResult<T>;
+/**
+ * PublishEventResult — payload ready for db.insert into intakeEvents.
+ * The Component does NOT perform the insertion — the host app owns the table.
+ */
+export type PublishEventResult<T> = {
+    ok: true;
+    payload: T;
+    schemaId: string;
+} | {
+    ok: false;
+    error: string;
+    schemaId: string;
+};
+/**
+ * publishEvent — validate an event payload and return it typed, ready to insert.
+ *
+ * The Component validates but does NOT insert. The caller (host app mutation
+ * or feature MCP) is responsible for db.insert into intakeEvents.
+ * This preserves the boundary: the Component owns zero tables.
+ *
+ * @param schemaId  The versioned schema identifier e.g. "intake.event.v1"
+ * @param guard     Type-guard function for the schema
+ * @param payload   Raw unknown payload from the caller
+ * @returns         PublishEventResult — ok=true with typed payload, or ok=false with error
+ *
+ * @example
+ *   import { publishEvent, isIntakeEventV1 } from "@vantageos/event-schemas";
+ *
+ *   const result = publishEvent("intake.event.v1", isIntakeEventV1, rawPayload);
+ *   if (!result.ok) { throw new Error(`Validation failed: ${result.error}`); }
+ *
+ *   // result.payload is typed as IntakeEventV1
+ *   await ctx.db.insert("intakeEvents", {
+ *     orgId: result.payload.orgId,
+ *     intakeId: ctx.db.normalizeId("intakeQueue", result.payload.intakeId)!,
+ *     objectId: ctx.db.normalizeId("customObjects", result.payload.objectId)!,
+ *     objectType: result.payload.sourceType,
+ *     eventType: "document_ingested",
+ *     createdAt: result.payload.createdAt,
+ *   });
+ */
+export declare function publishEvent<T>(schemaId: string, guard: (value: unknown) => value is T, payload: unknown): PublishEventResult<T>;
+import type { IntakeEventV1, IntakeEventMailV1, IntakeEventDocumentV1, IntakeEventContractV1, IntakeEventCandidatureV1, IntakeEventExternalV1 } from "./schemas/intake-event-v1.js";
+import type { TaskCompleteV1 } from "./schemas/task-complete-v1.js";
+/** Type-guard for IntakeEventMailV1 */
+export declare function isIntakeEventMailV1(v: unknown): v is IntakeEventMailV1;
+/** Type-guard for IntakeEventDocumentV1 */
+export declare function isIntakeEventDocumentV1(v: unknown): v is IntakeEventDocumentV1;
+/** Type-guard for IntakeEventContractV1 */
+export declare function isIntakeEventContractV1(v: unknown): v is IntakeEventContractV1;
+/** Type-guard for IntakeEventCandidatureV1 */
+export declare function isIntakeEventCandidatureV1(v: unknown): v is IntakeEventCandidatureV1;
+/** Type-guard for IntakeEventExternalV1 */
+export declare function isIntakeEventExternalV1(v: unknown): v is IntakeEventExternalV1;
+/**
+ * isIntakeEventV1 — master type-guard for the full IntakeEventV1 discriminated union.
+ * Dispatches on sourceType to the appropriate variant guard.
+ */
+export declare function isIntakeEventV1(v: unknown): v is IntakeEventV1;
+import type { TaskCompleteNormalV1, TaskCompleteAutoResolvedV1 } from "./schemas/task-complete-v1.js";
+/** Type-guard for TaskCompleteNormalV1 */
+export declare function isTaskCompleteNormalV1(v: unknown): v is TaskCompleteNormalV1;
+/** Type-guard for TaskCompleteAutoResolvedV1 */
+export declare function isTaskCompleteAutoResolvedV1(v: unknown): v is TaskCompleteAutoResolvedV1;
+/**
+ * isTaskCompleteV1 — master type-guard for the full TaskCompleteV1 union.
+ */
+export declare function isTaskCompleteV1(v: unknown): v is TaskCompleteV1;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,264 @@
+/**
+ * @vantageos/event-schemas — public API
+ *
+ * Versioned event schema registry for Vantage Immo feature MCPs.
+ * Code-side validators only — no Convex tables owned by this Component.
+ *
+ * Exports:
+ *   - Versioned schemas: IntakeEventV1Schema, TaskCompleteV1Schema
+ *   - Sub-validators per variant (vIntakeEvent*V1, vTaskComplete*V1)
+ *   - TypeScript types derived from validators
+ *   - Helpers: registerSchema, validatePayload, publishEvent
+ *
+ * Feature MCPs import this package to publish validated events into
+ * the host app's intakeEvents table without re-implementing validation.
+ *
+ * Source: decisions/c2-spec-schema-2026-05-21.md §4 CF2
+ */
+// ---------------------------------------------------------------------------
+// Re-export schemas and types
+// ---------------------------------------------------------------------------
+export { 
+// Intake event V1 — master schema + variants
+IntakeEventV1Schema, vIntakeEventMailV1, vIntakeEventDocumentV1, vIntakeEventContractV1, vIntakeEventCandidatureV1, vIntakeEventExternalV1, } from "./schemas/intake-event-v1.js";
+export { 
+// Task complete V1 — placeholder for Sigma API 5 v2 roadmap
+TaskCompleteV1Schema, vTaskCompleteNormalV1, vTaskCompleteAutoResolvedV1, } from "./schemas/task-complete-v1.js";
+/** Internal registry: schemaId → type-guard function */
+const _schemaRegistry = new Map();
+/**
+ * registerSchema — register a versioned schema by its type-guard function.
+ *
+ * @param schemaId  Stable string identifier e.g. "intake.event.v1", "task.complete.v1"
+ * @param guard     Type-guard function: (value: unknown) => value is T
+ *
+ * Throws if the schemaId is already registered (prevents silent override).
+ * Feature MCPs call this at module init to declare the schemas they produce/consume.
+ *
+ * @example
+ *   import { registerSchema, isIntakeEventV1 } from "@vantageos/event-schemas";
+ *   registerSchema("intake.event.v1", isIntakeEventV1);
+ */
+export function registerSchema(schemaId, guard) {
+    if (_schemaRegistry.has(schemaId)) {
+        throw new Error(`@vantageos/event-schemas: schema "${schemaId}" is already registered. ` +
+            `Use a unique schemaId per version (e.g. "intake.event.v2").`);
+    }
+    _schemaRegistry.set(schemaId, guard);
+}
+/**
+ * getRegisteredSchemaIds — list all registered schema IDs.
+ * Useful for debugging and audit.
+ */
+export function getRegisteredSchemaIds() {
+    return Array.from(_schemaRegistry.keys());
+}
+// ---------------------------------------------------------------------------
+// validatePayload helper
+// ---------------------------------------------------------------------------
+/**
+ * validatePayload — validate an unknown payload against a type-guard function.
+ *
+ * Returns a discriminated result — never throws on validation failure.
+ *
+ * @param guard   Type-guard: (value: unknown) => value is T
+ * @param payload Raw unknown value to validate
+ *
+ * @example
+ *   import { validatePayload, isIntakeEventV1 } from "@vantageos/event-schemas";
+ *   const result = validatePayload(isIntakeEventV1, rawPayload);
+ *   if (!result.ok) { logger.warn(result.error); return; }
+ *   const event = result.value; // typed as IntakeEventV1
+ */
+export function validatePayload(guard, payload) {
+    try {
+        if (guard(payload)) {
+            return { ok: true, value: payload };
+        }
+        return { ok: false, error: "Payload did not match expected schema shape" };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : "Unknown validation error";
+        return { ok: false, error: message };
+    }
+}
+/**
+ * publishEvent — validate an event payload and return it typed, ready to insert.
+ *
+ * The Component validates but does NOT insert. The caller (host app mutation
+ * or feature MCP) is responsible for db.insert into intakeEvents.
+ * This preserves the boundary: the Component owns zero tables.
+ *
+ * @param schemaId  The versioned schema identifier e.g. "intake.event.v1"
+ * @param guard     Type-guard function for the schema
+ * @param payload   Raw unknown payload from the caller
+ * @returns         PublishEventResult — ok=true with typed payload, or ok=false with error
+ *
+ * @example
+ *   import { publishEvent, isIntakeEventV1 } from "@vantageos/event-schemas";
+ *
+ *   const result = publishEvent("intake.event.v1", isIntakeEventV1, rawPayload);
+ *   if (!result.ok) { throw new Error(`Validation failed: ${result.error}`); }
+ *
+ *   // result.payload is typed as IntakeEventV1
+ *   await ctx.db.insert("intakeEvents", {
+ *     orgId: result.payload.orgId,
+ *     intakeId: ctx.db.normalizeId("intakeQueue", result.payload.intakeId)!,
+ *     objectId: ctx.db.normalizeId("customObjects", result.payload.objectId)!,
+ *     objectType: result.payload.sourceType,
+ *     eventType: "document_ingested",
+ *     createdAt: result.payload.createdAt,
+ *   });
+ */
+export function publishEvent(schemaId, guard, payload) {
+    const validation = validatePayload(guard, payload);
+    if (!validation.ok) {
+        return { ok: false, error: validation.error, schemaId };
+    }
+    return { ok: true, payload: validation.value, schemaId };
+}
+const CANDIDATURE_PIECE_TYPES = new Set([
+    "identite",
+    "justificatif_domicile",
+    "justificatif_revenus",
+    "avis_imposition",
+    "quittances_loyer",
+    "autre",
+]);
+/** Type-guard for IntakeEventMailV1 */
+export function isIntakeEventMailV1(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const o = v;
+    return (o["sourceType"] === "mail" &&
+        typeof o["orgId"] === "string" &&
+        typeof o["intakeId"] === "string" &&
+        typeof o["objectId"] === "string" &&
+        typeof o["sujet"] === "string" &&
+        typeof o["expediteur"] === "string" &&
+        Array.isArray(o["destinataires"]) &&
+        typeof o["dateReception"] === "number" &&
+        typeof o["mimeType"] === "string" &&
+        typeof o["createdAt"] === "number");
+}
+/** Type-guard for IntakeEventDocumentV1 */
+export function isIntakeEventDocumentV1(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const o = v;
+    return (o["sourceType"] === "document" &&
+        typeof o["orgId"] === "string" &&
+        typeof o["intakeId"] === "string" &&
+        typeof o["objectId"] === "string" &&
+        typeof o["storageId"] === "string" &&
+        typeof o["mimeType"] === "string" &&
+        typeof o["sizeBytes"] === "number" &&
+        typeof o["createdAt"] === "number");
+}
+/** Type-guard for IntakeEventContractV1 */
+export function isIntakeEventContractV1(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const o = v;
+    return (o["sourceType"] === "contract" &&
+        typeof o["orgId"] === "string" &&
+        typeof o["intakeId"] === "string" &&
+        typeof o["objectId"] === "string" &&
+        typeof o["storageId"] === "string" &&
+        typeof o["mimeType"] === "string" &&
+        typeof o["sizeBytes"] === "number" &&
+        typeof o["createdAt"] === "number");
+}
+/** Type-guard for IntakeEventCandidatureV1 */
+export function isIntakeEventCandidatureV1(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const o = v;
+    return (o["sourceType"] === "candidature" &&
+        typeof o["orgId"] === "string" &&
+        typeof o["intakeId"] === "string" &&
+        typeof o["objectId"] === "string" &&
+        typeof o["lotObjectId"] === "string" &&
+        typeof o["pieceType"] === "string" &&
+        CANDIDATURE_PIECE_TYPES.has(o["pieceType"]) &&
+        typeof o["storageId"] === "string" &&
+        typeof o["mimeType"] === "string" &&
+        typeof o["createdAt"] === "number");
+}
+/** Type-guard for IntakeEventExternalV1 */
+export function isIntakeEventExternalV1(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const o = v;
+    return (o["sourceType"] === "external-event" &&
+        typeof o["orgId"] === "string" &&
+        typeof o["intakeId"] === "string" &&
+        typeof o["objectId"] === "string" &&
+        typeof o["systemId"] === "string" &&
+        typeof o["externalEventType"] === "string" &&
+        typeof o["payloadJson"] === "string" &&
+        typeof o["createdAt"] === "number");
+}
+/**
+ * isIntakeEventV1 — master type-guard for the full IntakeEventV1 discriminated union.
+ * Dispatches on sourceType to the appropriate variant guard.
+ */
+export function isIntakeEventV1(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const o = v;
+    switch (o["sourceType"]) {
+        case "mail":
+            return isIntakeEventMailV1(v);
+        case "document":
+            return isIntakeEventDocumentV1(v);
+        case "contract":
+            return isIntakeEventContractV1(v);
+        case "candidature":
+            return isIntakeEventCandidatureV1(v);
+        case "external-event":
+            return isIntakeEventExternalV1(v);
+        default:
+            return false;
+    }
+}
+/** Type-guard for TaskCompleteNormalV1 */
+export function isTaskCompleteNormalV1(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const o = v;
+    return (o["completionKind"] === "normal" &&
+        typeof o["taskId"] === "string" &&
+        typeof o["completedBy"] === "string" &&
+        typeof o["completionNote"] === "string" &&
+        typeof o["completedAt"] === "number");
+}
+/** Type-guard for TaskCompleteAutoResolvedV1 */
+export function isTaskCompleteAutoResolvedV1(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const o = v;
+    return (o["completionKind"] === "auto-resolved" &&
+        typeof o["taskId"] === "string" &&
+        typeof o["resolvedBy"] === "string" &&
+        typeof o["reason"] === "string" &&
+        typeof o["completionNote"] === "string" &&
+        typeof o["completedAt"] === "number");
+}
+/**
+ * isTaskCompleteV1 — master type-guard for the full TaskCompleteV1 union.
+ */
+export function isTaskCompleteV1(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const o = v;
+    switch (o["completionKind"]) {
+        case "normal":
+            return isTaskCompleteNormalV1(v);
+        case "auto-resolved":
+            return isTaskCompleteAutoResolvedV1(v);
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/schemas/intake-event-v1.d.ts

@@ -0,0 +1,367 @@
+/**
+ * intake-event-v1 — Versioned schema for intake pipeline events.
+ *
+ * Discriminated union on sourceType — 5 variants:
+ *   mail        — inbound mail ingested from Gmail push / Composio
+ *   document    — document ingested from Drive webhook / manual upload
+ *   contract    — contract document (sous-type discriminé du document)
+ *   candidature — candidature pieces (F11 — locataire candidate)
+ *   external-event — tiers system webhook (Hektor, LOJII, Immodvisor …)
+ *
+ * Rule: no v.any(), no opaque v.string() at public boundaries (Pi doctrine).
+ * Naming: V1 suffix on all exported symbols.
+ */
+/** Mail intake variant — sujet, expediteur, thread context */
+export declare const vIntakeEventMailV1: import("convex/values").VObject<{
+    threadId?: string;
+    sourceType: "mail";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    sujet: string;
+    expediteur: string;
+    destinataires: string[];
+    dateReception: number;
+    mimeType: string;
+    createdAt: number;
+}, {
+    sourceType: import("convex/values").VLiteral<"mail", "required">;
+    orgId: import("convex/values").VString<string, "required">;
+    intakeId: import("convex/values").VString<string, "required">;
+    objectId: import("convex/values").VString<string, "required">;
+    sujet: import("convex/values").VString<string, "required">;
+    expediteur: import("convex/values").VString<string, "required">;
+    destinataires: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+    threadId: import("convex/values").VString<string | undefined, "optional">;
+    dateReception: import("convex/values").VFloat64<number, "required">;
+    mimeType: import("convex/values").VString<string, "required">;
+    createdAt: import("convex/values").VFloat64<number, "required">;
+}, "required", "sourceType" | "orgId" | "intakeId" | "objectId" | "sujet" | "expediteur" | "destinataires" | "dateReception" | "mimeType" | "createdAt" | "threadId">;
+/** Document intake variant — storage reference + type document */
+export declare const vIntakeEventDocumentV1: import("convex/values").VObject<{
+    nomenclatureKey?: string;
+    sourceType: "document";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    mimeType: string;
+    createdAt: number;
+    storageId: string;
+    sizeBytes: number;
+}, {
+    sourceType: import("convex/values").VLiteral<"document", "required">;
+    orgId: import("convex/values").VString<string, "required">;
+    intakeId: import("convex/values").VString<string, "required">;
+    objectId: import("convex/values").VString<string, "required">;
+    storageId: import("convex/values").VString<string, "required">;
+    mimeType: import("convex/values").VString<string, "required">;
+    sizeBytes: import("convex/values").VFloat64<number, "required">;
+    /** Canonical nomenclature key e.g. "BAIL_ENTRANT", "RELEVE_CHARGES" */
+    nomenclatureKey: import("convex/values").VString<string | undefined, "optional">;
+    createdAt: import("convex/values").VFloat64<number, "required">;
+}, "required", "sourceType" | "orgId" | "intakeId" | "objectId" | "mimeType" | "createdAt" | "storageId" | "sizeBytes" | "nomenclatureKey">;
+/** Contract intake variant — document with mandatory contract metadata */
+export declare const vIntakeEventContractV1: import("convex/values").VObject<{
+    signataire?: string;
+    signingRef?: string;
+    sourceType: "contract";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    mimeType: string;
+    createdAt: number;
+    storageId: string;
+    sizeBytes: number;
+}, {
+    sourceType: import("convex/values").VLiteral<"contract", "required">;
+    orgId: import("convex/values").VString<string, "required">;
+    intakeId: import("convex/values").VString<string, "required">;
+    objectId: import("convex/values").VString<string, "required">;
+    storageId: import("convex/values").VString<string, "required">;
+    mimeType: import("convex/values").VString<string, "required">;
+    sizeBytes: import("convex/values").VFloat64<number, "required">;
+    /** Clerk userId of the signer (if known at intake time) */
+    signataire: import("convex/values").VString<string | undefined, "optional">;
+    /** Signing platform reference e.g. Yousign envelope ID */
+    signingRef: import("convex/values").VString<string | undefined, "optional">;
+    createdAt: import("convex/values").VFloat64<number, "required">;
+}, "required", "sourceType" | "orgId" | "intakeId" | "objectId" | "mimeType" | "createdAt" | "storageId" | "sizeBytes" | "signataire" | "signingRef">;
+/** Candidature intake variant — F11 locataire candidate */
+export declare const vIntakeEventCandidatureV1: import("convex/values").VObject<{
+    sourceType: "candidature";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    mimeType: string;
+    createdAt: number;
+    storageId: string;
+    lotObjectId: string;
+    pieceType: "identite" | "justificatif_domicile" | "justificatif_revenus" | "avis_imposition" | "quittances_loyer" | "autre";
+}, {
+    sourceType: import("convex/values").VLiteral<"candidature", "required">;
+    orgId: import("convex/values").VString<string, "required">;
+    intakeId: import("convex/values").VString<string, "required">;
+    objectId: import("convex/values").VString<string, "required">;
+    /** ID of the lot (customObject) the candidature targets */
+    lotObjectId: import("convex/values").VString<string, "required">;
+    /** Piece type for this candidature item */
+    pieceType: import("convex/values").VUnion<"identite" | "justificatif_domicile" | "justificatif_revenus" | "avis_imposition" | "quittances_loyer" | "autre", [import("convex/values").VLiteral<"identite", "required">, import("convex/values").VLiteral<"justificatif_domicile", "required">, import("convex/values").VLiteral<"justificatif_revenus", "required">, import("convex/values").VLiteral<"avis_imposition", "required">, import("convex/values").VLiteral<"quittances_loyer", "required">, import("convex/values").VLiteral<"autre", "required">], "required", never>;
+    storageId: import("convex/values").VString<string, "required">;
+    mimeType: import("convex/values").VString<string, "required">;
+    createdAt: import("convex/values").VFloat64<number, "required">;
+}, "required", "sourceType" | "orgId" | "intakeId" | "objectId" | "mimeType" | "createdAt" | "storageId" | "lotObjectId" | "pieceType">;
+/** External event intake variant — third-party system webhook */
+export declare const vIntakeEventExternalV1: import("convex/values").VObject<{
+    sourceType: "external-event";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    createdAt: number;
+    systemId: string;
+    externalEventType: string;
+    payloadJson: string;
+}, {
+    sourceType: import("convex/values").VLiteral<"external-event", "required">;
+    orgId: import("convex/values").VString<string, "required">;
+    intakeId: import("convex/values").VString<string, "required">;
+    objectId: import("convex/values").VString<string, "required">;
+    /** Stable ID of the external system e.g. "hektor", "lojii", "immodvisor" */
+    systemId: import("convex/values").VString<string, "required">;
+    /** Event type as declared by the external system */
+    externalEventType: import("convex/values").VString<string, "required">;
+    /** JSON-serialised payload from the external system (string, not v.any()) */
+    payloadJson: import("convex/values").VString<string, "required">;
+    createdAt: import("convex/values").VFloat64<number, "required">;
+}, "required", "sourceType" | "orgId" | "intakeId" | "objectId" | "createdAt" | "systemId" | "externalEventType" | "payloadJson">;
+/**
+ * IntakeEventV1Schema — the master validator for all intake event variants.
+ *
+ * Usage:
+ *   import { IntakeEventV1Schema } from "@vantage/event-schemas";
+ *   const validated = validatePayload(IntakeEventV1Schema, rawPayload);
+ */
+export declare const IntakeEventV1Schema: import("convex/values").VUnion<{
+    threadId?: string;
+    sourceType: "mail";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    sujet: string;
+    expediteur: string;
+    destinataires: string[];
+    dateReception: number;
+    mimeType: string;
+    createdAt: number;
+} | {
+    nomenclatureKey?: string;
+    sourceType: "document";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    mimeType: string;
+    createdAt: number;
+    storageId: string;
+    sizeBytes: number;
+} | {
+    signataire?: string;
+    signingRef?: string;
+    sourceType: "contract";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    mimeType: string;
+    createdAt: number;
+    storageId: string;
+    sizeBytes: number;
+} | {
+    sourceType: "candidature";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    mimeType: string;
+    createdAt: number;
+    storageId: string;
+    lotObjectId: string;
+    pieceType: "identite" | "justificatif_domicile" | "justificatif_revenus" | "avis_imposition" | "quittances_loyer" | "autre";
+} | {
+    sourceType: "external-event";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    createdAt: number;
+    systemId: string;
+    externalEventType: string;
+    payloadJson: string;
+}, [import("convex/values").VObject<{
+    threadId?: string;
+    sourceType: "mail";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    sujet: string;
+    expediteur: string;
+    destinataires: string[];
+    dateReception: number;
+    mimeType: string;
+    createdAt: number;
+}, {
+    sourceType: import("convex/values").VLiteral<"mail", "required">;
+    orgId: import("convex/values").VString<string, "required">;
+    intakeId: import("convex/values").VString<string, "required">;
+    objectId: import("convex/values").VString<string, "required">;
+    sujet: import("convex/values").VString<string, "required">;
+    expediteur: import("convex/values").VString<string, "required">;
+    destinataires: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+    threadId: import("convex/values").VString<string | undefined, "optional">;
+    dateReception: import("convex/values").VFloat64<number, "required">;
+    mimeType: import("convex/values").VString<string, "required">;
+    createdAt: import("convex/values").VFloat64<number, "required">;
+}, "required", "sourceType" | "orgId" | "intakeId" | "objectId" | "sujet" | "expediteur" | "destinataires" | "dateReception" | "mimeType" | "createdAt" | "threadId">, import("convex/values").VObject<{
+    nomenclatureKey?: string;
+    sourceType: "document";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    mimeType: string;
+    createdAt: number;
+    storageId: string;
+    sizeBytes: number;
+}, {
+    sourceType: import("convex/values").VLiteral<"document", "required">;
+    orgId: import("convex/values").VString<string, "required">;
+    intakeId: import("convex/values").VString<string, "required">;
+    objectId: import("convex/values").VString<string, "required">;
+    storageId: import("convex/values").VString<string, "required">;
+    mimeType: import("convex/values").VString<string, "required">;
+    sizeBytes: import("convex/values").VFloat64<number, "required">;
+    /** Canonical nomenclature key e.g. "BAIL_ENTRANT", "RELEVE_CHARGES" */
+    nomenclatureKey: import("convex/values").VString<string | undefined, "optional">;
+    createdAt: import("convex/values").VFloat64<number, "required">;
+}, "required", "sourceType" | "orgId" | "intakeId" | "objectId" | "mimeType" | "createdAt" | "storageId" | "sizeBytes" | "nomenclatureKey">, import("convex/values").VObject<{
+    signataire?: string;
+    signingRef?: string;
+    sourceType: "contract";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    mimeType: string;
+    createdAt: number;
+    storageId: string;
+    sizeBytes: number;
+}, {
+    sourceType: import("convex/values").VLiteral<"contract", "required">;
+    orgId: import("convex/values").VString<string, "required">;
+    intakeId: import("convex/values").VString<string, "required">;
+    objectId: import("convex/values").VString<string, "required">;
+    storageId: import("convex/values").VString<string, "required">;
+    mimeType: import("convex/values").VString<string, "required">;
+    sizeBytes: import("convex/values").VFloat64<number, "required">;
+    /** Clerk userId of the signer (if known at intake time) */
+    signataire: import("convex/values").VString<string | undefined, "optional">;
+    /** Signing platform reference e.g. Yousign envelope ID */
+    signingRef: import("convex/values").VString<string | undefined, "optional">;
+    createdAt: import("convex/values").VFloat64<number, "required">;
+}, "required", "sourceType" | "orgId" | "intakeId" | "objectId" | "mimeType" | "createdAt" | "storageId" | "sizeBytes" | "signataire" | "signingRef">, import("convex/values").VObject<{
+    sourceType: "candidature";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    mimeType: string;
+    createdAt: number;
+    storageId: string;
+    lotObjectId: string;
+    pieceType: "identite" | "justificatif_domicile" | "justificatif_revenus" | "avis_imposition" | "quittances_loyer" | "autre";
+}, {
+    sourceType: import("convex/values").VLiteral<"candidature", "required">;
+    orgId: import("convex/values").VString<string, "required">;
+    intakeId: import("convex/values").VString<string, "required">;
+    objectId: import("convex/values").VString<string, "required">;
+    /** ID of the lot (customObject) the candidature targets */
+    lotObjectId: import("convex/values").VString<string, "required">;
+    /** Piece type for this candidature item */
+    pieceType: import("convex/values").VUnion<"identite" | "justificatif_domicile" | "justificatif_revenus" | "avis_imposition" | "quittances_loyer" | "autre", [import("convex/values").VLiteral<"identite", "required">, import("convex/values").VLiteral<"justificatif_domicile", "required">, import("convex/values").VLiteral<"justificatif_revenus", "required">, import("convex/values").VLiteral<"avis_imposition", "required">, import("convex/values").VLiteral<"quittances_loyer", "required">, import("convex/values").VLiteral<"autre", "required">], "required", never>;
+    storageId: import("convex/values").VString<string, "required">;
+    mimeType: import("convex/values").VString<string, "required">;
+    createdAt: import("convex/values").VFloat64<number, "required">;
+}, "required", "sourceType" | "orgId" | "intakeId" | "objectId" | "mimeType" | "createdAt" | "storageId" | "lotObjectId" | "pieceType">, import("convex/values").VObject<{
+    sourceType: "external-event";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    createdAt: number;
+    systemId: string;
+    externalEventType: string;
+    payloadJson: string;
+}, {
+    sourceType: import("convex/values").VLiteral<"external-event", "required">;
+    orgId: import("convex/values").VString<string, "required">;
+    intakeId: import("convex/values").VString<string, "required">;
+    objectId: import("convex/values").VString<string, "required">;
+    /** Stable ID of the external system e.g. "hektor", "lojii", "immodvisor" */
+    systemId: import("convex/values").VString<string, "required">;
+    /** Event type as declared by the external system */
+    externalEventType: import("convex/values").VString<string, "required">;
+    /** JSON-serialised payload from the external system (string, not v.any()) */
+    payloadJson: import("convex/values").VString<string, "required">;
+    createdAt: import("convex/values").VFloat64<number, "required">;
+}, "required", "sourceType" | "orgId" | "intakeId" | "objectId" | "createdAt" | "systemId" | "externalEventType" | "payloadJson">], "required", "sourceType" | "orgId" | "intakeId" | "objectId" | "sujet" | "expediteur" | "destinataires" | "dateReception" | "mimeType" | "createdAt" | "storageId" | "sizeBytes" | "lotObjectId" | "pieceType" | "systemId" | "externalEventType" | "payloadJson" | "threadId" | "nomenclatureKey" | "signataire" | "signingRef">;
+export type IntakeEventMailV1 = {
+    sourceType: "mail";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    sujet: string;
+    expediteur: string;
+    destinataires: string[];
+    threadId?: string;
+    dateReception: number;
+    mimeType: string;
+    createdAt: number;
+};
+export type IntakeEventDocumentV1 = {
+    sourceType: "document";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    storageId: string;
+    mimeType: string;
+    sizeBytes: number;
+    nomenclatureKey?: string;
+    createdAt: number;
+};
+export type IntakeEventContractV1 = {
+    sourceType: "contract";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    storageId: string;
+    mimeType: string;
+    sizeBytes: number;
+    signataire?: string;
+    signingRef?: string;
+    createdAt: number;
+};
+export type IntakeEventCandidatureV1 = {
+    sourceType: "candidature";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    lotObjectId: string;
+    pieceType: "identite" | "justificatif_domicile" | "justificatif_revenus" | "avis_imposition" | "quittances_loyer" | "autre";
+    storageId: string;
+    mimeType: string;
+    createdAt: number;
+};
+export type IntakeEventExternalV1 = {
+    sourceType: "external-event";
+    orgId: string;
+    intakeId: string;
+    objectId: string;
+    systemId: string;
+    externalEventType: string;
+    payloadJson: string;
+    createdAt: number;
+};
+/** Union of all intake event V1 variants */
+export type IntakeEventV1 = IntakeEventMailV1 | IntakeEventDocumentV1 | IntakeEventContractV1 | IntakeEventCandidatureV1 | IntakeEventExternalV1;
+//# sourceMappingURL=intake-event-v1.d.ts.map

package/dist/schemas/intake-event-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intake-event-v1.d.ts","sourceRoot":"","sources":["../../src/schemas/intake-event-v1.ts"],"names":[],"mappings":"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"}

package/dist/schemas/intake-event-v1.js

@@ -0,0 +1,99 @@
+/**
+ * intake-event-v1 — Versioned schema for intake pipeline events.
+ *
+ * Discriminated union on sourceType — 5 variants:
+ *   mail        — inbound mail ingested from Gmail push / Composio
+ *   document    — document ingested from Drive webhook / manual upload
+ *   contract    — contract document (sous-type discriminé du document)
+ *   candidature — candidature pieces (F11 — locataire candidate)
+ *   external-event — tiers system webhook (Hektor, LOJII, Immodvisor …)
+ *
+ * Rule: no v.any(), no opaque v.string() at public boundaries (Pi doctrine).
+ * Naming: V1 suffix on all exported symbols.
+ */
+import { v } from "convex/values";
+// ---------------------------------------------------------------------------
+// Variant sub-validators (reusable by callers)
+// ---------------------------------------------------------------------------
+/** Mail intake variant — sujet, expediteur, thread context */
+export const vIntakeEventMailV1 = v.object({
+    sourceType: v.literal("mail"),
+    orgId: v.string(),
+    intakeId: v.string(),
+    objectId: v.string(),
+    sujet: v.string(),
+    expediteur: v.string(),
+    destinataires: v.array(v.string()),
+    threadId: v.optional(v.string()),
+    dateReception: v.number(),
+    mimeType: v.string(),
+    createdAt: v.number(),
+});
+/** Document intake variant — storage reference + type document */
+export const vIntakeEventDocumentV1 = v.object({
+    sourceType: v.literal("document"),
+    orgId: v.string(),
+    intakeId: v.string(),
+    objectId: v.string(),
+    storageId: v.string(),
+    mimeType: v.string(),
+    sizeBytes: v.number(),
+    /** Canonical nomenclature key e.g. "BAIL_ENTRANT", "RELEVE_CHARGES" */
+    nomenclatureKey: v.optional(v.string()),
+    createdAt: v.number(),
+});
+/** Contract intake variant — document with mandatory contract metadata */
+export const vIntakeEventContractV1 = v.object({
+    sourceType: v.literal("contract"),
+    orgId: v.string(),
+    intakeId: v.string(),
+    objectId: v.string(),
+    storageId: v.string(),
+    mimeType: v.string(),
+    sizeBytes: v.number(),
+    /** Clerk userId of the signer (if known at intake time) */
+    signataire: v.optional(v.string()),
+    /** Signing platform reference e.g. Yousign envelope ID */
+    signingRef: v.optional(v.string()),
+    createdAt: v.number(),
+});
+/** Candidature intake variant — F11 locataire candidate */
+export const vIntakeEventCandidatureV1 = v.object({
+    sourceType: v.literal("candidature"),
+    orgId: v.string(),
+    intakeId: v.string(),
+    objectId: v.string(),
+    /** ID of the lot (customObject) the candidature targets */
+    lotObjectId: v.string(),
+    /** Piece type for this candidature item */
+    pieceType: v.union(v.literal("identite"), v.literal("justificatif_domicile"), v.literal("justificatif_revenus"), v.literal("avis_imposition"), v.literal("quittances_loyer"), v.literal("autre")),
+    storageId: v.string(),
+    mimeType: v.string(),
+    createdAt: v.number(),
+});
+/** External event intake variant — third-party system webhook */
+export const vIntakeEventExternalV1 = v.object({
+    sourceType: v.literal("external-event"),
+    orgId: v.string(),
+    intakeId: v.string(),
+    objectId: v.string(),
+    /** Stable ID of the external system e.g. "hektor", "lojii", "immodvisor" */
+    systemId: v.string(),
+    /** Event type as declared by the external system */
+    externalEventType: v.string(),
+    /** JSON-serialised payload from the external system (string, not v.any()) */
+    payloadJson: v.string(),
+    createdAt: v.number(),
+});
+// ---------------------------------------------------------------------------
+// Master discriminated union — IntakeEventV1Schema
+// ---------------------------------------------------------------------------
+/**
+ * IntakeEventV1Schema — the master validator for all intake event variants.
+ *
+ * Usage:
+ *   import { IntakeEventV1Schema } from "@vantage/event-schemas";
+ *   const validated = validatePayload(IntakeEventV1Schema, rawPayload);
+ */
+export const IntakeEventV1Schema = v.union(vIntakeEventMailV1, vIntakeEventDocumentV1, vIntakeEventContractV1, vIntakeEventCandidatureV1, vIntakeEventExternalV1);
+//# sourceMappingURL=intake-event-v1.js.map

package/dist/schemas/intake-event-v1.js.map

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

package/dist/schemas/task-complete-v1.d.ts

@@ -0,0 +1,138 @@
+/**
+ * task-complete-v1 — Placeholder schema for Sigma API 5 roadmap (v2).
+ *
+ * ADR reference: vantage-memory/decisions/c1-public-apis-design-2026-05-21.md
+ *   §"Hors scope C1.v1" — API 5 `issues.notifyTaskComplete` uses a typed
+ *   direct mutation in v1. For v2, this schema enables event-driven
+ *   decoupling (agent-protocol → VP-core) without structural coupling.
+ *
+ * Status: PLACEHOLDER — not consumed in production yet.
+ *   Wire-up target: C3/C4 when @vantage/agent-protocol Component is integrated.
+ *
+ * Rule: no v.any(), explicit typed fields only.
+ * Naming: V1 suffix on all exported symbols.
+ */
+/**
+ * Variant: task completed normally by an agent or user.
+ */
+export declare const vTaskCompleteNormalV1: import("convex/values").VObject<{
+    missionId?: string;
+    linkedIssueId?: string;
+    completionKind: "normal";
+    taskId: string;
+    completedBy: string;
+    completionNote: string;
+    completedAt: number;
+}, {
+    completionKind: import("convex/values").VLiteral<"normal", "required">;
+    taskId: import("convex/values").VString<string, "required">;
+    missionId: import("convex/values").VString<string | undefined, "optional">;
+    completedBy: import("convex/values").VString<string, "required">;
+    completionNote: import("convex/values").VString<string, "required">;
+    linkedIssueId: import("convex/values").VString<string | undefined, "optional">;
+    completedAt: import("convex/values").VFloat64<number, "required">;
+}, "required", "completionKind" | "taskId" | "completedBy" | "completionNote" | "completedAt" | "missionId" | "linkedIssueId">;
+/**
+ * Variant: task auto-resolved by the system (IRP cascade, timeout, etc.).
+ */
+export declare const vTaskCompleteAutoResolvedV1: import("convex/values").VObject<{
+    missionId?: string;
+    linkedIssueId?: string;
+    completionKind: "auto-resolved";
+    taskId: string;
+    completionNote: string;
+    completedAt: number;
+    resolvedBy: string;
+    reason: string;
+}, {
+    completionKind: import("convex/values").VLiteral<"auto-resolved", "required">;
+    taskId: import("convex/values").VString<string, "required">;
+    missionId: import("convex/values").VString<string | undefined, "optional">;
+    resolvedBy: import("convex/values").VString<string, "required">;
+    reason: import("convex/values").VString<string, "required">;
+    completionNote: import("convex/values").VString<string, "required">;
+    linkedIssueId: import("convex/values").VString<string | undefined, "optional">;
+    completedAt: import("convex/values").VFloat64<number, "required">;
+}, "required", "completionKind" | "taskId" | "completionNote" | "completedAt" | "resolvedBy" | "reason" | "missionId" | "linkedIssueId">;
+/**
+ * TaskCompleteV1Schema — master discriminated union.
+ *
+ * v2 usage (not yet wired):
+ *   import { TaskCompleteV1Schema } from "@vantage/event-schemas";
+ *   const validated = validatePayload(TaskCompleteV1Schema, rawEvent);
+ *   // then publish into an event bus or call notifyTaskComplete
+ */
+export declare const TaskCompleteV1Schema: import("convex/values").VUnion<{
+    missionId?: string;
+    linkedIssueId?: string;
+    completionKind: "normal";
+    taskId: string;
+    completedBy: string;
+    completionNote: string;
+    completedAt: number;
+} | {
+    missionId?: string;
+    linkedIssueId?: string;
+    completionKind: "auto-resolved";
+    taskId: string;
+    completionNote: string;
+    completedAt: number;
+    resolvedBy: string;
+    reason: string;
+}, [import("convex/values").VObject<{
+    missionId?: string;
+    linkedIssueId?: string;
+    completionKind: "normal";
+    taskId: string;
+    completedBy: string;
+    completionNote: string;
+    completedAt: number;
+}, {
+    completionKind: import("convex/values").VLiteral<"normal", "required">;
+    taskId: import("convex/values").VString<string, "required">;
+    missionId: import("convex/values").VString<string | undefined, "optional">;
+    completedBy: import("convex/values").VString<string, "required">;
+    completionNote: import("convex/values").VString<string, "required">;
+    linkedIssueId: import("convex/values").VString<string | undefined, "optional">;
+    completedAt: import("convex/values").VFloat64<number, "required">;
+}, "required", "completionKind" | "taskId" | "completedBy" | "completionNote" | "completedAt" | "missionId" | "linkedIssueId">, import("convex/values").VObject<{
+    missionId?: string;
+    linkedIssueId?: string;
+    completionKind: "auto-resolved";
+    taskId: string;
+    completionNote: string;
+    completedAt: number;
+    resolvedBy: string;
+    reason: string;
+}, {
+    completionKind: import("convex/values").VLiteral<"auto-resolved", "required">;
+    taskId: import("convex/values").VString<string, "required">;
+    missionId: import("convex/values").VString<string | undefined, "optional">;
+    resolvedBy: import("convex/values").VString<string, "required">;
+    reason: import("convex/values").VString<string, "required">;
+    completionNote: import("convex/values").VString<string, "required">;
+    linkedIssueId: import("convex/values").VString<string | undefined, "optional">;
+    completedAt: import("convex/values").VFloat64<number, "required">;
+}, "required", "completionKind" | "taskId" | "completionNote" | "completedAt" | "resolvedBy" | "reason" | "missionId" | "linkedIssueId">], "required", "completionKind" | "taskId" | "completedBy" | "completionNote" | "completedAt" | "resolvedBy" | "reason" | "missionId" | "linkedIssueId">;
+export type TaskCompleteNormalV1 = {
+    completionKind: "normal";
+    taskId: string;
+    missionId?: string;
+    completedBy: string;
+    completionNote: string;
+    linkedIssueId?: string;
+    completedAt: number;
+};
+export type TaskCompleteAutoResolvedV1 = {
+    completionKind: "auto-resolved";
+    taskId: string;
+    missionId?: string;
+    resolvedBy: string;
+    reason: string;
+    completionNote: string;
+    linkedIssueId?: string;
+    completedAt: number;
+};
+/** Union of all task-complete V1 variants */
+export type TaskCompleteV1 = TaskCompleteNormalV1 | TaskCompleteAutoResolvedV1;
+//# sourceMappingURL=task-complete-v1.d.ts.map

package/dist/schemas/task-complete-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-complete-v1.d.ts","sourceRoot":"","sources":["../../src/schemas/task-complete-v1.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;8HAQhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;wIAStC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gSAGhC,CAAC;AAMF,MAAM,MAAM,oBAAoB,GAAG;IACjC,cAAc,EAAE,QAAQ,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,cAAc,EAAE,eAAe,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG,0BAA0B,CAAC"}

package/dist/schemas/task-complete-v1.js

@@ -0,0 +1,53 @@
+/**
+ * task-complete-v1 — Placeholder schema for Sigma API 5 roadmap (v2).
+ *
+ * ADR reference: vantage-memory/decisions/c1-public-apis-design-2026-05-21.md
+ *   §"Hors scope C1.v1" — API 5 `issues.notifyTaskComplete` uses a typed
+ *   direct mutation in v1. For v2, this schema enables event-driven
+ *   decoupling (agent-protocol → VP-core) without structural coupling.
+ *
+ * Status: PLACEHOLDER — not consumed in production yet.
+ *   Wire-up target: C3/C4 when @vantage/agent-protocol Component is integrated.
+ *
+ * Rule: no v.any(), explicit typed fields only.
+ * Naming: V1 suffix on all exported symbols.
+ */
+import { v } from "convex/values";
+// ---------------------------------------------------------------------------
+// TaskCompleteV1Schema — discriminated union (roadmap v2, placeholder)
+// ---------------------------------------------------------------------------
+/**
+ * Variant: task completed normally by an agent or user.
+ */
+export const vTaskCompleteNormalV1 = v.object({
+    completionKind: v.literal("normal"),
+    taskId: v.string(),
+    missionId: v.optional(v.string()),
+    completedBy: v.string(),
+    completionNote: v.string(),
+    linkedIssueId: v.optional(v.string()),
+    completedAt: v.number(),
+});
+/**
+ * Variant: task auto-resolved by the system (IRP cascade, timeout, etc.).
+ */
+export const vTaskCompleteAutoResolvedV1 = v.object({
+    completionKind: v.literal("auto-resolved"),
+    taskId: v.string(),
+    missionId: v.optional(v.string()),
+    resolvedBy: v.string(),
+    reason: v.string(),
+    completionNote: v.string(),
+    linkedIssueId: v.optional(v.string()),
+    completedAt: v.number(),
+});
+/**
+ * TaskCompleteV1Schema — master discriminated union.
+ *
+ * v2 usage (not yet wired):
+ *   import { TaskCompleteV1Schema } from "@vantage/event-schemas";
+ *   const validated = validatePayload(TaskCompleteV1Schema, rawEvent);
+ *   // then publish into an event bus or call notifyTaskComplete
+ */
+export const TaskCompleteV1Schema = v.union(vTaskCompleteNormalV1, vTaskCompleteAutoResolvedV1);
+//# sourceMappingURL=task-complete-v1.js.map

package/dist/schemas/task-complete-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-complete-v1.js","sourceRoot":"","sources":["../../src/schemas/task-complete-v1.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAE9E;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACrC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACrC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CACzC,qBAAqB,EACrB,2BAA2B,CAC5B,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@vantageos/event-schemas",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Versioned event schema registry for Vantage Immo feature MCPs. Code-side validators — no DB table. Validates before publication into intakeEvents.",
+  "license": "MIT",
+  "author": "VantageOS Team",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elpiarthera/vantage-immo.git",
+    "directory": "packages/event-schemas"
+  },
+  "keywords": [
+    "vantageos",
+    "event-schemas",
+    "convex",
+    "validation",
+    "intake"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "package.json",
+    "README.md",
+    "LICENSE",
+    "convex.config.ts"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "convex": ">=1.16.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "convex": "^1.16.0"
+  }
+}