@openspecui/core 11.1.0 → 13.0.0

package/dist/{active-root-config-CsFtntHf.d.mts → active-root-config-_ZXqUzpc.d.mts}

@@ -1,4 +1,4 @@
-import { At as CliRootSource, Mt as CliExecutor, Nt as CliResult, bt as CliDiagnostic, f as CliDoctor, gt as CliCommandResult, l as OpenSpecCliContractExecutor, n as CliRootSelector, u as CliContext, vt as CliJsonValue, wt as CliDoctorReferenceEntry } from "./index-jbHV-sxg.mjs";
+import { Ct as CliJsonValue, Ft as CliRootSource, Lt as CliExecutor, Rt as CliResult, Tt as CliDiagnostic, f as CliDoctor, kt as CliDoctorReferenceEntry, l as OpenSpecCliContractExecutor, n as CliRootSelector, u as CliContext, xt as CliCommandResult } from "./index-zESQZeBd.mjs";
 import { z } from "zod";
 
 //#region src/open-spec-data-scope.d.ts
@@ -393,8 +393,8 @@ declare const ActiveRootOfficialConfigSchema: z.ZodObject<{
     } | undefined;
   }>>;
 }, "strict", z.ZodTypeAny, {
-  context: string | null;
   schema: string | null;
+  context: string | null;
   rules: Record<string, string[]> | null;
   operations: {
     apply?: {
@@ -405,8 +405,8 @@ declare const ActiveRootOfficialConfigSchema: z.ZodObject<{
     } | undefined;
   } | null;
 }, {
-  context: string | null;
   schema: string | null;
+  context: string | null;
   rules: Record<string, string[]> | null;
   operations: {
     apply?: {
@@ -455,8 +455,8 @@ declare const ActiveRootStructuredUpdateSchema: z.ZodObject<{
     } | null;
   }>>;
 }, "strict", z.ZodTypeAny, {
-  context: string | null;
   schema: string;
+  context: string | null;
   rules: Record<string, string[]> | null;
   operations: {
     apply: {
@@ -467,8 +467,8 @@ declare const ActiveRootStructuredUpdateSchema: z.ZodObject<{
     } | null;
   } | null;
 }, {
-  context: string | null;
   schema: string;
+  context: string | null;
   rules: Record<string, string[]> | null;
   operations: {
     apply: {
@@ -523,8 +523,8 @@ declare const ActiveRootMutationSchema: z.ZodDiscriminatedUnion<"mode", [z.ZodOb
       } | null;
     }>>;
   }, "strict", z.ZodTypeAny, {
-    context: string | null;
     schema: string;
+    context: string | null;
     rules: Record<string, string[]> | null;
     operations: {
       apply: {
@@ -535,8 +535,8 @@ declare const ActiveRootMutationSchema: z.ZodDiscriminatedUnion<"mode", [z.ZodOb
       } | null;
     } | null;
   }, {
-    context: string | null;
     schema: string;
+    context: string | null;
     rules: Record<string, string[]> | null;
     operations: {
       apply: {
@@ -551,11 +551,9 @@ declare const ActiveRootMutationSchema: z.ZodDiscriminatedUnion<"mode", [z.ZodOb
   filePath: z.ZodString;
   revision: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-  filePath: string;
-  revision: string;
   update: {
-    context: string | null;
     schema: string;
+    context: string | null;
     rules: Record<string, string[]> | null;
     operations: {
       apply: {
@@ -567,13 +565,13 @@ declare const ActiveRootMutationSchema: z.ZodDiscriminatedUnion<"mode", [z.ZodOb
     } | null;
   };
   mode: "structured";
+  revision: string;
+  filePath: string;
   ownerPath: string;
 }, {
-  filePath: string;
-  revision: string;
   update: {
-    context: string | null;
     schema: string;
+    context: string | null;
     rules: Record<string, string[]> | null;
     operations: {
       apply: {
@@ -585,6 +583,8 @@ declare const ActiveRootMutationSchema: z.ZodDiscriminatedUnion<"mode", [z.ZodOb
     } | null;
   };
   mode: "structured";
+  revision: string;
+  filePath: string;
   ownerPath: string;
 }>, z.ZodObject<{
   mode: z.ZodLiteral<"raw">;
@@ -593,16 +593,16 @@ declare const ActiveRootMutationSchema: z.ZodDiscriminatedUnion<"mode", [z.ZodOb
   filePath: z.ZodString;
   revision: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-  filePath: string;
-  revision: string;
   mode: "raw";
   content: string;
+  revision: string;
+  filePath: string;
   ownerPath: string;
 }, {
-  filePath: string;
-  revision: string;
   mode: "raw";
   content: string;
+  revision: string;
+  filePath: string;
   ownerPath: string;
 }>]>;
 /** Revision-aware Active Root mutation request. */

package/dist/active-root-config.d.mts

@@ -1,6 +1,6 @@
-import "./index-jbHV-sxg.mjs";
-import "./document-translation-OvsFNs-H.mjs";
-import "./sounds-B0GiWqBN.mjs";
-import "./notifications-B8Ael_hq.mjs";
-import { _ as ActiveRootStructuredUpdateSchema, a as ActiveRootConfigDiagnostic, c as ActiveRootMutation, d as ActiveRootOfficialConfig, f as ActiveRootOfficialConfigSchema, g as ActiveRootStructuredUpdate, h as ActiveRootRevisionSchema, i as ActiveRootConfig, l as ActiveRootMutationResult, m as ActiveRootRevision, n as patchActiveRootOfficialFields, o as ActiveRootConfigFile, p as ActiveRootRawValidation, r as validateActiveRootRawYaml, s as ActiveRootConfigInspection, t as inspectActiveRootOfficialConfig, u as ActiveRootMutationSchema, v as MAX_ACTIVE_ROOT_CONTEXT_BYTES } from "./active-root-config-CsFtntHf.mjs";
+import "./index-zESQZeBd.mjs";
+import "./document-translation-DM2eydNr.mjs";
+import "./sounds-BCmBc3Lm.mjs";
+import "./notifications-DwiGoWFM.mjs";
+import { _ as ActiveRootStructuredUpdateSchema, a as ActiveRootConfigDiagnostic, c as ActiveRootMutation, d as ActiveRootOfficialConfig, f as ActiveRootOfficialConfigSchema, g as ActiveRootStructuredUpdate, h as ActiveRootRevisionSchema, i as ActiveRootConfig, l as ActiveRootMutationResult, m as ActiveRootRevision, n as patchActiveRootOfficialFields, o as ActiveRootConfigFile, p as ActiveRootRawValidation, r as validateActiveRootRawYaml, s as ActiveRootConfigInspection, t as inspectActiveRootOfficialConfig, u as ActiveRootMutationSchema, v as MAX_ACTIVE_ROOT_CONTEXT_BYTES } from "./active-root-config-_ZXqUzpc.mjs";
 export { ActiveRootConfig, ActiveRootConfigDiagnostic, ActiveRootConfigFile, ActiveRootConfigInspection, ActiveRootMutation, ActiveRootMutationResult, ActiveRootMutationSchema, ActiveRootOfficialConfig, ActiveRootOfficialConfigSchema, ActiveRootRawValidation, ActiveRootRevision, ActiveRootRevisionSchema, ActiveRootStructuredUpdate, ActiveRootStructuredUpdateSchema, MAX_ACTIVE_ROOT_CONTEXT_BYTES, inspectActiveRootOfficialConfig, patchActiveRootOfficialFields, validateActiveRootRawYaml };

package/dist/app-daemon-control.d.mts

@@ -302,21 +302,21 @@ declare const AppDaemonStartManagedProjectResponseSchema: z.ZodDiscriminatedUnio
     code: z.ZodEnum<["UNSUPPORTED", "INVALID_DIRECTORY", "SPAWN_FAILED", "GENERATION_MISMATCH", "INVALID_REQUEST"]>;
     message: z.ZodString;
   }, "strip", z.ZodTypeAny, {
-    code: "INVALID_REQUEST" | "UNSUPPORTED" | "INVALID_DIRECTORY" | "SPAWN_FAILED" | "GENERATION_MISMATCH";
+    code: "UNSUPPORTED" | "INVALID_DIRECTORY" | "SPAWN_FAILED" | "GENERATION_MISMATCH" | "INVALID_REQUEST";
     message: string;
   }, {
-    code: "INVALID_REQUEST" | "UNSUPPORTED" | "INVALID_DIRECTORY" | "SPAWN_FAILED" | "GENERATION_MISMATCH";
+    code: "UNSUPPORTED" | "INVALID_DIRECTORY" | "SPAWN_FAILED" | "GENERATION_MISMATCH" | "INVALID_REQUEST";
     message: string;
   }>;
 }, "strip", z.ZodTypeAny, {
   error: {
-    code: "INVALID_REQUEST" | "UNSUPPORTED" | "INVALID_DIRECTORY" | "SPAWN_FAILED" | "GENERATION_MISMATCH";
+    code: "UNSUPPORTED" | "INVALID_DIRECTORY" | "SPAWN_FAILED" | "GENERATION_MISMATCH" | "INVALID_REQUEST";
     message: string;
   };
   ok: false;
 }, {
   error: {
-    code: "INVALID_REQUEST" | "UNSUPPORTED" | "INVALID_DIRECTORY" | "SPAWN_FAILED" | "GENERATION_MISMATCH";
+    code: "UNSUPPORTED" | "INVALID_DIRECTORY" | "SPAWN_FAILED" | "GENERATION_MISMATCH" | "INVALID_REQUEST";
     message: string;
   };
   ok: false;
@@ -338,21 +338,21 @@ declare const AppDaemonStopManagedProjectResponseSchema: z.ZodDiscriminatedUnion
     code: z.ZodEnum<["UNSUPPORTED", "INVALID_DIRECTORY", "SPAWN_FAILED", "GENERATION_MISMATCH", "INVALID_REQUEST"]>;
     message: z.ZodString;
   }, "strip", z.ZodTypeAny, {
-    code: "INVALID_REQUEST" | "UNSUPPORTED" | "INVALID_DIRECTORY" | "SPAWN_FAILED" | "GENERATION_MISMATCH";
+    code: "UNSUPPORTED" | "INVALID_DIRECTORY" | "SPAWN_FAILED" | "GENERATION_MISMATCH" | "INVALID_REQUEST";
     message: string;
   }, {
-    code: "INVALID_REQUEST" | "UNSUPPORTED" | "INVALID_DIRECTORY" | "SPAWN_FAILED" | "GENERATION_MISMATCH";
+    code: "UNSUPPORTED" | "INVALID_DIRECTORY" | "SPAWN_FAILED" | "GENERATION_MISMATCH" | "INVALID_REQUEST";
     message: string;
   }>;
 }, "strip", z.ZodTypeAny, {
   error: {
-    code: "INVALID_REQUEST" | "UNSUPPORTED" | "INVALID_DIRECTORY" | "SPAWN_FAILED" | "GENERATION_MISMATCH";
+    code: "UNSUPPORTED" | "INVALID_DIRECTORY" | "SPAWN_FAILED" | "GENERATION_MISMATCH" | "INVALID_REQUEST";
     message: string;
   };
   ok: false;
 }, {
   error: {
-    code: "INVALID_REQUEST" | "UNSUPPORTED" | "INVALID_DIRECTORY" | "SPAWN_FAILED" | "GENERATION_MISMATCH";
+    code: "UNSUPPORTED" | "INVALID_DIRECTORY" | "SPAWN_FAILED" | "GENERATION_MISMATCH" | "INVALID_REQUEST";
     message: string;
   };
   ok: false;

package/dist/{cli-projection-Dd5Gdqa2.d.mts → cli-projection-D932MJzB.d.mts}

@@ -1,4 +1,4 @@
-import { gt as CliCommandResult, vt as CliJsonValue } from "./index-jbHV-sxg.mjs";
+import { Ct as CliJsonValue, xt as CliCommandResult } from "./index-zESQZeBd.mjs";
 import { z } from "zod";
 
 //#region src/cli-projection.d.ts
@@ -215,22 +215,22 @@ declare function createCliProjectionStateSchema<TOutput, TInput>(dataSchema: z.Z
   workGeneration: z.ZodNumber;
   invalidationCause: z.ZodEnum<["initial", "dependency", "explicit-refresh", "subscriber-resume"]>;
 }, "strip", z.ZodTypeAny, {
-  identity: string;
-  workGeneration: number;
-  snapshotGeneration: null;
   error: null;
   state: "loading";
   data: null;
   freshness: null;
-  invalidationCause: "initial" | "dependency" | "explicit-refresh" | "subscriber-resume";
-}, {
+  snapshotGeneration: null;
   identity: string;
   workGeneration: number;
-  snapshotGeneration: null;
+  invalidationCause: "initial" | "dependency" | "explicit-refresh" | "subscriber-resume";
+}, {
   error: null;
   state: "loading";
   data: null;
   freshness: null;
+  snapshotGeneration: null;
+  identity: string;
+  workGeneration: number;
   invalidationCause: "initial" | "dependency" | "explicit-refresh" | "subscriber-resume";
 }>, z.ZodObject<{
   state: z.ZodLiteral<"ready">;
@@ -390,9 +390,6 @@ declare function createCliProjectionStateSchema<TOutput, TInput>(dataSchema: z.Z
   workGeneration: z.ZodNumber;
   invalidationCause: z.ZodEnum<["initial", "dependency", "explicit-refresh", "subscriber-resume"]>;
 }, "strip", z.ZodTypeAny, {
-  identity: string;
-  workGeneration: number;
-  snapshotGeneration: null;
   error: {
     message: string;
     name: string;
@@ -415,11 +412,11 @@ declare function createCliProjectionStateSchema<TOutput, TInput>(dataSchema: z.Z
   state: "error";
   data: null;
   freshness: null;
-  invalidationCause: "initial" | "dependency" | "explicit-refresh" | "subscriber-resume";
-}, {
+  snapshotGeneration: null;
   identity: string;
   workGeneration: number;
-  snapshotGeneration: null;
+  invalidationCause: "initial" | "dependency" | "explicit-refresh" | "subscriber-resume";
+}, {
   error: {
     message: string;
     name: string;
@@ -442,6 +439,9 @@ declare function createCliProjectionStateSchema<TOutput, TInput>(dataSchema: z.Z
   state: "error";
   data: null;
   freshness: null;
+  snapshotGeneration: null;
+  identity: string;
+  workGeneration: number;
   invalidationCause: "initial" | "dependency" | "explicit-refresh" | "subscriber-resume";
 }>, z.ZodObject<{
   state: z.ZodLiteral<"refresh-error">;
@@ -761,16 +761,16 @@ declare const CliProjectionNoticeSchema: z.ZodObject<{
   state: z.ZodEnum<["loading", "ready", "revalidating", "error", "refresh-error"]>;
   invalidationCause: z.ZodEnum<["initial", "dependency", "explicit-refresh", "subscriber-resume"]>;
 }, "strip", z.ZodTypeAny, {
+  state: "error" | "loading" | "ready" | "revalidating" | "refresh-error";
+  snapshotGeneration: number | null;
   identity: string;
   workGeneration: number;
-  snapshotGeneration: number | null;
-  state: "loading" | "ready" | "revalidating" | "error" | "refresh-error";
   invalidationCause: "initial" | "dependency" | "explicit-refresh" | "subscriber-resume";
 }, {
+  state: "error" | "loading" | "ready" | "revalidating" | "refresh-error";
+  snapshotGeneration: number | null;
   identity: string;
   workGeneration: number;
-  snapshotGeneration: number | null;
-  state: "loading" | "ready" | "revalidating" | "error" | "refresh-error";
   invalidationCause: "initial" | "dependency" | "explicit-refresh" | "subscriber-resume";
 }>;
 type CliProjectionNotice = z.infer<typeof CliProjectionNoticeSchema>;

package/dist/cli-projection.d.mts

@@ -1,6 +1,6 @@
-import "./index-jbHV-sxg.mjs";
-import "./document-translation-OvsFNs-H.mjs";
-import "./sounds-B0GiWqBN.mjs";
-import "./notifications-B8Ael_hq.mjs";
-import { _ as toCliProjectionCommandEvidence, a as CliProjectionFailure, c as CliProjectionInvalidationCauseSchema, d as CliProjectionState, f as CliProjectionStateName, g as createCliProjectionStateSchema, h as cliProjectionStates, i as CliProjectionCommandEvidenceSchema, l as CliProjectionNotice, m as cliProjectionInvalidationCauses, n as CliProjectionCommandError, o as CliProjectionFailureSchema, p as CliProjectionStateNameSchema, r as CliProjectionCommandEvidence, s as CliProjectionInvalidationCause, t as CliJsonValueSchema, u as CliProjectionNoticeSchema, v as toCliProjectionFailure, y as toCliProjectionNotice } from "./cli-projection-Dd5Gdqa2.mjs";
+import "./index-zESQZeBd.mjs";
+import "./document-translation-DM2eydNr.mjs";
+import "./sounds-BCmBc3Lm.mjs";
+import "./notifications-DwiGoWFM.mjs";
+import { _ as toCliProjectionCommandEvidence, a as CliProjectionFailure, c as CliProjectionInvalidationCauseSchema, d as CliProjectionState, f as CliProjectionStateName, g as createCliProjectionStateSchema, h as cliProjectionStates, i as CliProjectionCommandEvidenceSchema, l as CliProjectionNotice, m as cliProjectionInvalidationCauses, n as CliProjectionCommandError, o as CliProjectionFailureSchema, p as CliProjectionStateNameSchema, r as CliProjectionCommandEvidence, s as CliProjectionInvalidationCause, t as CliJsonValueSchema, u as CliProjectionNoticeSchema, v as toCliProjectionFailure, y as toCliProjectionNotice } from "./cli-projection-D932MJzB.mjs";
 export { CliJsonValueSchema, CliProjectionCommandError, CliProjectionCommandEvidence, CliProjectionCommandEvidenceSchema, CliProjectionFailure, CliProjectionFailureSchema, CliProjectionInvalidationCause, CliProjectionInvalidationCauseSchema, CliProjectionNotice, CliProjectionNoticeSchema, CliProjectionState, CliProjectionStateName, CliProjectionStateNameSchema, cliProjectionInvalidationCauses, cliProjectionStates, createCliProjectionStateSchema, toCliProjectionCommandEvidence, toCliProjectionFailure, toCliProjectionNotice };

package/dist/{command-result-DWMmDl6I.mjs → command-result-Eq147Dt4.mjs}

@@ -3,7 +3,7 @@ import { z } from "zod";
 
 //#region src/cli-contracts/workflow.ts
 /**
-* Orthogonal intents (updated 2026-08-28 Asia/Shanghai):
+* Orthogonal intents (updated 2026-09-12 Asia/Shanghai):
 * 1. Model camelCase workflow JSON independently from Store-family JSON.
 * 2. Preserve strict, archived, and bulk Validate plus Archive outcomes, including failure payloads.
 * 3. Preserve multiline requirement bodies from `show --json`.
@@ -11,11 +11,23 @@ import { z } from "zod";
 * 5. Export the successful Spec-document schema for browser-safe projection validation.
 * 6. Export the root-less Status payload fields and Requirement shape shared with the
 *    OpenSpec 1.11 batch Status and show --diff contracts.
+* 7. Model the OpenSpec 1.12 `validate --report findings` document beside (never inside) the
+*    full Validate report, sharing the bulk-item and summary shapes while keeping decoding
+*    independent of the process exit code and of full-report validation truth. Decode owns
+*    the upstream-guaranteed invariants (non-empty per-item issues, returnedItems bounded
+*    by totalItems), and the union guard validates the discriminator shape rather than
+*    mere `report`-key presence.
+* 8. Type the OpenSpec 1.13 Apply Instructions `missingPrerequisites` (build-order closure,
+*    present even when ready) and `warnings` (no-delta-specs advisory) as additive optional
+*    success members that never gain default empty arrays, never alter `state`/`progress`/
+*    `tasks`/`missingArtifacts` semantics, and stay verbatim CLI evidence.
 *
 * Original request (2026-07-15): "为不同命令建立强类型适配器，不实现平行解析规则。"
 * Original request (2026-07-26): "展开全面的接口升级和内核升级和测试升级。"
 * Original request (2026-08-15): "v9的适配需要同时适配 1.8和1.9。"
 * Original request (2026-08-28): "直接将 0.10.0 和 0.11.0 一起适配，然后发布 v11。"
+* Original request (2026-09-03): "Openspec 1.12.0 刚刚放出来，你更新一下，调查变更内容，然后开始规划适配工作，我们将用标准工作流worktree来推进"
+* Original request (2026-09-12): "Openspec 1.13.0 释放了，你更新一下，调查变更内容，然后开始规划适配工作，我们将用标准工作流worktree来推进。让 codex 参与。"
 */
 const CliChangeListEntrySchema = z.object({
 	name: z.string(),
@@ -207,6 +219,8 @@ const CliApplyInstructionsSuccessSchema = z.object({
 		"ready"
 	]),
 	missingArtifacts: z.array(z.string()).optional(),
+	missingPrerequisites: z.array(z.string()).optional(),
+	warnings: z.array(z.string()).optional(),
 	instruction: z.string(),
 	references: z.array(CliReferenceIndexEntrySchema).optional(),
 	context: z.string().optional(),
@@ -240,24 +254,110 @@ const CliValidationTotalsSchema = z.object({
 	passed: z.number(),
 	failed: z.number()
 }).passthrough();
+/** One bulk Validate item: verdict, full issue array, and runtime-dependent duration. */
+const CliValidateItemSchema = z.object({
+	id: z.string(),
+	type: z.enum(["change", "spec"]),
+	valid: z.boolean(),
+	issues: z.array(CliValidationIssueSchema),
+	durationMs: z.number()
+}).passthrough();
+/** Shared Validate summary: full-run totals plus per-type totals, never the filtered view. */
+const CliValidateSummarySchema = z.object({
+	totals: CliValidationTotalsSchema,
+	byType: z.record(CliValidationTotalsSchema)
+}).passthrough();
 /** Typed ordinary Validate report, also used by 1.9 `validate --archived --json`. */
 const CliValidateReportSchema = z.object({
-	items: z.array(z.object({
-		id: z.string(),
-		type: z.enum(["change", "spec"]),
-		valid: z.boolean(),
-		issues: z.array(CliValidationIssueSchema),
-		durationMs: z.number()
-	}).passthrough()),
-	summary: z.object({
-		totals: CliValidationTotalsSchema,
-		byType: z.record(CliValidationTotalsSchema)
-	}).passthrough(),
+	items: z.array(CliValidateItemSchema),
+	summary: CliValidateSummarySchema,
 	version: z.string(),
 	root: CliRootSchema
 }).passthrough();
 /** Typed strict, non-strict, or archived Validate result, including failure diagnostics. */
 const CliValidateSchema = z.union([CliValidateReportSchema, CliDiagnosticFailureSchema]);
+/**
+* Typed OpenSpec 1.12 `validate --report findings` document.
+*
+* The findings report is a filtered evidence transport beside the full report, never the
+* validation truth: `itemFindings` carries only items with issues, while `summary` and
+* `root` stay the full-run values the CLI computed over every item in scope.
+* `report.returnedItems`/`report.totalItems` distinguish the filtered view from the run
+* size, and the process exit code keeps the full-run rule (`failed > 0 -> 1`), so decoding
+* never consults it. An empty scope is the success document
+* `{ returnedItems: 0, totalItems: 0, itemFindings: [] }`, not a failure sum type.
+*
+* Two upstream-guaranteed invariants are decode-level facts (pinned v1.12.0
+* `projectValidationFindings`): every `itemFindings` entry carries at least one issue
+* (upstream filters `item.issues.length > 0`), and `returnedItems` never exceeds
+* `totalItems` (the filtered view is a subset of the full run). Upstream also happens to
+* set `returnedItems === itemFindings.length` today; that equality stays unasserted so a
+* future patch-level count adjustment inside the admitted range cannot fabricate a
+* contract error out of otherwise well-formed CLI evidence.
+*/
+const CliValidateFindingsSchema = z.object({
+	report: z.object({
+		kind: z.literal("validation-findings"),
+		version: z.string(),
+		scope: z.enum([
+			"all",
+			"changes",
+			"specs",
+			"archived"
+		]),
+		returnedItems: z.number(),
+		totalItems: z.number()
+	}).passthrough(),
+	itemFindings: z.array(CliValidateItemSchema),
+	summary: CliValidateSummarySchema,
+	root: CliRootSchema
+}).passthrough().superRefine((document, ctx) => {
+	if (document.report.returnedItems > document.report.totalItems) ctx.addIssue({
+		code: z.ZodIssueCode.custom,
+		path: ["report", "returnedItems"],
+		message: `returnedItems (${document.report.returnedItems}) must not exceed totalItems (${document.report.totalItems}).`
+	});
+	document.itemFindings.forEach((finding, index) => {
+		if (finding.issues.length === 0) ctx.addIssue({
+			code: z.ZodIssueCode.custom,
+			path: [
+				"itemFindings",
+				index,
+				"issues"
+			],
+			message: "Every findings item must carry at least one issue."
+		});
+	});
+});
+/**
+* Typed findings or request-failure result of `validate --report findings --json`.
+*
+* Invalid requests (no bulk scope, an item name, archived+active mixing, or an unknown
+* report value) produce the shared status-array failure envelope with code
+* `invalid_validation_report_request`, decoded here through the shared diagnostic
+* failure schema including its optional `fix` string.
+*/
+const CliValidateFindingsResultSchema = z.union([CliValidateFindingsSchema, CliDiagnosticFailureSchema]);
+/**
+* Whether a findings result is the findings document rather than the request-failure
+* envelope. Passthrough tolerance means a failure envelope may legally carry unknown
+* keys, so mere `report`-key presence cannot discriminate the union: the guard validates
+* the upstream discriminator shape — `report` is an object whose `kind` is the
+* `validation-findings` literal and whose count fields are numbers.
+*
+* The input is deliberately `unknown`: route and evidence consumers receive the union
+* of every validate transport (`CliValidate | CliValidateFindingsResult | null`), so the
+* guard must accept the consumed boundary, not only the already-narrowed findings union.
+* It stays a cheap shape check, never a second decode: schema-level invariants
+* (issue presence, count bounds) belong to `CliValidateFindingsSchema` alone.
+*/
+function isCliValidateFindings(result) {
+	if (typeof result !== "object" || result === null) return false;
+	const report = result.report;
+	if (typeof report !== "object" || report === null) return false;
+	const { kind, returnedItems, totalItems } = report;
+	return kind === "validation-findings" && typeof returnedItems === "number" && typeof totalItems === "number";
+}
 const CliArchiveTotalsSchema = z.object({
 	added: z.number(),
 	modified: z.number(),
@@ -352,4 +452,4 @@ function parseCliCommandResult(result, schema) {
 }
 
 //#endregion
-export { CliValidateReportSchema as C, CliWorkflowStatusSuccessSchema as D, CliWorkflowStatusSchema as E, CliTemplatesSchema as S, CliWorkflowStatusFieldsSchema as T, CliShowSpecDocumentSchema as _, CliApplyInstructionsSuccessSchema as a, CliSpecRequirementSchema as b, CliArchiveSchema as c, CliArtifactPathSchema as d, CliChangeListSchema as f, CliSchemaWhichSchema as g, CliSchemaShadowSchema as h, CliApplyInstructionsSchema as i, CliArtifactInstructionsSchema as l, CliSchemaResolutionSchema as m, parseCliCommandResult as n, CliArchiveInstructionsSchema as o, CliPlanningHomeSchema as p, CliActionContextSchema as r, CliArchiveInstructionsSuccessSchema as s, CliCommandTransportSchema as t, CliArtifactInstructionsSuccessSchema as u, CliShowSpecSchema as v, CliValidateSchema as w, CliTemplateEntrySchema as x, CliSpecListSchema as y };
+export { isCliValidateFindings as A, CliValidateFindingsResultSchema as C, CliWorkflowStatusFieldsSchema as D, CliValidateSchema as E, CliWorkflowStatusSchema as O, CliTemplatesSchema as S, CliValidateReportSchema as T, CliShowSpecDocumentSchema as _, CliApplyInstructionsSuccessSchema as a, CliSpecRequirementSchema as b, CliArchiveSchema as c, CliArtifactPathSchema as d, CliChangeListSchema as f, CliSchemaWhichSchema as g, CliSchemaShadowSchema as h, CliApplyInstructionsSchema as i, CliWorkflowStatusSuccessSchema as k, CliArtifactInstructionsSchema as l, CliSchemaResolutionSchema as m, parseCliCommandResult as n, CliArchiveInstructionsSchema as o, CliPlanningHomeSchema as p, CliActionContextSchema as r, CliArchiveInstructionsSuccessSchema as s, CliCommandTransportSchema as t, CliArtifactInstructionsSuccessSchema as u, CliShowSpecSchema as v, CliValidateFindingsSchema as w, CliTemplateEntrySchema as x, CliSpecListSchema as y };