antigravity-ai-kit 3.4.1 → 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.
Files changed (23) hide show
  1. package/.agent/CheatSheet.md +5 -3
  2. package/.agent/checklists/pre-commit.md +1 -1
  3. package/.agent/checklists/session-end.md +1 -1
  4. package/.agent/checklists/session-start.md +1 -1
  5. package/.agent/checklists/task-complete.md +78 -0
  6. package/.agent/commands/help.md +13 -9
  7. package/.agent/engine/identity.json +2 -2
  8. package/.agent/engine/sdlc-map.json +7 -1
  9. package/.agent/engine/workflow-state.json +22 -1
  10. package/.agent/hooks/hooks.json +11 -0
  11. package/.agent/manifest.json +371 -75
  12. package/.agent/rules.md +18 -2
  13. package/.agent/session-context.md +69 -80
  14. package/.agent/skills/app-builder/SKILL.md +1 -1
  15. package/.agent/skills/deployment-procedures/SKILL.md +2 -2
  16. package/.agent/skills/i18n-localization/SKILL.md +1 -1
  17. package/.agent/skills/mobile-design/SKILL.md +2 -2
  18. package/.agent/skills/webapp-testing/SKILL.md +1 -1
  19. package/README.md +12 -11
  20. package/bin/ag-kit.js +40 -3
  21. package/lib/updater.js +24 -9
  22. package/lib/workflow-engine.js +1 -1
  23. package/package.json +4 -2
package/.agent/CheatSheet.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Antigravity AI Kit — CheatSheet
2
2
 
3
- > **Version**: v3.1.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
  ---
@@ -138,7 +138,7 @@
138
138
 
139
139
  ---
140
140
 
141
- ## 🧩 Skills (31)
141
+ ## 🧩 Skills (32)
142
142
 
143
143
  ### Operational (5)
144
144
 
@@ -234,7 +234,7 @@
234
234
 
235
235
  ---
236
236
 
237
- ## ⚖️ Governance Rules (6)
237
+ ## ⚖️ Governance Rules (8)
238
238
 
239
239
  | Rule File | Scope |
240
240
  |:----------|:------|
@@ -244,6 +244,8 @@
244
244
  | `git-workflow.md` | Commits, branches, push policy |
245
245
  | `documentation.md` | Doc hierarchy, SSOT, preservation |
246
246
  | `sprint-tracking.md` | ROADMAP.md as SSOT, session protocols |
247
+ | `quality-gate.md` | Pre-task validation and quality standards |
248
+ | `architecture.md` | System design patterns and ADR governance |
247
249
 
248
250
  ---
249
251
 
package/.agent/checklists/pre-commit.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Pre-Commit Checklist
2
2
 
3
- > **Framework**: Antigravity AI Kit v2.0.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
 
package/.agent/checklists/session-end.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Session End Checklist
2
2
 
3
- > **Framework**: Antigravity AI Kit v3.1.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
 
package/.agent/checklists/session-start.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Session Start Checklist
2
2
 
3
- > **Framework**: Antigravity AI Kit v3.1.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
 
package/.agent/checklists/task-complete.md ADDED
@@ -0,0 +1,78 @@
1
+ # Task-Complete Checkpoint
2
+
3
+ > **Framework**: Antigravity AI Kit v3.5.1
4
+ > **Purpose**: Decision gate after task completion — present options before commit/push
5
+ > **Principle**: Human-in-the-loop governance
6
+
7
+ ---
8
+
9
+ ## 🎯 Trigger Condition
10
+
11
+ This checkpoint activates when:
12
+ - Implementation work is complete AND quality gates have passed (VERIFY → CHECKPOINT transition)
13
+ - The agent has made code changes that are ready for commit
14
+
15
+ This checkpoint does NOT activate when:
16
+ - The developer has explicitly enabled "skip checkpoint" mode for the session
17
+ - The change is docs-only or config-only (handled by commit-type scoping)
18
+
19
+ ---
20
+
21
+ ## 📋 Decision Prompt
22
+
23
+ Present these options to the developer:
24
+
25
+ | # | Action | Command | When to Recommend |
26
+ |:--|:-------|:--------|:-----------------|
27
+ | 1 | 🔍 Quality Review | `/review` | ✅ Always (if not already run) |
28
+ | 2 | 🛡️ Retrospective Audit | `/retrospective` | Sprint-end or milestone |
29
+ | 3 | 📋 Update Tracking | Manual | ✅ Always |
30
+ | 4 | 📦 Commit & Push | `git commit + push` | After review passes |
31
+ | 5 | 🔚 Session-End | Protocol | End of work session |
32
+ | 6 | 🚀 Deploy | `/deploy` | Production-impacting changes |
33
+ | 7 | 📝 Continue Working | Skip commit | Batching multiple changes |
34
+ | 8 | ⏭️ Skip Checkpoint | Session flag | Rapid iteration mode |
35
+
36
+ **Prompt format:**
37
+
38
+ ```
39
+ How should we proceed?
40
+
41
+ 1. 🔍 /review — Run quality gates (lint, type-check, test, security, build)
42
+ 2. 🛡️ /retrospective — Tier-1 audit (architecture, market benchmark, ethics)
43
+ 3. 📋 Update tracking — Sync ROADMAP.md, session-context.md, session-state.json
44
+ 4. 📦 Commit & push — Stage, commit (conventional), push to remote
45
+ 5. 🔚 Session-end protocol — Preserve context and prepare for handoff
46
+ 6. 🚀 /deploy — Production deployment with pre-flight checks
47
+ 7. 📝 Continue working — Proceed to next task without committing
48
+ 8. ⏭️ Skip checkpoint — Disable checkpoint for remainder of session
49
+
50
+ > Choose options (e.g., "1, 3, 4" or "1 through 5"):
51
+ ```
52
+
53
+ ---
54
+
55
+ ## 🧠 Recommendation Intelligence
56
+
57
+ Dynamically adjust recommendations based on:
58
+
59
+ - [ ] **Sprint boundary**: If ROADMAP shows sprint ending → recommend `/retrospective`
60
+ - [ ] **Production files**: If `apps/api/**` or `apps/web/**` changed → recommend `/deploy`
61
+ - [ ] **Session duration**: If >2 hours of work → recommend session-end
62
+ - [ ] **File count**: If >5 files changed → recommend atomic commit review
63
+ - [ ] **New code without tests**: Flag with ⚠️ if test coverage gap detected
64
+ - [ ] **Security-sensitive**: If auth/crypto/token files changed → recommend `/review security`
65
+
66
+ ---
67
+
68
+ ## 🔒 Governance
69
+
70
+ **PROHIBITED:**
71
+ - Committing or pushing without presenting this checkpoint
72
+ - Auto-selecting options without developer input
73
+ - Skipping this checkpoint for session-end commits
74
+
75
+ **REQUIRED:**
76
+ - Present decision prompt after every task completion
77
+ - Wait for explicit developer response
78
+ - Log the developer's choice for session audit trail
package/.agent/commands/help.md CHANGED
@@ -13,7 +13,7 @@ Your complete guide to the Antigravity AI Kit. Type `/help` for a quick overview
13
13
  /help commands # All 31 slash commands with descriptions
14
14
  /help workflows # All 14 workflows with descriptions
15
15
  /help agents # All 19 AI agents with domains
16
- /help skills # All 31 skill modules
16
+ /help skills # All 32 skill modules
17
17
  /help rules # Governance rules
18
18
  /help checklists # Quality gate checklists
19
19
  /help cli # Terminal CLI commands (ag-kit)
@@ -24,17 +24,17 @@ 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.0.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
  |:---------|:------|:------------|
31
31
  | ⌨️ Commands | 31 | Slash commands for every development task |
32
32
  | 🔄 Workflows | 14 | Multi-step development lifecycles |
33
33
  | 🤖 Agents | 19 | Specialized AI roles for delegation |
34
- | 🛠️ Skills | 31 | Domain knowledge modules |
35
- | ⚖️ Rules | 4 | Immutable governance constraints |
36
- | ✅ Checklists | 3 | Quality gate checklists |
37
- | ⚙️ Runtime | 21 | Engine modules (governance, reputation, self-healing) |
34
+ | 🛠️ Skills | 32 | Domain knowledge modules |
35
+ | ⚖️ Rules | 8 | Modular governance constraints |
36
+ | ✅ Checklists | 4 | Quality gate checklists |
37
+ | ⚙️ Runtime | 29 | Engine modules (governance, reputation, self-healing) |
38
38
 
39
39
  ### Getting Started
40
40
 
@@ -174,7 +174,7 @@ Agents are specialized AI roles. They are automatically activated based on task
174
174
 
175
175
  ---
176
176
 
177
- ## Skills (31)
177
+ ## Skills (32)
178
178
 
179
179
  Skills are domain knowledge modules that agents use. They are loaded automatically based on task context.
180
180
 
@@ -194,9 +194,9 @@ Skills are domain knowledge modules that agents use. They are loaded automatical
194
194
 
195
195
  ---
196
196
 
197
- ## Rules (4)
197
+ ## Rules (8)
198
198
 
199
- Rules are immutable governance constraints that all agents must follow.
199
+ Rules are modular governance constraints that all agents must follow.
200
200
 
201
201
  | Rule | Purpose |
202
202
  |:-----|:--------|
@@ -204,6 +204,10 @@ Rules are immutable governance constraints that all agents must follow.
204
204
  | `git-workflow` | Conventional commits, atomic changes, branch strategy |
205
205
  | `security` | Secret management, input validation, OWASP |
206
206
  | `testing` | Test-first, coverage targets, test naming |
207
+ | `documentation` | Doc hierarchy, SSOT, preservation |
208
+ | `sprint-tracking` | ROADMAP.md as SSOT, session protocols |
209
+ | `quality-gate` | Pre-task validation and quality standards |
210
+ | `architecture` | System design patterns and ADR governance |
207
211
 
208
212
  ---
209
213
 
package/.agent/engine/identity.json CHANGED
@@ -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"
package/.agent/engine/sdlc-map.json CHANGED
@@ -24,12 +24,18 @@
24
24
  "description": "Testing and quality gate validation",
25
25
  "workflows": ["test", "review"],
26
26
  "previous": "build",
27
+ "next": "checkpoint"
28
+ },
29
+ "checkpoint": {
30
+ "description": "Developer decision gate with intelligence-driven recommendations",
31
+ "workflows": [],
32
+ "previous": "verify",
27
33
  "next": "ship"
28
34
  },
29
35
  "ship": {
30
36
  "description": "Production deployment with pre-flight checks",
31
37
  "workflows": ["deploy"],
32
- "previous": "verify",
38
+ "previous": "checkpoint",
33
39
  "next": "evaluate"
34
40
  },
35
41
  "evaluate": {
package/.agent/engine/workflow-state.json CHANGED
@@ -37,6 +37,15 @@
37
37
  "startedAt": null,
38
38
  "completedAt": null
39
39
  },
40
+ "CHECKPOINT": {
41
+ "status": "pending",
42
+ "description": "Developer decision gate — presents completion options before commit/push",
43
+ "checklist": "checklists/task-complete.md",
44
+ "artifact": null,
45
+ "startedAt": null,
46
+ "completedAt": null,
47
+ "requiresApproval": true
48
+ },
40
49
  "REVIEW": {
41
50
  "status": "pending",
42
51
  "description": "Code review and security audit",
@@ -95,7 +104,7 @@
95
104
  },
96
105
  {
97
106
  "from": "VERIFY",
98
- "to": "REVIEW",
107
+ "to": "CHECKPOINT",
99
108
  "trigger": "Quality gates pass",
100
109
  "guard": "All quality gates pass (build, lint, test)"
101
110
  },
@@ -105,6 +114,18 @@
105
114
  "trigger": "Quality gates fail",
106
115
  "guard": "One or more quality gates failed"
107
116
  },
117
+ {
118
+ "from": "CHECKPOINT",
119
+ "to": "REVIEW",
120
+ "trigger": "Developer chooses review/commit",
121
+ "guard": "Developer selects review or commit option"
122
+ },
123
+ {
124
+ "from": "CHECKPOINT",
125
+ "to": "IMPLEMENT",
126
+ "trigger": "Developer chooses continue working",
127
+ "guard": "Developer selects continue or batch option"
128
+ },
108
129
  {
109
130
  "from": "REVIEW",
110
131
  "to": "DEPLOY",
package/.agent/hooks/hooks.json CHANGED
@@ -88,6 +88,17 @@
88
88
  { "action": "Append retrospective findings to contexts/plan-quality-log.md", "severity": "low", "onFailure": "log" },
89
89
  { "action": "Extract learnings for continuous-learning skill (PAAL cycle)", "severity": "low", "onFailure": "log" }
90
90
  ]
91
+ },
92
+ {
93
+ "event": "task-complete",
94
+ "description": "Triggered after quality gates pass. Presents developer with structured decision options before commit/push.",
95
+ "enforcement": "runtime",
96
+ "actions": [
97
+ { "action": "Present task completion decision prompt to developer", "severity": "critical", "onFailure": "block" },
98
+ { "action": "Evaluate change scope for recommendations (sprint boundary, production impact, session duration)", "severity": "high", "onFailure": "warn" },
99
+ { "action": "Check if tracking files (ROADMAP, session-context, session-state) need updating", "severity": "medium", "onFailure": "warn" },
100
+ { "action": "Suggest session-end protocol if session has accumulated significant changes", "severity": "low", "onFailure": "log" }
101
+ ]
91
102
  }
92
103
  ]
93
104
  }
package/.agent/manifest.json CHANGED
@@ -1,32 +1,108 @@
1
1
  {
2
2
  "schemaVersion": "1.0.0",
3
- "kitVersion": "3.4.1",
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,70 +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
+ }
341
+ ]
342
+ },
343
+ "checklists": {
344
+ "count": 4,
345
+ "items": [
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
+ }
362
+ ]
363
+ },
364
+ "hooks": {
365
+ "count": 8,
366
+ "items": [
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
+ }
103
399
  ]
104
400
  }
105
401
  }
package/.agent/rules.md CHANGED
@@ -218,7 +218,23 @@ After generating code, you MUST enter **Self-Correction Mode**.
218
218
  □ Only then may I declare "complete" or "done"
219
219
  ```
220
220
 
221
- ### F. Continuous Learning Protocol
221
+ ### F. Task-Complete Checkpoint Protocol
222
+
223
+ **After completing a task and before committing or pushing code, present the developer with structured decision options.**
224
+
225
+ This protocol is defined in `.agent/checklists/task-complete.md` and enforced by the `task-complete` hook event.
226
+
227
+ **PROHIBITED:**
228
+ - ❌ Committing or pushing without presenting the checkpoint prompt
229
+ - ❌ Auto-selecting options without explicit developer input
230
+ - ❌ Skipping this checkpoint for session-end commits
231
+
232
+ **REQUIRED:**
233
+ - ✅ Present the 8-option decision prompt after every task completion
234
+ - ✅ Wait for explicit developer response before proceeding
235
+ - ✅ Evaluate change scope for intelligent recommendation annotation
236
+
237
+ ### G. Continuous Learning Protocol
222
238
 
223
239
  **User corrections become permanent operational rules.**
224
240
 
@@ -226,7 +242,7 @@ After generating code, you MUST enter **Self-Correction Mode**.
226
242
  2. **Internalize**: Add to operational memory for this session
227
243
  3. **Apply**: Use immediately and in all future similar situations
228
244
 
229
- ### G. Error Recovery Protocol
245
+ ### H. Error Recovery Protocol
230
246
 
231
247
  **When errors occur, recover gracefully without excuses.**
232
248
 
package/.agent/session-context.md CHANGED
@@ -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 v2.0.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)_
package/.agent/skills/app-builder/SKILL.md CHANGED
@@ -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
  | ---------------- | ----------------------------- | ----------- |
package/.agent/skills/deployment-procedures/SKILL.md CHANGED
@@ -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)
package/.agent/skills/i18n-localization/SKILL.md CHANGED
@@ -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)
package/.agent/skills/mobile-design/SKILL.md CHANGED
@@ -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
  | ---------- | -------------------------------- |
package/.agent/skills/webapp-testing/SKILL.md CHANGED
@@ -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,21 +1,21 @@
1
1
  # 🚀 Antigravity AI Kit
2
2
 
3
- ![version](https://img.shields.io/badge/version-3.3.1-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)
7
7
  ![Commands](https://img.shields.io/badge/Commands-31-red)
8
8
  ![Workflows](https://img.shields.io/badge/Workflows-14-teal)
9
9
  ![Runtime Modules](https://img.shields.io/badge/Runtime%20Modules-29-blueviolet)
10
- ![Tests](https://img.shields.io/badge/Tests-327%20passing-brightgreen)
11
- ![Checklists](https://img.shields.io/badge/Checklists-3-yellow)
10
+ ![Tests](https://img.shields.io/badge/Tests-341%20passing-brightgreen)
11
+ ![Checklists](https://img.shields.io/badge/Checklists-4-yellow)
12
12
 
13
13
  <p align="center">
14
14
  <b>🎯 Transform Your IDE into an AI Engineering Team</b>
15
15
  </p>
16
16
 
17
17
  <p align="center">
18
- Antigravity AI Kit is a <b>Trust-Grade AI development framework</b> with a <b>29-module runtime engine</b>, <b>19 specialized agents</b>, <b>31 commands</b>, <b>32 skills</b>, and <b>14 workflows</b> — all backed by <b>327 tests</b> and governance-first principles.
18
+ Antigravity AI Kit is a <b>Trust-Grade AI development framework</b> with a <b>29-module runtime engine</b>, <b>19 specialized agents</b>, <b>31 commands</b>, <b>32 skills</b>, and <b>14 workflows</b> — all backed by <b>341 tests</b> and governance-first principles.
19
19
  </p>
20
20
 
21
21
  <p align="center">
@@ -60,9 +60,9 @@
60
60
  | ⌨️ **Commands** | 31 | Slash commands for every development workflow |
61
61
  | 🔄 **Workflows** | 14 | Process templates (/create, /debug, /deploy, /test...) |
62
62
  | ⚙️ **Runtime** | 29 | Runtime engine modules (governance, reputation, self-healing...) |
63
- | ✅ **Checklists** | 3 | Quality gates (session-start, session-end, pre-commit) |
63
+ | ✅ **Checklists** | 4 | Quality gates (session-start, session-end, pre-commit, task-complete) |
64
64
  | ⚖️ **Rules** | 8 | Modular governance constraints (coding, security, testing, git, docs, sprint) |
65
- | 🔗 **Hooks** | 7 | Event-driven automation (runtime + git-hook enforcement) |
65
+ | 🔗 **Hooks** | 8 | Event-driven automation (runtime + git-hook enforcement) |
66
66
  | 🧪 **Tests** | 327 | Unit, structural, integration, and security tests (32 test files) |
67
67
 
68
68
  ---
@@ -188,10 +188,10 @@ Antigravity AI Kit is designed to **never touch your project files**. All operat
188
188
 
189
189
  ### How It Works: The Autonomy Engine
190
190
 
191
- Antigravity AI Kit uses a **6-phase workflow state machine** that guides development:
191
+ Antigravity AI Kit uses a **7-phase workflow state machine** that guides development:
192
192
 
193
193
  ```
194
- EXPLORE → PLAN → IMPLEMENT → VERIFY → REVIEW → DEPLOY
194
+ EXPLORE → PLAN → IMPLEMENT → VERIFY → CHECKPOINT → REVIEW → DEPLOY
195
195
  ```
196
196
 
197
197
  | Phase | What Happens | Transition Guard |
@@ -200,6 +200,7 @@ EXPLORE → PLAN → IMPLEMENT → VERIFY → REVIEW → DEPLOY
200
200
  | **PLAN** | Implementation plan with user approval | Plan approved by user |
201
201
  | **IMPLEMENT** | Code generation with agent routing | Auto on commit |
202
202
  | **VERIFY** | Quality gates, tests, lint | All gates pass |
203
+ | **CHECKPOINT** | Developer decision gate | Explicit developer choice |
203
204
  | **REVIEW** | Code review (human or Copilot) | Review approved |
204
205
  | **DEPLOY** | Production deployment | Deployment checklist complete |
205
206
 
@@ -635,9 +636,9 @@ antigravity-ai-kit/
635
636
  │ ├── skills/ # 32 capability modules
636
637
  │ ├── workflows/ # 14 process templates
637
638
  │ ├── engine/ # Autonomy Engine (state machine, loading rules, configs)
638
- │ ├── hooks/ # 7 event hooks (runtime + git-hook)
639
+ │ ├── hooks/ # 8 event hooks (runtime + git-hook)
639
640
  │ ├── rules/ # 8 modular governance rules
640
- │ ├── checklists/ # Verification checklists (3)
641
+ │ ├── checklists/ # Verification checklists (4)
641
642
  │ ├── templates/ # ADR, feature-request, bug-report templates
642
643
  │ ├── decisions/ # Architecture Decision Records
643
644
  │ └── manifest.json # Machine-readable capability registry
@@ -728,7 +729,7 @@ Want to use Antigravity AI Kit in your project? The **[Contributor Guide](https:
728
729
  - Context-driven development from [Google Conductor](https://developers.googleblog.com/en/conductor-introducing-context-driven-development-for-gemini-cli/)
729
730
  - Hook concepts from [everything-claude-code](https://github.com/affaan-m/everything-claude-code)
730
731
 
731
- _Antigravity AI Kit v3.2.0 extends these foundations with a 29-module runtime engine, Trust-Grade governance, session management, and 100+ capabilities._
732
+ _Antigravity AI Kit v3.5.0 extends these foundations with a 29-module runtime engine, Trust-Grade governance, session management, and 100+ capabilities._
732
733
 
733
734
  ---
734
735
 
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/lib/workflow-engine.js CHANGED
@@ -19,7 +19,7 @@ const { writeJsonAtomic } = require('./io');
19
19
  const { createLogger } = require('./logger');
20
20
  const log = createLogger('workflow-engine');
21
21
 
22
- /** @typedef {'IDLE' | 'EXPLORE' | 'PLAN' | 'IMPLEMENT' | 'VERIFY' | 'REVIEW' | 'DEPLOY' | 'MAINTAIN'} WorkflowPhase */
22
+ /** @typedef {'IDLE' | 'EXPLORE' | 'PLAN' | 'IMPLEMENT' | 'VERIFY' | 'CHECKPOINT' | 'REVIEW' | 'DEPLOY' | 'MAINTAIN'} WorkflowPhase */
23
23
 
24
24
  /**
25
25
  * @typedef {object} TransitionResult
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "antigravity-ai-kit",
3
- "version": "3.4.1",
4
- "description": "🚀 Trust-Grade AI development framework with a 29-module runtime engine — 19 Agents, 32 Skills, 31 Commands, 14 Workflows, 8 Rules, 330 Tests. Workflow enforcement, task governance, agent reputation, self-healing, and skill marketplace.",
3
+ "version": "3.5.1",
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": {
7
7
  "ag-kit": "./bin/ag-kit.js"
@@ -9,6 +9,8 @@
9
9
  "scripts": {
10
10
  "test": "vitest run",
11
11
  "test:watch": "vitest watch",
12
+ "preversion": "npm test",
13
+ "version": "node scripts/sync-version.js && git add -A",
12
14
  "postinstall": "echo '✅ Antigravity AI Kit installed! Run: ag-kit init'"
13
15
  },
14
16
  "keywords": [