ds-compatible

Offline conformance prototypes for DeepSeek agent continuity work.

This is not an official DeepSeek project, not a compatibility certification, and not an adoption claim. The default path does not call providers, execute tools, write target files, write memory backends, publish artifacts, or perform outreach.

Public repository: https://github.com/ctxyao/ds-compatible

Latest release: https://github.com/ctxyao/ds-compatible/releases/tag/v0.1.0

License: Apache-2.0

Week 1 Gate

Validate synthetic traces and produce receipt JSON:

PYTHONPATH=src python3 -m ds_agent_conformance validate-trace fixtures/traces/valid_tool_reasoning_custody.json --receipt /tmp/receipt.json
PYTHONPATH=src python3 -m ds_agent_conformance render-receipt /tmp/receipt.json
PYTHONPATH=src python3 -m ds_agent_conformance validate-receipt /tmp/receipt.json

List bundled examples:

PYTHONPATH=src python3 -m ds_agent_conformance examples

Run the local gate:

PYTHONPATH=src python3 -m unittest tests/test_validator.py
PYTHONPATH=src python3 -m unittest tests/test_benchmark.py
PYTHONPATH=src python3 -m unittest tests/test_codewhale.py
PYTHONPATH=src python3 -m ds_agent_conformance benchmark
PYTHONPATH=src python3 scripts/check_week1_gate.py
PYTHONPATH=src python3 scripts/check_week2_product_gate.py
PYTHONPATH=src python3 -m ds_agent_conformance real-repo readiness
PYTHONPATH=src python3 scripts/check_real_repo_dry_run_gate.py
PYTHONPATH=src python3 scripts/generate_local_drafts.py
PYTHONPATH=src python3 scripts/generate_ecosystem_packet.py
PYTHONPATH=src python3 scripts/check_launch_readiness.py
PYTHONPATH=src python3 scripts/check_product_release_gate.py

Local Quantification

The local benchmark reports only synthetic-fixture quality. It can quantify:

• positive fixture pass rate
• negative corpus rejection rate
• diagnostic localization rate
• invariant-family coverage
• risk-rejection lift versus a no-gate baseline
• runtime and receipt-size overhead
• local product-impact proxy metrics: review-time reduction, fix suggestions, source refs preserved, rollback/action boundary preservation, and maintainer-actionability score

It cannot yet quantify real downstream integration savings, maintainer adoption, or product efficiency. Those require Week 2/3 dry-runs against real agent integrations.

scripts/check_week2_product_gate.py is the current local productization gate. It can mark real repo dry-run as ready, but it keeps adoption claims and product-optimization claims false.

Read-only Real Repo Dry-Runs

Current dry-run targets:

• DeepSeek-TUI
• Reasonix
• Codex via Moon Bridge
• Claude Code through the DeepSeek Anthropic endpoint

Run:

PYTHONPATH=src python3 -m ds_agent_conformance real-repo readiness
PYTHONPATH=src python3 scripts/generate_local_drafts.py

The generated drafts are local-only notes under artifacts/drafts/. They are not published issues, PRs, adoption evidence, or external product-optimization evidence.

The ecosystem readiness packet is written under artifacts/ecosystem-packet/. It is an owner-review packet, not adoption or product-optimization evidence.

DeepSeek-TUI First Target Plan

The first-target implementation plan has a published proposal issue but no target-code PR authorization:

• docs/deepseek-tui-receipt-export-implementation-plan.md
• artifacts/deepseek-tui/implementation-plan.json

Gate:

PYTHONPATH=src python3 scripts/check_deepseek_tui_plan.py

CodeWhale Receipt Builder

Build and validate a public-safe CodeWhale runtime receipt:

PYTHONPATH=src python3 -m ds_agent_conformance codewhale build-receipt fixtures/codewhale/valid_completed_turn.json --receipt /tmp/codewhale-receipt.json
PYTHONPATH=src python3 -m ds_agent_conformance codewhale validate-receipt /tmp/codewhale-receipt.json

The builder is pure/offline: it reads a fixture and writes an optional receipt. It does not call providers, execute tools, write target files, mutate memory, or perform outreach.

Product Release Gate

The local product release standard is documented in docs/product-release-criteria.md.

Run:

PYTHONPATH=src python3 scripts/check_product_release_gate.py

The gate writes:

artifacts/release/product-release-readiness-2026-06-01.json

Release artifacts:

• docs/release-notes-v0.1.0.md
• artifacts/release/release-manifest-0.1.0.json
• artifacts/release/github-publication-receipt-2026-06-01.json

Strategy Confidence Gate

This gate checks whether every known uncertainty has been converted into a testable, auditable, rollbackable constraint. It does not claim external success.

PYTHONPATH=src python3 scripts/check_strategy_confidence.py

Outreach Packet

The CodeWhale-first outreach packet is an owner-approved attempt packet, not an adoption or endorsement claim:

• artifacts/source-recheck/deepseek-tui-2026-06-01.json
• artifacts/outreach/owner-approval-2026-06-01.json
• artifacts/outreach/codewhale-issue-draft.md
• artifacts/outreach/publication-receipt-2026-06-01.json

The current publication target is Hmbown/CodeWhale; Hmbown/DeepSeek-TUI is treated as a legacy ecosystem reference unless same-day source recheck changes that.

Published proposal: Hmbown/CodeWhale#2556

Gate:

PYTHONPATH=src python3 scripts/check_outreach_packet.py
PYTHONPATH=src python3 scripts/check_launch_readiness.py

Claim Ceiling

Allowed now:

• local strategy
• synthetic fixtures
• proposed schemas
• dry-run receipts
• public-safe examples

Not allowed now:

• public adoption claim
• DeepSeek endorsement
• compatibility certification
• benchmark superiority
• safety proof
• major-significance claim