Skip to content
Back to search

2718lab-devkit

Deterministic project intelligence, durable workflow orchestration, and reusable MCP engineering tools for Codex.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/2718labs/2718lab-devkit with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/2718labs/2718lab-devkit'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/2718labs--2718lab-devkit/badge.svg)](/listings/2718labs--2718lab-devkit)

HTML

<a href="/listings/2718labs--2718lab-devkit"><img src="/api/listings/2718labs--2718lab-devkit/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Add the repository's slim marketplace branch once, then install the plugin:

codex plugin marketplace add 2718labs/2718lab-devkit --ref marketplace codex plugin add 2718lab-devkit@2718lab-marketplace

For later releases, refresh the remote snapshot and reinstall from it:

codex plugin marketplace upgrade 2718lab-marketplace codex plugin add 2718lab-devkit@2718lab-marketplace

Start a new Codex task after installing or updating so the refreshed skills and MCP server are loaded. The `marketplace` branch is a distribution snapshot; the source of record remains `main` and immutable release tags.

Maintainers build that snapshot with the dedicated marketplace allowlist:

python .codex-plugin/build_main_artifact.py --plugin-root . --allowlist .codex-plugin/marketplace-artifact-allowlist.json --output <artifact-output-dir>/2718lab-devkit-marketplace-v1.2.1.zip

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

plugin.json · Manifest · 34 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  3. "name": "2718lab-devkit",
  4. "version": "1.2.1",
  5. "description": "Local MCP server for developer workflow coordination, indexing, and evidence handling.",
  6. "author": {
  7. "name": "2718lab",
  8. "url": "https://github.com/2718labs"
  9. },
  10. "homepage": "https://github.com/2718labs/2718lab-devkit",
  11. "repository": "https://github.com/2718labs/2718lab-devkit",
  12. "license": "AGPL-3.0",
  13. "keywords": [
  14. "mcp",
  15. "developer-tools",
  16. "local"
  17. ],
  18. "extensions": {
  19. "com.openai": {
  20. "interface": {
  21. "displayName": "2718lab DevKit",
  22. "shortDescription": "Local MCP server for developer workflows",
  23. "longDescription": "A local MCP server for workflow coordination, indexing, and evidence handling.",
  24. "developerName": "2718lab",
  25. "category": "Developer Tools",
  26. "capabilities": [
  27. "MCP server"
  28. ],
  29. "websiteURL": "https://github.com/2718labs/2718lab-devkit",
  30. "defaultPrompt": []
  31. }
  32. }
  33. }
  34. }
README.md · README · 435 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. [简体中文](README.zh-CN.md)
  2. # 2718lab DevKit — Codex + MCP v1.2.1
  3. [![version](https://img.shields.io/badge/version-v1.2.1-blue)](./.codex-plugin/plugin.json)
  4. [![license](https://img.shields.io/badge/license-AGPL--3.0-blue)](LICENSE)
  5. 2718lab DevKit is a Codex-first engineering toolkit: a local, stdio-only MCP
  6. runtime for bounded project indexing, Atlas evidence, Relay lifecycle
  7. coordination, and deterministic Fast Lane planning, plus a compact Skill bundle
  8. of reference manuals. This repository carries the versioned v1.2.1 package.
  9. The checked-in manifest and allowlist define the executable runtime surface;
  10. the manual map, install, build, and verification sections below describe the
  11. supported workflow.
  12. The public Python compiler and CLI retain the deliberately fail-closed
  13. `team-efficiency/fast-lane-plan-v1` preview. For new work, prepare
  14. `fast-lane-request-v2` with `prepare_model_neutral_fast_lane_request`; MCP
  15. `fastlane_compile` then resolves the workspace/snapshot selectors through its
  16. local RuntimeRoot and returns a verified `team-efficiency/fast-lane-plan-v3`.
  17. Its assignments describe requirements and leave model selection to the
  18. coordinator using current Codex tool metadata. Every descriptor remains
  19. `plan_only`: it never dispatches, claims a lease, creates a worktree, or
  20. authorizes execution. Request-v1/plan-v2 stays available for exact legacy replay.
  21. The prior v1.1.3 storage-governance integration references compatible Host source only
  22. on Ayleovelle's user-fork
  23. [`codex/host-1.1.3-storage-governance-upstream`](https://github.com/Ayleovelle/codex/tree/codex/host-1.1.3-storage-governance-upstream)
  24. branch, pinned to immutable commit
  25. [`c3dde23bec21c45d10740f2eec09d9a1b87cd329`](https://github.com/Ayleovelle/codex/commit/c3dde23bec21c45d10740f2eec09d9a1b87cd329).
  26. That fork is buildable Host source, not an OpenAI upstream merge or a component
  27. shipped by this package. Stock Codex Hosts have no attested protected broker
  28. and continue to fail closed.
  29. > [!IMPORTANT]
  30. > **Workflow reminder:** route from bounded evidence. Parallel A1/A2/A3 work is
  31. > allowed only with disjoint, exclusively owned write scopes and independent G:
  32. > task roots. Claim and bind before execution; prewarm is read-only and
  33. > `action="retain"` is not a new spawn. The coordinator integrates only after
  34. > PR-style independent review, then accepts before archiving. Fast Lane does not
  35. > use an account-usage coordinator or account-usage inputs. Do not commit runtime state or
  36. > credentials.
  37. > **Scheduler topology V1:** `2718lab-devkit/scheduler-topology-v1` binds the
  38. > plan, lease, and G-drive worktree as auditable opaque identities. A/B/C means
  39. > main-conversation review/integration, scheduler, and writer; each scheduler
  40. > has at most a 1:3 writer relationship. Design/prewarm are read-only and stay
  41. > subject to actual host slots, host capability, and safety gates. Cross-scope
  42. > work requires a declared-child split that strictly reduces conflict, or is
  43. > UNSPLITTABLE.
  44. ## 1.2.1 hotfix
  45. The compatibility preflight now rejects any missing or extra retained Codex manifest field, including unreviewed hooks, agents and skill entry points. It remains read-only and does not authorize execution.
  46. ## What is new in 1.2.0
  47. Portable Agent Plugins entry points now accompany the retained Codex manifests.
  48. Run the read-only package preflight before installing an extracted artifact:
  49. python .codex-plugin/check_compatibility.py --plugin-root <extracted-plugin>
  50. The JSON report checks package consistency, not host permissions or model
  51. availability. See [the September 2026 compatibility guide](docs/compatibility/codex-2026-09.md)
  52. for current plugin packaging, dynamic model selection and actual host boundaries.
  53. The 17-tool runtime and fail-closed execution contracts remain intact.
  54. ## What is shipped
  55. - Project Index exposes opaque workspace registration, bounded snapshots,
  56. status, and graph queries.
  57. - Checkpoint services create, inspect, and restore evidence-bound snapshots.
  58. - Atlas provides bounded graph queries, packet preparation, inert rendering,
  59. and durable acceptance projection.
  60. - Relay validates explicit work packages and exposes lifecycle state. Python
  61. returns structured host actions; the Codex host remains responsible for
  62. worktree bootstrap and agent dispatch.
  63. - The executable MCP runtime exposes exactly 17 tools, no MCP prompts, no MCP
  64. resources, no static prompt agents, and no model runner.
  65. - The optional Codex Skill bundle is part of DevKit's documentation surface. It
  66. provides short, module-specific manuals without becoming a second runtime or
  67. an executable prompt/agent surface.
  68. - Fast Lane is a pure planning compiler. New model-neutral requests emit bounded
  69. `team-efficiency/fast-lane-plan-v3` assignments only after its private
  70. RuntimeRoot verifies a registered `INDEX_READY` snapshot, Git HEAD, and full
  71. write-scope coverage. Assignments contain no default model name; the
  72. coordinator records an exact model/effort choice before the dispatch tool
  73. validates availability. Every result remains `plan_only`; no agent, Git
  74. command, lease, or worktree action is executed. The public Python compiler/CLI
  75. remains the authority-inert plan-v1 diagnostic surface.
  76. ## Module overview
  77. | Module | Responsibility | Start here |
  78. | --- | --- | --- |
  79. | [`mcp-tools/server.py`](mcp-tools/server.py) | stdio MCP entry point and the public 17-tool surface | [MCP surface](#exact-mcp-surface) |
  80. | [`mcp-tools/project_index/`](mcp-tools/project_index/) | workspace registration, bounded snapshots, status, and graph queries | [Project Index tools](#exact-mcp-surface) |
  81. | [`mcp-tools/devkit_atlas/`](mcp-tools/devkit_atlas/) | evidence graph queries, implementation packets, rendering, and acceptance projection | [Atlas tools](#exact-mcp-surface) |
  82. | [`mcp-tools/devkit_relay/`](mcp-tools/devkit_relay/) | explicit work-package compilation and lifecycle host actions | [Relay tools](#exact-mcp-surface) |
  83. | [`mcp-tools/devkit_runtime/`](mcp-tools/devkit_runtime/) | runtime paths, checkpoints, durable boundaries, and the private host bridge | [runtime and recovery](#runtime-data-and-recovery) |
  84. | [`mcp-tools/orchestrator/`](mcp-tools/orchestrator/) | durable workflow, task, lease, and lifecycle state | [workflow lifecycle](mcp-tools/devkit_fastlane/references/efficiency-automation.md#workflow-lifecycle-plan) |
  85. | [`mcp-tools/devkit_fastlane/`](mcp-tools/devkit_fastlane/) | deterministic routing/Fast Lane compiler, contracts, and tests | [Fast Lane contract](mcp-tools/devkit_fastlane/FASTLANE_CONTRACT.md) |
  86. | [`.codex-plugin/`](.codex-plugin/) | plugin manifest, artifact allowlist, and reproducible package builder | [artifact build](#build-the-primary-artifact) |
  87. ## Overall workflow
  88. The repository workflow defaults to Fast Lane. `workflow-design` prepares a
  89. bounded model-neutral request-v2 input. MCP `fastlane_compile` verifies the
  90. persisted local project snapshot and returns a plan-v3 descriptor;
  91. `team_efficiency.py` retains the
  92. blocked plan-v1 diagnostic path. Neither path starts agents or creates/executes
  93. cross-session worktrees. A coordinator must separately validate route
  94. availability, claim a lease, and dispatch any selected work.
  95. ```mermaid
  96. flowchart TD
  97. A["Install + configure .mcp.json"] --> B{"Choose entry"}
  98. subgraph MCP["MCP runtime"]
  99. C["mcp-tools/server.py<br/>stdio entry"] --> D["Project Index / Checkpoint<br/>Atlas / Relay"] --> E["Bounded result<br/>host action"]
  100. end
  101. subgraph FAST["Fast Lane"]
  102. F["fast-lane request"] --> G["MCP fastlane_compile<br/>private RuntimeRoot verification"]
  103. G --> X["plan-v3 requirements<br/>unselected, plan_only"]
  104. F --> H["public Python / CLI"] --> I["plan-v1<br/>NO_SAFE_WORK"]
  105. end
  106. B -->|MCP tools| C
  107. B -->|Fast Lane| F
  108. ```
  109. ## Codex manual map
  110. DevKit deliberately has two separate surfaces: the MCP runtime performs
  111. bounded tool work, while the local plugin includes an optional,
  112. documentation-only Codex manual bundle. The bundle has one short navigator
  113. (`skills/devkit-overview`), one workflow-design manual (`skills/workflow-design`,
  114. default Fast Lane policy), and six separate module manuals. A task loads only
  115. the manual it needs:
  116. `fast-lane-routing` · `bugkiller` · `code-atlas` ·
  117. `mcp-server-dev` · `oss-repo-ops` · `python-engineering`.
  118. These skills are reference manuals, not MCP tools or executable prompt surfaces.
  119. They contain no slash commands, agent profiles, starter templates, validators,
  120. or dispatch code. The lean runtime ZIP deliberately excludes them, but that
  121. packaging boundary does not make DevKit a runtime-only product.
  122. ## Documentation map
  123. Use this page as the entry point, then follow the contract links instead of
  124. re-reading the whole repository:
  125. - [Fast Lane contract](mcp-tools/devkit_fastlane/FASTLANE_CONTRACT.md)
  126. - [Efficiency automation reference and CLI details](mcp-tools/devkit_fastlane/references/efficiency-automation.md)
  127. - [Verification checklist](mcp-tools/devkit_fastlane/references/verification-checklist.md)
  128. - [Work-package and task-card rules](mcp-tools/devkit_fastlane/references/work-packages.md)
  129. - [Orchestration runtime contract](mcp-tools/devkit_fastlane/references/orchestration-runtime.md)
  130. - [Team and lane patterns](mcp-tools/devkit_fastlane/references/team-patterns.md)
  131. - [Repository automation and review](docs/governance/repository-automation.md)
  132. - [Contributing](CONTRIBUTING.md) · [Security reporting](SECURITY.md) · [Code of Conduct](CODE_OF_CONDUCT.md)
  133. - [Historical design records](docs/superpowers/README.md) — context only; they can mention
  134. retired components and are not the current implementation contract.
  135. - [Release history](CHANGELOG.md)
  136. For the current implementation entry point, see
  137. [the Fast Lane compiler](mcp-tools/devkit_fastlane/scripts/team_efficiency.py).
  138. Fast Lane has no account-usage coordinator contract; the public compiler and
  139. CLI do not read, coordinate, or infer account usage.
  140. ## Exact MCP surface
  141. The public server name is 2718lab-devkit. Every result uses the bounded
  142. 2718lab-devkit/tool-result-v1 envelope. The public surface is exactly:
  143. | Area | Tools |
  144. | --- | --- |
  145. | Project Index | project_index_register, project_index_sync, project_index_status, project_index_query |
  146. | Checkpoints | worktree_checkpoint_create, worktree_checkpoint_status, worktree_checkpoint_restore |
  147. | Atlas | atlas_query, atlas_prepare, atlas_render, atlas_accept |
  148. | Relay | relay_compile, relay_start, relay_status, relay_handoff, relay_integrate |
  149. | Fast Lane | fastlane_compile |
  150. The server has no prompt or resource surface. Tool inputs are structured and
  151. bounded; absolute worker paths, shell fragments, raw source, credentials,
  152. unbounded command output, and caller-forged acceptance evidence are rejected.
  153. ## Install from the Codex marketplace
  154. Add the repository's slim marketplace branch once, then install the plugin:
  155. codex plugin marketplace add 2718labs/2718lab-devkit --ref marketplace
  156. codex plugin add 2718lab-devkit@2718lab-marketplace
  157. For later releases, refresh the remote snapshot and reinstall from it:
  158. codex plugin marketplace upgrade 2718lab-marketplace
  159. codex plugin add 2718lab-devkit@2718lab-marketplace
  160. Start a new Codex task after installing or updating so the refreshed skills and
  161. MCP server are loaded. The `marketplace` branch is a distribution snapshot; the
  162. source of record remains `main` and immutable release tags.
  163. Maintainers build that snapshot with the dedicated marketplace allowlist:
  164. python .codex-plugin/build_main_artifact.py --plugin-root . --allowlist .codex-plugin/marketplace-artifact-allowlist.json --output <artifact-output-dir>/2718lab-devkit-marketplace-v1.2.1.zip
  165. ## Install and run locally
  166. Requirements: Python 3.11 or newer and uv.
  167. From the repository root:
  168. cd mcp-tools
  169. uv sync --locked --no-dev
  170. uv run --locked --no-dev python server.py
  171. The canonical host configuration is .mcp.json. It runs the locked command
  172. above with mcp-tools as the working directory. The configuration forwards two
  173. private host-bridge selector names and optional project/thread scope identifiers:
  174. - CODEX_DEVKIT_HOST_BRIDGE_FD
  175. - CODEX_DEVKIT_HOST_BRIDGE_HANDLE
  176. - CODEX_PROJECT_ROOT, CODEX_WORKSPACE_ROOT
  177. - CODEX_PROJECT_ID, CODEX_WORKSPACE_ID, CODEX_THREAD_ID
  178. These are selector or identity names, not values to invent or copy into a task
  179. message. The latter identifiers keep durable state scoped to one project or
  180. thread instead of leaking it into another workspace.
  181. On Windows, CODEX_DEVKIT_HOST_BRIDGE_HANDLE is intentionally named for
  182. compatibility but accepts only
  183. `pipe:codex-devkit-<launcher-pid>-<creation-filetime>-<high-entropy-token>` (a
  184. launcher PID, its 16-hex Windows creation FILETIME, and a launcher-generated
  185. 128-bit lowercase hex token). The runtime
  186. maps that opaque selector only into the local `\\.\pipe\` namespace, verifies
  187. that the connected pipe server has exactly the encoded launcher PID and process
  188. creation time before sending the session key, and rejects inherited numeric
  189. handles, paths, remote UNC names, and untagged values. The launcher remains
  190. responsible for CSPRNG
  191. generation, first-instance creation, remote-client rejection, and an owner-only
  192. ACL. Unix continues to accept only a numeric inherited descriptor through
  193. CODEX_DEVKIT_HOST_BRIDGE_FD.
  194. Relay lifecycle mutations that need the private host capability broker or proof
  195. registry fail closed when the host does not provide an attested capability,
  196. using RELAY_CAPABILITY_BROKER_UNAVAILABLE. The server never exposes raw
  197. handles or falls back to an unrelated local start.
  198. ## Build the primary artifact
  199. The allowlisted builder creates a deterministic ZIP outside the plugin source
  200. tree. Choose an output directory outside the source tree:
  201. python .codex-plugin/build_main_artifact.py --plugin-root . --output <artifact-output-dir>/2718lab-devkit-v1.2.1.zip
  202. The artifact contains the manifest, .mcp.json, LICENSE, the locked Python
  203. project, and the runtime files selected by
  204. .codex-plugin/main-artifact-allowlist.json. Its executable runtime surface is
  205. the MCP server. The ZIP also carries the Fast Lane contract, required references
  206. and policy assets, the `team_efficiency.py` compatibility entry point, its
  207. routing modules, and the exact `fast-lane-routing`, `code-atlas`, and
  208. `workflow-design` Skill directories whose `agents/openai.yaml` files require
  209. that MCP server. The builder only supports file and directory allowlist roots,
  210. so those three directories are named individually and archive tests reject any
  211. other Skill directory. Command helpers, hooks, CI files, host-private state,
  212. prompts, top-level static agents, and arbitrary repository files remain excluded.
  213. Run Fast Lane through its executable entry point to inspect its fail-closed
  214. result:
  215. python mcp-tools/devkit_fastlane/scripts/team_efficiency.py fast-lane --input <fast-lane-request.json> --reasoning-effort ultra
  216. Legacy host-only switches remain parse-compatible only. The current public CLI
  217. does not read or consume them and cannot activate work. It has no account-usage
  218. coordinator or cache contract.
  219. `CODEX_FASTLANE_TASK_ROOT` and worktree/cache placement are likewise reserved
  220. for a future host-owned execution bridge. The current public compiler neither
  221. creates nor executes a worktree and must not be used as evidence that a
  222. worktree configuration has been accepted.
  223. ## Runtime data and recovery
  224. Persistent data is local. RuntimeConfig resolves the data root in this order:
  225. 1. `CODEX_DEVKIT_DATA_ROOT`, when the host explicitly provides an absolute
  226. directory for this installation.
  227. 2. PLUGIN_DATA, when the host explicitly provides an absolute directory.
  228. 3. CODEX_HOME/data/2718lab-devkit.
  229. 4. The default Codex data directory:
  230. %USERPROFILE%\.codex\data\2718lab-devkit.
  231. For a portable local installation, set `CODEX_DEVKIT_DATA_ROOT` to a durable
  232. G: path (for example `G:\CodexData\.codex\data\2718lab-devkit`). This
  233. override is intentionally separate from the legacy `PLUGIN_DATA` root so an
  234. older checkout cannot open the stable runtime's database by accident.
  235. When the host provides CODEX_PROJECT_ROOT or CODEX_WORKSPACE_ROOT, the durable
  236. root is further scoped below `scoped-v1` by a SHA-256 identity of that project
  237. root. If a project root is unavailable, CODEX_PROJECT_ID, CODEX_WORKSPACE_ID,
  238. or CODEX_THREAD_ID provides a non-path fallback scope. The raw project path or
  239. identity is never written into the scope directory name. This prevents a
  240. long-lived plugin process from projecting one project's workflows, indexes, or
  241. receipts into another project. A command-line invocation with no scope keeps
  242. the unsuffixed root for backwards compatibility; the host integration should
  243. always provide a project or thread scope.
  244. For local DevKit work, set CODEX_TASK_TEMP and its TMPDIR/TEMP/TMP/
  245. PYTHONPYCACHEPREFIX children under an isolated G: task root. A configured
  246. scratch base receives the same scope suffix as durable data. The runtime rejects
  247. unsafe, overlapping, missing, or reparse-point roots and does not write fallback
  248. state into the repository. Hosted Windows CI is the explicit exception: its
  249. workflow must require RUNNER_TEMP and derive CODEX_TASK_TEMP plus all task-local
  250. temporary/cache children below it. That host-provided exception does not prove
  251. an external host embedding.
  252. After a host interruption, resume from the durable workflow lease, endpoint,
  253. artifact references, snapshots, and bounded receipts. Rebind a valid current
  254. context before continuing. Do not reconstruct authority from chat history,
  255. raw logs, or an unrelated new start. Archive a completed independent task only
  256. after evidence, commit, integration, and acceptance have all succeeded.
  257. ### Retention and cleanup boundary
  258. Retention is an explicit host policy, not an inference from a successful or
  259. unverified run. After merge, a host may record `cleanup_candidate` only when the
  260. declared policy's `x` consecutive post-merge integration rounds have each been
  261. explicitly accepted by the coordinator, no rollback occurred in those rounds,
  262. a fresh host recheck is current, and durable evidence contains the candidate,
  263. base, and integration commits together with the required review, verification,
  264. and integration receipts. Pending, observed, inferred, or otherwise
  265. unverified results are not accepted rounds.
  266. `cleanup_candidate` is eligibility evidence only; it is not deletion
  267. authorization. No component automatically deletes a worktree, cache, receipt,
  268. evidence, or user data. If no retention strategy is declared, or if any gate
  269. or evidence is missing, retain the material permanently until an explicit,
  270. separately authorized cleanup policy exists.
  271. Derived project-index snapshots use a separate two-step maintenance command.
  272. Run `uv run python -m devkit_runtime.index_maintenance preview` first, inspect
  273. the exact candidate and protection sets, then pass its unchanged identity to
  274. `uv run python -m devkit_runtime.index_maintenance apply --preview-id <id>`.
  275. Apply holds the Orchestrator writer fence, rechecks cross-database snapshot
  276. references, keeps the newest two snapshots per workspace, and deletes at most
  277. 32 oldest candidates within fixed row and content-hash budgets. Parser-cache
  278. and blob rows are collected only when the approved batch made them unreachable.
  279. New stores use bounded incremental vacuuming; older stores without incremental
  280. auto-vacuum reuse freed SQLite pages internally. Run
  281. `uv run python -m devkit_runtime.index_maintenance compact` to inspect that
  282. boundary; a legacy store returns `RETENTION_FULL_REWRITE_REQUIRED` until the
  283. operator explicitly repeats it with `--allow-full-rewrite`. The one-time rewrite
  284. checks for at least twice the database size plus 64 MiB of free space and stops
  285. on active readers instead of gambling with a low-space database. Compaction
  286. reports observed database/WAL bytes before and after. Any stale preview, missing
  287. schema, budget overflow, lock failure, or
  288. invalid reference fails closed with zero deletion. Atlas data is never an index
  289. cleanup target.
  290. ## Deterministic Fast Lane
  291. The Fast Lane compiler is in
  292. mcp-tools/devkit_fastlane/scripts/fastlane_routing.py and
  293. mcp-tools/devkit_fastlane/scripts/team_efficiency.py. The MCP `fastlane_compile`
  294. entry returns `team-efficiency/fast-lane-plan-v3` for a model-neutral request
  295. only after a read-only
  296. RuntimeRoot unit of work resolves the registered workspace and snapshot. The
  297. snapshot must be current, `INDEX_READY`, bound to the repository Git HEAD, and
  298. its persisted `include_paths` must fully cover every writer `write_scope`.
  299. - `reasoning_effort` is required and accepts only `low`, `medium`, `high`,
  300. `xhigh`, or `max`; the MCP output never dispatches a worker.
  301. - `team-efficiency/fast-lane-plan-v3` fixes `plan_only=true`,
  302. `dispatch_state="not_dispatched"`, and `execution_authorized=false`.
  303. Assignments use `team-efficiency/local-writer-plan-v2`, with bounded
  304. `route_requirements` and coordinator-owned `selection.state="unselected"`;
  305. path-free
  306. `index_evidence` includes snapshot/binding hashes, `include_paths_hash`, and
  307. the compiled `scope_hash`.
  308. - `record_model_selection` binds `plan_item_id`, `requirement_hash`, the exact
  309. model ID and effort, and the coordinator's reason. It is a `selection_only`,
  310. `not_dispatched` record; the dispatch tool remains the availability gate.
  311. An explicit request intent cannot be replaced by a fallback model.
  312. - `INDEX_STALE` rejects filesystem or Git drift. `INDEX_PARTIAL` rejects either
  313. a partial snapshot or any snapshot whose include roots omit a writer scope.
  314. - Caller IDs are selectors, not authority material. The public MCP request and
  315. public `compile_fast_lane` Python API accept no local index root, Git HEAD, or
  316. private planning material.
  317. - The public Python compiler/CLI still does not consume host status, account
  318. usage, index evidence, or a worktree root and remains the blocked plan-v1
  319. diagnostic boundary.
  320. ### Account-usage boundary
  321. Account usage is not a Fast Lane input or routing mechanism. This release has
  322. no account-usage coordinator, cache, or external collector contract.
  323. ## Safety and scope boundaries
  324. - Atlas is deterministic and local. It cannot currently connect to third-party
  325. sources; it does not call an LLM, vector store, network service, shell, or
  326. patch applier.
  327. - Relay compiles explicit packages and returns host actions; it does not
  328. fabricate successful spawns. The host owns the actual Codex dispatch.
  329. - Worktree, branch, lease, task, snapshot, receipt, and evidence identities
  330. are bound and fail closed on stale, forged, cross-workflow, or conflicting
  331. input.
  332. - stdio stdout is protocol-only. Diagnostics go to stderr.
  333. - Runtime data, task scratch, worktrees, caches, and verification evidence
  334. remain local and bounded.
  335. ## Verification
  336. Run the release verification from the revision being built:
  337. cd mcp-tools
  338. uv run --locked pytest -q
  339. uv lock --check
  340. uv run --locked ruff check devkit_atlas/service.py devkit_continuity devkit_runtime/atlas_acceptance.py orchestrator/service.py project_index/checkpoints.py project_index/service.py project_index/store.py
  341. uv run --locked python -m compileall -q devkit_atlas devkit_continuity devkit_runtime orchestrator project_index
  342. CI and fresh-artifact checks are the source of truth for current test counts.
  343. They verify the exact 17-tool inventory, empty prompt/resource lists,
  344. protocol-clean stdout, normal and rejected calls, missing-host capability
  345. failure, and source-checkout independence. This README intentionally does not
  346. freeze a transient regression count.
  347. ## Version
  348. This repository represents the versioned v1.2.1 package. Release notes are
  349. in [CHANGELOG.md](CHANGELOG.md); build and install from the checked-in manifest,
  350. artifact allowlist, and locked dependency set. A maintainer dispatches Release
  351. from current `main`; it validates all declared gates, creates the annotated tag,
  352. and publishes the matching GitHub Release. Pushing a tag alone does not publish.
  353. ## License
  354. [AGPL-3.0](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.