@cassiomc1/forgeloop 0.1.15 → 1.0.0

package/schemas/continuity.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "forgeloop://schemas/continuity.schema.json",
+  "title": "ForgeLoop execution continuity",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "protocolVersion",
+    "taskId",
+    "workStateFingerprint",
+    "contractFingerprint",
+    "phase",
+    "repositoryFingerprint",
+    "updatedAt",
+    "remainingWork",
+    "knownIssues",
+    "changedAreas",
+    "inspectFirst"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "protocolVersion": { "const": 1 },
+    "taskId": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "workStateFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "contractFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "phase": { "type": "string", "minLength": 1 },
+    "verificationCycle": { "type": "integer", "minimum": 1 },
+    "repositoryFingerprint": {
+      "type": "object",
+      "required": ["branch", "head"],
+      "properties": {
+        "branch": { "oneOf": [{ "type": "string" }, { "type": "null" }] },
+        "head": { "oneOf": [{ "type": "string" }, { "type": "null" }] }
+      },
+      "additionalProperties": false
+    },
+    "updatedAt": { "type": "string", "minLength": 1 },
+    "currentFocus": { "$ref": "#/$defs/workItem" },
+    "remainingWork": { "type": "array", "maxItems": 40, "items": { "$ref": "#/$defs/workItem" } },
+    "knownIssues": { "type": "array", "maxItems": 40, "items": { "$ref": "#/$defs/workItem" } },
+    "changedAreas": { "type": "array", "maxItems": 80, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } },
+    "inspectFirst": { "type": "array", "maxItems": 40, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } },
+    "resumeNote": { "type": "string", "minLength": 1, "maxLength": 2000 }
+  },
+  "$defs": {
+    "workItem": {
+      "type": "object",
+      "required": ["id", "summary"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "summary": { "type": "string", "minLength": 1, "maxLength": 1000 }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/scripts/CI_VALIDATORS.md

@@ -0,0 +1,32 @@
+# Frozen CI-only validators
+
+The Python validators are retained as compatibility checks for repository
+contracts that predate the Node test suite:
+
+- `validate_markdown.py` checks Markdown structure, frontmatter, links, code
+  fences, guide metadata, and adapter/documentation consistency.
+- `validate_loop_system.py` checks the universal loop, instruction boundaries,
+  routing metadata, and protocol wording.
+- `scan_secrets.py` checks repository text for secret-shaped values and is also
+  exercised by its Python unit tests.
+
+They are deliberately frozen as CI-only tooling. The current migration does
+not replace them with a second Node implementation because doing so would
+change the historical scanner and validator contracts without a dedicated
+parity project. They are not runtime dependencies, are not shipped as the CLI
+runtime, and are not required by `npm install`.
+
+## CI invocation
+
+```bash
+python3 -m unittest discover -s tests -v
+python3 scripts/validate_markdown.py --self-test
+python3 scripts/validate_markdown.py
+python3 scripts/validate_loop_system.py --self-test
+python3 scripts/validate_loop_system.py
+python3 scripts/scan_secrets.py
+```
+
+The Node suite and Python suite have separate ownership: Node tests cover CLI,
+protocol behavior, schemas, and execution evidence; Python remains the
+compatibility gate for these repository-wide textual invariants.