Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -387,7 +387,7 @@ Sixteen core tapps-* SKILL.md files per platform in `.claude/skills/` or `.curso
- **tapps-review-pipeline** - Orchestrate a parallel review-fix-validate pipeline
- **tapps-research** - Look up library documentation and research best practices
- **tapps-security** - Run a comprehensive security audit with vulnerability scanning
- **tapps-memory** - Manage shared project memory (42 actions, cross-session)
- **tapps-memory** - Manage shared project memory (44 actions, cross-session)
- **tapps-tool-reference** - Full per-tool reference and when-to-use guidance
- **tapps-init** - Bootstrap TappsMCP scaffolding in a project
- **tapps-upgrade** - Reinstall global CLIs from latest source, restart MCP, run `tapps-mcp upgrade` + doctor + checklist
Expand Down
2 changes: 1 addition & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -181,7 +181,7 @@ You should call `tapps_validate_config(file_path)` when changing Dockerfile, doc

## Memory System

`tapps_memory` provides persistent cross-session knowledge with **42 actions** (save, search, consolidate, federation, profiles, hive, health, knowledge graph, batch ops, feedback, native session memory, and more). **Tiers:** architectural (180d), pattern (60d), procedural (30d), context (14d). **Scopes:** project, branch, session. Max 1500 entries. Configure `memory_hooks` in `.tapps-mcp.yaml` for auto-recall and auto-capture.
`tapps_memory` provides persistent cross-session knowledge with **44 actions** (save, search, consolidate, federation, profiles, hive, health, knowledge graph, batch ops, feedback, native session memory, and more). **Tiers:** architectural (180d), pattern (60d), procedural (30d), context (14d). **Scopes:** project, branch, session. Max 1500 entries. Configure `memory_hooks` in `.tapps-mcp.yaml` for auto-recall and auto-capture.

**Cross-session handoff:** prefer `/tapps-handoff-session` and `/tapps-continue-session` (`.tapps-mcp/session-handoff.md`). For ad-hoc payloads use `tapps-mcp memory save/get`. Cross-agent: `hive_propagate`; cross-project: federation actions.

Expand Down
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ tapps-brain (standalone) <── tapps-core (shared infra) <── tapps-mcp
- **85 deterministic MCP tools** (43 TappsMCP + 42 DocsMCP) — no LLM calls in the tool chain; same input always produces same output
- **Multi-language code scoring** - Python, TypeScript/JavaScript, Go, Rust across 7 categories (complexity, security, maintainability, test coverage, performance, structure, devex)
- **Documentation lookup** via Context7 and LlmsTxt providers with local caching
- **Persistent shared memory** via [tapps-brain](https://github.com/wtthornton/tapps-brain) — project decisions survive across sessions. TappsMCP accesses the Dockerized brain service over HTTP via BrainBridge; use `uv run tapps-mcp memory` (42 actions) or enable `nlt-memory` for MCP-exposed recall/save/handoff tools. See the [tapps-brain repo](https://github.com/wtthornton/tapps-brain) for retrieval, decay, consolidation, and federation internals.
- **Persistent shared memory** via [tapps-brain](https://github.com/wtthornton/tapps-brain) — project decisions survive across sessions. TappsMCP accesses the Dockerized brain service over HTTP via BrainBridge; use `uv run tapps-mcp memory` (44 actions) or enable `nlt-memory` for MCP-exposed recall/save/handoff tools. See the [tapps-brain repo](https://github.com/wtthornton/tapps-brain) for retrieval, decay, consolidation, and federation internals.
- **Unified feature flags** - optional dependency detection (faiss, numpy, radon) with graceful degradation
- **Platform generation** - auto-generates hooks, agents, skills, and rules for Claude Code, Cursor, and VS Code
- **Self-bootstrapping** - `tapps_init` sets up quality infrastructure in any project with one call
Expand Down Expand Up @@ -130,7 +130,7 @@ The platform exposes **85 MCP tools** (43 TappsMCP + 42 DocsMCP) plus workflow p
|--------|-------------|
| **Documentation lookup** | Up-to-date library docs via Context7 (when `TAPPS_MCP_CONTEXT7_API_KEY` is set) and LlmsTxt (always available as fallback). Fuzzy matching, local cache. |
| **Project context** | Detect project type, tech stack, structure for context-aware analysis. |
| **Shared memory** | Powered by [tapps-brain](https://github.com/wtthornton/tapps-brain) — BM25 retrieval, decay, contradiction detection, federation, Hive (Agent Teams). **42 actions** on `tapps_memory` (CRUD, search, federation, profiles, security, maintenance, Hive, knowledge graph, batch ops, feedback, native session memory). Shipped defaults turn on pipeline integrations and hooks; see [docs/MEMORY_REFERENCE.md](docs/MEMORY_REFERENCE.md). For local wiring and the VSCode/GUI-launch env-var gotcha, see [Local setup guide](docs/operations/TAPPS-BRAIN-LOCAL-SETUP.md). |
| **Shared memory** | Powered by [tapps-brain](https://github.com/wtthornton/tapps-brain) — BM25 retrieval, decay, contradiction detection, federation, Hive (Agent Teams). **44 actions** on `tapps_memory` (CRUD, search, federation, profiles, security, maintenance, Hive, knowledge graph, batch ops, feedback, native session memory). Shipped defaults turn on pipeline integrations and hooks; see [docs/MEMORY_REFERENCE.md](docs/MEMORY_REFERENCE.md). For local wiring and the VSCode/GUI-launch env-var gotcha, see [Local setup guide](docs/operations/TAPPS-BRAIN-LOCAL-SETUP.md). |
| **Session notes** | In-memory decisions and constraints for a single session. Promotable to shared memory for persistence. |
| **Impact analysis** | File dependencies and blast radius before refactoring or API changes. |
| **Quality reports** | JSON, Markdown, or HTML summaries. |
Expand Down Expand Up @@ -725,7 +725,7 @@ Quick index:

**Removed MCP tool:** `tapps_memory` left the MCP surface in v3.12.0. Use **`uv run tapps-mcp memory`** or enable **`nlt-memory`** for recall/save/handoff tools.

**What it does:** Persistent, project-scoped shared memory via [tapps-brain](https://github.com/wtthornton/tapps-brain) (Docker + Postgres, HTTP at `localhost:8080`) and **BrainBridge**. The CLI exposes **42 actions** (CRUD, search, federation, knowledge graph, batch ops, feedback, session memory, and more). Tiers: **architectural**, **pattern**, **procedural**, **context** with configurable half-lives. Shipped defaults also enable expert/research auto-save, recurring `tapps_quick_check` procedural memory, **tapps_impact_analysis** `memory_context`, and **memory_hooks** auto-recall/auto-capture — all overridable in `.tapps-mcp.yaml`. See [docs/MEMORY_REFERENCE.md](docs/MEMORY_REFERENCE.md) for the action list and [tapps-brain](https://github.com/wtthornton/tapps-brain) for storage internals.
**What it does:** Persistent, project-scoped shared memory via [tapps-brain](https://github.com/wtthornton/tapps-brain) (Docker + Postgres, HTTP at `localhost:8080`) and **BrainBridge**. The CLI exposes **44 actions** (CRUD, search, federation, knowledge graph, batch ops, feedback, session memory, and more). Tiers: **architectural**, **pattern**, **procedural**, **context** with configurable half-lives. Shipped defaults also enable expert/research auto-save, recurring `tapps_quick_check` procedural memory, **tapps_impact_analysis** `memory_context`, and **memory_hooks** auto-recall/auto-capture — all overridable in `.tapps-mcp.yaml`. See [docs/MEMORY_REFERENCE.md](docs/MEMORY_REFERENCE.md) for the action list and [tapps-brain](https://github.com/wtthornton/tapps-brain) for storage internals.

**Why use it:** Agents start every session without project context unless you persist it. Shared memory holds decisions, patterns, and workflows across sessions, with decay and contradiction checks to reduce stale answers.

Expand Down Expand Up @@ -1083,7 +1083,7 @@ tapps-mcp docs-mcp

### Memory subsystem

The memory system lives in tapps-brain and exposes **42 actions** through **`uv run tapps-mcp memory`** or the **`nlt-memory`** MCP profile (see [docs/MEMORY_REFERENCE.md](docs/MEMORY_REFERENCE.md)):
The memory system lives in tapps-brain and exposes **44 actions** through **`uv run tapps-mcp memory`** or the **`nlt-memory`** MCP profile (see [docs/MEMORY_REFERENCE.md](docs/MEMORY_REFERENCE.md)):

| Tier | Half-life | Use for |
|------|-----------|---------|
Expand Down Expand Up @@ -1364,7 +1364,7 @@ DocsMCP is feature-complete with 32 MCP tools covering README generation, API do
| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | Full architecture documentation. |
| [docs/DOCKER_DEPLOYMENT.md](docs/DOCKER_DEPLOYMENT.md) | Docker build, run, env vars, and client connection. |
| [docs/DOCKER_MCP_TOOLKIT.md](docs/DOCKER_MCP_TOOLKIT.md) | Docker image distribution. |
| [docs/MEMORY_REFERENCE.md](docs/MEMORY_REFERENCE.md) | Full memory system reference (42 actions, configuration, defaults). |
| [docs/MEMORY_REFERENCE.md](docs/MEMORY_REFERENCE.md) | Full memory system reference (44 actions, configuration, defaults). |
| [CHANGELOG.md](CHANGELOG.md) | Release history following Keep a Changelog format. |
| [SECURITY.md](SECURITY.md) | Security policy and vulnerability reporting. |

Expand Down
2 changes: 1 addition & 1 deletion docs/ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ The MCP server is split across ten files (server.py + 9 modules) sharing the sam
- **`server_scoring_tools.py`** -- `tapps_score_file`, `tapps_quality_gate`, `tapps_quick_check`
- **`server_pipeline_tools.py`** -- `tapps_validate_changed`, `tapps_session_start`, `tapps_init`, `tapps_set_engagement_level`, `tapps_upgrade`, `tapps_doctor`, `tapps_pipeline`, `tapps_decompose`
- **`server_metrics_tools.py`** -- `tapps_dashboard`, `tapps_stats`, `tapps_feedback`
- **`server_memory_tools.py`** -- `tapps_memory` (42 actions)
- **`server_memory_tools.py`** -- `tapps_memory` (44 actions)
- **`server_analysis_tools.py`** -- `tapps_session_notes`, `tapps_impact_analysis`, `tapps_report`, `tapps_dead_code`, `tapps_dependency_scan`, `tapps_dependency_graph`, `tapps_audit_campaign`
- **`server_linear_tools.py`** -- `tapps_linear_snapshot_get`, `tapps_linear_snapshot_put`, `tapps_linear_snapshot_invalidate`, `tapps_linear_count` (cache-first Linear read path; see [`.claude/rules/linear-standards.md`](../.claude/rules/linear-standards.md))
- **`server_release_tools.py`** -- `tapps_release_update` (builds release-update payload for the `linear-release-update` skill)
Expand Down
2 changes: 1 addition & 1 deletion docs/INDEX.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@
- [Configuration Reference](CONFIG_REFERENCE.md) — TappsMCP is configured via `.tapps-mcp.yaml` in the project root. Settings can also be overridden with environment va... *(updated 2026-06-22)*
- [Field Report: TappsMCP + DocsMCP Full-Session Usage](FEEDBACK_2026-04-06_agentforge-cleanup-session.md) — **Date:** 2026-04-06 *(updated 2026-04-06)*
- [tapps-mcp — Documentation Index](INDEX.md) — **138 documents** across **9 categories** *(updated 2026-06-22)*
- [TappsMCP Memory Reference](MEMORY_REFERENCE.md) — Complete reference for TappsMCP **shared brain memory** — **42 actions** when accessed via CLI or the `nlt-memory` MC... *(updated 2026-06-16)*
- [TappsMCP Memory Reference](MEMORY_REFERENCE.md) — Complete reference for TappsMCP **shared brain memory** — **44 actions** when accessed via CLI or the `nlt-memory` MC... *(updated 2026-06-16)*
- [Skill Authoring Conventions](SKILL_AUTHORING.md) — Reference commit: mattpocock/skills@b8be62f *(updated 2026-05-27)*
- [TAP-967: 2-Week `list_issues` Call-Count Measurement Report](TAP-967-measurement.md) — **Measurement date:** 2026-05-07 *(updated 2026-06-13)*
- [`packages.docs-mcp.src.docs_mcp`](api/docs-mcp.md) — Docs MCP: Documentation MCP server for the Tapps platform. *(updated 2026-06-22)*
Expand Down
2 changes: 1 addition & 1 deletion docs/MEMORY_REFERENCE.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# TappsMCP Memory Reference

Complete reference for TappsMCP **shared brain memory** — **42 actions** when accessed via CLI or the `nlt-memory` MCP facade (TAP-3895).
Complete reference for TappsMCP **shared brain memory** — **44 actions** when accessed via CLI or the `nlt-memory` MCP facade (TAP-3895).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Document the two actions behind the new count

This reference now advertises 44 actions, but the action tables below still enumerate only 42 names; comparing the page to server_memory_tools._VALID_ACTIONS shows the unlisted actions are session_start_capture and session_end_consolidate. Readers and generated agents using this as the promised complete reference still have no parameter or lifecycle-status guidance for those two actions, so the count bump leaves the docs internally incomplete.

Useful? React with 👍 / 👎.


## How to access memory (CLI vs MCP)

Expand Down
2 changes: 1 addition & 1 deletion docs/tutorials/03-wire-tapps-brain.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,5 +119,5 @@ The four pieces that have to line up: brain HTTP service running (or in-process
## Going further

- [docs/operations/CONSUMER-REPO-BRAIN-WIRING.md](../operations/CONSUMER-REPO-BRAIN-WIRING.md) — per-repo wiring checklist (bootstrap, registration, verification).
- [docs/MEMORY_REFERENCE.md](../MEMORY_REFERENCE.md) — full memory reference (42 actions, tier and scope rules, federation).
- [docs/MEMORY_REFERENCE.md](../MEMORY_REFERENCE.md) — full memory reference (44 actions, tier and scope rules, federation).
- [docs/operations/TAPPS-BRAIN-LOCAL-SETUP.md](../operations/TAPPS-BRAIN-LOCAL-SETUP.md) — production-grade setup, multi-project federation, operational notes.
Original file line number Diff line number Diff line change
Expand Up @@ -230,7 +230,7 @@ Sixteen core tapps-* SKILL.md files per platform in `.claude/skills/` or `.curso
- **tapps-review-pipeline** - Orchestrate a parallel review-fix-validate pipeline
- **tapps-research** - Look up library documentation and research best practices
- **tapps-security** - Run a comprehensive security audit with vulnerability scanning
- **tapps-memory** - Manage shared project memory (42 actions, cross-session)
- **tapps-memory** - Manage shared project memory (44 actions, cross-session)
- **tapps-tool-reference** - Full per-tool reference and when-to-use guidance
- **tapps-init** - Bootstrap TappsMCP scaffolding in a project
- **tapps-upgrade** - Reinstall global CLIs from latest source, restart MCP, run `tapps-mcp upgrade` + doctor + checklist
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -141,7 +141,7 @@ Your project may have two complementary memory systems:

REQUIRED: Use `uv run tapps-mcp memory save|get|search` for architecture decisions and quality patterns. Pin scope keys under `memory_hooks.auto_recall.recall_keys`.

### Memory action reference (42 actions)
### Memory action reference (44 actions)

**Core:** `save` (key, value, tier, scope, tags), `save_bulk` (up to 50 entries), `get` (by key), `list` (filter by scope/tier/tags), `delete` (by key)

Expand Down Expand Up @@ -266,7 +266,7 @@ Sixteen core tapps-* SKILL.md files per platform in `.claude/skills/` or `.curso
- **tapps-review-pipeline** - Orchestrate a parallel review-fix-validate pipeline
- **tapps-research** - Look up library documentation and research best practices
- **tapps-security** - Run a comprehensive security audit with vulnerability scanning
- **tapps-memory** - Manage shared project memory (42 actions, cross-session)
- **tapps-memory** - Manage shared project memory (44 actions, cross-session)
- **tapps-tool-reference** - Full per-tool reference and when-to-use guidance
- **tapps-init** - Bootstrap TappsMCP scaffolding in a project
- **tapps-upgrade** - Reinstall global CLIs from latest source, restart MCP, run `tapps-mcp upgrade` + doctor + checklist
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -167,7 +167,7 @@ Sixteen core tapps-* SKILL.md files per platform in `.claude/skills/` or `.curso
- **tapps-review-pipeline** - Orchestrate a parallel review-fix-validate pipeline
- **tapps-research** - Look up library documentation and research best practices
- **tapps-security** - Run a comprehensive security audit with vulnerability scanning
- **tapps-memory** - Manage shared project memory (42 actions, cross-session)
- **tapps-memory** - Manage shared project memory (44 actions, cross-session)
- **tapps-tool-reference** - Full per-tool reference and when-to-use guidance
- **tapps-init** - Bootstrap TappsMCP scaffolding in a project
- **tapps-upgrade** - Reinstall global CLIs from latest source, restart MCP, run `tapps-mcp upgrade` + doctor + checklist
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -252,7 +252,7 @@ Sixteen core tapps-* SKILL.md files per platform in `.claude/skills/` or `.curso
- **tapps-review-pipeline** - Orchestrate a parallel review-fix-validate pipeline
- **tapps-research** - Look up library documentation and research best practices
- **tapps-security** - Run a comprehensive security audit with vulnerability scanning
- **tapps-memory** - Manage shared project memory (42 actions, cross-session)
- **tapps-memory** - Manage shared project memory (44 actions, cross-session)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Keep the generated medium template count consistent

In the medium AGENTS template this changed summary now says 44 actions, but the same template’s memory section still has ### Memory actions (42 total) earlier in the file. Since this template feeds consumer AGENTS.md content, tapps_init/tapps_upgrade will continue generating instructions with conflicting memory-action counts unless the source header/list is updated along with this bullet.

Useful? React with 👍 / 👎.

- **tapps-tool-reference** - Full per-tool reference and when-to-use guidance
- **tapps-init** - Bootstrap TappsMCP scaffolding in a project
- **tapps-upgrade** - Reinstall global CLIs from latest source, restart MCP, run `tapps-mcp upgrade` + doctor + checklist
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ This validates against security and operational best practices.

## Memory System

`tapps_memory` provides persistent cross-session knowledge with **42 actions** (see AGENTS.md / docs/MEMORY_REFERENCE.md): CRUD, search, intelligence, consolidation, import/export, federation (6), maintenance (validate, maintain), security (safety_check, verify_integrity), profiles (3), health, Hive/Agent Teams (hive_status, hive_search, hive_propagate, agent_register), knowledge graph (related, relations, neighbors, explain_connection), batch ops (recall_many, reinforce_many), feedback (rate), and native session memory (index_session, search_sessions, session_end).
`tapps_memory` provides persistent cross-session knowledge with **44 actions** (see AGENTS.md / docs/MEMORY_REFERENCE.md): CRUD, search, intelligence, consolidation, import/export, federation (6), maintenance (validate, maintain), security (safety_check, verify_integrity), profiles (3), health, Hive/Agent Teams (hive_status, hive_search, hive_propagate, agent_register), knowledge graph (related, relations, neighbors, explain_connection), batch ops (recall_many, reinforce_many), feedback (rate), and native session memory (index_session, search_sessions, session_end).

**Tiers:** architectural (180d), pattern (60d), procedural (30d), context (14d). **Scopes:** project, branch, session. Max 1500 entries. (Federation publishing has its own propagation tier — see federation actions, not a `scope=` value.)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ Consider calling `tapps_validate_config(file_path)` when changing Dockerfile, do

## Memory System

`tapps_memory` provides persistent cross-session knowledge with **42 actions** (save, search, consolidate, federation, profiles, hive, health, knowledge graph, batch ops, feedback, native session memory, and more). Tiers: architectural/pattern/procedural/context. Scopes: project/branch/session. Max 1500 entries. Memory is manual at low engagement: call `search` at session start and `save` before end. Auto-recall/capture hooks are disabled.
`tapps_memory` provides persistent cross-session knowledge with **44 actions** (save, search, consolidate, federation, profiles, hive, health, knowledge graph, batch ops, feedback, native session memory, and more). Tiers: architectural/pattern/procedural/context. Scopes: project/branch/session. Max 1500 entries. Memory is manual at low engagement: call `search` at session start and `save` before end. Auto-recall/capture hooks are disabled.

**Cross-session handoff:** use `/tapps-handoff-session` and `/tapps-continue-session`, or `tapps-mcp memory save/get` for short payloads.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ You should call `tapps_validate_config(file_path)` when changing Dockerfile, doc

## Memory System

`tapps_memory` provides persistent cross-session knowledge with **42 actions** (save, search, consolidate, federation, profiles, hive, health, knowledge graph, batch ops, feedback, native session memory, and more). **Tiers:** architectural (180d), pattern (60d), procedural (30d), context (14d). **Scopes:** project, branch, session. Max 1500 entries. Configure `memory_hooks` in `.tapps-mcp.yaml` for auto-recall and auto-capture.
`tapps_memory` provides persistent cross-session knowledge with **44 actions** (save, search, consolidate, federation, profiles, hive, health, knowledge graph, batch ops, feedback, native session memory, and more). **Tiers:** architectural (180d), pattern (60d), procedural (30d), context (14d). **Scopes:** project, branch, session. Max 1500 entries. Configure `memory_hooks` in `.tapps-mcp.yaml` for auto-recall and auto-capture.

**Cross-session handoff:** prefer `/tapps-handoff-session` and `/tapps-continue-session` (`.tapps-mcp/session-handoff.md`). For ad-hoc payloads use `tapps-mcp memory save/get`. Cross-agent: `hive_propagate`; cross-project: federation actions.

Expand Down
Loading
Loading