context-guardian-core 0.1.0__tar.gz

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

@@ -0,0 +1,54 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  python:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: python -m pip install -e '.[dev]'
+      - run: pytest --cov=context_guardian
+      - run: ruff check .
+
+  pi:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: adapters/pi
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22.19.0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: python -m pip install .
+        working-directory: .
+      - run: npm install
+      - run: npm run typecheck
+      - run: npm run smoke
+
+  deepseek-harness:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22.19.0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: python -m pip install -e '.[dev]'
+      - run: npm install
+      - run: npm run typecheck:dsh
+      - run: npm run test:dsh

context_guardian_core-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,62 @@
+name: Publish packages
+
+on:
+  workflow_dispatch:
+    inputs:
+      package:
+        description: Package set to publish
+        required: true
+        default: all
+        type: choice
+        options:
+          - all
+          - python
+          - npm
+
+permissions:
+  contents: read
+
+jobs:
+  python:
+    if: ${{ inputs.package == 'all' || inputs.package == 'python' }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: python -m pip install --upgrade build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  npm:
+    if: ${{ inputs.package == 'all' || inputs.package == 'npm' }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22.19.0
+          registry-url: https://registry.npmjs.org
+          package-manager-cache: false
+      # npm Trusted Publishing requires npm 11.5.1 or newer.
+      - name: Upgrade npm for trusted publishing
+        run: npm install --global npm@11.5.1
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: python -m pip install -e '.[dev]'
+      - run: npm ci
+      - run: npm run typecheck
+      - run: npm run typecheck:dsh
+      - run: npm run test:dsh
+      # Authentication is provided by GitHub OIDC after each package is configured
+      # with this repository's npm Trusted Publisher relationship.
+      - run: npm publish --workspace adapters/pi --access public
+      - run: npm publish --workspace adapters/deepseek-harness --access public

context_guardian_core-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+.venv*/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.coverage
+htmlcov/
+.ruff_cache/
+dist/
+build/
+*.egg-info/
+node_modules/
+.DS_Store
+.agents/context-guardian.md
+.agents/context-guardian-state.json

context_guardian_core-0.1.0/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+## Unreleased
+
+- Added portable `build_checkpoint()` output for assisted integrations.
+- Added a shared adapter contract and capability matrix for host integrations.
+- Added a DeepSeek Harness adapter that decorates native compaction with Context
+  Guardian inspection, human review, host-model reuse, and fail-open fallback.
+- Added a pre-seeded interactive DeepSeek Harness fixture smoke for manual Keep/Drop
+  validation without requiring a long real conversation.
+- Hardened the JSONL guidance bridge to validate candidates received over the wire.
+
+## 0.1.0 - 2026-09-11
+
+- Added framework-neutral Python inspection core.
+- Added deterministic rules mode and optional structured providers.
+- Added JSONL bridge for host-model calls.
+- Added Pi compaction adapter with fail-open behavior.
+- Added deterministic verification CLI, Pi RPC smoke test, pre-seeded interactive Pi
+  fixture smoke test, example conversation, tests, and release documentation.

context_guardian_core-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,25 @@
+# Contributing
+
+1. Create a focused change that preserves the core boundary.
+2. Add or update tests for behavior changes.
+3. Run `context-guardian verify examples/conversation.json`.
+4. Run `pytest` and `ruff check .`.
+5. For Pi changes, run `npm run typecheck` and `npm run smoke` in `adapters/pi`.
+6. For DeepSeek Harness changes, run `npm run typecheck:dsh`, `npm run test:dsh`,
+   and `npm run dsh-fixture-smoke`.
+7. Before a release, run the interactive fixture checks from the repository root:
+   `npm run pi-fixture-smoke` and `npm run dsh-fixture-smoke`; manually review every
+   Keep/Drop flow.
+
+The deterministic verifier, RPC smoke test, and CI fixture jobs are fast regression
+checks. The local fixture smoke commands are interactive so a maintainer can verify
+the actual review surface before release. Set `CONTEXT_GUARDIAN_REVIEW_MODE=keep` in
+automation when no terminal is available.
+
+The manual publish workflow lives in `.github/workflows/release.yml`. Python and npm
+publishing use trusted publishing through GitHub Actions OIDC; no long-lived registry
+token is required. Each npm package must have a Trusted Publisher configured for
+the `deulofeu1/context-guardian` repository and `release.yml` workflow.
+
+Do not add a server, persistent memory database, or replacement summarizer without
+first discussing the project scope.

context_guardian_core-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Context Guardian Contributors
+
+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.

context_guardian_core-0.1.0/PKG-INFO

@@ -0,0 +1,268 @@
+Metadata-Version: 2.5
+Name: context-guardian-core
+Version: 0.1.0
+Summary: A human-in-the-loop control layer for AI agent context compaction.
+Author: Context Guardian Contributors
+License: MIT License
+        
+        Copyright (c) 2026 Context Guardian Contributors
+        
+        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.
+License-File: LICENSE
+Keywords: ai-agent,context-compaction,human-in-the-loop,memory,pi
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Requires-Dist: pydantic<3,>=2.7
+Provides-Extra: dev
+Requires-Dist: build<2,>=1.2; extra == 'dev'
+Requires-Dist: pytest-cov<7,>=5.0; extra == 'dev'
+Requires-Dist: pytest<9,>=8.0; extra == 'dev'
+Requires-Dist: ruff<1,>=0.6; extra == 'dev'
+Provides-Extra: openai
+Requires-Dist: openai<2,>=1.40; extra == 'openai'
+Description-Content-Type: text/markdown
+
+# Context Guardian
+
+> Never let your coding agent forget the wrong thing.
+
+[English](README.md) · [简体中文](README.zh-CN.md)
+
+Context Guardian adds a human review layer before an AI agent compacts its context.
+It does not replace the agent's memory system, summarizer, token manager, or native
+compaction engine. It makes the hidden keep/drop decision inspectable.
+
+```text
+Context
+  ↓
+Inspect
+  ↓
+Auto Keep / Auto Drop
+  ↓
+Human Review
+  ↓
+Compaction Guidance
+  ↓
+Agent Native Compaction
+```
+
+## Why it exists
+
+Agents often discard the reason a path was rejected. That can make them repeat the
+same failed approach after compaction. Context Guardian surfaces durable decisions,
+constraints, failed attempts, unfinished work, and transient noise before the host
+agent summarizes the context.
+
+## Quick start
+
+### Installation status
+
+This repository is source-installable today, but the Python and npm packages have
+not been published yet. That means the current path is clone/download → install
+the Python and JavaScript dependencies → run the adapter from the checkout.
+
+The no-checkout installation shown below is the target end-user experience after
+release. The host CLIs remain separate prerequisites. The Python distribution is
+named `context-guardian-core`; its installed CLI remains `context-guardian`.
+
+Package publication is designed around npm Trusted Publishing with GitHub Actions
+OIDC. The release workflow does not use a long-lived `NPM_TOKEN`; configure the
+trusted publisher for each npm package as described in
+[`docs/publishing.md`](docs/publishing.md).
+
+### Use this repository today
+
+```bash
+git clone https://github.com/deulofeu1/context-guardian.git
+cd context-guardian
+
+python3 -m venv .venv
+. .venv/bin/activate
+python -m pip install -e '.[dev]'
+npm install
+```
+
+The workspace install does not install the host CLI itself. The Pi workflow expects
+Pi `0.82.1` and Node.js `22.19.0+`; the DeepSeek Harness workflow expects the
+DeepSeek Harness `0.1.5-rc.x` API family and the same Node.js runtime.
+
+Now run the local Python CLI without an API key:
+
+```bash
+context-guardian inspect examples/conversation.json
+context-guardian inspect examples/conversation.json --json
+context-guardian review examples/conversation.json
+context-guardian verify examples/conversation.json
+```
+
+`verify` is a deterministic release smoke test. It needs no model or API key and
+checks critical-memory retention, noise removal, stable candidate IDs, and rendered
+guidance. It is a fast core check, not a replacement for the interactive Pi test.
+
+For the source Pi workflow, use the interactive fixture from the checkout:
+
+```bash
+npm run pi-fixture-smoke
+```
+
+It opens Pi with a pre-seeded long conversation and lets you manually choose
+Keep/Drop. To load the source extension in an existing Pi session, see
+[`adapters/pi/README.md`](adapters/pi/README.md).
+
+For DeepSeek Harness, install the local adapter into the Web profile:
+
+```bash
+dsh plugin --profile web add "$PWD/adapters/deepseek-harness"
+```
+
+### Install published packages after release
+
+These are the intended commands for end users once the package names are published
+and the Python distribution name is resolved:
+
+```bash
+python -m pip install context-guardian-core
+pi install npm:@context-guardian/pi
+dsh plugin --profile web add context-guardian-deepseek-harness
+```
+
+Until then, do not use these commands as an installation test; use the source
+workflow above.
+
+Inside Pi, the adapter reuses the current host model and its existing credentials.
+No second API key is required. The Python process never receives those credentials.
+The published adapter is tested against Pi `0.82.1` and Node.js `22.19.0+`.
+
+For DeepSeek Harness:
+
+```bash
+dsh plugin --profile web add /absolute/path/to/ContextGuardian/adapters/deepseek-harness
+```
+
+After the adapter is published, the path can be replaced with
+`context-guardian-deepseek-harness`.
+
+This adapter decorates DeepSeek Harness's native `dsh-compaction-basic` backend.
+It reuses Harness's active model route for structured inspection, presents uncertain
+candidates through Harness's user-question UI, and passes the resulting guidance back
+into the native summary. Harness remains responsible for session persistence and the
+compaction transaction. The adapter targets the DeepSeek Harness `0.1.5-rc.x` API
+family and is installed as a separate package from the Pi adapter. Web sessions use
+the selected agent preset, so the preset must contain the Context Guardian compaction
+row; the adapter README documents the one-time preset setup.
+
+## Modes
+
+- Rules mode is local, deterministic, conservative, and the default for the CLI.
+- Pi mode asks the host agent's current model for structured candidates, then uses
+  Pi's native compaction helper with the resulting guidance.
+- OpenAI is an optional standalone CLI provider: `pip install 'context-guardian-core[openai]'` after release.
+
+If the bridge, model call, or review UI fails, the adapter fails open and lets native
+Pi compaction continue normally.
+
+## Integrations
+
+| Platform | Level | Auto trigger | Host model | Human review | Preservation |
+| --- | --- | --- | --- | --- | --- |
+| Pi | Native | Yes | Pi current model | Pi UI | Direct native `customInstructions` |
+| DeepSeek Harness | Native | Yes | Harness current `ctx.llm` route | `userQuestions` UI | Direct native input message |
+
+The current release focuses on native compaction integrations. See
+[`docs/adapter-contract.md`](docs/adapter-contract.md) and
+[`adapters/capabilities.json`](adapters/capabilities.json) for the shared contract
+and capability declaration.
+
+## Python API
+
+```python
+from context_guardian import ContextGuardian
+
+guardian = ContextGuardian()
+result = guardian.inspect(messages)
+
+decisions = [{"candidate_id": result.review[0].id, "action": "keep"}]
+guidance = guardian.build_guidance(result.candidates, decisions)
+print(guidance.text)
+
+checkpoint = guardian.build_checkpoint(result.candidates, decisions)
+print(checkpoint.text)
+```
+
+## Project boundary
+
+Context Guardian intentionally does not implement an agent loop, context window
+management, conversation persistence, vector database, RAG, or a competing summarizer.
+If the host agent already provides a capability, the adapter reuses it.
+
+## Development
+
+```bash
+python -m venv .venv
+. .venv/bin/activate
+python -m pip install -e '.[dev]'
+pytest
+ruff check .
+
+npm install
+npm run typecheck
+npm run typecheck:dsh
+npm run test:dsh
+npm run pi-smoke
+npm run pi-fixture-smoke
+npm run dsh-fixture-smoke
+```
+
+The fast Pi smoke test loads the extension in RPC mode and exercises the Python JSONL
+bridge without requiring a live model call. The important end-to-end check is the
+interactive fixture smoke test:
+
+```bash
+npm run pi-fixture-smoke
+```
+
+It creates a temporary Pi session containing a pre-seeded, sufficiently large
+conversation, opens the Pi UI, and lets you run `/compact` and manually choose
+Keep/Drop for uncertain candidates. This means nobody needs to spend time creating a
+long real conversation just to validate the adapter. The fixture uses the current Pi
+model and authentication, so log in to Pi first if necessary. If the Python core is
+outside the repository virtual environment, set `CONTEXT_GUARDIAN_PYTHON` explicitly.
+
+The DeepSeek Harness adapter has the equivalent interactive fixture:
+
+```bash
+env PATH="/path/to/node-22.19/bin:$PATH" npm run dsh-fixture-smoke
+```
+
+It creates a temporary Harness profile and a pre-seeded long session, opens the Web UI,
+and pauses on an uncertain SQLite decision so you can select Keep or Drop. It also
+verifies that the goal, API constraint, PostgreSQL decision, `auth.py` TODO, and useful
+failure context reach native compaction guidance while transient grep/npm output is
+discarded. No real API key is needed because the fixture uses a replay model.
+
+## License
+
+MIT.

context_guardian_core-0.1.0/README.md

@@ -0,0 +1,221 @@
+# Context Guardian
+
+> Never let your coding agent forget the wrong thing.
+
+[English](README.md) · [简体中文](README.zh-CN.md)
+
+Context Guardian adds a human review layer before an AI agent compacts its context.
+It does not replace the agent's memory system, summarizer, token manager, or native
+compaction engine. It makes the hidden keep/drop decision inspectable.
+
+```text
+Context
+  ↓
+Inspect
+  ↓
+Auto Keep / Auto Drop
+  ↓
+Human Review
+  ↓
+Compaction Guidance
+  ↓
+Agent Native Compaction
+```
+
+## Why it exists
+
+Agents often discard the reason a path was rejected. That can make them repeat the
+same failed approach after compaction. Context Guardian surfaces durable decisions,
+constraints, failed attempts, unfinished work, and transient noise before the host
+agent summarizes the context.
+
+## Quick start
+
+### Installation status
+
+This repository is source-installable today, but the Python and npm packages have
+not been published yet. That means the current path is clone/download → install
+the Python and JavaScript dependencies → run the adapter from the checkout.
+
+The no-checkout installation shown below is the target end-user experience after
+release. The host CLIs remain separate prerequisites. The Python distribution is
+named `context-guardian-core`; its installed CLI remains `context-guardian`.
+
+Package publication is designed around npm Trusted Publishing with GitHub Actions
+OIDC. The release workflow does not use a long-lived `NPM_TOKEN`; configure the
+trusted publisher for each npm package as described in
+[`docs/publishing.md`](docs/publishing.md).
+
+### Use this repository today
+
+```bash
+git clone https://github.com/deulofeu1/context-guardian.git
+cd context-guardian
+
+python3 -m venv .venv
+. .venv/bin/activate
+python -m pip install -e '.[dev]'
+npm install
+```
+
+The workspace install does not install the host CLI itself. The Pi workflow expects
+Pi `0.82.1` and Node.js `22.19.0+`; the DeepSeek Harness workflow expects the
+DeepSeek Harness `0.1.5-rc.x` API family and the same Node.js runtime.
+
+Now run the local Python CLI without an API key:
+
+```bash
+context-guardian inspect examples/conversation.json
+context-guardian inspect examples/conversation.json --json
+context-guardian review examples/conversation.json
+context-guardian verify examples/conversation.json
+```
+
+`verify` is a deterministic release smoke test. It needs no model or API key and
+checks critical-memory retention, noise removal, stable candidate IDs, and rendered
+guidance. It is a fast core check, not a replacement for the interactive Pi test.
+
+For the source Pi workflow, use the interactive fixture from the checkout:
+
+```bash
+npm run pi-fixture-smoke
+```
+
+It opens Pi with a pre-seeded long conversation and lets you manually choose
+Keep/Drop. To load the source extension in an existing Pi session, see
+[`adapters/pi/README.md`](adapters/pi/README.md).
+
+For DeepSeek Harness, install the local adapter into the Web profile:
+
+```bash
+dsh plugin --profile web add "$PWD/adapters/deepseek-harness"
+```
+
+### Install published packages after release
+
+These are the intended commands for end users once the package names are published
+and the Python distribution name is resolved:
+
+```bash
+python -m pip install context-guardian-core
+pi install npm:@context-guardian/pi
+dsh plugin --profile web add context-guardian-deepseek-harness
+```
+
+Until then, do not use these commands as an installation test; use the source
+workflow above.
+
+Inside Pi, the adapter reuses the current host model and its existing credentials.
+No second API key is required. The Python process never receives those credentials.
+The published adapter is tested against Pi `0.82.1` and Node.js `22.19.0+`.
+
+For DeepSeek Harness:
+
+```bash
+dsh plugin --profile web add /absolute/path/to/ContextGuardian/adapters/deepseek-harness
+```
+
+After the adapter is published, the path can be replaced with
+`context-guardian-deepseek-harness`.
+
+This adapter decorates DeepSeek Harness's native `dsh-compaction-basic` backend.
+It reuses Harness's active model route for structured inspection, presents uncertain
+candidates through Harness's user-question UI, and passes the resulting guidance back
+into the native summary. Harness remains responsible for session persistence and the
+compaction transaction. The adapter targets the DeepSeek Harness `0.1.5-rc.x` API
+family and is installed as a separate package from the Pi adapter. Web sessions use
+the selected agent preset, so the preset must contain the Context Guardian compaction
+row; the adapter README documents the one-time preset setup.
+
+## Modes
+
+- Rules mode is local, deterministic, conservative, and the default for the CLI.
+- Pi mode asks the host agent's current model for structured candidates, then uses
+  Pi's native compaction helper with the resulting guidance.
+- OpenAI is an optional standalone CLI provider: `pip install 'context-guardian-core[openai]'` after release.
+
+If the bridge, model call, or review UI fails, the adapter fails open and lets native
+Pi compaction continue normally.
+
+## Integrations
+
+| Platform | Level | Auto trigger | Host model | Human review | Preservation |
+| --- | --- | --- | --- | --- | --- |
+| Pi | Native | Yes | Pi current model | Pi UI | Direct native `customInstructions` |
+| DeepSeek Harness | Native | Yes | Harness current `ctx.llm` route | `userQuestions` UI | Direct native input message |
+
+The current release focuses on native compaction integrations. See
+[`docs/adapter-contract.md`](docs/adapter-contract.md) and
+[`adapters/capabilities.json`](adapters/capabilities.json) for the shared contract
+and capability declaration.
+
+## Python API
+
+```python
+from context_guardian import ContextGuardian
+
+guardian = ContextGuardian()
+result = guardian.inspect(messages)
+
+decisions = [{"candidate_id": result.review[0].id, "action": "keep"}]
+guidance = guardian.build_guidance(result.candidates, decisions)
+print(guidance.text)
+
+checkpoint = guardian.build_checkpoint(result.candidates, decisions)
+print(checkpoint.text)
+```
+
+## Project boundary
+
+Context Guardian intentionally does not implement an agent loop, context window
+management, conversation persistence, vector database, RAG, or a competing summarizer.
+If the host agent already provides a capability, the adapter reuses it.
+
+## Development
+
+```bash
+python -m venv .venv
+. .venv/bin/activate
+python -m pip install -e '.[dev]'
+pytest
+ruff check .
+
+npm install
+npm run typecheck
+npm run typecheck:dsh
+npm run test:dsh
+npm run pi-smoke
+npm run pi-fixture-smoke
+npm run dsh-fixture-smoke
+```
+
+The fast Pi smoke test loads the extension in RPC mode and exercises the Python JSONL
+bridge without requiring a live model call. The important end-to-end check is the
+interactive fixture smoke test:
+
+```bash
+npm run pi-fixture-smoke
+```
+
+It creates a temporary Pi session containing a pre-seeded, sufficiently large
+conversation, opens the Pi UI, and lets you run `/compact` and manually choose
+Keep/Drop for uncertain candidates. This means nobody needs to spend time creating a
+long real conversation just to validate the adapter. The fixture uses the current Pi
+model and authentication, so log in to Pi first if necessary. If the Python core is
+outside the repository virtual environment, set `CONTEXT_GUARDIAN_PYTHON` explicitly.
+
+The DeepSeek Harness adapter has the equivalent interactive fixture:
+
+```bash
+env PATH="/path/to/node-22.19/bin:$PATH" npm run dsh-fixture-smoke
+```
+
+It creates a temporary Harness profile and a pre-seeded long session, opens the Web UI,
+and pauses on an uncertain SQLite decision so you can select Keep or Drop. It also
+verifies that the goal, API constraint, PostgreSQL decision, `auth.py` TODO, and useful
+failure context reach native compaction guidance while transient grep/npm output is
+discarded. No real API key is needed because the fixture uses a replay model.
+
+## License
+
+MIT.