anhedral 0.22.1 → 0.24.0
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/README.md +37 -53
- package/assets/contracts/environment-provenance.json +2 -2
- package/assets/launch/application.server.ts.txt +19 -7
- package/assets/launch/application.test.mjs.txt +8 -0
- package/assets/launch/home.tsx.txt +23 -1
- package/assets/launch/minimal-application.server.ts.txt +2 -2
- package/assets/launch/sign-in.tsx.txt +66 -4
- package/assets/launch/storage-page.tsx.txt +56 -0
- package/assets/stack/backend.test.mjs.txt +10 -0
- package/assets/stack/payment.test.mjs.txt +55 -0
- package/assets/stack/storage.test.mjs.txt +47 -0
- package/dist/bounded-file.d.ts +2 -1
- package/dist/bounded-file.js +3 -2
- package/dist/cli-output.js +1 -1
- package/dist/command-schema.js +5 -1
- package/dist/composition/catalog.d.ts +2 -2
- package/dist/composition/catalog.js +2 -2
- package/dist/composition/command.js +22 -12
- package/dist/composition/composition.d.ts +1 -0
- package/dist/composition/composition.js +9 -0
- package/dist/composition/editor.d.ts +2 -1
- package/dist/composition/editor.js +15 -3
- package/dist/composition/recipes.d.ts +1 -1
- package/dist/composition/recipes.js +17 -2
- package/dist/composition/update.js +15 -15
- package/dist/contracts/environment-file.d.ts +3 -0
- package/dist/contracts/environment-file.js +8 -5
- package/dist/dependencies.d.ts +6 -1
- package/dist/dependencies.js +10 -1
- package/dist/launch.js +17 -4
- package/dist/platform/deploy.js +5 -13
- package/dist/platform/environment.js +16 -8
- package/dist/platform/source.d.ts +2 -0
- package/dist/platform/source.js +52 -11
- package/dist/platform/state.js +9 -2
- package/dist/pnpm-policy.d.ts +1 -0
- package/dist/pnpm-policy.js +27 -0
- package/dist/scaffold/tanstack.d.ts +1 -1
- package/dist/scaffold/tanstack.js +17 -4
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/docs/capabilities.md +16 -6
- package/docs/software-factory.md +19 -6
- package/package.json +5 -5
package/dist/platform/source.js
CHANGED
|
@@ -1,18 +1,39 @@
|
|
|
1
1
|
import ignore from 'ignore';
|
|
2
|
+
import { readBoundedFile } from '../bounded-file.js';
|
|
2
3
|
import { constants } from 'node:fs';
|
|
3
|
-
import { lstat, open,
|
|
4
|
-
import { join } from 'node:path';
|
|
4
|
+
import { lstat, open, readdir, stat } from 'node:fs/promises';
|
|
5
|
+
import { join, resolve } from 'node:path';
|
|
5
6
|
import { sourceContainsCredential as localCredentialMaterial } from '../../assets/security/credential-patterns.mjs';
|
|
6
7
|
import { SOURCE_LIMITS, sourceContainsCredential, uploadExcluded, uploadSecret, } from '../contracts/cli-transport.js';
|
|
7
8
|
import { packSource, setSourceExecutable, sourceInventory, validateSourcePath, } from '../contracts/source-bundle.js';
|
|
8
9
|
import { excludedSource, generatedSource, secretSource } from '../contracts/source-profile.js';
|
|
9
10
|
import { platformFailure } from './state.js';
|
|
11
|
+
// Keep the directory open throughout all child lookups. These OS namespaces
|
|
12
|
+
// address the open object even if a writer renames its original directory.
|
|
13
|
+
export async function anchoredDirectory(handle) {
|
|
14
|
+
const identity = await handle.stat({ bigint: true });
|
|
15
|
+
const path = process.platform === 'linux'
|
|
16
|
+
? '/proc/self/fd/' + handle.fd
|
|
17
|
+
: '/.vol/' + identity.dev + '/' + identity.ino;
|
|
18
|
+
const resolved = await stat(path, { bigint: true }).catch(() => null);
|
|
19
|
+
if (!identity.isDirectory() || identity.dev !== resolved?.dev || identity.ino !== resolved.ino)
|
|
20
|
+
throw platformFailure('This filesystem cannot safely anchor source directories for upload.');
|
|
21
|
+
return path;
|
|
22
|
+
}
|
|
10
23
|
export async function packageSource(root) {
|
|
24
|
+
if (!['linux', 'darwin'].includes(process.platform))
|
|
25
|
+
throw platformFailure('Source packaging requires Linux procfs or a macOS volume supporting directory IDs. On Windows, run the CLI inside WSL.');
|
|
26
|
+
const directoryFlags = constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW;
|
|
11
27
|
const files = new Map();
|
|
12
28
|
let bytes = 0;
|
|
13
|
-
async function walk(relative, rules) {
|
|
14
|
-
const directory =
|
|
15
|
-
const
|
|
29
|
+
async function walk(handle, relative, rules) {
|
|
30
|
+
const directory = await anchoredDirectory(handle);
|
|
31
|
+
const ignorePath = join(directory, '.gitignore');
|
|
32
|
+
const gitignore = await lstat(ignorePath).catch((error) => {
|
|
33
|
+
if (error.code === 'ENOENT')
|
|
34
|
+
return null;
|
|
35
|
+
throw error;
|
|
36
|
+
});
|
|
16
37
|
if (gitignore && (!gitignore.isFile() || gitignore.isSymbolicLink()))
|
|
17
38
|
throw platformFailure('Source ignore file is unsafe.');
|
|
18
39
|
if (gitignore) {
|
|
@@ -22,13 +43,17 @@ export async function packageSource(root) {
|
|
|
22
43
|
...rules,
|
|
23
44
|
{
|
|
24
45
|
base: relative,
|
|
25
|
-
matcher: ignore().add(
|
|
46
|
+
matcher: ignore().add(readBoundedFile(ignorePath, 65536, (opened) => {
|
|
47
|
+
if (opened.dev !== gitignore.dev || opened.ino !== gitignore.ino)
|
|
48
|
+
throw platformFailure('Source ignore file changed during packaging.');
|
|
49
|
+
}).toString('utf8')),
|
|
26
50
|
},
|
|
27
51
|
];
|
|
28
52
|
}
|
|
29
53
|
for (const entry of (await readdir(directory, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name))) {
|
|
30
54
|
const path = relative ? `${relative}/${entry.name}` : entry.name;
|
|
31
|
-
if (
|
|
55
|
+
if (/^(?:\.env|\.dev\.vars|\.anhedral$)/i.test(entry.name) ||
|
|
56
|
+
excludedSource.test(path) ||
|
|
32
57
|
generatedSource.test(path) ||
|
|
33
58
|
secretSource.test(path) ||
|
|
34
59
|
uploadExcluded.test(path) ||
|
|
@@ -44,17 +69,27 @@ export async function packageSource(root) {
|
|
|
44
69
|
}
|
|
45
70
|
if (ignored)
|
|
46
71
|
continue;
|
|
47
|
-
const
|
|
72
|
+
const childPath = join(directory, entry.name);
|
|
73
|
+
const info = await lstat(childPath);
|
|
48
74
|
if (info.isSymbolicLink() || (!info.isFile() && !info.isDirectory()))
|
|
49
75
|
throw platformFailure('Source contains a symbolic link or special file. Exclude it before uploading.');
|
|
50
76
|
validateSourcePath(path);
|
|
51
77
|
if (info.isDirectory()) {
|
|
52
|
-
await
|
|
78
|
+
const child = await open(childPath, directoryFlags);
|
|
79
|
+
try {
|
|
80
|
+
const opened = await child.stat();
|
|
81
|
+
if (opened.dev !== info.dev || opened.ino !== info.ino)
|
|
82
|
+
throw platformFailure('Source directory changed during packaging.');
|
|
83
|
+
await walk(child, path, rules);
|
|
84
|
+
}
|
|
85
|
+
finally {
|
|
86
|
+
await child.close();
|
|
87
|
+
}
|
|
53
88
|
continue;
|
|
54
89
|
}
|
|
55
90
|
if (files.size >= SOURCE_LIMITS.files || (bytes += info.size) > SOURCE_LIMITS.bytes)
|
|
56
91
|
throw platformFailure('Source exceeds its file or byte limit.');
|
|
57
|
-
const handle = await open(
|
|
92
|
+
const handle = await open(childPath, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
|
|
58
93
|
let content;
|
|
59
94
|
try {
|
|
60
95
|
const before = await handle.stat();
|
|
@@ -86,7 +121,13 @@ export async function packageSource(root) {
|
|
|
86
121
|
setSourceExecutable(files, path, Boolean(info.mode & 0o111));
|
|
87
122
|
}
|
|
88
123
|
}
|
|
89
|
-
await
|
|
124
|
+
const rootHandle = await open(resolve(root) === process.cwd() ? '.' : root, directoryFlags);
|
|
125
|
+
try {
|
|
126
|
+
await walk(rootHandle, '', []);
|
|
127
|
+
}
|
|
128
|
+
finally {
|
|
129
|
+
await rootHandle.close();
|
|
130
|
+
}
|
|
90
131
|
const config = files.get('anhedral.json');
|
|
91
132
|
if (!config || !files.has('pnpm-lock.yaml'))
|
|
92
133
|
throw platformFailure('Upload requires anhedral.json and pnpm-lock.yaml.');
|
package/dist/platform/state.js
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
import { spawn } from 'node:child_process';
|
|
2
2
|
import { createHash, randomUUID } from 'node:crypto';
|
|
3
|
-
import { lstat, mkdir, open,
|
|
3
|
+
import { lstat, mkdir, open, rename, unlink, writeFile } from 'node:fs/promises';
|
|
4
4
|
import { dirname, join } from 'node:path';
|
|
5
|
+
import { readBoundedFile } from '../bounded-file.js';
|
|
5
6
|
import { CliArgumentError } from '../cli-arguments.js';
|
|
6
7
|
import { CliFailure } from '../cli-errors.js';
|
|
7
8
|
import { trustedLinuxCredentialHelper } from './credential-helper.js';
|
|
@@ -65,7 +66,13 @@ export async function readPrivate(path) {
|
|
|
65
66
|
info.size > 65536 ||
|
|
66
67
|
(process.platform !== 'win32' && ((info.mode & 0o077) !== 0 || info.uid !== process.getuid?.())))
|
|
67
68
|
throw platformFailure('State file must be owned by you with mode 0600.');
|
|
68
|
-
const text =
|
|
69
|
+
const text = readBoundedFile(path, 65536, (opened) => {
|
|
70
|
+
if (opened.dev !== info.dev ||
|
|
71
|
+
opened.ino !== info.ino ||
|
|
72
|
+
(process.platform !== 'win32' &&
|
|
73
|
+
((opened.mode & 0o077) !== 0 || opened.uid !== process.getuid?.())))
|
|
74
|
+
throw platformFailure('State file changed or has unsafe permissions.');
|
|
75
|
+
}).toString('utf8');
|
|
69
76
|
try {
|
|
70
77
|
return JSON.parse(text);
|
|
71
78
|
}
|
package/dist/pnpm-policy.d.ts
CHANGED
|
@@ -2,3 +2,4 @@
|
|
|
2
2
|
export declare function setPnpmPolicy(root: string, policy: Record<string, unknown>): void;
|
|
3
3
|
/** Extend a pnpm patch map without replacing unrelated patches or YAML comments. */
|
|
4
4
|
export declare function pnpmPatchPolicy(source: string, coordinate: string, patch: string): string;
|
|
5
|
+
export declare function secureWorkspacePolicy(source: string): string;
|
package/dist/pnpm-policy.js
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { SECURITY_OVERRIDES } from './dependencies.js';
|
|
1
2
|
import { existsSync, readFileSync } from 'node:fs';
|
|
2
3
|
import path from 'node:path';
|
|
3
4
|
import { writeFile } from './util.js';
|
|
@@ -38,3 +39,29 @@ export function pnpmPatchPolicy(source, coordinate, patch) {
|
|
|
38
39
|
mapping.set(coordinate, patch);
|
|
39
40
|
return document.toString({ lineWidth: 0 });
|
|
40
41
|
}
|
|
42
|
+
export function secureWorkspacePolicy(source) {
|
|
43
|
+
const document = parseDocument(source);
|
|
44
|
+
if (document.errors.length || !isMap(document.contents))
|
|
45
|
+
throw Error('Invalid pnpm workspace YAML; review dependency overrides.');
|
|
46
|
+
if (!document.has('overrides')) {
|
|
47
|
+
const newline = source.includes('\r\n') ? '\r\n' : '\n';
|
|
48
|
+
return (source +
|
|
49
|
+
(source.endsWith('\n') ? '' : newline) +
|
|
50
|
+
'overrides: ' +
|
|
51
|
+
JSON.stringify(SECURITY_OVERRIDES) +
|
|
52
|
+
newline);
|
|
53
|
+
}
|
|
54
|
+
const overrides = document.get('overrides', true);
|
|
55
|
+
if (!isMap(overrides))
|
|
56
|
+
throw Error('Expected an explicit pnpm overrides mapping.');
|
|
57
|
+
let changed = false;
|
|
58
|
+
for (const [selector, version] of Object.entries(SECURITY_OVERRIDES)) {
|
|
59
|
+
if (overrides.get(selector) === version)
|
|
60
|
+
continue;
|
|
61
|
+
if (overrides.has(selector))
|
|
62
|
+
throw Error('Review conflicting pnpm override for ' + selector);
|
|
63
|
+
overrides.set(selector, version);
|
|
64
|
+
changed = true;
|
|
65
|
+
}
|
|
66
|
+
return changed ? document.toString({ lineWidth: 0 }) : source;
|
|
67
|
+
}
|
|
@@ -5,6 +5,6 @@ export declare function scaffoldTanstack(root: string, name: string): void;
|
|
|
5
5
|
/** One-time source upgrade, planned in the same bounded overlay as each addition. */
|
|
6
6
|
export declare function normalizeOjFoundation(e: CapabilityEditor, installed: readonly Capability[], refreshConfiguration?: boolean): boolean;
|
|
7
7
|
/** Fingerprinted composition adapters; application routes stay source-owned. */
|
|
8
|
-
export declare function composeTanstack(e: CapabilityEditor, installed: readonly Capability[]): void;
|
|
8
|
+
export declare function composeTanstack(e: CapabilityEditor, installed: readonly Capability[], refreshConfiguration?: boolean): void;
|
|
9
9
|
/** Install account source only when the backend authentication capability is added. */
|
|
10
10
|
export declare function addTanstackAuth(e: CapabilityEditor): void;
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { secureWorkspacePolicy } from '../pnpm-policy.js';
|
|
1
2
|
import { readFileSync } from 'node:fs';
|
|
2
3
|
import { ANHEDRAL_STACK_DEPENDENCIES, WEB_DEPENDENCIES } from '../dependencies.js';
|
|
3
4
|
import { CapabilityEditor, fingerprint } from '../composition/editor.js';
|
|
@@ -15,6 +16,7 @@ export function scaffoldTanstack(root, name) {
|
|
|
15
16
|
version: '0.1.0',
|
|
16
17
|
type: 'module',
|
|
17
18
|
scripts: {
|
|
19
|
+
test: 'node --experimental-strip-types --test tests/*.test.mjs',
|
|
18
20
|
dev: 'node ../../scripts/oj.mjs dev . --host=0.0.0.0 --port 3000',
|
|
19
21
|
build: 'node ../../scripts/oj.mjs build .',
|
|
20
22
|
preview: 'wrangler dev --config dist/ssr/wrangler.json --port 3000',
|
|
@@ -107,6 +109,7 @@ export function cn(...values: ClassValue[]) { return twMerge(clsx(values)); }
|
|
|
107
109
|
put(root, `${app}/postcss.config.mjs`, "export default { plugins: { '@tailwindcss/postcss': {} } };\n");
|
|
108
110
|
put(root, `${app}/src/starter.ts`, `export const starterTitle = ${JSON.stringify(name)};\n`);
|
|
109
111
|
const files = {
|
|
112
|
+
'tests/application.test.mjs': 'application.test.mjs.txt',
|
|
110
113
|
'src/router.tsx': 'router.tsx.txt',
|
|
111
114
|
'src/lib/request-context.ts': 'request-context.ts.txt',
|
|
112
115
|
'src/routes/__root.tsx': 'root.tsx.txt',
|
|
@@ -170,7 +173,14 @@ export function normalizeOjFoundation(e, installed, refreshConfiguration = false
|
|
|
170
173
|
if (current !== undefined && current !== desired && current !== previous && !previousOjDev)
|
|
171
174
|
throw Error(`Preserve customized web launcher scripts.${name}. Reconcile it with the pinned OJ runtime before adding capabilities. No files were changed.`);
|
|
172
175
|
}
|
|
173
|
-
|
|
176
|
+
const workspace = 'pnpm-workspace.yaml';
|
|
177
|
+
const previousPolicy = e.read(workspace);
|
|
178
|
+
if (previousPolicy === null)
|
|
179
|
+
throw Error('Missing pnpm workspace configuration.');
|
|
180
|
+
const policy = secureWorkspacePolicy(previousPolicy);
|
|
181
|
+
let changed = policy !== previousPolicy;
|
|
182
|
+
if (changed)
|
|
183
|
+
e.writes.set(workspace, policy);
|
|
174
184
|
const serverEntry = 'apps/web/src/server.ts';
|
|
175
185
|
const currentEntry = e.read(serverEntry);
|
|
176
186
|
// Repair only the exact shipped adapter whose default-entry shim drops Start context in OJ.
|
|
@@ -228,13 +238,16 @@ export function normalizeOjFoundation(e, installed, refreshConfiguration = false
|
|
|
228
238
|
return changed;
|
|
229
239
|
}
|
|
230
240
|
/** Fingerprinted composition adapters; application routes stay source-owned. */
|
|
231
|
-
export function composeTanstack(e, installed) {
|
|
241
|
+
export function composeTanstack(e, installed, refreshConfiguration = false) {
|
|
232
242
|
assertTanstack(e);
|
|
233
|
-
normalizeOjFoundation(e, installed);
|
|
243
|
+
normalizeOjFoundation(e, installed, refreshConfiguration);
|
|
234
244
|
const backend = installed.includes('hono');
|
|
235
245
|
const auth = installed.includes('database-auth');
|
|
236
246
|
e.owned('apps/web/src/server.ts', template(backend ? 'server.ts.txt' : 'minimal-server.ts.txt'));
|
|
237
|
-
e.owned('apps/web/src/lib/application.server.ts', template(backend ? 'application.server.ts.txt' : 'minimal-application.server.ts.txt')
|
|
247
|
+
e.owned('apps/web/src/lib/application.server.ts', template(backend ? 'application.server.ts.txt' : 'minimal-application.server.ts.txt')
|
|
248
|
+
.replaceAll('__AUTHENTICATION__', String(auth))
|
|
249
|
+
.replaceAll('__STORAGE__', String(installed.includes('r2')))
|
|
250
|
+
.replaceAll('__PAYMENT__', String(installed.includes('stripe'))));
|
|
238
251
|
e.owned('apps/web/vite.config.ts', tanstackViteConfiguration(installed));
|
|
239
252
|
}
|
|
240
253
|
/** Install account source only when the backend authentication capability is added. */
|
package/dist/version.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export declare const GENERATOR_VERSION = "0.
|
|
1
|
+
export declare const GENERATOR_VERSION = "0.24.0";
|
package/dist/version.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export const GENERATOR_VERSION = '0.
|
|
1
|
+
export const GENERATOR_VERSION = '0.24.0';
|
package/docs/capabilities.md
CHANGED
|
@@ -7,18 +7,26 @@ anhedral init my-app
|
|
|
7
7
|
cd my-app
|
|
8
8
|
anhedral add backend --dry-run --json
|
|
9
9
|
anhedral add backend
|
|
10
|
-
anhedral add
|
|
10
|
+
anhedral add storage payment
|
|
11
11
|
anhedral stack status --json
|
|
12
12
|
```
|
|
13
13
|
|
|
14
|
-
| Selection | Source added
|
|
15
|
-
| --------- |
|
|
16
|
-
| `backend` | Hono API, Drizzle/D1, Better Auth and web sign-in starter
|
|
17
|
-
| `
|
|
18
|
-
| `
|
|
14
|
+
| Selection | Source added | Requires |
|
|
15
|
+
| --------- | ----------------------------------------------------------------- | ----------------------------- |
|
|
16
|
+
| `backend` | Hono API, Drizzle/D1, Better Auth and web sign-in starter | Anhedral Stack web foundation |
|
|
17
|
+
| `storage` | Cloudflare R2 binding and authenticated owner-scoped file routes | `backend` |
|
|
18
|
+
| `payment` | Stripe Checkout, signed webhooks and canonical entitlement checks | `backend` |
|
|
19
|
+
|
|
20
|
+
Use `add storage` in place of `add r2`, and `add payment` in place of `add stripe` or `add payments`. Existing projects retain the provider identifiers `r2` and `stripe` in their source manifests. The CLI recognizes these as installed storage and payment additions.
|
|
19
21
|
|
|
20
22
|
`backend` is one public selection; its provenance records the concrete Hono and database/auth capabilities. Use `--with-dependencies` to include missing prerequisites in the same planned source transaction. `stack list` describes this stack's additions. `status`/`doctor` check source completeness, not live service activation.
|
|
21
23
|
|
|
24
|
+
## Updating an existing app
|
|
25
|
+
|
|
26
|
+
Run `pnpm dlx anhedral@latest stack update --dry-run --human` from the project. Review the diff, then run the version-pinned apply command in the preview. It checks that the plan still matches. After applying, run `pnpm install` and `pnpm check`. Use `--offline` for a local source update with deployment provenance pending.
|
|
27
|
+
|
|
28
|
+
Updates refresh the managed web and API adapters for the installed additions. Product routes, feature implementations and migrations stay application-owned. The updater preserves local adapter edits when the release still supplies the same baseline. If both changed differently, the preview identifies the conflicting file before any writes.
|
|
29
|
+
|
|
22
30
|
## Source protection
|
|
23
31
|
|
|
24
32
|
Adding a capability also upgrades a canonical earlier TanStack Start foundation to the pinned OJ launchers and runtime helpers in the same source transaction, including when that capability is already installed. The exact earlier canonical document also receives the OJ-compatible side-effect CSS import; safe customized documents stay untouched, while edited documents retaining the earlier stylesheet URL import require reconciliation. Customized launchers or generated configuration require reconciliation before any writes. Additions never reinitialize an application. They plan all selected changes before writing, reject collisions and preserve unrelated JSON/JSONC settings. Composition adapters are fingerprinted in `anhedral.json`; modified adapters require reconciliation instead of silent replacement. Add product routes in `apps/api/src/index.ts`, custom types in `custom-environment.ts`, and auth method configuration in `auth-features.ts`/`auth.ts`.
|
|
@@ -41,4 +49,6 @@ Stripe adds source/schema, not a live payment service. Generate and review its b
|
|
|
41
49
|
|
|
42
50
|
`anhedral.json` records nonsecret generator/capability versions and identity. Source provenance never grants hosting authority. The public deployment manifest uses runtime profile `anhedral-stack` for the web foundation and selected backend/R2/Stripe composition. Artifact identity, resource provisioning, secrets, migrations, runtime checks and production approval remain server-owned. See [the workflow](software-factory.md#platform-cli-access-and-source-upload).
|
|
43
51
|
|
|
52
|
+
The starter includes local tests for each installed addition. Storage tests use ephemeral Worker bindings. Payment tests generate and apply SQL only to a disposable fixture and sign webhook events locally. The workspace scopes security overrides to the affected transitive dependency versions.
|
|
53
|
+
|
|
44
54
|
Run `pnpm check` and `pnpm audit:deps` in generated applications. Framework/runtime, provider and browser acceptance are distinct; source installation alone establishes none of them.
|
package/docs/software-factory.md
CHANGED
|
@@ -107,9 +107,10 @@ Use the host's configured marketplace: Codex refreshes its marketplace with
|
|
|
107
107
|
and reload/restart the host when required before relying on its new guidance.
|
|
108
108
|
Run `stack update --dry-run --json`, inspect the bounded file diffs and conflicts,
|
|
109
109
|
then apply `stack update --expect-plan <planId> --json`. The plan binds source
|
|
110
|
-
preimages, target generator and resolved release artifact.
|
|
111
|
-
|
|
112
|
-
|
|
110
|
+
preimages, target generator and resolved release artifact. A stale plan requires
|
|
111
|
+
a new preview. Fingerprinted adapters retain local edits when their release
|
|
112
|
+
baseline is unchanged. Divergent edits to the same adapter require reconciliation.
|
|
113
|
+
The application owns its routes and assets. This operation uses the existing journaled transaction
|
|
113
114
|
without installing dependencies or running project scripts. Resolve source
|
|
114
115
|
conflicts before another preview, then install dependencies and run application
|
|
115
116
|
checks/build separately. It never changes authentication or deployment authority.
|
|
@@ -175,8 +176,13 @@ responses. `source status` reads its server receipt. Changed source requires an
|
|
|
175
176
|
explicit `source upload --new`; an expired request also requires a new request.
|
|
176
177
|
The client honors nested `.gitignore`, excludes generated output and secret paths,
|
|
177
178
|
rejects symlinks and recognized credential material, and hashes every bounded
|
|
178
|
-
chunk plus the complete archive and canonical source inventory.
|
|
179
|
-
|
|
179
|
+
chunk plus the complete archive and canonical source inventory.
|
|
180
|
+
|
|
181
|
+
Source packaging holds directory handles throughout traversal. It requires Linux
|
|
182
|
+
with procfs or a macOS filesystem supporting volume file IDs. Run the CLI in WSL
|
|
183
|
+
for Windows source uploads.
|
|
184
|
+
|
|
185
|
+
The generated `apps/web/src/routeTree.gen.ts` is excluded because the router regenerates it during
|
|
180
186
|
checks/builds; authored routes, router configuration and server source remain
|
|
181
187
|
included. Credential scanning is deliberately conservative; inspect source before uploading.
|
|
182
188
|
|
|
@@ -220,13 +226,20 @@ routing require `deploy plan --manifest <file> --new`. Plan/source expiry and
|
|
|
220
226
|
revocation fail closed. State under `.anhedral/platform/deployment.json` contains
|
|
221
227
|
no credentials and cannot select a network origin or change the signed-in identity.
|
|
222
228
|
|
|
229
|
+
The CLI imports the reviewed portable environment parser from Platform. File, stdin
|
|
230
|
+
and parser size limits share its exported constant; typed parser errors retain the
|
|
231
|
+
same value-free validation messages.
|
|
232
|
+
|
|
223
233
|
`env list` returns names, types, environments and versions. `env import --environment
|
|
224
234
|
staging|production --file <path>` reads a private dotenv file; `--stdin` accepts a
|
|
225
235
|
pipe. `env set <NAME>` reads one literal value from a file or pipe. Values are
|
|
226
236
|
never arguments, output or retry-state contents. Non-public names default to
|
|
227
237
|
secrets; `--type config` is explicit readable configuration. Public-prefixed
|
|
228
238
|
secrets, reserved names, duplicate names and oversized input fail before upload.
|
|
229
|
-
|
|
239
|
+
Use stdin, an owner-only file outside the project, or an input under the
|
|
240
|
+
project’s always-excluded `.anhedral/` directory. Project `.env*` and `.dev.vars*`
|
|
241
|
+
filenames are also excluded. A project-specific gitignore rule alone is insufficient.
|
|
242
|
+
Files must have a single hard link and a regular non-symlink final component;
|
|
230
243
|
ancestor checks reject observed symlinks but are not an atomic directory lock.
|
|
231
244
|
Use `--dry-run` without authentication for names/types only. Actual imports bind
|
|
232
245
|
API origin, principal, team, project and environment, require `--replace` for
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "anhedral",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.24.0",
|
|
4
4
|
"description": "The open-source Anhedral API client for building, configuring and deploying apps, with editable source generation.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"exports": {
|
|
@@ -109,14 +109,14 @@
|
|
|
109
109
|
"packageManager": "pnpm@10.34.5",
|
|
110
110
|
"devDependencies": {
|
|
111
111
|
"@types/node": "20.19.43",
|
|
112
|
-
"hono": "4.13.
|
|
113
|
-
"prettier": "3.
|
|
114
|
-
"typescript": "
|
|
112
|
+
"hono": "4.13.18",
|
|
113
|
+
"prettier": "3.10.1",
|
|
114
|
+
"typescript": "6.0.3"
|
|
115
115
|
},
|
|
116
116
|
"dependencies": {
|
|
117
117
|
"jsonc-parser": "3.3.1",
|
|
118
118
|
"yaml": "2.9.1",
|
|
119
|
-
"zod": "4.6.
|
|
119
|
+
"zod": "4.6.7",
|
|
120
120
|
"ignore": "7.0.14"
|
|
121
121
|
}
|
|
122
122
|
}
|