@llblab/pi-kit 0.17.0 → 0.17.1

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to `@llblab/pi-kit` are documented here.
 
+## 0.17.1 - 2026-09-18
+
+- `State Flow Activation Hotfixes`: Advances the exact State Flow pin to `0.16.2`, allowing resumed activation to reassert its selected session cohort and allowing passive global memory before a new CWD has materialized, while retaining fail-closed handling for genuinely incomplete ownership.
+- `Package Cohort`: Keeps every other bundled package at its current exact version; the package set, resource inventory, and explicit load order remain unchanged.
+
 ## 0.17.0 - 2026-09-18
 
 - `Proportional State Flow Guidance`: Advances the exact State Flow pin to `0.16.0`, adding the focused operational Skill, compacting memory curation guidance, and returning bounded reactive diagnostics for missing paths with durable references.

package/README.md

@@ -14,7 +14,7 @@ Package links lead to the owning repositories for usage, documentation, issues,
 | [`@llblab/pi-clean-room`](https://github.com/llblab/pi-clean-room) | `0.1.1` | Isolated nested Pi TUI with explicitly selected extensions |
 | [`@llblab/pi-codex-usage`](https://github.com/llblab/pi-codex-usage) | `0.10.0` | Compact Codex/Spark subscription-limit and Business credit-usage status |
 | [`@llblab/pi-grow-loop`](https://github.com/llblab/pi-grow-loop) | `0.8.1` | Visible continuation scheduling and bounded worker Skills |
-| [`@llblab/pi-state-flow`](https://github.com/llblab/pi-state-flow) | `0.16.0` | Incremental scoped state/context/memory compiler with proportional operational guidance, intentional agency, reactive dangling-reference diagnostics, compiled runtime delivery, safe compaction, and exact publication |
+| [`@llblab/pi-state-flow`](https://github.com/llblab/pi-state-flow) | `0.16.2` | Incremental scoped state/context/memory compiler with proportional operational guidance, intentional agency, reactive dangling-reference diagnostics, compiled runtime delivery, safe compaction, and exact publication |
 | [`@llblab/pi-telegram`](https://github.com/llblab/pi-telegram) | `0.49.0` | Telegram companion with native fresh-session replacement, adaptive Thread continuity, exact queues, files, voice, controls, and Generative Apps guidance |
 | [`@llblab/skills`](https://github.com/llblab/skills) | `1.15.0` | Portable workflows for engineering, review, design, context maintenance, and other focused tasks |
 

package/node_modules/@llblab/pi-state-flow/CHANGELOG.md

@@ -4,6 +4,14 @@
 
 ## Unreleased
 
+## 0.16.2: Passive first-CWD memory hotfix
+
+- `Passive first-CWD memory`: Treats global-only storage as a valid passive-memory state before the current CWD has ever materialized, projecting an empty CWD overlay instead of warning that shared storage is incomplete; CWD-without-global storage still fails closed.
+
+## 0.16.1: Resumed activation hotfix
+
+- `Resumed activation`: Reasserts the selected session stream as a complete semantic cohort when `/state-flow-start` enables a resumed branch, so extension upgrades cannot misclassify retained session state as an omitted write while shared scopes still reconcile against their live owners.
+
 ## 0.16.0: Proportional State Flow guidance
 
 - `Operational Skill`: Adds the packaged `state-flow-guide` as an on-demand reference for concrete read, patch, inheritance, acquisition, finalization, and recovery problems without triggering memory audits or unsolicited cleanup.

package/node_modules/@llblab/pi-state-flow/dist/lib/extension.js

@@ -757,8 +757,11 @@ export default function stateFlowExtension(pi, options = {}) {
                 snapshot.meta.remotePublication = serializeRemotePublicationPolicyDocument(resolveRemotePublicationPolicy(existingBranch ? undefined : config.remotePublication, { legacyRuntime: existingBranch }));
             }
             branchHasSnapshot = true;
+            // Activation reasserts the selected session stream as a complete cohort. A resumed
+            // branch may have no reusable temporal revision after an extension upgrade; a
+            // runtime-only write would then reject its selected session as an omitted change.
             const publication = runtime.view
-                ? runtime.promote(snapshot) ?? runtime.publish(snapshot)
+                ? runtime.promote(snapshot) ?? runtime.publish(snapshot, true)
                 : runtime.initialize(snapshot, true, undefined, branchStartsWithoutRuntime);
             recordPolicyPublication(publication, ctx);
             installScopeStates();

package/node_modules/@llblab/pi-state-flow/dist/lib/runtime.js

@@ -110,11 +110,12 @@ export class TemporalRuntime {
         }));
         if (!shared.global && !shared.cwd)
             return false;
-        if (!shared.global || !shared.cwd)
-            throw new Error("Incomplete passive State Flow shared storage");
+        if (!shared.global)
+            throw new Error("Incomplete passive State Flow shared storage: CWD state exists without global state");
         const fresh = createTemporalState({ global: emptyState(), cwd: emptyState(), session: emptyState() }, randomUUID());
         const basis = backend === "git" ? base.head ?? "unborn" : "files";
-        this.view = adoptTemporalStreams({ global: shared.global, cwd: shared.cwd, session: fresh.scopes.session }, `passive:${basis}:${randomUUID()}`);
+        // Global memory is valid before this CWD has ever materialized its own scope.
+        this.view = adoptTemporalStreams({ global: shared.global, cwd: shared.cwd ?? fresh.scopes.cwd, session: fresh.scopes.session }, `passive:${basis}:${randomUUID()}`);
         this.base = base;
         this.backend = backend;
         this.provenanceByScope = {

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

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-state-flow",
-  "version": "0.16.0",
+  "version": "0.16.2",
   "private": false,
   "description": "Incremental scoped state/context/memory compiler for Pi, inspired by SKILL.state",
   "keywords": [

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

@@ -782,8 +782,11 @@ export default function stateFlowExtension(pi: ExtensionAPI, options: StateFlowE
 				);
 			}
 			branchHasSnapshot = true;
+			// Activation reasserts the selected session stream as a complete cohort. A resumed
+			// branch may have no reusable temporal revision after an extension upgrade; a
+			// runtime-only write would then reject its selected session as an omitted change.
 			const publication = runtime.view
-				? runtime.promote(snapshot) ?? runtime.publish(snapshot)
+				? runtime.promote(snapshot) ?? runtime.publish(snapshot, true)
 				: runtime.initialize(snapshot, true, undefined, branchStartsWithoutRuntime);
 			recordPolicyPublication(publication, ctx);
 			installScopeStates();

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

@@ -128,10 +128,11 @@ export class TemporalRuntime {
 				scope === "cwd" ? this.cwd : undefined, files.get(paths.meta))];
 		})) as Record<(typeof SHARED_SCOPES)[number], ScopeStream | undefined>;
 		if (!shared.global && !shared.cwd) return false;
-		if (!shared.global || !shared.cwd) throw new Error("Incomplete passive State Flow shared storage");
+		if (!shared.global) throw new Error("Incomplete passive State Flow shared storage: CWD state exists without global state");
 		const fresh = createTemporalState({ global: emptyState(), cwd: emptyState(), session: emptyState() }, randomUUID());
 		const basis = backend === "git" ? (base as TemporalGitBase).head ?? "unborn" : "files";
-		this.view = adoptTemporalStreams({ global: shared.global, cwd: shared.cwd, session: fresh.scopes.session }, `passive:${basis}:${randomUUID()}`);
+		// Global memory is valid before this CWD has ever materialized its own scope.
+		this.view = adoptTemporalStreams({ global: shared.global, cwd: shared.cwd ?? fresh.scopes.cwd, session: fresh.scopes.session }, `passive:${basis}:${randomUUID()}`);
 		this.base = base;
 		this.backend = backend;
 		this.provenanceByScope = {

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

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-state-flow",
-  "version": "0.16.0",
+  "version": "0.16.2",
   "private": false,
   "description": "Incremental scoped state/context/memory compiler for Pi, inspired by SKILL.state",
   "keywords": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-kit",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -44,7 +44,7 @@
     "@llblab/pi-clean-room": "0.1.1",
     "@llblab/pi-codex-usage": "0.10.0",
     "@llblab/pi-grow-loop": "0.8.1",
-    "@llblab/pi-state-flow": "0.16.0",
+    "@llblab/pi-state-flow": "0.16.2",
     "@llblab/pi-telegram": "0.49.0",
     "@llblab/skills": "1.15.0"
   },