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

package/dist/schemas/item-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-id.js","sourceRoot":"","sources":["../../src/schemas/item-id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,kBAAkB,GAAuC;IACpE,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,MAAM;IACf,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,KAAK;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,SAAS,GAAG,CAAC;IACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO,IAAI,MAAM,CAAC,KAAK,QAAQ,UAAU,SAAS,MAAM,CAAC,CAAC;AAC5D,CAAC"}

package/dist/schemas/relationships.d.ts

@@ -7,21 +7,20 @@
  */
 /**
  * Hierarchy relationships enforce parent-child rules
- * - implements/implemented-by: Standard hierarchy (Epic→Story→Task)
- * - blocks/blocked-by: Jira 2025 hierarchy for Bug (Bug blocks Story)
- *   Note: Other types (Story→Story, Task→Task) bypass validation (flexible)
- *   Scrum: Bug blocks Story | Waterfall: Bug blocks Feature
+ * - implements/implemented-by: every item type links to its parent this way, bugs included
+ *   (Scrum: Epic→Story→Bug→Task | Waterfall: Requirement→Feature→Bug→Task; DEC-018)
  */
-export declare const HIERARCHY_RELATIONSHIPS: readonly ["implements", "implemented-by", "blocks", "blocked-by"];
+export declare const HIERARCHY_RELATIONSHIPS: readonly ['implements', 'implemented-by'];
 /**
  * Flexible relationships allow connections between any item types
- * Note: blocks/blocked-by moved to HIERARCHY for Bug validation (Jira 2025)
  * - relates-to: Generic association
+ * - blocks/blocked-by: One item holds another up, the same for every type; may sit beside
+ *   implements on the same pair (DEC-018)
  * - depends-on/required-by: Technical dependencies
  * - tested-by/tests: Testing relationships
  * - supersedes/superseded-by: Version/replacement tracking
  */
-export declare const FLEXIBLE_RELATIONSHIPS: readonly ["relates-to", "depends-on", "required-by", "tested-by", "tests", "supersedes", "superseded-by"];
+export declare const FLEXIBLE_RELATIONSHIPS: readonly ['relates-to', 'blocks', 'blocked-by', 'depends-on', 'required-by', 'tested-by', 'tests', 'supersedes', 'superseded-by', 'canonical-for', 'derived-from', 'documented-by', 'documents'];
 export type HierarchyRelation = (typeof HIERARCHY_RELATIONSHIPS)[number];
 export type FlexibleRelation = (typeof FLEXIBLE_RELATIONSHIPS)[number];
 export type RelationType = HierarchyRelation | FlexibleRelation;

package/dist/schemas/relationships.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../src/schemas/relationships.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,mEAK1B,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,2GAQzB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AACzE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AACvE,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAEhE;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,IAAI,iBAAiB,CAE3F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,IAAI,gBAAgB,CAEzF"}
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../src/schemas/relationships.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,YAAI,YAAY,EAAE,gBAAgB,CAAU,CAAC;AAEjF;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,YACjC,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,WAAW,EACX,OAAO,EACP,YAAY,EACZ,eAAe,EACf,eAAe,EACf,cAAc,EACd,eAAe,EACf,WAAW,CACH,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AACzE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AACvE,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAEhE;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,IAAI,iBAAiB,CAE3F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,IAAI,gBAAgB,CAEzF"}

package/dist/schemas/relationships.js

@@ -7,33 +7,33 @@
  */
 /**
  * Hierarchy relationships enforce parent-child rules
- * - implements/implemented-by: Standard hierarchy (Epic→Story→Task)
- * - blocks/blocked-by: Jira 2025 hierarchy for Bug (Bug blocks Story)
- *   Note: Other types (Story→Story, Task→Task) bypass validation (flexible)
- *   Scrum: Bug blocks Story | Waterfall: Bug blocks Feature
+ * - implements/implemented-by: every item type links to its parent this way, bugs included
+ *   (Scrum: Epic→Story→Bug→Task | Waterfall: Requirement→Feature→Bug→Task; DEC-018)
  */
-export const HIERARCHY_RELATIONSHIPS = [
-    'implements',
-    'implemented-by',
-    'blocks',
-    'blocked-by',
-];
+export const HIERARCHY_RELATIONSHIPS = ['implements', 'implemented-by'];
 /**
  * Flexible relationships allow connections between any item types
- * Note: blocks/blocked-by moved to HIERARCHY for Bug validation (Jira 2025)
  * - relates-to: Generic association
+ * - blocks/blocked-by: One item holds another up, the same for every type; may sit beside
+ *   implements on the same pair (DEC-018)
  * - depends-on/required-by: Technical dependencies
  * - tested-by/tests: Testing relationships
  * - supersedes/superseded-by: Version/replacement tracking
  */
 export const FLEXIBLE_RELATIONSHIPS = [
     'relates-to',
+    'blocks',
+    'blocked-by',
     'depends-on',
     'required-by',
     'tested-by',
     'tests',
     'supersedes',
     'superseded-by',
+    'canonical-for',
+    'derived-from',
+    'documented-by',
+    'documents',
 ];
 /**
  * Check if a relation type requires hierarchy validation

package/dist/schemas/relationships.js.map

@@ -1 +1 @@
-{"version":3,"file":"relationships.js","sourceRoot":"","sources":["../../src/schemas/relationships.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,YAAY;IACZ,gBAAgB;IAChB,QAAQ;IACR,YAAY;CACJ,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,WAAW;IACX,OAAO;IACP,YAAY;IACZ,eAAe;CACP,CAAC;AAMX;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACtD,OAAO,uBAAuB,CAAC,QAAQ,CAAC,YAAiC,CAAC,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,OAAO,sBAAsB,CAAC,QAAQ,CAAC,YAAgC,CAAC,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"relationships.js","sourceRoot":"","sources":["../../src/schemas/relationships.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,YAAY,EAAE,gBAAgB,CAAU,CAAC;AAEjF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,YAAY;IACZ,QAAQ;IACR,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,WAAW;IACX,OAAO;IACP,YAAY;IACZ,eAAe;IACf,eAAe;IACf,cAAc;IACd,eAAe;IACf,WAAW;CACH,CAAC;AAMX;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACtD,OAAO,uBAAuB,CAAC,QAAQ,CAAC,YAAiC,CAAC,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,OAAO,sBAAsB,CAAC,QAAQ,CAAC,YAAgC,CAAC,CAAC;AAC3E,CAAC"}

package/dist/schemas/task-workflow.d.ts

@@ -0,0 +1,206 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * TASK workflow declaration schema
+ * Defines the serializable vocabulary for process states, transitions, inputs, evidence, and cleanup.
+ * It describes workflow behavior without selecting an executor or performing side effects.
+ */
+import { z } from 'zod';
+export declare const TaskWorkflowInputType: z.ZodEnum<{
+    boolean: "boolean";
+    number: "number";
+    path: "path";
+    "secret-reference": "secret-reference";
+    string: "string";
+}>;
+export type TaskWorkflowInputType = z.infer<typeof TaskWorkflowInputType>;
+export declare const TaskWorkflowEvidenceType: z.ZodEnum<{
+    approval: "approval";
+    artifact: "artifact";
+    log: "log";
+    observation: "observation";
+}>;
+export type TaskWorkflowEvidenceType = z.infer<typeof TaskWorkflowEvidenceType>;
+export declare const TaskWorkflowTerminalOutcome: z.ZodEnum<{
+    cancelled: "cancelled";
+    failed: "failed";
+    succeeded: "succeeded";
+}>;
+export type TaskWorkflowTerminalOutcome = z.infer<typeof TaskWorkflowTerminalOutcome>;
+export declare const TaskWorkflowState: z.ZodObject<{
+    terminal: z.ZodDefault<z.ZodBoolean>;
+    resumable: z.ZodDefault<z.ZodBoolean>;
+    retryable: z.ZodDefault<z.ZodBoolean>;
+    requires_human: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TaskWorkflowState = z.infer<typeof TaskWorkflowState>;
+export declare const TaskWorkflowGuard: z.ZodObject<{
+    kind: z.ZodString;
+    parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type TaskWorkflowGuard = z.infer<typeof TaskWorkflowGuard>;
+export declare const TaskWorkflowTransition: z.ZodObject<{
+    event: z.ZodString;
+    from: z.ZodArray<z.ZodString>;
+    to: z.ZodString;
+    guards: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type TaskWorkflowTransition = z.infer<typeof TaskWorkflowTransition>;
+export declare const TaskWorkflowCommand: z.ZodObject<{
+    id: z.ZodString;
+    command: z.ZodString;
+    working_directory: z.ZodOptional<z.ZodString>;
+    timeout_seconds: z.ZodDefault<z.ZodNumber>;
+    evidence_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type TaskWorkflowCommand = z.infer<typeof TaskWorkflowCommand>;
+export declare const TaskWorkflowHumanStep: z.ZodObject<{
+    id: z.ZodString;
+    instruction: z.ZodString;
+    expected_observation: z.ZodString;
+    accepted_answers: z.ZodArray<z.ZodString>;
+    evidence_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    cleanup_required: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TaskWorkflowHumanStep = z.infer<typeof TaskWorkflowHumanStep>;
+export declare const TaskWorkflowInput: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        boolean: "boolean";
+        number: "number";
+        path: "path";
+        "secret-reference": "secret-reference";
+        string: "string";
+    }>;
+    description: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export type TaskWorkflowInput = z.infer<typeof TaskWorkflowInput>;
+export declare const TaskWorkflowPrecondition: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    evidence_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type TaskWorkflowPrecondition = z.infer<typeof TaskWorkflowPrecondition>;
+export declare const TaskWorkflowEvidence: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        approval: "approval";
+        artifact: "artifact";
+        log: "log";
+        observation: "observation";
+    }>;
+    description: z.ZodString;
+    artifact_path: z.ZodOptional<z.ZodString>;
+    redacted: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TaskWorkflowEvidence = z.infer<typeof TaskWorkflowEvidence>;
+export declare const TaskWorkflowCleanup: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    evidence_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type TaskWorkflowCleanup = z.infer<typeof TaskWorkflowCleanup>;
+export declare const TaskWorkflowTerminal: z.ZodObject<{
+    outcome: z.ZodEnum<{
+        cancelled: "cancelled";
+        failed: "failed";
+        succeeded: "succeeded";
+    }>;
+    state: z.ZodString;
+    requires_cleanup: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TaskWorkflowTerminal = z.infer<typeof TaskWorkflowTerminal>;
+export declare const TaskWorkflowDefinition: z.ZodObject<{
+    schema_version: z.ZodLiteral<"1.0">;
+    process_type: z.ZodString;
+    states: z.ZodRecord<z.ZodString, z.ZodObject<{
+        terminal: z.ZodDefault<z.ZodBoolean>;
+        resumable: z.ZodDefault<z.ZodBoolean>;
+        retryable: z.ZodDefault<z.ZodBoolean>;
+        requires_human: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    initial: z.ZodString;
+    transitions: z.ZodArray<z.ZodObject<{
+        event: z.ZodString;
+        from: z.ZodArray<z.ZodString>;
+        to: z.ZodString;
+        guards: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    commands: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        command: z.ZodString;
+        working_directory: z.ZodOptional<z.ZodString>;
+        timeout_seconds: z.ZodDefault<z.ZodNumber>;
+        evidence_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    human_steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        instruction: z.ZodString;
+        expected_observation: z.ZodString;
+        accepted_answers: z.ZodArray<z.ZodString>;
+        evidence_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        cleanup_required: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    strict_checkpoints: z.ZodOptional<z.ZodBoolean>;
+    inputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            boolean: "boolean";
+            number: "number";
+            path: "path";
+            "secret-reference": "secret-reference";
+            string: "string";
+        }>;
+        description: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        default: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>>>;
+    preconditions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        evidence_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<{
+            approval: "approval";
+            artifact: "artifact";
+            log: "log";
+            observation: "observation";
+        }>;
+        description: z.ZodString;
+        artifact_path: z.ZodOptional<z.ZodString>;
+        redacted: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    cleanup: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        evidence_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    terminal: z.ZodArray<z.ZodObject<{
+        outcome: z.ZodEnum<{
+            cancelled: "cancelled";
+            failed: "failed";
+            succeeded: "succeeded";
+        }>;
+        state: z.ZodString;
+        requires_cleanup: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    max_attempts: z.ZodDefault<z.ZodNumber>;
+    allow_parallel_runs: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TaskWorkflowDefinition = z.infer<typeof TaskWorkflowDefinition>;
+//# sourceMappingURL=task-workflow.d.ts.map

package/dist/schemas/task-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-workflow.d.ts","sourceRoot":"","sources":["../../src/schemas/task-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,qBAAqB;;;;;;EAMhC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E,eAAO,MAAM,wBAAwB;;;;;EAAyD,CAAC;AAC/F,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF,eAAO,MAAM,2BAA2B;;;;EAA+C,CAAC;AACxF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEtF,eAAO,MAAM,iBAAiB;;;;;iBAK5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,sBAAsB;;;;;;;;iBAKjC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E,eAAO,MAAM,mBAAmB;;;;;;iBAM9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,eAAO,MAAM,qBAAqB;;;;;;;iBAOhC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;iBAM5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,wBAAwB;;;;;iBAKnC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF,eAAO,MAAM,oBAAoB;;;;;;;;;;;iBAM/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,mBAAmB;;;;;iBAK9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,eAAO,MAAM,oBAAoB;;;;;;;;iBAI/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmBA,CAAC;AACpC,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/schemas/task-workflow.js

@@ -0,0 +1,102 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * TASK workflow declaration schema
+ * Defines the serializable vocabulary for process states, transitions, inputs, evidence, and cleanup.
+ * It describes workflow behavior without selecting an executor or performing side effects.
+ */
+import { z } from 'zod';
+import { refineWorkflowGraph } from './workflow-graph.js';
+export const TaskWorkflowInputType = z.enum([
+    'string',
+    'number',
+    'boolean',
+    'path',
+    'secret-reference',
+]);
+export const TaskWorkflowEvidenceType = z.enum(['artifact', 'log', 'observation', 'approval']);
+export const TaskWorkflowTerminalOutcome = z.enum(['succeeded', 'failed', 'cancelled']);
+export const TaskWorkflowState = z.object({
+    terminal: z.boolean().default(false),
+    resumable: z.boolean().default(true),
+    retryable: z.boolean().default(false),
+    requires_human: z.boolean().default(false),
+});
+export const TaskWorkflowGuard = z.object({
+    kind: z.string().min(1).max(100),
+    parameters: z.record(z.string(), z.unknown()).default({}),
+});
+export const TaskWorkflowTransition = z.object({
+    event: z.string().min(1).max(100),
+    from: z.array(z.string().min(1).max(100)).min(1),
+    to: z.string().min(1).max(100),
+    guards: z.array(TaskWorkflowGuard).default([]),
+});
+export const TaskWorkflowCommand = z.object({
+    id: z.string().min(1).max(100),
+    command: z.string().min(1).max(2000),
+    working_directory: z.string().max(500).optional(),
+    timeout_seconds: z.number().int().min(1).max(86_400).default(900),
+    evidence_ids: z.array(z.string().min(1).max(100)).default([]),
+});
+export const TaskWorkflowHumanStep = z.object({
+    id: z.string().min(1).max(100),
+    instruction: z.string().min(1).max(4000),
+    expected_observation: z.string().min(1).max(2000),
+    accepted_answers: z.array(z.string().min(1).max(200)).min(1),
+    evidence_ids: z.array(z.string().min(1).max(100)).default([]),
+    cleanup_required: z.boolean().default(false),
+});
+export const TaskWorkflowInput = z.object({
+    name: z.string().regex(/^[a-z][a-z0-9_-]*$/),
+    type: TaskWorkflowInputType,
+    description: z.string().max(1000),
+    required: z.boolean().default(true),
+    default: z.unknown().optional(),
+});
+export const TaskWorkflowPrecondition = z.object({
+    id: z.string().min(1).max(100),
+    description: z.string().min(1).max(2000),
+    required: z.boolean().default(true),
+    evidence_ids: z.array(z.string().min(1).max(100)).default([]),
+});
+export const TaskWorkflowEvidence = z.object({
+    id: z.string().min(1).max(100),
+    type: TaskWorkflowEvidenceType,
+    description: z.string().min(1).max(2000),
+    artifact_path: z.string().max(500).optional(),
+    redacted: z.boolean().default(true),
+});
+export const TaskWorkflowCleanup = z.object({
+    id: z.string().min(1).max(100),
+    description: z.string().min(1).max(2000),
+    required: z.boolean().default(true),
+    evidence_ids: z.array(z.string().min(1).max(100)).default([]),
+});
+export const TaskWorkflowTerminal = z.object({
+    outcome: TaskWorkflowTerminalOutcome,
+    state: z.string().min(1).max(100),
+    requires_cleanup: z.boolean().default(true),
+});
+export const TaskWorkflowDefinition = z
+    .object({
+    schema_version: z.literal('1.0'),
+    process_type: z.string().min(1).max(100),
+    states: z.record(z.string(), TaskWorkflowState),
+    initial: z.string().min(1).max(100),
+    transitions: z.array(TaskWorkflowTransition),
+    commands: z.array(TaskWorkflowCommand).default([]),
+    human_steps: z.array(TaskWorkflowHumanStep).default([]),
+    /** Reject a checkpoint_id that names no human step instead of warning (TASK-811). */
+    strict_checkpoints: z.boolean().optional(),
+    inputs: z.array(TaskWorkflowInput).default([]),
+    preconditions: z.array(TaskWorkflowPrecondition).default([]),
+    evidence: z.array(TaskWorkflowEvidence).default([]),
+    cleanup: z.array(TaskWorkflowCleanup).default([]),
+    terminal: z.array(TaskWorkflowTerminal).min(1),
+    max_attempts: z.number().int().min(1).max(100).default(1),
+    allow_parallel_runs: z.boolean().default(false),
+})
+    .superRefine(refineWorkflowGraph);
+//# sourceMappingURL=task-workflow.js.map

package/dist/schemas/task-workflow.js.map

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

package/dist/schemas/test-profile.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Closed vocabulary for TEST authoring profiles.
+ */
+import { z } from 'zod';
+export declare const TestProfile: z.ZodEnum<{
+    "autonomous-guide": "autonomous-guide";
+    "human-guided-guide": "human-guided-guide";
+}>;
+export type TestProfile = z.infer<typeof TestProfile>;
+//# sourceMappingURL=test-profile.d.ts.map

package/dist/schemas/test-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-profile.d.ts","sourceRoot":"","sources":["../../src/schemas/test-profile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,WAAW;;;EAAqD,CAAC;AAC9E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/schemas/test-profile.js

@@ -0,0 +1,9 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Closed vocabulary for TEST authoring profiles.
+ */
+import { z } from 'zod';
+export const TestProfile = z.enum(['autonomous-guide', 'human-guided-guide']);
+//# sourceMappingURL=test-profile.js.map

package/dist/schemas/test-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-profile.js","sourceRoot":"","sources":["../../src/schemas/test-profile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAC,CAAC"}

package/dist/schemas/test-workflow.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * TEST workflow declaration schema.
+ * TEST definitions describe Acceptance capabilities without coupling the runtime to a guide.
+ */
+import { z } from 'zod';
+export declare const TestWorkflowState: z.ZodObject<{
+    terminal: z.ZodDefault<z.ZodBoolean>;
+    resumable: z.ZodDefault<z.ZodBoolean>;
+    retryable: z.ZodDefault<z.ZodBoolean>;
+    requires_human: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TestWorkflowState = z.infer<typeof TestWorkflowState>;
+export declare const TestWorkflowGuard: z.ZodObject<{
+    kind: z.ZodEnum<{
+        always: "always";
+        "mcp-tool-receipt": "mcp-tool-receipt";
+        "payload-equals": "payload-equals";
+        "payload-present": "payload-present";
+        "state-equals": "state-equals";
+    }>;
+    parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type TestWorkflowGuard = z.infer<typeof TestWorkflowGuard>;
+export declare const TestWorkflowTransition: z.ZodObject<{
+    event: z.ZodString;
+    from: z.ZodArray<z.ZodString>;
+    to: z.ZodString;
+    guards: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            always: "always";
+            "mcp-tool-receipt": "mcp-tool-receipt";
+            "payload-equals": "payload-equals";
+            "payload-present": "payload-present";
+            "state-equals": "state-equals";
+        }>;
+        parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type TestWorkflowTransition = z.infer<typeof TestWorkflowTransition>;
+export declare const TestWorkflowHumanStep: z.ZodObject<{
+    id: z.ZodString;
+    instruction: z.ZodString;
+    expected_observation: z.ZodString;
+    accepted_answers: z.ZodArray<z.ZodString>;
+    evidence_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    cleanup_required: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TestWorkflowHumanStep = z.infer<typeof TestWorkflowHumanStep>;
+export declare const TestWorkflowEvidence: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    artifact_path: z.ZodOptional<z.ZodString>;
+    redacted: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TestWorkflowEvidence = z.infer<typeof TestWorkflowEvidence>;
+export declare const TestWorkflowDefinition: z.ZodObject<{
+    schema_version: z.ZodLiteral<"1.0">;
+    process_type: z.ZodString;
+    profile: z.ZodEnum<{
+        "autonomous-guide": "autonomous-guide";
+        "human-guided-guide": "human-guided-guide";
+    }>;
+    derived_doc: z.ZodOptional<z.ZodString>;
+    dependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    states: z.ZodRecord<z.ZodString, z.ZodObject<{
+        terminal: z.ZodDefault<z.ZodBoolean>;
+        resumable: z.ZodDefault<z.ZodBoolean>;
+        retryable: z.ZodDefault<z.ZodBoolean>;
+        requires_human: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    initial: z.ZodString;
+    transitions: z.ZodArray<z.ZodObject<{
+        event: z.ZodString;
+        from: z.ZodArray<z.ZodString>;
+        to: z.ZodString;
+        guards: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                always: "always";
+                "mcp-tool-receipt": "mcp-tool-receipt";
+                "payload-equals": "payload-equals";
+                "payload-present": "payload-present";
+                "state-equals": "state-equals";
+            }>;
+            parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    human_steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        instruction: z.ZodString;
+        expected_observation: z.ZodString;
+        accepted_answers: z.ZodArray<z.ZodString>;
+        evidence_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        cleanup_required: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    strict_checkpoints: z.ZodOptional<z.ZodBoolean>;
+    evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodString;
+        artifact_path: z.ZodOptional<z.ZodString>;
+        redacted: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    cleanup: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    terminal: z.ZodArray<z.ZodObject<{
+        outcome: z.ZodEnum<{
+            cancelled: "cancelled";
+            failed: "failed";
+            succeeded: "succeeded";
+        }>;
+        state: z.ZodString;
+    }, z.core.$strip>>;
+    max_attempts: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type TestWorkflowDefinition = z.infer<typeof TestWorkflowDefinition>;
+//# sourceMappingURL=test-workflow.d.ts.map

package/dist/schemas/test-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-workflow.d.ts","sourceRoot":"","sources":["../../src/schemas/test-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,iBAAiB;;;;;iBAK5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,iBAAiB;;;;;;;;;iBAG5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;iBAKjC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E,eAAO,MAAM,qBAAqB;;;;;;;iBAOhC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E,eAAO,MAAM,oBAAoB;;;;;iBAK/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4BA,CAAC;AACpC,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/schemas/test-workflow.js

@@ -0,0 +1,69 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * TEST workflow declaration schema.
+ * TEST definitions describe Acceptance capabilities without coupling the runtime to a guide.
+ */
+import { z } from 'zod';
+import { itemIdPattern } from './item-id.js';
+import { TestProfile } from './test-profile.js';
+import { refineWorkflowGraph } from './workflow-graph.js';
+export const TestWorkflowState = z.object({
+    terminal: z.boolean().default(false),
+    resumable: z.boolean().default(true),
+    retryable: z.boolean().default(false),
+    requires_human: z.boolean().default(false),
+});
+export const TestWorkflowGuard = z.object({
+    kind: z.enum(['always', 'payload-present', 'payload-equals', 'state-equals', 'mcp-tool-receipt']),
+    parameters: z.record(z.string(), z.unknown()).default({}),
+});
+export const TestWorkflowTransition = z.object({
+    event: z.string().min(1).max(100),
+    from: z.array(z.string().min(1).max(100)).min(1),
+    to: z.string().min(1).max(100),
+    guards: z.array(TestWorkflowGuard).default([]),
+});
+export const TestWorkflowHumanStep = z.object({
+    id: z.string().min(1).max(100),
+    instruction: z.string().min(1).max(4000),
+    expected_observation: z.string().min(1).max(2000),
+    accepted_answers: z.array(z.string().min(1).max(200)).min(1),
+    evidence_ids: z.array(z.string().min(1).max(100)).default([]),
+    cleanup_required: z.boolean().default(false),
+});
+export const TestWorkflowEvidence = z.object({
+    id: z.string().min(1).max(100),
+    description: z.string().min(1).max(2000),
+    artifact_path: z.string().max(500).optional(),
+    redacted: z.boolean().default(true),
+});
+export const TestWorkflowDefinition = z
+    .object({
+    schema_version: z.literal('1.0'),
+    process_type: z.string().min(1).max(100),
+    profile: TestProfile,
+    derived_doc: z
+        .string()
+        .regex(/^DOC-\d+$/)
+        .optional(),
+    dependencies: z.array(z.string().regex(itemIdPattern())).default([]),
+    states: z.record(z.string(), TestWorkflowState),
+    initial: z.string().min(1).max(100),
+    transitions: z.array(TestWorkflowTransition),
+    human_steps: z.array(TestWorkflowHumanStep).default([]),
+    /** Reject a checkpoint_id that names no human step instead of warning (TASK-811). */
+    strict_checkpoints: z.boolean().optional(),
+    evidence: z.array(TestWorkflowEvidence).default([]),
+    cleanup: z.array(z.string().min(1).max(2000)).default([]),
+    terminal: z
+        .array(z.object({
+        outcome: z.enum(['succeeded', 'failed', 'cancelled']),
+        state: z.string().min(1).max(100),
+    }))
+        .min(1),
+    max_attempts: z.number().int().min(1).max(100).default(1),
+})
+    .superRefine(refineWorkflowGraph);
+//# sourceMappingURL=test-workflow.js.map

package/dist/schemas/test-workflow.js.map

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