@gitgov/core 1.9.0 → 1.10.1

package/dist/src/index.d.ts

@@ -334,7 +334,7 @@ interface ExecutionRecord<TMetadata = object> {
 /**
  * Canonical schema for feedback records - structured conversation about work
  */
-interface FeedbackRecord {
+interface FeedbackRecord<TMetadata = object> {
     /**
      * Unique identifier for the feedback entry
      */
@@ -377,6 +377,13 @@ interface FeedbackRecord {
      * Optional. The ID of another feedback record that this one resolves or responds to
      */
     resolvesFeedbackId?: string;
+    /**
+     * Optional structured data for machine consumption.
+     * Use this field for domain-specific data that needs to be programmatically processed.
+     * Common use cases: waiver details (fingerprint, ruleId, file, line), approval context, assignment metadata.
+     *
+     */
+    metadata?: TMetadata;
 }
 
 /**
@@ -772,7 +779,7 @@ type index$m_EmbeddedMetadataRecord<T extends GitGovRecordPayload> = EmbeddedMet
 type index$m_ExecutionPayload = ExecutionPayload;
 type index$m_ExecutionRecord<TMetadata = object> = ExecutionRecord<TMetadata>;
 type index$m_FeedbackPayload = FeedbackPayload;
-type index$m_FeedbackRecord = FeedbackRecord;
+type index$m_FeedbackRecord<TMetadata = object> = FeedbackRecord<TMetadata>;
 type index$m_GitGovActorRecord = GitGovActorRecord;
 type index$m_GitGovAgentRecord = GitGovAgentRecord;
 type index$m_GitGovChangelogRecord = GitGovChangelogRecord;
@@ -3810,12 +3817,14 @@ declare function createChangelogRecord(payload: Partial<ChangelogRecord>): Chang
 declare function loadChangelogRecord(data: unknown): GitGovChangelogRecord;
 
 /**
- * Creates a complete FeedbackRecord with validation
+ * Creates a complete FeedbackRecord with validation.
+ *
+ * The factory is generic to preserve the metadata type for compile-time safety.
  *
- * @param payload - Partial FeedbackRecord payload
- * @returns FeedbackRecord - The validated FeedbackRecord
+ * @param payload - Partial FeedbackRecord payload with optional typed metadata
+ * @returns FeedbackRecord<TMetadata> - The validated FeedbackRecord with preserved metadata type
  */
-declare function createFeedbackRecord(payload: Partial<FeedbackRecord>): FeedbackRecord;
+declare function createFeedbackRecord<TMetadata extends object = object>(payload: Partial<FeedbackRecord<TMetadata>>): FeedbackRecord<TMetadata>;
 /**
  * Loads and validates an existing FeedbackRecord from untrusted data.
  * Used by RecordStore to validate records when reading from disk.
@@ -5811,6 +5820,18 @@ declare const Schemas: {
                 description: string;
                 examples: string[];
             };
+            metadata: {
+                type: string;
+                additionalProperties: boolean;
+                description: string;
+                examples: {
+                    fingerprint: string;
+                    ruleId: string;
+                    file: string;
+                    line: number;
+                    expiresAt: string;
+                }[];
+            };
         };
         examples: ({
             id: string;
@@ -7642,6 +7663,18 @@ declare function getSchema(name: SchemaName): {
             description: string;
             examples: string[];
         };
+        metadata: {
+            type: string;
+            additionalProperties: boolean;
+            description: string;
+            examples: {
+                fingerprint: string;
+                ruleId: string;
+                file: string;
+                line: number;
+                expiresAt: string;
+            }[];
+        };
     };
     examples: ({
         id: string;

package/dist/src/index.js

@@ -1634,6 +1634,20 @@ var feedback_record_schema_default = {
       examples: [
         "1752788100-feedback-blocking-rest-api"
       ]
+    },
+    metadata: {
+      type: "object",
+      additionalProperties: true,
+      description: "Optional structured data for machine consumption.\nUse this field for domain-specific data that needs to be programmatically processed.\nCommon use cases: waiver details (fingerprint, ruleId, file, line), approval context, assignment metadata.\n",
+      examples: [
+        {
+          fingerprint: "abc123def456",
+          ruleId: "PII-001",
+          file: "src/user.ts",
+          line: 42,
+          expiresAt: "2025-12-31T23:59:59Z"
+        }
+      ]
     }
   },
   examples: [
@@ -4101,7 +4115,7 @@ function createFeedbackRecord(payload) {
     content: payload.content || "",
     assignee: payload.assignee,
     resolvesFeedbackId: payload.resolvesFeedbackId,
-    ...payload
+    metadata: payload.metadata
   };
   const validation = validateFeedbackRecordDetailed(feedback);
   if (!validation.isValid) {