@exaudeus/workrail 3.5.0 → 3.6.0

package/dist/v2/durable-core/schemas/compiled-workflow/index.d.ts

@@ -53,6 +53,82 @@ export declare const CompiledWorkflowSnapshotV1Schema: z.ZodDiscriminatedUnion<"
     definition: z.ZodType<unknown, z.ZodTypeDef, unknown>;
     resolvedBindings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     pinnedOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    resolvedReferences: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        source: z.ZodString;
+        purpose: z.ZodString;
+        authoritative: z.ZodBoolean;
+        resolveFrom: z.ZodEnum<["workspace", "package"]>;
+        status: z.ZodLiteral<"resolved">;
+        resolvedPath: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "resolved";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+        resolvedPath: string;
+    }, {
+        status: "resolved";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+        resolvedPath: string;
+    }>, z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        source: z.ZodString;
+        purpose: z.ZodString;
+        authoritative: z.ZodBoolean;
+        resolveFrom: z.ZodEnum<["workspace", "package"]>;
+        status: z.ZodLiteral<"unresolved">;
+    }, "strip", z.ZodTypeAny, {
+        status: "unresolved";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+    }, {
+        status: "unresolved";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+    }>, z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        source: z.ZodString;
+        purpose: z.ZodString;
+        authoritative: z.ZodBoolean;
+        resolveFrom: z.ZodEnum<["workspace", "package"]>;
+        status: z.ZodLiteral<"pinned">;
+    }, "strip", z.ZodTypeAny, {
+        status: "pinned";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+    }, {
+        status: "pinned";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     description: string;
@@ -63,6 +139,32 @@ export declare const CompiledWorkflowSnapshotV1Schema: z.ZodDiscriminatedUnion<"
     definition?: unknown;
     resolvedBindings?: Record<string, string> | undefined;
     pinnedOverrides?: Record<string, string> | undefined;
+    resolvedReferences?: ({
+        status: "resolved";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+        resolvedPath: string;
+    } | {
+        status: "unresolved";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+    } | {
+        status: "pinned";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+    })[] | undefined;
 }, {
     name: string;
     description: string;
@@ -73,6 +175,32 @@ export declare const CompiledWorkflowSnapshotV1Schema: z.ZodDiscriminatedUnion<"
     definition?: unknown;
     resolvedBindings?: Record<string, string> | undefined;
     pinnedOverrides?: Record<string, string> | undefined;
+    resolvedReferences?: ({
+        status: "resolved";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+        resolvedPath: string;
+    } | {
+        status: "unresolved";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+    } | {
+        status: "pinned";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+    })[] | undefined;
 }>]>;
 export type CompiledWorkflowSnapshotV1 = z.infer<typeof CompiledWorkflowSnapshotV1Schema>;
 export declare const CompiledWorkflowSnapshotSchema: z.ZodDiscriminatedUnion<"sourceKind", [z.ZodObject<{
@@ -129,6 +257,82 @@ export declare const CompiledWorkflowSnapshotSchema: z.ZodDiscriminatedUnion<"so
     definition: z.ZodType<unknown, z.ZodTypeDef, unknown>;
     resolvedBindings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     pinnedOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    resolvedReferences: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        source: z.ZodString;
+        purpose: z.ZodString;
+        authoritative: z.ZodBoolean;
+        resolveFrom: z.ZodEnum<["workspace", "package"]>;
+        status: z.ZodLiteral<"resolved">;
+        resolvedPath: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "resolved";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+        resolvedPath: string;
+    }, {
+        status: "resolved";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+        resolvedPath: string;
+    }>, z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        source: z.ZodString;
+        purpose: z.ZodString;
+        authoritative: z.ZodBoolean;
+        resolveFrom: z.ZodEnum<["workspace", "package"]>;
+        status: z.ZodLiteral<"unresolved">;
+    }, "strip", z.ZodTypeAny, {
+        status: "unresolved";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+    }, {
+        status: "unresolved";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+    }>, z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        source: z.ZodString;
+        purpose: z.ZodString;
+        authoritative: z.ZodBoolean;
+        resolveFrom: z.ZodEnum<["workspace", "package"]>;
+        status: z.ZodLiteral<"pinned">;
+    }, "strip", z.ZodTypeAny, {
+        status: "pinned";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+    }, {
+        status: "pinned";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     description: string;
@@ -139,6 +343,32 @@ export declare const CompiledWorkflowSnapshotSchema: z.ZodDiscriminatedUnion<"so
     definition?: unknown;
     resolvedBindings?: Record<string, string> | undefined;
     pinnedOverrides?: Record<string, string> | undefined;
+    resolvedReferences?: ({
+        status: "resolved";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+        resolvedPath: string;
+    } | {
+        status: "unresolved";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+    } | {
+        status: "pinned";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+    })[] | undefined;
 }, {
     name: string;
     description: string;
@@ -149,5 +379,31 @@ export declare const CompiledWorkflowSnapshotSchema: z.ZodDiscriminatedUnion<"so
     definition?: unknown;
     resolvedBindings?: Record<string, string> | undefined;
     pinnedOverrides?: Record<string, string> | undefined;
+    resolvedReferences?: ({
+        status: "resolved";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+        resolvedPath: string;
+    } | {
+        status: "unresolved";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+    } | {
+        status: "pinned";
+        id: string;
+        title: string;
+        source: string;
+        purpose: string;
+        authoritative: boolean;
+        resolveFrom: "workspace" | "package";
+    })[] | undefined;
 }>]>;
 export type CompiledWorkflowSnapshot = CompiledWorkflowSnapshotV1;

package/dist/v2/durable-core/schemas/compiled-workflow/index.js

@@ -26,6 +26,36 @@ const CompiledWorkflowSnapshotV1PinnedSchema = zod_1.z.object({
     definition: json_zod_js_1.JsonValueSchema,
     resolvedBindings: zod_1.z.record(zod_1.z.string()).optional(),
     pinnedOverrides: zod_1.z.record(zod_1.z.string()).optional(),
+    resolvedReferences: zod_1.z.array(zod_1.z.discriminatedUnion('status', [
+        zod_1.z.object({
+            id: zod_1.z.string().min(1),
+            title: zod_1.z.string().min(1),
+            source: zod_1.z.string().min(1),
+            purpose: zod_1.z.string().min(1),
+            authoritative: zod_1.z.boolean(),
+            resolveFrom: zod_1.z.enum(['workspace', 'package']),
+            status: zod_1.z.literal('resolved'),
+            resolvedPath: zod_1.z.string().min(1),
+        }),
+        zod_1.z.object({
+            id: zod_1.z.string().min(1),
+            title: zod_1.z.string().min(1),
+            source: zod_1.z.string().min(1),
+            purpose: zod_1.z.string().min(1),
+            authoritative: zod_1.z.boolean(),
+            resolveFrom: zod_1.z.enum(['workspace', 'package']),
+            status: zod_1.z.literal('unresolved'),
+        }),
+        zod_1.z.object({
+            id: zod_1.z.string().min(1),
+            title: zod_1.z.string().min(1),
+            source: zod_1.z.string().min(1),
+            purpose: zod_1.z.string().min(1),
+            authoritative: zod_1.z.boolean(),
+            resolveFrom: zod_1.z.enum(['workspace', 'package']),
+            status: zod_1.z.literal('pinned'),
+        }),
+    ])).optional(),
 });
 exports.CompiledWorkflowSnapshotV1Schema = zod_1.z.discriminatedUnion('sourceKind', [
     CompiledWorkflowSnapshotV1PreviewSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exaudeus/workrail",
-  "version": "3.5.0",
+  "version": "3.6.0",
   "description": "Step-by-step workflow enforcement for AI agents via MCP",
   "license": "MIT",
   "repository": {
@@ -32,6 +32,7 @@
     "console:build": "cd console && npm install && npm run build",
     "console:dev": "cd console && npm run dev",
     "build:all": "npm run build",
+    "docs:authoring": "node scripts/generate-authoring-docs.js",
     "docs:workflows": "node scripts/generate-workflow-docs.js",
     "generate:locks": "npx ts-node scripts/generate-lock-coverage.ts && npx ts-node scripts/generate-lock-coverage.ts --json",
     "verify:generated": "npm run generate:locks && git diff --exit-code -- docs/generated/v2-lock-coverage.json docs/generated/v2-lock-coverage.md docs/generated/v2-lock-closure-plan.md",
@@ -39,6 +40,8 @@
     "watch": "tsc --watch",
     "validate:workflows": "bash scripts/validate-workflows.sh",
     "validate:registry": "node scripts/validate-workflows-registry.ts",
+    "validate:authoring-spec": "node scripts/validate-authoring-spec.js",
+    "validate:authoring-docs": "node scripts/generate-authoring-docs.js --check",
     "validate:workflow-discovery": "node scripts/validate-workflow-discovery.js",
     "precommit": "npm run validate:registry",
     "preinstall": "node -e \"const v=parseInt(process.versions.node.split('.')[0],10); if(v<20){console.error('WorkRail requires Node.js >=20. Current: '+process.versions.node+'\\nPlease upgrade: https://nodejs.org/'); process.exit(1);}\"",

package/spec/authoring-spec.provenance.json

@@ -0,0 +1,77 @@
+{
+  "version": 1,
+  "title": "WorkRail Authoring Spec Provenance",
+  "purpose": "Maintainer-facing provenance and source hierarchy for authoring-spec.json.",
+  "canonicalSources": [
+    {
+      "path": "spec/workflow.schema.json",
+      "role": "Legal workflow structure"
+    },
+    {
+      "path": "src/application/services/validation-engine.ts",
+      "role": "Structural authoring invariants actually enforced"
+    },
+    {
+      "path": "src/infrastructure/storage/schema-validating-workflow-storage.ts",
+      "role": "Runtime-authoritative schema validation"
+    },
+    {
+      "path": "scripts/validate-workflows-registry.ts",
+      "role": "Registry and discoverability validation"
+    },
+    {
+      "path": "src/v2/durable-core/domain/prompt-renderer.ts",
+      "role": "Runtime prompt rendering and prompt composition behavior"
+    }
+  ],
+  "secondarySources": [
+    {
+      "path": "docs/design/workflow-authoring-v2.md",
+      "role": "Design intent and model rationale"
+    },
+    {
+      "path": "docs/authoring-v2.md",
+      "role": "High-level v2 authoring guidance"
+    },
+    {
+      "path": "docs/authoring.md",
+      "role": "Human-readable guide"
+    },
+    {
+      "path": "docs/workflow-validation.md",
+      "role": "Practical validation workflow"
+    },
+    {
+      "path": "docs/reference/god-tier-workflow-validation.md",
+      "role": "Validation philosophy and correctness bar"
+    },
+    {
+      "path": "workflows/coding-task-workflow-agentic.lean.v2.json",
+      "role": "Current example of modern workflow style"
+    }
+  ],
+  "nonCanonicalSources": [
+    {
+      "path": "docs/plans/**",
+      "role": "Historical or supporting context only"
+    },
+    {
+      "path": "ADRs and transitional notes",
+      "role": "Historical or supporting context only"
+    }
+  ],
+  "derivedArtifacts": [
+    {
+      "path": "docs/authoring.md",
+      "role": "Primary human-readable guide derived from authoring-spec.json"
+    },
+    {
+      "path": "docs/authoring-v2.md",
+      "role": "Candidate for merge or retirement once coverage is preserved"
+    }
+  ],
+  "notes": [
+    "This file exists to keep provenance out of the main authoring rules file.",
+    "authoring-spec.json should stay author-facing and current-rule-focused."
+  ]
+}