@davidorex/pi-context 0.26.0 → 0.28.1

package/samples/schemas/features.schema.json

@@ -1,35 +1,112 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "pi-context://schemas/features",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "title": "Features",
   "description": "L3 Work layer. Features with their own scope, acceptance criteria, and status lifecycle. A feature is atomically composable into prompt context as a self-contained unit of work.",
   "type": "object",
-  "required": ["features"],
+  "required": [
+    "features"
+  ],
   "properties": {
     "features": {
       "type": "array",
       "items": {
         "type": "object",
         "additionalProperties": false,
-        "required": ["id", "title", "status", "layer", "description", "acceptance_criteria", "created_by", "created_at"],
+        "required": [
+          "id",
+          "title",
+          "status",
+          "layer",
+          "description",
+          "acceptance_criteria",
+          "created_by",
+          "created_at"
+        ],
         "properties": {
-          "id": { "type": "string", "pattern": "^FEAT-\\d{3}$" },
-          "title": { "type": "string" },
+          "id": {
+            "type": "string",
+            "pattern": "^FEAT-\\d{3}$"
+          },
+          "title": {
+            "type": "string"
+          },
           "status": {
             "type": "string",
-            "enum": ["proposed", "approved", "in-progress", "in-review", "complete", "blocked", "cancelled"]
-          },
-          "layer": { "type": "string", "enum": ["L1", "L2", "L3", "L4", "L5"] },
-          "description": { "type": "string", "x-prompt-budget": { "tokens": 1000, "words": 800 } },
-          "motivation": { "type": "string", "x-prompt-budget": { "tokens": 1000, "words": 800 } },
-          "acceptance_criteria": { "type": "array", "items": { "type": "string" } },
-          "created_by": { "type": "string" },
-          "created_at": { "type": "string" },
-          "modified_by": { "type": "string" },
-          "modified_at": { "type": "string" },
-          "approved_by": { "type": "string" },
-          "approved_at": { "type": "string" }
+            "enum": [
+              "proposed",
+              "approved",
+              "in-progress",
+              "in-review",
+              "complete",
+              "blocked",
+              "cancelled"
+            ]
+          },
+          "layer": {
+            "type": "string",
+            "enum": [
+              "L1",
+              "L2",
+              "L3",
+              "L4",
+              "L5"
+            ]
+          },
+          "description": {
+            "type": "string",
+            "x-prompt-budget": {
+              "tokens": 1000,
+              "words": 800
+            }
+          },
+          "motivation": {
+            "type": "string",
+            "x-prompt-budget": {
+              "tokens": 1000,
+              "words": 800
+            }
+          },
+          "acceptance_criteria": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "created_by": {
+            "type": "string"
+          },
+          "created_at": {
+            "type": "string"
+          },
+          "modified_by": {
+            "type": "string"
+          },
+          "modified_at": {
+            "type": "string"
+          },
+          "approved_by": {
+            "type": "string"
+          },
+          "approved_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."
+          }
         }
       }
     }
@@ -37,17 +114,54 @@
   "x-lifecycle": {
     "feature": {
       "field": "status",
-      "states": ["proposed", "approved", "in-progress", "in-review", "complete", "blocked", "cancelled"],
+      "states": [
+        "proposed",
+        "approved",
+        "in-progress",
+        "in-review",
+        "complete",
+        "blocked",
+        "cancelled"
+      ],
       "transitions": [
-        { "from": "proposed", "to": "approved", "required_authority": "user", "precondition": "all gates in terminal state" },
-        { "from": "approved", "to": "in-progress", "required_authority": "any" },
-        { "from": "in-progress", "to": "in-review", "required_authority": "any" },
-        { "from": "in-review", "to": "complete", "required_authority": "any" },
-        { "from": "in-progress", "to": "blocked", "required_authority": "any" },
-        { "from": "blocked", "to": "in-progress", "required_authority": "any" },
-        { "from": "proposed", "to": "cancelled", "required_authority": "user" }
+        {
+          "from": "proposed",
+          "to": "approved",
+          "required_authority": "user",
+          "precondition": "all gates in terminal state"
+        },
+        {
+          "from": "approved",
+          "to": "in-progress",
+          "required_authority": "any"
+        },
+        {
+          "from": "in-progress",
+          "to": "in-review",
+          "required_authority": "any"
+        },
+        {
+          "from": "in-review",
+          "to": "complete",
+          "required_authority": "any"
+        },
+        {
+          "from": "in-progress",
+          "to": "blocked",
+          "required_authority": "any"
+        },
+        {
+          "from": "blocked",
+          "to": "in-progress",
+          "required_authority": "any"
+        },
+        {
+          "from": "proposed",
+          "to": "cancelled",
+          "required_authority": "user"
+        }
       ]
     },
-    "note": "AJV draft-07 cannot enforce transition validity; this block is metadata for future framework-level state-machine validation (FGAP-005)."
+    "note": "AJV draft-07 cannot enforce transition validity; this block is metadata reserved for future framework-level state-machine validation."
   }
 }

package/samples/schemas/framework-gaps.schema.json

@@ -1,64 +1,209 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "pi-context://schemas/framework-gaps",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "title": "Framework Gaps",
-  "description": "Capability gaps in the framework — pieces that must exist natively for the target model to be expressible as configuration rather than hand-enactment.",
+  "description": "Capability gaps in the pi-project-workflows framework — pieces that must exist natively for the target artifact-ownership model to be expressible as configuration rather than hand-enactment. Each gap carries evidence (file + line references), impact, canonical engineering vocabulary for the missing capability, proposed resolution, and lifecycle state. Framework gaps are distinct from feature-level defects: they describe what the framework cannot yet express at all, not bugs in expressible functionality.",
   "type": "object",
-  "required": ["gaps"],
+  "required": [
+    "gaps"
+  ],
   "properties": {
     "gaps": {
       "type": "array",
       "items": {
         "type": "object",
         "additionalProperties": false,
-        "required": ["id", "title", "status", "package", "description", "evidence", "impact", "proposed_resolution", "created_by", "created_at"],
+        "required": [
+          "id",
+          "title",
+          "status",
+          "package",
+          "description",
+          "evidence",
+          "impact",
+          "proposed_resolution",
+          "created_by",
+          "created_at"
+        ],
         "properties": {
-          "id": { "type": "string", "pattern": "^FGAP-\\d{3}$" },
-          "title": { "type": "string" },
+          "id": {
+            "type": "string",
+            "pattern": "^FGAP-\\d{3}$"
+          },
+          "title": {
+            "type": "string"
+          },
           "status": {
             "type": "string",
-            "enum": ["identified", "accepted", "in-progress", "closed", "wontfix"]
+            "enum": [
+              "identified",
+              "accepted",
+              "in-progress",
+              "closed",
+              "wontfix",
+              "superseded_by"
+            ]
+          },
+          "priority": {
+            "type": "string",
+            "enum": [
+              "P0",
+              "P1",
+              "P2",
+              "P3"
+            ]
+          },
+          "package": {
+            "type": "string"
+          },
+          "layer": {
+            "type": "string",
+            "enum": [
+              "L1",
+              "L2",
+              "L3",
+              "L4",
+              "L5"
+            ]
+          },
+          "description": {
+            "type": "string",
+            "x-prompt-budget": {
+              "tokens": 1000,
+              "words": 800
+            }
           },
-          "priority": { "type": "string", "enum": ["P0", "P1", "P2", "P3"] },
-          "package": { "type": "string" },
-          "layer": { "type": "string", "enum": ["L1", "L2", "L3", "L4", "L5"] },
-          "description": { "type": "string", "x-prompt-budget": { "tokens": 1000, "words": 800 } },
           "evidence": {
             "type": "array",
             "items": {
               "type": "object",
               "additionalProperties": false,
-              "required": ["file", "reference"],
+              "required": [
+                "file",
+                "reference"
+              ],
               "properties": {
-                "file": { "type": "string" },
-                "lines": { "type": "string" },
-                "reference": { "type": "string", "description": "What specifically at this location demonstrates the gap", "x-prompt-budget": { "tokens": 1000, "words": 800 } }
+                "file": {
+                  "type": "string"
+                },
+                "lines": {
+                  "type": "string"
+                },
+                "reference": {
+                  "type": "string",
+                  "description": "What specifically at this location demonstrates the gap",
+                  "x-prompt-budget": {
+                    "tokens": 1000,
+                    "words": 800
+                  }
+                }
               }
             }
           },
-          "impact": { "type": "string", "x-prompt-budget": { "tokens": 1000, "words": 800 } },
+          "impact": {
+            "type": "string",
+            "x-prompt-budget": {
+              "tokens": 1000,
+              "words": 800
+            }
+          },
           "canonical_vocabulary": {
             "type": "string",
             "description": "The established engineering term for the capability that is missing"
           },
-          "proposed_resolution": { "type": "string", "x-prompt-budget": { "tokens": 1000, "words": 800 } },
-          "created_by": { "type": "string" },
-          "created_at": { "type": "string" },
-          "closed_by": { "type": "string" },
-          "closed_at": { "type": "string" }
+          "proposed_resolution": {
+            "type": "string",
+            "x-prompt-budget": {
+              "tokens": 1000,
+              "words": 800
+            }
+          },
+          "related_features": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "related_decisions": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "related_issues": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "created_by": {
+            "type": "string"
+          },
+          "created_at": {
+            "type": "string"
+          },
+          "closed_by": {
+            "type": "string"
+          },
+          "closed_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": ["identified", "accepted", "in-progress", "closed", "wontfix"],
+    "states": [
+      "identified",
+      "accepted",
+      "in-progress",
+      "closed",
+      "wontfix",
+      "superseded_by"
+    ],
     "transitions": [
-      { "from": "identified", "to": "accepted", "required_authority": "user" },
-      { "from": "identified", "to": "wontfix", "required_authority": "user" },
-      { "from": "accepted", "to": "in-progress", "required_authority": "any" },
-      { "from": "in-progress", "to": "closed", "required_authority": "any" }
+      {
+        "from": "identified",
+        "to": "accepted",
+        "required_authority": "user"
+      },
+      {
+        "from": "identified",
+        "to": "wontfix",
+        "required_authority": "user"
+      },
+      {
+        "from": "accepted",
+        "to": "in-progress",
+        "required_authority": "any"
+      },
+      {
+        "from": "in-progress",
+        "to": "closed",
+        "required_authority": "any"
+      },
+      {
+        "from": "identified",
+        "to": "superseded_by",
+        "required_authority": "user"
+      }
     ]
   }
 }

package/samples/schemas/issues.schema.json

@@ -1,37 +1,110 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "pi-context://schemas/issues",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "title": "Issues",
   "description": "Known bugs, missing capabilities, design debt, and open work items. Tracked with title/body (GitHub issue pattern), code location, package scope, priority, and resolution lifecycle.",
   "type": "object",
-  "required": ["issues"],
+  "required": [
+    "issues"
+  ],
   "properties": {
     "issues": {
       "type": "array",
       "items": {
         "type": "object",
-        "required": ["id", "title", "body", "location", "status", "category", "priority", "package"],
+        "required": [
+          "id",
+          "title",
+          "body",
+          "location",
+          "status",
+          "category",
+          "priority",
+          "package"
+        ],
         "additionalProperties": false,
         "properties": {
-          "id": { "type": "string", "pattern": "^issue-\\d{3}$" },
-          "title": { "type": "string", "description": "Scannable one-liner (GitHub issue title pattern)" },
+          "id": {
+            "type": "string",
+            "pattern": "^issue-\\d{3}$"
+          },
+          "title": {
+            "type": "string",
+            "description": "Scannable one-liner (GitHub issue title pattern)"
+          },
           "body": {
             "type": "string",
             "description": "Full detail and context for downstream composition",
-            "x-prompt-budget": { "tokens": 1000, "words": 800 }
+            "x-prompt-budget": {
+              "tokens": 1000,
+              "words": 800
+            }
+          },
+          "location": {
+            "type": "string",
+            "description": "File path + line number, e.g. packages/pi-workflows/src/dag.ts:219"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "open",
+              "resolved",
+              "deferred"
+            ]
+          },
+          "category": {
+            "type": "string",
+            "enum": [
+              "primitive",
+              "issue",
+              "cleanup",
+              "capability",
+              "composition"
+            ]
+          },
+          "priority": {
+            "type": "string",
+            "enum": [
+              "low",
+              "medium",
+              "high",
+              "critical"
+            ]
+          },
+          "package": {
+            "type": "string",
+            "description": "Which monorepo package this issue touches (e.g. pi-workflows, pi-project, pi-behavior-monitors)"
           },
-          "location": { "type": "string", "description": "File path + line number, e.g. packages/pi-workflows/src/dag.ts:219" },
-          "status": { "type": "string", "enum": ["open", "resolved", "deferred"] },
-          "category": { "type": "string", "enum": ["primitive", "issue", "cleanup", "capability", "composition"] },
-          "priority": { "type": "string", "enum": ["low", "medium", "high", "critical"] },
-          "package": { "type": "string", "description": "Which monorepo package this issue touches (e.g. pi-workflows, pi-project, pi-behavior-monitors)" },
           "source": {
             "type": "string",
-            "enum": ["human", "agent", "monitor", "workflow"],
+            "enum": [
+              "human",
+              "agent",
+              "monitor",
+              "workflow"
+            ],
             "description": "How this issue was created"
           },
-          "resolved_by": { "type": "string", "description": "Commit message or reference if resolved" }
+          "resolved_by": {
+            "type": "string",
+            "description": "Commit message or reference if resolved"
+          },
+          "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."
+          }
         }
       }
     }