aios-core 2.1.4 → 2.1.6
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/.aios-core/development/tasks/analyze-brownfield.md +456 -456
- package/.aios-core/development/tasks/setup-project-docs.md +440 -444
- package/.aios-core/infrastructure/scripts/documentation-integrity/brownfield-analyzer.js +501 -501
- package/.aios-core/infrastructure/scripts/documentation-integrity/config-generator.js +368 -329
- package/.aios-core/infrastructure/scripts/documentation-integrity/deployment-config-loader.js +308 -282
- package/.aios-core/infrastructure/scripts/documentation-integrity/doc-generator.js +331 -331
- package/.aios-core/infrastructure/scripts/documentation-integrity/gitignore-generator.js +312 -312
- package/.aios-core/infrastructure/scripts/documentation-integrity/index.js +74 -74
- package/.aios-core/infrastructure/scripts/documentation-integrity/mode-detector.js +389 -358
- package/.aios-core/infrastructure/scripts/llm-routing/install-llm-routing.js +6 -6
- package/.aios-core/infrastructure/templates/core-config/core-config-brownfield.tmpl.yaml +176 -182
- package/.aios-core/infrastructure/templates/core-config/core-config-greenfield.tmpl.yaml +127 -127
- package/.aios-core/infrastructure/templates/project-docs/coding-standards-tmpl.md +346 -346
- package/.aios-core/infrastructure/templates/project-docs/source-tree-tmpl.md +177 -177
- package/.aios-core/infrastructure/templates/project-docs/tech-stack-tmpl.md +267 -267
- package/package.json +1 -1
- package/packages/installer/src/config/templates/env-template.js +2 -2
- package/packages/installer/src/wizard/wizard.js +1 -1
- package/packages/installer/tests/integration/environment-configuration.test.js +2 -1
- package/packages/installer/tests/unit/env-template.test.js +3 -2
- package/src/wizard/index.js +2 -2
- package/.aios-core/development/tasks/validate-structure.md +0 -243
- package/.aios-core/infrastructure/scripts/source-tree-guardian/index.js +0 -375
- package/.aios-core/infrastructure/scripts/source-tree-guardian/manifest-generator.js +0 -410
- package/.aios-core/infrastructure/scripts/source-tree-guardian/rules/naming-rules.yaml +0 -285
- package/.aios-core/infrastructure/scripts/source-tree-guardian/rules/placement-rules.yaml +0 -262
- package/.aios-core/infrastructure/scripts/source-tree-guardian/validator.js +0 -468
|
@@ -1,267 +1,267 @@
|
|
|
1
|
-
# {{PROJECT_NAME}} Tech Stack
|
|
2
|
-
|
|
3
|
-
> **Auto-generated by AIOS** on {{GENERATED_DATE}}
|
|
4
|
-
> **Mode:** {{INSTALLATION_MODE}}
|
|
5
|
-
|
|
6
|
-
## Overview
|
|
7
|
-
|
|
8
|
-
This document describes the technology stack and tooling decisions for **{{PROJECT_NAME}}**.
|
|
9
|
-
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## Core Technologies
|
|
13
|
-
|
|
14
|
-
### Runtime & Language
|
|
15
|
-
|
|
16
|
-
| Technology | Version | Purpose |
|
|
17
|
-
|------------|---------|---------|
|
|
18
|
-
{{#if IS_NODE}}
|
|
19
|
-
| Node.js | {{NODE_VERSION}} | JavaScript runtime |
|
|
20
|
-
{{#if IS_TYPESCRIPT}}
|
|
21
|
-
| TypeScript | {{TYPESCRIPT_VERSION}} | Type-safe JavaScript |
|
|
22
|
-
{{/if}}
|
|
23
|
-
{{/if}}
|
|
24
|
-
{{#if IS_PYTHON}}
|
|
25
|
-
| Python | {{PYTHON_VERSION}} | Programming language |
|
|
26
|
-
{{/if}}
|
|
27
|
-
{{#if IS_GO}}
|
|
28
|
-
| Go | {{GO_VERSION}} | Programming language |
|
|
29
|
-
{{/if}}
|
|
30
|
-
{{#if IS_RUST}}
|
|
31
|
-
| Rust | {{RUST_VERSION}} | Programming language |
|
|
32
|
-
{{/if}}
|
|
33
|
-
|
|
34
|
-
### Package Management
|
|
35
|
-
|
|
36
|
-
| Tool | Version | Purpose |
|
|
37
|
-
|------|---------|---------|
|
|
38
|
-
{{#if IS_NODE}}
|
|
39
|
-
| npm | {{NPM_VERSION}} | Package manager |
|
|
40
|
-
{{/if}}
|
|
41
|
-
{{#if IS_PYTHON}}
|
|
42
|
-
| pip | Latest | Package installer |
|
|
43
|
-
| poetry | {{POETRY_VERSION}} | Dependency management (optional) |
|
|
44
|
-
{{/if}}
|
|
45
|
-
{{#if IS_GO}}
|
|
46
|
-
| Go Modules | Built-in | Dependency management |
|
|
47
|
-
{{/if}}
|
|
48
|
-
|
|
49
|
-
---
|
|
50
|
-
|
|
51
|
-
## Development Tools
|
|
52
|
-
|
|
53
|
-
### Code Quality
|
|
54
|
-
|
|
55
|
-
| Tool | Purpose | Configuration |
|
|
56
|
-
|------|---------|---------------|
|
|
57
|
-
{{#if IS_NODE}}
|
|
58
|
-
| ESLint | Linting | `.eslintrc.js` |
|
|
59
|
-
| Prettier | Formatting | `.prettierrc` |
|
|
60
|
-
{{#if IS_TYPESCRIPT}}
|
|
61
|
-
| TypeScript | Type checking | `tsconfig.json` |
|
|
62
|
-
{{/if}}
|
|
63
|
-
{{/if}}
|
|
64
|
-
{{#if IS_PYTHON}}
|
|
65
|
-
| Black | Formatting | `pyproject.toml` |
|
|
66
|
-
| Flake8 | Linting | `.flake8` |
|
|
67
|
-
| mypy | Type checking | `mypy.ini` |
|
|
68
|
-
{{/if}}
|
|
69
|
-
{{#if IS_GO}}
|
|
70
|
-
| gofmt | Formatting | Built-in |
|
|
71
|
-
| golint | Linting | N/A |
|
|
72
|
-
| go vet | Static analysis | Built-in |
|
|
73
|
-
{{/if}}
|
|
74
|
-
|
|
75
|
-
### Testing
|
|
76
|
-
|
|
77
|
-
| Tool | Purpose | Location |
|
|
78
|
-
|------|---------|----------|
|
|
79
|
-
{{#if IS_NODE}}
|
|
80
|
-
| Jest | Unit testing | `tests/unit/` |
|
|
81
|
-
| Supertest | API testing | `tests/integration/` |
|
|
82
|
-
{{/if}}
|
|
83
|
-
{{#if IS_PYTHON}}
|
|
84
|
-
| pytest | Testing framework | `tests/` |
|
|
85
|
-
| pytest-cov | Coverage | `pytest.ini` |
|
|
86
|
-
{{/if}}
|
|
87
|
-
{{#if IS_GO}}
|
|
88
|
-
| go test | Testing framework | `*_test.go` files |
|
|
89
|
-
{{/if}}
|
|
90
|
-
|
|
91
|
-
### Build Tools
|
|
92
|
-
|
|
93
|
-
| Tool | Purpose |
|
|
94
|
-
|------|---------|
|
|
95
|
-
{{#if IS_NODE}}
|
|
96
|
-
{{#if IS_TYPESCRIPT}}
|
|
97
|
-
| tsc | TypeScript compilation |
|
|
98
|
-
{{/if}}
|
|
99
|
-
| esbuild / rollup | Bundling (if needed) |
|
|
100
|
-
{{/if}}
|
|
101
|
-
{{#if IS_PYTHON}}
|
|
102
|
-
| setuptools | Package building |
|
|
103
|
-
| wheel | Distribution format |
|
|
104
|
-
{{/if}}
|
|
105
|
-
{{#if IS_GO}}
|
|
106
|
-
| go build | Compilation |
|
|
107
|
-
{{/if}}
|
|
108
|
-
|
|
109
|
-
---
|
|
110
|
-
|
|
111
|
-
## Infrastructure
|
|
112
|
-
|
|
113
|
-
### Version Control
|
|
114
|
-
|
|
115
|
-
| Service | Purpose |
|
|
116
|
-
|---------|---------|
|
|
117
|
-
| Git | Version control |
|
|
118
|
-
| GitHub | Repository hosting |
|
|
119
|
-
| GitHub Actions | CI/CD |
|
|
120
|
-
|
|
121
|
-
### Deployment
|
|
122
|
-
|
|
123
|
-
| Platform | Environment | Branch |
|
|
124
|
-
|----------|-------------|--------|
|
|
125
|
-
{{#if DEPLOYMENT_PLATFORM}}
|
|
126
|
-
| {{DEPLOYMENT_PLATFORM}} | Production | `{{PRODUCTION_BRANCH}}` |
|
|
127
|
-
{{#if HAS_STAGING}}
|
|
128
|
-
| {{DEPLOYMENT_PLATFORM}} | Staging | `{{STAGING_BRANCH}}` |
|
|
129
|
-
{{/if}}
|
|
130
|
-
{{else}}
|
|
131
|
-
| TBD | Production | `main` |
|
|
132
|
-
{{/if}}
|
|
133
|
-
|
|
134
|
-
### Database (if applicable)
|
|
135
|
-
|
|
136
|
-
| Technology | Purpose | Environment |
|
|
137
|
-
|------------|---------|-------------|
|
|
138
|
-
{{#if DATABASE}}
|
|
139
|
-
| {{DATABASE}} | Primary database | All |
|
|
140
|
-
{{/if}}
|
|
141
|
-
{{#if CACHE}}
|
|
142
|
-
| {{CACHE}} | Caching layer | All |
|
|
143
|
-
{{/if}}
|
|
144
|
-
|
|
145
|
-
---
|
|
146
|
-
|
|
147
|
-
## Dependencies
|
|
148
|
-
|
|
149
|
-
### Production Dependencies
|
|
150
|
-
|
|
151
|
-
{{#if IS_NODE}}
|
|
152
|
-
Key dependencies from `package.json`:
|
|
153
|
-
|
|
154
|
-
| Package | Version | Purpose |
|
|
155
|
-
|---------|---------|---------|
|
|
156
|
-
{{#each DEPENDENCIES}}
|
|
157
|
-
| {{this.name}} | {{this.version}} | {{this.purpose}} |
|
|
158
|
-
{{/each}}
|
|
159
|
-
{{/if}}
|
|
160
|
-
|
|
161
|
-
{{#if IS_PYTHON}}
|
|
162
|
-
Key dependencies from `requirements.txt`:
|
|
163
|
-
|
|
164
|
-
| Package | Version | Purpose |
|
|
165
|
-
|---------|---------|---------|
|
|
166
|
-
{{#each DEPENDENCIES}}
|
|
167
|
-
| {{this.name}} | {{this.version}} | {{this.purpose}} |
|
|
168
|
-
{{/each}}
|
|
169
|
-
{{/if}}
|
|
170
|
-
|
|
171
|
-
### Development Dependencies
|
|
172
|
-
|
|
173
|
-
| Package | Purpose |
|
|
174
|
-
|---------|---------|
|
|
175
|
-
{{#each DEV_DEPENDENCIES}}
|
|
176
|
-
| {{this.name}} | {{this.purpose}} |
|
|
177
|
-
{{/each}}
|
|
178
|
-
|
|
179
|
-
---
|
|
180
|
-
|
|
181
|
-
## Configuration Files
|
|
182
|
-
|
|
183
|
-
| File | Purpose |
|
|
184
|
-
|------|---------|
|
|
185
|
-
| `.aios-core/core-config.yaml` | AIOS configuration |
|
|
186
|
-
| `.env.example` | Environment template |
|
|
187
|
-
| `.gitignore` | Git ignore rules |
|
|
188
|
-
{{#if IS_NODE}}
|
|
189
|
-
| `package.json` | Node.js project config |
|
|
190
|
-
{{#if IS_TYPESCRIPT}}
|
|
191
|
-
| `tsconfig.json` | TypeScript config |
|
|
192
|
-
{{/if}}
|
|
193
|
-
| `.eslintrc.js` | ESLint rules |
|
|
194
|
-
| `.prettierrc` | Prettier config |
|
|
195
|
-
{{/if}}
|
|
196
|
-
{{#if IS_PYTHON}}
|
|
197
|
-
| `pyproject.toml` | Python project config |
|
|
198
|
-
| `requirements.txt` | Dependencies |
|
|
199
|
-
| `.flake8` | Flake8 config |
|
|
200
|
-
{{/if}}
|
|
201
|
-
{{#if IS_GO}}
|
|
202
|
-
| `go.mod` | Go modules |
|
|
203
|
-
| `go.sum` | Dependency checksums |
|
|
204
|
-
{{/if}}
|
|
205
|
-
|
|
206
|
-
---
|
|
207
|
-
|
|
208
|
-
## Environment Variables
|
|
209
|
-
|
|
210
|
-
| Variable | Description | Required |
|
|
211
|
-
|----------|-------------|----------|
|
|
212
|
-
| `NODE_ENV` / `ENV` | Environment name | Yes |
|
|
213
|
-
{{#each ENV_VARS}}
|
|
214
|
-
| `{{this.name}}` | {{this.description}} | {{this.required}} |
|
|
215
|
-
{{/each}}
|
|
216
|
-
|
|
217
|
-
See `.env.example` for a complete list.
|
|
218
|
-
|
|
219
|
-
---
|
|
220
|
-
|
|
221
|
-
## Upgrade Guidelines
|
|
222
|
-
|
|
223
|
-
### Language/Runtime Updates
|
|
224
|
-
|
|
225
|
-
1. Check release notes for breaking changes
|
|
226
|
-
2. Update version in configuration files
|
|
227
|
-
3. Run full test suite
|
|
228
|
-
4. Update CI/CD configuration
|
|
229
|
-
5. Document changes in CHANGELOG
|
|
230
|
-
|
|
231
|
-
### Dependency Updates
|
|
232
|
-
|
|
233
|
-
1. Review changelogs for security fixes
|
|
234
|
-
2. Update one dependency at a time
|
|
235
|
-
3. Run tests after each update
|
|
236
|
-
4. Commit with clear message
|
|
237
|
-
|
|
238
|
-
```bash
|
|
239
|
-
{{#if IS_NODE}}
|
|
240
|
-
# Check for updates
|
|
241
|
-
npm outdated
|
|
242
|
-
|
|
243
|
-
# Update specific package
|
|
244
|
-
npm update <package-name>
|
|
245
|
-
{{/if}}
|
|
246
|
-
{{#if IS_PYTHON}}
|
|
247
|
-
# Check for updates
|
|
248
|
-
pip list --outdated
|
|
249
|
-
|
|
250
|
-
# Update specific package
|
|
251
|
-
pip install --upgrade <package-name>
|
|
252
|
-
{{/if}}
|
|
253
|
-
```
|
|
254
|
-
|
|
255
|
-
---
|
|
256
|
-
|
|
257
|
-
## Security Considerations
|
|
258
|
-
|
|
259
|
-
- [ ] Dependencies scanned for vulnerabilities
|
|
260
|
-
- [ ] Environment variables not committed
|
|
261
|
-
- [ ] Secrets stored securely
|
|
262
|
-
- [ ] HTTPS enforced in production
|
|
263
|
-
|
|
264
|
-
---
|
|
265
|
-
|
|
266
|
-
*Generated by AIOS Documentation Integrity System*
|
|
267
|
-
*Template Version: 1.0.0*
|
|
1
|
+
# {{PROJECT_NAME}} Tech Stack
|
|
2
|
+
|
|
3
|
+
> **Auto-generated by AIOS** on {{GENERATED_DATE}}
|
|
4
|
+
> **Mode:** {{INSTALLATION_MODE}}
|
|
5
|
+
|
|
6
|
+
## Overview
|
|
7
|
+
|
|
8
|
+
This document describes the technology stack and tooling decisions for **{{PROJECT_NAME}}**.
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## Core Technologies
|
|
13
|
+
|
|
14
|
+
### Runtime & Language
|
|
15
|
+
|
|
16
|
+
| Technology | Version | Purpose |
|
|
17
|
+
|------------|---------|---------|
|
|
18
|
+
{{#if IS_NODE}}
|
|
19
|
+
| Node.js | {{NODE_VERSION}} | JavaScript runtime |
|
|
20
|
+
{{#if IS_TYPESCRIPT}}
|
|
21
|
+
| TypeScript | {{TYPESCRIPT_VERSION}} | Type-safe JavaScript |
|
|
22
|
+
{{/if}}
|
|
23
|
+
{{/if}}
|
|
24
|
+
{{#if IS_PYTHON}}
|
|
25
|
+
| Python | {{PYTHON_VERSION}} | Programming language |
|
|
26
|
+
{{/if}}
|
|
27
|
+
{{#if IS_GO}}
|
|
28
|
+
| Go | {{GO_VERSION}} | Programming language |
|
|
29
|
+
{{/if}}
|
|
30
|
+
{{#if IS_RUST}}
|
|
31
|
+
| Rust | {{RUST_VERSION}} | Programming language |
|
|
32
|
+
{{/if}}
|
|
33
|
+
|
|
34
|
+
### Package Management
|
|
35
|
+
|
|
36
|
+
| Tool | Version | Purpose |
|
|
37
|
+
|------|---------|---------|
|
|
38
|
+
{{#if IS_NODE}}
|
|
39
|
+
| npm | {{NPM_VERSION}} | Package manager |
|
|
40
|
+
{{/if}}
|
|
41
|
+
{{#if IS_PYTHON}}
|
|
42
|
+
| pip | Latest | Package installer |
|
|
43
|
+
| poetry | {{POETRY_VERSION}} | Dependency management (optional) |
|
|
44
|
+
{{/if}}
|
|
45
|
+
{{#if IS_GO}}
|
|
46
|
+
| Go Modules | Built-in | Dependency management |
|
|
47
|
+
{{/if}}
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## Development Tools
|
|
52
|
+
|
|
53
|
+
### Code Quality
|
|
54
|
+
|
|
55
|
+
| Tool | Purpose | Configuration |
|
|
56
|
+
|------|---------|---------------|
|
|
57
|
+
{{#if IS_NODE}}
|
|
58
|
+
| ESLint | Linting | `.eslintrc.js` |
|
|
59
|
+
| Prettier | Formatting | `.prettierrc` |
|
|
60
|
+
{{#if IS_TYPESCRIPT}}
|
|
61
|
+
| TypeScript | Type checking | `tsconfig.json` |
|
|
62
|
+
{{/if}}
|
|
63
|
+
{{/if}}
|
|
64
|
+
{{#if IS_PYTHON}}
|
|
65
|
+
| Black | Formatting | `pyproject.toml` |
|
|
66
|
+
| Flake8 | Linting | `.flake8` |
|
|
67
|
+
| mypy | Type checking | `mypy.ini` |
|
|
68
|
+
{{/if}}
|
|
69
|
+
{{#if IS_GO}}
|
|
70
|
+
| gofmt | Formatting | Built-in |
|
|
71
|
+
| golint | Linting | N/A |
|
|
72
|
+
| go vet | Static analysis | Built-in |
|
|
73
|
+
{{/if}}
|
|
74
|
+
|
|
75
|
+
### Testing
|
|
76
|
+
|
|
77
|
+
| Tool | Purpose | Location |
|
|
78
|
+
|------|---------|----------|
|
|
79
|
+
{{#if IS_NODE}}
|
|
80
|
+
| Jest | Unit testing | `tests/unit/` |
|
|
81
|
+
| Supertest | API testing | `tests/integration/` |
|
|
82
|
+
{{/if}}
|
|
83
|
+
{{#if IS_PYTHON}}
|
|
84
|
+
| pytest | Testing framework | `tests/` |
|
|
85
|
+
| pytest-cov | Coverage | `pytest.ini` |
|
|
86
|
+
{{/if}}
|
|
87
|
+
{{#if IS_GO}}
|
|
88
|
+
| go test | Testing framework | `*_test.go` files |
|
|
89
|
+
{{/if}}
|
|
90
|
+
|
|
91
|
+
### Build Tools
|
|
92
|
+
|
|
93
|
+
| Tool | Purpose |
|
|
94
|
+
|------|---------|
|
|
95
|
+
{{#if IS_NODE}}
|
|
96
|
+
{{#if IS_TYPESCRIPT}}
|
|
97
|
+
| tsc | TypeScript compilation |
|
|
98
|
+
{{/if}}
|
|
99
|
+
| esbuild / rollup | Bundling (if needed) |
|
|
100
|
+
{{/if}}
|
|
101
|
+
{{#if IS_PYTHON}}
|
|
102
|
+
| setuptools | Package building |
|
|
103
|
+
| wheel | Distribution format |
|
|
104
|
+
{{/if}}
|
|
105
|
+
{{#if IS_GO}}
|
|
106
|
+
| go build | Compilation |
|
|
107
|
+
{{/if}}
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
## Infrastructure
|
|
112
|
+
|
|
113
|
+
### Version Control
|
|
114
|
+
|
|
115
|
+
| Service | Purpose |
|
|
116
|
+
|---------|---------|
|
|
117
|
+
| Git | Version control |
|
|
118
|
+
| GitHub | Repository hosting |
|
|
119
|
+
| GitHub Actions | CI/CD |
|
|
120
|
+
|
|
121
|
+
### Deployment
|
|
122
|
+
|
|
123
|
+
| Platform | Environment | Branch |
|
|
124
|
+
|----------|-------------|--------|
|
|
125
|
+
{{#if DEPLOYMENT_PLATFORM}}
|
|
126
|
+
| {{DEPLOYMENT_PLATFORM}} | Production | `{{PRODUCTION_BRANCH}}` |
|
|
127
|
+
{{#if HAS_STAGING}}
|
|
128
|
+
| {{DEPLOYMENT_PLATFORM}} | Staging | `{{STAGING_BRANCH}}` |
|
|
129
|
+
{{/if}}
|
|
130
|
+
{{else}}
|
|
131
|
+
| TBD | Production | `main` |
|
|
132
|
+
{{/if}}
|
|
133
|
+
|
|
134
|
+
### Database (if applicable)
|
|
135
|
+
|
|
136
|
+
| Technology | Purpose | Environment |
|
|
137
|
+
|------------|---------|-------------|
|
|
138
|
+
{{#if DATABASE}}
|
|
139
|
+
| {{DATABASE}} | Primary database | All |
|
|
140
|
+
{{/if}}
|
|
141
|
+
{{#if CACHE}}
|
|
142
|
+
| {{CACHE}} | Caching layer | All |
|
|
143
|
+
{{/if}}
|
|
144
|
+
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
## Dependencies
|
|
148
|
+
|
|
149
|
+
### Production Dependencies
|
|
150
|
+
|
|
151
|
+
{{#if IS_NODE}}
|
|
152
|
+
Key dependencies from `package.json`:
|
|
153
|
+
|
|
154
|
+
| Package | Version | Purpose |
|
|
155
|
+
|---------|---------|---------|
|
|
156
|
+
{{#each DEPENDENCIES}}
|
|
157
|
+
| {{this.name}} | {{this.version}} | {{this.purpose}} |
|
|
158
|
+
{{/each}}
|
|
159
|
+
{{/if}}
|
|
160
|
+
|
|
161
|
+
{{#if IS_PYTHON}}
|
|
162
|
+
Key dependencies from `requirements.txt`:
|
|
163
|
+
|
|
164
|
+
| Package | Version | Purpose |
|
|
165
|
+
|---------|---------|---------|
|
|
166
|
+
{{#each DEPENDENCIES}}
|
|
167
|
+
| {{this.name}} | {{this.version}} | {{this.purpose}} |
|
|
168
|
+
{{/each}}
|
|
169
|
+
{{/if}}
|
|
170
|
+
|
|
171
|
+
### Development Dependencies
|
|
172
|
+
|
|
173
|
+
| Package | Purpose |
|
|
174
|
+
|---------|---------|
|
|
175
|
+
{{#each DEV_DEPENDENCIES}}
|
|
176
|
+
| {{this.name}} | {{this.purpose}} |
|
|
177
|
+
{{/each}}
|
|
178
|
+
|
|
179
|
+
---
|
|
180
|
+
|
|
181
|
+
## Configuration Files
|
|
182
|
+
|
|
183
|
+
| File | Purpose |
|
|
184
|
+
|------|---------|
|
|
185
|
+
| `.aios-core/core-config.yaml` | AIOS configuration |
|
|
186
|
+
| `.env.example` | Environment template |
|
|
187
|
+
| `.gitignore` | Git ignore rules |
|
|
188
|
+
{{#if IS_NODE}}
|
|
189
|
+
| `package.json` | Node.js project config |
|
|
190
|
+
{{#if IS_TYPESCRIPT}}
|
|
191
|
+
| `tsconfig.json` | TypeScript config |
|
|
192
|
+
{{/if}}
|
|
193
|
+
| `.eslintrc.js` | ESLint rules |
|
|
194
|
+
| `.prettierrc` | Prettier config |
|
|
195
|
+
{{/if}}
|
|
196
|
+
{{#if IS_PYTHON}}
|
|
197
|
+
| `pyproject.toml` | Python project config |
|
|
198
|
+
| `requirements.txt` | Dependencies |
|
|
199
|
+
| `.flake8` | Flake8 config |
|
|
200
|
+
{{/if}}
|
|
201
|
+
{{#if IS_GO}}
|
|
202
|
+
| `go.mod` | Go modules |
|
|
203
|
+
| `go.sum` | Dependency checksums |
|
|
204
|
+
{{/if}}
|
|
205
|
+
|
|
206
|
+
---
|
|
207
|
+
|
|
208
|
+
## Environment Variables
|
|
209
|
+
|
|
210
|
+
| Variable | Description | Required |
|
|
211
|
+
|----------|-------------|----------|
|
|
212
|
+
| `NODE_ENV` / `ENV` | Environment name | Yes |
|
|
213
|
+
{{#each ENV_VARS}}
|
|
214
|
+
| `{{this.name}}` | {{this.description}} | {{this.required}} |
|
|
215
|
+
{{/each}}
|
|
216
|
+
|
|
217
|
+
See `.env.example` for a complete list.
|
|
218
|
+
|
|
219
|
+
---
|
|
220
|
+
|
|
221
|
+
## Upgrade Guidelines
|
|
222
|
+
|
|
223
|
+
### Language/Runtime Updates
|
|
224
|
+
|
|
225
|
+
1. Check release notes for breaking changes
|
|
226
|
+
2. Update version in configuration files
|
|
227
|
+
3. Run full test suite
|
|
228
|
+
4. Update CI/CD configuration
|
|
229
|
+
5. Document changes in CHANGELOG
|
|
230
|
+
|
|
231
|
+
### Dependency Updates
|
|
232
|
+
|
|
233
|
+
1. Review changelogs for security fixes
|
|
234
|
+
2. Update one dependency at a time
|
|
235
|
+
3. Run tests after each update
|
|
236
|
+
4. Commit with clear message
|
|
237
|
+
|
|
238
|
+
```bash
|
|
239
|
+
{{#if IS_NODE}}
|
|
240
|
+
# Check for updates
|
|
241
|
+
npm outdated
|
|
242
|
+
|
|
243
|
+
# Update specific package
|
|
244
|
+
npm update <package-name>
|
|
245
|
+
{{/if}}
|
|
246
|
+
{{#if IS_PYTHON}}
|
|
247
|
+
# Check for updates
|
|
248
|
+
pip list --outdated
|
|
249
|
+
|
|
250
|
+
# Update specific package
|
|
251
|
+
pip install --upgrade <package-name>
|
|
252
|
+
{{/if}}
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
---
|
|
256
|
+
|
|
257
|
+
## Security Considerations
|
|
258
|
+
|
|
259
|
+
- [ ] Dependencies scanned for vulnerabilities
|
|
260
|
+
- [ ] Environment variables not committed
|
|
261
|
+
- [ ] Secrets stored securely
|
|
262
|
+
- [ ] HTTPS enforced in production
|
|
263
|
+
|
|
264
|
+
---
|
|
265
|
+
|
|
266
|
+
*Generated by AIOS Documentation Integrity System*
|
|
267
|
+
*Template Version: 1.0.0*
|
package/package.json
CHANGED
|
@@ -118,7 +118,7 @@ VERCEL_TOKEN=
|
|
|
118
118
|
# AIOS Core Configuration
|
|
119
119
|
# --------------------------------------------
|
|
120
120
|
NODE_ENV=development
|
|
121
|
-
AIOS_VERSION=2.1.
|
|
121
|
+
AIOS_VERSION=2.1.6
|
|
122
122
|
|
|
123
123
|
# --------------------------------------------
|
|
124
124
|
# Custom Configuration
|
|
@@ -230,7 +230,7 @@ VERCEL_TOKEN=
|
|
|
230
230
|
# AIOS Core Configuration
|
|
231
231
|
# --------------------------------------------
|
|
232
232
|
NODE_ENV=development
|
|
233
|
-
AIOS_VERSION=2.1.
|
|
233
|
+
AIOS_VERSION=2.1.6
|
|
234
234
|
|
|
235
235
|
# --------------------------------------------
|
|
236
236
|
# Custom Configuration
|
|
@@ -105,7 +105,7 @@ async function selectInstallationMode(detected) {
|
|
|
105
105
|
* @param {Object} detected - Detection result
|
|
106
106
|
* @returns {Promise<Object>} Mode-specific configuration
|
|
107
107
|
*/
|
|
108
|
-
async function configureModeSpecific(mode,
|
|
108
|
+
async function configureModeSpecific(mode, _targetDir, _detected) {
|
|
109
109
|
const config = {
|
|
110
110
|
mode,
|
|
111
111
|
generateDocs: true,
|
|
@@ -9,6 +9,7 @@ const fs = require('fs-extra');
|
|
|
9
9
|
const path = require('path');
|
|
10
10
|
const os = require('os');
|
|
11
11
|
const { configureEnvironment, updateGitignore } = require('../../src/config/configure-environment');
|
|
12
|
+
const pkg = require('../../../../package.json');
|
|
12
13
|
|
|
13
14
|
/**
|
|
14
15
|
* Cleanup helper with retry logic for flaky file system operations
|
|
@@ -72,7 +73,7 @@ describe('Environment Configuration Integration', () => {
|
|
|
72
73
|
|
|
73
74
|
const content = await fs.readFile(envPath, 'utf8');
|
|
74
75
|
expect(content).toContain('NODE_ENV=development');
|
|
75
|
-
expect(content).toContain(
|
|
76
|
+
expect(content).toContain(`AIOS_VERSION=${pkg.version}`);
|
|
76
77
|
});
|
|
77
78
|
|
|
78
79
|
it('should create .env.example file', async () => {
|
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
*/
|
|
7
7
|
|
|
8
8
|
const { generateEnvContent, generateEnvExample } = require('../../src/config/templates/env-template');
|
|
9
|
+
const pkg = require('../../../../package.json');
|
|
9
10
|
|
|
10
11
|
describe('.env Template Generator', () => {
|
|
11
12
|
describe('generateEnvContent', () => {
|
|
@@ -13,7 +14,7 @@ describe('.env Template Generator', () => {
|
|
|
13
14
|
const content = generateEnvContent();
|
|
14
15
|
|
|
15
16
|
expect(content).toContain('NODE_ENV=development');
|
|
16
|
-
expect(content).toContain(
|
|
17
|
+
expect(content).toContain(`AIOS_VERSION=${pkg.version}`);
|
|
17
18
|
expect(content).toContain('OPENAI_API_KEY=');
|
|
18
19
|
expect(content).toContain('ANTHROPIC_API_KEY=');
|
|
19
20
|
expect(content).toContain('# AIOS Environment Configuration');
|
|
@@ -83,7 +84,7 @@ describe('.env Template Generator', () => {
|
|
|
83
84
|
const content = generateEnvExample();
|
|
84
85
|
|
|
85
86
|
expect(content).toContain('NODE_ENV=development');
|
|
86
|
-
expect(content).toContain(
|
|
87
|
+
expect(content).toContain(`AIOS_VERSION=${pkg.version}`);
|
|
87
88
|
expect(content).toContain('OPENAI_API_KEY=');
|
|
88
89
|
expect(content).toContain('ANTHROPIC_API_KEY=');
|
|
89
90
|
expect(content).toContain('CLICKUP_API_KEY=');
|
package/src/wizard/index.js
CHANGED
|
@@ -30,7 +30,7 @@ const {
|
|
|
30
30
|
const {
|
|
31
31
|
installLLMRouting,
|
|
32
32
|
isLLMRoutingInstalled,
|
|
33
|
-
getInstallationSummary
|
|
33
|
+
getInstallationSummary
|
|
34
34
|
} = require('../../.aios-core/infrastructure/scripts/llm-routing/install-llm-routing');
|
|
35
35
|
|
|
36
36
|
/**
|
|
@@ -484,7 +484,7 @@ async function runWizard() {
|
|
|
484
484
|
const llmResult = installLLMRouting({
|
|
485
485
|
projectRoot: process.cwd(),
|
|
486
486
|
onProgress: (msg) => console.log(` ${msg}`),
|
|
487
|
-
onError: (msg) => console.error(` ${msg}`)
|
|
487
|
+
onError: (msg) => console.error(` ${msg}`)
|
|
488
488
|
});
|
|
489
489
|
|
|
490
490
|
if (llmResult.success) {
|