@khoavu882/doflow 2.0.0-beta.4 → 2.0.0

package/core/registry/contribution-points.json

@@ -0,0 +1,32 @@
+{
+  "version": 1,
+  "trustPolicyVersion": 1,
+  "forbiddenFields": [
+    "enabled", "defaultEnabled", "trust", "trusted", "settings", "guards", "hooks", "floors", "invariants", "order",
+    "position", "replaces", "override", "familyProven", "crossFamily", "firstParty", "scripts", "install", "postinstall"
+  ],
+  "limits": { "files": 512, "bytes": 4194304, "fileBytes": 262144, "pathLength": 200 },
+  "points": [
+    { "id": "review-preset", "versions": [1], "tier": "inert", "status": "open", "entry": "file",
+      "validator": "review-preset-v1", "combine": "add-only", "consumer": "src/runtime/review/protocols.js",
+      "referencedBy": ["review.preset"], "slice": "A", "template": "package-templates/review-preset" },
+    { "id": "debate-preset", "versions": [1], "tier": "inert", "status": "open", "entry": "file",
+      "validator": "debate-preset-v1", "combine": "add-only", "consumer": "src/runtime/review/protocols.js",
+      "referencedBy": ["debate.preset"], "slice": "A", "template": "package-templates/debate-preset" },
+    { "id": "skill", "versions": [1], "tier": "instruction", "status": "open", "entry": "dir",
+      "validator": "skill-v1", "combine": "add-only", "consumer": "src/lifecycle/index.js",
+      "referencedBy": [], "slice": "C", "template": "package-templates/skill" },
+    { "id": "agent", "versions": [1], "tier": "instruction", "status": "open", "entry": "file",
+      "validator": "agent-v1", "combine": "add-only", "consumer": "src/lifecycle/index.js",
+      "referencedBy": [], "slice": "C", "template": "package-templates/agent" },
+    { "id": "worker", "versions": [1], "tier": "executable", "status": "open", "entry": "file",
+      "validator": "worker-v1", "combine": "add-only", "consumer": "src/runtime/worker/catalogue.js",
+      "referencedBy": ["workers.billing"], "slice": "D", "template": "package-templates/worker" },
+    { "id": "capability-provider", "versions": [1], "tier": "executable", "status": "open", "entry": "file",
+      "validator": "capability-provider-v1", "combine": "add-only", "consumer": "src/runtime/capability-router.js",
+      "referencedBy": [], "slice": "D", "template": "package-templates/capability-provider" }
+  ],
+  "bundled": [
+    { "id": "doflow", "dir": "core/registry/packages/doflow", "contentDigest": "492b10df12d1281743ee26a31a5acab8a90c39e2b7c9ed29fdca5cc0a94bf24a" }
+  ]
+}

package/core/registry/gates.json

@@ -0,0 +1,32 @@
+{
+  "schema": 1,
+  "classes": {
+    "feature": {
+      "gate-0": { "autopilot": "approve", "predicates": ["markers-zero:requirement"] },
+      "gate-a": { "autopilot": "approve", "predicates": ["protected-paths", "plan-verification-absent", "plan-parses", "markers-zero:design", "markers-zero:plan", "needs-merged", "requires-reachable", "plan-within-write-set"] },
+      "gate-b": { "autopilot": "approve", "minSeats": 2, "predicates": ["protected-paths", "plan-verification-absent", "verify-pass-on-head", "findings-valid", "no-dropped-findings", "dispositions-backed", "blockers-zero"] }
+    },
+    "bug": {},
+    "refactor": {},
+    "review": {},
+    "research": {},
+    "documentation": {},
+    "dependency-change": {},
+    "operations": {},
+    "trivial-edit": {}
+  },
+  "protected": {
+    "paths": ["core/registry/gates.json", "src/runtime/roadmap/", "core/registry/verification.json", "src/runtime/workflow-orchestrator.js", "src/runtime/decision-register.js", "core/registry/settings.json", "core/harnesses/shared/hooks/policies/", ".github/workflows/"],
+    "guardDir": "test/guards/",
+    "packageJsonKeys": ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"]
+  },
+  "loop": { "maxSteps": 200, "wip": 2 },
+  "merge": { "staleLockSeconds": 120, "extraTrailers": [] },
+  "denyReasons": [
+    "no-policy", "policy-invalid", "policy-override-widens", "policy-override-invalid", "policy-never", "class-unsupported", "row-unknown", "row-proposed", "seed-typed-status",
+    "unresolved-clarifications", "markers-open", "protected-path", "plan-unparsable", "need-unmerged", "prerequisite-no-source", "capability-unreachable", "write-set-exceeded",
+    "verify-missing", "verify-not-pass", "verify-flaky", "findings-missing", "findings-invalid", "review-stale-head", "seats-too-few", "finding-dropped", "refuted-without-evidence", "accepted-without-user-decision", "user-accepted-needs-person", "fixed-not-ancestor", "blockers-open",
+    "lease-held", "lease-lost", "stage-not-performed", "plan-exit-refused", "report-changed", "pause-not-machine", "facts-unreadable", "autopilot-disabled",
+    "git-too-old", "merge-conflict", "develop-wrong-branch", "develop-dirty", "ff-running", "develop-moved", "head-moved", "no-develop-worktree", "plan-changed", "needs-person", "needs-person-tty"
+  ]
+}

package/core/registry/guidance-caps.json

@@ -0,0 +1,40 @@
+{
+  "version": 1,
+  "description": "Vendor-documented size caps on always-loaded guidance, per harness. scope per-file-after-includes caps each projected always-on file after its includes are expanded; combined-chain caps everything a harness loads at startup together. cap_bytes is null when the vendor documents no byte cap; source_url is then the page checked. Never estimate a number. Read by test/guards/guidance-caps.test.ts (G74). agent_description_caps (row 131) is the same record for the combined name and description text of the shared agent specs, in tokens estimated at 4 characters each; agent_description_ratchet is a growth ceiling, not a vendor cap, that applies where no vendor documents one. Read by test/guards/skill-structure.test.ts (G75).",
+  "caps": [
+    {"harness": "claude", "cap_bytes": 4194304, "scope": "per-file-after-includes", "source_url": "https://code.claude.com/docs/en/memory", "verified_on": "2026-10-27",
+     "note": "4 MiB per CLAUDE.md file loaded at launch; a larger file is skipped entirely. The page's 200-line target is advice, not a cap."},
+    {"harness": "codex", "cap_bytes": 32768, "scope": "combined-chain", "source_url": "https://learn.chatgpt.com/docs/agent-configuration/agents-md", "verified_on": "2026-10-27",
+     "note": "project_doc_max_bytes, 32 KiB by default: Codex stops adding AGENTS.md files once the combined size reaches it."},
+    {"harness": "opencode", "cap_bytes": null, "scope": "combined-chain", "source_url": "https://opencode.ai/docs/rules", "verified_on": "2026-10-27",
+     "note": "No size cap documented."},
+    {"harness": "pi", "cap_bytes": null, "scope": "combined-chain", "source_url": "https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/configuration.md", "verified_on": "2026-10-27",
+     "note": "No cap documented; the context-file loader reads each file whole."},
+    {"harness": "copilot", "cap_bytes": null, "scope": "per-file-after-includes", "source_url": "https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions", "verified_on": "2026-10-27",
+     "note": "No cap documented for the CLI. A 4,000-character limit for code review only is cited secondhand and is not in the current docs."},
+    {"harness": "kiro", "cap_bytes": null, "scope": "per-file-after-includes", "source_url": "https://kiro.dev/docs/steering/", "verified_on": "2026-10-27",
+     "note": "No size cap documented for steering files."},
+    {"harness": "antigravity", "cap_bytes": 24000, "scope": "per-file-after-includes", "source_url": "https://antigravity.google/docs/rules", "verified_on": "2026-10-27",
+     "note": "Antigravity truncates any single rule file over 24,000 bytes after expanding @[label](path) includes."},
+    {"harness": "antigravity", "cap_bytes": null, "scope": "combined-chain", "source_url": "https://antigravity.google/docs/rules", "verified_on": "2026-10-27",
+     "note": "All active global and always_on rules share a 20,000-token budget; over it the largest are demoted to pointers. Tokens, not bytes, so no byte cap is recorded."}
+  ],
+  "agent_description_caps": [
+    {"harness": "claude", "cap_tokens": 15000, "source_url": "https://code.claude.com/docs/en/sub-agents", "verified_on": "2026-10-27",
+     "note": "When the combined descriptions of the subagents, built-in ones excepted, pass 15,000 tokens, Claude Code warns at startup and still loads every subagent. Each agent counts its name plus its description."},
+    {"harness": "codex", "cap_tokens": null, "source_url": "https://learn.chatgpt.com/docs/agent-configuration/subagents", "verified_on": "2026-10-27",
+     "note": "No description cap documented; the only cap is agents.max_concurrent_threads_per_session, a thread count."},
+    {"harness": "opencode", "cap_tokens": null, "source_url": "https://opencode.ai/docs/agents", "verified_on": "2026-10-27",
+     "note": "No cap documented; the page asks for a brief description."},
+    {"harness": "pi", "cap_tokens": null, "source_url": "https://github.com/earendil-works/pi", "verified_on": "2026-10-27",
+     "note": "Pi has no subagent surface (its README says it skips sub-agents), so nothing lists agent descriptions."},
+    {"harness": "copilot", "cap_tokens": null, "source_url": "https://docs.github.com/en/copilot/reference/custom-agents-configuration", "verified_on": "2026-10-27",
+     "note": "No description cap documented; the agent prompt body is capped at 30,000 characters."},
+    {"harness": "kiro", "cap_tokens": null, "source_url": "https://kiro.dev/docs/custom-agents/configuration-reference/", "verified_on": "2026-10-27",
+     "note": "No description cap documented."},
+    {"harness": "antigravity", "cap_tokens": null, "source_url": "https://antigravity.google/docs/subagents", "verified_on": "2026-10-27",
+     "note": "No description cap documented."}
+  ],
+  "agent_description_ratchet": {"chars": 1040, "measured_on": "2026-10-27",
+    "note": "RATCHET, NOT A VENDOR CAP. The combined name and description characters of core/shared/agent-specs/*.md, measured at row 131. It holds the harnesses whose vendor documents no cap to the current size: raise it in its own commit with the new measurement when an added or longer description is deliberate."}
+}