@arbiterforge/ca-pi 0.20.0 → 0.21.0

package/README.md

@@ -10,7 +10,7 @@ and durable project context. You decide. codeArbiter enforces.
 <img alt="Claude Code plugin" src="https://img.shields.io/badge/Claude_Code-plugin-d97757">
 <img alt="Codex plugin" src="https://img.shields.io/badge/OpenAI_Codex-plugin-10a37f">
 <img alt="Pi Feature Forge preview" src="https://img.shields.io/badge/ca--pi-Feature_Forge_preview-d97757">
-<img alt="version 3.1.0" src="https://img.shields.io/badge/version-3.1.0-2b7489">
+<img alt="version 3.2.0" src="https://img.shields.io/badge/version-3.2.0-2b7489">
 <img alt="core lanes" src="https://img.shields.io/badge/core_lanes-18-555">
 <img alt="skills" src="https://img.shields.io/badge/skills-22-555">
 <img alt="agents" src="https://img.shields.io/badge/agents-20-555">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbiterforge/ca-pi",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "license": "AGPL-3.0-only",
   "repository": {
     "type": "git",

package/plugins/ca-pi/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to `ca-pi` are documented in this file.
 
 ## [Unreleased]
 
+## [0.21.0] - 2026-10-18
+
+### Added
+
+- A new `init-store` engine operation creates a checkout's local artifact store metadata on purpose, and only that. On Windows, a fresh clone or worktree reports `NO_LOCAL_STORE` on every read until the store exists; the host bridge now runs `init-store` once and retries the read once, so `/feature` and `/sprint` resume work in a new checkout. Reads themselves still never write, and a read-only checkout still gets `NO_LOCAL_STORE`.
+
+## [0.20.1] - 2026-10-18
+
+### Fixed
+
+- A spec whose design had only one sane approach recorded its SMARTS rationale with not-applicable filler for every rationale part, because the rationale convention listed all parts unconditionally. The convention now applies the multi-part rationale only when a comparison ran; a single-option choice records exactly one block, its one-line statement and reason. Found by a live `/feature` run.
+- The SMARTS rationale convention and the spec-compliance reviewer no longer describe the rationale as belonging to an "approved" spec, since 3.0.0 retired spec approval.
+
 ## [0.20.0] - 2026-10-17
 
 ### Added

package/plugins/ca-pi/helpers/artifacts/release.json

@@ -6,43 +6,43 @@
   "binaries": {
     "darwin/amd64": {
       "file": "ca-artifact-darwin-amd64",
-      "sha256": "ca6dc89a106f4b79eb2ab992eb7617c79742f88eb3d5d9b0444102ecf3f23ed3",
+      "sha256": "882fefc23bd4b07dcf8f954a2e3cdaecffe210d8bd95e190d2864d9eb77aa339",
       "native_tested": true
     },
     "darwin/arm64": {
       "file": "ca-artifact-darwin-arm64",
-      "sha256": "04dae5874b003fb5530a460c3d9ce6da8284ca7bbfb886e6b6591d0e2980934d",
+      "sha256": "8f51bd9848e4b0441eea50c8f4e2da9892164be0488ca3959a8dc900dc295020",
       "native_tested": true
     },
     "linux/amd64": {
       "file": "ca-artifact-linux-amd64",
-      "sha256": "1b2d858cf64e7774cbc2abf8abe7921c5f9fe147fcee796e70dbe38478272847",
+      "sha256": "0f24a4f79a2554c37deabf9ec81d6dfbceb45030f4bea3cfabc33dc51ed1d582",
       "native_tested": true
     },
     "linux/arm64": {
       "file": "ca-artifact-linux-arm64",
-      "sha256": "37e592fb61297850b17e2cd6c603a203143940b42b04e7a285f081b0d9d848e5",
+      "sha256": "c7cb1e636b3abd3284a7fbc3354bdc556414aec2aacc92665431118f723a86b0",
       "native_tested": true
     },
     "windows/amd64": {
       "file": "ca-artifact-windows-amd64.exe",
-      "sha256": "4f4b3f4cf0ab7230f9cd577a3310a293007af1126913224c8e6103438aaafc8b",
+      "sha256": "7bfdc9a86320e38932d84ee3fef6d088d548809b16dfc17dd648f64e4105471b",
       "native_tested": true
     },
     "windows/arm64": {
       "file": "ca-artifact-windows-arm64.exe",
-      "sha256": "855bfbd1c628a0b76cfa5bdf7d6ff392fb55e49dba23efb13e2a7a26d9e5ccb4",
+      "sha256": "095bf92bca707c0027c54e929b1d08c62cb97b0b2888cfbe07a3ea49ea0fb8b3",
       "native_tested": true
     }
   },
   "context_qualification": {
     "darwin/amd64": {
-      "source_commit": "44149055d1ca136e191f79136244f0d3a2b1a461",
+      "source_commit": "020f67947c4c0fb299a9e9d77a9b9354e3ff2ed4",
       "workflow": ".github/workflows/ci.yml",
-      "run_id": "39097065693",
-      "binary_sha256": "ca6dc89a106f4b79eb2ab992eb7617c79742f88eb3d5d9b0444102ecf3f23ed3",
-      "observation_sha256": "178ac16ede5052a25eff69597ef2c6ab30439bcfd3d9127a1189e9eaa7a6147e",
-      "module_sha256": "a34f09f52c52145624e87c1d5e3850c822dd1ca54c346c5ad63802f6e5a0d0b3",
+      "run_id": "39186858332",
+      "binary_sha256": "882fefc23bd4b07dcf8f954a2e3cdaecffe210d8bd95e190d2864d9eb77aa339",
+      "observation_sha256": "fdeac588d567329a64b6315456d8c47e060c70dbe9355d76be3c07ec40bd8705",
+      "module_sha256": "b39a694ff5283a97c62d532a8abc25a8a47101baa7dfc025bffc90c1da9d9144",
       "native_cases": [
         "TestContextBoundedRender",
         "TestContextDocumentContract",
@@ -53,12 +53,12 @@
       ]
     },
     "darwin/arm64": {
-      "source_commit": "44149055d1ca136e191f79136244f0d3a2b1a461",
+      "source_commit": "020f67947c4c0fb299a9e9d77a9b9354e3ff2ed4",
       "workflow": ".github/workflows/ci.yml",
-      "run_id": "39097065693",
-      "binary_sha256": "04dae5874b003fb5530a460c3d9ce6da8284ca7bbfb886e6b6591d0e2980934d",
-      "observation_sha256": "c7a246aafb77097d60704ecae57abcd7a8786078144de3549475684cd93c1fc2",
-      "module_sha256": "a34f09f52c52145624e87c1d5e3850c822dd1ca54c346c5ad63802f6e5a0d0b3",
+      "run_id": "39186858332",
+      "binary_sha256": "8f51bd9848e4b0441eea50c8f4e2da9892164be0488ca3959a8dc900dc295020",
+      "observation_sha256": "f4b6ff84048f95a0c36ba839caad39a15ac493305b7212b5597333ed6e59c9f0",
+      "module_sha256": "b39a694ff5283a97c62d532a8abc25a8a47101baa7dfc025bffc90c1da9d9144",
       "native_cases": [
         "TestContextBoundedRender",
         "TestContextDocumentContract",
@@ -69,12 +69,12 @@
       ]
     },
     "linux/amd64": {
-      "source_commit": "44149055d1ca136e191f79136244f0d3a2b1a461",
+      "source_commit": "020f67947c4c0fb299a9e9d77a9b9354e3ff2ed4",
       "workflow": ".github/workflows/ci.yml",
-      "run_id": "39097065693",
-      "binary_sha256": "1b2d858cf64e7774cbc2abf8abe7921c5f9fe147fcee796e70dbe38478272847",
-      "observation_sha256": "f2725ba4c6ef48d36fb92962ef1fc6b00871e057a3234010ab0066a844bf21fd",
-      "module_sha256": "a34f09f52c52145624e87c1d5e3850c822dd1ca54c346c5ad63802f6e5a0d0b3",
+      "run_id": "39186858332",
+      "binary_sha256": "0f24a4f79a2554c37deabf9ec81d6dfbceb45030f4bea3cfabc33dc51ed1d582",
+      "observation_sha256": "15afed41ddcddfccecc0a49875e5f7b1b8a69e80311f06b5f351e4e0dc02db7d",
+      "module_sha256": "b39a694ff5283a97c62d532a8abc25a8a47101baa7dfc025bffc90c1da9d9144",
       "native_cases": [
         "TestContextBoundedRender",
         "TestContextDocumentContract",
@@ -85,12 +85,12 @@
       ]
     },
     "linux/arm64": {
-      "source_commit": "44149055d1ca136e191f79136244f0d3a2b1a461",
+      "source_commit": "020f67947c4c0fb299a9e9d77a9b9354e3ff2ed4",
       "workflow": ".github/workflows/ci.yml",
-      "run_id": "39097065693",
-      "binary_sha256": "37e592fb61297850b17e2cd6c603a203143940b42b04e7a285f081b0d9d848e5",
-      "observation_sha256": "3c0cae7073c8e7cf7ba6e40da4a04fad9d623a87914e44dac3b6e329d0dd020a",
-      "module_sha256": "a34f09f52c52145624e87c1d5e3850c822dd1ca54c346c5ad63802f6e5a0d0b3",
+      "run_id": "39186858332",
+      "binary_sha256": "c7cb1e636b3abd3284a7fbc3354bdc556414aec2aacc92665431118f723a86b0",
+      "observation_sha256": "5a6a057bcd8a1a194d890a24c570a21d37029e418bcc856b66acf5b69357ba9f",
+      "module_sha256": "b39a694ff5283a97c62d532a8abc25a8a47101baa7dfc025bffc90c1da9d9144",
       "native_cases": [
         "TestContextBoundedRender",
         "TestContextDocumentContract",
@@ -101,12 +101,12 @@
       ]
     },
     "windows/amd64": {
-      "source_commit": "44149055d1ca136e191f79136244f0d3a2b1a461",
+      "source_commit": "020f67947c4c0fb299a9e9d77a9b9354e3ff2ed4",
       "workflow": ".github/workflows/ci.yml",
-      "run_id": "39097065693",
-      "binary_sha256": "4f4b3f4cf0ab7230f9cd577a3310a293007af1126913224c8e6103438aaafc8b",
-      "observation_sha256": "3ad94468cbd6eaf40500b525859923feaa5fbb120f91b3aadcc08b08ae837fc9",
-      "module_sha256": "a34f09f52c52145624e87c1d5e3850c822dd1ca54c346c5ad63802f6e5a0d0b3",
+      "run_id": "39186858332",
+      "binary_sha256": "7bfdc9a86320e38932d84ee3fef6d088d548809b16dfc17dd648f64e4105471b",
+      "observation_sha256": "fc8ec82f4212b5f35e3ed2ef59691f3542facfca9482c44daaeb2a79ffe06e57",
+      "module_sha256": "b39a694ff5283a97c62d532a8abc25a8a47101baa7dfc025bffc90c1da9d9144",
       "native_cases": [
         "TestContextBoundedRender",
         "TestContextDocumentContract",
@@ -117,12 +117,12 @@
       ]
     },
     "windows/arm64": {
-      "source_commit": "44149055d1ca136e191f79136244f0d3a2b1a461",
+      "source_commit": "020f67947c4c0fb299a9e9d77a9b9354e3ff2ed4",
       "workflow": ".github/workflows/ci.yml",
-      "run_id": "39097065693",
-      "binary_sha256": "855bfbd1c628a0b76cfa5bdf7d6ff392fb55e49dba23efb13e2a7a26d9e5ccb4",
-      "observation_sha256": "8f594d61907c66818ddae106e859c6ba437713ca4c049468425558751ddb9697",
-      "module_sha256": "a34f09f52c52145624e87c1d5e3850c822dd1ca54c346c5ad63802f6e5a0d0b3",
+      "run_id": "39186858332",
+      "binary_sha256": "095bf92bca707c0027c54e929b1d08c62cb97b0b2888cfbe07a3ea49ea0fb8b3",
+      "observation_sha256": "60a3b695097d8be6dee2c61e452e31b624a393526675bfd16f092222dee87bf6",
+      "module_sha256": "b39a694ff5283a97c62d532a8abc25a8a47101baa7dfc025bffc90c1da9d9144",
       "native_cases": [
         "TestContextBoundedRender",
         "TestContextDocumentContract",

package/plugins/ca-pi/hooks/_artifactlib.py

@@ -977,10 +977,14 @@ def _engine_timeout() -> float:
 
 
 class ArtifactClient:
-    def __init__(self, root: str | Path, installation: str | Path, *, timeout: float | None = None):
+    def __init__(self, root: str | Path, installation: str | Path, *, timeout: float | None = None,
+                 initialize_store: bool = True):
         self.root = _trusted_directory(root, "UNSAFE_ROOT")
         self.installation = _trusted_directory(installation, "CAPABILITY_MISSING")
         self.timeout = _engine_timeout() if timeout is None else timeout
+        # A fresh clone or worktree has no local store, and reads never create
+        # one. With this set, the client creates it once through init-store.
+        self.initialize_store = initialize_store
 
     def workflow_preflight(self) -> dict[str, object]:
         """Read fresh installed prerequisites; never attest live host authority."""
@@ -1074,6 +1078,22 @@ class ArtifactClient:
             raise
 
     def call(self, operation: str, request: dict[str, Any] | None = None, *, permit_invalid: bool = False) -> dict:
+        try:
+            return self._exchange(operation, request, permit_invalid)
+        except ArtifactError as exc:
+            if exc.code != "NO_LOCAL_STORE" or operation == "init-store" or not self.initialize_store:
+                raise
+        # One explicit initialization, then one retry of the original request.
+        try:
+            self._exchange("init-store", {}, False)
+        except ArtifactError as refused:
+            raise ArtifactError(
+                "NO_LOCAL_STORE",
+                f"local artifact store is absent and initialization was refused ({refused.code})",
+            ) from refused
+        return self._exchange(operation, request, permit_invalid)
+
+    def _exchange(self, operation: str, request: dict[str, Any] | None, permit_invalid: bool) -> dict:
         if not re.fullmatch(r"[a-z][a-z-]{0,39}", operation):
             raise ArtifactError("UNKNOWN_OPERATION", "invalid internal operation name")
         if operation in {"context-preview", "context-finalize-preview", "context-apply"}:

package/plugins/ca-pi/hooks/_host.py

@@ -11,7 +11,7 @@ import hostapi  # noqa: E402
 class PiHost(hostapi.Host):
     name = "pi"
     adapter_name = "@arbiterforge/ca-pi"
-    adapter_version = "0.20.0"
+    adapter_version = "0.21.0"
     update_target = "ca-pi"
     update_tag_prefix = "ca-pi-v"
     update_command = "pi update npm:@arbiterforge/ca-pi"

package/plugins/ca-pi/hooks/hostapi.py

@@ -313,7 +313,7 @@ class Host:
 
     name = "claude"
     adapter_name = "ca"
-    adapter_version = "3.1.0"
+    adapter_version = "3.2.0"
 
     # Update-notifier descriptor. Each independently versioned host overrides
     # these three values in its per-plugin _host.py. Keeping the target,

package/plugins/ca-pi/includes/smarts/core.md

@@ -138,17 +138,19 @@ analysis; they supplement, never replace it, and never become a seventh lens.
 
 ## Design rationale record
 
-An approved full-lane spec keeps a concise SMARTS design rationale; it is design evidence, not a
+A full-lane spec keeps a concise SMARTS design rationale; it is design evidence, not a
 source of execution authority. For a typed HTML spec, write it through the existing mutation
 operations with this convention, with no spec-schema change:
 
 - the chosen approach and its trade-off live in the existing `approach` record (`choice`, `tradeoff`);
 - a `decisions` record carries each material decision the SMARTS pass settled, and `approach.binding_decision_refs` cites it;
-- one `sections` record with the fixed id `SEC-SMARTS` (title "SMARTS design rationale") holds one block each for: alternatives considered or the single-option statement; decisive lenses; material Weak and Unknown observations, each Unknown with its missing observation and whether it is decision-critical; load-bearing assumptions; non-SMARTS considerations; and priority evidence when one influenced the recommendation.
+- When a comparison ran, one `sections` record with the fixed id `SEC-SMARTS` (title "SMARTS design rationale") holds one block each for: alternatives considered or the single-option statement; decisive lenses; material Weak and Unknown observations, each Unknown with its missing observation and whether it is decision-critical; load-bearing assumptions; non-SMARTS considerations; and priority evidence when one influenced the recommendation.
+- A single-option choice holds exactly one `SEC-SMARTS` block: its one-line statement and reason, with no other part. Do not pad it with not-applicable lens, assumption or constraint entries.
 
 Read the rationale back with the existing read operations; never hand-edit or parse rendered HTML.
 A legacy Markdown spec keeps the rationale in one stable `## SMARTS design rationale` section that
-carries the same parts in the same order.
+carries the same parts in the same order when a comparison ran, or the single-option statement and
+its reason alone.
 
 ## Worked example
 

package/plugins/ca-pi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbiterforge/ca-pi",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "private": true,
   "license": "AGPL-3.0-only",
   "type": "module",