antigravity-ai-kit 3.5.0 → 3.5.1

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.
@@ -1,6 +1,6 @@
1
1
  # Antigravity AI Kit — CheatSheet
2
2
 
3
- > **Version**: v3.5.0 | **Quick Reference** for all capabilities
3
+ > **Version**: v3.5.1 | **Quick Reference** for all capabilities
4
4
  > **Session**: Start with `/status`, end with session-end checklist
5
5
 
6
6
  ---
@@ -1,6 +1,6 @@
1
1
  # Pre-Commit Checklist
2
2
 
3
- > **Framework**: Antigravity AI Kit v3.5.0
3
+ > **Framework**: Antigravity AI Kit v3.5.1
4
4
  > **Purpose**: Quality gate before committing code
5
5
  > **Principle**: Prevention over correction
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Session End Checklist
2
2
 
3
- > **Framework**: Antigravity AI Kit v3.5.0
3
+ > **Framework**: Antigravity AI Kit v3.5.1
4
4
  > **Purpose**: Complete this checklist before ending any work session
5
5
  > **Principle**: Context preservation for continuity
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Session Start Checklist
2
2
 
3
- > **Framework**: Antigravity AI Kit v3.5.0
3
+ > **Framework**: Antigravity AI Kit v3.5.1
4
4
  > **Purpose**: Complete this checklist at the beginning of every work session
5
5
  > **Principle**: Full context before new work
6
6
 
@@ -1,6 +1,6 @@
1
1
  # Task-Complete Checkpoint
2
2
 
3
- > **Framework**: Antigravity AI Kit v3.5.0
3
+ > **Framework**: Antigravity AI Kit v3.5.1
4
4
  > **Purpose**: Decision gate after task completion — present options before commit/push
5
5
  > **Principle**: Human-in-the-loop governance
6
6
 
@@ -24,7 +24,7 @@ Your complete guide to the Antigravity AI Kit. Type `/help` for a quick overview
24
24
 
25
25
  ## Quick Overview
26
26
 
27
- **Antigravity AI Kit v3.5.0** — Trust-Grade AI Development Framework
27
+ **Antigravity AI Kit v3.5.1** — Trust-Grade AI Development Framework
28
28
 
29
29
  | Category | Count | Description |
30
30
  |:---------|:------|:------------|
@@ -5,8 +5,8 @@
5
5
  "name": "emredursun",
6
6
  "email": "info.emredursun@gmail.com",
7
7
  "role": "owner",
8
- "registeredAt": "2026-03-14T00:18:01.952Z",
9
- "lastActiveAt": "2026-03-14T00:18:01.952Z"
8
+ "registeredAt": "2026-03-16T17:02:45.476Z",
9
+ "lastActiveAt": "2026-03-16T17:02:45.476Z"
10
10
  }
11
11
  ],
12
12
  "activeId": "9c1dbf58766b"
@@ -1,32 +1,108 @@
1
1
  {
2
2
  "schemaVersion": "1.0.0",
3
- "kitVersion": "3.5.0",
4
- "lastAuditedAt": "2026-03-16T05:47:00Z",
3
+ "kitVersion": "3.5.1",
4
+ "lastAuditedAt": null,
5
5
  "description": "Antigravity AI Kit — Trust-Grade AI Development Framework",
6
6
  "repository": "https://github.com/besync-labs/antigravity-ai-kit",
7
7
  "capabilities": {
8
8
  "agents": {
9
9
  "count": 19,
10
10
  "items": [
11
- { "name": "architect", "file": "agents/architect.md", "domain": "System design, DDD, Hexagonal" },
12
- { "name": "backend-specialist", "file": "agents/backend-specialist.md", "domain": "Node.js, NestJS, API design" },
13
- { "name": "build-error-resolver", "file": "agents/build-error-resolver.md", "domain": "Rapid build fixes" },
14
- { "name": "code-reviewer", "file": "agents/code-reviewer.md", "domain": "Quality + security review" },
15
- { "name": "database-architect", "file": "agents/database-architect.md", "domain": "Schema, queries, optimization" },
16
- { "name": "devops-engineer", "file": "agents/devops-engineer.md", "domain": "CI/CD, Docker, deployment" },
17
- { "name": "doc-updater", "file": "agents/doc-updater.md", "domain": "Documentation sync" },
18
- { "name": "e2e-runner", "file": "agents/e2e-runner.md", "domain": "End-to-end testing" },
19
- { "name": "explorer-agent", "file": "agents/explorer-agent.md", "domain": "Codebase discovery" },
20
- { "name": "frontend-specialist", "file": "agents/frontend-specialist.md", "domain": "React, Next.js, UI architecture" },
21
- { "name": "knowledge-agent", "file": "agents/knowledge-agent.md", "domain": "RAG retrieval" },
22
- { "name": "mobile-developer", "file": "agents/mobile-developer.md", "domain": "React Native, Expo" },
23
- { "name": "performance-optimizer", "file": "agents/performance-optimizer.md", "domain": "Core Web Vitals" },
24
- { "name": "planner", "file": "agents/planner.md", "domain": "Task breakdown, Socratic analysis" },
25
- { "name": "refactor-cleaner", "file": "agents/refactor-cleaner.md", "domain": "Dead code cleanup" },
26
- { "name": "reliability-engineer", "file": "agents/reliability-engineer.md", "domain": "SRE, production readiness" },
27
- { "name": "security-reviewer", "file": "agents/security-reviewer.md", "domain": "Vulnerability analysis" },
28
- { "name": "sprint-orchestrator", "file": "agents/sprint-orchestrator.md", "domain": "Sprint planning, velocity" },
29
- { "name": "tdd-guide", "file": "agents/tdd-guide.md", "domain": "Test-first enforcement" }
11
+ {
12
+ "name": "architect",
13
+ "file": "agents/architect.md",
14
+ "domain": "System design, DDD, Hexagonal"
15
+ },
16
+ {
17
+ "name": "backend-specialist",
18
+ "file": "agents/backend-specialist.md",
19
+ "domain": "Node.js, NestJS, API design"
20
+ },
21
+ {
22
+ "name": "build-error-resolver",
23
+ "file": "agents/build-error-resolver.md",
24
+ "domain": "Rapid build fixes"
25
+ },
26
+ {
27
+ "name": "code-reviewer",
28
+ "file": "agents/code-reviewer.md",
29
+ "domain": "Quality + security review"
30
+ },
31
+ {
32
+ "name": "database-architect",
33
+ "file": "agents/database-architect.md",
34
+ "domain": "Schema, queries, optimization"
35
+ },
36
+ {
37
+ "name": "devops-engineer",
38
+ "file": "agents/devops-engineer.md",
39
+ "domain": "CI/CD, Docker, deployment"
40
+ },
41
+ {
42
+ "name": "doc-updater",
43
+ "file": "agents/doc-updater.md",
44
+ "domain": "Documentation sync"
45
+ },
46
+ {
47
+ "name": "e2e-runner",
48
+ "file": "agents/e2e-runner.md",
49
+ "domain": "End-to-end testing"
50
+ },
51
+ {
52
+ "name": "explorer-agent",
53
+ "file": "agents/explorer-agent.md",
54
+ "domain": "Codebase discovery"
55
+ },
56
+ {
57
+ "name": "frontend-specialist",
58
+ "file": "agents/frontend-specialist.md",
59
+ "domain": "React, Next.js, UI architecture"
60
+ },
61
+ {
62
+ "name": "knowledge-agent",
63
+ "file": "agents/knowledge-agent.md",
64
+ "domain": "RAG retrieval"
65
+ },
66
+ {
67
+ "name": "mobile-developer",
68
+ "file": "agents/mobile-developer.md",
69
+ "domain": "React Native, Expo"
70
+ },
71
+ {
72
+ "name": "performance-optimizer",
73
+ "file": "agents/performance-optimizer.md",
74
+ "domain": "Core Web Vitals"
75
+ },
76
+ {
77
+ "name": "planner",
78
+ "file": "agents/planner.md",
79
+ "domain": "Task breakdown, Socratic analysis"
80
+ },
81
+ {
82
+ "name": "refactor-cleaner",
83
+ "file": "agents/refactor-cleaner.md",
84
+ "domain": "Dead code cleanup"
85
+ },
86
+ {
87
+ "name": "reliability-engineer",
88
+ "file": "agents/reliability-engineer.md",
89
+ "domain": "SRE, production readiness"
90
+ },
91
+ {
92
+ "name": "security-reviewer",
93
+ "file": "agents/security-reviewer.md",
94
+ "domain": "Vulnerability analysis"
95
+ },
96
+ {
97
+ "name": "sprint-orchestrator",
98
+ "file": "agents/sprint-orchestrator.md",
99
+ "domain": "Sprint planning, velocity"
100
+ },
101
+ {
102
+ "name": "tdd-guide",
103
+ "file": "agents/tdd-guide.md",
104
+ "domain": "Test-first enforcement"
105
+ }
30
106
  ]
31
107
  },
32
108
  "commands": {
@@ -36,92 +112,290 @@
36
112
  "skills": {
37
113
  "count": 32,
38
114
  "items": [
39
- { "name": "api-patterns", "directory": "skills/api-patterns/" },
40
- { "name": "app-builder", "directory": "skills/app-builder/" },
41
- { "name": "architecture", "directory": "skills/architecture/" },
42
- { "name": "behavioral-modes", "directory": "skills/behavioral-modes/" },
43
- { "name": "brainstorming", "directory": "skills/brainstorming/" },
44
- { "name": "clean-code", "directory": "skills/clean-code/" },
45
- { "name": "context-budget", "directory": "skills/context-budget/" },
46
- { "name": "continuous-learning", "directory": "skills/continuous-learning/" },
47
- { "name": "database-design", "directory": "skills/database-design/" },
48
- { "name": "debugging-strategies", "directory": "skills/debugging-strategies/" },
49
- { "name": "deployment-procedures", "directory": "skills/deployment-procedures/" },
50
- { "name": "docker-patterns", "directory": "skills/docker-patterns/" },
51
- { "name": "eval-harness", "directory": "skills/eval-harness/" },
52
- { "name": "frontend-patterns", "directory": "skills/frontend-patterns/" },
53
- { "name": "git-workflow", "directory": "skills/git-workflow/" },
54
- { "name": "intelligent-routing", "directory": "skills/intelligent-routing/" },
55
- { "name": "i18n-localization", "directory": "skills/i18n-localization/" },
56
- { "name": "mcp-integration", "directory": "skills/mcp-integration/" },
57
- { "name": "mobile-design", "directory": "skills/mobile-design/" },
58
- { "name": "nodejs-patterns", "directory": "skills/nodejs-patterns/" },
59
- { "name": "parallel-agents", "directory": "skills/parallel-agents/" },
60
- { "name": "performance-profiling", "directory": "skills/performance-profiling/" },
61
- { "name": "plan-validation", "directory": "skills/plan-validation/" },
62
- { "name": "plan-writing", "directory": "skills/plan-writing/" },
63
- { "name": "security-practices", "directory": "skills/security-practices/" },
64
- { "name": "strategic-compact", "directory": "skills/strategic-compact/" },
65
- { "name": "testing-patterns", "directory": "skills/testing-patterns/" },
66
- { "name": "typescript-expert", "directory": "skills/typescript-expert/" },
67
- { "name": "ui-ux-pro-max", "directory": "skills/ui-ux-pro-max/" },
68
- { "name": "verification-loop", "directory": "skills/verification-loop/" },
69
- { "name": "webapp-testing", "directory": "skills/webapp-testing/" },
70
- { "name": "shell-conventions", "directory": "skills/shell-conventions/" }
115
+ {
116
+ "name": "api-patterns",
117
+ "directory": "skills/api-patterns/"
118
+ },
119
+ {
120
+ "name": "app-builder",
121
+ "directory": "skills/app-builder/"
122
+ },
123
+ {
124
+ "name": "architecture",
125
+ "directory": "skills/architecture/"
126
+ },
127
+ {
128
+ "name": "behavioral-modes",
129
+ "directory": "skills/behavioral-modes/"
130
+ },
131
+ {
132
+ "name": "brainstorming",
133
+ "directory": "skills/brainstorming/"
134
+ },
135
+ {
136
+ "name": "clean-code",
137
+ "directory": "skills/clean-code/"
138
+ },
139
+ {
140
+ "name": "context-budget",
141
+ "directory": "skills/context-budget/"
142
+ },
143
+ {
144
+ "name": "continuous-learning",
145
+ "directory": "skills/continuous-learning/"
146
+ },
147
+ {
148
+ "name": "database-design",
149
+ "directory": "skills/database-design/"
150
+ },
151
+ {
152
+ "name": "debugging-strategies",
153
+ "directory": "skills/debugging-strategies/"
154
+ },
155
+ {
156
+ "name": "deployment-procedures",
157
+ "directory": "skills/deployment-procedures/"
158
+ },
159
+ {
160
+ "name": "docker-patterns",
161
+ "directory": "skills/docker-patterns/"
162
+ },
163
+ {
164
+ "name": "eval-harness",
165
+ "directory": "skills/eval-harness/"
166
+ },
167
+ {
168
+ "name": "frontend-patterns",
169
+ "directory": "skills/frontend-patterns/"
170
+ },
171
+ {
172
+ "name": "git-workflow",
173
+ "directory": "skills/git-workflow/"
174
+ },
175
+ {
176
+ "name": "intelligent-routing",
177
+ "directory": "skills/intelligent-routing/"
178
+ },
179
+ {
180
+ "name": "i18n-localization",
181
+ "directory": "skills/i18n-localization/"
182
+ },
183
+ {
184
+ "name": "mcp-integration",
185
+ "directory": "skills/mcp-integration/"
186
+ },
187
+ {
188
+ "name": "mobile-design",
189
+ "directory": "skills/mobile-design/"
190
+ },
191
+ {
192
+ "name": "nodejs-patterns",
193
+ "directory": "skills/nodejs-patterns/"
194
+ },
195
+ {
196
+ "name": "parallel-agents",
197
+ "directory": "skills/parallel-agents/"
198
+ },
199
+ {
200
+ "name": "performance-profiling",
201
+ "directory": "skills/performance-profiling/"
202
+ },
203
+ {
204
+ "name": "plan-validation",
205
+ "directory": "skills/plan-validation/"
206
+ },
207
+ {
208
+ "name": "plan-writing",
209
+ "directory": "skills/plan-writing/"
210
+ },
211
+ {
212
+ "name": "security-practices",
213
+ "directory": "skills/security-practices/"
214
+ },
215
+ {
216
+ "name": "strategic-compact",
217
+ "directory": "skills/strategic-compact/"
218
+ },
219
+ {
220
+ "name": "testing-patterns",
221
+ "directory": "skills/testing-patterns/"
222
+ },
223
+ {
224
+ "name": "typescript-expert",
225
+ "directory": "skills/typescript-expert/"
226
+ },
227
+ {
228
+ "name": "ui-ux-pro-max",
229
+ "directory": "skills/ui-ux-pro-max/"
230
+ },
231
+ {
232
+ "name": "verification-loop",
233
+ "directory": "skills/verification-loop/"
234
+ },
235
+ {
236
+ "name": "webapp-testing",
237
+ "directory": "skills/webapp-testing/"
238
+ },
239
+ {
240
+ "name": "shell-conventions",
241
+ "directory": "skills/shell-conventions/"
242
+ }
71
243
  ]
72
244
  },
73
245
  "workflows": {
74
246
  "count": 14,
75
247
  "items": [
76
- { "name": "brainstorm", "file": "workflows/brainstorm.md" },
77
- { "name": "create", "file": "workflows/create.md" },
78
- { "name": "debug", "file": "workflows/debug.md" },
79
- { "name": "deploy", "file": "workflows/deploy.md" },
80
- { "name": "enhance", "file": "workflows/enhance.md" },
81
- { "name": "orchestrate", "file": "workflows/orchestrate.md" },
82
- { "name": "plan", "file": "workflows/plan.md" },
83
- { "name": "preview", "file": "workflows/preview.md" },
84
- { "name": "quality-gate", "file": "workflows/quality-gate.md" },
85
- { "name": "retrospective", "file": "workflows/retrospective.md" },
86
- { "name": "review", "file": "workflows/review.md" },
87
- { "name": "status", "file": "workflows/status.md" },
88
- { "name": "test", "file": "workflows/test.md" },
89
- { "name": "ui-ux-pro-max", "file": "workflows/ui-ux-pro-max.md" }
248
+ {
249
+ "name": "brainstorm",
250
+ "file": "workflows/brainstorm.md"
251
+ },
252
+ {
253
+ "name": "create",
254
+ "file": "workflows/create.md"
255
+ },
256
+ {
257
+ "name": "debug",
258
+ "file": "workflows/debug.md"
259
+ },
260
+ {
261
+ "name": "deploy",
262
+ "file": "workflows/deploy.md"
263
+ },
264
+ {
265
+ "name": "enhance",
266
+ "file": "workflows/enhance.md"
267
+ },
268
+ {
269
+ "name": "orchestrate",
270
+ "file": "workflows/orchestrate.md"
271
+ },
272
+ {
273
+ "name": "plan",
274
+ "file": "workflows/plan.md"
275
+ },
276
+ {
277
+ "name": "preview",
278
+ "file": "workflows/preview.md"
279
+ },
280
+ {
281
+ "name": "quality-gate",
282
+ "file": "workflows/quality-gate.md"
283
+ },
284
+ {
285
+ "name": "retrospective",
286
+ "file": "workflows/retrospective.md"
287
+ },
288
+ {
289
+ "name": "review",
290
+ "file": "workflows/review.md"
291
+ },
292
+ {
293
+ "name": "status",
294
+ "file": "workflows/status.md"
295
+ },
296
+ {
297
+ "name": "test",
298
+ "file": "workflows/test.md"
299
+ },
300
+ {
301
+ "name": "ui-ux-pro-max",
302
+ "file": "workflows/ui-ux-pro-max.md"
303
+ }
90
304
  ]
91
305
  },
92
306
  "rules": {
93
307
  "count": 8,
94
308
  "items": [
95
- { "name": "architecture", "file": "rules/architecture.md" },
96
- { "name": "coding-style", "file": "rules/coding-style.md" },
97
- { "name": "documentation", "file": "rules/documentation.md" },
98
- { "name": "git-workflow", "file": "rules/git-workflow.md" },
99
- { "name": "quality-gate", "file": "rules/quality-gate.md" },
100
- { "name": "security", "file": "rules/security.md" },
101
- { "name": "sprint-tracking", "file": "rules/sprint-tracking.md" },
102
- { "name": "testing", "file": "rules/testing.md" }
309
+ {
310
+ "name": "architecture",
311
+ "file": "rules/architecture.md"
312
+ },
313
+ {
314
+ "name": "coding-style",
315
+ "file": "rules/coding-style.md"
316
+ },
317
+ {
318
+ "name": "documentation",
319
+ "file": "rules/documentation.md"
320
+ },
321
+ {
322
+ "name": "git-workflow",
323
+ "file": "rules/git-workflow.md"
324
+ },
325
+ {
326
+ "name": "quality-gate",
327
+ "file": "rules/quality-gate.md"
328
+ },
329
+ {
330
+ "name": "security",
331
+ "file": "rules/security.md"
332
+ },
333
+ {
334
+ "name": "sprint-tracking",
335
+ "file": "rules/sprint-tracking.md"
336
+ },
337
+ {
338
+ "name": "testing",
339
+ "file": "rules/testing.md"
340
+ }
103
341
  ]
104
342
  },
105
343
  "checklists": {
106
344
  "count": 4,
107
345
  "items": [
108
- { "name": "pre-commit", "file": "checklists/pre-commit.md" },
109
- { "name": "session-start", "file": "checklists/session-start.md" },
110
- { "name": "session-end", "file": "checklists/session-end.md" },
111
- { "name": "task-complete", "file": "checklists/task-complete.md" }
346
+ {
347
+ "name": "pre-commit",
348
+ "file": "checklists/pre-commit.md"
349
+ },
350
+ {
351
+ "name": "session-start",
352
+ "file": "checklists/session-start.md"
353
+ },
354
+ {
355
+ "name": "session-end",
356
+ "file": "checklists/session-end.md"
357
+ },
358
+ {
359
+ "name": "task-complete",
360
+ "file": "checklists/task-complete.md"
361
+ }
112
362
  ]
113
363
  },
114
364
  "hooks": {
115
365
  "count": 8,
116
366
  "items": [
117
- { "name": "session-start", "event": "session-start" },
118
- { "name": "session-end", "event": "session-end" },
119
- { "name": "pre-commit", "event": "pre-commit" },
120
- { "name": "secret-detection", "event": "secret-detection" },
121
- { "name": "phase-transition", "event": "phase-transition" },
122
- { "name": "sprint-checkpoint", "event": "sprint-checkpoint" },
123
- { "name": "plan-complete", "event": "plan-complete" },
124
- { "name": "task-complete", "event": "task-complete" }
367
+ {
368
+ "name": "session-start",
369
+ "event": "session-start"
370
+ },
371
+ {
372
+ "name": "session-end",
373
+ "event": "session-end"
374
+ },
375
+ {
376
+ "name": "pre-commit",
377
+ "event": "pre-commit"
378
+ },
379
+ {
380
+ "name": "secret-detection",
381
+ "event": "secret-detection"
382
+ },
383
+ {
384
+ "name": "phase-transition",
385
+ "event": "phase-transition"
386
+ },
387
+ {
388
+ "name": "sprint-checkpoint",
389
+ "event": "sprint-checkpoint"
390
+ },
391
+ {
392
+ "name": "plan-complete",
393
+ "event": "plan-complete"
394
+ },
395
+ {
396
+ "name": "task-complete",
397
+ "event": "task-complete"
398
+ }
125
399
  ]
126
400
  }
127
401
  }
@@ -1,80 +1,69 @@
1
- # AI Session Context
2
-
3
- > **Purpose**: Quick context loading for AI agents to resume work efficiently
4
- > **Auto-Updated**: End of each session
5
- > **Last Updated**: 2026-02-06
6
-
7
- ---
8
-
9
- ## Last Session Summary
10
-
11
- **Date**: February 6, 2026
12
- **Duration**: ~35m
13
- **Focus Area**: Documentation alignment with README.md
14
-
15
- ### What Was Done
16
-
17
- - [x] Updated `docs/index.md` 17 agents, checklists, hooks
18
- - [x] Updated `docs/getting-started.md` — NPX Quick Start as Option 1
19
- - [x] Updated `docs/agents/index.md` — 17 agents in 3 categories
20
- - [x] Created `docs/session-management.md` — Full section from README
21
- - [x] Created `docs/architecture.md` ASCII diagram
22
- - [x] Created `docs/extending.md` Custom agents/skills/commands guide
23
- - [x] Created `docs/contributing.md` Development workflow
24
- - [x] Updated `mkdocs.yml` — New nav sections, OG meta tags to 17 agents
25
- - [x] Deployed to GitHub Pages — besync-labs.github.io/antigravity-ai-kit
26
-
27
- ### Session Commits
28
-
29
- | Commit | Message | Branch |
30
- | :------ | :-------------------------------------- | :----- |
31
- | 826a3e1 | docs: update documentation to v2.0.0 | main |
32
- | 64f9d39 | docs: complete alignment with README.md | main |
33
-
34
- ### Open Items (Priority Order)
35
-
36
- 1. [ ] **Port BeSync Skills** — i18n-localization, seo-fundamentals, shell-scripting, documentation-templates, image-processing, knowledge-indexing, vulnerability-scanner
37
- 2. [ ] **Port BeSync Commands** — analyze-image, index, insights, knowledge, metrics, notify, onboard, review-pr, rollback, track
38
-
39
- ---
40
-
41
- ## Current Working Context
42
-
43
- **Branch**: `main`
44
- **Repository**: `besync-labs/antigravity-ai-kit`
45
- **Framework**: Antigravity AI Kit v3.5.0
46
-
47
- ### Key File Locations
48
-
49
- | Purpose | Path |
50
- | :------------ | :-------------- |
51
- | Main Entry | `.agent/` |
52
- | Documentation | `docs/` |
53
- | Configuration | `mkdocs.yml` |
54
- | CLI Tool | `bin/ag-kit.js` |
55
-
56
- ---
57
-
58
- ## Quick Resume
59
-
60
- ```bash
61
- # Common commands to resume work
62
- cd d:\ProfesionalDevelopment\AntigravityProjects\antigravity-ai-kit
63
- git status
64
- git log -n 3 --oneline
65
- ```
66
-
67
- ### Environment Notes
68
-
69
- - MkDocs not installed locally — GitHub Actions handles docs build
70
- - NPM package published as `@emredursun/antigravity-ai-kit`
71
-
72
- ---
73
-
74
- ## Handoff Notes
75
-
76
- If another session will continue this work:
77
-
78
- - **Next Priority**: Port BeSync-specific skills and commands to AI Kit
79
- - **Blockers**: None
80
- - **Context Files**: `docs/skills/index.md`, `.agent/skills/`, `.agent/commands/`
1
+ # AI Session Context
2
+
3
+ > **Purpose**: Quick context loading for AI agents to resume work efficiently
4
+ > **Auto-Updated**: End of each session
5
+ > **Last Updated**:
6
+
7
+ ---
8
+
9
+ ## Last Session Summary
10
+
11
+ **Date**:
12
+ **Duration**:
13
+ **Focus Area**:
14
+
15
+ ### What Was Done
16
+
17
+ - [ ] _(Updated automatically at session end)_
18
+
19
+ ### Session Commits
20
+
21
+ | Commit | Message | Branch |
22
+ | :----- | :------ | :----- |
23
+ | — | — | |
24
+
25
+ ### Open Items (Priority Order)
26
+
27
+ 1. [ ] _(Add your current priorities here)_
28
+
29
+ ---
30
+
31
+ ## Current Working Context
32
+
33
+ **Branch**: —
34
+ **Repository**:
35
+ **Framework**: Antigravity AI Kit v3.5.1
36
+
37
+ ### Key File Locations
38
+
39
+ | Purpose | Path |
40
+ | :------------ | :-------------- |
41
+ | Main Entry | `.agent/` |
42
+ | Documentation | `docs/` |
43
+ | Configuration | `mkdocs.yml` |
44
+ | CLI Tool | `bin/ag-kit.js` |
45
+
46
+ ---
47
+
48
+ ## Quick Resume
49
+
50
+ ```bash
51
+ # Common commands to resume work
52
+ git status
53
+ git log -n 3 --oneline
54
+ ag-kit status
55
+ ```
56
+
57
+ ### Environment Notes
58
+
59
+ - _(Add project-specific notes here)_
60
+
61
+ ---
62
+
63
+ ## Handoff Notes
64
+
65
+ If another session will continue this work:
66
+
67
+ - **Next Priority**: _(Describe next task)_
68
+ - **Blockers**: None
69
+ - **Context Files**: _(List relevant files)_
@@ -19,7 +19,7 @@ User Request → Analyze → Select Stack → Plan → Scaffold → Coordinate
19
19
 
20
20
  ---
21
21
 
22
- ## 📦 BeSync Default Stack
22
+ ## 📦 Recommended Default Stack
23
23
 
24
24
  | Layer | Technology | Alternative |
25
25
  | ---------------- | ----------------------------- | ----------- |
@@ -68,7 +68,7 @@ allowed-tools: Read, Glob, Grep, Bash
68
68
 
69
69
  ## 3. Platform-Specific Procedures
70
70
 
71
- ### Vercel (BeSync Primary)
71
+ ### Vercel
72
72
 
73
73
  ```bash
74
74
  # Preview deploy (automatic on PR)
@@ -172,7 +172,7 @@ Before deploying:
172
172
 
173
173
  ---
174
174
 
175
- ## 9. BeSync Deployment Flow
175
+ ## 9. Example Deployment Flow
176
176
 
177
177
  ```
178
178
  develop → staging (auto) → main → production (auto)
@@ -188,4 +188,4 @@ export const config = {
188
188
 
189
189
  ---
190
190
 
191
- > **Source**: Antigravity AI Kit — [besync-labs/antigravity-ai-kit](https://github.com/besync-labs/antigravity-ai-kit)
191
+ > **Source**: Antigravity AI Kit — [antigravity-ai-kit](https://github.com/besync-labs/antigravity-ai-kit)
@@ -146,7 +146,7 @@ GPU-accelerated (FAST): CPU-bound (SLOW):
146
146
  ### Before Starting ANY Mobile Project
147
147
 
148
148
  - [ ] Platform(s) confirmed (iOS/Android/Both)
149
- - [ ] Framework chosen (Expo preferred for BeSync)
149
+ - [ ] Framework chosen (Expo recommended)
150
150
  - [ ] Navigation pattern decided
151
151
  - [ ] Offline requirements clarified
152
152
  - [ ] Design system tokens defined
@@ -167,7 +167,7 @@ GPU-accelerated (FAST): CPU-bound (SLOW):
167
167
 
168
168
  ---
169
169
 
170
- ## 🔗 BeSync Mobile Stack
170
+ ## 🔗 Recommended Mobile Stack
171
171
 
172
172
  | Layer | Technology |
173
173
  | ---------- | -------------------------------- |
@@ -153,7 +153,7 @@ tests/
153
153
 
154
154
  ---
155
155
 
156
- ## 9. BeSync Testing Standards
156
+ ## 9. Recommended Testing Standards
157
157
 
158
158
  ### Required Coverage
159
159
 
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 🚀 Antigravity AI Kit
2
2
 
3
- ![version](https://img.shields.io/badge/version-3.5.0-blue)
3
+ ![version](https://img.shields.io/badge/version-3.5.1-blue)
4
4
  ![license](https://img.shields.io/badge/license-MIT-green)
5
5
  ![AI Agents](https://img.shields.io/badge/AI%20Agents-19-purple)
6
6
  ![Skills](https://img.shields.io/badge/Skills-32-orange)
package/bin/ag-kit.js CHANGED
@@ -188,10 +188,11 @@ function initCommand(options) {
188
188
  }
189
189
 
190
190
  // C-2: Auto-backup before force-overwrite
191
+ let backupPath = null;
191
192
  if (options.force && fs.existsSync(agentPath)) {
192
- logStep('1/4', 'Backing up existing .agent folder...');
193
+ logStep('1/5', 'Backing up existing .agent folder...');
193
194
  try {
194
- const backupPath = backupDirectory(agentPath);
195
+ backupPath = backupDirectory(agentPath);
195
196
  log(` ✓ Backup created: ${path.basename(backupPath)}`, 'green');
196
197
  } catch (err) {
197
198
  log(` ⚠️ Backup failed: ${err.message}`, 'yellow');
@@ -200,7 +201,7 @@ function initCommand(options) {
200
201
  }
201
202
 
202
203
  // C-3: Atomic copy via temp directory
203
- const stepPrefix = options.force && fs.existsSync(agentPath) ? '2/4' : '1/3';
204
+ const stepPrefix = options.force && fs.existsSync(agentPath) ? '2/5' : '1/3';
204
205
  logStep(stepPrefix, 'Copying .agent folder...');
205
206
 
206
207
  const tempPath = `${agentPath}.tmp-${Date.now()}`;
@@ -225,6 +226,42 @@ function initCommand(options) {
225
226
  log(` ✗ Failed to copy: ${err.message}`, 'red');
226
227
  process.exit(1);
227
228
  }
229
+
230
+ // E3: Restore user data files from backup after force-overwrite
231
+ if (backupPath && fs.existsSync(backupPath)) {
232
+ logStep('3/5', 'Restoring user session data from backup...');
233
+ const userDataFiles = ['session-context.md', 'session-state.json', path.join('engine', 'identity.json')];
234
+ const userDataDirs = ['decisions', 'contexts'];
235
+ let restoredCount = 0;
236
+
237
+ for (const file of userDataFiles) {
238
+ const backupFile = path.join(backupPath, file);
239
+ const targetFile = path.join(agentPath, file);
240
+ if (fs.existsSync(backupFile)) {
241
+ const targetDirPath = path.dirname(targetFile);
242
+ if (!fs.existsSync(targetDirPath)) {
243
+ fs.mkdirSync(targetDirPath, { recursive: true });
244
+ }
245
+ fs.copyFileSync(backupFile, targetFile);
246
+ log(` ✓ Restored ${file}`, 'green');
247
+ restoredCount++;
248
+ }
249
+ }
250
+
251
+ for (const dir of userDataDirs) {
252
+ const backupDir = path.join(backupPath, dir);
253
+ const targetDirPath = path.join(agentPath, dir);
254
+ if (fs.existsSync(backupDir)) {
255
+ safeCopyDirSync(backupDir, targetDirPath);
256
+ log(` ✓ Restored ${dir}/`, 'green');
257
+ restoredCount++;
258
+ }
259
+ }
260
+
261
+ if (restoredCount === 0) {
262
+ log(' ○ No user data to restore', 'yellow');
263
+ }
264
+ }
228
265
 
229
266
  // Verify installation
230
267
  logStep('2/3', 'Verifying installation...');
package/lib/updater.js CHANGED
@@ -18,14 +18,21 @@ const crypto = require('crypto');
18
18
 
19
19
  const { AGENT_DIR } = require('./constants');
20
20
 
21
- /** Files that should never be overwritten during updates */
22
- const PRESERVED_FILES = new Set([
21
+ /**
22
+ * User data files that should NEVER be overwritten during updates.
23
+ * These contain project-specific data populated at runtime.
24
+ */
25
+ const USER_DATA_FILES = new Set([
23
26
  'session-context.md',
24
27
  'session-state.json',
28
+ 'engine/identity.json',
25
29
  ]);
26
30
 
27
- /** Directories whose contents should never be overwritten */
28
- const PRESERVED_DIRS = new Set([
31
+ /**
32
+ * User data directories whose contents should NEVER be overwritten.
33
+ * These contain project-specific decisions and context.
34
+ */
35
+ const USER_DATA_DIRS = new Set([
29
36
  'decisions',
30
37
  'contexts',
31
38
  ]);
@@ -86,15 +93,23 @@ function collectFiles(rootDir, prefix = '') {
86
93
  * @returns {boolean} True if the file should be preserved
87
94
  */
88
95
  function isPreservedFile(relativePath) {
89
- // Check exact filename matches
96
+ // Normalize path separators for cross-platform matching
97
+ const normalizedPath = relativePath.replace(/\\/g, '/');
98
+
99
+ // Check exact relative path matches (e.g., 'engine/identity.json')
100
+ if (USER_DATA_FILES.has(normalizedPath)) {
101
+ return true;
102
+ }
103
+
104
+ // Check basename matches for root-level files (e.g., 'session-context.md')
90
105
  const basename = path.basename(relativePath);
91
- if (PRESERVED_FILES.has(basename)) {
106
+ if (USER_DATA_FILES.has(basename)) {
92
107
  return true;
93
108
  }
94
109
 
95
- // Check if inside a preserved directory
96
- const parts = relativePath.split(/[/\\]/);
97
- for (const dir of PRESERVED_DIRS) {
110
+ // Check if inside a user data directory
111
+ const parts = normalizedPath.split('/');
112
+ for (const dir of USER_DATA_DIRS) {
98
113
  if (parts.includes(dir)) {
99
114
  return true;
100
115
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "antigravity-ai-kit",
3
- "version": "3.5.0",
3
+ "version": "3.5.1",
4
4
  "description": "🚀 Trust-Grade AI development framework with a 29-module runtime engine — 19 Agents, 32 Skills, 31 Commands, 14 Workflows, 8 Rules, 341 Tests. Workflow enforcement, task governance, agent reputation, self-healing, and skill marketplace.",
5
5
  "main": "bin/ag-kit.js",
6
6
  "bin": {