@crewhaus/spec 0.1.7 → 0.1.8

package/dist/index.d.ts

@@ -214,6 +214,62 @@ declare const failureTaxonomyBlock: z.ZodOptional<z.ZodArray<z.ZodObject<{
     recovery: "retry" | "compact" | "continue" | "tombstone" | "fail";
     hint?: string | undefined;
 }>, "many">>;
+/**
+ * Response-feedback block — declares that a harness collects human ratings on
+ * agent responses (thumbs/stars/scale/comment) which `crewhaus distill` turns
+ * into eval datasets + graders. Cross-cutting like security: carried on the
+ * interactive shapes that consume it (cli, channel). `channelReactions` gates
+ * codegen of Slack 👍/👎 → feedback in the channel target; `modality`/`storage`
+ * configure the capture surfaces; `autoDistill` is a forward-looking flag for a
+ * continuous flywheel. `.strict()` so a typo'd sub-key fails the build.
+ */
+declare const feedbackBlock: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    modality: z.ZodDefault<z.ZodEnum<["binary", "stars", "scale", "comment"]>>;
+    scale: z.ZodOptional<z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        min: number;
+        max: number;
+    }, {
+        min: number;
+        max: number;
+    }>>;
+    storage: z.ZodOptional<z.ZodObject<{
+        location: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        location: string;
+    }, {
+        location: string;
+    }>>;
+    autoDistill: z.ZodOptional<z.ZodBoolean>;
+    channelReactions: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    modality: "binary" | "stars" | "scale" | "comment";
+    enabled?: boolean | undefined;
+    scale?: {
+        min: number;
+        max: number;
+    } | undefined;
+    storage?: {
+        location: string;
+    } | undefined;
+    autoDistill?: boolean | undefined;
+    channelReactions?: boolean | undefined;
+}, {
+    enabled?: boolean | undefined;
+    scale?: {
+        min: number;
+        max: number;
+    } | undefined;
+    modality?: "binary" | "stars" | "scale" | "comment" | undefined;
+    storage?: {
+        location: string;
+    } | undefined;
+    autoDistill?: boolean | undefined;
+    channelReactions?: boolean | undefined;
+}>>;
 declare const cliSchema: z.ZodObject<{
     name: z.ZodString;
     target: z.ZodLiteral<"cli">;
@@ -439,6 +495,53 @@ declare const cliSchema: z.ZodObject<{
         recovery: "retry" | "compact" | "continue" | "tombstone" | "fail";
         hint?: string | undefined;
     }>, "many">>;
+    feedback: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        modality: z.ZodDefault<z.ZodEnum<["binary", "stars", "scale", "comment"]>>;
+        scale: z.ZodOptional<z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            min: number;
+            max: number;
+        }, {
+            min: number;
+            max: number;
+        }>>;
+        storage: z.ZodOptional<z.ZodObject<{
+            location: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            location: string;
+        }, {
+            location: string;
+        }>>;
+        autoDistill: z.ZodOptional<z.ZodBoolean>;
+        channelReactions: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        modality: "binary" | "stars" | "scale" | "comment";
+        enabled?: boolean | undefined;
+        scale?: {
+            min: number;
+            max: number;
+        } | undefined;
+        storage?: {
+            location: string;
+        } | undefined;
+        autoDistill?: boolean | undefined;
+        channelReactions?: boolean | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        scale?: {
+            min: number;
+            max: number;
+        } | undefined;
+        modality?: "binary" | "stars" | "scale" | "comment" | undefined;
+        storage?: {
+            location: string;
+        } | undefined;
+        autoDistill?: boolean | undefined;
+        channelReactions?: boolean | undefined;
+    }>>;
     cli: z.ZodOptional<z.ZodObject<{
         banner: z.ZodOptional<z.ZodObject<{
             taglineMode: z.ZodDefault<z.ZodEnum<["static", "random"]>>;
@@ -645,6 +748,19 @@ declare const cliSchema: z.ZodObject<{
         recovery: "retry" | "compact" | "continue" | "tombstone" | "fail";
         hint?: string | undefined;
     }[] | undefined;
+    feedback?: {
+        modality: "binary" | "stars" | "scale" | "comment";
+        enabled?: boolean | undefined;
+        scale?: {
+            min: number;
+            max: number;
+        } | undefined;
+        storage?: {
+            location: string;
+        } | undefined;
+        autoDistill?: boolean | undefined;
+        channelReactions?: boolean | undefined;
+    } | undefined;
     chains?: {
         kind: "evm";
         id: string;
@@ -744,6 +860,19 @@ declare const cliSchema: z.ZodObject<{
         recovery: "retry" | "compact" | "continue" | "tombstone" | "fail";
         hint?: string | undefined;
     }[] | undefined;
+    feedback?: {
+        enabled?: boolean | undefined;
+        scale?: {
+            min: number;
+            max: number;
+        } | undefined;
+        modality?: "binary" | "stars" | "scale" | "comment" | undefined;
+        storage?: {
+            location: string;
+        } | undefined;
+        autoDistill?: boolean | undefined;
+        channelReactions?: boolean | undefined;
+    } | undefined;
     chains?: {
         kind: "evm";
         id: string;
@@ -1654,6 +1783,53 @@ declare const channelSchema: z.ZodObject<{
         recovery: "retry" | "compact" | "continue" | "tombstone" | "fail";
         hint?: string | undefined;
     }>, "many">>;
+    feedback: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        modality: z.ZodDefault<z.ZodEnum<["binary", "stars", "scale", "comment"]>>;
+        scale: z.ZodOptional<z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            min: number;
+            max: number;
+        }, {
+            min: number;
+            max: number;
+        }>>;
+        storage: z.ZodOptional<z.ZodObject<{
+            location: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            location: string;
+        }, {
+            location: string;
+        }>>;
+        autoDistill: z.ZodOptional<z.ZodBoolean>;
+        channelReactions: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        modality: "binary" | "stars" | "scale" | "comment";
+        enabled?: boolean | undefined;
+        scale?: {
+            min: number;
+            max: number;
+        } | undefined;
+        storage?: {
+            location: string;
+        } | undefined;
+        autoDistill?: boolean | undefined;
+        channelReactions?: boolean | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        scale?: {
+            min: number;
+            max: number;
+        } | undefined;
+        modality?: "binary" | "stars" | "scale" | "comment" | undefined;
+        storage?: {
+            location: string;
+        } | undefined;
+        autoDistill?: boolean | undefined;
+        channelReactions?: boolean | undefined;
+    }>>;
     heartbeat: z.ZodOptional<z.ZodObject<{
         every: z.ZodString;
         instructions: z.ZodString;
@@ -1862,6 +2038,19 @@ declare const channelSchema: z.ZodObject<{
         recovery: "retry" | "compact" | "continue" | "tombstone" | "fail";
         hint?: string | undefined;
     }[] | undefined;
+    feedback?: {
+        modality: "binary" | "stars" | "scale" | "comment";
+        enabled?: boolean | undefined;
+        scale?: {
+            min: number;
+            max: number;
+        } | undefined;
+        storage?: {
+            location: string;
+        } | undefined;
+        autoDistill?: boolean | undefined;
+        channelReactions?: boolean | undefined;
+    } | undefined;
     chains?: {
         kind: "evm";
         id: string;
@@ -1982,6 +2171,19 @@ declare const channelSchema: z.ZodObject<{
         recovery: "retry" | "compact" | "continue" | "tombstone" | "fail";
         hint?: string | undefined;
     }[] | undefined;
+    feedback?: {
+        enabled?: boolean | undefined;
+        scale?: {
+            min: number;
+            max: number;
+        } | undefined;
+        modality?: "binary" | "stars" | "scale" | "comment" | undefined;
+        storage?: {
+            location: string;
+        } | undefined;
+        autoDistill?: boolean | undefined;
+        channelReactions?: boolean | undefined;
+    } | undefined;
     chains?: {
         kind: "evm";
         id: string;
@@ -6121,6 +6323,53 @@ export declare const Spec: z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
         recovery: "retry" | "compact" | "continue" | "tombstone" | "fail";
         hint?: string | undefined;
     }>, "many">>;
+    feedback: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        modality: z.ZodDefault<z.ZodEnum<["binary", "stars", "scale", "comment"]>>;
+        scale: z.ZodOptional<z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            min: number;
+            max: number;
+        }, {
+            min: number;
+            max: number;
+        }>>;
+        storage: z.ZodOptional<z.ZodObject<{
+            location: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            location: string;
+        }, {
+            location: string;
+        }>>;
+        autoDistill: z.ZodOptional<z.ZodBoolean>;
+        channelReactions: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        modality: "binary" | "stars" | "scale" | "comment";
+        enabled?: boolean | undefined;
+        scale?: {
+            min: number;
+            max: number;
+        } | undefined;
+        storage?: {
+            location: string;
+        } | undefined;
+        autoDistill?: boolean | undefined;
+        channelReactions?: boolean | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        scale?: {
+            min: number;
+            max: number;
+        } | undefined;
+        modality?: "binary" | "stars" | "scale" | "comment" | undefined;
+        storage?: {
+            location: string;
+        } | undefined;
+        autoDistill?: boolean | undefined;
+        channelReactions?: boolean | undefined;
+    }>>;
     cli: z.ZodOptional<z.ZodObject<{
         banner: z.ZodOptional<z.ZodObject<{
             taglineMode: z.ZodDefault<z.ZodEnum<["static", "random"]>>;
@@ -6327,6 +6576,19 @@ export declare const Spec: z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
         recovery: "retry" | "compact" | "continue" | "tombstone" | "fail";
         hint?: string | undefined;
     }[] | undefined;
+    feedback?: {
+        modality: "binary" | "stars" | "scale" | "comment";
+        enabled?: boolean | undefined;
+        scale?: {
+            min: number;
+            max: number;
+        } | undefined;
+        storage?: {
+            location: string;
+        } | undefined;
+        autoDistill?: boolean | undefined;
+        channelReactions?: boolean | undefined;
+    } | undefined;
     chains?: {
         kind: "evm";
         id: string;
@@ -6426,6 +6688,19 @@ export declare const Spec: z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
         recovery: "retry" | "compact" | "continue" | "tombstone" | "fail";
         hint?: string | undefined;
     }[] | undefined;
+    feedback?: {
+        enabled?: boolean | undefined;
+        scale?: {
+            min: number;
+            max: number;
+        } | undefined;
+        modality?: "binary" | "stars" | "scale" | "comment" | undefined;
+        storage?: {
+            location: string;
+        } | undefined;
+        autoDistill?: boolean | undefined;
+        channelReactions?: boolean | undefined;
+    } | undefined;
     chains?: {
         kind: "evm";
         id: string;
@@ -7181,6 +7456,53 @@ export declare const Spec: z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
         recovery: "retry" | "compact" | "continue" | "tombstone" | "fail";
         hint?: string | undefined;
     }>, "many">>;
+    feedback: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        modality: z.ZodDefault<z.ZodEnum<["binary", "stars", "scale", "comment"]>>;
+        scale: z.ZodOptional<z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            min: number;
+            max: number;
+        }, {
+            min: number;
+            max: number;
+        }>>;
+        storage: z.ZodOptional<z.ZodObject<{
+            location: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            location: string;
+        }, {
+            location: string;
+        }>>;
+        autoDistill: z.ZodOptional<z.ZodBoolean>;
+        channelReactions: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        modality: "binary" | "stars" | "scale" | "comment";
+        enabled?: boolean | undefined;
+        scale?: {
+            min: number;
+            max: number;
+        } | undefined;
+        storage?: {
+            location: string;
+        } | undefined;
+        autoDistill?: boolean | undefined;
+        channelReactions?: boolean | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        scale?: {
+            min: number;
+            max: number;
+        } | undefined;
+        modality?: "binary" | "stars" | "scale" | "comment" | undefined;
+        storage?: {
+            location: string;
+        } | undefined;
+        autoDistill?: boolean | undefined;
+        channelReactions?: boolean | undefined;
+    }>>;
     heartbeat: z.ZodOptional<z.ZodObject<{
         every: z.ZodString;
         instructions: z.ZodString;
@@ -7389,6 +7711,19 @@ export declare const Spec: z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
         recovery: "retry" | "compact" | "continue" | "tombstone" | "fail";
         hint?: string | undefined;
     }[] | undefined;
+    feedback?: {
+        modality: "binary" | "stars" | "scale" | "comment";
+        enabled?: boolean | undefined;
+        scale?: {
+            min: number;
+            max: number;
+        } | undefined;
+        storage?: {
+            location: string;
+        } | undefined;
+        autoDistill?: boolean | undefined;
+        channelReactions?: boolean | undefined;
+    } | undefined;
     chains?: {
         kind: "evm";
         id: string;
@@ -7509,6 +7844,19 @@ export declare const Spec: z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
         recovery: "retry" | "compact" | "continue" | "tombstone" | "fail";
         hint?: string | undefined;
     }[] | undefined;
+    feedback?: {
+        enabled?: boolean | undefined;
+        scale?: {
+            min: number;
+            max: number;
+        } | undefined;
+        modality?: "binary" | "stars" | "scale" | "comment" | undefined;
+        storage?: {
+            location: string;
+        } | undefined;
+        autoDistill?: boolean | undefined;
+        channelReactions?: boolean | undefined;
+    } | undefined;
     chains?: {
         kind: "evm";
         id: string;
@@ -11115,6 +11463,7 @@ export type SpecMcpServerConfig = z.infer<typeof mcpServerConfigSchema>;
 export type SpecSubAgentDefinition = z.infer<typeof subAgentDefinitionSchema>;
 export type SpecCompactionBlock = z.infer<typeof compactionBlock>;
 export type SpecSecurityBlock = z.infer<typeof securityBlock>;
+export type SpecFeedbackBlock = z.infer<typeof feedbackBlock>;
 export type SpecFailureTaxonomyEntry = z.infer<typeof failureTaxonomyEntrySchema>;
 export type SpecFailureTaxonomy = z.infer<typeof failureTaxonomyBlock>;
 export { SpecParseError };

package/dist/index.js

@@ -270,6 +270,26 @@ const failureTaxonomyEntrySchema = z
 })
     .strict();
 const failureTaxonomyBlock = z.array(failureTaxonomyEntrySchema).optional();
+/**
+ * Response-feedback block — declares that a harness collects human ratings on
+ * agent responses (thumbs/stars/scale/comment) which `crewhaus distill` turns
+ * into eval datasets + graders. Cross-cutting like security: carried on the
+ * interactive shapes that consume it (cli, channel). `channelReactions` gates
+ * codegen of Slack 👍/👎 → feedback in the channel target; `modality`/`storage`
+ * configure the capture surfaces; `autoDistill` is a forward-looking flag for a
+ * continuous flywheel. `.strict()` so a typo'd sub-key fails the build.
+ */
+const feedbackBlock = z
+    .object({
+    enabled: z.boolean().optional(),
+    modality: z.enum(["binary", "stars", "scale", "comment"]).default("binary"),
+    scale: z.object({ min: z.number().int(), max: z.number().int() }).strict().optional(),
+    storage: z.object({ location: safeName }).strict().optional(),
+    autoDistill: z.boolean().optional(),
+    channelReactions: z.boolean().optional(),
+})
+    .strict()
+    .optional();
 /**
  * Section 47 — blockchain subsystem blocks (cross-cutting). Any shape may
  * declare any subset of `chains` / `wallets` / `contracts` /
@@ -421,6 +441,7 @@ const cliSchema = z
     compaction: compactionBlock,
     security: securityBlock,
     failure_taxonomy: failureTaxonomyBlock,
+    feedback: feedbackBlock,
     cli: cliOptionsBlock,
     chains: chainsBlock,
     wallets: walletsBlock,
@@ -538,6 +559,7 @@ const channelSchema = z
     permissions: permissionsBlock,
     compaction: compactionBlock,
     failure_taxonomy: failureTaxonomyBlock,
+    feedback: feedbackBlock,
     heartbeat: heartbeatBlock,
     gateway: channelGatewayBlock,
     chains: chainsBlock,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewhaus/spec",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "type": "module",
   "description": "User-facing spec schema (Zod) + YAML parser",
   "main": "dist/index.js",
@@ -15,7 +15,7 @@
     "test": "bun test src"
   },
   "dependencies": {
-    "@crewhaus/errors": "0.1.7",
+    "@crewhaus/errors": "0.1.8",
     "yaml": "^2.6.0",
     "zod": "^3.23.8"
   },