@schnick371/devsteps-shared 1.1.0-next.4 → 2.0.0-next.1

package/dist/schemas/guide-acceptance.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Schemas for opt-in guide acceptance sessions.
+ */
+import { z } from 'zod';
+export declare const GuideAcceptanceMode: z.ZodEnum<{
+    "autonomous-guide": "autonomous-guide";
+    "human-guided-guide": "human-guided-guide";
+}>;
+export type GuideAcceptanceMode = z.infer<typeof GuideAcceptanceMode>;
+export declare const GuideAcceptanceStatus: z.ZodEnum<{
+    aborted: "aborted";
+    completed: "completed";
+    failed: "failed";
+    "in-progress": "in-progress";
+    open: "open";
+}>;
+export type GuideAcceptanceStatus = z.infer<typeof GuideAcceptanceStatus>;
+export declare const GuideCheckpointStatus: z.ZodEnum<{
+    failed: "failed";
+    passed: "passed";
+    pending: "pending";
+    skipped: "skipped";
+}>;
+export type GuideCheckpointStatus = z.infer<typeof GuideCheckpointStatus>;
+export declare const GuideFailureClass: z.ZodEnum<{
+    environment_blocker: "environment_blocker";
+    fixture_blocker: "fixture_blocker";
+    guide_drift: "guide_drift";
+    product_defect: "product_defect";
+    security_boundary: "security_boundary";
+    transient: "transient";
+}>;
+export type GuideFailureClass = z.infer<typeof GuideFailureClass>;
+export declare const GuideHumanAnswer: z.ZodEnum<{
+    negative: "negative";
+    positive: "positive";
+}>;
+export type GuideHumanAnswer = z.infer<typeof GuideHumanAnswer>;
+export declare const GuideEvidence: z.ZodObject<{
+    checkpoint_id: z.ZodString;
+    status: z.ZodEnum<{
+        failed: "failed";
+        passed: "passed";
+        pending: "pending";
+        skipped: "skipped";
+    }>;
+    summary: z.ZodDefault<z.ZodString>;
+    artifact_path: z.ZodOptional<z.ZodString>;
+    recorded_at: z.ZodString;
+    attempt: z.ZodDefault<z.ZodNumber>;
+    failure_class: z.ZodOptional<z.ZodEnum<{
+        environment_blocker: "environment_blocker";
+        fixture_blocker: "fixture_blocker";
+        guide_drift: "guide_drift";
+        product_defect: "product_defect";
+        security_boundary: "security_boundary";
+        transient: "transient";
+    }>>;
+    next_permitted_action: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GuideEvidence = z.infer<typeof GuideEvidence>;
+export declare const GuideProgressRecord: z.ZodObject<{
+    schema_version: z.ZodLiteral<"1.0">;
+    session_id: z.ZodString;
+    guide_id: z.ZodString;
+    guide_revision: z.ZodString;
+    guide_digest: z.ZodString;
+    human_guide_digest: z.ZodOptional<z.ZodString>;
+    source_path: z.ZodOptional<z.ZodString>;
+    source_digest: z.ZodOptional<z.ZodString>;
+    fixture_id: z.ZodOptional<z.ZodString>;
+    record_version: z.ZodDefault<z.ZodNumber>;
+    mode: z.ZodEnum<{
+        "autonomous-guide": "autonomous-guide";
+        "human-guided-guide": "human-guided-guide";
+    }>;
+    status: z.ZodEnum<{
+        aborted: "aborted";
+        completed: "completed";
+        failed: "failed";
+        "in-progress": "in-progress";
+        open: "open";
+    }>;
+    started_at: z.ZodString;
+    updated_at: z.ZodString;
+    completed_checkpoints: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        checkpoint_id: z.ZodString;
+        status: z.ZodEnum<{
+            failed: "failed";
+            passed: "passed";
+            pending: "pending";
+            skipped: "skipped";
+        }>;
+        summary: z.ZodDefault<z.ZodString>;
+        artifact_path: z.ZodOptional<z.ZodString>;
+        recorded_at: z.ZodString;
+        attempt: z.ZodDefault<z.ZodNumber>;
+        failure_class: z.ZodOptional<z.ZodEnum<{
+            environment_blocker: "environment_blocker";
+            fixture_blocker: "fixture_blocker";
+            guide_drift: "guide_drift";
+            product_defect: "product_defect";
+            security_boundary: "security_boundary";
+            transient: "transient";
+        }>>;
+        next_permitted_action: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    checkpoint_order: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    max_attempts: z.ZodDefault<z.ZodNumber>;
+    run_marker: z.ZodOptional<z.ZodString>;
+    current_step: z.ZodOptional<z.ZodString>;
+    failure_reason: z.ZodOptional<z.ZodString>;
+    human_checkpoint: z.ZodDefault<z.ZodBoolean>;
+    presented_checkpoint_id: z.ZodOptional<z.ZodString>;
+    last_human_answer: z.ZodOptional<z.ZodEnum<{
+        negative: "negative";
+        positive: "positive";
+    }>>;
+    cleanup_confirmed: z.ZodDefault<z.ZodBoolean>;
+    residual_state_verified: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type GuideProgressRecord = z.infer<typeof GuideProgressRecord>;
+export declare const GuideAcceptanceStart: z.ZodObject<{
+    guide_id: z.ZodString;
+    guide_revision: z.ZodString;
+    guide_digest: z.ZodString;
+    mode: z.ZodEnum<{
+        "autonomous-guide": "autonomous-guide";
+        "human-guided-guide": "human-guided-guide";
+    }>;
+    human_checkpoint: z.ZodDefault<z.ZodBoolean>;
+    checkpoint_order: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    max_attempts: z.ZodDefault<z.ZodNumber>;
+    run_marker: z.ZodOptional<z.ZodString>;
+    fixture_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GuideAcceptanceStart = z.input<typeof GuideAcceptanceStart>;
+export declare const GuideAcceptanceCheckpoint: z.ZodObject<{
+    checkpoint_id: z.ZodString;
+    status: z.ZodEnum<{
+        failed: "failed";
+        passed: "passed";
+        pending: "pending";
+        skipped: "skipped";
+    }>;
+    summary: z.ZodDefault<z.ZodString>;
+    artifact_path: z.ZodOptional<z.ZodString>;
+    attempt: z.ZodDefault<z.ZodNumber>;
+    failure_class: z.ZodOptional<z.ZodEnum<{
+        environment_blocker: "environment_blocker";
+        fixture_blocker: "fixture_blocker";
+        guide_drift: "guide_drift";
+        product_defect: "product_defect";
+        security_boundary: "security_boundary";
+        transient: "transient";
+    }>>;
+    next_permitted_action: z.ZodOptional<z.ZodString>;
+    expected_record_version: z.ZodOptional<z.ZodNumber>;
+    human_answer: z.ZodOptional<z.ZodEnum<{
+        negative: "negative";
+        positive: "positive";
+    }>>;
+    cleanup_confirmed: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type GuideAcceptanceCheckpoint = z.input<typeof GuideAcceptanceCheckpoint>;
+//# sourceMappingURL=guide-acceptance.d.ts.map

package/dist/schemas/guide-acceptance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-acceptance.d.ts","sourceRoot":"","sources":["../../src/schemas/guide-acceptance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;EAAqD,CAAC;AACtF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,eAAO,MAAM,qBAAqB;;;;;;EAMhC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E,eAAO,MAAM,qBAAqB;;;;;EAAqD,CAAC;AACxF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E,eAAO,MAAM,iBAAiB;;;;;;;EAO5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,gBAAgB;;;EAAmC,CAAC;AACjE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;iBASxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiC9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBAU/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAWpC,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/schemas/guide-acceptance.js

@@ -0,0 +1,93 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Schemas for opt-in guide acceptance sessions.
+ */
+import { z } from 'zod';
+export const GuideAcceptanceMode = z.enum(['autonomous-guide', 'human-guided-guide']);
+export const GuideAcceptanceStatus = z.enum([
+    'open',
+    'in-progress',
+    'completed',
+    'failed',
+    'aborted',
+]);
+export const GuideCheckpointStatus = z.enum(['pending', 'passed', 'failed', 'skipped']);
+export const GuideFailureClass = z.enum([
+    'transient',
+    'product_defect',
+    'guide_drift',
+    'environment_blocker',
+    'fixture_blocker',
+    'security_boundary',
+]);
+export const GuideHumanAnswer = z.enum(['positive', 'negative']);
+export const GuideEvidence = z.object({
+    checkpoint_id: z.string().min(1),
+    status: GuideCheckpointStatus,
+    summary: z.string().max(2000).default(''),
+    artifact_path: z.string().max(500).optional(),
+    recorded_at: z.string().datetime(),
+    attempt: z.number().int().min(1).default(1),
+    failure_class: GuideFailureClass.optional(),
+    next_permitted_action: z.string().max(500).optional(),
+});
+export const GuideProgressRecord = z.object({
+    schema_version: z.literal('1.0'),
+    session_id: z.string().uuid(),
+    guide_id: z.string().min(1).max(100),
+    guide_revision: z.string().min(1).max(50),
+    guide_digest: z.string().regex(/^sha256:[0-9a-f]{64}$/),
+    human_guide_digest: z
+        .string()
+        .regex(/^sha256:[0-9a-f]{64}$/)
+        .optional(),
+    source_path: z.string().max(500).optional(),
+    source_digest: z
+        .string()
+        .regex(/^sha256:[0-9a-f]{64}$/)
+        .optional(),
+    fixture_id: z.string().max(200).optional(),
+    record_version: z.number().int().min(1).default(1),
+    mode: GuideAcceptanceMode,
+    status: GuideAcceptanceStatus,
+    started_at: z.string().datetime(),
+    updated_at: z.string().datetime(),
+    completed_checkpoints: z.array(z.string()).default([]),
+    evidence: z.array(GuideEvidence).default([]),
+    checkpoint_order: z.array(z.string().min(1)).default([]),
+    max_attempts: z.number().int().min(1).max(10).default(2),
+    run_marker: z.string().max(500).optional(),
+    current_step: z.string().optional(),
+    failure_reason: z.string().max(2000).optional(),
+    human_checkpoint: z.boolean().default(false),
+    presented_checkpoint_id: z.string().max(100).optional(),
+    last_human_answer: GuideHumanAnswer.optional(),
+    cleanup_confirmed: z.boolean().default(false),
+    residual_state_verified: z.boolean().default(false),
+});
+export const GuideAcceptanceStart = z.object({
+    guide_id: z.string().min(1).max(100),
+    guide_revision: z.string().min(1).max(50),
+    guide_digest: z.string().regex(/^sha256:[0-9a-f]{64}$/),
+    mode: GuideAcceptanceMode,
+    human_checkpoint: z.boolean().default(false),
+    checkpoint_order: z.array(z.string().min(1)).default([]),
+    max_attempts: z.number().int().min(1).max(10).default(2),
+    run_marker: z.string().max(500).optional(),
+    fixture_id: z.string().max(200).optional(),
+});
+export const GuideAcceptanceCheckpoint = z.object({
+    checkpoint_id: z.string().min(1).max(100),
+    status: GuideCheckpointStatus,
+    summary: z.string().max(2000).default(''),
+    artifact_path: z.string().max(500).optional(),
+    attempt: z.number().int().min(1).default(1),
+    failure_class: GuideFailureClass.optional(),
+    next_permitted_action: z.string().max(500).optional(),
+    expected_record_version: z.number().int().min(1).optional(),
+    human_answer: GuideHumanAnswer.optional(),
+    cleanup_confirmed: z.boolean().default(false),
+});
+//# sourceMappingURL=guide-acceptance.js.map

package/dist/schemas/guide-acceptance.js.map

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

package/dist/schemas/index-refs.schema.d.ts

@@ -26,13 +26,14 @@ export declare const TypeIndexSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodString>;
     updated: z.ZodString;
     category: z.ZodEnum<{
+        bug: "bug";
+        doc: "doc";
         epic: "epic";
-        story: "story";
-        task: "task";
-        requirement: "requirement";
         feature: "feature";
-        bug: "bug";
+        requirement: "requirement";
         spike: "spike";
+        story: "story";
+        task: "task";
         test: "test";
     }>;
 }, z.core.$strip>;
@@ -43,14 +44,14 @@ export declare const StatusIndexSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodString>;
     updated: z.ZodString;
     category: z.ZodEnum<{
-        draft: "draft";
-        planned: "planned";
-        "in-progress": "in-progress";
-        review: "review";
-        done: "done";
         blocked: "blocked";
         cancelled: "cancelled";
+        done: "done";
+        draft: "draft";
+        "in-progress": "in-progress";
         obsolete: "obsolete";
+        planned: "planned";
+        review: "review";
     }>;
 }, z.core.$strip>;
 /**
@@ -60,10 +61,10 @@ export declare const PriorityIndexSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodString>;
     updated: z.ZodString;
     category: z.ZodEnum<{
-        "urgent-important": "urgent-important";
         "not-urgent-important": "not-urgent-important";
-        "urgent-not-important": "urgent-not-important";
         "not-urgent-not-important": "not-urgent-not-important";
+        "urgent-important": "urgent-important";
+        "urgent-not-important": "urgent-not-important";
     }>;
 }, z.core.$strip>;
 /**

package/dist/schemas/index-refs.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-refs.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/index-refs.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;iBAS9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;iBAE1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;iBAW5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;iBAO9B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc,uCAM1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;iBAO3B,CAAC;AAEH;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAExF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAEhF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAEpF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAExF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAE9E"}
+{"version":3,"file":"index-refs.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/index-refs.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;iBAS9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;iBAY1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;iBAW5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;iBAO9B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc,uCAG1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;iBAO3B,CAAC;AAEH;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAExF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAEhF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAEpF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAExF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAE9E"}

package/dist/schemas/index-refs.schema.js

@@ -18,7 +18,7 @@ export const CategoryIndexSchema = z.object({
     /** Category name */
     category: z.string(),
     /** Array of item IDs */
-    items: z.array(z.string().regex(/^(EPIC|STORY|TASK|REQ|FEAT|BUG|SPIKE|TEST)-\d{3,}$/)),
+    items: z.array(z.string().regex(/^(EPIC|STORY|TASK|REQ|FEAT|BUG|SPIKE|TEST|DOC)-\d{3,}$/)),
     /** Last update timestamp (ISO 8601) */
     updated: z.string().datetime(),
 });
@@ -26,7 +26,17 @@ export const CategoryIndexSchema = z.object({
  * Type index schema (by-type/*.json)
  */
 export const TypeIndexSchema = CategoryIndexSchema.extend({
-    category: z.enum(['epic', 'story', 'task', 'requirement', 'feature', 'bug', 'spike', 'test']),
+    category: z.enum([
+        'epic',
+        'story',
+        'task',
+        'requirement',
+        'feature',
+        'bug',
+        'spike',
+        'test',
+        'doc',
+    ]),
 });
 /**
  * Status index schema (by-status/*.json)
@@ -60,10 +70,7 @@ export const PriorityIndexSchema = CategoryIndexSchema.extend({
  * Preserves ID generation counters from legacy index
  */
 export const CountersSchema = z.record(z.string(), // item type key
-z
-    .number()
-    .int()
-    .nonnegative() // counter value
+z.number().int().nonnegative() // counter value
 );
 /**
  * Index paths validation

package/dist/schemas/index-refs.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"index-refs.schema.js","sourceRoot":"","sources":["../../src/schemas/index-refs.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,oBAAoB;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IAEpB,wBAAwB;IACxB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAEtF,uCAAuC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACxD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;CAC9F,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAC1D,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;QACf,OAAO;QACP,SAAS;QACT,aAAa;QACb,QAAQ;QACR,MAAM;QACN,UAAU;QACV,SAAS;QACT,WAAW;KACZ,CAAC;CACH,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAC5D,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;QACf,kBAAkB;QAClB,sBAAsB;QACtB,sBAAsB;QACtB,0BAA0B;KAC3B,CAAC;CACH,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CACpC,CAAC,CAAC,MAAM,EAAE,EAAE,gBAAgB;AAC5B,CAAC;KACE,MAAM,EAAE;KACR,GAAG,EAAE;KACL,WAAW,EAAE,CAAC,gBAAgB;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,OAAO,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}
+{"version":3,"file":"index-refs.schema.js","sourceRoot":"","sources":["../../src/schemas/index-refs.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,oBAAoB;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IAEpB,wBAAwB;IACxB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAE1F,uCAAuC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACxD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;QACf,MAAM;QACN,OAAO;QACP,MAAM;QACN,aAAa;QACb,SAAS;QACT,KAAK;QACL,OAAO;QACP,MAAM;QACN,KAAK;KACN,CAAC;CACH,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAC1D,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;QACf,OAAO;QACP,SAAS;QACT,aAAa;QACb,QAAQ;QACR,MAAM;QACN,UAAU;QACV,SAAS;QACT,WAAW;KACZ,CAAC;CACH,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAC5D,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;QACf,kBAAkB;QAClB,sBAAsB;QACtB,sBAAsB;QACtB,0BAA0B;KAC3B,CAAC;CACH,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CACpC,CAAC,CAAC,MAAM,EAAE,EAAE,gBAAgB;AAC5B,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,gBAAgB;CAChD,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,OAAO,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}