@openspecui/core 4.1.0 → 6.0.0-beta.0

package/dist/hosted-contract-CcRnb51e.mjs

@@ -0,0 +1,234 @@
+import { a as CliRootSchema, n as CliDiagnosticSchema, o as CliRootSourceSchema, r as CliDoctorReferenceEntrySchema } from "./common-D8YUK9dA.mjs";
+import { o as CliProjectionNoticeSchema, u as createCliProjectionStateSchema } from "./cli-projection-vO3-FJg5.mjs";
+import { i as StoreMutationStartResponseSchema } from "./store-mutation-protocol-CSwD-xPO.mjs";
+import { i as StoreListEntrySchema, r as StoreDoctorStoreSchema } from "./store-types-DlX1REBg.mjs";
+import { z } from "zod";
+
+//#region src/hosted-protocol-browser.ts
+/** Mark a backend-issued string as an opaque `EnvUri` without dereferencing or reconstructing it. */
+function asEnvUri(value) {
+	return value;
+}
+/** Whether a backend advertises a compatibility fact. This authorizes nothing. */
+function hasCapability(capabilities, capability) {
+	return Boolean(capabilities?.includes(capability));
+}
+/** Whether a Store mutation status is terminal. */
+function isTerminalMutationStatus(status) {
+	return status === "succeeded" || status === "failed" || status === "indeterminate";
+}
+
+//#endregion
+//#region src/hosted-contract.ts
+/**
+* Orthogonal intents (created 2026-07-25 Asia/Shanghai):
+* 1. Publish the browser-safe runtime schemas for hosted Health, Store, Root Context, and mutation facts.
+* 2. Decode one successful tRPC result envelope into typed data or retained contract-error evidence.
+* 3. Preserve upstream Store and OpenSpec diagnostic facts without inferring health or ownership.
+* 4. Keep this protocol entry free of Node runtime dependencies for hosted browser consumers.
+* 5. Publish Store CLI projection lifecycle Pull schemas and data-free Push notices.
+*
+* Original request (2026-07-24): "可以归档旧change了，然后我们继续新的change 的开发推进"
+* P4.1 contract boundary: malformed successful hosted payloads must not become asserted public facts.
+* Original request (2026-07-26): "这是一套通用的数据拉取推送技术。"
+*/
+const HOSTED_SHELL_PROTOCOL_VERSION = 1;
+const OPENSPECUI_RUNTIME_CAPABILITIES = ["notifications.subscribe", "config.notifications"];
+const HOSTED_STORE_CAPABILITIES = [
+	"stores.inspect",
+	"stores.mutate",
+	"contexts.inspect"
+];
+/** Display-safe summary emitted with a hosted backend health response. */
+const HostedBackendRootSummarySchema = z.object({
+	planningRootPath: z.string().nullable(),
+	rootSource: CliRootSourceSchema,
+	storeId: z.string().nullable(),
+	ready: z.boolean()
+}).passthrough();
+/** Browser-safe runtime contract for one hosted backend health response. */
+const HostedBackendHealthResponseSchema = z.object({
+	status: z.literal("ok"),
+	projectDir: z.string(),
+	projectName: z.string(),
+	watcherEnabled: z.boolean(),
+	openspecuiVersion: z.string(),
+	hostedShellProtocolVersion: z.literal(HOSTED_SHELL_PROTOCOL_VERSION),
+	embeddedUiUrl: z.string(),
+	runtimeCapabilities: z.array(z.enum(OPENSPECUI_RUNTIME_CAPABILITIES)),
+	apiBaseUrl: z.string().optional(),
+	cliVersion: z.string().nullable().optional(),
+	envUri: z.string().optional(),
+	rootSummary: HostedBackendRootSummarySchema.nullable().optional(),
+	hostedCapabilities: z.array(z.enum(HOSTED_STORE_CAPABILITIES)).optional(),
+	accessGateEnabled: z.boolean().optional()
+}).passthrough();
+const HostedStoreFeatureErrorSchema = z.object({
+	kind: z.string(),
+	message: z.string(),
+	cliVersion: z.string().optional()
+}).passthrough();
+/** Browser-safe Store-list projection wrapper returned by the hosted router. */
+const HostedStoreListEnvelopeSchema = z.object({
+	available: z.boolean(),
+	stores: z.array(StoreListEntrySchema),
+	evidence: z.unknown().nullable().optional(),
+	error: HostedStoreFeatureErrorSchema.optional(),
+	cliVersion: z.string().optional()
+}).passthrough();
+/** Browser-safe Store-Doctor projection wrapper returned by the hosted router. */
+const HostedStoreDoctorEnvelopeSchema = z.object({
+	available: z.boolean(),
+	stores: z.array(StoreDoctorStoreSchema),
+	evidence: z.unknown().nullable().optional(),
+	error: HostedStoreFeatureErrorSchema.optional(),
+	cliVersion: z.string().optional()
+}).passthrough();
+/** Browser-safe Pull state for Store Inventory CLI Projection Work. */
+const HostedStoreListProjectionStateSchema = createCliProjectionStateSchema(HostedStoreListEnvelopeSchema);
+/** Browser-safe Pull state for Store Doctor CLI Projection Work. */
+const HostedStoreDoctorProjectionStateSchema = createCliProjectionStateSchema(HostedStoreDoctorEnvelopeSchema);
+/** Browser-safe lifecycle-only Push shared by hosted CLI projections. */
+const HostedCliProjectionNoticeSchema = CliProjectionNoticeSchema;
+const HostedRootContextCliSchema = z.object({
+	available: z.boolean(),
+	version: z.string().optional(),
+	error: z.string().optional(),
+	effectiveCommand: z.string().optional(),
+	tried: z.array(z.string()).optional()
+}).passthrough();
+const HostedRootContextCommandEvidenceSchema = z.object({
+	success: z.boolean(),
+	stdout: z.string(),
+	stderr: z.string(),
+	exitCode: z.number().int().nullable(),
+	diagnostics: z.array(CliDiagnosticSchema),
+	contractError: z.string().optional()
+}).passthrough();
+const HostedPlanningRootSchema = CliRootSchema.extend({
+	healthy: z.boolean(),
+	status: z.array(CliDiagnosticSchema)
+}).passthrough();
+const HostedContextMemberSchema = z.object({
+	role: z.literal("referenced_store"),
+	id: z.string(),
+	path: z.string().optional(),
+	remote: z.string().optional(),
+	fetch: z.string().optional(),
+	status: z.array(CliDiagnosticSchema)
+}).passthrough();
+/** Browser-safe complete Root Context fact retained by the hosted App projection. */
+const HostedRootContextSchema = z.object({
+	launchProject: z.object({ path: z.string() }).passthrough(),
+	planningRoot: HostedPlanningRootSchema.nullable(),
+	storeId: z.string().nullable(),
+	generation: z.string().optional(),
+	cli: HostedRootContextCliSchema,
+	references: z.array(CliDoctorReferenceEntrySchema),
+	contextMembers: z.array(HostedContextMemberSchema),
+	dataScope: z.object({
+		path: z.string(),
+		source: z.enum([
+			"xdg-data-home",
+			"local-app-data",
+			"user-home-default"
+		]),
+		environmentVariable: z.enum(["XDG_DATA_HOME", "LOCALAPPDATA"]).nullable()
+	}).passthrough(),
+	diagnostics: z.object({
+		root: z.array(CliDiagnosticSchema),
+		doctor: z.array(CliDiagnosticSchema),
+		context: z.array(CliDiagnosticSchema)
+	}).passthrough(),
+	evidence: z.object({
+		doctor: HostedRootContextCommandEvidenceSchema.nullable(),
+		context: HostedRootContextCommandEvidenceSchema.nullable()
+	}).passthrough(),
+	observedAt: z.number()
+}).passthrough();
+const HostedRootContextErrorCodeSchema = z.enum([
+	"cli-unavailable",
+	"doctor-command-failed",
+	"doctor-contract-drift",
+	"root-unresolved",
+	"root-unhealthy",
+	"context-command-failed",
+	"context-contract-drift",
+	"context-root-mismatch",
+	"references-unresolved",
+	"resolver-failed"
+]);
+const HostedRootContextLoadingStateSchema = z.object({
+	state: z.literal("loading"),
+	data: z.null(),
+	attempt: z.null(),
+	error: z.null(),
+	observedAt: z.number()
+});
+const HostedRootContextReadyStateSchema = z.object({
+	state: z.literal("ready"),
+	data: HostedRootContextSchema,
+	attempt: z.null(),
+	error: z.null(),
+	observedAt: z.number()
+});
+const HostedRootContextRefreshingStateSchema = z.object({
+	state: z.literal("refreshing"),
+	data: HostedRootContextSchema,
+	attempt: z.null(),
+	error: z.null(),
+	observedAt: z.number()
+});
+const HostedRootContextErrorStateSchema = z.object({
+	state: z.literal("error"),
+	data: HostedRootContextSchema.nullable(),
+	attempt: HostedRootContextSchema,
+	error: z.object({
+		code: HostedRootContextErrorCodeSchema,
+		message: z.string()
+	}),
+	observedAt: z.number()
+});
+/** Browser-safe settled CLI result cached by Root Context Projection Work. */
+const HostedRootContextResolvedStateSchema = z.discriminatedUnion("state", [HostedRootContextReadyStateSchema, HostedRootContextErrorStateSchema]);
+/** Browser-safe Pull lifecycle for cached Root Context CLI Projection Work. */
+const HostedRootContextProjectionStateSchema = createCliProjectionStateSchema(HostedRootContextResolvedStateSchema);
+/** Browser-safe legacy Root Context lifecycle retained for project-workspace adapters. */
+const HostedRootContextStateSchema = z.discriminatedUnion("state", [
+	HostedRootContextLoadingStateSchema,
+	HostedRootContextReadyStateSchema,
+	HostedRootContextRefreshingStateSchema,
+	HostedRootContextErrorStateSchema
+]);
+/** Hosted mutation admission shares the Server-owned P3 lifecycle schema. */
+const HostedStoreMutationStartResponseSchema = StoreMutationStartResponseSchema;
+/** One explicit browser-visible contract error, retaining the decoder's parse cause. */
+var HostedBackendContractError = class extends Error {
+	kind = "contract";
+	constructor(message, options) {
+		super(message, options);
+		this.name = "HostedBackendContractError";
+	}
+};
+/** Structural tRPC envelope used by every successful hosted router ingress. */
+const HostedTrpcResultEnvelopeSchema = z.object({ result: z.object({ data: z.unknown() }).passthrough() }).passthrough();
+/** Decode one successful hosted tRPC `{ result: { data } }` envelope into typed data. */
+function decodeHostedTrpcData(schema, payload) {
+	const envelope = HostedTrpcResultEnvelopeSchema.safeParse(payload);
+	if (!envelope.success) return {
+		kind: "contract-error",
+		error: new HostedBackendContractError("Malformed hosted tRPC result envelope.", { cause: envelope.error })
+	};
+	const decoded = schema.safeParse(envelope.data.result.data);
+	if (!decoded.success) return {
+		kind: "contract-error",
+		error: new HostedBackendContractError("Malformed hosted tRPC result data.", { cause: decoded.error })
+	};
+	return {
+		kind: "success",
+		data: decoded.data
+	};
+}
+
+//#endregion
+export { isTerminalMutationStatus as S, HostedTrpcResultEnvelopeSchema as _, HostedBackendRootSummarySchema as a, asEnvUri as b, HostedRootContextProjectionStateSchema as c, HostedRootContextStateSchema as d, HostedStoreDoctorEnvelopeSchema as f, HostedStoreMutationStartResponseSchema as g, HostedStoreListProjectionStateSchema as h, HostedBackendHealthResponseSchema as i, HostedRootContextResolvedStateSchema as l, HostedStoreListEnvelopeSchema as m, HOSTED_STORE_CAPABILITIES as n, HostedCliProjectionNoticeSchema as o, HostedStoreDoctorProjectionStateSchema as p, HostedBackendContractError as r, HostedRootContextErrorCodeSchema as s, HOSTED_SHELL_PROTOCOL_VERSION as t, HostedRootContextSchema as u, OPENSPECUI_RUNTIME_CAPABILITIES as v, hasCapability as x, decodeHostedTrpcData as y };

package/dist/hosted-contract.d.mts

@@ -0,0 +1,25 @@
+import "./command-result-fkH3Ekdz.mjs";
+import "./document-translation-D50BnvVh.mjs";
+import "./sounds-qhRgCy0F.mjs";
+import "./notifications-CgJlLgLO.mjs";
+import "./cli-projection-DxnVGm2B.mjs";
+import "./schemas-DS-JqAJ2.mjs";
+import "./opsx-types-BJ8AjhrS.mjs";
+import "./opsx-entity-D7kDQsze.mjs";
+import { $ as HostedRootContextResolvedStateSchema, B as HostedBackendHealthResponse, Ct as StoreMutationResult, Dt as isTerminalMutationStatus, Et as hasCapability, G as HostedCliProjectionNotice, H as HostedBackendRootSummary, J as HostedRootContextErrorCode, K as HostedCliProjectionNoticeSchema, L as HOSTED_SHELL_PROTOCOL_VERSION, Q as HostedRootContextResolvedState, R as HOSTED_STORE_CAPABILITIES, St as StoreMutationKind, Tt as asEnvUri, U as HostedBackendRootSummarySchema, V as HostedBackendHealthResponseSchema, W as HostedCliDiagnostic, X as HostedRootContextProjectionState, Y as HostedRootContextErrorCodeSchema, Z as HostedRootContextProjectionStateSchema, _t as decodeHostedTrpcData, at as HostedStoreDoctorEnvelopeSchema, bt as StoreCapabilitySet, ct as HostedStoreListEnvelope, dt as HostedStoreListProjectionStateSchema, et as HostedRootContextSchema, ft as HostedStoreMutationStartResponse, gt as OPENSPECUI_RUNTIME_CAPABILITIES, ht as HostedTrpcResultEnvelopeSchema, it as HostedStoreDoctorEnvelope, lt as HostedStoreListEnvelopeSchema, mt as HostedTrpcDecodeResult, nt as HostedRootContextStateSchema, ot as HostedStoreDoctorProjectionState, pt as HostedStoreMutationStartResponseSchema, q as HostedRootContext, rt as HostedRootSource, st as HostedStoreDoctorProjectionStateSchema, tt as HostedRootContextState, ut as HostedStoreListProjectionState, vt as EnvUri, wt as StoreMutationStatus, xt as StoreMutation, yt as StoreCapability, z as HostedBackendContractError } from "./dashboard-summary-transport-CQ4is5_e.mjs";
+import "./markdown-facts-CCw3QdbM.mjs";
+import "./markdown-reading-LUdqfbxH.mjs";
+import "./openspec-annotations-C58Aoi-V.mjs";
+import "./openspec-projection-RohNZI4p.mjs";
+import "./translator-NKv1wo3o.mjs";
+import "./terminal-audio-tXDm_EDe.mjs";
+import "./local-download-profiles-BL_rtlVM.mjs";
+import "./translation-language-pair-C18GPATW.mjs";
+import "./opsx-workflows-BvnJqjfL.mjs";
+import "./opsx-display-path-RXS5JTbV.mjs";
+import "./store-mutation-protocol-5tfs-RmD.mjs";
+import "./store-types-b554wAQJ.mjs";
+import "./terminal-invocation-BOvxThym.mjs";
+import "./terminal-theme-m3MSGJ7U.mjs";
+import "./opsx-schema-detail-BxDXEwDY.mjs";
+export { EnvUri, HOSTED_SHELL_PROTOCOL_VERSION, HOSTED_STORE_CAPABILITIES, HostedBackendContractError, HostedBackendHealthResponse, HostedBackendHealthResponseSchema, HostedBackendRootSummary, HostedBackendRootSummarySchema, HostedCliDiagnostic, HostedCliProjectionNotice, HostedCliProjectionNoticeSchema, HostedRootContext, HostedRootContextErrorCode, HostedRootContextErrorCodeSchema, HostedRootContextProjectionState, HostedRootContextProjectionStateSchema, HostedRootContextResolvedState, HostedRootContextResolvedStateSchema, HostedRootContextSchema, HostedRootContextState, HostedRootContextStateSchema, HostedRootSource, HostedStoreDoctorEnvelope, HostedStoreDoctorEnvelopeSchema, HostedStoreDoctorProjectionState, HostedStoreDoctorProjectionStateSchema, HostedStoreListEnvelope, HostedStoreListEnvelopeSchema, HostedStoreListProjectionState, HostedStoreListProjectionStateSchema, HostedStoreMutationStartResponse, HostedStoreMutationStartResponseSchema, HostedTrpcDecodeResult, HostedTrpcResultEnvelopeSchema, OPENSPECUI_RUNTIME_CAPABILITIES, StoreCapability, StoreCapabilitySet, StoreMutation, StoreMutationKind, StoreMutationResult, StoreMutationStatus, asEnvUri, decodeHostedTrpcData, hasCapability, isTerminalMutationStatus };

package/dist/hosted-contract.mjs

@@ -0,0 +1,7 @@
+import "./common-D8YUK9dA.mjs";
+import "./cli-projection-vO3-FJg5.mjs";
+import "./store-mutation-protocol-CSwD-xPO.mjs";
+import "./store-types-DlX1REBg.mjs";
+import { S as isTerminalMutationStatus, _ as HostedTrpcResultEnvelopeSchema, a as HostedBackendRootSummarySchema, b as asEnvUri, c as HostedRootContextProjectionStateSchema, d as HostedRootContextStateSchema, f as HostedStoreDoctorEnvelopeSchema, g as HostedStoreMutationStartResponseSchema, h as HostedStoreListProjectionStateSchema, i as HostedBackendHealthResponseSchema, l as HostedRootContextResolvedStateSchema, m as HostedStoreListEnvelopeSchema, n as HOSTED_STORE_CAPABILITIES, o as HostedCliProjectionNoticeSchema, p as HostedStoreDoctorProjectionStateSchema, r as HostedBackendContractError, s as HostedRootContextErrorCodeSchema, t as HOSTED_SHELL_PROTOCOL_VERSION, u as HostedRootContextSchema, v as OPENSPECUI_RUNTIME_CAPABILITIES, x as hasCapability, y as decodeHostedTrpcData } from "./hosted-contract-CcRnb51e.mjs";
+
+export { HOSTED_SHELL_PROTOCOL_VERSION, HOSTED_STORE_CAPABILITIES, HostedBackendContractError, HostedBackendHealthResponseSchema, HostedBackendRootSummarySchema, HostedCliProjectionNoticeSchema, HostedRootContextErrorCodeSchema, HostedRootContextProjectionStateSchema, HostedRootContextResolvedStateSchema, HostedRootContextSchema, HostedRootContextStateSchema, HostedStoreDoctorEnvelopeSchema, HostedStoreDoctorProjectionStateSchema, HostedStoreListEnvelopeSchema, HostedStoreListProjectionStateSchema, HostedStoreMutationStartResponseSchema, HostedTrpcResultEnvelopeSchema, OPENSPECUI_RUNTIME_CAPABILITIES, asEnvUri, decodeHostedTrpcData, hasCapability, isTerminalMutationStatus };