FCoP · Python Core
fcop is the official Python implementation of the File-based Coordination
Protocol (FCoP). It records durable, reviewable coordination facts as UTF-8
Markdown documents with YAML front matter.
Current version: 4.0.5. This package is the protocol Core, Python API, and
local CLI. The optional fcop-mcp package
is a thin adapter over this Core. Core remains the sole authority for protocol
facts, validation, state transitions, idempotency, locking, and recovery.
Install
FCoP 4.0.5 supports Python 3.10–3.13.
python -m pip install "fcop==4.0.5"
Verify the installed distribution:
python -c "from importlib.metadata import version; from fcop import Project; print(version('fcop'), Project)"
Base Protocol boundary
FCoP Core provides:
- Workspace identity and versioned protocol behavior.
- Four durable envelope types: TASK, REPORT, ISSUE, and REVIEW.
- Explicit lifecycle, attempt, relation, evidence, and authorization records.
- Branch families, explicit convergence, and atomic Branch merge.
- Durable idempotency, cross-process locking, and crash-safe recovery.
- Version-selected protocol rules and schemas.
- A typed Python
ProjectAPI with no MCP, LLM, Runtime, or network dependency.
Team models, Solo mode, ME or other fixed roles, seats, and Host sessions are outside the Base Protocol. A Host, Profile, or Runtime may define such concepts, but Core does not require them. Legacy compatibility is also a separate boundary and does not redefine canonical 4.x behavior. FCoP Core can be used independently of CodeFlowMu.
init_workspace and the matching Core workspace API initialize a pure FCoP v4
workspace. They do not create AGENTS.md, CLAUDE.md, Cursor rules, role files,
or session state.
CLI — Setup, inspect, and diagnose
CLI = Setup + Observe + Diagnose; MCP = Work.
| Command | Purpose |
|---|---|
fcop init |
Initialize a pure FCoP workspace |
fcop status |
View workspace status |
fcop inspect |
Inspect TASK / REPORT / ISSUE / REVIEW |
fcop validate |
Validate protocol structure |
fcop tools |
Inspect the installed optional MCP catalog |
fcop doctor |
Diagnose installation, environment, and compatibility |
fcop version |
Show installed versions |
fcop spec |
Show specification and rule identity |
fcop migrate |
Explicitly plan or apply a legacy workspace migration |
Example:
python -m pip install fcop
fcop version
fcop doctor
fcop init --root ./my-project
fcop status --root ./my-project
fcop validate --root ./my-project
python -m pip install fcop-mcp
fcop tools
fcop tools merge_branches --json
Package installation does not initialize a repository, migrate a workspace,
deploy Host instructions, start an MCP server, or modify another application.
Canonical v4 workspace state belongs under <project>/fcop/.
fcop doctor does not access the network or modify Host configuration.
Minimal Python example
from pathlib import Path
from fcop import Project
project = Project(Path("/absolute/path/to/repository"))
workspace = project.create_workspace(protocol_version="4.0")
print(workspace["workspace_id"])
Package boundary
| Package | Responsibility |
|---|---|
fcop |
Protocol Core, Python API, and setup/observe/diagnose CLI |
fcop-mcp |
Optional canonical MCP adapter exposing Core capabilities |
The 4.0.5 default MCP surface contains 25 Canonical MCP Tools and 6 read-only Core Resources. The MCP reference is generated from its canonical manifest. Every entry from the historical 49-tool implementation surface has an explicit disposition in the 4.0.5 migration guide.
中文简介
FCoP 4.0.5 是 File-based Coordination Protocol 的官方 Python Core。
Core 是协议事实、校验和状态迁移的唯一权威；fcop-mcp 只是可选的薄适配层。
Base Protocol 不要求 Team、Solo、ME、seat 或 Host session，这些概念属于
Host、Profile 或 Runtime。Legacy compatibility 也不属于 canonical 4.x 路径。
init_workspace 初始化纯 FCoP v4 工作区，不生成 Host 指令或角色文件。
FCoP Core 可以脱离 CodeFlowMu 独立使用。
Documentation
License
MIT · LICENSE
1 maintainer
Metadata
1 maintainer
Release files for fcop 4.0.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| fcop-4.0.5.tar.gz | 615.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| fcop-4.0.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.3 MB
Release files / fcop-4.0.5.tar.gz
| Download URL | fcop-4.0.5.tar.gz |
|---|---|
| Size | 615.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3a8a6923608905e9e7df337617e68063814fabdddb71dc06537e781b51d151a3
|
|
BLAKE2b-256 checksum How to use checksums |
67e615b039d10a703a644c5d195bf45a22576364de5cb1258a9abf46ae83f5ba
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.9
|
Release files / fcop-4.0.5-py3-none-any.whl
| Download URL | fcop-4.0.5-py3-none-any.whl |
|---|---|
| Size | 732.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3f0c02fc94e91bfc965516ec0d9f546cd1228aaf571e5add3f4229d91fbb9dd3
|
|
BLAKE2b-256 checksum How to use checksums |
4e5bf09689986d1091a36c6ca19304de2d4da36e12a4fbe4746f670ae434ad76
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.9
|
Security for fcop 4.0.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
