traceable-research-mcp 0.1.0__tar.gz

traceable_research_mcp-0.1.0/.agents/plugins/marketplace.json

@@ -0,0 +1,17 @@
+{
+  "name": "deep-research-toolkit-local",
+  "plugins": [
+    {
+      "name": "deep-research-toolkit",
+      "description": "Traceable scholarly research tools exposed over MCP.",
+      "source": {
+        "type": "local",
+        "path": "./plugins/deep-research-toolkit"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      }
+    }
+  ]
+}

traceable_research_mcp-0.1.0/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(uv --version)",
+      "Bash(py --version)"
+    ]
+  }
+}

traceable_research_mcp-0.1.0/.claude-plugin/marketplace.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "deep-research-toolkit",
+  "description": "Traceable scholarly research tools exposed over MCP.",
+  "owner": {
+    "name": "Deep Research Toolkit contributors",
+    "url": "https://github.com/CYC2002tommy/Deep-Research-Agent"
+  },
+  "plugins": [
+    {
+      "name": "deep-research-toolkit",
+      "description": "Traceable literature review over free APIs with evidence-linked bilingual reports.",
+      "source": "./plugins/deep-research-toolkit",
+      "category": "productivity"
+    }
+  ]
+}

traceable_research_mcp-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,46 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.11", "3.13"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Sync dependencies
+        run: uv sync --extra dev
+      - name: Ruff lint
+        run: uv run ruff check .
+      - name: Ruff format check
+        run: uv run ruff format --check .
+      - name: Mypy
+        run: uv run mypy src
+      - name: Tests
+        run: uv run pytest -m "not online" -q
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.11"
+      - name: Build wheel and sdist
+        run: uv build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/*

traceable_research_mcp-0.1.0/.gitignore

@@ -0,0 +1,22 @@
+# Python
+__pycache__/
+*.pyc
+.venv/
+dist/
+build/
+*.egg-info/
+
+# Partial writes
+*.part
+
+# Local research artifacts (reports/ and evidence/ are intentionally NOT ignored)
+.deep-research/research.sqlite3
+.deep-research/research.sqlite3-shm
+.deep-research/research.sqlite3-wal
+.deep-research/jobs/
+.deep-research/sources/
+.deep-research/cache/
+.deep-research/quarantine/
+
+# Local worktrees
+.worktrees/

traceable_research_mcp-0.1.0/.superpowers/sdd/progress.md

@@ -0,0 +1,3 @@
+# Subagent-Driven Development Progress
+
+Task 0: complete (commit 844e317, review clean)

traceable_research_mcp-0.1.0/.superpowers/sdd/task-0-brief.md

@@ -0,0 +1,36 @@
+### Task 0: Initialize version control and preserve approved specifications
+
+**Files:**
+- Existing: docs/設計說明.md
+- Existing: 說明書.md
+- Existing: docs/superpowers/plans/2026-07-20-deep-research-toolkit.md
+
+**Interfaces:**
+- Produces: a main-branch Git repository with the approved documents as the
+  immutable implementation baseline.
+
+- [ ] **Step 1: Initialize the repository**
+
+Run:
+
+    git init -b main
+
+Expected: Git reports an empty repository initialized on branch main.
+
+- [ ] **Step 2: Verify the documentation baseline**
+
+Run:
+
+    git status --short
+
+Expected: the two specifications and this implementation plan appear as
+untracked files; no product source files exist yet.
+
+- [ ] **Step 3: Commit the approved documents**
+
+Run:
+
+    git add docs/設計說明.md 說明書.md docs/superpowers/plans/2026-07-20-deep-research-toolkit.md
+    git commit -m "docs: define deep research toolkit"
+
+Expected: commit succeeds and git status --short prints no output.

traceable_research_mcp-0.1.0/.superpowers/sdd/task-0-report.md

@@ -0,0 +1,129 @@
+# Task 0 Report — Initialize version control and preserve approved specifications
+
+## Status
+
+Completed successfully.
+
+## Commands and results
+
+1. `git init -b main`
+   - Result: initialized an empty Git repository on branch `main`.
+2. `git status --short`
+   - Result: documentation and `.superpowers/` were untracked; no product source files existed.
+3. `git add -- 'docs/設計說明.md' '說明書.md' 'docs/superpowers/plans/2026-07-20-deep-research-toolkit.md'`
+   - Result: staged exactly the three approved documentation files.
+4. `git commit -m 'docs: define deep research toolkit'`
+   - Result: created root commit `844e317` (`docs: define deep research toolkit`).
+5. `git status --short; git log -1 --oneline; git show --stat --oneline HEAD`
+   - Result: confirmed the expected commit and its three-file contents. The only remaining untracked path is `.superpowers/`.
+
+## Files committed
+
+- `docs/設計說明.md`
+- `說明書.md`
+- `docs/superpowers/plans/2026-07-20-deep-research-toolkit.md`
+
+## Self-review
+
+- Confirmed `main` is the repository's initial branch.
+- Confirmed the root commit has subject `docs: define deep research toolkit`.
+- Confirmed the commit contains exactly the three approved documents (2,545 inserted lines).
+- Confirmed no `.superpowers/` scratch materials were staged or committed.
+- Did not modify any approved Markdown document.
+
+## Concerns
+
+- `git status --short` remains non-empty because `.superpowers/` contains local planning/scratch files, including this report. These files were intentionally left untracked per the task requirements.
+- Git emitted line-ending warnings indicating that files may be converted from LF to CRLF if Git rewrites them on this Windows workspace; the committed document content was not changed as part of this task.
+
+## Fix Review
+
+### Local-only scratch exclusion
+
+Command:
+
+```powershell
+Add exactly `.superpowers/` to `.git/info/exclude`.
+git status --short
+```
+
+Output:
+
+```text
+(no output)
+```
+
+Result: `.superpowers/` is excluded only in the local Git metadata. No repository file, index entry, or commit was changed.
+
+### Committed-blob verification
+
+Command:
+
+```powershell
+$paths = @('docs/設計說明.md','說明書.md','docs/superpowers/plans/2026-07-20-deep-research-toolkit.md')
+foreach ($p in $paths) {
+  $work = git hash-object -- $p
+  $head = git rev-parse "HEAD:$p"
+  Write-Output "$p`n  working $work`n  HEAD    $head`n  match   $($work -eq $head)"
+}
+```
+
+Output:
+
+```text
+docs/設計說明.md
+  working 8afe6ea444006af485e703b1682738de199ed0d3
+  HEAD    8afe6ea444006af485e703b1682738de199ed0d3
+  match   True
+說明書.md
+  working ca8ea2527dbd64035d5e063ef86e48cb3350f380
+  HEAD    ca8ea2527dbd64035d5e063ef86e48cb3350f380
+  match   True
+docs/superpowers/plans/2026-07-20-deep-research-toolkit.md
+  working 9369ef78c94923dcb51b41ade2cf3bfeb64354a7
+  HEAD    9369ef78c94923dcb51b41ade2cf3bfeb64354a7
+  match   True
+```
+
+### Timestamp evidence
+
+Command:
+
+```powershell
+git log -1 --format='commit %H%ncommit timestamp %ci'
+Get-Item 'docs/設計說明.md','說明書.md','docs/superpowers/plans/2026-07-20-deep-research-toolkit.md' |
+  ForEach-Object { Write-Output "$($_.FullName)`n  LastWriteTime $($_.LastWriteTime.ToString('yyyy-MM-dd HH:mm:ss K'))" }
+```
+
+Output:
+
+```text
+commit 844e3174ad2c421874ccaf4adaa4a8fd2f340a36
+commit timestamp 2026-07-20 01:39:59 +0800
+...\docs\設計說明.md
+  LastWriteTime 2026-07-20 01:25:29 +08:00
+...\說明書.md
+  LastWriteTime 2026-07-20 01:25:29 +08:00
+...\docs\superpowers\plans\2026-07-20-deep-research-toolkit.md
+  LastWriteTime 2026-07-20 01:35:59 +08:00
+```
+
+The document LastWriteTime values precede the commit timestamp, and the blob hashes exactly match `HEAD`; Task 0 did not rewrite the approved Markdown files.
+
+### Final commit state
+
+Command:
+
+```powershell
+git status --porcelain=v1
+git rev-parse HEAD
+git log -1 --format='%s'
+```
+
+Output:
+
+```text
+(no status output)
+844e3174ad2c421874ccaf4adaa4a8fd2f340a36
+docs: define deep research toolkit
+```