@intentic/sdk 1.224.0 → 1.226.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 +8 -8
- package/package.json +5 -5
package/README.md
CHANGED
|
@@ -1,20 +1,20 @@
|
|
|
1
1
|
# @intentic/sdk
|
|
2
2
|
|
|
3
|
-
The **authoring surface** a user writes their `deploy.config.ts` against. A declaration uses `i.have.host` / `i.have.cloudflare` (the inventory you have) and `i.want.app` (what you want), wiring each app to its host/Cloudflare via `on` / `expose`. The split is lifecycle ownership, not requirements: intentic never creates or destroys a have, and owns a want end-to-end (create, reconcile, prune, destroy); requirements are the input fields, and may point at haves and wants alike. The support stack each app needs (git+CI, deploy orchestrator, runner, tunnel, routes) is *derived* by the resolvers
|
|
3
|
+
The **authoring surface** a user writes their `deploy.config.ts` against. A declaration uses `i.have.host` / `i.have.cloudflare` (the inventory you have) and `i.want.app` (what you want), wiring each app to its host/Cloudflare via `on` / `expose`. The split is lifecycle ownership, not requirements: intentic never creates or destroys a have, and owns a want end-to-end (create, reconcile, prune, destroy); requirements are the input fields, and may point at haves and wants alike. The support stack each app needs (git+CI, deploy orchestrator, runner, tunnel, routes) is *derived* by the resolvers, authors never name it. Depends on [`@intentic/graph`](../graph), [`@intentic/need-resolver`](../need-resolver), and [`@intentic/state-resolver`](../state-resolver).
|
|
4
4
|
|
|
5
5
|
## Responsibilities
|
|
6
6
|
|
|
7
7
|
- Provide the fluent `i.have.*` / `i.want.*` builders and capture them into an `IntentSet`.
|
|
8
|
-
- `defineIntent
|
|
9
|
-
- `defineStack
|
|
8
|
+
- `defineIntent`, the authoring entry: declaration → `IntentSet` (what `intentic deploy resolve` consumes).
|
|
9
|
+
- `defineStack`, one-shot convenience: declaration → a single compiled `DesiredStateGraph`.
|
|
10
10
|
- Export the handle types (`Host`, `Cloudflare`, `App`, `Repo`, `Deployment`, …) used to wire declarations.
|
|
11
11
|
|
|
12
12
|
## Key files
|
|
13
13
|
|
|
14
|
-
- [src/index.ts](src/index.ts)
|
|
15
|
-
- [src/handles.ts](src/handles.ts)
|
|
16
|
-
- [src/stack.ts](src/stack.ts)
|
|
17
|
-
- [src/\_\_fixtures\_\_](src/__fixtures__)
|
|
14
|
+
- [src/index.ts](src/index.ts): `defineIntent` / `defineStack` (public entry).
|
|
15
|
+
- [src/handles.ts](src/handles.ts): the `i.have`/`i.want` builders and handle types.
|
|
16
|
+
- [src/stack.ts](src/stack.ts): assembles the `IntentSet` and runs the resolver pipeline.
|
|
17
|
+
- [src/\_\_fixtures\_\_](src/__fixtures__): the canonical `deploy.config.ts` + expected graph (snapshot).
|
|
18
18
|
|
|
19
19
|
## How it fits
|
|
20
20
|
|
|
@@ -22,5 +22,5 @@ The front door of the pipeline. A `deploy.config.ts` imports this + `@intentic/g
|
|
|
22
22
|
|
|
23
23
|
## Conventions & gotchas
|
|
24
24
|
|
|
25
|
-
- Authors import `env` (secret refs) from its true source, [`@intentic/graph`](../graph)
|
|
25
|
+
- Authors import `env` (secret refs) from its true source, [`@intentic/graph`](../graph): **not** re-exported here.
|
|
26
26
|
- The fixtures are snapshot-tested ([src/index.test.ts](src/index.test.ts), [src/deploy.config.test.ts](src/deploy.config.test.ts)); changing builder output updates them. See [_tools/examples/deploy.config.ts](../../_tools/examples/deploy.config.ts) and [ARCHITECTURE.md](../../ARCHITECTURE.md).
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@intentic/sdk",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.226.0",
|
|
4
4
|
"description": "",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -31,10 +31,10 @@
|
|
|
31
31
|
},
|
|
32
32
|
"dependencies": {
|
|
33
33
|
"tslib": "2.8.1",
|
|
34
|
-
"@intentic/graph": "1.
|
|
35
|
-
"@intentic/
|
|
36
|
-
"@intentic/
|
|
37
|
-
"@intentic/state-resolver": "1.
|
|
34
|
+
"@intentic/graph": "1.226.0",
|
|
35
|
+
"@intentic/need-resolver": "1.226.0",
|
|
36
|
+
"@intentic/resources": "1.226.0",
|
|
37
|
+
"@intentic/state-resolver": "1.226.0"
|
|
38
38
|
},
|
|
39
39
|
"devDependencies": {
|
|
40
40
|
"@typescript/native-preview": "7.0.0-dev.20260707.2",
|