requ-mcp 0.2.0 → 0.5.0

package/dist/schema.d.ts

@@ -3,20 +3,48 @@ import { z } from "zod";
  * The requ-mcp data model.
  *
  * Traceability spine:
- *   Requirement → User Story → Acceptance Criterion → TestLink ──┐
- *                                                                 │ (resolved per phase)
- *   Phase → Execution (test result for a given run) ─────────────┘
+ *   Component ← Requirement → User Story → (acceptance criteria)
+ *                                ↑
+ *   Phase → Execution (a scenario result for a run) ─── @US-xxx tag in feature files
  *
- * A TestLink is pure intent ("this Conductor test verifies this criterion").
- * Results are Executions owned by a Phase, so coverage is computed *per phase*
- * and its evolution can be tracked across releases.
- *
- * Everything is persisted as flat YAML in `.requ/`.
+ * Component: a sub-system/module that maps to broker domain_tags.
+ * Phase.id is free-form — use the same value as the broker phase_id (e.g. "P1")
+ * so both systems share a single identifier.
  */
 export declare const Priority: z.ZodEnum<["low", "medium", "high", "critical"]>;
 export type Priority = z.infer<typeof Priority>;
 /** ISO-8601 timestamp string. */
 export declare const Timestamp: z.ZodString;
+export declare const ComponentStatus: z.ZodEnum<["active", "deprecated"]>;
+export type ComponentStatus = z.infer<typeof ComponentStatus>;
+export declare const Component: z.ZodObject<{
+    /** Unique identifier. Use the same value as broker domain_tag (e.g. 'C-auth'). */
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    /** Broker routing tags this component maps to. E.g. ["auth","security"]. */
+    domainTags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    status: z.ZodDefault<z.ZodEnum<["active", "deprecated"]>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "active" | "deprecated";
+    id: string;
+    name: string;
+    description: string;
+    domainTags: string[];
+    createdAt: string;
+    updatedAt: string;
+}, {
+    id: string;
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+    status?: "active" | "deprecated" | undefined;
+    description?: string | undefined;
+    domainTags?: string[] | undefined;
+}>;
+export type Component = z.infer<typeof Component>;
 export declare const RequirementStatus: z.ZodEnum<["active", "deprecated"]>;
 export type RequirementStatus = z.infer<typeof RequirementStatus>;
 export declare const Requirement: z.ZodObject<{
@@ -26,34 +54,39 @@ export declare const Requirement: z.ZodObject<{
     /** Provenance: where this requirement came from (doc, spec section, ticket). */
     source: z.ZodDefault<z.ZodString>;
     priority: z.ZodDefault<z.ZodEnum<["low", "medium", "high", "critical"]>>;
-    /** Sub-systems / modules this requirement belongs to (used to slice coverage). */
+    /** Component IDs this requirement belongs to (matches Component.id). */
     components: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     status: z.ZodDefault<z.ZodEnum<["active", "deprecated"]>>;
+    /** Target phase this requirement is planned for (matches Phase.id). Optional;
+     *  unassigned requirements are always in scope for every phase report. */
+    phase: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     status: "active" | "deprecated";
     id: string;
-    title: string;
     description: string;
+    createdAt: string;
+    updatedAt: string;
+    title: string;
     source: string;
     priority: "low" | "medium" | "high" | "critical";
     components: string[];
     tags: string[];
-    createdAt: string;
-    updatedAt: string;
+    phase?: string | undefined;
 }, {
     id: string;
-    title: string;
     createdAt: string;
     updatedAt: string;
+    title: string;
     status?: "active" | "deprecated" | undefined;
     description?: string | undefined;
     source?: string | undefined;
     priority?: "low" | "medium" | "high" | "critical" | undefined;
     components?: string[] | undefined;
     tags?: string[] | undefined;
+    phase?: string | undefined;
 }>;
 export type Requirement = z.infer<typeof Requirement>;
 export declare const TestStatus: z.ZodEnum<["pass", "fail", "pending"]>;
@@ -95,28 +128,34 @@ export declare const UserStory: z.ZodObject<{
         text: string;
     }>, "many">>;
     status: z.ZodDefault<z.ZodEnum<["draft", "ready", "in_progress", "done"]>>;
+    /** Target phase this story is planned for (matches Phase.id). Optional and
+     *  independent of the story's requirements; unassigned stories are always in
+     *  scope for every phase report. */
+    phase: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     status: "draft" | "ready" | "in_progress" | "done";
     id: string;
-    title: string;
     description: string;
     createdAt: string;
     updatedAt: string;
+    title: string;
     requirements: string[];
     acceptanceCriteria: {
         id: string;
         text: string;
     }[];
+    phase?: string | undefined;
 }, {
     id: string;
-    title: string;
     createdAt: string;
     updatedAt: string;
+    title: string;
     requirements: string[];
     status?: "draft" | "ready" | "in_progress" | "done" | undefined;
     description?: string | undefined;
+    phase?: string | undefined;
     acceptanceCriteria?: {
         id: string;
         text: string;
@@ -126,6 +165,11 @@ export type UserStory = z.infer<typeof UserStory>;
 export declare const PhaseStatus: z.ZodEnum<["planned", "active", "completed"]>;
 export type PhaseStatus = z.infer<typeof PhaseStatus>;
 export declare const Phase: z.ZodObject<{
+    /**
+     * Free-form identifier. Use the same value as the broker phase_id
+     * (e.g. "P1", "Sprint-3") so both systems share one identifier.
+     * Previously required PHASE-\d+ format; that format is still valid.
+     */
     id: z.ZodString;
     name: z.ZodString;
     /** Sort key for evolution; lower = earlier. */
@@ -137,16 +181,16 @@ export declare const Phase: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     status: "active" | "planned" | "completed";
     id: string;
+    name: string;
     description: string;
     createdAt: string;
     updatedAt: string;
-    name: string;
     order: number;
 }, {
     id: string;
+    name: string;
     createdAt: string;
     updatedAt: string;
-    name: string;
     order: number;
     status?: "active" | "planned" | "completed" | undefined;
     description?: string | undefined;
@@ -165,8 +209,8 @@ export declare const Execution: z.ZodObject<{
     name: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     status: "pass" | "fail" | "pending";
-    source: "manual" | "cucumber-json" | "import";
     name: string;
+    source: "manual" | "cucumber-json" | "import";
     ranAt: string;
     feature: string;
     runId?: string | undefined;
@@ -181,7 +225,7 @@ export declare const Execution: z.ZodObject<{
     note?: string | undefined;
 }>;
 export type Execution = z.infer<typeof Execution>;
-/** Per-phase execution log file shape. */
+/** Per-phase execution log file shape (YAML mode). */
 export declare const ExecutionLog: z.ZodObject<{
     phase: z.ZodString;
     runs: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -195,8 +239,8 @@ export declare const ExecutionLog: z.ZodObject<{
         name: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         status: "pass" | "fail" | "pending";
-        source: "manual" | "cucumber-json" | "import";
         name: string;
+        source: "manual" | "cucumber-json" | "import";
         ranAt: string;
         feature: string;
         runId?: string | undefined;
@@ -214,8 +258,8 @@ export declare const ExecutionLog: z.ZodObject<{
     phase: string;
     runs: {
         status: "pass" | "fail" | "pending";
-        source: "manual" | "cucumber-json" | "import";
         name: string;
+        source: "manual" | "cucumber-json" | "import";
         ranAt: string;
         feature: string;
         runId?: string | undefined;
@@ -236,31 +280,625 @@ export declare const ExecutionLog: z.ZodObject<{
 export type ExecutionLog = z.infer<typeof ExecutionLog>;
 export declare const Config: z.ZodObject<{
     name: z.ZodDefault<z.ZodString>;
-    /**
-     * Path to the Conductor project root (dir containing features/ and flows/).
-     * Absolute, or relative to the .requ/ parent (the repo root).
-     */
+    key: z.ZodOptional<z.ZodString>;
+    brief: z.ZodOptional<z.ZodString>;
     conductorPath: z.ZodDefault<z.ZodString>;
-    /** Detected name of the Conductor project (package.json name or folder name). */
     conductorName: z.ZodOptional<z.ZodString>;
-    /** Default path to Conductor's cucumber-json result file (for import). */
     conductorReportPath: z.ZodOptional<z.ZodString>;
-    /** The phase new executions are recorded against by default. */
+    /** Free-form phase identifier (e.g. "P1"). */
     activePhase: z.ZodOptional<z.ZodString>;
+    /** VCS repository reference (requ-mcp never calls VCS; it only records references). */
+    repoUrl: z.ZodOptional<z.ZodString>;
+    /** Default branch name; treated as "main" when unset. */
+    defaultBranch: z.ZodOptional<z.ZodString>;
+    vcsType: z.ZodOptional<z.ZodEnum<["gitlab"]>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     conductorPath: string;
+    key?: string | undefined;
+    brief?: string | undefined;
     conductorName?: string | undefined;
     conductorReportPath?: string | undefined;
     activePhase?: string | undefined;
+    repoUrl?: string | undefined;
+    defaultBranch?: string | undefined;
+    vcsType?: "gitlab" | undefined;
 }, {
     name?: string | undefined;
+    key?: string | undefined;
+    brief?: string | undefined;
     conductorPath?: string | undefined;
     conductorName?: string | undefined;
     conductorReportPath?: string | undefined;
     activePhase?: string | undefined;
+    repoUrl?: string | undefined;
+    defaultBranch?: string | undefined;
+    vcsType?: "gitlab" | undefined;
 }>;
 export type Config = z.infer<typeof Config>;
+export declare const VcsRefKind: z.ZodEnum<["branch", "mr"]>;
+export type VcsRefKind = z.infer<typeof VcsRefKind>;
+export declare const VcsRefState: z.ZodEnum<["opened", "merged", "closed"]>;
+export type VcsRefState = z.infer<typeof VcsRefState>;
+export declare const VcsRef: z.ZodObject<{
+    /** Auto-id, e.g. "MR-5" / "BR-1". */
+    id: z.ZodString;
+    kind: z.ZodEnum<["branch", "mr"]>;
+    /** MR iid as string, or branch name. */
+    ref: z.ZodString;
+    url: z.ZodDefault<z.ZodString>;
+    branch: z.ZodDefault<z.ZodString>;
+    targetBranch: z.ZodOptional<z.ZodString>;
+    component: z.ZodOptional<z.ZodString>;
+    storyIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    requirementIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    state: z.ZodDefault<z.ZodEnum<["opened", "merged", "closed"]>>;
+    mergeCommit: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    branch: string;
+    kind: "branch" | "mr";
+    ref: string;
+    url: string;
+    storyIds: string[];
+    requirementIds: string[];
+    state: "opened" | "merged" | "closed";
+    targetBranch?: string | undefined;
+    component?: string | undefined;
+    mergeCommit?: string | undefined;
+}, {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    kind: "branch" | "mr";
+    ref: string;
+    branch?: string | undefined;
+    url?: string | undefined;
+    targetBranch?: string | undefined;
+    component?: string | undefined;
+    storyIds?: string[] | undefined;
+    requirementIds?: string[] | undefined;
+    state?: "opened" | "merged" | "closed" | undefined;
+    mergeCommit?: string | undefined;
+}>;
+export type VcsRef = z.infer<typeof VcsRef>;
 /** Coverage resolution mode across phases. */
 export declare const CoverageMode: z.ZodEnum<["cumulative", "strict"]>;
 export type CoverageMode = z.infer<typeof CoverageMode>;
+export declare const ExportPayload: z.ZodObject<{
+    version: z.ZodLiteral<"1">;
+    exportedAt: z.ZodString;
+    source: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+    }, {
+        name: string;
+    }>>;
+    data: z.ZodObject<{
+        components: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            /** Unique identifier. Use the same value as broker domain_tag (e.g. 'C-auth'). */
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodDefault<z.ZodString>;
+            /** Broker routing tags this component maps to. E.g. ["auth","security"]. */
+            domainTags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            status: z.ZodDefault<z.ZodEnum<["active", "deprecated"]>>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            status: "active" | "deprecated";
+            id: string;
+            name: string;
+            description: string;
+            domainTags: string[];
+            createdAt: string;
+            updatedAt: string;
+        }, {
+            id: string;
+            name: string;
+            createdAt: string;
+            updatedAt: string;
+            status?: "active" | "deprecated" | undefined;
+            description?: string | undefined;
+            domainTags?: string[] | undefined;
+        }>, "many">>;
+        requirements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodDefault<z.ZodString>;
+            /** Provenance: where this requirement came from (doc, spec section, ticket). */
+            source: z.ZodDefault<z.ZodString>;
+            priority: z.ZodDefault<z.ZodEnum<["low", "medium", "high", "critical"]>>;
+            /** Component IDs this requirement belongs to (matches Component.id). */
+            components: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            status: z.ZodDefault<z.ZodEnum<["active", "deprecated"]>>;
+            /** Target phase this requirement is planned for (matches Phase.id). Optional;
+             *  unassigned requirements are always in scope for every phase report. */
+            phase: z.ZodOptional<z.ZodString>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            status: "active" | "deprecated";
+            id: string;
+            description: string;
+            createdAt: string;
+            updatedAt: string;
+            title: string;
+            source: string;
+            priority: "low" | "medium" | "high" | "critical";
+            components: string[];
+            tags: string[];
+            phase?: string | undefined;
+        }, {
+            id: string;
+            createdAt: string;
+            updatedAt: string;
+            title: string;
+            status?: "active" | "deprecated" | undefined;
+            description?: string | undefined;
+            source?: string | undefined;
+            priority?: "low" | "medium" | "high" | "critical" | undefined;
+            components?: string[] | undefined;
+            tags?: string[] | undefined;
+            phase?: string | undefined;
+        }>, "many">>;
+        stories: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodDefault<z.ZodString>;
+            /** Must contain at least one requirement id. Enforced at write time. */
+            requirements: z.ZodArray<z.ZodString, "many">;
+            acceptanceCriteria: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                text: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                text: string;
+            }, {
+                id: string;
+                text: string;
+            }>, "many">>;
+            status: z.ZodDefault<z.ZodEnum<["draft", "ready", "in_progress", "done"]>>;
+            /** Target phase this story is planned for (matches Phase.id). Optional and
+             *  independent of the story's requirements; unassigned stories are always in
+             *  scope for every phase report. */
+            phase: z.ZodOptional<z.ZodString>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            status: "draft" | "ready" | "in_progress" | "done";
+            id: string;
+            description: string;
+            createdAt: string;
+            updatedAt: string;
+            title: string;
+            requirements: string[];
+            acceptanceCriteria: {
+                id: string;
+                text: string;
+            }[];
+            phase?: string | undefined;
+        }, {
+            id: string;
+            createdAt: string;
+            updatedAt: string;
+            title: string;
+            requirements: string[];
+            status?: "draft" | "ready" | "in_progress" | "done" | undefined;
+            description?: string | undefined;
+            phase?: string | undefined;
+            acceptanceCriteria?: {
+                id: string;
+                text: string;
+            }[] | undefined;
+        }>, "many">>;
+        phases: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            /**
+             * Free-form identifier. Use the same value as the broker phase_id
+             * (e.g. "P1", "Sprint-3") so both systems share one identifier.
+             * Previously required PHASE-\d+ format; that format is still valid.
+             */
+            id: z.ZodString;
+            name: z.ZodString;
+            /** Sort key for evolution; lower = earlier. */
+            order: z.ZodNumber;
+            status: z.ZodDefault<z.ZodEnum<["planned", "active", "completed"]>>;
+            description: z.ZodDefault<z.ZodString>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            status: "active" | "planned" | "completed";
+            id: string;
+            name: string;
+            description: string;
+            createdAt: string;
+            updatedAt: string;
+            order: number;
+        }, {
+            id: string;
+            name: string;
+            createdAt: string;
+            updatedAt: string;
+            order: number;
+            status?: "active" | "planned" | "completed" | undefined;
+            description?: string | undefined;
+        }>, "many">>;
+        executions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+            status: z.ZodEnum<["pass", "fail", "pending"]>;
+            ranAt: z.ZodString;
+            /** Optional run identifier (CI job, report file). Latest by ranAt wins per test. */
+            runId: z.ZodOptional<z.ZodString>;
+            source: z.ZodDefault<z.ZodEnum<["manual", "cucumber-json", "import"]>>;
+            note: z.ZodOptional<z.ZodString>;
+            feature: z.ZodString;
+            name: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            status: "pass" | "fail" | "pending";
+            name: string;
+            source: "manual" | "cucumber-json" | "import";
+            ranAt: string;
+            feature: string;
+            runId?: string | undefined;
+            note?: string | undefined;
+        }, {
+            status: "pass" | "fail" | "pending";
+            name: string;
+            ranAt: string;
+            feature: string;
+            source?: "manual" | "cucumber-json" | "import" | undefined;
+            runId?: string | undefined;
+            note?: string | undefined;
+        }>, "many">>>;
+        vcsRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            /** Auto-id, e.g. "MR-5" / "BR-1". */
+            id: z.ZodString;
+            kind: z.ZodEnum<["branch", "mr"]>;
+            /** MR iid as string, or branch name. */
+            ref: z.ZodString;
+            url: z.ZodDefault<z.ZodString>;
+            branch: z.ZodDefault<z.ZodString>;
+            targetBranch: z.ZodOptional<z.ZodString>;
+            component: z.ZodOptional<z.ZodString>;
+            storyIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            requirementIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            state: z.ZodDefault<z.ZodEnum<["opened", "merged", "closed"]>>;
+            mergeCommit: z.ZodOptional<z.ZodString>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            createdAt: string;
+            updatedAt: string;
+            branch: string;
+            kind: "branch" | "mr";
+            ref: string;
+            url: string;
+            storyIds: string[];
+            requirementIds: string[];
+            state: "opened" | "merged" | "closed";
+            targetBranch?: string | undefined;
+            component?: string | undefined;
+            mergeCommit?: string | undefined;
+        }, {
+            id: string;
+            createdAt: string;
+            updatedAt: string;
+            kind: "branch" | "mr";
+            ref: string;
+            branch?: string | undefined;
+            url?: string | undefined;
+            targetBranch?: string | undefined;
+            component?: string | undefined;
+            storyIds?: string[] | undefined;
+            requirementIds?: string[] | undefined;
+            state?: "opened" | "merged" | "closed" | undefined;
+            mergeCommit?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        components: {
+            status: "active" | "deprecated";
+            id: string;
+            name: string;
+            description: string;
+            domainTags: string[];
+            createdAt: string;
+            updatedAt: string;
+        }[];
+        requirements: {
+            status: "active" | "deprecated";
+            id: string;
+            description: string;
+            createdAt: string;
+            updatedAt: string;
+            title: string;
+            source: string;
+            priority: "low" | "medium" | "high" | "critical";
+            components: string[];
+            tags: string[];
+            phase?: string | undefined;
+        }[];
+        stories: {
+            status: "draft" | "ready" | "in_progress" | "done";
+            id: string;
+            description: string;
+            createdAt: string;
+            updatedAt: string;
+            title: string;
+            requirements: string[];
+            acceptanceCriteria: {
+                id: string;
+                text: string;
+            }[];
+            phase?: string | undefined;
+        }[];
+        phases: {
+            status: "active" | "planned" | "completed";
+            id: string;
+            name: string;
+            description: string;
+            createdAt: string;
+            updatedAt: string;
+            order: number;
+        }[];
+        executions: Record<string, {
+            status: "pass" | "fail" | "pending";
+            name: string;
+            source: "manual" | "cucumber-json" | "import";
+            ranAt: string;
+            feature: string;
+            runId?: string | undefined;
+            note?: string | undefined;
+        }[]>;
+        vcsRefs: {
+            id: string;
+            createdAt: string;
+            updatedAt: string;
+            branch: string;
+            kind: "branch" | "mr";
+            ref: string;
+            url: string;
+            storyIds: string[];
+            requirementIds: string[];
+            state: "opened" | "merged" | "closed";
+            targetBranch?: string | undefined;
+            component?: string | undefined;
+            mergeCommit?: string | undefined;
+        }[];
+    }, {
+        components?: {
+            id: string;
+            name: string;
+            createdAt: string;
+            updatedAt: string;
+            status?: "active" | "deprecated" | undefined;
+            description?: string | undefined;
+            domainTags?: string[] | undefined;
+        }[] | undefined;
+        requirements?: {
+            id: string;
+            createdAt: string;
+            updatedAt: string;
+            title: string;
+            status?: "active" | "deprecated" | undefined;
+            description?: string | undefined;
+            source?: string | undefined;
+            priority?: "low" | "medium" | "high" | "critical" | undefined;
+            components?: string[] | undefined;
+            tags?: string[] | undefined;
+            phase?: string | undefined;
+        }[] | undefined;
+        stories?: {
+            id: string;
+            createdAt: string;
+            updatedAt: string;
+            title: string;
+            requirements: string[];
+            status?: "draft" | "ready" | "in_progress" | "done" | undefined;
+            description?: string | undefined;
+            phase?: string | undefined;
+            acceptanceCriteria?: {
+                id: string;
+                text: string;
+            }[] | undefined;
+        }[] | undefined;
+        phases?: {
+            id: string;
+            name: string;
+            createdAt: string;
+            updatedAt: string;
+            order: number;
+            status?: "active" | "planned" | "completed" | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+        executions?: Record<string, {
+            status: "pass" | "fail" | "pending";
+            name: string;
+            ranAt: string;
+            feature: string;
+            source?: "manual" | "cucumber-json" | "import" | undefined;
+            runId?: string | undefined;
+            note?: string | undefined;
+        }[]> | undefined;
+        vcsRefs?: {
+            id: string;
+            createdAt: string;
+            updatedAt: string;
+            kind: "branch" | "mr";
+            ref: string;
+            branch?: string | undefined;
+            url?: string | undefined;
+            targetBranch?: string | undefined;
+            component?: string | undefined;
+            storyIds?: string[] | undefined;
+            requirementIds?: string[] | undefined;
+            state?: "opened" | "merged" | "closed" | undefined;
+            mergeCommit?: string | undefined;
+        }[] | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    version: "1";
+    exportedAt: string;
+    data: {
+        components: {
+            status: "active" | "deprecated";
+            id: string;
+            name: string;
+            description: string;
+            domainTags: string[];
+            createdAt: string;
+            updatedAt: string;
+        }[];
+        requirements: {
+            status: "active" | "deprecated";
+            id: string;
+            description: string;
+            createdAt: string;
+            updatedAt: string;
+            title: string;
+            source: string;
+            priority: "low" | "medium" | "high" | "critical";
+            components: string[];
+            tags: string[];
+            phase?: string | undefined;
+        }[];
+        stories: {
+            status: "draft" | "ready" | "in_progress" | "done";
+            id: string;
+            description: string;
+            createdAt: string;
+            updatedAt: string;
+            title: string;
+            requirements: string[];
+            acceptanceCriteria: {
+                id: string;
+                text: string;
+            }[];
+            phase?: string | undefined;
+        }[];
+        phases: {
+            status: "active" | "planned" | "completed";
+            id: string;
+            name: string;
+            description: string;
+            createdAt: string;
+            updatedAt: string;
+            order: number;
+        }[];
+        executions: Record<string, {
+            status: "pass" | "fail" | "pending";
+            name: string;
+            source: "manual" | "cucumber-json" | "import";
+            ranAt: string;
+            feature: string;
+            runId?: string | undefined;
+            note?: string | undefined;
+        }[]>;
+        vcsRefs: {
+            id: string;
+            createdAt: string;
+            updatedAt: string;
+            branch: string;
+            kind: "branch" | "mr";
+            ref: string;
+            url: string;
+            storyIds: string[];
+            requirementIds: string[];
+            state: "opened" | "merged" | "closed";
+            targetBranch?: string | undefined;
+            component?: string | undefined;
+            mergeCommit?: string | undefined;
+        }[];
+    };
+    source?: {
+        name: string;
+    } | undefined;
+}, {
+    version: "1";
+    exportedAt: string;
+    data: {
+        components?: {
+            id: string;
+            name: string;
+            createdAt: string;
+            updatedAt: string;
+            status?: "active" | "deprecated" | undefined;
+            description?: string | undefined;
+            domainTags?: string[] | undefined;
+        }[] | undefined;
+        requirements?: {
+            id: string;
+            createdAt: string;
+            updatedAt: string;
+            title: string;
+            status?: "active" | "deprecated" | undefined;
+            description?: string | undefined;
+            source?: string | undefined;
+            priority?: "low" | "medium" | "high" | "critical" | undefined;
+            components?: string[] | undefined;
+            tags?: string[] | undefined;
+            phase?: string | undefined;
+        }[] | undefined;
+        stories?: {
+            id: string;
+            createdAt: string;
+            updatedAt: string;
+            title: string;
+            requirements: string[];
+            status?: "draft" | "ready" | "in_progress" | "done" | undefined;
+            description?: string | undefined;
+            phase?: string | undefined;
+            acceptanceCriteria?: {
+                id: string;
+                text: string;
+            }[] | undefined;
+        }[] | undefined;
+        phases?: {
+            id: string;
+            name: string;
+            createdAt: string;
+            updatedAt: string;
+            order: number;
+            status?: "active" | "planned" | "completed" | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+        executions?: Record<string, {
+            status: "pass" | "fail" | "pending";
+            name: string;
+            ranAt: string;
+            feature: string;
+            source?: "manual" | "cucumber-json" | "import" | undefined;
+            runId?: string | undefined;
+            note?: string | undefined;
+        }[]> | undefined;
+        vcsRefs?: {
+            id: string;
+            createdAt: string;
+            updatedAt: string;
+            kind: "branch" | "mr";
+            ref: string;
+            branch?: string | undefined;
+            url?: string | undefined;
+            targetBranch?: string | undefined;
+            component?: string | undefined;
+            storyIds?: string[] | undefined;
+            requirementIds?: string[] | undefined;
+            state?: "opened" | "merged" | "closed" | undefined;
+            mergeCommit?: string | undefined;
+        }[] | undefined;
+    };
+    source?: {
+        name: string;
+    } | undefined;
+}>;
+export type ExportPayload = z.infer<typeof ExportPayload>;
+export type ImportReport = {
+    imported: Record<string, number>;
+    skipped: Record<string, string[]>;
+    errors: string[];
+};