v1.31.1 — contamination scan (feat MINOR)

Installation

Quick Install

# Linux/macOS
curl -fsSL https://get.saw.sh | bash

# Windows (PowerShell)
iwr -useb https://get.saw.sh | iex

Package Managers

# pipx (Recommended)
pipx install smart-agent-wiki

# Homebrew (macOS)
brew install chensaics/tap/saw

# Docker
docker run -it chensaics/saw:1.31.1 saw init

Verify

saw --version

PyPI / Docker images publish when the corresponding repo secrets
(PYPI_API_TOKEN, DOCKER_USERNAME/DOCKER_PASSWORD) are
configured. The sdist + wheel attached below are always available.

Full Changelog: v1.31.1...HEAD

v1.31.0 — Provenance Verification API + Activity 持久化 (feat MINOR)

Installation

Quick Install

# Linux/macOS
curl -fsSL https://get.saw.sh | bash

# Windows (PowerShell)
iwr -useb https://get.saw.sh | iex

Package Managers

# pipx (Recommended)
pipx install smart-agent-wiki

# Homebrew (macOS)
brew install chensaics/tap/saw

# Docker
docker run -it chensaics/saw:1.31.0 saw init

Verify

saw --version

PyPI / Docker images publish when the corresponding repo secrets
(PYPI_API_TOKEN, DOCKER_USERNAME/DOCKER_PASSWORD) are
configured. The sdist + wheel attached below are always available.

Full Changelog: v1.31.0...HEAD

v1.30.2 — AUDIT-F-03 wiki 索引 YAML 韧性 (PATCH)

Installation

Quick Install

# Linux/macOS
curl -fsSL https://get.saw.sh | bash

# Windows (PowerShell)
iwr -useb https://get.saw.sh | iex

Package Managers

# pipx (Recommended)
pipx install smart-agent-wiki

# Homebrew (macOS)
brew install chensaics/tap/saw

# Docker
docker run -it chensaics/saw:1.30.2 saw init

Verify

saw --version

PyPI / Docker images publish when the corresponding repo secrets
(PYPI_API_TOKEN, DOCKER_USERNAME/DOCKER_PASSWORD) are
configured. The sdist + wheel attached below are always available.

Full Changelog: v1.30.2...HEAD

v1.30.1 — audit 快速修复批 (PATCH)

Installation

Quick Install

# Linux/macOS
curl -fsSL https://get.saw.sh | bash

# Windows (PowerShell)
iwr -useb https://get.saw.sh | iex

Package Managers

# pipx (Recommended)
pipx install smart-agent-wiki

# Homebrew (macOS)
brew install chensaics/tap/saw

# Docker
docker run -it chensaics/saw:1.30.1 saw init

Verify

saw --version

PyPI / Docker images publish when the corresponding repo secrets
(PYPI_API_TOKEN, DOCKER_USERNAME/DOCKER_PASSWORD) are
configured. The sdist + wheel attached below are always available.

Full Changelog: v1.30.1...HEAD

v1.30.0

Installation

Quick Install

# Linux/macOS
curl -fsSL https://get.saw.sh | bash

# Windows (PowerShell)
iwr -useb https://get.saw.sh | iex

Package Managers

# pipx (Recommended)
pipx install smart-agent-wiki

# Homebrew (macOS)
brew install chensaics/tap/saw

# Docker
docker run -it chensaics/saw:1.30.0 saw init

Verify

saw --version

PyPI / Docker images publish when the corresponding repo secrets
(PYPI_API_TOKEN, DOCKER_USERNAME/DOCKER_PASSWORD) are
configured. The sdist + wheel attached below are always available.

Full Changelog: v1.30.0...HEAD

v1.29.0

Installation

Quick Install

# Linux/macOS
curl -fsSL https://get.saw.sh | bash

# Windows (PowerShell)
iwr -useb https://get.saw.sh | iex

Package Managers

# pipx (Recommended)
pipx install smart-agent-wiki

# Homebrew (macOS)
brew install chensaics/tap/saw

# Docker
docker run -it chensaics/saw:1.29.0 saw init

Verify

saw --version

PyPI / Docker images publish when the corresponding repo secrets
(PYPI_API_TOKEN, DOCKER_USERNAME/DOCKER_PASSWORD) are
configured. The sdist + wheel attached below are always available.

Full Changelog: v1.29.0...HEAD

v1.28.0

Installation

Quick Install

# Linux/macOS
curl -fsSL https://get.saw.sh | bash

# Windows (PowerShell)
iwr -useb https://get.saw.sh | iex

Package Managers

# pipx (Recommended)
pipx install smart-agent-wiki

# Homebrew (macOS)
brew install chensaics/tap/saw

# Docker
docker run -it chensaics/saw:1.28.0 saw init

Verify

saw --version

PyPI / Docker images publish when the corresponding repo secrets
(PYPI_API_TOKEN, DOCKER_USERNAME/DOCKER_PASSWORD) are
configured. The sdist + wheel attached below are always available.

Full Changelog: v1.28.0...HEAD

v1.27.0

Installation

Quick Install

# Linux/macOS
curl -fsSL https://get.saw.sh | bash

# Windows (PowerShell)
iwr -useb https://get.saw.sh | iex

Package Managers

# pipx (Recommended)
pipx install smart-agent-wiki

# Homebrew (macOS)
brew install chensaics/tap/saw

# Docker
docker run -it chensaics/saw:1.27.0 saw init

Verify

saw --version

PyPI / Docker images publish when the corresponding repo secrets
(PYPI_API_TOKEN, DOCKER_USERNAME/DOCKER_PASSWORD) are
configured. The sdist + wheel attached below are always available.

Full Changelog: v1.27.0...HEAD

v1.26.0

v1.26.0 — B4 NLP Cost-Reduction + B5 Auto-Feedback + D3 Heartbeat Patrol

Three competitive-borrow landings (per docs/analysis/COMPETITIVE-REFERENCE.md): B4 (FastGraphRAG) + B5 (Cognee) + D3 (Letta).

Added

• B4 extract_noun_phrases(text) + saw_nlp_keywords (FastGraphRAG-inspired) — cheap NLP noun-phrase extraction (jieba CJK + regex Latin, no LLM/network) as a cost-reduction pre-index tier / OFFLINE-tier degrade path.
• B5 saw_record_feedback(claim_uuid, helpful) (Cognee-inspired auto-feedback) — per-turn feedback bumps/lowers a claim's 4-level confidence (reuses claims_repo.update_confidence); retrieval drifts toward claims the agent community found useful — no re-ingest.
• D3 HeartbeatScheduler + saw_heartbeat_status (Letta-inspired heartbeat) — apscheduler background patrol runs Governor freshness + Detector unresolved-contradiction scans on an interval (SAW_HEARTBEAT_INTERVAL env), surfacing stale claims / open contradictions proactively.

Release Gate

pytest 2376 passed / 7 skipped / 0 failed (+13: B4×4 + B5×4 + D3×5) · coverage 68.28% · ruff 0 · vitest 64 pass · zero regressions.

Installation

pipx install smart-agent-wiki --force   # or: pip install smart-agent-wiki==1.26.0
saw --version

Differentiation

• FastGraphRAG uses NLP noun-phrases for cheap indexing — SAW lands it jieba-backed (CJK-ready) as a no-LLM degrade path for the OFFLINE tier, complementing (not replacing) the LLM claim extraction.
• Cognee auto-feedback tunes retrieval — SAW adjusts the 4-level confidence directly (so the B3 TRUE/FALSE/SUSPECTED status + Ed25519-receiptable provenance reflect the feedback), not a hidden retrieval score.
• Letta heartbeat runs the agent brain proactively — SAW runs Governor + Detector patrols (governance, not just memory), so stale/contradicted claims surface without a user trigger.

Deferred (gated)

AUDIT-F-05 activity persist (PRD rule 6) · AUDIT-F-06 banner SPEC drift · AUDIT-F-07 desktop signing / vLLM CI / Playwright (infra) · remaining competitive-borrow candidates → v1.27.0+.

Full changelog: CHANGELOG.md. PRD: docs/prd/PRD-nlp-feedback-heartbeat-v1.26.0.md.

v1.25.0

v1.25.0 — A3 DRIFT Hybrid Search + B3 Claim Status Axis

Two competitive-borrow landings (per docs/analysis/COMPETITIVE-REFERENCE.md): A3 (GraphRAG DRIFT) + B3 (claim TRUE/FALSE/SUSPECTED).

Added

• A3 saw_drift_search(query, depth, limit) (GraphRAG DRIFT-inspired) — global (community) + local (entity-neighborhood) hybrid: primer semantic-searches the query to top claims → community_of for the broad view, then per-depth traverse for follow-up local refinement. Confidence-gated (claims below CROSS_VALIDATED flagged SUSPECTED). Built on A2 communities + semantic.
• B3 ClaimStatus (GraphRAG-inspired TRUE/FALSE/SUSPECTED axis) — new enum + derive_claim_status(confidence, contradicted, resolution) reusing SAW's 4-level confidence + B1's contradicts edge resolution (SUPERSEDED→FALSE, DISPUTED/HISTORICAL→SUSPECTED, high-conf not-contradicted→TRUE). Claim.status property; surfaced in saw_search + saw_drift_search output.

Release Gate

pytest 2363 passed / 7 skipped / 0 failed (+8: A3×3 + B3×5) · coverage 68.26% · ruff 0 · vitest 64 pass · zero regressions.

Installation

pipx install smart-agent-wiki --force   # or: pip install smart-agent-wiki==1.25.0
saw --version

Differentiation

• GraphRAG DRIFT expands by community — SAW gates expansion by 4-level confidence (won't follow SUSPECTED premises) and lands on the entity graph (trust-weighted members).
• GraphRAG claims carry TRUE/FALSE/SUSPECTED — SAW derives it from existing confidence + B1 contradicts-edge resolution (no new schema dimension) + Ed25519-receiptable.

Deferred (gated)

AUDIT-F-05 activity persist (PRD rule 6) · AUDIT-F-06 banner SPEC drift · AUDIT-F-07 desktop signing / vLLM CI / Playwright (infra) · remaining competitive-borrow candidates → v1.26.0+.

Full changelog: CHANGELOG.md. PRD: docs/prd/PRD-drift-status-v1.25.0.md.