mirror of
https://github.com/stack-auth/stack.git
synced 2026-06-21 21:09:49 +08:00
## Summary
Replaces `writeConfigObject` (destructive overwrite) with
`updateConfigObject` — an async, AI-aware updater that preserves
user-authored config structure (imports, external file references,
helpers).
**Dual-path approach:**
- **Fast path** (deterministic, no AI): plain static literal configs →
`override()` + in-memory validation + atomic write
- **Agent path** (custom structure): configs with `import x from
"./file.txt" with { type: "text" }` etc. → Claude agent edits the
external files in place, then validates
**Safety guarantees:**
- Snapshot/restore: config + all relative imports are captured before
the agent runs; rolled back on any failure
- In-memory validation on fast path (never write unvalidated bytes)
- Semantic check when config is evaluable; no-op detection + structural
check when it isn't
- Path traversal guard on imports (rejects `../` escapes)
- Agent isolation: `settingSources: []`, `strictMcpConfig: true`,
`CLAUDE_CODE_DISABLE_AUTO_MEMORY`, no Bash tool
- `scheduleSync` only fires after a successful update
- Bounded 120s timeout on agent runs (configurable via env var)
CI failures are preexisting on `dev`
(`ERR_PNPM_LOCKFILE_CONFIG_MISMATCH` from overrides move without
lockfile regen); this branch has zero lockfile changes vs dev.
Link to Devin session:
https://app.devin.ai/sessions/cc7409a357bc472ea19fbed065f1229f
Requested by: @mantrakp04
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit
* **New Features**
* Introduced partial configuration update functionality with validation
and automatic rollback on failures.
* Enhanced configuration management with support for more complex file
structures and external references.
* **Chores**
* Added Claude Agent SDK dependency for configuration update operations.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
## Documentation
Docs for this feature were added in this branch:
- **New page**
`docs-mintlify/guides/going-further/local-development.mdx` — covers
`stack dev`, the development-environment flow, and how dashboard edits
are written back to the local config file (structure-preserving fast
path vs. assistant path, external `import … with { type: "text" }`
templates, validation + rollback). Added to `docs.json` nav; also fixes
the previously-broken `/guides/going-further/local-development` links
from `index.mdx` and `self-host.mdx`.
- **`docs-mintlify/guides/going-further/cli.mdx`** — added a `stack dev`
("Run a development environment") section.
- **Skill-site AI prompts** — filled in the `config-docs` and
`dashboard-instructions` placeholders under
`packages/stack-shared/src/ai/unified-prompts/skill-site-prompt-parts/`,
and added a structure-preserving note to the setup prompt.
- **`CHANGELOG.md`** — user-facing entry.
---------
Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: mantra <mantra@stack-auth.com>
176 lines
3.3 KiB
JSON
176 lines
3.3 KiB
JSON
{
|
|
"$schema": "https://turbo.build/schema.json",
|
|
"globalEnv": [
|
|
"STACK_*",
|
|
"HEXCLAVE_*",
|
|
"CRON_SECRET",
|
|
"CRON_SECRET_OLD",
|
|
"BLOB_READ_WRITE_TOKEN",
|
|
"NEXT_PUBLIC_*",
|
|
"VITE_*",
|
|
"NEXT_PUBLIC_SENTRY_*",
|
|
"SENTRY_*",
|
|
"VERCEL_GIT_COMMIT_SHA",
|
|
"NEXT_PUBLIC_POSTHOG_*",
|
|
"POSTHOG_*",
|
|
"NODE_ENV",
|
|
"QUETZAL_*",
|
|
"OTEL_*",
|
|
"DISCORD_WEBHOOK_URL",
|
|
"DISCORD_CHANNEL_ID",
|
|
"DISCORD_BOT_TOKEN",
|
|
"ENABLE_EXPERIMENTAL_COREPACK"
|
|
],
|
|
"tasks": {
|
|
"build": {
|
|
"inputs": [
|
|
"$TURBO_DEFAULT$",
|
|
".env",
|
|
".env.local",
|
|
".env.development",
|
|
".env.development.local",
|
|
".env.production",
|
|
".env.production.local",
|
|
"tsdown.config.ts"
|
|
],
|
|
"dependsOn": [
|
|
"^build"
|
|
],
|
|
"outputs": [
|
|
".next",
|
|
"dist/**",
|
|
"lib/**",
|
|
"*.js",
|
|
"*.d.ts",
|
|
"*.d.ts.map"
|
|
],
|
|
"outputLogs": "new-only"
|
|
},
|
|
"build:rde-standalone": {
|
|
"inputs": [
|
|
"$TURBO_DEFAULT$",
|
|
".env",
|
|
".env.local",
|
|
".env.development",
|
|
".env.development.local",
|
|
".env.production",
|
|
".env.production.local"
|
|
],
|
|
"dependsOn": [
|
|
"build"
|
|
],
|
|
"outputs": [
|
|
".next/**",
|
|
"src/generated/bundled-type-definitions.ts"
|
|
],
|
|
"outputLogs": "new-only"
|
|
},
|
|
"docker-build": {
|
|
"inputs": [
|
|
"$TURBO_DEFAULT$",
|
|
".env",
|
|
".env.local",
|
|
".env.development",
|
|
".env.development.local",
|
|
".env.production",
|
|
".env.production.local"
|
|
],
|
|
"dependsOn": [
|
|
"^build"
|
|
],
|
|
"outputs": [
|
|
".next",
|
|
"dist/**",
|
|
"lib/**",
|
|
"*.js",
|
|
"*.d.ts",
|
|
"*.d.ts.map"
|
|
],
|
|
"outputLogs": "new-only"
|
|
},
|
|
"@hexclave/backend#build": {
|
|
"dependsOn": [
|
|
"codegen"
|
|
]
|
|
},
|
|
"@hexclave/cli#build": {
|
|
"dependsOn": [
|
|
"^build",
|
|
"@hexclave/dashboard#build:rde-standalone"
|
|
],
|
|
"outputs": [
|
|
"dist/**"
|
|
]
|
|
},
|
|
"@hexclave/next#build": {
|
|
"dependsOn": [
|
|
"^build",
|
|
"@hexclave/template#build"
|
|
]
|
|
},
|
|
"@hexclave/react#build": {
|
|
"dependsOn": [
|
|
"^build",
|
|
"@hexclave/template#build"
|
|
]
|
|
},
|
|
"@hexclave/tanstack-start#build": {
|
|
"dependsOn": [
|
|
"^build",
|
|
"@hexclave/template#build"
|
|
]
|
|
},
|
|
"@hexclave/js#build": {
|
|
"dependsOn": [
|
|
"^build",
|
|
"@hexclave/template#build"
|
|
]
|
|
},
|
|
"clean": {
|
|
"cache": false
|
|
},
|
|
"dev": {
|
|
"persistent": true,
|
|
"cache": false
|
|
},
|
|
"dev:tui": {
|
|
"persistent": true,
|
|
"cache": false
|
|
},
|
|
"start": {
|
|
"persistent": true,
|
|
"cache": false
|
|
},
|
|
"lint": {
|
|
"dependsOn": []
|
|
},
|
|
"codegen": {
|
|
"dependsOn": [
|
|
"^build"
|
|
],
|
|
"cache": false
|
|
},
|
|
"typecheck": {
|
|
"dependsOn": []
|
|
},
|
|
"generate-keys": {
|
|
"cache": false
|
|
},
|
|
"db:migration-gen": {
|
|
"cache": false
|
|
},
|
|
"db:reset": {
|
|
"cache": false
|
|
},
|
|
"db:seed": {
|
|
"cache": false
|
|
},
|
|
"db:init": {
|
|
"cache": false
|
|
},
|
|
"db:migrate": {
|
|
"cache": false
|
|
}
|
|
}
|
|
}
|