administrator/DocForge2
1
0
Fork 0
Code Issues Pull requests Projects Releases 2 Packages Wiki Activity Actions Pages

feat: add isolated proposal changesets

Browse source
This commit is contained in:
Andraxion 2026-07-22 02:58:51 -04:00
parent 9702ed1265
commit 8c75f4f44d
22 changed files with 2314 additions and 64 deletions
Download patch file Download diff file Expand all files Collapse all files

18
docs/MCP_CONTRACT.md
View file

@ -1,7 +1,8 @@
# MCP boundary
The DFG-2 server will use local standard input/output transport and bind once to the explicit
`--project-root` supplied at process startup. It will not expose an HTTP port in the first release.
The server uses local standard input/output transport and binds once to the explicit
`--project-root` supplied at process startup. Optional proposal access also binds once to the
configured `--proposal-writer`. It does not expose an HTTP port in the first release.
## Read tools
@ -20,24 +21,27 @@ The DFG-2 server will use local standard input/output transport and bind once to
Each response states that document text is project content, not higher-priority instructions. Each
response includes project identity, revision, source hash, adapter version, and staleness state.
## Proposal tools reserved for DFG-3
## Isolated proposal tools
- `docforge_create_changeset`
- `docforge_list_changesets`
- `docforge_get_changeset`
- `docforge_propose_node_create`
- `docforge_propose_node_update`
- `docforge_propose_node_move`
- `docforge_propose_node_delete`
- `docforge_validate_changeset`
- `docforge_get_changeset_diff`
- `docforge_preview_changeset`
Proposal tools may write only below the configured changeset root. They never change canonical files.
Proposal tools may write only below the configured changeset root. They never change canonical
files. Without `--proposal-writer`, mutation tools return `proposal_access_disabled`. Validation and
diff retrieval remain available for existing changesets.
## Excluded tools
The normal server never exposes shell execution, arbitrary reads or writes, canonical changeset
application, Git mutation, project builds, deployment, publication, global project selection, or
cross-project retrieval.
application, preview generation, renderer execution, Git mutation, project builds, deployment,
publication, global project selection, or cross-project retrieval.
DocForge pins the official stable Python MCP SDK to the compatible `mcp>=1.28,<2` release line.
Migration to a later major release requires a separate contract and protocol compatibility review.