@davidorex/pi-context 0.26.0 → 0.28.0

package/samples/schemas/layer-plans.schema.json

@@ -1,54 +1,125 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "pi-context://schemas/layer-plans",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "title": "Layer Restructure Plans",
   "description": "Plans for restructuring the .project/ directory from flat-block storage into a layered artifact-ownership model. Each plan names its conceptual source (e.g. Muni five-layer), describes each layer's purpose and its current-vs-target block mapping, and sequences the enactment into phases with exit criteria. Layer plans are themselves L2 specification-layer artifacts — they are spec-level decisions about how the framework organizes project state.",
   "type": "object",
-  "required": ["plans"],
+  "required": [
+    "plans"
+  ],
   "properties": {
     "plans": {
       "type": "array",
       "items": {
         "type": "object",
         "additionalProperties": false,
-        "required": ["id", "title", "status", "model", "layers", "migration_phases", "created_by", "created_at"],
+        "required": [
+          "id",
+          "title",
+          "status",
+          "model",
+          "layers",
+          "migration_phases",
+          "created_by",
+          "created_at"
+        ],
         "properties": {
-          "id": { "type": "string", "pattern": "^PLAN-\\d{3}$" },
-          "title": { "type": "string" },
+          "id": {
+            "type": "string",
+            "pattern": "^PLAN-\\d{3}$"
+          },
+          "title": {
+            "type": "string"
+          },
           "status": {
             "type": "string",
-            "enum": ["draft", "proposed", "decided", "in-progress", "complete", "abandoned"]
+            "enum": [
+              "draft",
+              "proposed",
+              "decided",
+              "in-progress",
+              "complete",
+              "abandoned"
+            ]
+          },
+          "model": {
+            "type": "string",
+            "description": "Conceptual source — e.g. 'Muni five-layer'"
+          },
+          "description": {
+            "type": "string",
+            "x-prompt-budget": {
+              "tokens": 1000,
+              "words": 800
+            }
           },
-          "model": { "type": "string", "description": "Conceptual source — e.g. 'Muni five-layer'" },
-          "description": { "type": "string", "x-prompt-budget": { "tokens": 1000, "words": 800 } },
           "layers": {
             "type": "array",
             "items": {
               "type": "object",
               "additionalProperties": false,
-              "required": ["id", "name", "purpose", "current_blocks", "target_blocks"],
+              "required": [
+                "id",
+                "name",
+                "purpose",
+                "current_blocks",
+                "target_blocks"
+              ],
               "properties": {
-                "id": { "type": "string" },
-                "name": { "type": "string" },
-                "purpose": { "type": "string", "x-prompt-budget": { "tokens": 1000, "words": 800 } },
-                "canonical_vocabulary": { "type": "string" },
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "purpose": {
+                  "type": "string",
+                  "x-prompt-budget": {
+                    "tokens": 1000,
+                    "words": 800
+                  }
+                },
+                "canonical_vocabulary": {
+                  "type": "string"
+                },
                 "lifetime": {
                   "type": "string",
                   "description": "Cadence at which this layer changes — project-lifetime, per-design-cycle, per-iteration, per-session, ever-accumulating"
                 },
-                "ownership_principle": { "type": "string", "x-prompt-budget": { "tokens": 1000, "words": 800 } },
-                "current_blocks": { "type": "array", "items": { "type": "string" } },
+                "ownership_principle": {
+                  "type": "string",
+                  "x-prompt-budget": {
+                    "tokens": 1000,
+                    "words": 800
+                  }
+                },
+                "current_blocks": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
                 "target_blocks": {
                   "type": "array",
                   "items": {
                     "type": "object",
                     "additionalProperties": false,
-                    "required": ["name", "shape"],
+                    "required": [
+                      "name",
+                      "shape"
+                    ],
                     "properties": {
-                      "name": { "type": "string" },
-                      "shape": { "type": "string", "description": "flat | nested | materialized-view" },
-                      "notes": { "type": "string" }
+                      "name": {
+                        "type": "string"
+                      },
+                      "shape": {
+                        "type": "string",
+                        "description": "flat | nested | materialized-view"
+                      },
+                      "notes": {
+                        "type": "string"
+                      }
                     }
                   }
                 }
@@ -60,33 +131,122 @@
             "items": {
               "type": "object",
               "additionalProperties": false,
-              "required": ["id", "name", "description", "depends_on", "exit_criteria"],
+              "required": [
+                "id",
+                "name",
+                "description",
+                "depends_on",
+                "exit_criteria"
+              ],
               "properties": {
-                "id": { "type": "string" },
-                "name": { "type": "string" },
-                "description": { "type": "string", "x-prompt-budget": { "tokens": 1000, "words": 800 } },
-                "depends_on": { "type": "array", "items": { "type": "string" } },
-                "exit_criteria": { "type": "array", "items": { "type": "string", "x-prompt-budget": { "tokens": 1000, "words": 800 } } },
-                "produces": { "type": "array", "items": { "type": "string" } },
-                "status": { "type": "string", "enum": ["pending", "in-progress", "complete", "blocked"] }
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "description": {
+                  "type": "string",
+                  "x-prompt-budget": {
+                    "tokens": 1000,
+                    "words": 800
+                  }
+                },
+                "depends_on": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "exit_criteria": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "x-prompt-budget": {
+                      "tokens": 1000,
+                      "words": 800
+                    }
+                  }
+                },
+                "produces": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "status": {
+                  "type": "string",
+                  "enum": [
+                    "pending",
+                    "in-progress",
+                    "complete",
+                    "blocked"
+                  ]
+                }
               }
             }
           },
-          "created_by": { "type": "string" },
-          "created_at": { "type": "string" }
+          "created_by": {
+            "type": "string"
+          },
+          "created_at": {
+            "type": "string"
+          },
+          "oid": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{32}$",
+            "description": "Content-independent substrate-stable item identity (content-addressed substrate identity, Cycle 3). Minted once at item birth via mintOid(substrate_id); immutable across content versions. Optional in the schema so pre-Cycle-3 items validate; stamped on next write."
+          },
+          "content_hash": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{64}$",
+            "description": "SHA-256 (hex) of the RFC-8785-canonical content projection of this item (metadata fields excluded). Recomputed on every stamping write; moves with content, stable across metadata-only churn."
+          },
+          "content_parent": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{64}$",
+            "description": "content_hash of the immediately-prior version of this item; set on a content-changing update, absent on the first (v1) version. Forms the per-item content version chain."
+          }
         }
       }
     }
   },
   "x-lifecycle": {
     "field": "status",
-    "states": ["draft", "proposed", "decided", "in-progress", "complete", "abandoned"],
+    "states": [
+      "draft",
+      "proposed",
+      "decided",
+      "in-progress",
+      "complete",
+      "abandoned"
+    ],
     "transitions": [
-      { "from": "draft", "to": "proposed", "required_authority": "any" },
-      { "from": "proposed", "to": "decided", "required_authority": "user" },
-      { "from": "decided", "to": "in-progress", "required_authority": "any" },
-      { "from": "in-progress", "to": "complete", "required_authority": "any" },
-      { "from": "draft", "to": "abandoned", "required_authority": "user" }
+      {
+        "from": "draft",
+        "to": "proposed",
+        "required_authority": "any"
+      },
+      {
+        "from": "proposed",
+        "to": "decided",
+        "required_authority": "user"
+      },
+      {
+        "from": "decided",
+        "to": "in-progress",
+        "required_authority": "any"
+      },
+      {
+        "from": "in-progress",
+        "to": "complete",
+        "required_authority": "any"
+      },
+      {
+        "from": "draft",
+        "to": "abandoned",
+        "required_authority": "user"
+      }
     ]
   }
 }

package/samples/schemas/phase.schema.json

@@ -1,9 +1,9 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "pi-context://schemas/phase",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "title": "Phases",
-  "description": "Array-block of planned implementation phases (DEC-0028). Each phase carries a PHASE-NNN string id, intent, optional goal, success criteria, decomposed specs, and status lifecycle (planned, in-progress, completed). Inter-phase dependencies live in relations.json edges, not inline.",
+  "description": "Array-block of planned implementation phases. Each phase carries a PHASE-NNN string id, intent, optional goal, success criteria, decomposed specs, and status lifecycle (planned, in-progress, completed). Inter-phase dependencies live in relations.json edges, not inline.",
   "type": "object",
   "required": [
     "phases"
@@ -25,7 +25,7 @@
           "id": {
             "type": "string",
             "pattern": "^PHASE-[A-Z0-9-]+$",
-            "description": "Canonical phase id (e.g. PHASE-001). Replaces the integer `number` discriminator of the file-per-phase form."
+            "description": "Canonical phase id (e.g.). Replaces the integer `number` discriminator of the file-per-phase form."
           },
           "name": {
             "type": "string"
@@ -110,6 +110,21 @@
             "items": {
               "type": "string"
             }
+          },
+          "oid": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{32}$",
+            "description": "Content-independent substrate-stable item identity (content-addressed substrate identity, Cycle 3). Minted once at item birth via mintOid(substrate_id); immutable across content versions. Optional in the schema so pre-Cycle-3 items validate; stamped on next write."
+          },
+          "content_hash": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{64}$",
+            "description": "SHA-256 (hex) of the RFC-8785-canonical content projection of this item (metadata fields excluded). Recomputed on every stamping write; moves with content, stable across metadata-only churn."
+          },
+          "content_parent": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{64}$",
+            "description": "content_hash of the immediately-prior version of this item; set on a content-changing update, absent on the first (v1) version. Forms the per-item content version chain."
           }
         }
       }

package/samples/schemas/rationale.schema.json

@@ -1,22 +1,52 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "pi-context://schemas/rationale",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "title": "Design Rationale",
   "description": "The deeper reasoning behind decisions — why this approach over others, what constraints drove the choice, what tradeoffs were accepted.",
   "type": "object",
-  "required": ["rationales"],
+  "required": [
+    "rationales"
+  ],
   "properties": {
     "rationales": {
       "type": "array",
       "items": {
         "type": "object",
-        "required": ["id", "title", "narrative"],
+        "required": [
+          "id",
+          "title",
+          "narrative"
+        ],
         "properties": {
-          "id": { "type": "string", "pattern": "^RAT-\\d{3}$" },
-          "title": { "type": "string" },
-          "narrative": { "type": "string" },
-          "phase": { "type": "integer" }
+          "id": {
+            "type": "string",
+            "pattern": "^RAT-\\d{3}$"
+          },
+          "title": {
+            "type": "string"
+          },
+          "narrative": {
+            "type": "string"
+          },
+          "phase": {
+            "type": "integer"
+          },
+          "oid": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{32}$",
+            "description": "Content-independent substrate-stable item identity (content-addressed substrate identity, Cycle 3). Minted once at item birth via mintOid(substrate_id); immutable across content versions. Optional in the schema so pre-Cycle-3 items validate; stamped on next write."
+          },
+          "content_hash": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{64}$",
+            "description": "SHA-256 (hex) of the RFC-8785-canonical content projection of this item (metadata fields excluded). Recomputed on every stamping write; moves with content, stable across metadata-only churn."
+          },
+          "content_parent": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{64}$",
+            "description": "content_hash of the immediately-prior version of this item; set on a content-changing update, absent on the first (v1) version. Forms the per-item content version chain."
+          }
         }
       }
     }

package/samples/schemas/requirements.schema.json

@@ -1,31 +1,98 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "pi-context://schemas/requirements",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "title": "Requirements",
   "description": "What the project must deliver. Functional and non-functional requirements with MoSCoW priority and lifecycle states (proposed, accepted, implemented, verified). The contract between intent and implementation.",
   "type": "object",
-  "required": ["requirements"],
+  "required": [
+    "requirements"
+  ],
   "properties": {
     "requirements": {
       "type": "array",
       "items": {
         "type": "object",
-        "required": ["id", "description", "type", "status", "priority"],
+        "required": [
+          "id",
+          "description",
+          "type",
+          "status",
+          "priority"
+        ],
         "properties": {
-          "id": { "type": "string", "pattern": "^REQ-\\d{3,}$" },
-          "description": { "type": "string", "x-prompt-budget": { "tokens": 1000, "words": 800 } },
-          "type": { "type": "string", "enum": ["functional", "non-functional", "constraint", "integration"] },
-          "status": { "type": "string", "enum": ["proposed", "accepted", "deferred", "implemented", "verified"] },
-          "priority": { "type": "string", "enum": ["must", "should", "could", "wont"] },
+          "id": {
+            "type": "string",
+            "pattern": "^REQ-\\d{3,}$"
+          },
+          "description": {
+            "type": "string",
+            "x-prompt-budget": {
+              "tokens": 1000,
+              "words": 800
+            }
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "functional",
+              "non-functional",
+              "constraint",
+              "integration"
+            ]
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "proposed",
+              "accepted",
+              "deferred",
+              "implemented",
+              "verified"
+            ]
+          },
+          "priority": {
+            "type": "string",
+            "enum": [
+              "must",
+              "should",
+              "could",
+              "wont"
+            ]
+          },
           "acceptance_criteria": {
             "type": "array",
-            "items": { "type": "string", "x-prompt-budget": { "tokens": 1000, "words": 800 } }
+            "items": {
+              "type": "string",
+              "x-prompt-budget": {
+                "tokens": 1000,
+                "words": 800
+              }
+            }
           },
           "source": {
             "type": "string",
-            "enum": ["human", "agent", "analysis"],
+            "enum": [
+              "human",
+              "agent",
+              "analysis"
+            ],
             "description": "How this requirement was created"
+          },
+          "oid": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{32}$",
+            "description": "Content-independent substrate-stable item identity (content-addressed substrate identity, Cycle 3). Minted once at item birth via mintOid(substrate_id); immutable across content versions. Optional in the schema so pre-Cycle-3 items validate; stamped on next write."
+          },
+          "content_hash": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{64}$",
+            "description": "SHA-256 (hex) of the RFC-8785-canonical content projection of this item (metadata fields excluded). Recomputed on every stamping write; moves with content, stable across metadata-only churn."
+          },
+          "content_parent": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{64}$",
+            "description": "content_hash of the immediately-prior version of this item; set on a content-changing update, absent on the first (v1) version. Forms the per-item content version chain."
           }
         }
       }