personal-ai 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +35 -18
- package/SKILL.md +172 -126
- package/dist/{calendar-BHcM4wfQ.mjs → calendar-DGJSyErS.mjs} +2 -2
- package/dist/{calendar-BHcM4wfQ.mjs.map → calendar-DGJSyErS.mjs.map} +1 -1
- package/dist/entry.mjs +810 -239
- package/dist/entry.mjs.map +1 -1
- package/dist/{gmail-B9ja9sKN.mjs → gmail-BhGX6az1.mjs} +2 -2
- package/dist/{gmail-B9ja9sKN.mjs.map → gmail-BhGX6az1.mjs.map} +1 -1
- package/dist/index.mjs +364 -209
- package/dist/index.mjs.map +1 -1
- package/dist/{mac-C9SDXZGK.mjs → mac-vynpftec.mjs} +1 -1
- package/dist/{mac-C9SDXZGK.mjs.map → mac-vynpftec.mjs.map} +1 -1
- package/package.json +1 -1
- /package/dist/{auth-Dtx8Wc3l.mjs → auth-DTf1SI8B.mjs} +0 -0
package/README.md
CHANGED
|
@@ -86,19 +86,27 @@ pai profile --export # 输出可复制粘贴的 profile
|
|
|
86
86
|
pai profile --json # JSON 元数据
|
|
87
87
|
pai distribute # 部署 profile + skill 到 Cursor
|
|
88
88
|
|
|
89
|
-
#
|
|
89
|
+
# 日常记录 (零 LLM)
|
|
90
|
+
pai log <text> # 追加到今日 journal (memory/YYYY-MM-DD.md)
|
|
91
|
+
pai log --clip # 从剪贴板读入
|
|
92
|
+
pai log --show # 查看今日 journal
|
|
93
|
+
pai log --date <date> <text> # 回填指定日期
|
|
94
|
+
|
|
95
|
+
# 数据管理
|
|
90
96
|
pai reset [--force] # 清空所有数据并重新初始化
|
|
91
97
|
pai add <text> # 手动添加文本到 raw/local/
|
|
92
98
|
pai add --url <url> # 抓取 URL 到 raw/web/
|
|
93
99
|
pai add <file> # 添加文件内容
|
|
94
100
|
pai auth google # Google 授权 (gmail/calendar 首次或重授权)
|
|
95
101
|
pai import --source mac # 手动触发 Mac 扫描 (写入 raw)
|
|
96
|
-
pai import --source gmail [--days N] [--query "..."] # Gmail 导入
|
|
102
|
+
pai import --source gmail [--days N] [--query "..."] # Gmail 导入
|
|
97
103
|
pai import --source calendar [--days N] # 日历导入
|
|
98
|
-
pai import --source <src> --path # 批量导入其他数据源 (需 --path)
|
|
99
104
|
|
|
100
|
-
#
|
|
101
|
-
pai distill [--dry-run] [--file] #
|
|
105
|
+
# PINData 提取 (需要 OPENAI_API_KEY)
|
|
106
|
+
pai distill [--dry-run] [--file] # 提取 PINData: raw + journal → vault
|
|
107
|
+
pai distill --today # 只处理今日 journal
|
|
108
|
+
pai digest [--date <date>] # 生成 AI 日摘要
|
|
109
|
+
pai gaps [--days <n>] # 检查缺失日志 (默认 7 天)
|
|
102
110
|
pai generate [--profile <name>] # LLM 生成 SKILL.md
|
|
103
111
|
pai index # 更新 QMD 索引
|
|
104
112
|
|
|
@@ -145,23 +153,24 @@ src/
|
|
|
145
153
|
├── cli/ # CLI 命令注册 (Commander.js)
|
|
146
154
|
│ ├── build-program.ts
|
|
147
155
|
│ ├── command-registry.ts
|
|
148
|
-
│ └── register.*.ts
|
|
156
|
+
│ └── register.*.ts # init/profile/log/distill/digest/gaps/add/search/...
|
|
149
157
|
├── profile/ # Profile 编译器 (scan → profile.md, 零 LLM)
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
├── config/ # 配置管理 (Zod + JSON5)
|
|
158
|
+
├── memory/ # 时间维度 — 日志 + 摘要 (journal.ts)
|
|
159
|
+
├── vault/ # 主题维度 — PINData 结构化知识 (writer.ts)
|
|
160
|
+
├── config/ # 配置管理 (Zod + JSON5 + 路径管理)
|
|
153
161
|
├── auth/ # Google OAuth (encryption + google-oauth)
|
|
154
162
|
├── connectors/ # 数据收集器
|
|
155
163
|
│ ├── mac/ # 14 个 Mac collectors
|
|
156
164
|
│ ├── google/ # gmail.ts, calendar.ts
|
|
157
165
|
│ └── sanitize.ts
|
|
158
|
-
├── raw/ # Raw 层
|
|
159
|
-
├── scraper/ # 网页抓取
|
|
160
|
-
├── distill/ #
|
|
161
|
-
├── generate/ # SKILL.md 生成
|
|
166
|
+
├── raw/ # Raw 层 (来源维度)
|
|
167
|
+
├── scraper/ # 网页抓取 (Playwright + defuddle)
|
|
168
|
+
├── distill/ # PINData 提取 Pipeline (extract.ts)
|
|
169
|
+
├── generate/ # SKILL.md 生成
|
|
162
170
|
├── search/ # QMD 搜索封装
|
|
163
171
|
├── llm/ # OpenAI client
|
|
164
|
-
├── prompts/ # Prompt 模板
|
|
172
|
+
├── prompts/ # Prompt 模板 (extract.ts, generate.ts)
|
|
173
|
+
├── ask/ # Ask agent (Vercel AI SDK + tools)
|
|
165
174
|
├── utils/ # 工具函数
|
|
166
175
|
├── types.ts # 全局类型
|
|
167
176
|
├── index.ts # Public API
|
|
@@ -172,13 +181,21 @@ src/
|
|
|
172
181
|
|
|
173
182
|
```
|
|
174
183
|
~/.pai/
|
|
175
|
-
├── profile.md # 核心产物 — 编译后的用户画像
|
|
176
|
-
├──
|
|
184
|
+
├── profile.md # 核心产物 — 编译后的用户画像 (零 LLM)
|
|
185
|
+
├── memory/ # 时间维度 — 日志 + 摘要
|
|
186
|
+
│ ├── 2026-02-08.md # 每日 journal (pai log 追加)
|
|
187
|
+
│ └── weekly/ # 周摘要 (未来)
|
|
188
|
+
├── raw/ # 来源维度 — 原始数据 (扫描/添加)
|
|
177
189
|
│ ├── local/
|
|
178
190
|
│ ├── web/
|
|
179
191
|
│ └── connector/ # mac/, gmail/, calendar/
|
|
192
|
+
├── vault/ # 主题维度 — PINData 结构化知识
|
|
193
|
+
│ ├── context/ # identity.md, projects.md, services.md
|
|
194
|
+
│ ├── preferences/ # tools.md, workflow.md
|
|
195
|
+
│ ├── work/ # activity.md, finance.md
|
|
196
|
+
│ ├── life/ # interests.md
|
|
197
|
+
│ └── coding/ # lessons.md
|
|
180
198
|
├── credentials/ # Google OAuth: client_secret.json, google-oauth.json.enc
|
|
181
|
-
├── vault/ # 蒸馏后知识 (可选进阶)
|
|
182
199
|
├── skills/profiles/ # LLM 生成的 SKILL.md (可选)
|
|
183
200
|
└── config/
|
|
184
201
|
├── pai.json5
|
|
@@ -207,7 +224,7 @@ pai init && pai distribute # 两步搞定
|
|
|
207
224
|
pai ask "What's the user's deployment preference?" # 推荐：直接拿答案
|
|
208
225
|
pai context --task "configure PostgreSQL connection pooling"
|
|
209
226
|
pai search "database performance" --json
|
|
210
|
-
pai
|
|
227
|
+
pai log "learned: always set pool_size=20 for production" # 快速记住
|
|
211
228
|
```
|
|
212
229
|
|
|
213
230
|
## 开发
|
package/SKILL.md
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
# pai — Personal AI Identity Provider
|
|
2
2
|
|
|
3
|
-
> One command to scan your machine, compile your profile, and deploy to any AI agent.
|
|
3
|
+
> One command to scan your machine, compile your profile, and deploy to any AI agent. Log your day, extract structured knowledge, search your personal memory.
|
|
4
4
|
|
|
5
5
|
<!--
|
|
6
6
|
metadata:
|
|
7
7
|
{
|
|
8
8
|
"name": "pai",
|
|
9
|
-
"version": "0.
|
|
10
|
-
"description": "Local-first AI agent identity system. Scan, compile profile, deploy to agents.",
|
|
9
|
+
"version": "0.2.0",
|
|
10
|
+
"description": "Local-first AI agent identity & memory system. Scan machine, compile profile, log daily journal, extract PINData knowledge, deploy to agents.",
|
|
11
11
|
"requires": {
|
|
12
12
|
"bins": ["pai"],
|
|
13
13
|
"optional_bins": ["qmd"],
|
|
@@ -21,12 +21,13 @@ metadata:
|
|
|
21
21
|
|
|
22
22
|
## What This Skill Does
|
|
23
23
|
|
|
24
|
-
pai is a local-first AI agent identity
|
|
24
|
+
pai is a local-first AI agent identity & memory system. When you have access to this skill, you can:
|
|
25
25
|
|
|
26
26
|
- **Know** who the user is — identity, environment, tools, projects, preferences
|
|
27
|
-
- **
|
|
27
|
+
- **Log** the user's day — quick journal entries, no LLM needed
|
|
28
|
+
- **Remember** structured knowledge (PINData) — facts, preferences, decisions, entities, events
|
|
29
|
+
- **Search** the user's personal knowledge base (vault + raw + memory)
|
|
28
30
|
- **Ask** questions about the user and get direct answers (agentic)
|
|
29
|
-
- **Remember** new lessons, preferences, and discoveries for the user
|
|
30
31
|
|
|
31
32
|
## Quick Setup (1 minute)
|
|
32
33
|
|
|
@@ -51,8 +52,8 @@ That's it. Your agent now knows who you are.
|
|
|
51
52
|
|
|
52
53
|
| Requirement | Feature | How to Get |
|
|
53
54
|
|---|---|---|
|
|
54
|
-
| `qmd` CLI |
|
|
55
|
-
| `OPENAI_API_KEY` | AI features (`pai ask`, `pai distill`) | Set in shell profile |
|
|
55
|
+
| `qmd` CLI | Hybrid search (`pai search`) | `npm install -g https://github.com/tobi/qmd` |
|
|
56
|
+
| `OPENAI_API_KEY` | AI features (`pai ask`, `pai distill`, `pai digest`) | Set in shell profile |
|
|
56
57
|
| Google OAuth | Gmail/Calendar import | `pai auth google` (built-in flow) |
|
|
57
58
|
|
|
58
59
|
### Data Location
|
|
@@ -61,17 +62,33 @@ All data is stored locally at `~/.pai/` (override with `PAI_HOME` env var):
|
|
|
61
62
|
|
|
62
63
|
```
|
|
63
64
|
~/.pai/
|
|
64
|
-
├── profile.md
|
|
65
|
-
├──
|
|
66
|
-
│ ├──
|
|
67
|
-
│
|
|
68
|
-
|
|
69
|
-
├──
|
|
70
|
-
├──
|
|
65
|
+
├── profile.md # Core — compiled user profile (no LLM needed)
|
|
66
|
+
├── memory/ # Time dimension — daily journals & digests
|
|
67
|
+
│ ├── 2026-02-08.md
|
|
68
|
+
│ └── weekly/ # Weekly summaries (future)
|
|
69
|
+
├── raw/ # Source dimension — original input (immutable)
|
|
70
|
+
│ ├── local/ # Text & file input
|
|
71
|
+
│ ├── web/ # Scraped URLs
|
|
72
|
+
│ └── connector/ # Imported data (mac scan, gmail, calendar)
|
|
73
|
+
├── vault/ # Topic dimension — PINData structured knowledge
|
|
74
|
+
│ ├── context/ # identity, projects, services
|
|
75
|
+
│ ├── preferences/ # tools, workflow
|
|
76
|
+
│ ├── work/ # activity, finance
|
|
77
|
+
│ ├── life/ # interests
|
|
78
|
+
│ └── coding/ # lessons
|
|
79
|
+
├── credentials/ # Google OAuth tokens (encrypted)
|
|
71
80
|
├── skills/profiles/ # LLM-generated SKILL.md files (optional)
|
|
72
|
-
└── config/
|
|
81
|
+
└── config/ # pai.json5 + profiles.json5 + preferences.md
|
|
73
82
|
```
|
|
74
83
|
|
|
84
|
+
### Three-Dimensional Data
|
|
85
|
+
|
|
86
|
+
| Layer | Directory | Dimension | Answers |
|
|
87
|
+
|---|---|---|---|
|
|
88
|
+
| `memory/` | YYYY-MM-DD.md | **Time** | "What happened that day?" |
|
|
89
|
+
| `raw/` | local/ web/ connector/ | **Source** | "Where did this data come from?" |
|
|
90
|
+
| `vault/` | context/ preferences/ work/ | **Topic** | "What do I know about X?" |
|
|
91
|
+
|
|
75
92
|
### Verifying Access
|
|
76
93
|
|
|
77
94
|
```bash
|
|
@@ -88,138 +105,135 @@ pai init
|
|
|
88
105
|
|
|
89
106
|
## Available Commands
|
|
90
107
|
|
|
91
|
-
###
|
|
108
|
+
### Profile (Core — no LLM needed)
|
|
92
109
|
|
|
93
110
|
```bash
|
|
94
|
-
#
|
|
95
|
-
pai
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
pai
|
|
99
|
-
|
|
100
|
-
#
|
|
101
|
-
pai
|
|
102
|
-
|
|
103
|
-
# Import from Mac system scan (no --path; auto-scans 11 dimensions)
|
|
104
|
-
pai import --source mac
|
|
105
|
-
pai import --source mac --dry-run
|
|
106
|
-
|
|
107
|
-
# Import from a data connector directory
|
|
108
|
-
pai import --source gmail --path ~/data/gmail-export/
|
|
111
|
+
pai init # Initialize + scan + compile profile (one command)
|
|
112
|
+
pai init --skip-scan # Init only, skip scan (CI/testing)
|
|
113
|
+
pai profile # View your profile
|
|
114
|
+
pai profile --rebuild # Re-scan machine + recompile
|
|
115
|
+
pai profile --export # Plain text output for copy-paste
|
|
116
|
+
pai profile --json # JSON metadata
|
|
117
|
+
pai distribute # Deploy profile + skill to Cursor/Claude
|
|
118
|
+
pai distribute --target cursor # Specific target
|
|
119
|
+
pai reset [--force] # Wipe all data and re-init
|
|
109
120
|
```
|
|
110
121
|
|
|
111
|
-
###
|
|
112
|
-
|
|
113
|
-
Ask a question; an agentic secretary uses tools to find the answer and returns a direct reply. No need to interpret raw search results.
|
|
122
|
+
### Daily Journal (no LLM needed)
|
|
114
123
|
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
**Tools available to the agent:** search vault/raw, read profile, read file, grep (ripgrep), glob, ls, bash. The agent decides which to call and when to stop.
|
|
124
|
+
Quick, low-friction logging. Appends to `memory/YYYY-MM-DD.md`.
|
|
118
125
|
|
|
119
126
|
```bash
|
|
120
|
-
|
|
121
|
-
pai
|
|
122
|
-
pai
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
pai ask "..." --model gpt-4o # override model
|
|
127
|
-
pai ask "..." --verbose # show each tool step
|
|
127
|
+
pai log "Had standup with Ethan, Prediction on track"
|
|
128
|
+
pai log "Decided to use Tailwind instead of vanilla CSS"
|
|
129
|
+
pai log --clip # Read from clipboard
|
|
130
|
+
pai log --show # View today's journal
|
|
131
|
+
pai log --date 2026-02-07 "Backfill yesterday"
|
|
132
|
+
echo "piped text" | pai log # Read from stdin
|
|
128
133
|
```
|
|
129
134
|
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
### Retrieving Context (fast, no LLM)
|
|
135
|
+
### Adding Knowledge to Raw
|
|
133
136
|
|
|
134
137
|
```bash
|
|
135
|
-
|
|
136
|
-
pai
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
pai context
|
|
140
|
-
|
|
141
|
-
# Machine-readable output
|
|
142
|
-
pai context --task "deploy React app" --json
|
|
143
|
-
|
|
144
|
-
# Use a specific profile
|
|
145
|
-
pai context --profile coding-assistant --task "..."
|
|
138
|
+
pai add "Always use connection pooling with PostgreSQL in production"
|
|
139
|
+
pai add --url "https://docs.example.com/best-practices"
|
|
140
|
+
pai add ./meeting-notes.txt
|
|
141
|
+
pai add "some text" --source work
|
|
146
142
|
```
|
|
147
143
|
|
|
148
|
-
###
|
|
144
|
+
### Data Import
|
|
149
145
|
|
|
150
146
|
```bash
|
|
151
|
-
#
|
|
152
|
-
pai
|
|
147
|
+
pai auth google # Google OAuth (once)
|
|
148
|
+
pai import --source mac # Mac scan (14 collectors)
|
|
149
|
+
pai import --source mac --dry-run # Preview mode
|
|
150
|
+
pai import --source gmail # Gmail (default: 30 days)
|
|
151
|
+
pai import --source gmail --days 7 --query "is:important"
|
|
152
|
+
pai import --source calendar # Calendar
|
|
153
|
+
pai import --source calendar --days 60
|
|
154
|
+
```
|
|
153
155
|
|
|
154
|
-
|
|
155
|
-
pai search "PostgreSQL" --raw
|
|
156
|
+
### PINData Extraction (requires OPENAI_API_KEY)
|
|
156
157
|
|
|
157
|
-
|
|
158
|
-
pai search "PostgreSQL" --all
|
|
158
|
+
Extract structured knowledge entries from raw files and journals into vault.
|
|
159
159
|
|
|
160
|
-
|
|
161
|
-
pai search "React hooks" -n 10
|
|
160
|
+
PINData types: `[fact]` / `[pref]` / `[decision]` / `[entity]` / `[event]`
|
|
162
161
|
|
|
163
|
-
|
|
164
|
-
pai
|
|
162
|
+
```bash
|
|
163
|
+
pai distill # Process all pending raw + today's journal
|
|
164
|
+
pai distill --today # Only today's journal
|
|
165
|
+
pai distill --dry-run # Preview extraction, no writes
|
|
166
|
+
pai distill --file ~/.pai/raw/local/xxx.md # Single file
|
|
165
167
|
```
|
|
166
168
|
|
|
167
|
-
###
|
|
169
|
+
### Daily Digest (requires OPENAI_API_KEY)
|
|
170
|
+
|
|
171
|
+
Generate an AI summary of the day, appended to the journal.
|
|
168
172
|
|
|
169
173
|
```bash
|
|
170
|
-
#
|
|
171
|
-
pai
|
|
174
|
+
pai digest # Today's digest
|
|
175
|
+
pai digest --date 2026-02-07 # Specific date
|
|
176
|
+
pai digest --dry-run # Preview without writing
|
|
177
|
+
```
|
|
172
178
|
|
|
173
|
-
|
|
174
|
-
pai distill
|
|
179
|
+
### Journal Gaps
|
|
175
180
|
|
|
176
|
-
|
|
177
|
-
pai distill --file ~/.pai/raw/local/2026-02-06T15-17-xxx.md
|
|
181
|
+
Check for missing daily journals.
|
|
178
182
|
|
|
179
|
-
|
|
180
|
-
pai
|
|
183
|
+
```bash
|
|
184
|
+
pai gaps # Last 7 days
|
|
185
|
+
pai gaps --days 30 # Last 30 days
|
|
181
186
|
```
|
|
182
187
|
|
|
183
|
-
###
|
|
188
|
+
### Ask (RECOMMENDED for Agents — get direct answers)
|
|
184
189
|
|
|
185
|
-
|
|
186
|
-
# Generate all configured profiles
|
|
187
|
-
pai generate
|
|
190
|
+
Agentic secretary that uses tools to find answers. No need to interpret raw search results.
|
|
188
191
|
|
|
189
|
-
|
|
190
|
-
pai generate --profile coding-assistant
|
|
192
|
+
**Requires:** `OPENAI_API_KEY`.
|
|
191
193
|
|
|
192
|
-
|
|
193
|
-
|
|
194
|
+
```bash
|
|
195
|
+
pai ask "What deployment method does this user prefer?"
|
|
196
|
+
pai ask "Does the user have Kubernetes experience?" --json
|
|
197
|
+
pai ask "用户的编码规范是什么？" --steps 15
|
|
198
|
+
pai ask "..." --model gpt-4o --verbose
|
|
194
199
|
```
|
|
195
200
|
|
|
196
|
-
|
|
201
|
+
**Output:** plain answer; or with `--json`: `{ "answer", "sources", "steps" }`.
|
|
202
|
+
|
|
203
|
+
### Context Retrieval (fast, no LLM)
|
|
197
204
|
|
|
198
205
|
```bash
|
|
199
|
-
#
|
|
200
|
-
pai
|
|
201
|
-
pai
|
|
202
|
-
pai
|
|
203
|
-
pai distribute --profile coding-assistant # Use a specific generated profile
|
|
206
|
+
pai context # Identity only
|
|
207
|
+
pai context --task "current task description" # Identity + relevant memories
|
|
208
|
+
pai context --task "deploy React app" --json # Machine-readable
|
|
209
|
+
pai context --profile coding-assistant --task "..."
|
|
204
210
|
```
|
|
205
211
|
|
|
206
|
-
###
|
|
212
|
+
### Search
|
|
207
213
|
|
|
208
214
|
```bash
|
|
209
|
-
#
|
|
210
|
-
pai
|
|
211
|
-
pai
|
|
215
|
+
pai search "PostgreSQL performance" # Hybrid search vault
|
|
216
|
+
pai search "PostgreSQL" --fast # Keyword only
|
|
217
|
+
pai search "PostgreSQL" --vector # Semantic only
|
|
218
|
+
pai search "PostgreSQL" --raw # Search raw
|
|
219
|
+
pai search "PostgreSQL" --all # vault + raw
|
|
220
|
+
pai search "PostgreSQL" --json -n 10 # JSON, 10 results
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
### Generate & Deploy
|
|
212
224
|
|
|
213
|
-
|
|
214
|
-
pai
|
|
215
|
-
pai
|
|
225
|
+
```bash
|
|
226
|
+
pai generate # Generate all SKILL.md profiles
|
|
227
|
+
pai generate --profile coding-assistant # Specific profile
|
|
228
|
+
pai index # Update QMD search index
|
|
229
|
+
pai status [--json] # Data overview
|
|
216
230
|
```
|
|
217
231
|
|
|
218
232
|
## How to Use This Skill as an Agent
|
|
219
233
|
|
|
220
234
|
### 1. Ask questions (recommended)
|
|
221
235
|
|
|
222
|
-
For any question about the user, use `pai ask`
|
|
236
|
+
For any question about the user, use `pai ask` for a direct answer:
|
|
223
237
|
|
|
224
238
|
```bash
|
|
225
239
|
pai ask "What does this user prefer for deployment?"
|
|
@@ -228,75 +242,107 @@ pai ask "What's the user's current project?" --json
|
|
|
228
242
|
|
|
229
243
|
### 2. Retrieve context before starting work
|
|
230
244
|
|
|
231
|
-
For
|
|
245
|
+
For quick identity + task-relevant knowledge (no LLM):
|
|
232
246
|
|
|
233
247
|
```bash
|
|
234
248
|
pai context --task "brief description of what you're about to do"
|
|
235
249
|
```
|
|
236
250
|
|
|
237
|
-
|
|
251
|
+
### 3. Search for specific knowledge
|
|
252
|
+
|
|
253
|
+
When you need raw search results instead of a synthesized answer:
|
|
238
254
|
|
|
239
255
|
```bash
|
|
240
|
-
pai search "editor preferences"
|
|
256
|
+
pai search "editor preferences" --json
|
|
241
257
|
pai search "React deployment" --json -n 3
|
|
242
258
|
```
|
|
243
259
|
|
|
244
|
-
|
|
260
|
+
### 4. Log discoveries and decisions (RECOMMENDED over pai add)
|
|
261
|
+
|
|
262
|
+
When you discover something the user should remember — use `pai log` for quick notes, `pai add` for longer content:
|
|
245
263
|
|
|
246
264
|
```bash
|
|
247
|
-
|
|
265
|
+
# Quick notes (appends to today's journal, no LLM)
|
|
266
|
+
pai log "User prefers dark mode and monospace fonts"
|
|
267
|
+
pai log "Decided: pool_size=20 for production PostgreSQL"
|
|
268
|
+
|
|
269
|
+
# Longer content or URLs (writes to raw/)
|
|
270
|
+
pai add "Detailed explanation of the CORS issue and resolution..."
|
|
248
271
|
pai add --url "https://the-useful-article.com"
|
|
249
272
|
```
|
|
250
273
|
|
|
251
274
|
### 5. Periodic maintenance
|
|
252
275
|
|
|
253
|
-
After
|
|
276
|
+
After logging multiple items, extract and regenerate:
|
|
254
277
|
|
|
255
278
|
```bash
|
|
256
|
-
pai distill #
|
|
279
|
+
pai distill # Extract PINData from pending raw + journal → vault
|
|
280
|
+
pai digest # Generate daily AI summary
|
|
257
281
|
pai generate # Regenerate SKILL.md profiles
|
|
258
282
|
pai distribute # Update deployed agent configs
|
|
259
283
|
```
|
|
260
284
|
|
|
261
|
-
The generated profiles at `~/.pai/skills/profiles/` can be used by other agents.
|
|
262
|
-
|
|
263
285
|
## Data Flow
|
|
264
286
|
|
|
265
287
|
```
|
|
266
|
-
|
|
288
|
+
pai log ──→ memory/YYYY-MM-DD.md (daily journal, append-only)
|
|
289
|
+
│
|
|
290
|
+
User Input ──→ pai add ──→ raw/ │ (original, immutable)
|
|
291
|
+
│ │
|
|
292
|
+
▼ ▼
|
|
293
|
+
pai distill ──→ Extract PINData (1 LLM call)
|
|
294
|
+
│
|
|
295
|
+
▼
|
|
296
|
+
vault/{topic}.md (structured PINData entries)
|
|
297
|
+
│
|
|
298
|
+
┌─────────────┼──────────────┐
|
|
299
|
+
▼ ▼ ▼
|
|
300
|
+
pai generate pai search pai digest
|
|
301
|
+
│ │
|
|
302
|
+
▼ ▼
|
|
303
|
+
skills/profiles/*.md memory/## Digest
|
|
267
304
|
│
|
|
268
305
|
▼
|
|
269
|
-
|
|
306
|
+
pai distribute ──→ ~/.cursor/rules/ (auto-injected)
|
|
270
307
|
│
|
|
271
308
|
▼
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
309
|
+
Agent starts ──→ reads identity from rules (Layer 1: passive)
|
|
310
|
+
Agent works ──→ pai ask / pai context (Layer 2: active retrieval)
|
|
311
|
+
Agent learns ──→ pai log / pai add (Layer 3: write-back)
|
|
312
|
+
```
|
|
313
|
+
|
|
314
|
+
### PINData Entry Format
|
|
315
|
+
|
|
316
|
+
Vault stores structured entries, one per line:
|
|
317
|
+
|
|
318
|
+
```markdown
|
|
319
|
+
- [fact] Vercel project is pin-sandman (2026-02-08 | ref:journal | verified:3)
|
|
320
|
+
- [pref] Prefers pnpm over npm (2026-02-07 | ref:raw/local/xxx.md)
|
|
321
|
+
- [decision] Chose Tailwind over vanilla CSS (2026-02-08 | ref:journal)
|
|
322
|
+
- [entity] Ethan Liu — team member, Prediction module (2026-02-06)
|
|
323
|
+
- [event] ETHDenver 2026 attendance (2026-02-20)
|
|
281
324
|
```
|
|
282
325
|
|
|
326
|
+
5 types: `fact` (data points), `pref` (preferences), `decision` (choices), `entity` (people/orgs/projects), `event` (time-bound).
|
|
327
|
+
|
|
283
328
|
## Security Notes
|
|
284
329
|
|
|
285
330
|
- All data stays on the user's local machine (`~/.pai/`)
|
|
286
331
|
- No data is sent anywhere except to the configured LLM API for processing
|
|
287
332
|
- `OPENAI_API_KEY` is read from environment, never stored in files
|
|
288
|
-
- Raw files are immutable after creation (append-only
|
|
289
|
-
-
|
|
333
|
+
- Raw files are immutable after creation (append-only)
|
|
334
|
+
- Journal files are append-only (new entries inserted before digest)
|
|
335
|
+
- The user controls what goes in and what gets extracted
|
|
290
336
|
|
|
291
337
|
## Profiles Configuration
|
|
292
338
|
|
|
293
|
-
Profiles are defined in `~/.pai/config/profiles.json5
|
|
339
|
+
Profiles are defined in `~/.pai/config/profiles.json5`:
|
|
294
340
|
|
|
295
341
|
```json5
|
|
296
342
|
{
|
|
297
343
|
profiles: {
|
|
298
344
|
"coding-assistant": {
|
|
299
|
-
scope: ["vault/coding/**", "vault/preferences
|
|
345
|
+
scope: ["vault/coding/**", "vault/preferences/**"],
|
|
300
346
|
maxLines: 30,
|
|
301
347
|
},
|
|
302
348
|
"full-context": {
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import { a as info, c as warn, r as googleOAuth } from "./entry.mjs";
|
|
3
|
-
import "./auth-
|
|
3
|
+
import "./auth-DTf1SI8B.mjs";
|
|
4
4
|
import { google } from "googleapis";
|
|
5
5
|
|
|
6
6
|
//#region src/connectors/google/calendar.ts
|
|
@@ -88,4 +88,4 @@ async function syncCalendar(opts = {}) {
|
|
|
88
88
|
|
|
89
89
|
//#endregion
|
|
90
90
|
export { syncCalendar };
|
|
91
|
-
//# sourceMappingURL=calendar-
|
|
91
|
+
//# sourceMappingURL=calendar-DGJSyErS.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"calendar-
|
|
1
|
+
{"version":3,"file":"calendar-DGJSyErS.mjs","names":[],"sources":["../src/connectors/google/calendar.ts"],"sourcesContent":["/**\n * Google Calendar connector — fetches events and returns CollectorResult[] for raw layer.\n *\n * Default behavior: enumerate ALL user-visible calendars via calendarList.list(),\n * tag each event with the calendar display name so the ask agent can distinguish\n * \"Work\" meetings from \"Holiday\" markers.\n */\n\nimport { google } from \"googleapis\";\nimport type { calendar_v3 } from \"googleapis\";\nimport type { CollectorResult } from \"../../types.js\";\nimport { googleOAuth } from \"../../auth/index.js\";\nimport * as console from \"../../utils/console.js\";\n\nexport interface SyncCalendarOptions {\n /** Calendar IDs to fetch. If omitted, fetches ALL user-visible calendars. */\n calendars?: string[];\n /** Days to look back (default 30). */\n lookbackDays?: number;\n /** Days to look forward (default 90). */\n lookforwardDays?: number;\n}\n\nfunction formatEventTime(start: calendar_v3.Schema$EventDateTime): string {\n const dt = start.dateTime ?? start.date;\n const tz = start.timeZone ?? \"UTC\";\n if (!dt) return \"\";\n return `${dt} (${tz})`;\n}\n\n/** Resolve calendar IDs + display names. If explicit list given, use as-is; otherwise enumerate all. */\nasync function resolveCalendars(\n calendarApi: calendar_v3.Calendar,\n explicitIds?: string[],\n): Promise<{ id: string; name: string }[]> {\n if (explicitIds) {\n return explicitIds.map((id) => ({ id, name: id }));\n }\n\n // Enumerate all user-visible calendars\n const res = await calendarApi.calendarList.list({ showHidden: false });\n const items = res.data.items ?? [];\n return items\n .filter((c) => c.id)\n .map((c) => ({\n id: c.id!,\n name: c.summary ?? c.id!,\n }));\n}\n\n/**\n * Sync Google Calendar events and return one CollectorResult per event.\n * Each event includes a **Calendar** field with the display name of its source calendar.\n */\nexport async function syncCalendar(\n opts: SyncCalendarOptions = {},\n): Promise<CollectorResult[]> {\n await googleOAuth.ensureAuthenticated();\n const calendarApi: calendar_v3.Calendar = google.calendar({\n version: \"v3\",\n auth: googleOAuth.getClient(),\n });\n\n const calendars = await resolveCalendars(calendarApi, opts.calendars);\n const lookbackDays = opts.lookbackDays ?? 30;\n const lookforwardDays = opts.lookforwardDays ?? 90;\n\n const now = new Date();\n const timeMin = new Date(\n now.getTime() - lookbackDays * 24 * 60 * 60 * 1000,\n ).toISOString();\n const timeMax = new Date(\n now.getTime() + lookforwardDays * 24 * 60 * 60 * 1000,\n ).toISOString();\n\n console.info(\n `Fetching events from ${calendars.length} calendar(s): ${calendars.map((c) => c.name).join(\", \")}`,\n );\n\n const results: CollectorResult[] = [];\n let failed = 0;\n\n for (const cal of calendars) {\n try {\n const res = await calendarApi.events.list({\n calendarId: cal.id,\n timeMin,\n timeMax,\n singleEvents: true,\n orderBy: \"startTime\",\n maxResults: 250,\n });\n\n const items = res.data.items ?? [];\n for (const event of items) {\n const id = event.id ?? \"\";\n const summary = event.summary ?? \"(no title)\";\n const startStr = event.start\n ? formatEventTime(event.start)\n : \"\";\n const endStr = event.end ? formatEventTime(event.end) : \"\";\n const location = event.location ?? \"\";\n const attendees = (event.attendees ?? [])\n .map((a) => a.email ?? a.displayName ?? \"\")\n .filter(Boolean)\n .join(\", \");\n const status = event.status ?? \"confirmed\";\n\n const lines = [\n `- **Calendar**: ${cal.name}`,\n startStr ? `- **Time**: ${startStr}${endStr ? ` - ${endStr}` : \"\"}` : \"\",\n location ? `- **Location**: ${location}` : \"\",\n attendees ? `- **Attendees**: ${attendees}` : \"\",\n `- **Status**: ${status}`,\n ].filter(Boolean);\n\n results.push({\n id,\n title: summary,\n content: lines.join(\"\\n\") || \"(no details)\",\n });\n }\n } catch (err) {\n failed++;\n const msgText = err instanceof Error ? err.message : String(err);\n console.warn(`Calendar fetch failed for ${cal.name} (${cal.id}): ${msgText}`);\n }\n }\n\n if (failed > 0 && calendars.length > failed) {\n console.warn(`Calendar fetch failed for ${failed} of ${calendars.length} calendar(s).`);\n }\n return results;\n}\n"],"mappings":";;;;;;;;;;;;;AAuBA,SAAS,gBAAgB,OAAiD;CACxE,MAAM,KAAK,MAAM,YAAY,MAAM;CACnC,MAAM,KAAK,MAAM,YAAY;AAC7B,KAAI,CAAC,GAAI,QAAO;AAChB,QAAO,GAAG,GAAG,IAAI,GAAG;;;AAItB,eAAe,iBACb,aACA,aACyC;AACzC,KAAI,YACF,QAAO,YAAY,KAAK,QAAQ;EAAE;EAAI,MAAM;EAAI,EAAE;AAMpD,UAFY,MAAM,YAAY,aAAa,KAAK,EAAE,YAAY,OAAO,CAAC,EACpD,KAAK,SAAS,EAAE,EAE/B,QAAQ,MAAM,EAAE,GAAG,CACnB,KAAK,OAAO;EACX,IAAI,EAAE;EACN,MAAM,EAAE,WAAW,EAAE;EACtB,EAAE;;;;;;AAOP,eAAsB,aACpB,OAA4B,EAAE,EACF;AAC5B,OAAM,YAAY,qBAAqB;CACvC,MAAM,cAAoC,OAAO,SAAS;EACxD,SAAS;EACT,MAAM,YAAY,WAAW;EAC9B,CAAC;CAEF,MAAM,YAAY,MAAM,iBAAiB,aAAa,KAAK,UAAU;CACrE,MAAM,eAAe,KAAK,gBAAgB;CAC1C,MAAM,kBAAkB,KAAK,mBAAmB;CAEhD,MAAM,sBAAM,IAAI,MAAM;CACtB,MAAM,2BAAU,IAAI,KAClB,IAAI,SAAS,GAAG,eAAe,KAAK,KAAK,KAAK,IAC/C,EAAC,aAAa;CACf,MAAM,UAAU,IAAI,KAClB,IAAI,SAAS,GAAG,kBAAkB,KAAK,KAAK,KAAK,IAClD,CAAC,aAAa;AAEf,MACE,wBAAwB,UAAU,OAAO,gBAAgB,UAAU,KAAK,MAAM,EAAE,KAAK,CAAC,KAAK,KAAK,GACjG;CAED,MAAM,UAA6B,EAAE;CACrC,IAAI,SAAS;AAEb,MAAK,MAAM,OAAO,UAChB,KAAI;EAUF,MAAM,SATM,MAAM,YAAY,OAAO,KAAK;GACxC,YAAY,IAAI;GAChB;GACA;GACA,cAAc;GACd,SAAS;GACT,YAAY;GACb,CAAC,EAEgB,KAAK,SAAS,EAAE;AAClC,OAAK,MAAM,SAAS,OAAO;GACzB,MAAM,KAAK,MAAM,MAAM;GACvB,MAAM,UAAU,MAAM,WAAW;GACjC,MAAM,WAAW,MAAM,QACnB,gBAAgB,MAAM,MAAM,GAC5B;GACJ,MAAM,SAAS,MAAM,MAAM,gBAAgB,MAAM,IAAI,GAAG;GACxD,MAAM,WAAW,MAAM,YAAY;GACnC,MAAM,aAAa,MAAM,aAAa,EAAE,EACrC,KAAK,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,CAC1C,OAAO,QAAQ,CACf,KAAK,KAAK;GACb,MAAM,SAAS,MAAM,UAAU;GAE/B,MAAM,QAAQ;IACZ,mBAAmB,IAAI;IACvB,WAAW,eAAe,WAAW,SAAS,MAAM,WAAW,OAAO;IACtE,WAAW,mBAAmB,aAAa;IAC3C,YAAY,oBAAoB,cAAc;IAC9C,iBAAiB;IAClB,CAAC,OAAO,QAAQ;AAEjB,WAAQ,KAAK;IACX;IACA,OAAO;IACP,SAAS,MAAM,KAAK,KAAK,IAAI;IAC9B,CAAC;;UAEG,KAAK;AACZ;EACA,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAChE,OAAa,6BAA6B,IAAI,KAAK,IAAI,IAAI,GAAG,KAAK,UAAU;;AAIjF,KAAI,SAAS,KAAK,UAAU,SAAS,OACnC,MAAa,6BAA6B,OAAO,MAAM,UAAU,OAAO,eAAe;AAEzF,QAAO"}
|