@openspecui/core 3.5.2 → 3.6.0

package/dist/openspec-projection-DWqBxedv.mjs

@@ -0,0 +1,223 @@
+import { c as getMarkdownHeadingFacts, l as trimMarkdownSlice, n as createMarkdownReadingDocument, o as getMarkdownFactSpan, s as getMarkdownHeadingEnd } from "./markdown-reading-CrchEfoW.mjs";
+import { r as builtinOpenSpecReadingPlugin } from "./openspec-annotations-BMy9nWUe.mjs";
+
+//#region src/openspec-projection.ts
+const OPEN_SPEC_SPEC_PROJECTION_ID = "openspec.projection.spec.v2";
+const OPEN_SPEC_READING_SECTIONS_PROJECTION_ID = "openspec.projection.reading-sections.v2";
+function createOpenSpecReadingPlugin(options) {
+	return {
+		...builtinOpenSpecReadingPlugin,
+		id: "openspec.builtin-reading-with-projections.v2",
+		projectionRules: [createOpenSpecReadingSectionsProjectionRule(), createOpenSpecSpecProjectionRule(options)]
+	};
+}
+function parseOpenSpecMarkdownToSpec(specId, content) {
+	return projectOpenSpecMarkdown(content, { specId }).projections[OPEN_SPEC_SPEC_PROJECTION_ID];
+}
+function projectOpenSpecMarkdown(sourceMarkdown, options, plugins = [createOpenSpecReadingPlugin(options)]) {
+	return toProjectedOpenSpecDocument(createMarkdownReadingDocument(sourceMarkdown, plugins));
+}
+function projectAnnotatedOpenSpecToSpec(specId, document) {
+	return projectOpenSpecContextToSpec(createDetachedProjectionContext(document), { specId });
+}
+function getOpenSpecReadingSections(document) {
+	const context = createDetachedProjectionContext(document);
+	return {
+		sections: collectSpecSections(context),
+		requirements: collectRequirementBlocks(context)
+	};
+}
+function getOpenSpecProjectionAnnotation(annotations, factId, kind) {
+	return annotations.find((annotation) => annotation.targetFactId === factId && annotation.kind === kind);
+}
+function createOpenSpecReadingSectionsProjectionRule() {
+	return {
+		id: OPEN_SPEC_READING_SECTIONS_PROJECTION_ID,
+		project(context) {
+			return {
+				sections: collectSpecSections(toOpenSpecProjectionContext(context)),
+				requirements: collectRequirementBlocks(toOpenSpecProjectionContext(context))
+			};
+		}
+	};
+}
+function createOpenSpecSpecProjectionRule(options) {
+	return {
+		id: OPEN_SPEC_SPEC_PROJECTION_ID,
+		project(context) {
+			return projectOpenSpecContextToSpec(toOpenSpecProjectionContext(context), options);
+		}
+	};
+}
+function projectOpenSpecContextToSpec(context, options) {
+	const name = context.annotations.find((annotation) => annotation.kind === "document-title")?.metadata?.title || options.specId;
+	const overviewSection = collectSpecSections(context).find((section) => section.kind === "overview");
+	const overview = overviewSection ? trimMarkdownSlice(context.sourceMarkdown, getContentStartAfterHeading(context, overviewSection.factId, overviewSection.start), overviewSection.end) : "";
+	const requirements = collectRequirementBlocks(context).map((requirement) => projectRequirement(context, requirement));
+	return {
+		id: options.specId,
+		name: name || options.specId,
+		overview: overview.trim(),
+		requirements,
+		metadata: {
+			version: "1.0.0",
+			format: "openspec"
+		}
+	};
+}
+function createRequirementText(title, bodyMarkdown, scenarioText) {
+	return [
+		title,
+		bodyMarkdown,
+		scenarioText
+	].filter((part) => part.trim()).join("\n\n");
+}
+function collectSpecSections(context) {
+	const headings = getMarkdownHeadingFacts(context);
+	return headings.reduce((sections, fact, index) => {
+		if (fact.depth !== 2) return sections;
+		const span = getFactSpan(fact);
+		if (!span) return sections;
+		sections.push({
+			id: fact.id,
+			title: fact.text,
+			kind: getSectionKind(context.annotations, fact.id),
+			factId: fact.id,
+			start: span.start,
+			end: getMarkdownHeadingEnd(headings, index, context.sourceMarkdown.length)
+		});
+		return sections;
+	}, []);
+}
+function collectRequirementBlocks(context) {
+	const headings = getMarkdownHeadingFacts(context);
+	let reqIndex = 0;
+	return headings.reduce((requirements, fact, index) => {
+		const annotation = getOpenSpecProjectionAnnotation(context.annotations, fact.id, "requirement");
+		if (!annotation) return requirements;
+		const span = getFactSpan(fact);
+		if (!span) return requirements;
+		reqIndex++;
+		const end = getMarkdownHeadingEnd(headings, index, context.sourceMarkdown.length);
+		const title = annotation.metadata?.title?.trim() || fact.text;
+		requirements.push({
+			id: `req-${reqIndex}`,
+			title,
+			factId: fact.id,
+			start: span.start,
+			end,
+			scenarios: collectScenarioBlocks(context, headings, fact, end)
+		});
+		return requirements;
+	}, []);
+}
+function collectScenarioBlocks(context, headings, requirementFact, requirementEnd) {
+	const requirementSpan = getFactSpan(requirementFact);
+	if (!requirementSpan) return [];
+	return headings.reduce((scenarios, fact, index) => {
+		const annotation = getOpenSpecProjectionAnnotation(context.annotations, fact.id, "scenario");
+		if (!annotation) return scenarios;
+		const span = getFactSpan(fact);
+		if (!span || span.start <= requirementSpan.start || span.start >= requirementEnd) return scenarios;
+		scenarios.push({
+			title: annotation.metadata?.title?.trim() || fact.text,
+			factId: fact.id,
+			start: span.start,
+			end: Math.min(getScenarioEnd(context, headings, index, requirementEnd), requirementEnd)
+		});
+		return scenarios;
+	}, []);
+}
+function getScenarioEnd(context, headings, scenarioIndex, requirementEnd) {
+	for (let i = scenarioIndex + 1; i < headings.length; i++) {
+		const next = headings[i];
+		const nextSpan = getFactSpan(next);
+		if (!nextSpan || nextSpan.start >= requirementEnd) return requirementEnd;
+		if ((next.depth ?? 6) <= 3 || getOpenSpecProjectionAnnotation(context.annotations, next.id, "scenario")) return nextSpan.start;
+	}
+	return requirementEnd;
+}
+function getContentStartAfterHeading(context, factId, fallback) {
+	const fact = context.factById.get(factId);
+	return fact ? getFactSpan(fact)?.end ?? fallback : fallback;
+}
+function projectScenario(context, scenario) {
+	const bodyMarkdown = trimMarkdownSlice(context.sourceMarkdown, getContentStartAfterHeading(context, scenario.factId, scenario.start), scenario.end);
+	const rawText = [scenario.title, bodyMarkdown].filter((part) => part.trim()).join("\n");
+	return {
+		title: scenario.title,
+		bodyMarkdown,
+		rawText,
+		steps: getScenarioStepsFromAnnotations(context, scenario)
+	};
+}
+function getScenarioStepsFromAnnotations(context, scenario) {
+	return context.annotations.reduce((steps, annotation) => {
+		if (annotation.kind !== "scenario-step") return steps;
+		const fact = context.factById.get(annotation.targetFactId);
+		const span = fact ? getFactSpan(fact) : void 0;
+		if (!span || span.start <= scenario.start || span.start >= scenario.end) return steps;
+		const keyword = annotation.metadata?.keyword;
+		const contentMarkdown = annotation.metadata?.contentMarkdown;
+		const rawText = annotation.metadata?.rawMarkdown;
+		if (!isScenarioStepKeyword(keyword) || !contentMarkdown || !rawText) return steps;
+		steps.push({
+			keyword,
+			contentMarkdown,
+			rawText
+		});
+		return steps;
+	}, []);
+}
+function isScenarioStepKeyword(value) {
+	return value === "GIVEN" || value === "WHEN" || value === "THEN" || value === "AND" || value === "BUT";
+}
+function projectRequirement(context, requirement) {
+	const bodyEnd = requirement.scenarios.map((scenario) => scenario.start).sort((left, right) => left - right)[0] ?? requirement.end;
+	const bodyMarkdown = trimMarkdownSlice(context.sourceMarkdown, getContentStartAfterHeading(context, requirement.factId, requirement.start), bodyEnd);
+	const scenarios = requirement.scenarios.map((scenario) => projectScenario(context, scenario));
+	const scenarioText = scenarios.map((scenario) => scenario.rawText).join("\n\n");
+	return {
+		id: requirement.id,
+		title: requirement.title,
+		bodyMarkdown,
+		text: createRequirementText(requirement.title, bodyMarkdown, scenarioText),
+		scenarios
+	};
+}
+function getFactSpan(fact) {
+	return getMarkdownFactSpan(fact);
+}
+function getSectionKind(annotations, factId) {
+	if (getOpenSpecProjectionAnnotation(annotations, factId, "purpose-section")) return "overview";
+	if (getOpenSpecProjectionAnnotation(annotations, factId, "requirements-section")) return "requirements";
+	return "other";
+}
+function createDetachedProjectionContext(document) {
+	return {
+		sourceMarkdown: document.sourceMarkdown,
+		facts: document.facts,
+		factById: new Map(document.facts.map((fact) => [fact.id, fact])),
+		annotations: document.annotations.filter(isOpenSpecAnnotation)
+	};
+}
+function toOpenSpecProjectionContext(context) {
+	return {
+		sourceMarkdown: context.sourceMarkdown,
+		facts: context.facts,
+		factById: context.factById,
+		annotations: context.annotations.filter(isOpenSpecAnnotation)
+	};
+}
+function toProjectedOpenSpecDocument(document) {
+	return {
+		...document,
+		annotations: document.annotations.filter(isOpenSpecAnnotation)
+	};
+}
+function isOpenSpecAnnotation(annotation) {
+	return annotation.kind === "document-title" || annotation.kind === "purpose-section" || annotation.kind === "requirements-section" || annotation.kind === "requirement" || annotation.kind === "scenario" || annotation.kind === "scenario-step" || annotation.kind === "keyword";
+}
+
+//#endregion
+export { getOpenSpecReadingSections as a, projectOpenSpecMarkdown as c, getOpenSpecProjectionAnnotation as i, OPEN_SPEC_SPEC_PROJECTION_ID as n, parseOpenSpecMarkdownToSpec as o, createOpenSpecReadingPlugin as r, projectAnnotatedOpenSpecToSpec as s, OPEN_SPEC_READING_SECTIONS_PROJECTION_ID as t };

package/dist/openspec-projection.d.mts

@@ -0,0 +1,5 @@
+import { a as OpenSpecReadingSectionsProjection, c as ProjectedOpenSpecDocument, d as getOpenSpecReadingSections, f as parseOpenSpecMarkdownToSpec, i as OpenSpecProjectionOptions, l as createOpenSpecReadingPlugin, m as projectOpenSpecMarkdown, n as OPEN_SPEC_SPEC_PROJECTION_ID, o as OpenSpecRequirementBlock, p as projectAnnotatedOpenSpecToSpec, r as OpenSpecHeadingSection, s as OpenSpecScenarioBlock, t as OPEN_SPEC_READING_SECTIONS_PROJECTION_ID, u as getOpenSpecProjectionAnnotation } from "./openspec-projection-DTuKPTgf.mjs";
+import "./markdown-facts-f3kXnqXb.mjs";
+import "./markdown-reading-D36W693c.mjs";
+import "./openspec-annotations-CJmYcfAu.mjs";
+export { OPEN_SPEC_READING_SECTIONS_PROJECTION_ID, OPEN_SPEC_SPEC_PROJECTION_ID, OpenSpecHeadingSection, OpenSpecProjectionOptions, OpenSpecReadingSectionsProjection, OpenSpecRequirementBlock, OpenSpecScenarioBlock, ProjectedOpenSpecDocument, createOpenSpecReadingPlugin, getOpenSpecProjectionAnnotation, getOpenSpecReadingSections, parseOpenSpecMarkdownToSpec, projectAnnotatedOpenSpecToSpec, projectOpenSpecMarkdown };

package/dist/openspec-projection.mjs

@@ -0,0 +1,6 @@
+import "./markdown-facts-BmSmZmpB.mjs";
+import "./markdown-reading-CrchEfoW.mjs";
+import "./openspec-annotations-BMy9nWUe.mjs";
+import { a as getOpenSpecReadingSections, c as projectOpenSpecMarkdown, i as getOpenSpecProjectionAnnotation, n as OPEN_SPEC_SPEC_PROJECTION_ID, o as parseOpenSpecMarkdownToSpec, r as createOpenSpecReadingPlugin, s as projectAnnotatedOpenSpecToSpec, t as OPEN_SPEC_READING_SECTIONS_PROJECTION_ID } from "./openspec-projection-DWqBxedv.mjs";
+
+export { OPEN_SPEC_READING_SECTIONS_PROJECTION_ID, OPEN_SPEC_SPEC_PROJECTION_ID, createOpenSpecReadingPlugin, getOpenSpecProjectionAnnotation, getOpenSpecReadingSections, parseOpenSpecMarkdownToSpec, projectAnnotatedOpenSpecToSpec, projectOpenSpecMarkdown };

package/dist/opsx-display-path.d.mts

@@ -1,2 +1,2 @@
-import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-CuQyGB_A.mjs";
+import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-CkV9sq_j.mjs";
 export { VIRTUAL_PROJECT_DIRNAME, toOpsxDisplayPath };

package/dist/opsx-display-path.mjs

@@ -1,3 +1,3 @@
-import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-B6Owu17P.mjs";
+import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-D4KLYRXQ.mjs";
 
 export { VIRTUAL_PROJECT_DIRNAME, toOpsxDisplayPath };

package/dist/sounds.d.mts

@@ -1,2 +1,2 @@
-import { C as SoundVolume, D as normalizeLegacySoundId, E as getBuiltinSoundUrl, O as soundIdFromCustomHash, S as SoundIdSchema, T as customHashFromSoundId, _ as DEFAULT_SOUND_VOLUME, a as BuiltinSoundOption, b as SoundConfigIdSchema, c as CustomSoundHashSchema, d as CustomSoundMetadata, f as CustomSoundMetadataFile, g as DEFAULT_NOTIFICATION_SOUND_ID, h as DEFAULT_BELL_SOUND_ID, i as BuiltinSoundIdSchema, l as CustomSoundId, m as CustomSoundMetadataSchema, n as BUILTIN_SOUND_OPTIONS, o as CUSTOM_SOUND_ADD_VALUE, p as CustomSoundMetadataFileSchema, r as BuiltinSoundId, s as CustomSoundHash, t as BUILTIN_SOUND_IDS, u as CustomSoundIdSchema, v as LEGACY_SOUND_ID_MAP, w as SoundVolumeSchema, x as SoundId, y as SILENT_SOUND_ID } from "./sounds-Bw-sSyFZ.mjs";
+import { C as SoundVolume, D as normalizeLegacySoundId, E as getBuiltinSoundUrl, O as soundIdFromCustomHash, S as SoundIdSchema, T as customHashFromSoundId, _ as DEFAULT_SOUND_VOLUME, a as BuiltinSoundOption, b as SoundConfigIdSchema, c as CustomSoundHashSchema, d as CustomSoundMetadata, f as CustomSoundMetadataFile, g as DEFAULT_NOTIFICATION_SOUND_ID, h as DEFAULT_BELL_SOUND_ID, i as BuiltinSoundIdSchema, l as CustomSoundId, m as CustomSoundMetadataSchema, n as BUILTIN_SOUND_OPTIONS, o as CUSTOM_SOUND_ADD_VALUE, p as CustomSoundMetadataFileSchema, r as BuiltinSoundId, s as CustomSoundHash, t as BUILTIN_SOUND_IDS, u as CustomSoundIdSchema, v as LEGACY_SOUND_ID_MAP, w as SoundVolumeSchema, x as SoundId, y as SILENT_SOUND_ID } from "./sounds-CYxOpEdm.mjs";
 export { BUILTIN_SOUND_IDS, BUILTIN_SOUND_OPTIONS, BuiltinSoundId, BuiltinSoundIdSchema, BuiltinSoundOption, CUSTOM_SOUND_ADD_VALUE, CustomSoundHash, CustomSoundHashSchema, CustomSoundId, CustomSoundIdSchema, CustomSoundMetadata, CustomSoundMetadataFile, CustomSoundMetadataFileSchema, CustomSoundMetadataSchema, DEFAULT_BELL_SOUND_ID, DEFAULT_NOTIFICATION_SOUND_ID, DEFAULT_SOUND_VOLUME, LEGACY_SOUND_ID_MAP, SILENT_SOUND_ID, SoundConfigIdSchema, SoundId, SoundIdSchema, SoundVolume, SoundVolumeSchema, customHashFromSoundId, getBuiltinSoundUrl, normalizeLegacySoundId, soundIdFromCustomHash };

package/dist/sounds.mjs

@@ -1,3 +1,3 @@
-import { _ as customHashFromSoundId, a as CustomSoundHashSchema, b as soundIdFromCustomHash, c as CustomSoundMetadataSchema, d as DEFAULT_SOUND_VOLUME, f as LEGACY_SOUND_ID_MAP, g as SoundVolumeSchema, h as SoundIdSchema, i as CUSTOM_SOUND_ADD_VALUE, l as DEFAULT_BELL_SOUND_ID, m as SoundConfigIdSchema, n as BUILTIN_SOUND_OPTIONS, o as CustomSoundIdSchema, p as SILENT_SOUND_ID, r as BuiltinSoundIdSchema, s as CustomSoundMetadataFileSchema, t as BUILTIN_SOUND_IDS, u as DEFAULT_NOTIFICATION_SOUND_ID, v as getBuiltinSoundUrl, y as normalizeLegacySoundId } from "./sounds-C0dNSFm8.mjs";
+import { _ as customHashFromSoundId, a as CustomSoundHashSchema, b as soundIdFromCustomHash, c as CustomSoundMetadataSchema, d as DEFAULT_SOUND_VOLUME, f as LEGACY_SOUND_ID_MAP, g as SoundVolumeSchema, h as SoundIdSchema, i as CUSTOM_SOUND_ADD_VALUE, l as DEFAULT_BELL_SOUND_ID, m as SoundConfigIdSchema, n as BUILTIN_SOUND_OPTIONS, o as CustomSoundIdSchema, p as SILENT_SOUND_ID, r as BuiltinSoundIdSchema, s as CustomSoundMetadataFileSchema, t as BUILTIN_SOUND_IDS, u as DEFAULT_NOTIFICATION_SOUND_ID, v as getBuiltinSoundUrl, y as normalizeLegacySoundId } from "./sounds-BzNKMW05.mjs";
 
 export { BUILTIN_SOUND_IDS, BUILTIN_SOUND_OPTIONS, BuiltinSoundIdSchema, CUSTOM_SOUND_ADD_VALUE, CustomSoundHashSchema, CustomSoundIdSchema, CustomSoundMetadataFileSchema, CustomSoundMetadataSchema, DEFAULT_BELL_SOUND_ID, DEFAULT_NOTIFICATION_SOUND_ID, DEFAULT_SOUND_VOLUME, LEGACY_SOUND_ID_MAP, SILENT_SOUND_ID, SoundConfigIdSchema, SoundIdSchema, SoundVolumeSchema, customHashFromSoundId, getBuiltinSoundUrl, normalizeLegacySoundId, soundIdFromCustomHash };

package/dist/{terminal-audio-8E82E0AM.d.mts → terminal-audio-U9Exv9A5.d.mts}

@@ -1,4 +1,4 @@
-import { x as SoundId } from "./sounds-Bw-sSyFZ.mjs";
+import { x as SoundId } from "./sounds-CYxOpEdm.mjs";
 import * as zod0 from "zod";
 
 //#region src/terminal-audio.d.ts

package/dist/{terminal-audio-DDwxz9sJ.mjs → terminal-audio-UEv3j655.mjs}

@@ -1,4 +1,4 @@
-import { l as DEFAULT_BELL_SOUND_ID, m as SoundConfigIdSchema } from "./sounds-C0dNSFm8.mjs";
+import { l as DEFAULT_BELL_SOUND_ID, m as SoundConfigIdSchema } from "./sounds-BzNKMW05.mjs";
 
 //#region src/terminal-audio.ts
 const TERMINAL_BELL_SOUND_VALUES = [

package/dist/terminal-audio.d.mts

@@ -1,3 +1,3 @@
-import "./sounds-Bw-sSyFZ.mjs";
-import { i as TerminalBellSoundSchema, n as TERMINAL_BELL_SOUND_VALUES, r as TerminalBellSound, t as TERMINAL_BELL_SOUND_OPTIONS } from "./terminal-audio-8E82E0AM.mjs";
+import "./sounds-CYxOpEdm.mjs";
+import { i as TerminalBellSoundSchema, n as TERMINAL_BELL_SOUND_VALUES, r as TerminalBellSound, t as TERMINAL_BELL_SOUND_OPTIONS } from "./terminal-audio-U9Exv9A5.mjs";
 export { TERMINAL_BELL_SOUND_OPTIONS, TERMINAL_BELL_SOUND_VALUES, TerminalBellSound, TerminalBellSoundSchema };

package/dist/terminal-audio.mjs

@@ -1,4 +1,4 @@
-import "./sounds-C0dNSFm8.mjs";
-import { n as TERMINAL_BELL_SOUND_VALUES, r as TerminalBellSoundSchema, t as TERMINAL_BELL_SOUND_OPTIONS } from "./terminal-audio-DDwxz9sJ.mjs";
+import "./sounds-BzNKMW05.mjs";
+import { n as TERMINAL_BELL_SOUND_VALUES, r as TerminalBellSoundSchema, t as TERMINAL_BELL_SOUND_OPTIONS } from "./terminal-audio-UEv3j655.mjs";
 
 export { TERMINAL_BELL_SOUND_OPTIONS, TERMINAL_BELL_SOUND_VALUES, TerminalBellSoundSchema };

package/dist/terminal-control.d.mts

@@ -1,3 +1,3 @@
-import "./sounds-Bw-sSyFZ.mjs";
-import { A as TerminalNotificationProtocol, D as TerminalControlEvent, M as TerminalPromptState, N as TerminalTitleTarget, O as TerminalControlParseResult, P as terminalNotificationEventToPublishInput, j as TerminalProgressState, k as TerminalControlParser } from "./notifications-BWvRNkRJ.mjs";
+import "./sounds-CYxOpEdm.mjs";
+import { A as TerminalNotificationProtocol, D as TerminalControlEvent, M as TerminalPromptState, N as TerminalTitleTarget, O as TerminalControlParseResult, P as terminalNotificationEventToPublishInput, j as TerminalProgressState, k as TerminalControlParser } from "./notifications-C4amULI4.mjs";
 export { TerminalControlEvent, TerminalControlParseResult, TerminalControlParser, TerminalNotificationProtocol, TerminalProgressState, TerminalPromptState, TerminalTitleTarget, terminalNotificationEventToPublishInput };

package/dist/terminal-control.mjs

@@ -1,3 +1,3 @@
-import { n as terminalNotificationEventToPublishInput, t as TerminalControlParser } from "./terminal-control-DtBprY6-.mjs";
+import { n as terminalNotificationEventToPublishInput, t as TerminalControlParser } from "./terminal-control-Bxois59k.mjs";
 
 export { TerminalControlParser, terminalNotificationEventToPublishInput };

package/dist/{terminal-invocation-CpdllJff.d.mts → terminal-invocation-BmwWgwgY.d.mts}

@@ -645,10 +645,10 @@ declare const TerminalCommandFieldSchema: z.ZodObject<{
   label: string;
   id: string;
   options?: string[] | undefined;
-  required?: boolean | undefined;
   description?: string | undefined;
   placeholder?: string | undefined;
   defaultValue?: string | boolean | undefined;
+  required?: boolean | undefined;
   advanced?: boolean | undefined;
 }>;
 type TerminalCommandField = z.infer<typeof TerminalCommandFieldSchema>;
@@ -1012,10 +1012,10 @@ declare const TerminalSpawnCommandSchema: z.ZodObject<{
     label: string;
     id: string;
     options?: string[] | undefined;
-    required?: boolean | undefined;
     description?: string | undefined;
     placeholder?: string | undefined;
     defaultValue?: string | boolean | undefined;
+    required?: boolean | undefined;
     advanced?: boolean | undefined;
   }>, "many">>;
   parameters: z.ZodOptional<z.ZodObject<{
@@ -1259,10 +1259,10 @@ declare const TerminalSpawnCommandSchema: z.ZodObject<{
     label: string;
     id: string;
     options?: string[] | undefined;
-    required?: boolean | undefined;
     description?: string | undefined;
     placeholder?: string | undefined;
     defaultValue?: string | boolean | undefined;
+    required?: boolean | undefined;
     advanced?: boolean | undefined;
   }[] | undefined;
   parameters?: {
@@ -1392,10 +1392,10 @@ declare const TerminalInvocationSettingsSchema: z.ZodObject<{
       label: string;
       id: string;
       options?: string[] | undefined;
-      required?: boolean | undefined;
       description?: string | undefined;
       placeholder?: string | undefined;
       defaultValue?: string | boolean | undefined;
+      required?: boolean | undefined;
       advanced?: boolean | undefined;
     }>, "many">>;
     parameters: z.ZodOptional<z.ZodObject<{
@@ -1639,10 +1639,10 @@ declare const TerminalInvocationSettingsSchema: z.ZodObject<{
       label: string;
       id: string;
       options?: string[] | undefined;
-      required?: boolean | undefined;
       description?: string | undefined;
       placeholder?: string | undefined;
       defaultValue?: string | boolean | undefined;
+      required?: boolean | undefined;
       advanced?: boolean | undefined;
     }[] | undefined;
     parameters?: {
@@ -1789,10 +1789,10 @@ declare const TerminalInvocationSettingsSchema: z.ZodObject<{
       label: string;
       id: string;
       options?: string[] | undefined;
-      required?: boolean | undefined;
       description?: string | undefined;
       placeholder?: string | undefined;
       defaultValue?: string | boolean | undefined;
+      required?: boolean | undefined;
       advanced?: boolean | undefined;
     }[] | undefined;
     parameters?: {

package/dist/terminal-invocation.d.mts

@@ -1,2 +1,2 @@
-import { A as renderTerminalSpawnCommand, C as TerminalSpawnCommand, D as getTerminalCommandParameters, E as getTerminalCommandDefaultValues, M as resolveTerminalShellDefaults, O as quoteTerminalShellArg, S as TerminalShellQuoteStyleSchema, T as fieldsToTerminalCommandParameters, _ as TerminalShellDefaults, a as TerminalCommandBuilder, b as TerminalShellProfileSchema, c as TerminalCommandFieldSchema, d as TerminalCommandJsonSchema, f as TerminalCommandJsonSchemaProperty, g as TerminalInvocationSettingsSchema, h as TerminalInvocationSettings, i as TerminalCommandArgument, j as renderTerminalSpawnCommandLine, k as renderTerminalCommandArgs, l as TerminalCommandFieldValue, m as TerminalCommandRenderResult, n as TERMINAL_COMMAND_FIELD_TYPE_VALUES, o as TerminalCommandBuilderPart, p as TerminalCommandParameters, r as TERMINAL_SHELL_QUOTE_STYLE_VALUES, s as TerminalCommandField, t as BUILTIN_TERMINAL_SPAWN_COMMANDS, u as TerminalCommandFieldValues, v as TerminalShellEnv, w as TerminalSpawnCommandSchema, x as TerminalShellQuoteStyle, y as TerminalShellProfile } from "./terminal-invocation-CpdllJff.mjs";
+import { A as renderTerminalSpawnCommand, C as TerminalSpawnCommand, D as getTerminalCommandParameters, E as getTerminalCommandDefaultValues, M as resolveTerminalShellDefaults, O as quoteTerminalShellArg, S as TerminalShellQuoteStyleSchema, T as fieldsToTerminalCommandParameters, _ as TerminalShellDefaults, a as TerminalCommandBuilder, b as TerminalShellProfileSchema, c as TerminalCommandFieldSchema, d as TerminalCommandJsonSchema, f as TerminalCommandJsonSchemaProperty, g as TerminalInvocationSettingsSchema, h as TerminalInvocationSettings, i as TerminalCommandArgument, j as renderTerminalSpawnCommandLine, k as renderTerminalCommandArgs, l as TerminalCommandFieldValue, m as TerminalCommandRenderResult, n as TERMINAL_COMMAND_FIELD_TYPE_VALUES, o as TerminalCommandBuilderPart, p as TerminalCommandParameters, r as TERMINAL_SHELL_QUOTE_STYLE_VALUES, s as TerminalCommandField, t as BUILTIN_TERMINAL_SPAWN_COMMANDS, u as TerminalCommandFieldValues, v as TerminalShellEnv, w as TerminalSpawnCommandSchema, x as TerminalShellQuoteStyle, y as TerminalShellProfile } from "./terminal-invocation-BmwWgwgY.mjs";
 export { BUILTIN_TERMINAL_SPAWN_COMMANDS, TERMINAL_COMMAND_FIELD_TYPE_VALUES, TERMINAL_SHELL_QUOTE_STYLE_VALUES, TerminalCommandArgument, TerminalCommandBuilder, TerminalCommandBuilderPart, TerminalCommandField, TerminalCommandFieldSchema, TerminalCommandFieldValue, TerminalCommandFieldValues, TerminalCommandJsonSchema, TerminalCommandJsonSchemaProperty, TerminalCommandParameters, TerminalCommandRenderResult, TerminalInvocationSettings, TerminalInvocationSettingsSchema, TerminalShellDefaults, TerminalShellEnv, TerminalShellProfile, TerminalShellProfileSchema, TerminalShellQuoteStyle, TerminalShellQuoteStyleSchema, TerminalSpawnCommand, TerminalSpawnCommandSchema, fieldsToTerminalCommandParameters, getTerminalCommandDefaultValues, getTerminalCommandParameters, quoteTerminalShellArg, renderTerminalCommandArgs, renderTerminalSpawnCommand, renderTerminalSpawnCommandLine, resolveTerminalShellDefaults };

package/dist/terminal-invocation.mjs

@@ -1,3 +1,3 @@
-import { a as TerminalInvocationSettingsSchema, c as TerminalSpawnCommandSchema, d as getTerminalCommandParameters, f as quoteTerminalShellArg, g as resolveTerminalShellDefaults, h as renderTerminalSpawnCommandLine, i as TerminalCommandFieldSchema, l as fieldsToTerminalCommandParameters, m as renderTerminalSpawnCommand, n as TERMINAL_COMMAND_FIELD_TYPE_VALUES, o as TerminalShellProfileSchema, p as renderTerminalCommandArgs, r as TERMINAL_SHELL_QUOTE_STYLE_VALUES, s as TerminalShellQuoteStyleSchema, t as BUILTIN_TERMINAL_SPAWN_COMMANDS, u as getTerminalCommandDefaultValues } from "./terminal-invocation-Cdi6_Kl6.mjs";
+import { a as TerminalInvocationSettingsSchema, c as TerminalSpawnCommandSchema, d as getTerminalCommandParameters, f as quoteTerminalShellArg, g as resolveTerminalShellDefaults, h as renderTerminalSpawnCommandLine, i as TerminalCommandFieldSchema, l as fieldsToTerminalCommandParameters, m as renderTerminalSpawnCommand, n as TERMINAL_COMMAND_FIELD_TYPE_VALUES, o as TerminalShellProfileSchema, p as renderTerminalCommandArgs, r as TERMINAL_SHELL_QUOTE_STYLE_VALUES, s as TerminalShellQuoteStyleSchema, t as BUILTIN_TERMINAL_SPAWN_COMMANDS, u as getTerminalCommandDefaultValues } from "./terminal-invocation-BRCuSBjE.mjs";
 
 export { BUILTIN_TERMINAL_SPAWN_COMMANDS, TERMINAL_COMMAND_FIELD_TYPE_VALUES, TERMINAL_SHELL_QUOTE_STYLE_VALUES, TerminalCommandFieldSchema, TerminalInvocationSettingsSchema, TerminalShellProfileSchema, TerminalShellQuoteStyleSchema, TerminalSpawnCommandSchema, fieldsToTerminalCommandParameters, getTerminalCommandDefaultValues, getTerminalCommandParameters, quoteTerminalShellArg, renderTerminalCommandArgs, renderTerminalSpawnCommand, renderTerminalSpawnCommandLine, resolveTerminalShellDefaults };

package/dist/terminal-theme.d.mts

@@ -1,2 +1,2 @@
-import { a as TERMINAL_THEME_VALUES, i as TERMINAL_THEME_MODE_VALUES, n as DEFAULT_TERMINAL_LIGHT_THEME, o as TerminalThemeId, r as DEFAULT_TERMINAL_THEME_MODE, s as TerminalThemeMode, t as DEFAULT_TERMINAL_DARK_THEME } from "./terminal-theme-wbkK9vVH.mjs";
+import { a as TERMINAL_THEME_VALUES, i as TERMINAL_THEME_MODE_VALUES, n as DEFAULT_TERMINAL_LIGHT_THEME, o as TerminalThemeId, r as DEFAULT_TERMINAL_THEME_MODE, s as TerminalThemeMode, t as DEFAULT_TERMINAL_DARK_THEME } from "./terminal-theme-lPZGfVA_.mjs";
 export { DEFAULT_TERMINAL_DARK_THEME, DEFAULT_TERMINAL_LIGHT_THEME, DEFAULT_TERMINAL_THEME_MODE, TERMINAL_THEME_MODE_VALUES, TERMINAL_THEME_VALUES, TerminalThemeId, TerminalThemeMode };

package/dist/terminal-theme.mjs

@@ -1,3 +1,3 @@
-import { a as TERMINAL_THEME_VALUES, i as TERMINAL_THEME_MODE_VALUES, n as DEFAULT_TERMINAL_LIGHT_THEME, r as DEFAULT_TERMINAL_THEME_MODE, t as DEFAULT_TERMINAL_DARK_THEME } from "./terminal-theme-CMQqJvIQ.mjs";
+import { a as TERMINAL_THEME_VALUES, i as TERMINAL_THEME_MODE_VALUES, n as DEFAULT_TERMINAL_LIGHT_THEME, r as DEFAULT_TERMINAL_THEME_MODE, t as DEFAULT_TERMINAL_DARK_THEME } from "./terminal-theme-CIv3YMfi.mjs";
 
 export { DEFAULT_TERMINAL_DARK_THEME, DEFAULT_TERMINAL_LIGHT_THEME, DEFAULT_TERMINAL_THEME_MODE, TERMINAL_THEME_MODE_VALUES, TERMINAL_THEME_VALUES };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openspecui/core",
-  "version": "3.5.2",
+  "version": "3.6.0",
   "description": "Core OpenSpec adapter and parser",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -22,6 +22,22 @@
       "import": "./dist/openspec-compat.mjs",
       "types": "./dist/openspec-compat.d.mts"
     },
+    "./markdown-facts": {
+      "import": "./dist/markdown-facts.mjs",
+      "types": "./dist/markdown-facts.d.mts"
+    },
+    "./markdown-reading": {
+      "import": "./dist/markdown-reading.mjs",
+      "types": "./dist/markdown-reading.d.mts"
+    },
+    "./openspec-annotations": {
+      "import": "./dist/openspec-annotations.mjs",
+      "types": "./dist/openspec-annotations.d.mts"
+    },
+    "./openspec-projection": {
+      "import": "./dist/openspec-projection.mjs",
+      "types": "./dist/openspec-projection.d.mts"
+    },
     "./opsx-display-path": {
       "import": "./dist/opsx-display-path.mjs",
       "types": "./dist/opsx-display-path.d.mts"
@@ -55,18 +71,24 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsdown src/index.ts src/dashboard-display.ts src/opsx-display-path.ts src/hosted-app.ts src/openspec-compat.ts src/notifications.ts src/sounds.ts src/terminal-theme.ts src/terminal-invocation.ts src/terminal-audio.ts src/terminal-control.ts --format esm --dts",
-    "dev": "tsdown src/index.ts src/dashboard-display.ts src/opsx-display-path.ts src/hosted-app.ts src/openspec-compat.ts src/notifications.ts src/sounds.ts src/terminal-theme.ts src/terminal-invocation.ts src/terminal-audio.ts src/terminal-control.ts --format esm --dts --watch",
+    "build": "tsdown src/index.ts src/dashboard-display.ts src/opsx-display-path.ts src/hosted-app.ts src/openspec-compat.ts src/markdown-facts.ts src/markdown-reading.ts src/openspec-annotations.ts src/openspec-projection.ts src/notifications.ts src/sounds.ts src/terminal-theme.ts src/terminal-invocation.ts src/terminal-audio.ts src/terminal-control.ts --format esm --dts",
+    "dev": "tsdown src/index.ts src/dashboard-display.ts src/opsx-display-path.ts src/hosted-app.ts src/openspec-compat.ts src/markdown-facts.ts src/markdown-reading.ts src/openspec-annotations.ts src/openspec-projection.ts src/notifications.ts src/sounds.ts src/terminal-theme.ts src/terminal-invocation.ts src/terminal-audio.ts src/terminal-control.ts --format esm --dts --watch",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "@parcel/watcher": "^2.5.1",
+    "mdast-util-from-markdown": "^2.0.2",
+    "mdast-util-gfm": "^3.1.0",
+    "mdast-util-to-string": "^4.0.0",
+    "micromark-extension-gfm": "^3.0.0",
     "yaml": "^2.8.2",
     "zod": "^3.24.1"
   },
   "devDependencies": {
+    "@types/mdast": "^4.0.4",
+    "@types/unist": "^3.0.3",
     "@vitest/coverage-v8": "^4.1.0",
     "tsdown": "^0.16.6",
     "typescript": "^5.7.2",