@openspecui/core 4.1.0 → 6.0.0-beta.0

package/dist/cli-projection-vO3-FJg5.mjs

@@ -0,0 +1,161 @@
+import { n as CliDiagnosticSchema } from "./common-D8YUK9dA.mjs";
+import { z } from "zod";
+
+//#region src/cli-projection.ts
+/**
+* Orthogonal intents (updated 2026-07-26 Asia/Shanghai):
+* 1. Define the browser-safe lifecycle for one cached CLI-backed projection.
+* 2. Keep settled snapshot provenance separate from replacement Work lifecycle.
+* 3. Define lifecycle-only Push notices for typed client Pull.
+* 4. Preserve exact typed CLI failure evidence without fabricating it for infrastructure errors.
+*
+* Original request (2026-07-26): "即便现在有正在的任务，界面上仍然可以读到缓存，但它也能知道这个缓存现在正在被更新中。"
+*/
+const CliJsonValueSchema = z.lazy(() => z.union([
+	z.string(),
+	z.number(),
+	z.boolean(),
+	z.null(),
+	z.array(CliJsonValueSchema),
+	z.record(z.string(), CliJsonValueSchema)
+]));
+/** Complete CLI attempt evidence retained when a Projection Work command rejects. */
+const CliProjectionCommandEvidenceSchema = z.object({
+	success: z.boolean(),
+	stdout: z.string(),
+	stderr: z.string(),
+	exitCode: z.number().int().nullable(),
+	payload: CliJsonValueSchema.nullable(),
+	diagnostics: z.array(CliDiagnosticSchema),
+	contractError: z.string().optional()
+});
+/** Serializable infrastructure failure for one Projection Work attempt. */
+const CliProjectionFailureSchema = z.object({
+	name: z.string(),
+	message: z.string(),
+	cliEvidence: CliProjectionCommandEvidenceSchema.nullable()
+});
+const cliProjectionStates = [
+	"loading",
+	"ready",
+	"revalidating",
+	"error",
+	"refresh-error"
+];
+const CliProjectionStateNameSchema = z.enum(cliProjectionStates);
+const cliProjectionInvalidationCauses = [
+	"initial",
+	"dependency",
+	"explicit-refresh",
+	"subscriber-resume"
+];
+const CliProjectionInvalidationCauseSchema = z.enum(cliProjectionInvalidationCauses);
+/** Build a runtime decoder for one concrete CLI projection payload. */
+function createCliProjectionStateSchema(dataSchema) {
+	const base = {
+		identity: z.string().min(1),
+		workGeneration: z.number().int().nonnegative(),
+		invalidationCause: CliProjectionInvalidationCauseSchema
+	};
+	return z.discriminatedUnion("state", [
+		z.object({
+			...base,
+			state: z.literal("loading"),
+			data: z.null(),
+			freshness: z.null(),
+			snapshotGeneration: z.null(),
+			error: z.null()
+		}),
+		z.object({
+			...base,
+			state: z.literal("ready"),
+			data: dataSchema,
+			freshness: z.literal("current"),
+			snapshotGeneration: z.number().int().nonnegative(),
+			error: z.null()
+		}),
+		z.object({
+			...base,
+			state: z.literal("revalidating"),
+			data: dataSchema,
+			freshness: z.literal("stale-display-only"),
+			snapshotGeneration: z.number().int().nonnegative(),
+			error: z.null()
+		}),
+		z.object({
+			...base,
+			state: z.literal("error"),
+			data: z.null(),
+			freshness: z.null(),
+			snapshotGeneration: z.null(),
+			error: CliProjectionFailureSchema
+		}),
+		z.object({
+			...base,
+			state: z.literal("refresh-error"),
+			data: dataSchema,
+			freshness: z.literal("stale-display-only"),
+			snapshotGeneration: z.number().int().nonnegative(),
+			error: CliProjectionFailureSchema
+		})
+	]);
+}
+/** Lifecycle-only Server Push that wakes a client Pull without duplicating projection data. */
+const CliProjectionNoticeSchema = z.object({
+	identity: z.string().min(1),
+	workGeneration: z.number().int().nonnegative(),
+	snapshotGeneration: z.number().int().nonnegative().nullable(),
+	state: CliProjectionStateNameSchema,
+	invalidationCause: CliProjectionInvalidationCauseSchema
+});
+/** Error raised by a typed CLI reader while retaining its complete command evidence. */
+var CliProjectionCommandError = class extends Error {
+	cliEvidence;
+	constructor(message, result) {
+		super(message);
+		this.name = "CliProjectionCommandError";
+		this.cliEvidence = toCliProjectionCommandEvidence(result);
+	}
+};
+/** Remove typed business data while retaining every process/parser fact for public projection evidence. */
+function toCliProjectionCommandEvidence(result) {
+	return CliProjectionCommandEvidenceSchema.parse({
+		success: result.success,
+		stdout: result.stdout,
+		stderr: result.stderr,
+		exitCode: result.exitCode,
+		payload: result.payload,
+		diagnostics: result.diagnostics,
+		...result.contractError ? { contractError: result.contractError } : {}
+	});
+}
+/** Convert an unknown Work rejection into the stable public failure boundary. */
+function toCliProjectionFailure(error) {
+	if (error instanceof CliProjectionCommandError) return {
+		name: error.name,
+		message: error.message,
+		cliEvidence: error.cliEvidence
+	};
+	return error instanceof Error ? {
+		name: error.name,
+		message: error.message,
+		cliEvidence: null
+	} : {
+		name: "Error",
+		message: String(error),
+		cliEvidence: null
+	};
+}
+/** Drop business data and exact errors from one Pull state before Server Push. */
+function toCliProjectionNotice(state) {
+	return {
+		identity: state.identity,
+		workGeneration: state.workGeneration,
+		snapshotGeneration: state.snapshotGeneration,
+		state: state.state,
+		invalidationCause: state.invalidationCause
+	};
+}
+
+//#endregion
+export { CliProjectionInvalidationCauseSchema as a, cliProjectionInvalidationCauses as c, toCliProjectionCommandEvidence as d, toCliProjectionFailure as f, CliProjectionFailureSchema as i, cliProjectionStates as l, CliProjectionCommandError as n, CliProjectionNoticeSchema as o, toCliProjectionNotice as p, CliProjectionCommandEvidenceSchema as r, CliProjectionStateNameSchema as s, CliJsonValueSchema as t, createCliProjectionStateSchema as u };

package/dist/cli-projection.d.mts

@@ -0,0 +1,6 @@
+import "./command-result-fkH3Ekdz.mjs";
+import "./document-translation-D50BnvVh.mjs";
+import "./sounds-qhRgCy0F.mjs";
+import "./notifications-CgJlLgLO.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-DxnVGm2B.mjs";
+export { CliJsonValueSchema, CliProjectionCommandError, CliProjectionCommandEvidence, CliProjectionCommandEvidenceSchema, CliProjectionFailure, CliProjectionFailureSchema, CliProjectionInvalidationCause, CliProjectionInvalidationCauseSchema, CliProjectionNotice, CliProjectionNoticeSchema, CliProjectionState, CliProjectionStateName, CliProjectionStateNameSchema, cliProjectionInvalidationCauses, cliProjectionStates, createCliProjectionStateSchema, toCliProjectionCommandEvidence, toCliProjectionFailure, toCliProjectionNotice };

package/dist/cli-projection.mjs

@@ -0,0 +1,4 @@
+import "./common-D8YUK9dA.mjs";
+import { a as CliProjectionInvalidationCauseSchema, c as cliProjectionInvalidationCauses, d as toCliProjectionCommandEvidence, f as toCliProjectionFailure, i as CliProjectionFailureSchema, l as cliProjectionStates, n as CliProjectionCommandError, o as CliProjectionNoticeSchema, p as toCliProjectionNotice, r as CliProjectionCommandEvidenceSchema, s as CliProjectionStateNameSchema, t as CliJsonValueSchema, u as createCliProjectionStateSchema } from "./cli-projection-vO3-FJg5.mjs";
+
+export { CliJsonValueSchema, CliProjectionCommandError, CliProjectionCommandEvidenceSchema, CliProjectionFailureSchema, CliProjectionInvalidationCauseSchema, CliProjectionNoticeSchema, CliProjectionStateNameSchema, cliProjectionInvalidationCauses, cliProjectionStates, createCliProjectionStateSchema, toCliProjectionCommandEvidence, toCliProjectionFailure, toCliProjectionNotice };