Skip to content

Commit 9aef501

Browse files
Dchuong03claude
andcommitted
chore: bump v0.7.0 — Enhanced Claude Code integration, quality gates, macros
New MCP tools: context_pack, macro_run, session_save, session_restore (53 total) New hooks: quality gate (task-complete-gate.sh), smart session bootstrap Full hook template distribution via sidstack update Updated README, CHANGELOG, QUICK_START, CLAUDE_CODE_INTEGRATION docs Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent d0e666d commit 9aef501

31 files changed

Lines changed: 2194 additions & 67 deletions

.gitignore

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -60,9 +60,11 @@ logs/
6060
# SidStack workspace data
6161
.sidstack/
6262

63-
# Claude Code
63+
# Claude Code (project-local, not tracked)
6464
.claude/
6565
JOURNAL.md
66+
# Exception: CLI template files must be tracked for distribution
67+
!packages/cli/templates/governance/.claude/
6668

6769
# MCP local config
6870
.mcp.json
@@ -119,10 +121,8 @@ src-tauri/templates/knowledge/
119121
# Legacy ADRs
120122
docs/ADRs/005-langgraph-orchestration.md
121123

122-
# Legacy presets and skills
124+
# Legacy presets
123125
packages/cli/templates/presets/go-microservices.json
124-
packages/cli/templates/skills/core/file-locking-protocol.md
125-
packages/cli/templates/skills/core/progress-reporting.md
126126

127127
# API server data (session artifacts)
128128
packages/api-server/data/

CHANGELOG.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,37 @@
11
# Changelog
22

3+
## [0.7.0] - 2026-03-06
4+
5+
### Added
6+
- **Context Packs (`context_pack`):** New MCP tool that combines knowledge search + semantic memory + related tasks into a single comprehensive context bundle per module — replaces 3-5 separate tool calls
7+
- **Macro Tools (`macro_run`):** Composite MCP tool with 3 built-in macros:
8+
- `start_work` — create task + search knowledge + search memory in one call
9+
- `finish_work` — complete task + store learnings in memory
10+
- `quick_context` — search knowledge + memory + list active tasks
11+
- **Session Continuity (`session_save` / `session_restore`):** MCP tools to persist and restore session state (decisions, blockers, files modified, progress) across conversations
12+
- **Quality Gate Hook:** PreToolUse hook on `task_complete` that checks test results exist, progress >= 80%, acceptance criteria, and quality commands before allowing completion
13+
- **Smart Session Bootstrap:** Enhanced `session-init.sh` with git branch-to-task correlation, uncommitted changes count, changed modules detection, top pending tasks with priorities, smart next-action suggestions, and automatic session state restore on resume
14+
- **`chore` TaskType:** Added to task type enum for maintenance work
15+
- **CI Deploy:** GitHub Actions workflow for Docker image deployment to GHCR
16+
17+
### Changed
18+
- **Hook Templates:** Full hook configuration now distributed via `sidstack update` — 7 hook scripts (session-init, prompt-context, pre-compact, task-create-context, task-start-training, task-complete-learn, task-complete-gate)
19+
- **Settings Template:** `.claude/settings.json` template updated with all hook registrations including quality gate PreToolUse matcher
20+
- **CLAUDE.md Template:** Simplified governance section, streamlined workflow router, updated tool reference
21+
- **CLI Presets:** Simplified preset configurations (minimal, fullstack-typescript, typescript-backend, python-data)
22+
- **Skill Discovery:** Simplified `SkillDiscovery` class, removed unused methods
23+
- **`sidstack-aware` Skill:** Updated with enhanced workflow classification and progress tracking
24+
25+
### Removed
26+
- **Legacy CLI Skills:** `architecture-understanding`, `code-discovery`, `research-first`, `self-improvement`, `communication-protocol`, `contract-first`, `governance-compliance`, `implementation-analysis`, `workflow-negotiation`
27+
- **Legacy Optional Skills:** `documentation-standards`, `performance-optimization`, `security-awareness`, `tdd-workflow`, `test-driven-development`
28+
- **Dead Code:** `init-wizard.ts`, `skill-manager.ts`, `template-selector.ts`, `migrate-skills.ts`, `config/index.ts`
29+
- **Legacy CLI Skill Files:** `sidstack-init.md` and `packages/cli/skills/core/` directory
30+
31+
### Fixed
32+
- Missing `okr` type in frontend Record maps (CI typecheck)
33+
- Unused imports in test files (CI typecheck)
34+
335
## [0.6.0] - 2026-03-04
436

537
### Added

README.md

Lines changed: 83 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ Or configure MCP manually:
4343
}
4444
```
4545

46-
Claude Code now has access to 32 MCP tools for knowledge, tasks, impact analysis, tickets, training, and OKRs.
46+
Claude Code now has access to 53 MCP tools for knowledge, tasks, impact analysis, tickets, training, memory, macros, and session management.
4747

4848
### Desktop App (macOS)
4949

@@ -59,54 +59,86 @@ pnpm install && pnpm packages:build && pnpm tauri:build
5959

6060
See [Quick Start Guide](docs/QUICK_START.md) for full setup instructions.
6161

62-
## MCP Tools (32)
62+
## MCP Tools (53)
6363

6464
```
65-
# Knowledge (9) - understand your project
66-
knowledge_context Build context for a task/module
67-
knowledge_search Search across knowledge docs
68-
knowledge_list List available docs
69-
knowledge_get Get single document with full content
70-
knowledge_modules List modules with stats
71-
knowledge_create Create knowledge document
72-
knowledge_update Update knowledge document
73-
knowledge_delete Delete knowledge document
74-
knowledge_health Check knowledge coverage health
65+
# Knowledge (10) - understand your project
66+
knowledge_context Build context for a task/module
67+
knowledge_search Search across knowledge docs
68+
knowledge_list List available docs
69+
knowledge_get Get single document with full content
70+
knowledge_modules List modules with stats
71+
knowledge_module_overview Get module architecture overview
72+
knowledge_create Create knowledge document
73+
knowledge_update Update knowledge document
74+
knowledge_delete Delete knowledge document
75+
knowledge_health Check knowledge coverage health
7576
7677
# Tasks (5) - track AI work
77-
task_create Create task with governance
78-
task_update Update status/progress
79-
task_list List tasks with filtering
80-
task_get Get task details
81-
task_complete Complete with quality gate check
78+
task_create Create task with governance
79+
task_update Update status/progress
80+
task_list List tasks with filtering
81+
task_get Get task details
82+
task_complete Complete with quality gate check
8283
8384
# Impact Analysis (3) - assess risk
84-
impact_analyze Run impact analysis on a change
85-
impact_check_gate Check gate status (blocked/warning/clear)
86-
impact_list List analyses
85+
impact_analyze Run impact analysis on a change
86+
impact_check_gate Check gate status (blocked/warning/clear)
87+
impact_list List analyses
8788
8889
# Tickets (4) - external intake
89-
ticket_create Create ticket
90-
ticket_list List/filter tickets
91-
ticket_update Update status
92-
ticket_convert_to_task Convert to task
90+
ticket_create Create ticket
91+
ticket_list List/filter tickets
92+
ticket_update Update status
93+
ticket_convert_to_task Convert to task
9394
9495
# Training (8) - learn from mistakes
95-
incident_create Report an incident
96-
incident_list List incidents
97-
lesson_create Create lesson from incident
98-
lesson_list List lessons
99-
skill_create Create reusable skill
100-
skill_list List skills
101-
rule_check Check rules for context
102-
training_context_get Get training context for session
96+
incident_create Report an incident
97+
incident_list List incidents
98+
lesson_create Create lesson from incident
99+
lesson_list List lessons
100+
skill_create Create reusable skill
101+
skill_list List skills
102+
rule_check Check rules for context
103+
training_context_get Get training context for session
103104
104105
# OKRs (2) - project goals
105-
okr_list List objectives and key results
106-
okr_update Update key result progress
107-
108-
# Sessions (1)
109-
session_launch Launch Claude session with context
106+
okr_list List objectives and key results
107+
okr_update Update key result progress
108+
109+
# Test Results (3) - persist test execution
110+
test_result_create Persist test execution results
111+
test_result_list List test results with filtering
112+
test_result_get Get detailed test result
113+
114+
# Agent Desk (7) - workspace isolation
115+
desk_create Create agent desk (git worktree)
116+
desk_list List all agent desks
117+
desk_status Get desk status and current task
118+
desk_checkout Switch desk to a task
119+
desk_health Check desk health
120+
desk_conflicts Detect merge conflicts
121+
desk_remove Remove agent desk
122+
123+
# Memory (6) - semantic search
124+
memory_add Store a memory entry
125+
memory_search Semantic search across memories
126+
memory_list List memory entries
127+
memory_delete Delete a memory entry
128+
memory_index_knowledge Index knowledge docs into memory
129+
memory_cleanup Clean up expired entries
130+
131+
# Context & References (4)
132+
entity_link Link entities (task↔knowledge, etc.)
133+
entity_references Get references for an entity
134+
entity_context Build context from linked entities
135+
traceability_matrix Generate spec-task-test coverage matrix
136+
137+
# Productivity (v0.7.0)
138+
context_pack Build comprehensive context pack for a module
139+
macro_run Run composite macros (start_work, finish_work, quick_context)
140+
session_save Save session state for cross-session continuity
141+
session_restore Restore saved session state
110142
```
111143

112144
## Desktop App - 7 Views
@@ -128,16 +160,21 @@ sidstack/
128160
├── src/ # React frontend (Tauri)
129161
├── src-tauri/ # Rust backend (Tauri)
130162
├── packages/
131-
│ ├── mcp-server/ # MCP Server (standalone, npx-ready)
132-
│ ├── api-server/ # REST API (Express.js)
133-
│ ├── cli/ # CLI (init, scan, doctor)
134-
│ ├── shared/ # SQLite + shared types + impact engine
135-
│ └── vscode-extension/ # VS Code sidebar integration
136-
├── .sidstack/ # Governance, knowledge, skills
163+
│ ├── mcp-server/ # MCP Server (53 tools, npx-ready)
164+
│ ├── api-server/ # REST API (Express.js, central gateway)
165+
│ ├── cli/ # CLI (init, update, scan, skills, desk)
166+
│ ├── bot-server/ # SidBot (Gemini intent router)
167+
│ ├── web-ui/ # React SPA (browser access)
168+
│ └── shared/ # Repository layer + shared types
169+
├── .sidstack/ # Project data (config, knowledge)
137170
│ ├── governance.md # Master governance doc
138-
│ ├── knowledge/ # Project knowledge docs
139-
│ ├── skills/ # Capability skills (implement, review)
140-
│ └── principles/ # Quality standards
171+
│ └── knowledge/ # Project knowledge docs (9 categories)
172+
├── .claude/ # Claude Code integration
173+
│ ├── hooks/ # Lifecycle hooks (quality gates, bootstrap)
174+
│ ├── skills/ # Auto-triggered agent skills
175+
│ ├── agents/ # Worker + Reviewer agent definitions
176+
│ └── commands/ # Custom slash commands
177+
├── docker/ # Docker deployment configs
141178
└── docs/ # Documentation
142179
```
143180

docs/CLAUDE_CODE_INTEGRATION.md

Lines changed: 29 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ List my SidStack tasks
6161

6262
Claude should use the `task_list` MCP tool.
6363

64-
## Available MCP Tools (49)
64+
## Available MCP Tools (53)
6565

6666
### Knowledge (9)
6767

@@ -132,15 +132,17 @@ Claude should use the `task_list` MCP tool.
132132
| `test_result_list` | List test results with filtering |
133133
| `test_result_get` | Get detailed test result |
134134

135-
### Agent Desk (5)
135+
### Agent Desk (7)
136136

137137
| Tool | Description |
138138
|------|-------------|
139+
| `desk_create` | Create agent desk (git worktree) |
139140
| `desk_list` | List all agent desks |
140141
| `desk_status` | Get desk status and current task |
141-
| `desk_acquire` | Acquire a desk for an agent |
142-
| `desk_release` | Release a desk |
143-
| `desk_pool_init` | Initialize desk pool |
142+
| `desk_checkout` | Switch desk to a task |
143+
| `desk_health` | Check desk health |
144+
| `desk_conflicts` | Detect merge conflicts |
145+
| `desk_remove` | Remove agent desk |
144146

145147
### Memory (6)
146148

@@ -167,6 +169,28 @@ Claude should use the `task_list` MCP tool.
167169
| `entity_references` | Get references for an entity |
168170
| `entity_context` | Build context from linked entities |
169171

172+
### Productivity (4) — v0.7.0
173+
174+
| Tool | Description |
175+
|------|-------------|
176+
| `context_pack` | Build comprehensive context pack for a module (knowledge + memory + tasks in one call) |
177+
| `macro_run` | Run composite macros: `start_work`, `finish_work`, `quick_context` |
178+
| `session_save` | Save session state (decisions, blockers, files, progress) for continuity |
179+
| `session_restore` | Restore saved session state from previous conversation |
180+
181+
### Claude Code Hooks (Quality Gates)
182+
183+
SidStack installs lifecycle hooks in `.claude/hooks/` that enforce quality automatically:
184+
185+
| Hook | Event | Purpose |
186+
|------|-------|---------|
187+
| `session-init.sh` | SessionStart | Smart bootstrap with branch→task correlation, changed modules, session restore |
188+
| `prompt-context.sh` | UserPromptSubmit | Inject active task context with completion reminder |
189+
| `task-complete-gate.sh` | PreToolUse (task_complete) | Block completion without test results, progress check, acceptance criteria |
190+
| `task-create-context.sh` | PostToolUse (task_create) | Remind agent to search knowledge/memory and link entities |
191+
| `task-start-training.sh` | PostToolUse (task_update) | Auto-inject relevant training lessons and rules |
192+
| `pre-compact.sh` | PreCompact | Save active task state before context compaction |
193+
170194
## Governance for Agents
171195

172196
Agents automatically follow governance rules from `.sidstack/governance.md`:

docs/QUICK_START.md

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ npx @sidstack/cli init
3333

3434
### 2. Use MCP Tools in Claude Code
3535

36-
Once initialized, Claude Code has access to 49 tools:
36+
Once initialized, Claude Code has access to 53 tools:
3737

3838
**Knowledge (understand your project)**
3939
```
@@ -99,11 +99,13 @@ test_result_get - Get detailed test result
9999

100100
**Agent Desk (workspace isolation)**
101101
```
102+
desk_create - Create agent desk (git worktree)
102103
desk_list - List all agent desks
103104
desk_status - Get desk status
104-
desk_acquire - Acquire a desk for an agent
105-
desk_release - Release a desk
106-
desk_pool_init - Initialize desk pool
105+
desk_checkout - Switch desk to a task
106+
desk_health - Check desk health
107+
desk_conflicts - Detect merge conflicts
108+
desk_remove - Remove agent desk
107109
```
108110

109111
**Memory (semantic search via mem0)**
@@ -124,6 +126,14 @@ entity_references - Get references for an entity
124126
entity_context - Build context from linked entities
125127
```
126128

129+
**Productivity (v0.7.0)**
130+
```
131+
context_pack - Build comprehensive context pack for a module
132+
macro_run - Run composite macros (start_work, finish_work, quick_context)
133+
session_save - Save session state for cross-session continuity
134+
session_restore - Restore saved session state
135+
```
136+
127137
### 3. Example Workflow
128138

129139
```

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "sidstack",
3-
"version": "0.6.0",
3+
"version": "0.7.0",
44
"private": true,
55
"type": "module",
66
"description": "SidStack - Lightweight AI Agent Orchestration Platform",

packages/api-server/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@sidstack/api-server",
3-
"version": "0.6.0",
3+
"version": "0.7.0",
44
"description": "REST API server for SidStack Web UI",
55
"license": "MIT",
66
"publishConfig": {

packages/bot-server/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@sidstack/bot-server",
3-
"version": "0.5.0",
3+
"version": "0.7.0",
44
"description": "SidBot bot server - Gemini intent router + Claude Code bridge",
55
"license": "MIT",
66
"publishConfig": {

packages/cli/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@sidstack/cli",
3-
"version": "0.6.0",
3+
"version": "0.7.0",
44
"description": "SidStack CLI - Project Intelligence for AI Coding Agents",
55
"author": "SidStack Team",
66
"license": "MIT",

0 commit comments

Comments
 (0)