chatmd 0.2.7__tar.gz

chatmd-0.2.7/.gitignore

@@ -0,0 +1,31 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.venv/
+.eggs/
+
+# IDE
+.vscode/
+.idea/
+
+# ChatMD runtime (user workspace, not this repo)
+# .chatmd/state.json
+# .chatmd/tasks.json
+# .chatmd/queue.json
+# .chatmd/logs/
+
+# Secrets
+.env
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test / coverage
+.coverage
+htmlcov/
+.pytest_cache/

chatmd-0.2.7/CHANGELOG.md

@@ -0,0 +1,196 @@
+# Changelog
+
+> Format follows [Keep a Changelog](https://keepachangelog.com/). Versioning follows [Semantic Versioning](https://semver.org/).
+
+---
+
+## [0.2.7] — 2026-04-15
+
+Windows Service management + `/notify` channel filtering + multi-service convenience commands.
+
+### Added
+
+- **Windows Service (pywin32)**: proper SCM-managed Windows Service replacing Task Scheduler
+  - `chatmd service install -w <path>` — install per-workspace service with auto-start
+  - Auto-detect `pywin32_postinstall.py` DLL status with clear fix instructions
+  - Idempotent install (existing service auto-removed before reinstall)
+  - Failure recovery: auto-restart on crash (5s delay, max 3/day)
+- **Multi-service convenience commands**:
+  - `chatmd service status` (no `-w`) — list all installed ChatMD services
+  - `chatmd service uninstall --all` — uninstall all ChatMD services at once
+- **`/notify` channel filtering**: target specific notification channels
+  - `/notify(email) msg` — send via email only
+  - `/notify(bot) msg` — send via Bot only
+  - `/notify(email,bot) msg` — send via email + Bot
+  - `/notify msg` — all channels (default, unchanged)
+- `chatmd init` now creates `.chatmd/agent.yaml.example` + `.chatmd/user.yaml.example` (committed to git as safe templates)
+- `.chatmd/agent.yaml` and `.chatmd/user.yaml` added to workspace `.gitignore` (may contain API keys)
+
+### Fixed
+
+- Windows Service Error 1073 (service already exists) — idempotent reinstall
+- Windows Service Error 1053 (DLL / PythonPath / SCM issues) — auto-detection + registry fix
+
+---
+
+## [0.2.6] — 2026-04-14
+
+`/sync` quality improvements + Bot notification pipeline + CI.
+
+### Added
+
+- `/sync` detailed feedback: shows `↓N pulled, ↑N pushed` counts
+- `chatmd upgrade` migration 0.2.4→0.2.5: auto-add `.gitignore` runtime patterns
+- LiteStartup `POST /api/bot/notify` — push notifications to bound Telegram Bot
+- LiteStartup `POST /api/bot/sync-complete` — reset pending messages after sync
+- GitHub Actions CI: Ruff lint + pytest (Python 3.10–3.13, ubuntu/windows/macos)
+
+---
+
+## [0.2.5] — 2026-04-14
+
+Bot binding + reverse notifications + inbox + security fixes.
+
+### Added
+
+- `/bind <token>` — one-step Telegram Bot binding (auto-detect git remote, SSH→HTTPS)
+- `BotNotificationChannel` — push notifications to Telegram Bot
+- `/inbox` — view messages received via Bot
+- Inbox deduplication (monotonic `message_id`)
+- Timezone support for Bot messages (`notification.bot.timezone` config)
+
+### Security
+
+- `strip_url_credentials()` — strip plaintext credentials from repo URLs before API calls
+- `mask_repo_url()` — sanitize repo URLs for display
+
+---
+
+## [0.2.4] — 2026-04-13
+
+Confirmation window + open-source preparation + CLI improvements.
+
+### Added
+
+- Confirmation window for destructive commands (`/sync`, `/upload`, `/new`)
+- `chatmd restart` / `chatmd upgrade -w <path>` CLI commands
+- `CONTRIBUTING.md` for open-source contributors
+
+---
+
+## [0.2.3] — 2026-04-12
+
+Custom Skill plugins + Git Sync Cron + `/notify` notifications.
+
+### Added
+
+- Custom Skill plugin system (YAML declarative + Python dynamic)
+- `/notify` — send notifications through file/desktop/email channels
+- Git Sync as Cron job (`@every 5m /sync`)
+- Cron task management: `/cron list`, `/cron pause`, `/cron resume`
+
+---
+
+## [0.2.2] — 2026-04-10
+
+Cron scheduled tasks + Notification system + `/help` improvements.
+
+### Added
+
+- Cron task engine (crontab syntax + `@every` intervals)
+- Notification system (FileChannel + SystemChannel desktop toast)
+- `/help` grouped by category with rich Markdown output
+
+---
+
+## [0.2.1] — 2026-04-02
+
+Cross-platform startup experience improvements + configuration audit + code quality fixes.
+
+### Added
+
+- `chatmd mode suffix/save` — trigger mode switching command
+- `chatmd start --daemon` — background daemon mode (Unix nohup/double-fork + Windows pythonw)
+- `chatmd service install/uninstall/status` — system service registration (systemd/launchd/Windows Service)
+- Windows graceful shutdown via signal file (replaces SIGTERM)
+
+### Fixed
+
+- Assistant mode (`--mode assistant`) now monitors all `.md` files across the entire workspace via `watch_dirs: ["."]`, with internal directories (`.chatmd`, `.git`, `node_modules`, etc.) excluded
+- Windows `chatmd service install` and `_start_agent_now` now use `pythonw.exe` instead of `python.exe`, eliminating the cmd window popup when the service starts
+- Removed unimplemented default config entries (`trigger.confirm`, `async.retry`, `commands.natural_language`, `display_name`, `preferences`) to avoid misleading users
+- `KernelGate` now respects `logging.audit` config toggle
+- `Scheduler` async task timeout (`async.timeout` config + watchdog timer)
+- `file_writer` atomic write auto-retry + fallback on Windows PermissionError
+- `logging.level` config now correctly applies to file log handler
+
+### Changed
+
+- Recommend `pipx` as the primary installation method
+- README updated with Python installation guide
+
+---
+
+## [0.2.0] — 2026-04-01
+
+Provider unified abstraction + long text + AI writing + Canvas + upload + date/time + Markdown templates. 595 tests passed.
+
+### Added
+
+- LiteStartupProvider unified abstraction (multi-endpoint routing: AI/upload, backward compatible)
+- Parser extensions: `:::` fenced long text + `/cmd{text}` inline command + `@` reference markers
+- AI writing commands: `/rewrite`, `/expand`, `/polish`, `/summary`, `/tag`, `/title`
+- `/canvas` — AI Canvas mind map (structured AI output + tree layout + .canvas export)
+- `/upload` — manual image upload + auto-upload mode (Watcher integration)
+- `/new` — archive conversation and start new session
+- Date/time extensions: `/datetime`, `/timestamp`, `/week`, `/weekday`, `/progress`, `/daynum`, `/countdown`
+- Markdown templates: `/todo`, `/done`, `/table`, `/code`, `/link`, `/img`, `/hr`, `/heading`, `/quote`
+- `/help` grouped by category (datetime/ai/markdown/utility/custom)
+
+### Fixed
+
+- Alias conflict: `/q` restored to `/quote`
+
+---
+
+## [0.1.0] — 2026-03-30
+
+First official release. 168 tests passed. 6 sprints, 35 development tasks.
+
+### Added
+
+- Project skeleton: pyproject.toml + src/chatmd/ modular structure + CLI entry point
+- `chatmd init` — workspace initialization (full/assistant mode + Git + config generation)
+- `chatmd start/stop/status` — Agent lifecycle management (PID dedup + graceful stop)
+- `chatmd upgrade --full` — assistant → full workspace conversion
+- Config loading (agent.yaml + user.yaml + defaults merge + ${ENV} variable resolution)
+- FileWatcher (watchdog + 300ms debounce + Agent write-back filter)
+- Parser (`/command(args) input` syntax + `@ai{}` inline/multi-line + code block protection)
+- Router (deterministic match + alias chain resolution + Levenshtein fuzzy suggestions)
+- FileWriter (task ID anchor replacement + atomic write + thread-lock serialization)
+- Scheduler (sync/async task dispatch + 6-state machine + ThreadPool)
+- AI Skills: `/ask` conversation + `/translate` multi-language translation
+- LiteAgent AI Provider (httpx + timeout/401/429 error handling)
+- KernelGate security filter (AI output `/command` escaping + audit log)
+- Multi-turn AI conversation context (ChatSession + max_turns truncation)
+- Multi-session state management (StateManager + JSON persistence)
+- Offline queue (OfflineQueue + FIFO + disk persistence)
+- Git auto-sync + `/sync` (auto-commit + pull --rebase + push)
+- Suffix signal trigger (SuffixTrigger + custom marker + enable/disable)
+- Confirmation window (ConfirmationWindow + delay timer + delete-to-cancel)
+- `@ai{}` enhanced (inline + multi-line block + code block protection)
+- YAML/Python Skill Loader (declarative templates + dynamic import)
+- Command conflict detection and priority (builtin > ai > custom > remote)
+- Skill hot reload (SkillReloader + YAML/Python dynamic loading)
+- `chat/_index.md` auto-maintenance (IndexManager)
+- Built-in Skills: `/help`, `/date`, `/time`, `/now`, `/status`, `/list`, `/log`, `/sync`
+
+### Fixed
+
+- Skill base class `field()` compatibility on non-dataclass ABC
+
+---
+
+## [0.0.0] — 2026-03-30
+
+Project initialization.

chatmd-0.2.7/CONTRIBUTING.md

@@ -0,0 +1,146 @@
+# Contributing to ChatMarkdown
+
+Thank you for your interest in contributing to ChatMarkdown! This guide will help you get started.
+
+## Quick Start
+
+```bash
+# 1. Fork and clone
+git clone https://github.com/<your-username>/chatmd.git
+cd chatmd
+
+# 2. Create a virtual environment
+python -m venv .venv
+source .venv/bin/activate    # Linux/macOS
+# .venv\Scripts\activate     # Windows
+
+# 3. Install dev dependencies
+pip install -e ".[dev]"
+
+# 4. Verify everything works
+pytest
+ruff check src/
+```
+
+## Development Guidelines
+
+### Code Style
+
+- **Python 3.10+** — use modern type hints (`list[str]`, `X | None`)
+- **Ruff** for linting — run `ruff check src/ tests/` before committing
+- **100-character** line width
+- **Google-style** docstrings for all public functions
+- **English** for all code, comments, variable names, and commit messages
+
+### Testing
+
+- **pytest + pytest-asyncio** — tests live in `tests/`
+- Run the full suite: `pytest`
+- Run with coverage: `coverage run -m pytest && coverage report`
+- Markers: `@pytest.mark.unit`, `@pytest.mark.integration`, `@pytest.mark.e2e`, `@pytest.mark.slow`
+- **All new features must include tests** — aim for ≥ 80% coverage
+
+### Commit Messages
+
+We follow [Conventional Commits](https://www.conventionalcommits.org/):
+
+```
+<type>(<scope>): <description>
+```
+
+**Types**: `feat`, `fix`, `docs`, `test`, `refactor`, `chore`, `ci`, `perf`
+
+**Examples**:
+- `feat(skills): add /weather skill`
+- `fix(parser): handle empty lines in fenced blocks`
+- `docs: update README with new CLI commands`
+- `test(cron): add persistence edge case tests`
+
+### Branch Strategy
+
+| Branch | Purpose |
+|--------|---------|
+| `main` | Stable releases |
+| `dev` | Integration branch |
+| `feat/<name>` | New features |
+| `fix/<name>` | Bug fixes |
+
+## How to Contribute
+
+### Reporting Bugs
+
+1. Search [existing issues](https://github.com/litestartup-com/chatmd/issues) first
+2. Use the **Bug Report** issue template
+3. Include: Python version, OS, steps to reproduce, expected vs actual behavior
+
+### Suggesting Features
+
+1. Open a **Feature Request** issue
+2. Describe the use case and expected behavior
+3. We'll discuss feasibility before implementation
+
+### Submitting Pull Requests
+
+1. **Fork** the repo and create a branch from `dev`
+2. **Write tests** for your changes
+3. **Run checks** before pushing:
+   ```bash
+   pytest
+   ruff check src/ tests/
+   ```
+4. **Open a PR** against `dev` with a clear description
+5. Link related issues (e.g., "Closes #42")
+
+### Creating Custom Skills
+
+ChatMarkdown supports a plugin system for custom skills. See [`rules/custom_skills.md`](rules/custom_skills.md) for the full guide.
+
+Quick overview:
+1. Create a Python module with a class extending `Skill`
+2. Register it in `.chatmd/skills.yaml`
+3. Skills support `configure()` / `teardown()` lifecycle hooks
+
+## Project Structure
+
+```
+src/chatmd/
+├── cli.py                  # CLI entry point (Click)
+├── commands/               # CLI subcommands (init, start, stop, upgrade)
+├── engine/                 # Core engine (parser, router, agent, scheduler, cron)
+├── watcher/                # File watcher + suffix trigger
+├── skills/                 # Built-in skills (ai, cron, infra, builtin)
+├── providers/              # AI provider backends
+├── security/               # KernelGate safety checks
+├── infra/                  # Config, file writer, git sync, notifications
+└── i18n/                   # Internationalization (en, zh_CN)
+
+tests/                      # All tests (unit, integration, e2e)
+rules/                      # Development rules and conventions
+docs/                       # Project documentation
+```
+
+## i18n
+
+- All user-facing strings use `t("key.name")` from `chatmd.i18n`
+- Default locale: `en`, supported: `zh-CN`
+- **Never hardcode user-facing text** — always use i18n keys
+- Add keys to both `i18n/en.py` and `i18n/zh_CN.py`
+
+## Security
+
+- **No hardcoded API keys** — use environment variables or `.env`
+- Commands in `security/kernel_gate.py` blacklist are blocked
+- Destructive operations require explicit `/confirm`
+
+## Code of Conduct
+
+Be respectful, constructive, and inclusive. We follow the [Contributor Covenant](https://www.contributor-covenant.org/) Code of Conduct.
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the [MIT License](LICENSE).
+
+## Questions?
+
+- Open a [Discussion](https://github.com/litestartup-com/chatmd/discussions) for general questions
+- Check the [README](README.md) for usage documentation

chatmd-0.2.7/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Litestartup
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.