mcp-sequential-thinking 0.6.0__tar.gz

mcp_sequential_thinking-0.6.0/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly

mcp_sequential_thinking-0.6.0/.github/workflows/ci.yml

@@ -0,0 +1,21 @@
+name: CI
+on:
+  push:
+    branches: [master]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.10", "3.12"]
+    steps:
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: pytest tests/ -v
+      - run: mypy mcp_sequential_thinking/

mcp_sequential_thinking-0.6.0/.github/workflows/claude.yml

@@ -0,0 +1,50 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+          # claude_args: '--allowed-tools Bash(gh pr:*)'
+

mcp_sequential_thinking-0.6.0/.github/workflows/release.yml

@@ -0,0 +1,18 @@
+name: Release
+on:
+  release:
+    types: [published]
+
+jobs:
+  pypi:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - run: pip install build && python -m build
+      - uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # v1.14.0

mcp_sequential_thinking-0.6.0/.gitignore

@@ -0,0 +1,5 @@
+.venv
+__pycache__
+*.pyc
+.coverage
+CLAUDE.md

mcp_sequential_thinking-0.6.0/CHANGELOG.md

@@ -0,0 +1,111 @@
+# Changelog
+
+## [0.6.0] - 2026-07-03
+
+### Added
+- **Thought revisions and branching**: `process_thought` accepts new optional
+  parameters `is_revision`, `revises_thought_number`, `branch_from_thought` and
+  `branch_id` to revise an earlier thought or fork an alternative line of
+  reasoning. Cross-field validation enforces consistent usage. Analysis output
+  reports `isRevision`/`revisedThought`/`branchId` (plus a `revisionOf` snippet
+  for revisions), and `generate_summary` gains a `branches` object and a
+  `revisionCount`. Progress metrics are based on mainline thoughts only, so
+  revisions and branches no longer inflate completion beyond 100%.
+- **Append-only JSONL session format (schema v2)**: the session now lives in
+  `current_session.jsonl` (header record + one thought per line). `process_thought`
+  is O(1) per call instead of rewriting the full history, and the file doubles as
+  an audit trail. A truncated final line (interrupted write) is dropped on load
+  instead of invalidating the whole session. Existing v1 `current_session.json`
+  files are migrated automatically and losslessly on first start; the original is
+  kept as `current_session.json.migrated-to-v2`.
+- JSON exports now carry a top-level `"version": 2` field. Legacy v0.5.0 exports
+  (no version field) remain importable.
+- CI workflow (GitHub Actions): test matrix on Linux/Windows with Python 3.10
+  and 3.12, running pytest and mypy on every push and pull request.
+- Release workflow publishing to PyPI via Trusted Publishing when a GitHub
+  release is published (requires one-time Trusted Publisher setup on pypi.org).
+- Dependabot configuration for pip and GitHub Actions dependencies.
+- `SECURITY.md` with a private disclosure contact.
+
+### Changed
+- **Package renamed** from `sequential-thinking` to `mcp-sequential-thinking` for the PyPI
+  release (the old name is occupied by a third-party fork). The console script
+  `mcp-sequential-thinking` and the import package `mcp_sequential_thinking` are unchanged.
+- **Breaking:** `export_session` and `import_session` are now confined to the
+  `exports/` subdirectory of the storage directory (relative paths resolve to
+  `~/.mcp_sequential_thinking/exports/` by default). This prevents an export from
+  overwriting the active session file or its lock file.
+
+### Fixed
+- `import_session` no longer silently replaces the active session with an empty
+  one when the given file is a valid JSON file without a `thoughts` key, or when
+  the file does not exist. Both cases now raise and leave the session untouched.
+- Path-validation errors returned to the MCP client no longer leak the absolute
+  storage path (e.g. the user's home directory); the full path is only logged
+  server-side.
+- `mypy` now passes cleanly: added missing type annotations in `analysis.py`
+  (`stages`, `percent_complete`) and `server.py` (`main() -> None`), and removed
+  duplicate `import os` / `import sys` in the `__main__` block of `server.py`.
+
+## Version 0.5.0 (Unreleased)
+
+### Code Quality Improvements
+
+#### 1. Reduced Code Duplication in Storage Layer
+- Created a new `storage_utils.py` module with shared utility functions
+- Implemented reusable functions for file operations and serialization
+- Standardized error handling and backup creation
+- Improved consistency across serialization operations
+- Optimized resource management with cleaner context handling
+
+#### 2. API and Data Structure Improvements
+- Added explicit parameter for ID inclusion in `to_dict()` method
+- Created utility module with snake_case/camelCase conversion functions
+- Eliminated flag-based solution in favor of explicit method parameters
+- Improved readability with clearer, more explicit list comprehensions
+- Eliminated duplicate calculations in analysis methods
+
+## Version 0.4.0
+
+### Major Improvements
+
+#### 1. Serialization & Validation with Pydantic
+- Converted `ThoughtData` from dataclass to Pydantic model
+- Added automatic validation with field validators
+- Maintained backward compatibility with existing code
+
+#### 2. Thread-Safety in Storage Layer
+- Added file locking with `portalocker` to prevent race conditions
+- Added thread locks to protect shared data structures
+- Made all methods thread-safe
+
+#### 3. Fixed Division-by-Zero in Analysis
+- Added proper error handling in `generate_summary` method
+- Added safe calculation of percent complete with default values
+
+#### 4. Case-Insensitive Stage Comparison
+- Updated `ThoughtStage.from_string` to use case-insensitive comparison
+- Improved user experience by accepting any case for stage names
+
+#### 5. Added UUID to ThoughtData
+- Added a unique identifier to each thought for better tracking
+- Maintained backward compatibility with existing code
+
+#### 6. Consolidated Logging Setup
+- Created a central logging configuration in `logging_conf.py`
+- Standardized logging across all modules
+
+#### 7. Improved Package Entry Point
+- Cleaned up the path handling in `run_server.py`
+- Removed redundant code
+
+### New Dependencies
+- Added `portalocker` for file locking
+- Added `pydantic` for data validation
+
+## Version 0.3.0
+
+Initial release with basic functionality:
+- Sequential thinking process with defined stages
+- Thought storage and retrieval
+- Analysis and summary generation

mcp_sequential_thinking-0.6.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) <2025> <Arben Ademi>
+
+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.