Metadata-Version: 2.5
Name: fcop
Version: 4.0.1
Summary: FCoP protocol: official Python library — Project API, task/report/issue files, filename parsing, bundled rules. Uses PyYAML and jsonschema; not an MCP server.
Project-URL: Homepage, https://github.com/joinwell52-AI/FCoP
Project-URL: Repository, https://github.com/joinwell52-AI/FCoP
Project-URL: Issues, https://github.com/joinwell52-AI/FCoP/issues
Project-URL: Changelog, https://github.com/joinwell52-AI/FCoP/blob/main/CHANGELOG.md
Project-URL: Documentation, https://github.com/joinwell52-AI/FCoP/blob/main/docs/getting-started.en.md
Project-URL: MCP Tools Reference, https://github.com/joinwell52-AI/FCoP/blob/main/docs/mcp-tools.md
Author: FCoP Maintainers
License-Expression: MIT
License-File: LICENSE
Keywords: agent-coordination,agent-framework,fcop,file-based-protocol,llm-tools,multi-agent,protocol
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: jsonschema<5.0,>=4.0
Requires-Dist: pyyaml<7.0,>=6.0
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == 'dev'
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.5; extra == 'dev'
Requires-Dist: twine>=5.0; extra == 'dev'
Requires-Dist: types-pyyaml; extra == 'dev'
Description-Content-Type: text/markdown

# FCoP — `fcop` (Python package)

**This file is the PyPI long description for the `fcop` package only** — a pure Python
library. It is **not** the MCP server; the optional IDE bridge is the **separate**
[PyPI `fcop-mcp`](https://pypi.org/project/fcop-mcp/) project.

- **FCoP protocol (what it is, no product pitch):**  
  <https://github.com/joinwell52-AI/FCoP/blob/main/docs/getting-started.en.md>
- **This repository (specs, essays, source):**  
  <https://github.com/joinwell52-AI/FCoP>

## FCoP 4.0.0 Stable

4.0.0 promotes the accepted RC without new protocol or tool business behavior.
Workspace identity, four envelopes, Branch, explicit convergence, authorization,
durable idempotency, atomic recovery and rule distribution are provided by Core.
Existing 3.x workspaces retain legacy semantics; installing does not migrate,
redeploy rules or modify other applications. Historical RC 4.0.0rc1 is retained.

## Installation

```bash
python -m pip install fcop==4.0.0
```

Runtime: **Python 3.10+**, **PyYAML** and **jsonschema** — no `fastmcp`, no `websockets`, no LLM SDK.

`fcop` gives you a **`Project` API** for creating and maintaining
`fcop/` (tasks, reports, issues, `fcop.json`, team templates) and
reading/writing the protocol’s Markdown+YAML files. The normative **rules
files** for agents (`fcop-rules.mdc`, `fcop-protocol.mdc`) ship inside the
package and can be written into a repo by `init` / `deploy` flows.

## Minimal example

```python
from fcop import Project

from pathlib import Path
from tempfile import TemporaryDirectory

with TemporaryDirectory(prefix="fcop-demo-") as directory:
    project = Project(Path(directory) / "workspace")
    workspace = project.create_workspace(protocol_version="4.0")
    print(workspace["workspace_id"])
```

## 0.5.x → 0.6.x

The MCP **server** moved to **`fcop-mcp`**; this wheel keeps the **library** and a
`fcop` **compat CLI** that only prints a migration message if someone still
expects the old 0.5 `fcop` command. See:  
<https://github.com/joinwell52-AI/FCoP/blob/main/docs/MIGRATION-0.6.md>

## License

MIT — <https://github.com/joinwell52-AI/FCoP/blob/main/LICENSE>

---

*Full monorepo README, essays, and the optional MCP install guide: same GitHub
repository, not the PyPI `fcop` long description.*
