Skip to content

Commit e7a1b64

Browse files
danielmiesslerclaude
danielmiessler
and
claude
committed
feat: Add PAI v3.0 release
Complete PAI v3.0 release with Algorithm v1.4.0, 70+ skills, 20 hooks, agent system, voice server, and full installer. Security-audited with 4 parallel agents scanning 1,230 files across 68+ patterns — zero sensitive data, credentials, or personal information found. Update .pai-protected.json exception_files to cover v3.0 release documentation files containing architectural path references and security pattern documentation. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent d7f6fd5 commit e7a1b64

1,228 files changed

Lines changed: 264201 additions & 1 deletion

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.pai-protected.json‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -381,7 +381,14 @@
381381
"Releases/*/.claude/skills/WebAssessment/FfufResources/*.md",
382382
"Releases/*/.claude/skills/PromptInjection/*.md",
383383
"Releases/*/.claude/skills/Documents/Pdf/*.md",
384-
"Releases/*/.claude/skills/WebAssessment/*.py"
384+
"Releases/*/.claude/skills/WebAssessment/*.py",
385+
"Releases/*/.claude/skills/PAI/*.md",
386+
"Releases/*/.claude/skills/PAI/Components/Algorithm/*.md",
387+
"Releases/*/.claude/skills/PAI/USER/PAISECURITYSYSTEM/*.md",
388+
"Releases/*/.claude/skills/PAI/USER/PAISECURITYSYSTEM/*.yaml",
389+
"Releases/*/.claude/skills/PAI/PAISECURITYSYSTEM/*.yaml",
390+
"Releases/*/.claude/skills/Parser/Prompts/*.md",
391+
"Releases/*/.claude/skills/Parser/Utils/*.ts"
385392
],
386393
"exception_contexts": {
387394
"description": "Patterns that are OK when in documentation/example context",

‎Releases/v3.0/.claude/CLAUDE.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
This file does nothing.
2+
3+
# Read the PAI system for system understanding and initiation
4+
`read skills/PAI/SKILL.md`

‎Releases/v3.0/.claude/MEMORY/README.md‎

Lines changed: 121 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,121 @@
1+
# MEMORY - Unified Memory System
2+
3+
**Version:** 7.0 (Projects-native architecture, 2026-01-12)
4+
5+
Full documentation: `~/.claude/skills/PAI/MEMORYSYSTEM.md`
6+
7+
---
8+
9+
## Architecture
10+
11+
**Claude Code's `projects/` is the source of truth. Hooks capture domain-specific events directly. Harvesting tools extract learnings from session transcripts.**
12+
13+
```
14+
User Request
15+
↓
16+
Claude Code projects/ (native transcript storage - 30-day retention)
17+
↓
18+
Hook Events trigger domain-specific captures:
19+
├── AutoWorkCreation → WORK/
20+
├── ResponseCapture → WORK/, LEARNING/
21+
├── RatingCapture → LEARNING/SIGNALS/
22+
├── WorkCompletionLearning → LEARNING/
23+
├── AgentOutputCapture → RESEARCH/
24+
└── SecurityValidator → SECURITY/
25+
```
26+
27+
**Key insight:** Hooks write directly to specialized directories. There is no intermediate "firehose" layer - Claude Code's `projects/` serves that purpose natively.
28+
29+
---
30+
31+
## Directory Reference
32+
33+
| Directory | Purpose | Format | Access Pattern |
34+
|-----------|---------|--------|----------------|
35+
| **WORK/** | PRIMARY work tracking | Directories + YAML | Read/write per session |
36+
| **LEARNING/** | Derived insights from experience | Markdown + JSONL | Read at session start |
37+
| **RESEARCH/** | Agent output captures | Markdown | Write on agent completion |
38+
| **SECURITY/** | Security audit events | JSONL | Write on security decisions |
39+
| **STATE/** | Fast runtime data (caches, current state) | JSON | High-frequency read/write |
40+
| **PAISYSTEMUPDATES/** | Architecture change history | Markdown | Manual, infrequent |
41+
42+
---
43+
44+
## Directory Details
45+
46+
### Claude Code projects/
47+
**Native session storage.** Complete JSONL transcripts for every session. This is the actual "firehose" - every message, tool call, and response. PAI leverages this native storage rather than duplicating it. 30-day retention, managed by Claude Code.
48+
49+
### WORK/
50+
**Primary work tracking system.** Each work unit gets a directory with META.yaml, items/, verification artifacts, and child work. Created on UserPromptSubmit, updated on Stop, marked COMPLETED on SessionEnd.
51+
52+
### LEARNING/
53+
**Derived insights, not raw events.** Contains:
54+
- `SYSTEM/` - Infrastructure/tooling learnings
55+
- `ALGORITHM/` - Task execution learnings
56+
- `SYNTHESIS/` - Aggregated pattern analysis (weekly/monthly reports)
57+
- `SIGNALS/` - User satisfaction ratings (fast statusline queries)
58+
59+
### STATE/
60+
**Fast real-time operational data.** Frequently read/written JSON files for runtime state. NOT durable knowledge - can be rebuilt from other sources.
61+
- `current-work.json` - Active work directory pointer
62+
- `algorithm-state.json` - Current execution phase
63+
- `format-streak.json`, `algorithm-streak.json` - Performance metrics
64+
- `trending-cache.json` - Cached analysis (TTL-based)
65+
- `progress/` - Multi-session project tracking
66+
- `integrity/` - System health checks
67+
68+
### SECURITY/
69+
**Security decisions and audit trail.** Security-relevant events (blocks, confirmations, alerts).
70+
71+
### RESEARCH/
72+
**Agent output captures.** Markdown files from spawned agents (researchers, architects, engineers).
73+
74+
### PAISYSTEMUPDATES/
75+
**Architecture change history.** Canonical tracking of all system changes over time.
76+
77+
---
78+
79+
## Data Flow
80+
81+
```
82+
User Prompt
83+
↓
84+
Claude Code → projects/{uuid}.jsonl (native transcript)
85+
↓
86+
AutoWorkCreation → WORK/ + STATE/current-work.json
87+
↓
88+
[Work happens - all captured in projects/]
89+
↓
90+
ResponseCapture → Updates WORK/items, optionally LEARNING/
91+
↓
92+
RatingCapture → LEARNING/SIGNALS/ (+ LEARNING/ if low rating)
93+
↓
94+
SessionSummary → WORK/ marked COMPLETED, STATE cleared
95+
96+
[Periodic harvesting]
97+
↓
98+
SessionHarvester → scans projects/ → writes LEARNING/
99+
LearningPatternSynthesis → analyzes SIGNALS/ → writes SYNTHESIS/
100+
```
101+
102+
---
103+
104+
## Quick Commands
105+
106+
```bash
107+
# Current work
108+
cat ~/.claude/MEMORY/STATE/current-work.json
109+
110+
# Recent work directories
111+
ls -lt ~/.claude/MEMORY/WORK/ | head -5
112+
113+
# Recent ratings
114+
tail ~/.claude/MEMORY/LEARNING/SIGNALS/ratings.jsonl
115+
116+
# View session transcripts
117+
ls -lt ~/.claude/projects/-Users-yourname--claude/*.jsonl | head -5
118+
119+
# Check multi-session progress
120+
ls ~/.claude/MEMORY/STATE/progress/
121+
```

‎Releases/v3.0/.claude/PAI-Install/.gitignore‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# Dependencies
2+
electron/node_modules/
3+
node_modules/
4+
5+
# Build artifacts
6+
*.tsbuildinfo
7+
8+
# OS files
9+
.DS_Store
10+
Thumbs.db
11+
12+
# Install state (user-specific)
13+
install-state.json

0 commit comments

Comments
 (0)