UNPKG

aios-core

Version:

Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework

github.com/SynkraAI/aios-core

SynkraAI/aios-core

115 lines (86 loc) • 3.33 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
# Brownfield Compatibility Checklist > Story AIOS-DIFF-4.3.2: Checklist formal de compatibilidade retroativa ## Pre-Migration Compatibility Check ### 1. Source Control Status - [ ] All changes committed to version control - [ ] Working branch created from main/master - [ ] Remote backup verified (push before migration) ### 2. Existing Configuration Preservation - [ ] `.env` files backed up (never overwritten by AIOS) - [ ] `package.json` scripts preserved - [ ] Existing linting config (.eslintrc, .prettierrc) detected - [ ] CI/CD workflows (.github/workflows) inventoried ### 3. Dependency Compatibility - [ ] Node.js version compatible (>=18) - [ ] No conflicting global dependencies - [ ] Lock file (package-lock.json/yarn.lock) preserved ### 4. Directory Structure Analysis - [ ] `docs/` directory status checked (empty/existing) - [ ] `.aios-core/` not present (fresh install) - [ ] No naming conflicts with AIOS directories ## During Migration Checks ### 5. Non-Destructive Operations - [ ] AIOS creates new files, never overwrites existing - [ ] Merge conflicts surfaced for user decision - [ ] Original files preserved with `.backup` if conflict ### 6. Configuration Merge Strategy - [ ] Existing `.gitignore` entries preserved + AIOS entries added - [ ] TypeScript config extended (not replaced) if existing - [ ] ESLint rules merged (not overwritten) ### 7. Rollback Points - [ ] Pre-migration commit hash recorded - [ ] AIOS files clearly identified (can be removed cleanly) - [ ] No modifications to existing source code during install ## Post-Migration Validation ### 8. Existing Functionality - [ ] `npm test` passes (if tests existed before) - [ ] `npm run build` succeeds (if build existed) - [ ] Application starts normally ### 9. AIOS Integration - [ ] `npx aios-core doctor` reports healthy - [ ] Agent activation works (@dev, @architect, etc.) - [ ] Existing docs not duplicated ### 10. Rollback Verification - [ ] `git diff HEAD~1` shows only AIOS additions - [ ] `git checkout HEAD~1 -- .` would restore pre-AIOS state - [ ] No orphaned AIOS processes or files --- ## Compatibility Matrix | Existing Config | AIOS Behavior | User Action Required | |-----------------|---------------|---------------------| | `.eslintrc.*` | Detect + preserve | None | | `.prettierrc.*` | Detect + preserve | None | | `tsconfig.json` | Extend (not replace) | Review extends | | `jest.config.*` | Detect + preserve | None | | `docs/*.md` | Skip (don't overwrite) | Manual merge if needed | | `.github/workflows/*` | Inventory only | User decides integration | | `package.json` scripts | Preserve all | None | ## Rollback Procedure If migration fails or is unwanted: ```bash # Option 1: Full rollback to pre-migration state git checkout HEAD~1 -- . # Option 2: Remove only AIOS files rm -rf .aios-core/ rm -rf docs/architecture/ docs/prd/ docs/stories/ # Review and revert .gitignore AIOS entries # Option 3: Soft rollback (keep docs, remove runtime) rm -rf .aios-core/ ``` --- ## Checklist Usage **Pre-Migration:** ```bash # Run compatibility check npx aios-core doctor --pre-migration ``` **Post-Migration:** ```bash # Validate migration npx aios-core doctor npm test # if tests exist npm run build # if build exists ``` --- *AIOS Brownfield Compatibility Checklist v1.0* *Story AIOS-DIFF-4.3.2*