@llblab/pi-kit 0.28.0 → 0.29.1

package/node_modules/@llblab/pi-state-flow/lib/snapshot.ts

@@ -9,8 +9,6 @@ const MAX_LEGACY_VALIDATION_ATTEMPT = 7;
 /** Missing operational capability is not evidence that a checkpoint target is invalid. */
 export class RevisionUnavailableError extends Error {}
 
-/** Expired history cannot be restored, but explicit activation may use validated current memory. */
-export class HistoryBoundaryExpiredError extends RevisionUnavailableError {}
 
 export type StateFlowMode = "active" | "passive" | "off";
 export type InactiveMode = Exclude<StateFlowMode, "active">;
@@ -57,6 +55,11 @@ export interface StateFlowSnapshot {
 
 export type Snapshot = StateFlowSnapshot;
 
+/** Failed Active selection retains its policy and fences inference until explicit recovery or an inactive choice. */
+export function isActiveRestorationBlocked(snapshot: Snapshot): boolean {
+	return snapshot.config.mode === "active" && snapshot.meta.validation?.attempt === 0;
+}
+
 export interface SessionRuntime {
 	config: SnapshotConfig;
 	meta: SnapshotMeta & {
@@ -249,7 +252,7 @@ export function parseRetainedPiCheckpoint(value: unknown, inactiveMode: Inactive
 	};
 }
 
-export function migrationFailure(data: JsonObject, error: string, mode: InactiveMode = "passive"): Snapshot {
+export function migrationFailure(data: JsonObject, error: string, mode: StateFlowMode = "passive"): Snapshot {
 	const meta = restoredMeta(data.meta, data);
 	meta.validation = {
 		attempt: 0,

package/node_modules/@llblab/pi-state-flow/lib/status.ts

@@ -2,7 +2,7 @@ import type { ArtifactInvalidationReason } from "./artifact.ts";
 import type { RecentTransitionWindow } from "./history.ts";
 import { ownedTopLevelKeys } from "./ownership.ts";
 import { conciseDiagnostic } from "./protocol.ts";
-import type { Snapshot } from "./snapshot.ts";
+import { isActiveRestorationBlocked, type Snapshot } from "./snapshot.ts";
 import { overlayStates, projectSemanticState, type SemanticState, type ScopedStates, type StateScope } from "./state.ts";
 import type { ScopeRevisions, TransitionBoundary } from "./temporal.ts";
 
@@ -40,7 +40,7 @@ export function formatScopeRevisionVector(revisions: ScopeRevisions): string {
 export function compactStatus(snapshot: Snapshot, _revisions: ScopeRevisions, colorize: Colorize): string | undefined {
 	const { mode } = snapshot.config;
 	if (mode === "off") return undefined;
-	return `${colorize("accent", "state-flow")} ${colorize("dim", mode)}`;
+	return `${colorize("accent", "state-flow")} ${colorize("dim", isActiveRestorationBlocked(snapshot) ? "active (blocked)" : mode)}`;
 }
 
 function countArtifacts(states: ScopedStates, scope: StateScope): number {
@@ -101,6 +101,8 @@ export function detailedStatus(snapshot: Snapshot, diagnostics: StatusDiagnostic
 	const hasArtifacts = available && (["global", "cwd", "session"] as const).some((scope) => artifacts(scope) > 0);
 
 	return [
+		`Mode: ${snapshot.config.mode}`,
+		...(isActiveRestorationBlocked(snapshot) ? ["Inference blocked: Active memory restoration failed. Use /state-flow-active for current memory or select Passive/Off for native context."] : []),
 		`Repository: ${diagnostics.repositoryRoot}`,
 		`Scope keys: CWD ${diagnostics.cwdScopeKey}; session ${diagnostics.sessionScopeKey}`,
 		...temporalLines,

package/node_modules/@llblab/pi-state-flow/lib/telegram.ts

@@ -21,6 +21,8 @@ export function stateFlowTelegramSectionSpecifiers(moduleUrl = import.meta.url):
 export interface StateFlowTelegramSnapshot {
 	/** The current session's selected mode. */
 	mode: StateFlowMode;
+	/** Failed Active restoration fences inference without silently selecting an inactive mode. */
+	inferenceBlocked?: boolean;
 	/** Legacy branch step retained for existing adapter ports; current runtime ports also supply owner revisions. */
 	step: number;
 	revisions?: ScopeRevisions;
@@ -132,12 +134,12 @@ export interface StateFlowTelegramAdapter {
 
 /** Main-menu section label shows only the current session mode. */
 export function formatStateFlowSectionLabel(snapshot: StateFlowTelegramSnapshot): string {
-	return `🌀 State Flow: ${snapshot.mode}`;
+	return `🌀 State Flow: ${snapshot.mode}${snapshot.mode === "active" && snapshot.inferenceBlocked ? " (blocked)" : ""}`;
 }
 
 export const STATE_FLOW_MODES = ["off", "passive", "active"] as const satisfies readonly StateFlowMode[];
 const STATE_FLOW_MODE_LABELS: Record<StateFlowMode, string> = { off: "Off", passive: "Passive", active: "Active" };
-const STATE_FLOW_SELECTED_MARKERS: Record<StateFlowMode, string> = { off: "🟡", passive: "🟣", active: "🟢" };
+const STATE_FLOW_SELECTED_MARKERS: Record<StateFlowMode, string> = { off: "🟣", passive: "🟡", active: "🟢" };
 
 function isStateFlowModeAction(value: string): value is StateFlowMode {
 	return (STATE_FLOW_MODES as readonly string[]).includes(value);
@@ -160,6 +162,10 @@ export function buildStateFlowSectionView(
 	return {
 		text: [
 			`<b>🌀 State Flow:</b> <code>${snapshot.mode}</code>`,
+			...(snapshot.mode === "active" && snapshot.inferenceBlocked ? [
+				"",
+				"<b>Inference blocked:</b> Active memory restoration failed. Select Active to accept current session memory, or Passive/Off to permit native context.",
+			] : []),
 			"",
 			"<b>Mode</b> — choose a workflow (switching modes never erases stored memory):",
 			"",

package/node_modules/@llblab/pi-state-flow/lib/temporal.ts

@@ -235,42 +235,6 @@ export function constrainTemporalState(view: TemporalState, historyLimit: number
 	return next;
 }
 
-/** Select one scope at a proven retained boundary from its owning runtime lineage. */
-export function selectScopeStreamAtBoundary(stream: ScopeStream, scope: StateScope, boundary: TransitionBoundary, historyLimit = DEFAULT_HISTORY_LIMIT): ScopeStream {
-	validateHistoryLimit(historyLimit);
-	validateBoundary(boundary);
-	validateScopeStream(stream, scope, historyLimit);
-	if (boundary.position < stream.checkpoint.through.position) {
-		throw new Error("Selected State Flow history boundary predates the retained scope checkpoint");
-	}
-	const selected = structuredClone(stream);
-	const retained = selected.patches.filter(({ transition }) => transition.position <= boundary.position);
-	selected.revision -= selected.patches.length - retained.length;
-	selected.patches = retained;
-	validateScopeStream(selected, scope, historyLimit);
-	return selected;
-}
-
-/** Select one still-retained causal boundary without consulting an external history store. */
-export function selectTemporalStateBoundary(view: TemporalState, boundaryId: string, historyLimit = DEFAULT_HISTORY_LIMIT): TemporalState {
-	validateHistoryLimit(historyLimit);
-	validateTemporalState(view, historyLimit);
-	if (typeof boundaryId !== "string" || boundaryId.trim().length === 0) throw new Error("State Flow temporal boundary identity must be non-empty");
-	const index = view.lineage.findIndex(({ id }) => id === boundaryId);
-	if (index < 0) throw new Error("Selected State Flow history boundary is outside the retained temporal window");
-	const target = view.lineage[index]!;
-	const selected = structuredClone(view);
-	selected.lineage = selected.lineage.slice(0, index + 1);
-	for (const scope of SCOPES) {
-		const stream = selected.scopes[scope];
-		const retained = stream.patches.filter(({ transition }) => transition.position <= target.position);
-		stream.revision -= stream.patches.length - retained.length;
-		stream.patches = retained;
-	}
-	validateTemporalState(selected, historyLimit);
-	return selected;
-}
-
 /** Current independent scope revisions; Effective uses this vector rather than inventing a scalar owner. */
 export function temporalScopeRevisions(view: TemporalState): ScopeRevisions {
 	const revisions = {

package/node_modules/@llblab/pi-state-flow/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-state-flow",
-  "version": "0.25.5",
+  "version": "0.26.1",
   "license": "MIT",
   "private": false,
   "description": "Incremental scoped state/context/memory compiler for Pi, inspired by SKILL.state",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-kit",
-  "version": "0.28.0",
+  "version": "0.29.1",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -46,7 +46,7 @@
     "@llblab/pi-clean-room": "0.3.0",
     "@llblab/pi-codex-usage": "0.12.1",
     "@llblab/pi-grow-loop": "0.9.0",
-    "@llblab/pi-state-flow": "0.25.5",
+    "@llblab/pi-state-flow": "0.26.1",
     "@llblab/pi-telegram": "0.52.0",
     "@llblab/skills": "1.15.0"
   },