@geraldmaron/construct 1.2.2 → 1.3.0

package/specialists/contracts.schema.json

@@ -1,83 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "Construct Agent Contracts",
-  "description": "Schema for specialists/contracts.json — every producer→consumer handoff is a typed contract with explicit pre/post conditions.",
-  "type": "object",
-  "required": ["version", "terminalStates", "severities", "contracts"],
-  "additionalProperties": true,
-  "properties": {
-    "$schema": { "type": "string" },
-    "version": { "type": "integer", "minimum": 1 },
-    "description": { "type": "string" },
-    "terminalStates": {
-      "type": "array",
-      "items": { "type": "string", "enum": ["DONE", "BLOCKED", "NEEDS_MAIN_INPUT"] },
-      "minItems": 1,
-      "uniqueItems": true
-    },
-    "severities": {
-      "type": "object",
-      "required": ["blocking", "warning", "info"],
-      "properties": {
-        "blocking": { "type": "array", "items": { "type": "string" } },
-        "warning":  { "type": "array", "items": { "type": "string" } },
-        "info":     { "type": "array", "items": { "type": "string" } }
-      }
-    },
-    "contracts": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "required": ["id", "producer", "consumer", "input"],
-        "additionalProperties": true,
-        "properties": {
-          "id":       { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
-          "producer": { "type": "string", "minLength": 1 },
-          "consumer": { "type": "string", "minLength": 1 },
-          "trigger":  { "type": "object" },
-          "input": {
-            "type": "object",
-            "properties": {
-              "shape":       { "type": "string" },
-              "schema":      { "type": "string" },
-              "mustContain": { "type": "array", "items": { "type": "string" } }
-            }
-          },
-          "output": {
-            "type": "object",
-            "properties": {
-              "shape":       { "type": "string" },
-              "schema":      { "type": "string" },
-              "type":        { "type": "string" },
-              "mustContain": { "type": "array", "items": { "type": "string" } }
-            }
-          },
-          "preconditions":  { "type": "array", "items": { "type": "string" } },
-          "postconditions": {
-            "type": "array",
-            "items": {
-              "oneOf": [
-                { "type": "string", "description": "Descriptive postcondition (honor-based, documentation only)." },
-                {
-                  "type": "object",
-                  "required": ["id", "check"],
-                  "properties": {
-                    "id":          { "type": "string", "minLength": 1 },
-                    "description": { "type": "string" },
-                    "check": {
-                      "type": "string",
-                      "enum": ["artifact-has-frontmatter-field", "artifact-has-section", "artifact-claims-cited"]
-                    },
-                    "field":   { "type": "string" },
-                    "section": { "type": "string" }
-                  }
-                }
-              ]
-            }
-          }
-        }
-      }
-    }
-  }
-}

package/specialists/policy-inventory.json

@@ -1,188 +0,0 @@
-{
-  "version": 1,
-  "description": "Single source of truth for Construct policy gates. Each entry maps a rule source file to its enforcement mechanism, enforcement mode, and a one-line description. Consumed by `construct policy show` and the CI inventory-coverage test.",
-  "policies": [
-    {
-      "id": "file-path-fence",
-      "source": "specialists/role-manifests.json",
-      "enforcement": "lib/roles/fence.mjs#checkAction",
-      "mode": "deterministic",
-      "description": "Prevents specialists from touching files outside their declared path scope."
-    },
-    {
-      "id": "action-approval",
-      "source": "specialists/role-manifests.json",
-      "enforcement": "lib/roles/fence.mjs#checkAction",
-      "mode": "deterministic",
-      "description": "Blocks specialists from taking actions not listed in their approved action set."
-    },
-    {
-      "id": "no-fabrication",
-      "source": "rules/common/no-fabrication.md",
-      "enforcement": "lib/comment-lint.mjs",
-      "mode": "deterministic-85",
-      "description": "Detects fabrication-risk patterns (manufactured confidence, uncited claims, hand-wave percentages) in artifact prose."
-    },
-    {
-      "id": "release-gates",
-      "source": "rules/common/release-gates.md",
-      "enforcement": "lib/hooks/pre-push-gate.mjs",
-      "mode": "deterministic",
-      "description": "Enforces test + build + lint gates before any push reaches the remote."
-    },
-    {
-      "id": "contract-preconditions",
-      "source": "specialists/contracts.json",
-      "enforcement": "lib/contracts/validate.mjs#validateHandoff",
-      "mode": "deterministic",
-      "description": "Validates that specialist handoffs conform to declared pre/postconditions in contracts.json."
-    },
-    {
-      "id": "bash-safety",
-      "source": "built-in",
-      "enforcement": "lib/hooks/guard-bash.mjs",
-      "mode": "deterministic",
-      "description": "Blocks destructive bash commands (rm -rf /, git reset --hard HEAD, etc.) from running."
-    },
-    {
-      "id": "bootstrap-state",
-      "source": "built-in",
-      "enforcement": "lib/hooks/policy-engine.mjs",
-      "mode": "deterministic",
-      "description": "State machine enforces valid session bootstrap sequence before any agent work begins."
-    },
-    {
-      "id": "secret-scan",
-      "source": "built-in",
-      "enforcement": "lib/hooks/scan-secrets.mjs",
-      "mode": "deterministic",
-      "description": "Scans added lines for credential patterns before any file is written."
-    },
-    {
-      "id": "beads-hygiene",
-      "source": "rules/common/beads-hygiene.md",
-      "enforcement": "lib/contracts/validate.mjs#validateBeadsCloseReason",
-      "mode": "deterministic",
-      "description": "Validates beads close-reason quality: requires PR reference or file:line evidence."
-    },
-    {
-      "id": "commit-approval",
-      "source": "rules/common/commit-approval.md",
-      "enforcement": "(persona prompt)",
-      "mode": "honor-system",
-      "description": "Requires explicit user confirmation before any git commit or push. Enforced at the conversation level."
-    },
-    {
-      "id": "framing",
-      "source": "rules/common/framing.md",
-      "enforcement": "(persona prompt)",
-      "mode": "honor-system",
-      "description": "Requires that execution artifacts cite their source; prevents specialists from treating their own output as ground truth."
-    },
-    {
-      "id": "research-evidence",
-      "source": "rules/common/research.md",
-      "enforcement": "(persona prompt)",
-      "mode": "honor-system",
-      "description": "Enforces evidence hierarchy and citation discipline in research and analysis artifacts."
-    },
-    {
-      "id": "doc-ownership",
-      "source": "rules/common/doc-ownership.md",
-      "enforcement": "(persona prompt)",
-      "mode": "honor-system",
-      "description": "Routes artifacts to the correct specialist owner before writing (PRD to PM, ADR to Architect)."
-    },
-    {
-      "id": "code-review",
-      "source": "rules/common/code-review.md",
-      "enforcement": "(persona prompt)",
-      "mode": "honor-system",
-      "description": "Review standards applied by cx-reviewer and cx-qa before any change is marked done."
-    },
-    {
-      "id": "testing",
-      "source": "rules/common/testing.md",
-      "enforcement": "lib/hooks/pre-push-gate.mjs",
-      "mode": "deterministic",
-      "description": "Tests must pass before push; multi-component features require a functional test in tests/functional/."
-    },
-    {
-      "id": "comments",
-      "source": "rules/common/comments.md",
-      "enforcement": "lib/comment-lint.mjs",
-      "mode": "deterministic",
-      "description": "Enforces the two-form comment policy (file header + section context block). Blocks inline narration."
-    },
-    {
-      "id": "security",
-      "source": "rules/common/security.md",
-      "enforcement": "(persona prompt)",
-      "mode": "honor-system",
-      "description": "Security review checklist applied by cx-security and cx-reviewer on any change touching auth, credentials, or external I/O."
-    },
-    {
-      "id": "agents-routing",
-      "source": "rules/common/cx-agent-routing.md",
-      "enforcement": "(persona prompt)",
-      "mode": "honor-system",
-      "description": "Routing discipline: construct routes to specialists, specialists do not self-route except to adjacent roles."
-    },
-    {
-      "id": "skill-routing",
-      "source": "rules/common/cx-skill-routing.md",
-      "enforcement": "(persona prompt + lib/mcp/tools/skills.mjs)",
-      "mode": "honor-system",
-      "description": "Specialists load skills explicitly via get_skill rather than relying on ambient knowledge."
-    },
-    {
-      "id": "git-workflow",
-      "source": "rules/common/git-workflow.md",
-      "enforcement": "lib/hooks/pre-push-gate.mjs",
-      "mode": "deterministic",
-      "description": "Enforces branch naming, commit message style, and push guard (no direct-to-main pushes)."
-    },
-    {
-      "id": "coding-style",
-      "source": "rules/common/coding-style.md",
-      "enforcement": "(persona prompt)",
-      "mode": "honor-system",
-      "description": "Style standards applied at authoring time; not mechanically enforced beyond lint:comments."
-    },
-    {
-      "id": "patterns",
-      "source": "rules/common/patterns.md",
-      "enforcement": "(persona prompt)",
-      "mode": "honor-system",
-      "description": "Architectural pattern guidance (module boundaries, error handling, async contracts) applied at authoring time."
-    },
-    {
-      "id": "review-before-change",
-      "source": "rules/common/review-before-change.md",
-      "enforcement": "(persona prompt)",
-      "mode": "honor-system",
-      "description": "Requires an existing-artifact audit before authoring or rewriting any durable doc, rule, template, or PRD/ADR/RFC. Extend or supersede; do not duplicate."
-    },
-    {
-      "id": "session-efficiency",
-      "source": "rules/common/efficiency.md",
-      "enforcement": "lib/read-tracker-store.mjs + session-start digest",
-      "mode": "deterministic",
-      "description": "Read discipline, probe-before-bulk-read, and tool parallelism rules. Read counts tracked per-file; the session-start efficiency digest surfaces files crossing the re-read threshold."
-    },
-    {
-      "id": "neurodivergent-output",
-      "source": "rules/common/neurodivergent-output.md",
-      "enforcement": "(persona prompt) + tests/term-format.test.mjs",
-      "mode": "honor-system",
-      "description": "Human-facing output (terminal, agent prose, dashboard) is formatted for neurodivergent readers; presentation never reshapes machine-readable output."
-    },
-    {
-      "id": "tool-invisibility",
-      "source": "rules/common/tool-invisibility.md",
-      "enforcement": "(persona prompt + shared guidance) + lib/comment-lint.mjs",
-      "mode": "deterministic-85",
-      "description": "Deliverable artifacts are about the user's project; the comment linter flags internal cx-* role-id leaks in a consuming project's deliverables (skipped on the Construct repo itself)."
-    }
-  ]
-}