diff --git a/.zenodo.json b/.zenodo.json index 034bfcdf..76988cc8 100644 --- a/.zenodo.json +++ b/.zenodo.json @@ -1,7 +1,7 @@ { "title": "DotMatch: deterministic known-target short-DNA assignment for sequencing workflows", "upload_type": "software", - "version": "0.7.0", + "version": "0.8.0", "conceptdoi": "10.5281/zenodo.20541628", "creators": [ { diff --git a/CHANGELOG.md b/CHANGELOG.md index 944cd489..9a05cb62 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,17 +1,8 @@ # Changelog -## 0.7.0 — 2026-10-03 - -- Add a guide-counter-compatible counting path, precision boundary fixes, and an audited five-repeat comparison with matching counts. -- Add experimental joint gene-level inference and whole-gene control calibration to CRISPRWorks Fit, with convergence and attainable-FDR diagnostics. -- Stage Fit output bundles, verify consumed inputs, prevent overlapping publication, and reject malformed MLE counts before fitting. -- Add first-run tutorials, scientific audit findings, benchmark graphs and scoped comparison callouts. -- Keep biological validation limitations explicit; experimental Fit is not evidence of general scientific superiority. - - All notable user-facing changes are tracked here. Public statements in release notes must stay aligned with `docs/scientific-claims.md`. -## Unreleased +## 0.8.0 — 2026-10-31 - Add `dotmatch mcp`, a dependency-free local stdio MCP server exposing `route_task`, `count_targets`, `demux_barcodes`, `audit_targets`, `edit_distance` and the six assay tools to Claude Code, Codex, Cursor and other MCP clients. - Add a Claude Code plugin marketplace (`/plugin install dotmatch --marketplace dnncha/dotmatch`) bundling the MCP server and a routing skill. @@ -36,6 +27,14 @@ All notable user-facing changes are tracked here. Public statements in release n - Update the hosted demo's fallback install from DotMatch 0.6.3 to the current 0.6.4 release. +## 0.7.0 — 2026-10-03 + +- Add a guide-counter-compatible counting path, precision boundary fixes, and an audited five-repeat comparison with matching counts. +- Add experimental joint gene-level inference and whole-gene control calibration to CRISPRWorks Fit, with convergence and attainable-FDR diagnostics. +- Stage Fit output bundles, verify consumed inputs, prevent overlapping publication, and reject malformed MLE counts before fitting. +- Add first-run tutorials, scientific audit findings, benchmark graphs and scoped comparison callouts. +- Keep biological validation limitations explicit; experimental Fit is not evidence of general scientific superiority. + ## 0.6.4 - 2026-09-29 ### Fixed diff --git a/CITATION.cff b/CITATION.cff index 4ed56db7..eb84b097 100644 --- a/CITATION.cff +++ b/CITATION.cff @@ -8,7 +8,7 @@ authors: orcid: "https://orcid.org/0009-0003-5012-7229" repository-code: "https://github.com/dnncha/dotmatch" license: Apache-2.0 -version: "0.7.0" +version: "0.8.0" doi: "10.5281/zenodo.23118107" abstract: "DotMatch is a deterministic known-target short-DNA assignment engine for CRISPR guide counting, barcode demultiplexing, and fixed-target FASTQ workflows." keywords: diff --git a/Dockerfile b/Dockerfile index c9b146d1..3713f828 100644 --- a/Dockerfile +++ b/Dockerfile @@ -13,7 +13,7 @@ LABEL org.opencontainers.image.title="DotMatch" \ org.opencontainers.image.source="https://github.com/dnncha/dotmatch" \ org.opencontainers.image.url="https://dotmatch.readthedocs.io/" \ org.opencontainers.image.documentation="https://dotmatch.readthedocs.io/" \ - org.opencontainers.image.version="0.7.0" \ + org.opencontainers.image.version="0.8.0" \ org.opencontainers.image.licenses="Apache-2.0" \ org.opencontainers.image.authors="Donncha O'Toole" COPY --from=build /wheels /wheels diff --git a/README.md b/README.md index 82c851c8..6463a138 100644 --- a/README.md +++ b/README.md @@ -65,11 +65,11 @@ basecaller, cell/UMI pipeline or gene-level hit-calling package. ## Install -Release 0.7.0 is published on PyPI and GHCR. It includes the six `dotmatch agent` tools +Release 0.8.0 is published on PyPI (GHCR has 0.7.0). It includes the six `dotmatch agent` tools described below: ```bash -python3 -m pip install dotmatch==0.7.0 +python3 -m pip install dotmatch==0.8.0 dotmatch --version ``` @@ -143,10 +143,10 @@ best-distance Hamming assignment using the same windows in **one FASTQ pass**. It produces three count matrices, per-guide deltas, read-state transitions, checksums and a self-contained HTML report. It never selects a policy for you. -Run the included synthetic example from a checkout of the v0.7.0 release: +Run the included synthetic example from a checkout of the v0.8.0 release: ```bash -python3 -m pip install dotmatch==0.7.0 +python3 -m pip install dotmatch==0.8.0 dotmatch sensitivity \ --targets examples/assignment_sensitivity/targets.tsv \ --reads examples/assignment_sensitivity/reads.fastq \ @@ -161,7 +161,7 @@ This is sensitivity analysis, not an estimate of biological accuracy. [Explore the interactive review example](https://dnncha.github.io/dotmatch/assignment-sensitivity/) without installing anything. The example uses the public nine-read synthetic fixture. -The interactive assignment review is published on the DotMatch 0.7.0 site. +The interactive assignment review is published on the DotMatch 0.8.0 site. The installed `dotmatch sensitivity` command continues to write its static report. The synthetic fixture demonstrates software behavior, not biological accuracy. @@ -243,8 +243,8 @@ reliability contract is in Add DotMatch as a local MCP server in Claude Code, Codex, Cursor or any MCP client: ```bash -claude mcp add dotmatch -- uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp -codex mcp add dotmatch -- uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp +claude mcp add dotmatch -- uvx dotmatch mcp +codex mcp add dotmatch -- uvx dotmatch mcp ``` Claude Code users can install the plugin, which bundles the MCP server and a routing skill: @@ -255,7 +255,7 @@ Claude Code users can install the plugin, which bundles the MCP server and a rou On older Claude Code versions, run `/plugin marketplace add dnncha/dotmatch` and then `/plugin install dotmatch@dotmatch`. Other MCP clients use `{"mcpServers": {"dotmatch": {"command": "uvx", "args": ["--from", "git+https://github.com/dnncha/dotmatch", "dotmatch", "mcp"]}}}`. With DotMatch already installed from source, `dotmatch mcp` serves the same tools. -The server exposes `route_task`, `count_targets`, `demux_barcodes`, `audit_targets` and `edit_distance` for known-window work, plus the six assay tools above for reviewed CRISPR and Perturb-seq runs. Every tool runs locally, takes structured arguments only, refuses to overwrite existing outputs, and returns the JSON envelope as MCP structured content. `dotmatch mcp` ships on the main branch ahead of the next PyPI release, so the commands above install from source and need a C compiler. +The server exposes `route_task`, `count_targets`, `demux_barcodes`, `audit_targets` and `edit_distance` for known-window work, plus the six assay tools above for reviewed CRISPR and Perturb-seq runs. Every tool runs locally, takes structured arguments only, refuses to overwrite existing outputs, and returns the JSON envelope as MCP structured content. `dotmatch mcp` ships in DotMatch 0.8.0 and later. The six structured agent tools are included in release 0.5.0: diff --git a/agent-capabilities.json b/agent-capabilities.json index ba81154e..5e110297 100644 --- a/agent-capabilities.json +++ b/agent-capabilities.json @@ -1,7 +1,7 @@ { "$schema": "https://dnncha.github.io/dotmatch/agent-capabilities.schema.json", "schema_version": "1.1", - "generated_for_version": "0.7.0", + "generated_for_version": "0.8.0", "project": { "name": "DotMatch", "package": "dotmatch", @@ -27,7 +27,7 @@ ] }, "install": { - "recommended": "python3 -m pip install dotmatch==0.7.0", + "recommended": "python3 -m pip install dotmatch==0.8.0", "verify": "dotmatch --version", "platforms": [ "Linux x86_64 or aarch64 with glibc or musl", @@ -295,7 +295,7 @@ "agent_tools_schema": "https://dnncha.github.io/dotmatch/agent-tools.schema.json", "codex_skill": "https://github.com/dnncha/dotmatch/tree/main/extensions/codex/dotmatch-agent", "mcp_server": "dotmatch mcp", - "mcp_server_no_install": "uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp", + "mcp_server_no_install": "uvx dotmatch mcp", "claude_plugin": "https://github.com/dnncha/dotmatch/tree/main/extensions/claude/dotmatch" } } diff --git a/agent-capabilities.schema.json b/agent-capabilities.schema.json index 7db53c9d..26a33281 100644 --- a/agent-capabilities.schema.json +++ b/agent-capabilities.schema.json @@ -91,7 +91,7 @@ "agent_tools_schema": {"type": "string", "format": "uri"}, "codex_skill": {"type": "string", "format": "uri"}, "mcp_server": {"const": "dotmatch mcp"}, - "mcp_server_no_install": {"const": "uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp"}, + "mcp_server_no_install": {"const": "uvx dotmatch mcp"}, "claude_plugin": {"type": "string", "format": "uri"} } } diff --git a/agent-reference-crispr.json b/agent-reference-crispr.json index 9e1b70fa..f3513f88 100644 --- a/agent-reference-crispr.json +++ b/agent-reference-crispr.json @@ -1,7 +1,7 @@ { "schema_version": "1.0", "tool_contract_version": "1.0", - "dotmatch_version": "0.7.0", + "dotmatch_version": "0.8.0", "tool": "review_assay", "status": "failed", "exit_code": 2, diff --git a/agent-tools.json b/agent-tools.json index 03efee1f..84798153 100644 --- a/agent-tools.json +++ b/agent-tools.json @@ -2,7 +2,7 @@ "$schema": "https://dnncha.github.io/dotmatch/agent-tools.schema.json", "schema_version": "1.0", "tool_contract_version": "1.0", - "generated_for_version": "0.7.0", + "generated_for_version": "0.8.0", "transport": { "input": "one JSON object supplied by file, stdin, or the Python API", "output": "one JSON envelope on stdout or as a Python dictionary", diff --git a/app/site-metadata.ts b/app/site-metadata.ts index 5ceb3dbe..c26f5996 100644 --- a/app/site-metadata.ts +++ b/app/site-metadata.ts @@ -3,7 +3,7 @@ export const siteUrl = (process.env.NEXT_PUBLIC_SITE_URL ?? "https://dnncha.gith export const basePath = (process.env.NEXT_PUBLIC_BASE_PATH ?? "").replace(/\/+$/, ""); export const docsUrl = "https://dotmatch.readthedocs.io/en/latest/"; export const repoUrl = "https://github.com/dnncha/dotmatch"; -export const publishedVersion = "0.7.0"; +export const publishedVersion = "0.8.0"; export const conceptDoi = "https://doi.org/10.5281/zenodo.20541628"; export function sitePath(path = ""): string { const clean = path.replace(/^\/+|\/+$/g, ""); diff --git a/codemeta.json b/codemeta.json index 72b35d09..bc757b39 100644 --- a/codemeta.json +++ b/codemeta.json @@ -9,8 +9,8 @@ "issueTracker": "https://github.com/dnncha/dotmatch/issues", "license": "https://spdx.org/licenses/Apache-2.0", "identifier": "https://doi.org/10.5281/zenodo.20541628", - "version": "0.7.0", - "softwareVersion": "0.7.0", + "version": "0.8.0", + "softwareVersion": "0.8.0", "programmingLanguage": [ "C", "Python", diff --git a/docs/agent-capabilities.json b/docs/agent-capabilities.json index ba81154e..5e110297 100644 --- a/docs/agent-capabilities.json +++ b/docs/agent-capabilities.json @@ -1,7 +1,7 @@ { "$schema": "https://dnncha.github.io/dotmatch/agent-capabilities.schema.json", "schema_version": "1.1", - "generated_for_version": "0.7.0", + "generated_for_version": "0.8.0", "project": { "name": "DotMatch", "package": "dotmatch", @@ -27,7 +27,7 @@ ] }, "install": { - "recommended": "python3 -m pip install dotmatch==0.7.0", + "recommended": "python3 -m pip install dotmatch==0.8.0", "verify": "dotmatch --version", "platforms": [ "Linux x86_64 or aarch64 with glibc or musl", @@ -295,7 +295,7 @@ "agent_tools_schema": "https://dnncha.github.io/dotmatch/agent-tools.schema.json", "codex_skill": "https://github.com/dnncha/dotmatch/tree/main/extensions/codex/dotmatch-agent", "mcp_server": "dotmatch mcp", - "mcp_server_no_install": "uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp", + "mcp_server_no_install": "uvx dotmatch mcp", "claude_plugin": "https://github.com/dnncha/dotmatch/tree/main/extensions/claude/dotmatch" } } diff --git a/docs/agent-capabilities.schema.json b/docs/agent-capabilities.schema.json index 7db53c9d..26a33281 100644 --- a/docs/agent-capabilities.schema.json +++ b/docs/agent-capabilities.schema.json @@ -91,7 +91,7 @@ "agent_tools_schema": {"type": "string", "format": "uri"}, "codex_skill": {"type": "string", "format": "uri"}, "mcp_server": {"const": "dotmatch mcp"}, - "mcp_server_no_install": {"const": "uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp"}, + "mcp_server_no_install": {"const": "uvx dotmatch mcp"}, "claude_plugin": {"type": "string", "format": "uri"} } } diff --git a/docs/agent-guide.md b/docs/agent-guide.md index 0e55a68e..0bcb7639 100644 --- a/docs/agent-guide.md +++ b/docs/agent-guide.md @@ -25,10 +25,10 @@ JSON envelope to stdout and progress or diagnostics to stderr. The Python API exposes the same contract through `dotmatch.agent_tools.list_tools()` and `dotmatch.agent_tools.invoke_tool()`. -Version 0.7.0 is verified on PyPI and GHCR; verify other channels separately. This six-tool interface is included in release 0.7.0. +Version 0.8.0 is verified on PyPI (GHCR has 0.7.0); verify other channels separately. This six-tool interface is included in release 0.8.0. Check `dotmatch --version` before following this route. If a channel provides an older package, use the ordinary CLI commands or `dotmatch capabilities ---json` until that channel reaches 0.7.0. +--json` until that channel reaches 0.8.0. The canonical contract and schema are also published as [`agent-tools.json`](https://dnncha.github.io/dotmatch/agent-tools.json) and @@ -179,8 +179,8 @@ before broadening a workflow or a claim. ## MCP server and Claude Code plugin ```bash -claude mcp add dotmatch -- uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp -codex mcp add dotmatch -- uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp +claude mcp add dotmatch -- uvx dotmatch mcp +codex mcp add dotmatch -- uvx dotmatch mcp ``` Claude Code users can install the plugin, which bundles the MCP server and a routing skill: @@ -191,4 +191,4 @@ Claude Code users can install the plugin, which bundles the MCP server and a rou On older Claude Code versions, run `/plugin marketplace add dnncha/dotmatch` and then `/plugin install dotmatch@dotmatch`. Other MCP clients use `{"mcpServers": {"dotmatch": {"command": "uvx", "args": ["--from", "git+https://github.com/dnncha/dotmatch", "dotmatch", "mcp"]}}}`. With DotMatch already installed from source, `dotmatch mcp` serves the same tools. -The server exposes `route_task`, `count_targets`, `demux_barcodes`, `audit_targets` and `edit_distance` for known-window work, plus the six assay tools above for reviewed CRISPR and Perturb-seq runs. Every tool runs locally, takes structured arguments only, refuses to overwrite existing outputs, and returns the JSON envelope as MCP structured content. `dotmatch mcp` ships on the main branch ahead of the next PyPI release, so the commands above install from source and need a C compiler. +The server exposes `route_task`, `count_targets`, `demux_barcodes`, `audit_targets` and `edit_distance` for known-window work, plus the six assay tools above for reviewed CRISPR and Perturb-seq runs. Every tool runs locally, takes structured arguments only, refuses to overwrite existing outputs, and returns the JSON envelope as MCP structured content. `dotmatch mcp` ships in DotMatch 0.8.0 and later. diff --git a/docs/agent-reference-crispr.json b/docs/agent-reference-crispr.json index 9e1b70fa..f3513f88 100644 --- a/docs/agent-reference-crispr.json +++ b/docs/agent-reference-crispr.json @@ -1,7 +1,7 @@ { "schema_version": "1.0", "tool_contract_version": "1.0", - "dotmatch_version": "0.7.0", + "dotmatch_version": "0.8.0", "tool": "review_assay", "status": "failed", "exit_code": 2, diff --git a/docs/agent-tools.json b/docs/agent-tools.json index 03efee1f..84798153 100644 --- a/docs/agent-tools.json +++ b/docs/agent-tools.json @@ -2,7 +2,7 @@ "$schema": "https://dnncha.github.io/dotmatch/agent-tools.schema.json", "schema_version": "1.0", "tool_contract_version": "1.0", - "generated_for_version": "0.7.0", + "generated_for_version": "0.8.0", "transport": { "input": "one JSON object supplied by file, stdin, or the Python API", "output": "one JSON envelope on stdout or as a Python dictionary", diff --git a/docs/crisprworks.md b/docs/crisprworks.md index 98b1f9fe..76014def 100644 --- a/docs/crisprworks.md +++ b/docs/crisprworks.md @@ -29,7 +29,7 @@ The broader Review tool is planned. The desktop Workbench is developed separatel Install the published package and use its existing command: ```bash -python3 -m pip install dotmatch==0.7.0 +python3 -m pip install dotmatch==0.8.0 dotmatch --version dotmatch demo --out-dir first-run/ ``` diff --git a/docs/index.md b/docs/index.md index 5e26157c..4e5c0eaf 100644 --- a/docs/index.md +++ b/docs/index.md @@ -51,8 +51,8 @@ python3 -m pip install dotmatch dotmatch --version ``` -Release 0.7.0 is published on PyPI and GHCR and includes the six `dotmatch agent` -tools described below. Confirm that `dotmatch --version` reports 0.7.0 before +Release 0.8.0 is published on PyPI (GHCR has 0.7.0) and includes the six `dotmatch agent` +tools described below. Confirm that `dotmatch --version` reports 0.8.0 before using them. Bioconda and BioContainers may lag PyPI; check the installed version when using those channels. diff --git a/docs/llms-full.txt b/docs/llms-full.txt index ba6072c1..8b3fee9d 100644 --- a/docs/llms-full.txt +++ b/docs/llms-full.txt @@ -23,8 +23,8 @@ Each invocation accepts a JSON object, returns one stable JSON envelope on stdou ## MCP server ```bash -claude mcp add dotmatch -- uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp -codex mcp add dotmatch -- uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp +claude mcp add dotmatch -- uvx dotmatch mcp +codex mcp add dotmatch -- uvx dotmatch mcp ``` Claude Code users can install the plugin, which bundles the MCP server and a routing skill: @@ -35,12 +35,12 @@ Claude Code users can install the plugin, which bundles the MCP server and a rou On older Claude Code versions, run `/plugin marketplace add dnncha/dotmatch` and then `/plugin install dotmatch@dotmatch`. Other MCP clients use `{"mcpServers": {"dotmatch": {"command": "uvx", "args": ["--from", "git+https://github.com/dnncha/dotmatch", "dotmatch", "mcp"]}}}`. With DotMatch already installed from source, `dotmatch mcp` serves the same tools. -The server exposes `route_task`, `count_targets`, `demux_barcodes`, `audit_targets` and `edit_distance` for known-window work, plus the six assay tools above for reviewed CRISPR and Perturb-seq runs. Every tool runs locally, takes structured arguments only, refuses to overwrite existing outputs, and returns the JSON envelope as MCP structured content. `dotmatch mcp` ships on the main branch ahead of the next PyPI release, so the commands above install from source and need a C compiler. +The server exposes `route_task`, `count_targets`, `demux_barcodes`, `audit_targets` and `edit_distance` for known-window work, plus the six assay tools above for reviewed CRISPR and Perturb-seq runs. Every tool runs locally, takes structured arguments only, refuses to overwrite existing outputs, and returns the JSON envelope as MCP structured content. `dotmatch mcp` ships in DotMatch 0.8.0 and later. ## Install and verify -Version 0.7.0 is published and verified on PyPI and GHCR. Bioconda and -BioContainers 0.7.0 still require upstream submission and public verification. +Version 0.8.0 is published and verified on PyPI (GHCR has 0.7.0). Bioconda and +BioContainers 0.8.0 still require upstream submission and public verification. Linux x86_64 and macOS 11 or newer: @@ -48,7 +48,7 @@ Linux x86_64 and macOS 11 or newer: mkdir -p smoke-output python3 -m venv .venv . .venv/bin/activate -python3 -m pip install dotmatch==0.7.0 +python3 -m pip install dotmatch==0.8.0 dotmatch --version ``` @@ -226,7 +226,7 @@ After cloning this repository, this recipe installs the release into a new virtu ```bash python3 -m venv .venv . .venv/bin/activate -python3 -m pip install dotmatch==0.7.0 +python3 -m pip install dotmatch==0.8.0 dotmatch count \ --targets demo-data/crispr_guides.tsv \ --reads demo-data/reads.fastq \ diff --git a/docs/llms.txt b/docs/llms.txt index 95023e7a..01545149 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -2,7 +2,7 @@ > DotMatch is an Apache-2.0 command-line and Python tool for deterministic fixed-window assignment of FASTQ reads to a finite list of known short DNA targets. Use it for CRISPR guide counting, inline barcode demultiplexing, per-read feature-barcode or guide-capture assignment, barcode panel design, and other known-target matching. It is not a genome aligner, basecaller, UMI or cell quantifier, variant caller, or downstream screen-statistics package. -Install the verified 0.7.0 release with `python3 -m pip install dotmatch==0.7.0` and verify it with `dotmatch --version`. DotMatch 0.4 introduced six structured, local-only `dotmatch agent` tools. Run `dotmatch demo --out-dir first-run/` for a packaged offline synthetic check; use `dotmatch compare-counts` to compare raw count tables by guide and sample ID. Neither command establishes biological accuracy. Use `dotmatch capabilities --json` or the public capability manifest for task routing. MCP clients (Claude Code, Codex, Cursor) can run `claude mcp add dotmatch -- uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp` or install the Claude Code plugin with `/plugin install dotmatch --marketplace dnncha/dotmatch`; tools include `route_task`, `count_targets`, `demux_barcodes`, `audit_targets` and the six assay tools. Coordinates are zero-based. Count only `unique` assignments; `ambiguous`, `none`, and `invalid` remain separate. Audit a target list before enabling mismatch correction. +Install the verified 0.8.0 release with `python3 -m pip install dotmatch==0.8.0` and verify it with `dotmatch --version`. DotMatch 0.4 introduced six structured, local-only `dotmatch agent` tools. Run `dotmatch demo --out-dir first-run/` for a packaged offline synthetic check; use `dotmatch compare-counts` to compare raw count tables by guide and sample ID. Neither command establishes biological accuracy. Use `dotmatch capabilities --json` or the public capability manifest for task routing. MCP clients (Claude Code, Codex, Cursor) can run `claude mcp add dotmatch -- uvx dotmatch mcp` or install the Claude Code plugin with `/plugin install dotmatch --marketplace dnncha/dotmatch`; tools include `route_task`, `count_targets`, `demux_barcodes`, `audit_targets` and the six assay tools. Coordinates are zero-based. Count only `unique` assignments; `ambiguous`, `none`, and `invalid` remain separate. Audit a target list before enabling mismatch correction. ## Agent start diff --git a/docs/releases/v0.8.0.md b/docs/releases/v0.8.0.md new file mode 100644 index 00000000..fad54617 --- /dev/null +++ b/docs/releases/v0.8.0.md @@ -0,0 +1,23 @@ +# DotMatch 0.8.0 + +This release makes DotMatch available to coding agents as a local MCP server. + +`dotmatch mcp` is a dependency-free stdio MCP server. It exposes +`route_task`, `count_targets`, `demux_barcodes`, `audit_targets` and +`edit_distance` for known-window work, plus the six assay tools, to Claude +Code, Codex, Cursor and other MCP clients. Every tool runs locally, accepts +structured arguments only and refuses to overwrite existing outputs. + +```bash +claude mcp add dotmatch -- uvx dotmatch mcp +``` + +The Claude Code plugin (`/plugin install dotmatch --marketplace dnncha/dotmatch`) +bundles the server with a routing skill. + +The release also adds a strict typed Python surface, a scientific reliability +gate with targeted mutation tests, immutable result records and faster Python +bindings. See the CHANGELOG for the full list. + +This release is published on PyPI. GHCR, Bioconda and BioContainers still +carry 0.7.0. diff --git a/docs/tutorials/crispr-count-first-run.md b/docs/tutorials/crispr-count-first-run.md index 785a6562..35a85e6d 100644 --- a/docs/tutorials/crispr-count-first-run.md +++ b/docs/tutorials/crispr-count-first-run.md @@ -22,13 +22,13 @@ command; evaluate your assay and matching policy separately. The released package can be installed with: ```bash -python3 -m pip install dotmatch==0.7.0 +python3 -m pip install dotmatch==0.8.0 dotmatch --version ``` -DotMatch 0.7.0 includes the checked offline demo, `dotmatch compare-counts`, +DotMatch 0.8.0 includes the checked offline demo, `dotmatch compare-counts`, and the validated `crispr quickstart --link-reads` option. Use the published -package and confirm `dotmatch --version` reports 0.7.0 before following this +package and confirm `dotmatch --version` reports 0.8.0 before following this tutorial. For a no-install view using the public synthetic fixture, open the @@ -36,7 +36,7 @@ For a no-install view using the public synthetic fixture, open the ## 1. Get a checked result without assembling files -From an installed DotMatch 0.7.0 package: +From an installed DotMatch 0.8.0 package: ```bash dotmatch demo --out-dir first-run/ @@ -85,7 +85,7 @@ dotmatch crispr quickstart \ ``` Use paths that match your actual naming convention. Repeat `--fastq` for more -input patterns. DotMatch 0.7.0 requires every argument to resolve: one valid +input patterns. DotMatch 0.8.0 requires every argument to resolve: one valid file does not excuse a second missing pattern. Duplicate inputs, colliding basenames, non-files and invalid resource limits are rejected before a project is created. Existing output paths are never overwritten. @@ -131,7 +131,7 @@ the top-level `status = "draft"` to `status = "ready"` in `assay.toml`, then run dotmatch assay start crispr-screen/assay.toml ``` -DotMatch 0.7.0's explicit `--accept-inference` option only starts a run +DotMatch 0.8.0's explicit `--accept-inference` option only starts a run when inference itself reports ready. It no longer promotes an uncertain inference automatically. `--no-run` always leaves the project in draft. @@ -149,7 +149,7 @@ The matrix contains `sgRNA`, `Gene`, then one raw integer count column per sample. Only unique assignments add target counts. Ambiguous, unmatched and invalid-window reads remain visible in the QC outputs. -For a side-by-side evaluation with DotMatch 0.7.0: +For a side-by-side evaluation with DotMatch 0.8.0: ```bash dotmatch compare-counts \ diff --git a/extensions/claude/dotmatch/.mcp.json b/extensions/claude/dotmatch/.mcp.json index 4203193e..20435ab4 100644 --- a/extensions/claude/dotmatch/.mcp.json +++ b/extensions/claude/dotmatch/.mcp.json @@ -3,8 +3,6 @@ "dotmatch": { "command": "uvx", "args": [ - "--from", - "git+https://github.com/dnncha/dotmatch", "dotmatch", "mcp" ] diff --git a/include/qdalign.h b/include/qdalign.h index 97b78c7a..f3df6b3d 100644 --- a/include/qdalign.h +++ b/include/qdalign.h @@ -7,7 +7,7 @@ extern "C" { #endif -#define QDALN_VERSION "0.7.0" +#define QDALN_VERSION "0.8.0" #define QDALN_ALPHABET_POLICY "literal-byte; A/C/G/T/N/IUPAC symbols are ordinary byte symbols; no wildcard expansion" enum qdaln_match_status { diff --git a/llms-full.txt b/llms-full.txt index ba6072c1..8b3fee9d 100644 --- a/llms-full.txt +++ b/llms-full.txt @@ -23,8 +23,8 @@ Each invocation accepts a JSON object, returns one stable JSON envelope on stdou ## MCP server ```bash -claude mcp add dotmatch -- uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp -codex mcp add dotmatch -- uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp +claude mcp add dotmatch -- uvx dotmatch mcp +codex mcp add dotmatch -- uvx dotmatch mcp ``` Claude Code users can install the plugin, which bundles the MCP server and a routing skill: @@ -35,12 +35,12 @@ Claude Code users can install the plugin, which bundles the MCP server and a rou On older Claude Code versions, run `/plugin marketplace add dnncha/dotmatch` and then `/plugin install dotmatch@dotmatch`. Other MCP clients use `{"mcpServers": {"dotmatch": {"command": "uvx", "args": ["--from", "git+https://github.com/dnncha/dotmatch", "dotmatch", "mcp"]}}}`. With DotMatch already installed from source, `dotmatch mcp` serves the same tools. -The server exposes `route_task`, `count_targets`, `demux_barcodes`, `audit_targets` and `edit_distance` for known-window work, plus the six assay tools above for reviewed CRISPR and Perturb-seq runs. Every tool runs locally, takes structured arguments only, refuses to overwrite existing outputs, and returns the JSON envelope as MCP structured content. `dotmatch mcp` ships on the main branch ahead of the next PyPI release, so the commands above install from source and need a C compiler. +The server exposes `route_task`, `count_targets`, `demux_barcodes`, `audit_targets` and `edit_distance` for known-window work, plus the six assay tools above for reviewed CRISPR and Perturb-seq runs. Every tool runs locally, takes structured arguments only, refuses to overwrite existing outputs, and returns the JSON envelope as MCP structured content. `dotmatch mcp` ships in DotMatch 0.8.0 and later. ## Install and verify -Version 0.7.0 is published and verified on PyPI and GHCR. Bioconda and -BioContainers 0.7.0 still require upstream submission and public verification. +Version 0.8.0 is published and verified on PyPI (GHCR has 0.7.0). Bioconda and +BioContainers 0.8.0 still require upstream submission and public verification. Linux x86_64 and macOS 11 or newer: @@ -48,7 +48,7 @@ Linux x86_64 and macOS 11 or newer: mkdir -p smoke-output python3 -m venv .venv . .venv/bin/activate -python3 -m pip install dotmatch==0.7.0 +python3 -m pip install dotmatch==0.8.0 dotmatch --version ``` @@ -226,7 +226,7 @@ After cloning this repository, this recipe installs the release into a new virtu ```bash python3 -m venv .venv . .venv/bin/activate -python3 -m pip install dotmatch==0.7.0 +python3 -m pip install dotmatch==0.8.0 dotmatch count \ --targets demo-data/crispr_guides.tsv \ --reads demo-data/reads.fastq \ diff --git a/llms.txt b/llms.txt index 95023e7a..01545149 100644 --- a/llms.txt +++ b/llms.txt @@ -2,7 +2,7 @@ > DotMatch is an Apache-2.0 command-line and Python tool for deterministic fixed-window assignment of FASTQ reads to a finite list of known short DNA targets. Use it for CRISPR guide counting, inline barcode demultiplexing, per-read feature-barcode or guide-capture assignment, barcode panel design, and other known-target matching. It is not a genome aligner, basecaller, UMI or cell quantifier, variant caller, or downstream screen-statistics package. -Install the verified 0.7.0 release with `python3 -m pip install dotmatch==0.7.0` and verify it with `dotmatch --version`. DotMatch 0.4 introduced six structured, local-only `dotmatch agent` tools. Run `dotmatch demo --out-dir first-run/` for a packaged offline synthetic check; use `dotmatch compare-counts` to compare raw count tables by guide and sample ID. Neither command establishes biological accuracy. Use `dotmatch capabilities --json` or the public capability manifest for task routing. MCP clients (Claude Code, Codex, Cursor) can run `claude mcp add dotmatch -- uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp` or install the Claude Code plugin with `/plugin install dotmatch --marketplace dnncha/dotmatch`; tools include `route_task`, `count_targets`, `demux_barcodes`, `audit_targets` and the six assay tools. Coordinates are zero-based. Count only `unique` assignments; `ambiguous`, `none`, and `invalid` remain separate. Audit a target list before enabling mismatch correction. +Install the verified 0.8.0 release with `python3 -m pip install dotmatch==0.8.0` and verify it with `dotmatch --version`. DotMatch 0.4 introduced six structured, local-only `dotmatch agent` tools. Run `dotmatch demo --out-dir first-run/` for a packaged offline synthetic check; use `dotmatch compare-counts` to compare raw count tables by guide and sample ID. Neither command establishes biological accuracy. Use `dotmatch capabilities --json` or the public capability manifest for task routing. MCP clients (Claude Code, Codex, Cursor) can run `claude mcp add dotmatch -- uvx dotmatch mcp` or install the Claude Code plugin with `/plugin install dotmatch --marketplace dnncha/dotmatch`; tools include `route_task`, `count_targets`, `demux_barcodes`, `audit_targets` and the six assay tools. Coordinates are zero-based. Count only `unique` assignments; `ambiguous`, `none`, and `invalid` remain separate. Audit a target list before enabling mismatch correction. ## Agent start diff --git a/package-lock.json b/package-lock.json index cfae92b1..deed3343 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "dotmatch-site", - "version": "0.7.0", + "version": "0.8.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "dotmatch-site", - "version": "0.7.0", + "version": "0.8.0", "license": "Apache-2.0", "dependencies": { "next": "^16.3.6", diff --git a/package.json b/package.json index 32820b54..0682116a 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "dotmatch-site", - "version": "0.7.0", + "version": "0.8.0", "private": true, "scripts": { "dev": "next dev", diff --git a/packaging/bioconda/assaycode-meta.yaml b/packaging/bioconda/assaycode-meta.yaml index 24ec6fc3..b7f1850f 100644 --- a/packaging/bioconda/assaycode-meta.yaml +++ b/packaging/bioconda/assaycode-meta.yaml @@ -1,4 +1,4 @@ -{% set version = "0.7.0" %} +{% set version = "0.8.0" %} package: name: assaycode diff --git a/packaging/bioconda/meta.yaml b/packaging/bioconda/meta.yaml index 926b8e2c..245e3242 100644 --- a/packaging/bioconda/meta.yaml +++ b/packaging/bioconda/meta.yaml @@ -1,5 +1,5 @@ {% set name = "dotmatch" %} -{% set version = "0.7.0" %} +{% set version = "0.8.0" %} {% set sha256 = "REPLACE_WITH_RELEASE_TARBALL_SHA256" %} package: diff --git a/public/agent-capabilities.json b/public/agent-capabilities.json index ba81154e..5e110297 100644 --- a/public/agent-capabilities.json +++ b/public/agent-capabilities.json @@ -1,7 +1,7 @@ { "$schema": "https://dnncha.github.io/dotmatch/agent-capabilities.schema.json", "schema_version": "1.1", - "generated_for_version": "0.7.0", + "generated_for_version": "0.8.0", "project": { "name": "DotMatch", "package": "dotmatch", @@ -27,7 +27,7 @@ ] }, "install": { - "recommended": "python3 -m pip install dotmatch==0.7.0", + "recommended": "python3 -m pip install dotmatch==0.8.0", "verify": "dotmatch --version", "platforms": [ "Linux x86_64 or aarch64 with glibc or musl", @@ -295,7 +295,7 @@ "agent_tools_schema": "https://dnncha.github.io/dotmatch/agent-tools.schema.json", "codex_skill": "https://github.com/dnncha/dotmatch/tree/main/extensions/codex/dotmatch-agent", "mcp_server": "dotmatch mcp", - "mcp_server_no_install": "uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp", + "mcp_server_no_install": "uvx dotmatch mcp", "claude_plugin": "https://github.com/dnncha/dotmatch/tree/main/extensions/claude/dotmatch" } } diff --git a/public/agent-capabilities.schema.json b/public/agent-capabilities.schema.json index 7db53c9d..26a33281 100644 --- a/public/agent-capabilities.schema.json +++ b/public/agent-capabilities.schema.json @@ -91,7 +91,7 @@ "agent_tools_schema": {"type": "string", "format": "uri"}, "codex_skill": {"type": "string", "format": "uri"}, "mcp_server": {"const": "dotmatch mcp"}, - "mcp_server_no_install": {"const": "uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp"}, + "mcp_server_no_install": {"const": "uvx dotmatch mcp"}, "claude_plugin": {"type": "string", "format": "uri"} } } diff --git a/public/agent-reference-crispr.json b/public/agent-reference-crispr.json index 9e1b70fa..f3513f88 100644 --- a/public/agent-reference-crispr.json +++ b/public/agent-reference-crispr.json @@ -1,7 +1,7 @@ { "schema_version": "1.0", "tool_contract_version": "1.0", - "dotmatch_version": "0.7.0", + "dotmatch_version": "0.8.0", "tool": "review_assay", "status": "failed", "exit_code": 2, diff --git a/public/agent-tools.json b/public/agent-tools.json index 03efee1f..84798153 100644 --- a/public/agent-tools.json +++ b/public/agent-tools.json @@ -2,7 +2,7 @@ "$schema": "https://dnncha.github.io/dotmatch/agent-tools.schema.json", "schema_version": "1.0", "tool_contract_version": "1.0", - "generated_for_version": "0.7.0", + "generated_for_version": "0.8.0", "transport": { "input": "one JSON object supplied by file, stdin, or the Python API", "output": "one JSON envelope on stdout or as a Python dictionary", diff --git a/public/llms-full.txt b/public/llms-full.txt index ba6072c1..8b3fee9d 100644 --- a/public/llms-full.txt +++ b/public/llms-full.txt @@ -23,8 +23,8 @@ Each invocation accepts a JSON object, returns one stable JSON envelope on stdou ## MCP server ```bash -claude mcp add dotmatch -- uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp -codex mcp add dotmatch -- uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp +claude mcp add dotmatch -- uvx dotmatch mcp +codex mcp add dotmatch -- uvx dotmatch mcp ``` Claude Code users can install the plugin, which bundles the MCP server and a routing skill: @@ -35,12 +35,12 @@ Claude Code users can install the plugin, which bundles the MCP server and a rou On older Claude Code versions, run `/plugin marketplace add dnncha/dotmatch` and then `/plugin install dotmatch@dotmatch`. Other MCP clients use `{"mcpServers": {"dotmatch": {"command": "uvx", "args": ["--from", "git+https://github.com/dnncha/dotmatch", "dotmatch", "mcp"]}}}`. With DotMatch already installed from source, `dotmatch mcp` serves the same tools. -The server exposes `route_task`, `count_targets`, `demux_barcodes`, `audit_targets` and `edit_distance` for known-window work, plus the six assay tools above for reviewed CRISPR and Perturb-seq runs. Every tool runs locally, takes structured arguments only, refuses to overwrite existing outputs, and returns the JSON envelope as MCP structured content. `dotmatch mcp` ships on the main branch ahead of the next PyPI release, so the commands above install from source and need a C compiler. +The server exposes `route_task`, `count_targets`, `demux_barcodes`, `audit_targets` and `edit_distance` for known-window work, plus the six assay tools above for reviewed CRISPR and Perturb-seq runs. Every tool runs locally, takes structured arguments only, refuses to overwrite existing outputs, and returns the JSON envelope as MCP structured content. `dotmatch mcp` ships in DotMatch 0.8.0 and later. ## Install and verify -Version 0.7.0 is published and verified on PyPI and GHCR. Bioconda and -BioContainers 0.7.0 still require upstream submission and public verification. +Version 0.8.0 is published and verified on PyPI (GHCR has 0.7.0). Bioconda and +BioContainers 0.8.0 still require upstream submission and public verification. Linux x86_64 and macOS 11 or newer: @@ -48,7 +48,7 @@ Linux x86_64 and macOS 11 or newer: mkdir -p smoke-output python3 -m venv .venv . .venv/bin/activate -python3 -m pip install dotmatch==0.7.0 +python3 -m pip install dotmatch==0.8.0 dotmatch --version ``` @@ -226,7 +226,7 @@ After cloning this repository, this recipe installs the release into a new virtu ```bash python3 -m venv .venv . .venv/bin/activate -python3 -m pip install dotmatch==0.7.0 +python3 -m pip install dotmatch==0.8.0 dotmatch count \ --targets demo-data/crispr_guides.tsv \ --reads demo-data/reads.fastq \ diff --git a/public/llms.txt b/public/llms.txt index 95023e7a..01545149 100644 --- a/public/llms.txt +++ b/public/llms.txt @@ -2,7 +2,7 @@ > DotMatch is an Apache-2.0 command-line and Python tool for deterministic fixed-window assignment of FASTQ reads to a finite list of known short DNA targets. Use it for CRISPR guide counting, inline barcode demultiplexing, per-read feature-barcode or guide-capture assignment, barcode panel design, and other known-target matching. It is not a genome aligner, basecaller, UMI or cell quantifier, variant caller, or downstream screen-statistics package. -Install the verified 0.7.0 release with `python3 -m pip install dotmatch==0.7.0` and verify it with `dotmatch --version`. DotMatch 0.4 introduced six structured, local-only `dotmatch agent` tools. Run `dotmatch demo --out-dir first-run/` for a packaged offline synthetic check; use `dotmatch compare-counts` to compare raw count tables by guide and sample ID. Neither command establishes biological accuracy. Use `dotmatch capabilities --json` or the public capability manifest for task routing. MCP clients (Claude Code, Codex, Cursor) can run `claude mcp add dotmatch -- uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp` or install the Claude Code plugin with `/plugin install dotmatch --marketplace dnncha/dotmatch`; tools include `route_task`, `count_targets`, `demux_barcodes`, `audit_targets` and the six assay tools. Coordinates are zero-based. Count only `unique` assignments; `ambiguous`, `none`, and `invalid` remain separate. Audit a target list before enabling mismatch correction. +Install the verified 0.8.0 release with `python3 -m pip install dotmatch==0.8.0` and verify it with `dotmatch --version`. DotMatch 0.4 introduced six structured, local-only `dotmatch agent` tools. Run `dotmatch demo --out-dir first-run/` for a packaged offline synthetic check; use `dotmatch compare-counts` to compare raw count tables by guide and sample ID. Neither command establishes biological accuracy. Use `dotmatch capabilities --json` or the public capability manifest for task routing. MCP clients (Claude Code, Codex, Cursor) can run `claude mcp add dotmatch -- uvx dotmatch mcp` or install the Claude Code plugin with `/plugin install dotmatch --marketplace dnncha/dotmatch`; tools include `route_task`, `count_targets`, `demux_barcodes`, `audit_targets` and the six assay tools. Coordinates are zero-based. Count only `unique` assignments; `ambiguous`, `none`, and `invalid` remain separate. Audit a target list before enabling mismatch correction. ## Agent start diff --git a/pyproject.toml b/pyproject.toml index 0fb12b58..64e06d61 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta" [project] name = "dotmatch" -version = "0.7.0" +version = "0.8.0" description = "Known-target short-DNA assignment from FASTQ for CRISPR guides, barcodes, feature tags, primers, and other targets" readme = "README.md" requires-python = ">=3.9" diff --git a/python/dotmatch/__init__.py b/python/dotmatch/__init__.py index 8a583d7d..7ca8a99f 100644 --- a/python/dotmatch/__init__.py +++ b/python/dotmatch/__init__.py @@ -74,7 +74,7 @@ def _source_tree_version() -> Optional[str]: try: __version__ = _source_tree_version() or _metadata_version("dotmatch") except PackageNotFoundError: - __version__ = "0.7.0" + __version__ = "0.8.0" __all__ = [ "__version__", diff --git a/python/dotmatch/data/agent-capabilities.json b/python/dotmatch/data/agent-capabilities.json index ba81154e..5e110297 100644 --- a/python/dotmatch/data/agent-capabilities.json +++ b/python/dotmatch/data/agent-capabilities.json @@ -1,7 +1,7 @@ { "$schema": "https://dnncha.github.io/dotmatch/agent-capabilities.schema.json", "schema_version": "1.1", - "generated_for_version": "0.7.0", + "generated_for_version": "0.8.0", "project": { "name": "DotMatch", "package": "dotmatch", @@ -27,7 +27,7 @@ ] }, "install": { - "recommended": "python3 -m pip install dotmatch==0.7.0", + "recommended": "python3 -m pip install dotmatch==0.8.0", "verify": "dotmatch --version", "platforms": [ "Linux x86_64 or aarch64 with glibc or musl", @@ -295,7 +295,7 @@ "agent_tools_schema": "https://dnncha.github.io/dotmatch/agent-tools.schema.json", "codex_skill": "https://github.com/dnncha/dotmatch/tree/main/extensions/codex/dotmatch-agent", "mcp_server": "dotmatch mcp", - "mcp_server_no_install": "uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp", + "mcp_server_no_install": "uvx dotmatch mcp", "claude_plugin": "https://github.com/dnncha/dotmatch/tree/main/extensions/claude/dotmatch" } } diff --git a/python/dotmatch/data/agent-capabilities.schema.json b/python/dotmatch/data/agent-capabilities.schema.json index 7db53c9d..26a33281 100644 --- a/python/dotmatch/data/agent-capabilities.schema.json +++ b/python/dotmatch/data/agent-capabilities.schema.json @@ -91,7 +91,7 @@ "agent_tools_schema": {"type": "string", "format": "uri"}, "codex_skill": {"type": "string", "format": "uri"}, "mcp_server": {"const": "dotmatch mcp"}, - "mcp_server_no_install": {"const": "uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp"}, + "mcp_server_no_install": {"const": "uvx dotmatch mcp"}, "claude_plugin": {"type": "string", "format": "uri"} } } diff --git a/python/dotmatch/data/agent-tools.json b/python/dotmatch/data/agent-tools.json index 03efee1f..84798153 100644 --- a/python/dotmatch/data/agent-tools.json +++ b/python/dotmatch/data/agent-tools.json @@ -2,7 +2,7 @@ "$schema": "https://dnncha.github.io/dotmatch/agent-tools.schema.json", "schema_version": "1.0", "tool_contract_version": "1.0", - "generated_for_version": "0.7.0", + "generated_for_version": "0.8.0", "transport": { "input": "one JSON object supplied by file, stdin, or the Python API", "output": "one JSON envelope on stdout or as a Python dictionary", diff --git a/python/dotmatch/mcp_server.py b/python/dotmatch/mcp_server.py index c7a7aafa..87e34df5 100644 --- a/python/dotmatch/mcp_server.py +++ b/python/dotmatch/mcp_server.py @@ -539,7 +539,7 @@ def main(argv: Sequence[str] = ()) -> int: " claude mcp add dotmatch -- dotmatch mcp\n" " codex mcp add dotmatch -- dotmatch mcp\n" ' {"mcpServers": {"dotmatch": {"command": "dotmatch", "args": ["mcp"]}}}\n' - "Or without installing: uvx --from git+https://github.com/dnncha/dotmatch dotmatch mcp" + "Or without installing: uvx dotmatch mcp" ) return 0 if argv: