npm - frontend-project-context - Versions diffs - 1.8.0 → 1.10.0 - Mend

frontend-project-context 1.8.0 → 1.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (69) hide show

package/CHANGELOG.md +29 -1
package/README.md +26 -7
package/UPGRADING.md +24 -0
package/docs/00-PRODUCT-CONSTITUTION.md +44 -12
package/docs/08-INSTALLATION-AND-DISTRIBUTION.md +9 -3
package/docs/14-FORMAL-RELEASE-READINESS.md +14 -0
package/docs/28-REAL-PROJECT-ONBOARDING-CLOSURE-DESIGN.md +10 -0
package/docs/29-REAL-PROJECT-1.8.0-INITIALIZATION-OBSERVATIONS.md +228 -0
package/docs/30-TASK-CONTEXT-CONSUMPTION-CLOSURE-DESIGN.md +563 -0
package/docs/31-TASK-CONTEXT-INTEGRITY-REPAIR-DESIGN.md +281 -0
package/docs/32-PROJECT-TO-TASK-INTERACTION-PROPOSAL.md +173 -0
package/docs/33-BOUNDED-TASK-HANDOFF-REDESIGN.md +207 -0
package/docs/34-A0-CODEX-HOST-FEASIBILITY.md +61 -0
package/docs/35-CONTEXT-FIRST-TASK-HANDOFF-DESIGN.md +248 -0
package/docs/36-PRODUCT-VALUE-AND-USABILITY-REVIEW.md +158 -0
package/docs/37-EVERYDAY-HANDOFF-FLOW-DESIGN.md +271 -0
package/docs/38-EVERYDAY-HANDOFF-OPERATION.md +147 -0
package/docs/39-SELF-HOST-RELEASE-ACCEPTANCE.md +39 -0
package/docs/AI-PROJECT-INITIALIZATION.md +8 -3
package/docs/PRODUCT-SHARING-AND-ADOPTION-GUIDE.md +111 -0
package/docs/README.md +26 -2
package/docs/USER-AND-AI-OPERATION-MANUAL.md +9 -3
package/docs/assets/product-sharing-01-overview.svg +32 -0
package/docs/assets/product-sharing-02-how-it-works.svg +17 -0
package/docs/assets/product-sharing-03-example.svg +19 -0
package/examples/package.json +1 -1
package/migration-manifest.json +38 -12
package/package.json +2 -2
package/schemas/capabilities.schema.json +26 -12
package/schemas/context-bundle.schema.json +32 -0
package/schemas/coverage-audit.schema.json +6 -4
package/schemas/evidence-bundle.schema.json +1 -1
package/schemas/initialization-instruction.schema.json +17 -5
package/schemas/migration-manifest.schema.json +3 -3
package/schemas/migration-plan.schema.json +1 -1
package/schemas/project-brief.schema.json +400 -0
package/schemas/projection-lock.schema.json +1 -1
package/schemas/task-context-record.schema.json +27 -0
package/schemas/task-handoff-input.schema.json +23 -0
package/schemas/task-handoff-result.schema.json +320 -0
package/schemas/upgrade-assessment.schema.json +1 -1
package/schemas/upgrade-result-bundle.schema.json +1 -1
package/schemas/work-view.schema.json +541 -0
package/src/project-context/adaptive-context-schema.mjs +1 -1
package/src/project-context/adaptive-context.mjs +16 -29
package/src/project-context/ai-entry.mjs +28 -12
package/src/project-context/approver.mjs +6 -2
package/src/project-context/authoring.mjs +28 -8
package/src/project-context/capabilities.mjs +13 -1
package/src/project-context/checker.mjs +1 -1
package/src/project-context/cli.mjs +74 -17
package/src/project-context/context-bundle.mjs +379 -0
package/src/project-context/contract-schema.mjs +62 -9
package/src/project-context/coverage-profile.mjs +127 -0
package/src/project-context/exchange-schema.mjs +24 -6
package/src/project-context/exchange.mjs +3 -0
package/src/project-context/initialization-instruction.mjs +20 -2
package/src/project-context/maintenance.mjs +5 -4
package/src/project-context/migration-manifest.mjs +3 -3
package/src/project-context/path-policy.mjs +13 -0
package/src/project-context/renderer.mjs +11 -4
package/src/project-context/source-reader.mjs +27 -2
package/src/project-context/task-context.mjs +4 -14
package/src/project-context/task-handoff-schema.mjs +185 -0
package/src/project-context/task-handoff.mjs +259 -0
package/src/project-context/upgrade-schema.mjs +1 -1
package/src/project-context/upgrade.mjs +1 -0
package/src/project-context/work-view-schema.mjs +125 -0
package/src/project-context/work-view.mjs +135 -0

package/schemas/task-handoff-result.schema.json ADDED Viewed

@@ -0,0 +1,320 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:task-handoff-result:2",
+  "oneOf": [
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "kind",
+        "taskIdentity",
+        "projectHealth",
+        "intent",
+        "recordDigest",
+        "authorityGranted",
+        "semanticCompleteness",
+        "taskStatus",
+        "gate",
+        "contextBundleDigest",
+        "requirementsDigest",
+        "progressKey",
+        "itemIds",
+        "scopeCoverage",
+        "requiredTargets",
+        "conditionalTargets",
+        "evidenceResults",
+        "gaps",
+        "questions",
+        "nextAction"
+      ],
+      "properties": {
+        "schemaVersion": {
+          "const": 1
+        },
+        "kind": {
+          "const": "task-handoff-result"
+        },
+        "taskIdentity": {
+          "type": "object"
+        },
+        "projectHealth": {
+          "type": "string"
+        },
+        "intent": {
+          "enum": [
+            "investigate",
+            "design",
+            "implement"
+          ]
+        },
+        "recordDigest": {
+          "type": "string"
+        },
+        "authorityGranted": {
+          "const": false
+        },
+        "semanticCompleteness": {
+          "const": "not-claimed"
+        },
+        "taskStatus": {
+          "enum": [
+            "blocked",
+            "discovering",
+            "needs-evidence",
+            "needs-decision",
+            "ready-for-read-only",
+            "ready-to-implement",
+            "inactive"
+          ]
+        },
+        "gate": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "mode",
+            "currentAction",
+            "status",
+            "reasonIds",
+            "instruction"
+          ],
+          "properties": {
+            "mode": {
+              "const": "instructional"
+            },
+            "currentAction": {
+              "enum": [
+                "read-only",
+                "implementation"
+              ]
+            },
+            "status": {
+              "enum": [
+                "hold",
+                "proceed",
+                "not-applicable"
+              ]
+            },
+            "reasonIds": {
+              "type": "array"
+            },
+            "instruction": {
+              "type": "string"
+            }
+          }
+        },
+        "contextBundleDigest": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "requirementsDigest": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "progressKey": {
+          "type": "string"
+        },
+        "itemIds": {
+          "type": "array"
+        },
+        "scopeCoverage": {
+          "type": "array"
+        },
+        "requiredTargets": {
+          "type": "array"
+        },
+        "conditionalTargets": {
+          "type": "array"
+        },
+        "evidenceResults": {
+          "type": "array"
+        },
+        "gaps": {
+          "type": "array"
+        },
+        "questions": {
+          "type": "array"
+        },
+        "nextAction": {
+          "type": "string"
+        }
+      }
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "kind",
+        "taskIdentity",
+        "projectHealth",
+        "intent",
+        "recordDigest",
+        "authorityGranted",
+        "semanticCompleteness",
+        "taskStatus",
+        "gate",
+        "contextBundleDigest",
+        "requirementsDigest",
+        "progressKey",
+        "itemIds",
+        "scopeCoverage",
+        "requiredTargets",
+        "conditionalTargets",
+        "evidenceResults",
+        "gaps",
+        "questions",
+        "nextAction",
+        "context",
+        "taskSnapshot",
+        "presentation",
+        "delivery"
+      ],
+      "properties": {
+        "schemaVersion": {
+          "const": 2
+        },
+        "kind": {
+          "const": "task-handoff-result"
+        },
+        "taskIdentity": {
+          "type": "object"
+        },
+        "projectHealth": {
+          "type": "string"
+        },
+        "intent": {
+          "enum": [
+            "investigate",
+            "design",
+            "implement"
+          ]
+        },
+        "recordDigest": {
+          "type": "string"
+        },
+        "authorityGranted": {
+          "const": false
+        },
+        "semanticCompleteness": {
+          "const": "not-claimed"
+        },
+        "taskStatus": {
+          "enum": [
+            "blocked",
+            "discovering",
+            "needs-evidence",
+            "needs-decision",
+            "ready-for-read-only",
+            "ready-to-implement",
+            "inactive"
+          ]
+        },
+        "gate": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "mode",
+            "currentAction",
+            "status",
+            "reasonIds",
+            "instruction"
+          ],
+          "properties": {
+            "mode": {
+              "const": "instructional"
+            },
+            "currentAction": {
+              "enum": [
+                "read-only",
+                "implementation"
+              ]
+            },
+            "status": {
+              "enum": [
+                "hold",
+                "proceed",
+                "not-applicable"
+              ]
+            },
+            "reasonIds": {
+              "type": "array"
+            },
+            "instruction": {
+              "type": "string"
+            }
+          }
+        },
+        "contextBundleDigest": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "requirementsDigest": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "progressKey": {
+          "type": "string"
+        },
+        "itemIds": {
+          "type": "array"
+        },
+        "scopeCoverage": {
+          "type": "array"
+        },
+        "requiredTargets": {
+          "type": "array"
+        },
+        "conditionalTargets": {
+          "type": "array"
+        },
+        "evidenceResults": {
+          "type": "array"
+        },
+        "gaps": {
+          "type": "array"
+        },
+        "questions": {
+          "type": "array"
+        },
+        "nextAction": {
+          "type": "string"
+        },
+        "context": {
+          "anyOf": [
+            {
+              "$ref": "context-bundle.schema.json"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "taskSnapshot": {
+          "anyOf": [
+            {
+              "$ref": "work-view.schema.json#/$defs/taskSnapshot"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "presentation": {
+          "$ref": "work-view.schema.json#/$defs/presentation"
+        },
+        "delivery": {
+          "$ref": "work-view.schema.json#/$defs/delivery"
+        }
+      }
+    }
+  ]
+}

package/schemas/upgrade-assessment.schema.json CHANGED Viewed

@@ -10,7 +10,7 @@
     "kind": {"const": "upgrade-assessment"},
     "product": {"type": "object", "additionalProperties": false, "required": ["name"], "properties": {"name": {"const": "frontend-project-context"}}},
     "fromVersion": {"enum": ["1.3.1", "1.4.0", "1.5.0", "1.6.0", "1.7.0"]},
-    "targetVersion": {"const": "1.8.0"},
+    "targetVersion": {"const": "1.10.0"},
     "fromVersionEvidence": {"const": "host-asserted"},
     "manifestSchemaVersion": {"const": 2},
     "manifestDigest": {"$ref": "#/$defs/digest"},

package/schemas/upgrade-result-bundle.schema.json CHANGED Viewed

@@ -10,7 +10,7 @@
     "kind": {"const": "upgrade-result-bundle"},
     "product": {"type": "object", "additionalProperties": false, "required": ["name"], "properties": {"name": {"const": "frontend-project-context"}}},
     "fromVersion": {"type": "string"},
-    "targetVersion": {"const": "1.8.0"},
+    "targetVersion": {"const": "1.10.0"},
     "manifestDigest": {"$ref": "#/$defs/digest"},
     "planDigest": {"$ref": "#/$defs/digest"},
     "mode": {"enum": ["preview", "write"]},