@agimon-ai/po-config 0.0.0-alpha.0

package/dist/sessionConfig-CtLoc-lO.mjs

@@ -0,0 +1,240 @@
+import { a as loadDoomConfigAsync, i as loadDoomConfig } from "./config-CKA07FxG.mjs";
+import { a as getSessionHarnessState, i as getHarnessState } from "./harnessStore-CltwLB7M.mjs";
+import { t as DOOM_CONFIG_SERVICE } from "./config-NSHRd6na.mjs";
+import { Service } from "@deepseek-ai/cordis";
+//#region src/services/doomConfigService/index.ts
+function deepFreeze$1(value) {
+	if (typeof value !== "object" || value === null || Object.isFrozen(value)) return value;
+	for (const child of Object.values(value)) deepFreeze$1(child);
+	return Object.freeze(value);
+}
+/**
+* Doom configuration published on the shared cordis Context.
+*
+* Every extension resolves the same instance by name, so configuration stays
+* one read per session instead of one per consumer, and the registration is
+* removed with the fiber that created it. The loader is injected so this stays
+* free of filesystem access.
+*/
+var DoomConfigService = class extends Service {
+	loadConfig;
+	generation;
+	snapshot;
+	constructor(ctx, snapshot, loadConfig, generation = `doom-config:${crypto.randomUUID()}`) {
+		super(ctx, DOOM_CONFIG_SERVICE);
+		this.loadConfig = loadConfig;
+		this.snapshot = deepFreeze$1(snapshot);
+		this.generation = generation;
+	}
+	getSnapshot() {
+		return this.snapshot;
+	}
+	replaceSnapshot(context) {
+		this.snapshot = deepFreeze$1(context);
+		return this.snapshot;
+	}
+	load(repoRoot, homeDirectory) {
+		return this.loadConfig(repoRoot, homeDirectory);
+	}
+};
+//#endregion
+//#region src/services/sessionConfig/index.ts
+const DOOM_CONFIG_ENTRY_TYPE = "po:config:v1";
+const DOOM_CONFIG_TRANSITION_ENTRY_TYPE = "po:transition:v1";
+function isSelection(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const selection = value;
+	return selection.version === 1 && typeof selection.majorMode === "string" && Array.isArray(selection.domains) && selection.domains.every((domain) => typeof domain === "string") && (selection.profile === void 0 || typeof selection.profile === "string") && (selection.compositionFingerprint === void 0 || typeof selection.compositionFingerprint === "string");
+}
+function branchSelection(entries) {
+	for (let index = entries.length - 1; index >= 0; index -= 1) {
+		const entry = entries[index];
+		if (entry?.type === "custom" && entry.customType === "po:config:v1" && isSelection(entry.data)) return entry.data;
+	}
+}
+function isTransitionStrategy(value) {
+	return value === "pi-reload" || value === "process-relaunch";
+}
+function isTransition(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const transition = value;
+	return transition.version === 1 && typeof transition.operationId === "string" && isSelection(transition.active) && isSelection(transition.target) && isTransitionStrategy(transition.strategy) && (transition.phase === "pending" || transition.phase === "applied" || transition.phase === "aborted" || transition.phase === "superseded");
+}
+function branchTransition(entries) {
+	for (let index = entries.length - 1; index >= 0; index -= 1) {
+		const entry = entries[index];
+		if (entry?.type === "custom" && entry.customType === "po:transition:v1" && isTransition(entry.data)) return entry.data;
+	}
+}
+function sameSelection(left, state) {
+	return left.majorMode === state.majorMode && left.profile === state.profile && (left.compositionFingerprint === void 0 || left.compositionFingerprint === state.compositionFingerprint) && left.domains.length === state.domains.length && left.domains.every((domain, index) => domain === state.domains[index]);
+}
+function isActiveTransitionTarget(target, state) {
+	return target.compositionFingerprint !== void 0 && target.compositionFingerprint === state.compositionFingerprint && sameSelection(target, state);
+}
+function pendingFromTransition(transition) {
+	if (transition.phase !== "pending") return void 0;
+	return {
+		...transition,
+		phase: "pending"
+	};
+}
+function pendingFromLegacySelection(selection, bootstrap) {
+	if (sameSelection(selection, bootstrap)) return void 0;
+	return {
+		version: 1,
+		operationId: "legacy-config-selection",
+		active: {
+			version: 1,
+			majorMode: bootstrap.majorMode,
+			domains: [...bootstrap.domains],
+			profile: bootstrap.profile,
+			compositionFingerprint: bootstrap.compositionFingerprint
+		},
+		target: selection,
+		strategy: "process-relaunch",
+		phase: "pending"
+	};
+}
+function deepFreeze(value) {
+	if (typeof value !== "object" || value === null || Object.isFrozen(value)) return value;
+	for (const child of Object.values(value)) deepFreeze(child);
+	return Object.freeze(value);
+}
+function readDoomConfigSelection(ctx) {
+	return branchSelection(ctx.sessionManager.getBranch());
+}
+function resolveContextState(ctx) {
+	const bootstrap = getSessionHarnessState(ctx.sessionManager.getSessionId());
+	return resolveBranchState(ctx.sessionManager.getBranch(), bootstrap);
+}
+function resolveBranchState(entries, bootstrap) {
+	const selection = branchSelection(entries);
+	const transition = branchTransition(entries);
+	const transitionPending = transition ? pendingFromTransition(transition) : void 0;
+	const pendingSelection = transition ? transitionPending : selection ? pendingFromLegacySelection(selection, bootstrap) : void 0;
+	return {
+		harness: bootstrap,
+		pendingSelection,
+		requiresRelaunch: pendingSelection !== void 0 && (transitionPending === void 0 || !isActiveTransitionTarget(pendingSelection.target, bootstrap)),
+		root: bootstrap.root
+	};
+}
+function createDoomConfigContext(ctx) {
+	const { harness, pendingSelection, requiresRelaunch, root } = resolveContextState(ctx);
+	return deepFreeze({
+		settings: loadDoomConfig(root ?? ctx.cwd),
+		harness,
+		pendingSelection,
+		requiresRelaunch
+	});
+}
+async function createDoomConfigContextAsync(ctx) {
+	const { harness, pendingSelection, requiresRelaunch, root } = resolveContextState(ctx);
+	return deepFreeze({
+		settings: await loadDoomConfigAsync(root ?? ctx.cwd),
+		harness,
+		pendingSelection,
+		requiresRelaunch
+	});
+}
+/** Initializes from this native session's branch, awaiting durable transition acknowledgement. */
+async function createNativeDoomConfigContext(execution) {
+	const bootstrap = getSessionHarnessState(execution.sessionId);
+	const branch = (await execution.session.entries({ type: "custom" })).map((entry) => ({
+		type: String(entry.type),
+		customType: typeof entry.customType === "string" ? entry.customType : void 0,
+		data: entry.data
+	}));
+	const transition = branchTransition(branch);
+	if (transition?.phase === "pending" && isActiveTransitionTarget(transition.target, bootstrap)) {
+		const data = {
+			...transition,
+			phase: "applied"
+		};
+		await execution.session.appendCustomEntry(DOOM_CONFIG_TRANSITION_ENTRY_TYPE, data);
+		branch.push({
+			type: "custom",
+			customType: DOOM_CONFIG_TRANSITION_ENTRY_TYPE,
+			data
+		});
+	}
+	const { harness, pendingSelection, requiresRelaunch, root } = resolveBranchState(branch, bootstrap);
+	return deepFreeze({
+		settings: await loadDoomConfigAsync(root ?? execution.cwd, void 0, execution.environment),
+		harness,
+		pendingSelection,
+		requiresRelaunch
+	});
+}
+function appendDoomConfigSelection(pi, selection) {
+	pi.appendEntry(DOOM_CONFIG_ENTRY_TYPE, selection);
+}
+/** Journals the live selection, defaulting to whatever the harness store holds. */
+function persistHarnessSelection(pi, state = getHarnessState()) {
+	appendDoomConfigSelection(pi, {
+		version: 1,
+		majorMode: state.majorMode,
+		domains: state.domains,
+		profile: state.profile,
+		compositionFingerprint: state.compositionFingerprint
+	});
+}
+function appendDoomConfigTransition(pi, transition) {
+	pi.appendEntry(DOOM_CONFIG_TRANSITION_ENTRY_TYPE, transition);
+}
+function supersedeDoomConfigTransition(pi, transition) {
+	pi.appendEntry(DOOM_CONFIG_TRANSITION_ENTRY_TYPE, {
+		...transition,
+		phase: "superseded"
+	});
+}
+/** Acknowledges the latest pending transition from a fresh session that owns its exact target composition. */
+function acknowledgeDoomConfigTransition(pi, ctx, harness) {
+	const transition = branchTransition(ctx.sessionManager.getBranch());
+	if (!transition || transition.phase !== "pending" || !isActiveTransitionTarget(transition.target, harness)) return false;
+	appendDoomConfigTransition(pi, {
+		...transition,
+		phase: "applied"
+	});
+	return true;
+}
+function readDoomConfigPendingSelection(ctx) {
+	const bootstrap = getSessionHarnessState(ctx.sessionManager.getSessionId());
+	const transition = branchTransition(ctx.sessionManager.getBranch());
+	const transitionPending = transition ? pendingFromTransition(transition) : void 0;
+	if (transition) return transitionPending;
+	const selection = branchSelection(ctx.sessionManager.getBranch());
+	return selection ? pendingFromLegacySelection(selection, bootstrap) : void 0;
+}
+function provideDoomConfigContext(ctx, context, generation = `doom-config:${crypto.randomUUID()}`) {
+	return new DoomConfigService(ctx, deepFreeze(context), loadDoomConfig, generation);
+}
+/** Returns the binding identity used to fence in-flight transitions. */
+function readDoomConfigContextGeneration(ctx) {
+	return readDoomConfigService(ctx)?.generation;
+}
+/** Precomputes an immutable context before a transaction reaches publication. */
+function freezeDoomConfigContext(context) {
+	return deepFreeze(context);
+}
+/** Replaces a live binding with a deeply frozen context after publication. */
+function replaceDoomConfigContext(ctx, context) {
+	const next = deepFreeze(context);
+	return requireDoomConfigService(ctx).replaceSnapshot(next);
+}
+function readDoomConfigService(ctx) {
+	return ctx.get(DOOM_CONFIG_SERVICE);
+}
+function requireDoomConfigService(ctx) {
+	const service = readDoomConfigService(ctx);
+	if (!service) throw new Error("Doom config service is unavailable. Load @agimon-ai/po-config/extensions/server.");
+	return service;
+}
+function requireDoomConfigContext(ctx) {
+	return requireDoomConfigService(ctx).getSnapshot();
+}
+//#endregion
+export { supersedeDoomConfigTransition as _, appendDoomConfigTransition as a, createNativeDoomConfigContext as c, provideDoomConfigContext as d, readDoomConfigContextGeneration as f, requireDoomConfigContext as g, replaceDoomConfigContext as h, appendDoomConfigSelection as i, freezeDoomConfigContext as l, readDoomConfigSelection as m, DOOM_CONFIG_TRANSITION_ENTRY_TYPE as n, createDoomConfigContext as o, readDoomConfigPendingSelection as p, acknowledgeDoomConfigTransition as r, createDoomConfigContextAsync as s, DOOM_CONFIG_ENTRY_TYPE as t, persistHarnessSelection as u };
+
+//# sourceMappingURL=sessionConfig-CtLoc-lO.mjs.map

package/dist/sessionConfig-CtLoc-lO.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionConfig-CtLoc-lO.mjs","names":["deepFreeze"],"sources":["../src/services/doomConfigService/index.ts","../src/services/sessionConfig/index.ts"],"sourcesContent":["import { type Context, Service } from '@deepseek-ai/cordis';\n\nimport {\n  DOOM_CONFIG_SERVICE,\n  type DeepReadonly,\n  type DoomConfig,\n  type DoomConfigContext,\n  type DoomConfigLoader,\n  type IDoomConfigService,\n} from '../../types/config';\n\nfunction deepFreeze<TValue>(value: TValue): DeepReadonly<TValue> {\n  if (typeof value !== 'object' || value === null || Object.isFrozen(value)) {\n    return value as DeepReadonly<TValue>;\n  }\n  for (const child of Object.values(value)) deepFreeze(child);\n  return Object.freeze(value) as DeepReadonly<TValue>;\n}\n\n/**\n * Doom configuration published on the shared cordis Context.\n *\n * Every extension resolves the same instance by name, so configuration stays\n * one read per session instead of one per consumer, and the registration is\n * removed with the fiber that created it. The loader is injected so this stays\n * free of filesystem access.\n */\nexport class DoomConfigService extends Service implements IDoomConfigService {\n  readonly generation: string;\n  private snapshot: DoomConfigContext;\n\n  constructor(\n    ctx: Context,\n    snapshot: DoomConfigContext,\n    private readonly loadConfig: DoomConfigLoader,\n    generation = `doom-config:${crypto.randomUUID()}`,\n  ) {\n    super(ctx, DOOM_CONFIG_SERVICE);\n    this.snapshot = deepFreeze(snapshot) as DoomConfigContext;\n    this.generation = generation;\n  }\n\n  getSnapshot(): DoomConfigContext {\n    return this.snapshot;\n  }\n\n  replaceSnapshot(context: DoomConfigContext): DoomConfigContext {\n    this.snapshot = deepFreeze(context) as DoomConfigContext;\n    return this.snapshot;\n  }\n\n  load(repoRoot: string, homeDirectory?: string): DoomConfig {\n    return this.loadConfig(repoRoot, homeDirectory);\n  }\n}\n","import type { DoomHeadlessExecutionContext } from '@agimon-ai/po-core/headless';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\n\nimport type {\n  DoomConfigSelection as ConfigSelection,\n  DeepReadonly,\n  DoomConfigContext,\n  DoomConfigPendingSelection,\n  DoomConfigTransitionRecord,\n  DoomConfigTransitionStrategy,\n  HarnessState,\n  IDoomConfigService,\n} from '../../types/config';\nimport { DOOM_CONFIG_SERVICE } from '../../types/config';\nimport { loadDoomConfig, loadDoomConfigAsync } from '../config';\nimport { DoomConfigService } from '../doomConfigService';\nimport { getHarnessState, getSessionHarnessState } from '../harnessStore';\n\nexport const DOOM_CONFIG_ENTRY_TYPE = 'po:config:v1';\nexport const DOOM_CONFIG_TRANSITION_ENTRY_TYPE = 'po:transition:v1';\n\nexport type DoomConfigSelection = ConfigSelection;\n\ntype DoomConfigTransitionEntry = DoomConfigTransitionRecord;\n\nfunction isSelection(value: unknown): value is DoomConfigSelection {\n  if (typeof value !== 'object' || value === null) return false;\n  const selection = value as Partial<DoomConfigSelection>;\n  return (\n    selection.version === 1 &&\n    typeof selection.majorMode === 'string' &&\n    Array.isArray(selection.domains) &&\n    selection.domains.every((domain) => typeof domain === 'string') &&\n    (selection.profile === undefined || typeof selection.profile === 'string') &&\n    (selection.compositionFingerprint === undefined || typeof selection.compositionFingerprint === 'string')\n  );\n}\n\nfunction branchSelection(\n  entries: readonly { type: string; customType?: string; data?: unknown }[],\n): DoomConfigSelection | undefined {\n  for (let index = entries.length - 1; index >= 0; index -= 1) {\n    const entry = entries[index];\n    if (entry?.type === 'custom' && entry.customType === DOOM_CONFIG_ENTRY_TYPE && isSelection(entry.data)) {\n      return entry.data;\n    }\n  }\n  return undefined;\n}\n\nfunction isTransitionStrategy(value: unknown): value is DoomConfigTransitionStrategy {\n  return value === 'pi-reload' || value === 'process-relaunch';\n}\n\nfunction isTransition(value: unknown): value is DoomConfigTransitionEntry {\n  if (typeof value !== 'object' || value === null) return false;\n  const transition = value as Partial<DoomConfigTransitionEntry>;\n  return (\n    transition.version === 1 &&\n    typeof transition.operationId === 'string' &&\n    isSelection(transition.active) &&\n    isSelection(transition.target) &&\n    isTransitionStrategy(transition.strategy) &&\n    (transition.phase === 'pending' ||\n      transition.phase === 'applied' ||\n      transition.phase === 'aborted' ||\n      transition.phase === 'superseded')\n  );\n}\n\nfunction branchTransition(\n  entries: readonly { type: string; customType?: string; data?: unknown }[],\n): DoomConfigTransitionEntry | undefined {\n  for (let index = entries.length - 1; index >= 0; index -= 1) {\n    const entry = entries[index];\n    if (\n      entry?.type === 'custom' &&\n      entry.customType === DOOM_CONFIG_TRANSITION_ENTRY_TYPE &&\n      isTransition(entry.data)\n    ) {\n      return entry.data;\n    }\n  }\n  return undefined;\n}\n\nfunction sameSelection(left: DoomConfigSelection, state: HarnessState): boolean {\n  return (\n    left.majorMode === state.majorMode &&\n    left.profile === state.profile &&\n    (left.compositionFingerprint === undefined || left.compositionFingerprint === state.compositionFingerprint) &&\n    left.domains.length === state.domains.length &&\n    left.domains.every((domain, index) => domain === state.domains[index])\n  );\n}\n\nfunction isActiveTransitionTarget(target: DoomConfigSelection, state: HarnessState): boolean {\n  return (\n    target.compositionFingerprint !== undefined &&\n    target.compositionFingerprint === state.compositionFingerprint &&\n    sameSelection(target, state)\n  );\n}\n\nfunction pendingFromTransition(transition: DoomConfigTransitionEntry): DoomConfigPendingSelection | undefined {\n  if (transition.phase !== 'pending') return undefined;\n  return { ...transition, phase: 'pending' };\n}\n\nfunction pendingFromLegacySelection(\n  selection: DoomConfigSelection,\n  bootstrap: HarnessState,\n): DoomConfigPendingSelection | undefined {\n  if (sameSelection(selection, bootstrap)) return undefined;\n  const active: DoomConfigSelection = {\n    version: 1,\n    majorMode: bootstrap.majorMode,\n    domains: [...bootstrap.domains],\n    profile: bootstrap.profile,\n    compositionFingerprint: bootstrap.compositionFingerprint,\n  };\n  return {\n    version: 1,\n    operationId: 'legacy-config-selection',\n    active,\n    target: selection,\n    strategy: 'process-relaunch',\n    phase: 'pending',\n  };\n}\n\nfunction deepFreeze<TValue>(value: TValue): DeepReadonly<TValue> {\n  if (typeof value !== 'object' || value === null || Object.isFrozen(value)) {\n    return value as DeepReadonly<TValue>;\n  }\n  for (const child of Object.values(value)) deepFreeze(child);\n  return Object.freeze(value) as DeepReadonly<TValue>;\n}\n\nexport function readDoomConfigSelection(\n  ctx: Pick<ExtensionContext, 'sessionManager'>,\n): DoomConfigSelection | undefined {\n  return branchSelection(ctx.sessionManager.getBranch());\n}\n\nfunction resolveContextState(ctx: Pick<ExtensionContext, 'sessionManager'>): {\n  harness: HarnessState;\n  pendingSelection: DoomConfigPendingSelection | undefined;\n  requiresRelaunch: boolean;\n  root: string | undefined;\n} {\n  const bootstrap = getSessionHarnessState(ctx.sessionManager.getSessionId());\n  return resolveBranchState(ctx.sessionManager.getBranch(), bootstrap);\n}\n\nfunction resolveBranchState(\n  entries: readonly { type: string; customType?: string; data?: unknown }[],\n  bootstrap: HarnessState,\n): {\n  harness: HarnessState;\n  pendingSelection: DoomConfigPendingSelection | undefined;\n  requiresRelaunch: boolean;\n  root: string | undefined;\n} {\n  const selection = branchSelection(entries);\n  const transition = branchTransition(entries);\n  const transitionPending = transition ? pendingFromTransition(transition) : undefined;\n  const pendingSelection = transition\n    ? transitionPending\n    : selection\n      ? pendingFromLegacySelection(selection, bootstrap)\n      : undefined;\n  return {\n    harness: bootstrap,\n    pendingSelection,\n    requiresRelaunch:\n      pendingSelection !== undefined &&\n      (transitionPending === undefined || !isActiveTransitionTarget(pendingSelection.target, bootstrap)),\n    root: bootstrap.root,\n  };\n}\n\nexport function createDoomConfigContext(ctx: Pick<ExtensionContext, 'cwd' | 'sessionManager'>): DoomConfigContext {\n  const { harness, pendingSelection, requiresRelaunch, root } = resolveContextState(ctx);\n  return deepFreeze({ settings: loadDoomConfig(root ?? ctx.cwd), harness, pendingSelection, requiresRelaunch });\n}\n\nexport async function createDoomConfigContextAsync(\n  ctx: Pick<ExtensionContext, 'cwd' | 'sessionManager'>,\n): Promise<DoomConfigContext> {\n  const { harness, pendingSelection, requiresRelaunch, root } = resolveContextState(ctx);\n  const settings = await loadDoomConfigAsync(root ?? ctx.cwd);\n  return deepFreeze({ settings, harness, pendingSelection, requiresRelaunch });\n}\n\n/** Initializes from this native session's branch, awaiting durable transition acknowledgement. */\nexport async function createNativeDoomConfigContext(\n  execution: DoomHeadlessExecutionContext,\n): Promise<DoomConfigContext> {\n  const bootstrap = getSessionHarnessState(execution.sessionId);\n  const entries = await execution.session.entries({ type: 'custom' });\n  const branch = entries.map((entry) => ({\n    type: String(entry.type),\n    customType: typeof entry.customType === 'string' ? entry.customType : undefined,\n    data: entry.data,\n  }));\n  const transition = branchTransition(branch);\n  if (transition?.phase === 'pending' && isActiveTransitionTarget(transition.target, bootstrap)) {\n    const data = { ...transition, phase: 'applied' as const };\n    await execution.session.appendCustomEntry(DOOM_CONFIG_TRANSITION_ENTRY_TYPE, data);\n    branch.push({ type: 'custom', customType: DOOM_CONFIG_TRANSITION_ENTRY_TYPE, data });\n  }\n  const { harness, pendingSelection, requiresRelaunch, root } = resolveBranchState(branch, bootstrap);\n  const settings = await loadDoomConfigAsync(root ?? execution.cwd, undefined, execution.environment);\n  return deepFreeze({ settings, harness, pendingSelection, requiresRelaunch });\n}\n\nexport function appendDoomConfigSelection(pi: Pick<ExtensionAPI, 'appendEntry'>, selection: DoomConfigSelection): void {\n  pi.appendEntry(DOOM_CONFIG_ENTRY_TYPE, selection);\n}\n\n/** Journals the live selection, defaulting to whatever the harness store holds. */\nexport function persistHarnessSelection(\n  pi: Pick<ExtensionAPI, 'appendEntry'>,\n  state: {\n    readonly majorMode: string;\n    readonly domains: readonly string[];\n    readonly profile?: string;\n    readonly compositionFingerprint?: string;\n  } = getHarnessState(),\n): void {\n  appendDoomConfigSelection(pi, {\n    version: 1,\n    majorMode: state.majorMode,\n    domains: state.domains,\n    profile: state.profile,\n    compositionFingerprint: state.compositionFingerprint,\n  });\n}\n\nexport function appendDoomConfigTransition(\n  pi: Pick<ExtensionAPI, 'appendEntry'>,\n  transition: DoomConfigTransitionRecord,\n): void {\n  pi.appendEntry(DOOM_CONFIG_TRANSITION_ENTRY_TYPE, transition);\n}\n\nexport function supersedeDoomConfigTransition(\n  pi: Pick<ExtensionAPI, 'appendEntry'>,\n  transition: DoomConfigPendingSelection,\n): void {\n  pi.appendEntry(DOOM_CONFIG_TRANSITION_ENTRY_TYPE, { ...transition, phase: 'superseded' });\n}\n\n/** Acknowledges the latest pending transition from a fresh session that owns its exact target composition. */\nexport function acknowledgeDoomConfigTransition(\n  pi: Pick<ExtensionAPI, 'appendEntry'>,\n  ctx: Pick<ExtensionContext, 'sessionManager'>,\n  harness: HarnessState,\n): boolean {\n  const transition = branchTransition(ctx.sessionManager.getBranch());\n  if (!transition || transition.phase !== 'pending' || !isActiveTransitionTarget(transition.target, harness)) {\n    return false;\n  }\n  appendDoomConfigTransition(pi, { ...transition, phase: 'applied' });\n  return true;\n}\n\nexport function readDoomConfigPendingSelection(\n  ctx: Pick<ExtensionContext, 'sessionManager'>,\n): DoomConfigPendingSelection | undefined {\n  const bootstrap = getSessionHarnessState(ctx.sessionManager.getSessionId());\n  const transition = branchTransition(ctx.sessionManager.getBranch());\n  const transitionPending = transition ? pendingFromTransition(transition) : undefined;\n  if (transition) return transitionPending;\n  const selection = branchSelection(ctx.sessionManager.getBranch());\n  return selection ? pendingFromLegacySelection(selection, bootstrap) : undefined;\n}\n\nexport function provideDoomConfigContext(\n  ctx: Context,\n  context: DoomConfigContext,\n  generation = `doom-config:${crypto.randomUUID()}`,\n): IDoomConfigService {\n  return new DoomConfigService(ctx, deepFreeze(context) as DoomConfigContext, loadDoomConfig, generation);\n}\n\n/** Returns the binding identity used to fence in-flight transitions. */\nexport function readDoomConfigContextGeneration(ctx: Context): string | undefined {\n  return readDoomConfigService(ctx)?.generation;\n}\n\n/** Precomputes an immutable context before a transaction reaches publication. */\nexport function freezeDoomConfigContext(context: DoomConfigContext): DoomConfigContext {\n  return deepFreeze(context);\n}\n\n/** Replaces a live binding with a deeply frozen context after publication. */\nexport function replaceDoomConfigContext(ctx: Context, context: DoomConfigContext): DoomConfigContext {\n  const next = deepFreeze(context);\n  return requireDoomConfigService(ctx).replaceSnapshot(next as DoomConfigContext);\n}\n\nexport function readDoomConfigService(ctx: Context): IDoomConfigService | undefined {\n  return ctx.get(DOOM_CONFIG_SERVICE) as IDoomConfigService | undefined;\n}\n\nexport function requireDoomConfigService(ctx: Context): IDoomConfigService {\n  const service = readDoomConfigService(ctx);\n  if (!service) throw new Error('Doom config service is unavailable. Load @agimon-ai/po-config/extensions/server.');\n  return service;\n}\n\nexport function requireDoomConfigContext(ctx: Context): DoomConfigContext {\n  return requireDoomConfigService(ctx).getSnapshot();\n}\n"],"mappings":"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"}

package/dist/types.cjs

@@ -0,0 +1,9 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("./config-zZz80Mh5.cjs");
+let _agimon_ai_po_core_config = require("@agimon-ai/po-core/config");
+Object.defineProperty(exports, "DOOM_CONFIG_SERVICE", {
+	enumerable: true,
+	get: function() {
+		return _agimon_ai_po_core_config.DOOM_CONFIG_SERVICE;
+	}
+});

package/dist/types.d.mts

@@ -0,0 +1,2 @@
+import { A as PluginHookSource, B as VoiceTtsConfig, C as IDoomConfigService, D as PlanningAgentConfig, E as PackageAttribution, F as VoiceAutoCaptureConfig, I as VoiceConfig, L as VoiceEngine, M as ResolvedVoiceAutoCaptureConfig, N as ResolvedVoiceConfig, O as PlanningModeConfig, P as VoiceAdapterConfig, R as VoiceMode, S as IDoomConfigLoader, T as LenientParseResult, V as VoiceTtsEngine, _ as DoomConfigTransitionStrategy, a as ConfigDiagnostic, b as EditorConfig, c as DeepReadonly, d as DoomConfigLayer, f as DoomConfigLayers, g as DoomConfigTransitionRecord, h as DoomConfigTransitionPhase, i as AutocompactTokenConfig, j as ProjectTrust, k as PlanningThinkingLevel, l as DoomConfig, m as DoomConfigSelection, n as AutocompactOverrideConfig, o as ConfigValueOrigin, p as DoomConfigPendingSelection, r as AutocompactThresholdConfig, s as DOOM_CONFIG_SERVICE, t as AutocompactModeConfig, u as DoomConfigContext, v as DoomHarnessContext, w as LenientParseOptions, x as HarnessState, y as DoomSelectionConfig, z as VoiceModelConfig } from "./config-Cm3EV1jp.mjs";
+export { type AutocompactModeConfig, type AutocompactOverrideConfig, type AutocompactThresholdConfig, type AutocompactTokenConfig, type ConfigDiagnostic, type ConfigValueOrigin, DOOM_CONFIG_SERVICE, type DeepReadonly, type DoomConfig, type DoomConfigContext, type DoomConfigLayer, type DoomConfigLayers, type DoomConfigPendingSelection, type DoomConfigSelection, type DoomConfigTransitionPhase, type DoomConfigTransitionRecord, type DoomConfigTransitionStrategy, type DoomHarnessContext, type DoomSelectionConfig, type EditorConfig, type HarnessState, type IDoomConfigLoader, type IDoomConfigService, type LenientParseOptions, type LenientParseResult, type PackageAttribution, type PlanningAgentConfig, type PlanningModeConfig, type PlanningThinkingLevel, type PluginHookSource, type ProjectTrust, type ResolvedVoiceAutoCaptureConfig, type ResolvedVoiceConfig, type VoiceAdapterConfig, type VoiceAutoCaptureConfig, type VoiceConfig, type VoiceEngine, type VoiceMode, type VoiceModelConfig, type VoiceTtsConfig, type VoiceTtsEngine };

package/dist/types.mjs

@@ -0,0 +1,2 @@
+import { t as DOOM_CONFIG_SERVICE } from "./config-NSHRd6na.mjs";
+export { DOOM_CONFIG_SERVICE };

package/llms.txt

@@ -0,0 +1,12 @@
+# Doom Pi Config
+
+Package-owned guidance for Po runtime settings, source precedence, and typed session context.
+
+## How to author
+
+- [Author Po runtime configuration](./src/prompts/po-author-config/SKILL.md): Change `config.yaml` and consume session configuration safely.
+- [Configuration authoring contract](./src/prompts/po-author-config/references/config-contract.md): Runtime schema, source merge rules, typed context, transition state, and verification.
+
+## Package reference
+
+- [Package README](./README.md): Runtime configuration, immutable context, transitions, and public APIs.

package/package.json

@@ -0,0 +1,206 @@
+{
+  "name": "@agimon-ai/po-config",
+  "version": "0.0.0-alpha.0",
+  "description": "Typed configuration loading, validation, and host services for composing Po sessions.",
+  "keywords": [
+    "agent-configuration",
+    "ai",
+    "coding-agent",
+    "configuration",
+    "dependency-injection",
+    "developer-tools",
+    "pi-coding-agent",
+    "pi-package",
+    "po",
+    "typescript",
+    "yaml"
+  ],
+  "homepage": "https://agimon.ai",
+  "bugs": {
+    "url": "https://github.com/AgiFlow/po/issues"
+  },
+  "license": "MIT",
+  "author": "Vuong Ngo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgiFlow/po.git",
+    "directory": "packages/foundations/po-config"
+  },
+  "files": [
+    "dist",
+    "llms.txt",
+    "README.md",
+    "src/prompts"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.mts",
+  "jsnext:main": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./agentPluginMcp": {
+      "types": "./dist/agentPluginMcp.d.mts",
+      "import": "./dist/agentPluginMcp.mjs",
+      "require": "./dist/agentPluginMcp.cjs"
+    },
+    "./apiContracts": {
+      "types": "./dist/apiContracts.d.mts",
+      "import": "./dist/apiContracts.mjs",
+      "require": "./dist/apiContracts.cjs"
+    },
+    "./atomicJson": {
+      "types": "./dist/atomicJson.d.mts",
+      "import": "./dist/atomicJson.mjs",
+      "require": "./dist/atomicJson.cjs"
+    },
+    "./config": {
+      "types": "./dist/config.d.mts",
+      "import": "./dist/config.mjs",
+      "require": "./dist/config.cjs"
+    },
+    "./configSchema": {
+      "types": "./dist/configSchema.d.mts",
+      "import": "./dist/configSchema.mjs",
+      "require": "./dist/configSchema.cjs"
+    },
+    "./configWriter": {
+      "types": "./dist/configWriter.d.mts",
+      "import": "./dist/configWriter.mjs",
+      "require": "./dist/configWriter.cjs"
+    },
+    "./domains": {
+      "types": "./dist/domains.d.mts",
+      "import": "./dist/domains.mjs",
+      "require": "./dist/domains.cjs"
+    },
+    "./extensions/server": {
+      "types": "./dist/extensions/server.d.mts",
+      "import": "./dist/extensions/server.mjs",
+      "require": "./dist/extensions/server.cjs"
+    },
+    "./harnessState": {
+      "types": "./dist/harnessState.d.mts",
+      "import": "./dist/harnessState.mjs",
+      "require": "./dist/harnessState.cjs"
+    },
+    "./harnessStore": {
+      "types": "./dist/harnessStore.d.mts",
+      "import": "./dist/harnessStore.mjs",
+      "require": "./dist/harnessStore.cjs"
+    },
+    "./init": {
+      "types": "./dist/init.d.mts",
+      "import": "./dist/init.mjs",
+      "require": "./dist/init.cjs"
+    },
+    "./layeredConfig": {
+      "types": "./dist/layeredConfig.d.mts",
+      "import": "./dist/layeredConfig.mjs",
+      "require": "./dist/layeredConfig.cjs"
+    },
+    "./majorModes": {
+      "types": "./dist/majorModes.d.mts",
+      "import": "./dist/majorModes.mjs",
+      "require": "./dist/majorModes.cjs"
+    },
+    "./piConfig": {
+      "types": "./dist/piConfig.d.mts",
+      "import": "./dist/piConfig.mjs",
+      "require": "./dist/piConfig.cjs"
+    },
+    "./piContext": {
+      "types": "./dist/piContext.d.mts",
+      "import": "./dist/piContext.mjs",
+      "require": "./dist/piContext.cjs"
+    },
+    "./profiles": {
+      "types": "./dist/profiles.d.mts",
+      "import": "./dist/profiles.mjs",
+      "require": "./dist/profiles.cjs"
+    },
+    "./selectionSwitch": {
+      "types": "./dist/selectionSwitch.d.mts",
+      "import": "./dist/selectionSwitch.mjs",
+      "require": "./dist/selectionSwitch.cjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.mts",
+      "import": "./dist/types.mjs",
+      "require": "./dist/types.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@agimon-ai/po-core": "0.0.0-alpha.0",
+    "@agimon-ai/po-telemetry": "0.0.0-alpha.0",
+    "@agimon-ai/po-web-components": "0.0.0-alpha.0",
+    "@deepseek-ai/cordis": "4.0.4",
+    "typebox": "1.3.34",
+    "yaml": "2.9.1"
+  },
+  "devDependencies": {
+    "@agimon-ai/po-build": "0.0.0-alpha.0",
+    "@earendil-works/pi-coding-agent": "1.0.2",
+    "@modelcontextprotocol/ext-apps": "2.0.3",
+    "@modelcontextprotocol/server": "2.2.0",
+    "@playwright/test": "1.63.0",
+    "@types/node": "26.6.4",
+    "@types/react": "19.3.0",
+    "@vitest/coverage-v8": "5.0.3",
+    "react": "19.3.0",
+    "tsdown": "0.23.0",
+    "typescript": "7.0.2",
+    "vitest": "5.0.3"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "1.0.2"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "poMcp": {
+    "entry": "./generated/mcp.ts",
+    "dist": "./dist/extensions/mcp.mjs",
+    "scopes": [
+      "session"
+    ],
+    "ui": {
+      "entry": "./generated/mcp-ui.ts",
+      "dist": "./dist/extensions/mcp-ui.mjs",
+      "widgets": [
+        "@agimon-ai/po-config/load_context",
+        "@agimon-ai/po-config/rename_thread",
+        "@agimon-ai/po-config/show_session"
+      ]
+    }
+  },
+  "poServer": {
+    "entry": "./generated/server.ts",
+    "dist": "./dist/extensions/server.mjs",
+    "scopes": [
+      "global",
+      "workspace",
+      "session"
+    ],
+    "contracts": {
+      "entry": "./src/exports/apiContracts.ts",
+      "dist": "./dist/apiContracts.mjs"
+    }
+  },
+  "scripts": {
+    "build": "tsdown && pnpm build:mcp",
+    "build:mcp": "tsdown --config tsdown.mcp.config.ts",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.mcp.json",
+    "lint": "oxlint . && oxfmt . --check",
+    "fixcode": "oxlint . --fix && oxfmt ."
+  }
+}

package/src/prompts/po-author-config/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: po-author-config
+description: Configure Po runtime settings, source precedence, and typed session configuration. Use for config.yaml, the doom/config Cordis service, immutable context snapshots, or shared selection transition state. Do not use for defining modes.yaml, domains.yaml, or profiles.yaml.
+---
+
+# Author Po runtime configuration
+
+Configure runtime policy in `config.yaml` and consume one immutable session snapshot through Cordis.
+
+## Workflow
+
+1. Read both `~/.po/config.yaml` and the repository's `.po/config.yaml` before changing effective settings.
+2. Check the `DoomConfig` types and parser before adding or editing a field. Unknown keys and invalid values fail early
+   everywhere a session reads config. `po sync` is the one exception: it reports an unknown key and carries on, so a
+   config written for another version cannot break a build. Invalid values for known keys still fail there too. Run
+   `po doctor` for the strict check.
+3. Preserve field-specific source policy. Repository settings do not uniformly replace every personal setting.
+4. Consume live state only inside an owning `cordis.inject([DOOM_CONFIG_SERVICE], ...)` callback, using `requireDoomConfigContext(cordis)`.
+5. Treat `settings`, `harness`, `pendingSelection`, and nested values as immutable. Do not mutate or cache a snapshot across session replacement.
+6. Route live major-mode, domain, and profile changes through the transition coordinator. Keep append-only selection and transition entries consistent with the active harness.
+7. Keep `process.env` as launcher transport and the controlled live-switch boundary, not as an alternative configuration registry.
+8. Verify parsing and merge behavior with Doom Config tests, then exercise `po --explain` and a real session when transition behavior changes.
+
+Use the package-owned Major Mode, Domain, or Profile Help skill when the task is to define an axis in `modes.yaml`, `domains.yaml`, or `profiles.yaml`.
+
+Read [references/config-contract.md](references/config-contract.md) for the runtime schema, source merge rules, immutable context, and transition contract.

package/src/prompts/po-author-config/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Doom Pi Runtime Config"
+  short_description: "Configure runtime settings and session context"
+  default_prompt: "Use $po-author-config to update Po runtime configuration safely."