t1k-config-cocos.json
registryVersion: 1 · priority: 90
Feature flags
Section titled “Feature flags”| Flag | Value |
|---|---|
autoStdlibTriage | true |
batchMode | false |
cocosTemplateStaleCheck | true |
mcp | true |
playMode | false |
Raw JSON (ground truth)
{ "_mcpTierSemanticsNote": "There is no per-entry `tier:` field. An entry's tier IS which array holds it — `mcp.required` / `mcp.recommended` / `mcp.optional`. Resolved by hooks/lib/mcp-requirements.cjs `collectMcpEntries()`, which walks the three arrays and dedupes a name across them with required > recommended > optional precedence. The tier decides the doctor consequence, not the entry shape: doctor check #31 (`doctor-check-31-mcp-connectivity.cjs`) reports a missing `required` server as FAIL and a missing `recommended` one as WARN, and ignores `mcp.optional[]` entirely.", "build": { "sizeBudgetMB": { "_source": [ { "claim": "4.8 MB is the studio pass mark, applied to EVERY ad network", "evidence": "reports/cocos-build-tooling.md § 3 \"Size budget practice\"", "retrieved": "2026-09-13", "scope": "the shared Jenkins library; used by all 155 repos whose Jenkinsfile calls cocos(this)", "where": "JenkinsUtils.groovy getFolderTreeWithFileSizes (:84-130) marks each network file [*] when <= 4.8 MB and prints \"Files passed X/Y\" into Build-Size-Log.txt, uploaded to R2 — reporting only, it never fails the build" }, { "claim": "standing studio default, confirmed 2026-07-13", "evidence": "reports/cocos-build-tooling.md § 3 \"Size budget practice\"", "retrieved": "2026-09-13", "scope": "the project's own preproduction clarification gate", "where": "WoolPuzzle3DPLA clarification-gate note (reference line 57) — \"All networks, hard 4.8 MB final build\", marked \"never ask\"" }, { "claim": "AnimalHunterWildPLA build estimate (reference lines 62, 469)", "evidence": "reports/cocos-build-tooling.md § 3 \"Size budget practice\"", "retrieved": "2026-09-13", "scope": "an independent second project, same 4.8 MB figure — corroboration, not a conflicting cap", "where": "AnimalHunterWildPLA plans/reports/animal-hunter-wild-estimate.md" } ], "default": 4.8, "perNetwork": {} }, "sizeGate": { "_excludeNetworksComment": "`common/` holds the unminified shared bundle (measured 11,930,020 B on a real build, ~2.5x the pass mark) which no network uploads, so gating it reds every real project. An explicit [] is a DECISION to gate every channel and is honoured as one, not as a miss.", "excludeNetworks": [ "common" ] } }, "context": { "description": "Requires Cocos Creator project structure", "requiredPaths": [ "assets", "settings" ] }, "extraCommands": [], "features": { "autoStdlibTriage": true, "batchMode": false, "cocosTemplateStaleCheck": true, "mcp": true, "playMode": false }, "kit": "cocos", "kitName": "theonekit-cocos", "mcp": { "optional": [ { "_installNote": "Run from the project root (local scope is keyed to the cwd). <port> is per-EDITOR, never assume 3000: resolve it with t1k-cocos-base-editor-mcp-truth/scripts/resolve-mcp-port.cjs (reads <project>/settings/mcp-server.json .port) before registering; a wrong port still reports success against another open project.", "installCmd": "claude mcp add cocos-creator -s local --transport http -- http://127.0.0.1:<port>/mcp", "name": "cocos-creator", "note": "Demoted from required 2026-10-05: 0 Claude sessions on the workstation called any mcp__cocos-creator__* tool in the prior 30 days. Normal Cocos work runs through blind-edit (t1k-cocos-blind-edit-*, which hands needs-editor cases back to the editor), the CocosCreator CLI build and the canary. Install only when you need the live editor; existing registrations keep working.", "purpose": "Cocos Creator Editor bridge. OPTIONAL: needed only for live-editor work (scene/node hierarchy edits, prefab overrides, .effect/.pmtl, previews)", "scope": "local", "verifyTool": "mcp__cocos-creator__" } ], "recommended": [ { "_tierNote": "RECOMMENDED, not required, and scope user — both agree with theonekit-core's mcp.recommended entry for knowledge-retrieval (guarded by test/mcp-kr-tier.test.cjs). The access-mode install registers at user scope and needs one browser login (Cloudflare Access Managed OAuth) and no token. The old `required` + `scope: local` + `autoInstall` pair made auto-add (required + non-user scope only) look for KNOWLEDGE_RETRIEVAL_CF_ACCESS_TOKEN in a machine's stale user-level template (`needs-values`). `required` would also turn a logged-out machine into a doctor FAIL; `recommended` keeps the reminder and makes an absent server a WARN. Cocos skills already degrade to `unverified` when the MCP is absent.", "appliesWhen": { "owningKit": "cocos", "projectType": "cocos" }, "installCmd": "~/.claude/skills/t1k-mcp-management/scripts/install-knowledge-retrieval.sh", "name": "knowledge-retrieval", "purpose": "Studio docs/assembly retrieval (doc_search, doc_list_assemblies, doc_get_member, doc_list_indexed_repos)", "scope": "user", "servedTools": [ "doc_search", "doc_list_assemblies", "doc_get_member", "doc_list_indexed_repos" ], "verifyTool": "mcp__knowledge-retrieval__" }, { "_servedToolsNote": "Complete as of 2026-09-23 — the service's own `tools/list`. `list_prs`/`get_pr_impact`/`triage_prs` were missing here while already listed in the core SSOT `t1k-code-graph/SKILL.md` § The tool surface, so a session reading only this fragment believed the PR tools did not exist.", "_tierNote": "RECOMMENDED, not required (demoted from `required` 2026-09-23). The graph is served ahead of its own evaluation result — `t1k-code-graph` documents it as \"promising, not proven\", an unproven hypothesis with a kill criterion that may be retired. A `required` tier makes an absent graph a doctor FAIL for every Cocos consumer, i.e. it converts an experimental capability into a contractually binding dependency the studio has not committed to; `recommended` keeps the SessionStart reminder and the install path while making an absent graph a WARN. Promote it back to `required` only when the scored-evaluation kill criterion resolves in its favour.", "appliesWhen": { "owningKit": "cocos", "projectType": "cocos" }, "authMode": "studio", "autoInstall": true, "installCmd": "~/.claude/skills/t1k-mcp-management/scripts/install-code-graph.sh code-graph-cocos --mode shared", "name": "code-graph-cocos", "purpose": "Studio code graph for Cocos repos: callers, dependencies, paths and communities across every enrolled repo (graphify, tree-sitter AST)", "replacesLocalCopy": true, "scope": "user", "servedTools": [ "query_graph", "get_node", "get_neighbors", "get_community", "god_nodes", "graph_stats", "shortest_path", "list_prs", "get_pr_impact", "triage_prs" ], "verifyTool": "mcp__code-graph-cocos__" }, { "appliesWhen": { "owningKit": "cocos", "projectType": "cocos" }, "installCmd": "claude mcp add --transport http -s user playablelabs https://mcp.playablelabs.ai/mcp", "name": "playablelabs", "purpose": "PlayableLabs platform: games, versions, variants, customization, export (remote OAuth)", "scope": "user", "verifyTool": "mcp__playablelabs__" } ], "required": [ { "installCmd": "claude mcp add context7 --transport http -- https://mcp.context7.com/mcp", "name": "context7", "purpose": "Library/framework documentation lookup for planning and implementation", "servedTools": [ "resolve-library-id", "get-library-docs" ], "verifyTool": "mcp__context7__" }, { "appliesWhen": { "owningKit": "cocos", "projectType": "cocos" }, "autoInstall": true, "installCmd": "~/.claude/skills/t1k-mcp-management/scripts/install-jenkins.sh", "name": "jenkins", "purpose": "Studio Jenkins CI — build jobs, pipeline status, run history", "requiredEnv": [ "JENKINS_USERNAME", "JENKINS_API_TOKEN" ], "scope": "local", "verifyTool": "mcp__jenkins__" } ] }, "priority": 90, "registryVersion": 1, "repos": { "mcp": "The1Studio/cocos-mcp-server", "primary": "The1Studio/theonekit-cocos" }, "rsiSignals": [ { "class": "library-candidate", "engine": "cocos", "id": "cocos-reuse-verdict-contribute", "pattern": "^reuse-verdict: CONTRIBUTE — (?<symbol>[^—]{1,200}) — scope:" } ], "stdlibContribute": { "_holdNote": "Project roots (absolute; an entry also holds everything beneath it) that are NEVER auto-triggered and never nudged; their queue rows are left untouched. The list is the UNION across every t1k-config-*.json fragment (global, kit, and each project's own .claude/ ancestors), so a project adds its own hold in .claude/t1k-config-cocos-project.json (priority 100) without editing this kit file.", "_note": "Read by core's cocos-stdlib-candidate-nudge.cjs to decide the [t1k:stdlib-candidates] frame's mode=<auto|suggest> field and its inline instruction. mode=auto — the session spawns `t1k-cocos-base-stdlib-contribute --from-queue` in the BACKGROUND without asking (the flag is the standing approval, the auto-sync-back shape); mode=suggest — offer once per nudge cooldown, no spawn without a yes; mode=off — no nudge frame, detection silent. merge is auto only and names who merges, not a flag the flow acts on: the contribute flow opens the PR and stops, and cocos-stdlib `.github/workflows/auto-merge.yml` squash-merges it after `ci` succeeds (skips draft, the `no-automerge` label and fork heads; contribute/* and harvest/* heads also need a gatekeeper APPROVE for the head sha). The flow NEVER runs `gh pr merge --auto` (the ruleset has no required status checks, so it would merge immediately) — NEVER hand-merge, NEVER publish to CPM by hand, NEVER seed a first-release tag. Env override T1K_STDLIB_CONTRIBUTE=off|suggest|auto wins over config; an unrecognised value behaves as suggest WITH a visible warning naming the bad value. features.autoStdlibTriage stays the detection kill switch (mode=off also silences). A project override goes in .claude/t1k-config-cocos-project.json at priority 100 — normal fragment-merge resolution.", "autoTrigger": { "_maxOpenNote": "Backpressure: the Stop hook does not auto-spawn the contributor while this many or more contribute/* or harvest/* PRs are open on cocos-stdlib that are NOT draft and do NOT carry the no-automerge label (held PRs never count). A gh failure also pauses it. The manual contribute flow and the report/ack commands are unaffected. Core falls back to 5 only when this key is absent.", "_note": "Read by core's lib/stdlib-auto-trigger.cjs from cocos-stdlib-candidate-stop.cjs. After a Stop that leaves >= minCandidates triaged-unacknowledged NEW/EXTEND candidates in a non-held project (and mode=auto), the Stop hook itself tells the session to start the contribute flow NOW as a background agent. Fires at most once per triaged batch. enabled=false restores the next-prompt nudge as the only path.", "enabled": true, "maxOpenContributePrs": 5, "minCandidates": 1 }, "holdProjects": [], "merge": "auto", "mode": "auto" }, "stdlibContributors": { "_note": "The contributor arm per engine key, read by core's lib/stdlib-auto-trigger.cjs readContributors() (merged per engine key and per field across fragments). `queue` is the entry that drains the candidate queue; null means offered per file by hand.", "cocos": { "agent": "t1k-cocos-playable-stdlib-contributor", "queue": "t1k-cocos-base-stdlib-contribute --from-queue", "skill": "t1k-cocos-base-stdlib-contribute" } }, "stdlibTriage": { "_defaultsNote": "Lowered for the Stop-time auto-trigger (stdlibContribute.autoTrigger): the trigger can only fire once a batch is TRIAGED, so a lone candidate waiting for batchSize 3 / maxWait 4h would sit unrecovered long after its feature finished. batchSize 1 triages every detected candidate on the next scan, debounceMinutes 10 lets a second feature in the same session be scanned (30 re-scanned at most twice per hour of work), maxWaitHours 1 is the backstop. Triage is one cheap routed hop per batch; maxPerBatch still caps its size.", "_readerNote": "Read by theonekit-core hooks/lib/cocos-stdlib-candidates.cjs readTriageConfig() — and the autoStdlibTriage feature flag via telemetry-utils readFeatureFlag() — which scan every t1k-config-*.json in the layered fragment stack, so this block lives with the kit that owns the detector CLI (shipped at t1k-cocos-playable-stdlib-harvest/scripts/stdlib-candidates.cjs, owned by the t1k-cocos-base-stdlib-contribute decision law), not in t1k-config-core.json. These are the kit defaults; a project override goes in .claude/t1k-config-cocos-project.json at priority 100.", "batchSize": 1, "debounceMinutes": 10, "maxPerBatch": 5, "maxWaitHours": 1, "nudgeCooldownHours": 4 }}