Skip to content

t1k-config-cocos.json

registryVersion: 1 · priority: 90

FlagValue
autoStdlibTriagetrue
batchModefalse
cocosTemplateStaleChecktrue
mcptrue
playModefalse

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
}
}