deepmodel-dmx 0.1.0__tar.gz

deepmodel_dmx-0.1.0/.editorconfig

@@ -0,0 +1,21 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.toml]
+indent_size = 4
+
+[*.yml]
+indent_size = 2
+
+[*.yaml]
+indent_size = 2

deepmodel_dmx-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,13 @@
+## Summary
+
+<!-- What does this PR do? Why? -->
+
+## Checklist
+
+- [ ] Tests added or updated for all changed behaviour
+- [ ] `CHANGELOG.md` entry added under `[Unreleased]`
+- [ ] All new functions and classes have type annotations
+- [ ] `uv run ruff check src/ tests/` passes
+- [ ] `uv run ruff format --check src/ tests/` passes
+- [ ] `uv run mypy src/` passes
+- [ ] `uv run python -m pytest` passes

deepmodel_dmx-0.1.0/.github/dependabot.yml

@@ -0,0 +1,23 @@
+version: 2
+
+updates:
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+    open-pull-requests-limit: 5
+    labels:
+      - dependencies
+    ignore:
+      # fastmcp is the critical dependency; pin updates manually after testing.
+      - dependency-name: fastmcp
+        update-types: ["version-update:semver-major"]
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+    labels:
+      - dependencies

deepmodel_dmx-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    name: Build and publish
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write   # required for OIDC trusted publishing
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          version: "latest"
+
+      - name: Build
+        run: uv build
+
+      - name: Publish
+        run: uv publish

deepmodel_dmx-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,39 @@
+name: Test
+
+on:
+  push:
+    branches: ["**"]
+  pull_request:
+
+jobs:
+  test:
+    name: "Python ${{ matrix.python-version }} / ${{ matrix.os }}"
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+        os: [ubuntu-latest, macos-latest]
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          version: "latest"
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Lint — ruff check
+        run: uv run ruff check src/ tests/
+
+      - name: Lint — ruff format
+        run: uv run ruff format --check src/ tests/
+
+      - name: Type check — mypy
+        run: uv run mypy src/
+
+      - name: Test
+        run: uv run python -m pytest --cov --cov-fail-under=75 -q

deepmodel_dmx-0.1.0/.gitignore

@@ -0,0 +1,48 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# uv / virtualenv
+.venv/
+venv/
+.python-version
+
+# uv.lock is intentionally committed — do not add it here
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+
+# Linting / formatting
+.ruff_cache/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Distribution
+*.whl
+*.tar.gz
+MANIFEST
+
+# Environment / secrets
+.env
+.env.*

deepmodel_dmx-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,28 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.4.10
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.10.0
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          - fastmcp
+          - python-frontmatter
+          - pyyaml
+          - types-PyYAML
+          - click
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-merge-conflict
+      - id: debug-statements

deepmodel_dmx-0.1.0/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+All notable changes to `deepmodel-dmx` are documented here.
+
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [Unreleased]
+
+---
+
+## [0.1.0] — 2026-06-01
+
+### Added
+
+- **23 SDLC skills** as MCP prompts, namespaced under the MCP server name: `/dmx/init`, `/dmx/create-ticket`, `/dmx/derive-ticket`, `/dmx/plan`, `/dmx/implement-next-phase`, `/dmx/implement-next-task`, `/dmx/validate`, `/dmx/create-branch`, `/dmx/commit`, `/dmx/create-pr`, `/dmx/draft-pr-description`, `/dmx/close-ticket`, `/dmx/hotfix`, `/dmx/draft-release-note`, `/dmx/release-merge`, `/dmx/create-release`, `/dmx/status`, `/dmx/sync-branch`, `/dmx/update-memory`, `/dmx/review`, `/dmx/test`, `/dmx/docs`, `/dmx/secure`
+- **`system-prompt` rule** — always-apply AI persona and memory bank instructions
+- **`detect_invoking_ide` tool** — detects Cursor, Claude, Copilot, Antigravity from MCP `clientInfo.name`, `X-Dmx-IDE` header, or `DMX_IDE` env var
+- **`setup_ide_rules` tool** — emits per-IDE rule files for Cursor (`.mdc`), Claude, Copilot, Antigravity, and generic agents; response includes `workflow_version`
+- **Workflow versioning** — `_workflow_version.py` tracks a `WORKFLOW_VERSION` constant independent of the package version; embedded in the DMX marker (`<!-- deepmodel:dmx:start workflow-v1 -->`) so staleness can be detected on re-init
+- **`dmx serve`** — stdio and HTTP/SSE transports; `PORT` env var; `REQUIRE_API_KEY` + `MCP_API_KEY` bearer auth
+- **`dmx serve --watch`** — hot-reload on skill/rule file changes (`watchfiles` extra)
+- **`dmx list-skills`** — print all loaded skills with name, title, and argument count
+- **`--skills-dir` / `--rules-dir`** CLI overrides and `DMX_SKILLS_DIR` / `DMX_RULES_DIR` env var overrides
+- **`create_app()`** internal extension API for the Deepmodel commercial layer
+- **CI** — GitHub Actions matrix: Python 3.11/3.12/3.13 × ubuntu/macos; ruff, mypy, pytest
+- **Publishing** — OIDC trusted publisher workflow on `v*` tags
+
+[Unreleased]: https://github.com/deepmodel-ai/dmx/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/deepmodel-ai/dmx/releases/tag/v0.1.0

deepmodel_dmx-0.1.0/CLA.md

@@ -0,0 +1,46 @@
+# Contributor License Agreement
+
+**Deepmodel, Inc. ("Deepmodel") Individual Contributor License Agreement ("CLA")**
+
+Thank you for your interest in contributing to open-source software projects managed by Deepmodel ("We" or "Us").
+
+This CLA is for your protection as a contributor as well as the protection of Deepmodel and its users; it does not change your rights to use your own contributions for any other purpose.
+
+Please read this document carefully before signing and keep a copy for your records.
+
+## 1. Definitions
+
+"You" means the individual who submits a Contribution to Us.
+
+"Contribution" means any original work of authorship, including any modifications or additions to an existing work, that you intentionally submit to Us for inclusion in, or documentation of, any of the products owned or managed by Us (the "Work").
+
+"Submit" means any form of electronic, verbal, or written communication sent to Us, including but not limited to communication on electronic mailing lists, source-code control systems, and issue tracking systems.
+
+## 2. Grant of Copyright License
+
+Subject to the terms and conditions of this Agreement, you hereby assign to Us joint ownership of, and all copyrights in, your Contributions. This assignment allows Us to license your Contributions under any license, including proprietary licenses, in addition to any open-source license under which the Work is made available.
+
+You retain the right to use your Contributions for any purpose and in any way you see fit, including the right to offer your Contributions under other license terms.
+
+## 3. Grant of Patent License
+
+Subject to the terms and conditions of this Agreement, you hereby grant to Us and to recipients of software distributed by Us a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by you that are necessarily infringed by your Contributions alone or by combination of your Contributions with the Work to which such Contributions were submitted.
+
+## 4. You represent that
+
+- Each Contribution you submit is your original creation.
+- You have the legal authority to enter into this Agreement.
+- Your Contributions do not violate any third-party intellectual property rights.
+- If your employer has rights to intellectual property that you create, you have received permission to make Contributions on behalf of that employer, or your employer has waived such rights for your Contributions to Us.
+
+## 5. Disclaimer of Warranties
+
+Your Contributions are provided on an "AS IS" basis, without warranties or conditions of any kind, either express or implied, including, without limitation, any warranties or conditions of title, non-infringement, merchantability, or fitness for a particular purpose.
+
+## 6. Agreement
+
+By signing the CLA (via CLA Assistant when opening a pull request to a Deepmodel repository), you accept and agree to the terms and conditions of this Agreement for your present and future Contributions submitted to Deepmodel.
+
+---
+
+*This CLA is adapted from the Apache Individual Contributor License Agreement v2.0.*

deepmodel_dmx-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,77 @@
+# Contributing to dmx
+
+Thank you for your interest in contributing. This document explains how to contribute and what we expect from contributors.
+
+## Contributor License Agreement (CLA)
+
+**Before your first pull request can be merged, you must sign the [Contributor License Agreement](CLA.md).**
+
+We use [CLA Assistant](https://cla-assistant.io) — it will prompt you to sign directly in the PR when you open one. The CLA assigns copyright to Deepmodel while granting you the right to retain and use your contributions. This allows Deepmodel to offer `dmx` under AGPL-3.0 alongside a commercial license.
+
+## Development setup
+
+```bash
+git clone https://github.com/deepmodel-ai/dmx.git
+cd dmx
+uv sync --extra dev
+uv run pre-commit install  # optional but recommended
+```
+
+## Running checks locally
+
+```bash
+uv run ruff check src/ tests/        # lint
+uv run ruff format --check src/ tests/  # format
+uv run mypy src/                     # type check
+uv run python -m pytest              # tests
+```
+
+All four must pass before opening a PR. CI runs the same commands on Python 3.11, 3.12, and 3.13 on Ubuntu and macOS.
+
+## Adding or editing skills
+
+Skills are Markdown files under `src/dmx/skills/`. Each file requires YAML frontmatter:
+
+```yaml
+---
+name: dmx-my-skill
+title: Short human-readable title
+description: One-sentence description shown in the IDE command palette.
+arguments:
+  - name: my_arg
+    description: What this argument controls.
+    required: false
+---
+
+Your skill prompt body here.
+```
+
+- `name` must match `^[a-z0-9_-]+$`
+- `title` and `description` are shown in the IDE; keep them concise
+- Skill files live under `src/dmx/skills/<category>/<order>-<slug>/` — order prefix controls sort order
+
+## Adding or editing rules
+
+Rules are Markdown files under `src/dmx/rules/`. Each file requires YAML frontmatter:
+
+```yaml
+---
+name: my-rule
+title: Short title
+description: One-sentence description of what this rule enforces.
+---
+
+Rule body here (written as an instruction to the AI).
+```
+
+## Pull request checklist
+
+- [ ] Tests added or updated for all changed behaviour
+- [ ] `CHANGELOG.md` entry added under `[Unreleased]`
+- [ ] All new functions and classes have type annotations
+- [ ] `ruff check`, `ruff format --check`, `mypy`, and `pytest` all pass
+- [ ] CLA signed (CLA Assistant will prompt on first PR)
+
+## Reporting bugs and feature requests
+
+Open a [GitHub issue](https://github.com/deepmodel-ai/dmx/issues). For security issues, see [SECURITY.md](SECURITY.md).

deepmodel_dmx-0.1.0/LICENSE

@@ -0,0 +1,38 @@
+                                                                    GNU AFFERO GENERAL PUBLIC LICENSE
+                       Version 3, 19 November 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU Affero General Public License is a free, copyleft license for
+software and other kinds of works, specifically designed to ensure
+cooperation with the community in the case of network server software.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+our General Public Licenses are intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can modify it, that
+you know you can do these rights, and that you have the freedom to use,
+share, and change the software.
+
+  Specifically, the GNU Affero General Public License is designed to
+ensure that anyone running a modified version of the software over a
+network can receive the source code for that version.
+
+  For the full license text, see: https://www.gnu.org/licenses/agpl-3.0.txt
+
+  Copyright (C) 2024 Deepmodel Inc.
+  All Rights Reserved under AGPL-3.0.
+
+  Additional permissions: Deepmodel Inc. retains the right to release
+  the software under different license terms (dual licensing). See
+  CLA.md for contributor terms.

deepmodel_dmx-0.1.0/PKG-INFO

@@ -0,0 +1,219 @@
+Metadata-Version: 2.4
+Name: deepmodel-dmx
+Version: 0.1.0
+Summary: AI SDLC MCP server — skills and rules for any AI IDE.
+License: AGPL-3.0
+License-File: LICENSE
+Keywords: ai,claude,cursor,mcp,sdlc
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1
+Requires-Dist: fastmcp>=2.0
+Requires-Dist: python-frontmatter>=1.1
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: starlette>=0.40
+Provides-Extra: dev
+Requires-Dist: httpx2>=2.2.0; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pre-commit>=3; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Requires-Dist: syrupy>=4; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0; extra == 'dev'
+Provides-Extra: watch
+Requires-Dist: watchfiles>=0.21; extra == 'watch'
+Description-Content-Type: text/markdown
+
+# dmx
+
+[![PyPI](https://img.shields.io/pypi/v/deepmodel-dmx)](https://pypi.org/project/deepmodel-dmx/)
+[![Test](https://github.com/deepmodel-ai/dmx/actions/workflows/test.yml/badge.svg)](https://github.com/deepmodel-ai/dmx/actions/workflows/test.yml)
+[![License: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
+
+The official implementation of the [AI SDLC](https://github.com/deepmodel-ai/ai-sdlc) — delivered as an MCP server for any AI IDE.
+
+`dmx` turns the AI SDLC framework into slash commands and always-apply engineering rules. Connect it to Cursor, Claude Code, GitHub Copilot, Antigravity, or any MCP-compatible IDE and get a structured, phase-gated AI engineering workflow out of the box.
+
+---
+
+## The workflow
+
+The [AI SDLC](https://github.com/deepmodel-ai/ai-sdlc) structures development around five phases with explicit developer control points. AI executes within each phase and stops. The developer drives every transition forward.
+
+![AI SDLC Phase Arc](https://raw.githubusercontent.com/deepmodel-ai/ai-sdlc/main/assets/phase-arc.drawio.svg)
+
+| Phase | What happens | dmx command |
+|---|---|---|
+| **Specify** | AI drafts a structured spec, surfaces ambiguity, asks Q&A. Developer answers. | `/dmx/create-ticket` |
+| **Plan** | AI generates a phased task list from the answered spec. Developer reviews. | `/dmx/plan` |
+| **Build** | AI implements one phase, stops, reports. Developer reviews and commits. Repeats. | `/dmx/implement-next-phase` |
+| **Validate** | Automated quality gate checks spec, security, coverage. AI drafts the PR body. | `/dmx/validate` · `/dmx/create-pr` |
+| **Ship** | Developer merges. AI tags the release and publishes. Developer confirms. | `/dmx/create-release` |
+
+> The model does not merge. It does not advance the workflow. It does not decide when the work is done.
+
+---
+
+## Quick start
+
+Add to your IDE's MCP config and restart:
+
+**Cursor** — `~/.cursor/mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "dmx": {
+      "command": "uvx",
+      "args": ["--from", "deepmodel-dmx", "dmx", "serve"]
+    }
+  }
+}
+```
+
+**Claude Code** — `~/.claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "dmx": {
+      "command": "uvx",
+      "args": ["--from", "deepmodel-dmx", "dmx", "serve"]
+    }
+  }
+}
+```
+
+**Antigravity** — `~/.gemini/config/mcp_config.json`
+
+```json
+{
+  "mcpServers": {
+    "dmx": {
+      "command": "uvx",
+      "args": ["--from", "deepmodel-dmx", "dmx", "serve"]
+    }
+  }
+}
+```
+
+**GitHub Copilot** — `.vscode/settings.json` (workspace) or user settings
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "dmx": {
+        "command": "uvx",
+        "args": ["--from", "deepmodel-dmx", "dmx", "serve"]
+      }
+    }
+  }
+}
+```
+
+Then run `/dmx-init` in your IDE to write always-apply rules and scaffold the `.dmx/` memory bank.
+
+---
+
+## `/dmx-init` walkthrough
+
+`/dmx-init` is the one-time project setup skill. It:
+
+1. Detects your workflow mode (feature branches vs. trunk) and ticketing system
+2. Auto-detects your GitHub remote and tech stack
+3. Writes `.dmx/config.md` with project context
+4. Scaffolds the `.dmx/` memory bank (architecture, decisions, style guide, etc.)
+5. Calls `detect_invoking_ide` and `setup_ide_rules` to write IDE-specific rule files
+6. Writes the always-apply persona rule so every future chat starts with the right context
+
+Safe to re-run — updates config without overwriting memory bank files that already have content.
+
+---
+
+## Skill catalog
+
+All `/dmx-*` commands are MCP prompts served live — no file writes, no installation beyond the MCP config.
+
+### Workflow
+
+| Skill | What it does |
+|---|---|
+| `/dmx/init` | One-time project setup: rules, memory bank, IDE config |
+| `/dmx/create-ticket` | Idea → ticket → branch → spec in one command |
+| `/dmx/derive-ticket` | Uncommitted changes → ticket → branch → derived spec |
+| `/dmx/plan` | Answered spec → phased `tasks.md` |
+| `/dmx/implement-next-phase` | Execute the next phase in `tasks.md`, stop |
+| `/dmx/implement-next-task` | Execute the next single task, stop |
+| `/dmx/validate` | Pre-PR quality gate: ticket, code, security |
+| `/dmx/create-branch` | Create a properly named branch, scaffold spec |
+| `/dmx/commit` | Conventional commit from staged diff |
+| `/dmx/create-pr` | Open PR with correct title + description |
+| `/dmx/draft-pr-description` | Generate PR body without opening the PR |
+| `/dmx/close-ticket` | Post-merge: close ticket, delete branch, archive |
+
+### Release
+
+| Skill | What it does |
+|---|---|
+| `/dmx/hotfix` | Create hotfix branch from master |
+| `/dmx/draft-release-note` | Generate release notes from merged PRs |
+| `/dmx/release-merge` | Open staging → master release gate PR |
+| `/dmx/create-release` | Tag and publish GitHub release |
+
+### Utilities
+
+| Skill | What it does |
+|---|---|
+| `/dmx/status` | Snapshot of in-progress tickets and open PRs |
+| `/dmx/sync-branch` | Rebase/merge base branch onto current branch |
+| `/dmx/update-memory` | Sync ticket learnings into memory bank |
+| `/dmx/review` | Code review: clarity, correctness, maintainability |
+| `/dmx/test` | Write tests that enable change |
+| `/dmx/docs` | Write clear, human-first documentation |
+| `/dmx/secure` | Security analysis — thinks like an attacker |
+
+---
+
+## CLI
+
+```
+dmx serve               # stdio transport (default, for IDE MCP config)
+dmx serve --http        # SSE transport on :8080 (team server / Docker)
+dmx serve --http --port 9000
+dmx serve --watch       # hot-reload on file change (requires watchfiles extra)
+dmx list-skills         # print all loaded skills
+dmx version
+```
+
+**Environment variables**
+
+| Variable | Purpose | Default |
+|---|---|---|
+| `PORT` | HTTP port | `8080` |
+| `DMX_SKILLS_DIR` | Override bundled skills directory | bundled |
+| `DMX_RULES_DIR` | Override bundled rules directory | bundled |
+| `DMX_IDE` | Force IDE detection (`cursor`, `claude`, `copilot`, `antigravity`, `agents`) | auto-detect |
+| `MCP_API_KEY` | Bearer token for HTTP auth | — |
+| `REQUIRE_API_KEY` | Enable HTTP bearer auth (`true`/`false`) | `false` |
+
+---
+
+## Requirements
+
+- Python 3.11+
+- `uv` (recommended) or any package manager that supports `uvx`
+
+---
+
+## License
+
+[AGPL-3.0](LICENSE) — free for open-source use. Commercial licensing available from [Deepmodel](https://deepmodel.ai).