@iwsdk/cli 1.1.0-rc.2 → 1.2.0-rc.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 +79 -2
- package/dist/agent-adapters.d.ts +12 -1
- package/dist/agent-adapters.d.ts.map +1 -1
- package/dist/agent-guidance/files/.agents/skills/iwsdk-build-model/SKILL.md +312 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-build-model/agents/openai.yaml +4 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-build-model/assets/hardsurface.ts.template +599 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-compose-scene/SKILL.md +277 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-compose-scene/agents/openai.yaml +4 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-compose-scene/references/environment-recipes.md +234 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-compose-scene/references/extended-workflow.md +166 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-compose-scene/references/image-intake.md +190 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-compose-scene/references/scene-composition.md +80 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-compose-scene/references/scene-format.md +466 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-compose-scene/references/scene-review.md +66 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-compose-scene/references/text-intake.md +80 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-debug/SKILL.md +74 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-depth-occlusion/SKILL.md +88 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-dev/SKILL.md +46 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-dev/references/api-reference.md +1531 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-dev/references/headless-rendering.md +82 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-dev/references/iterate.md +263 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-dev/references/planner.md +307 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-glasses-test/SKILL.md +282 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-grab/SKILL.md +75 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-hosting/SKILL.md +178 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-hosting/references/existing-hosts.md +181 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-hosting/references/vercel.md +114 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-native-xr-test/SKILL.md +262 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-physics/SKILL.md +106 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-physics/references/component-reference.md +152 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-physics/references/tuning-and-config.md +101 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-physics/references/workflows.md +303 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-pwa-packaging/SKILL.md +219 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-pwa-packaging/references/app-modes.md +104 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-pwa-packaging/references/bubblewrap.md +219 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-pwa-packaging/references/manifest-and-icons.md +149 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-pwa-packaging/references/store-upload.md +104 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-pwa-packaging/references/troubleshooting.md +178 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-ray/SKILL.md +70 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-ui/SKILL.md +328 -0
- package/dist/agent-guidance/files/.agents/skills/iwsdk-upgrade/SKILL.md +74 -0
- package/dist/agent-guidance/files/.claude/agents/iwsdk-project-code-reviewer.md +521 -0
- package/dist/agent-guidance/files/.claude/rules/assets-and-manifest.md +60 -0
- package/dist/agent-guidance/files/.claude/rules/ecs-api.md +103 -0
- package/dist/agent-guidance/files/.claude/rules/scene-json.md +72 -0
- package/dist/agent-guidance/files/.claude/rules/uikitml.md +66 -0
- package/dist/agent-guidance/files/.claude/settings.json +29 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-build-model/SKILL.md +312 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-build-model/agents/openai.yaml +4 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-build-model/assets/hardsurface.ts.template +599 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-compose-scene/SKILL.md +277 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-compose-scene/agents/openai.yaml +4 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-compose-scene/references/environment-recipes.md +234 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-compose-scene/references/extended-workflow.md +166 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-compose-scene/references/image-intake.md +190 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-compose-scene/references/scene-composition.md +80 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-compose-scene/references/scene-format.md +466 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-compose-scene/references/scene-review.md +66 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-compose-scene/references/text-intake.md +80 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-debug/SKILL.md +74 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-depth-occlusion/SKILL.md +88 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-dev/SKILL.md +46 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-dev/references/api-reference.md +1531 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-dev/references/headless-rendering.md +82 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-dev/references/iterate.md +263 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-dev/references/planner.md +307 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-glasses-test/SKILL.md +282 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-grab/SKILL.md +75 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-hosting/SKILL.md +178 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-hosting/references/existing-hosts.md +181 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-hosting/references/vercel.md +114 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-native-xr-test/SKILL.md +262 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-physics/SKILL.md +106 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-physics/references/component-reference.md +152 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-physics/references/tuning-and-config.md +101 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-physics/references/workflows.md +303 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-pwa-packaging/SKILL.md +219 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-pwa-packaging/references/app-modes.md +104 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-pwa-packaging/references/bubblewrap.md +219 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-pwa-packaging/references/manifest-and-icons.md +149 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-pwa-packaging/references/store-upload.md +104 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-pwa-packaging/references/troubleshooting.md +178 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-ray/SKILL.md +70 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-ui/SKILL.md +328 -0
- package/dist/agent-guidance/files/.claude/skills/iwsdk-upgrade/SKILL.md +74 -0
- package/dist/agent-guidance/files/.cursor/rules/assets-and-manifest.mdc +62 -0
- package/dist/agent-guidance/files/.cursor/rules/ecs-api.mdc +105 -0
- package/dist/agent-guidance/files/.cursor/rules/scene-json.mdc +74 -0
- package/dist/agent-guidance/files/.cursor/rules/uikitml.mdc +68 -0
- package/dist/agent-guidance/files/.github/instructions/assets-and-manifest.instructions.md +55 -0
- package/dist/agent-guidance/files/.github/instructions/ecs-api.instructions.md +101 -0
- package/dist/agent-guidance/files/.github/instructions/scene-json.instructions.md +71 -0
- package/dist/agent-guidance/files/.github/instructions/uikitml.instructions.md +65 -0
- package/{guidance → dist/agent-guidance/files}/AGENTS.md +107 -27
- package/dist/agent-guidance/files/CLAUDE.md +3 -0
- package/dist/agent-guidance/files/public/scenes/AGENTS.md +72 -0
- package/dist/agent-guidance/files/public/ui/AGENTS.md +66 -0
- package/dist/agent-guidance/files/src/AGENTS.md +153 -0
- package/dist/agent-guidance/manifest.json +854 -0
- package/dist/agent-guidance.d.ts +113 -0
- package/dist/agent-guidance.d.ts.map +1 -0
- package/dist/agent-guidance.js +3403 -0
- package/dist/agent-guidance.js.map +1 -0
- package/dist/cli.js +2407 -144
- package/dist/cli.js.map +1 -1
- package/dist/commands/adapter.d.ts +1 -0
- package/dist/commands/adapter.d.ts.map +1 -1
- package/dist/commands/agents.d.ts +11 -0
- package/dist/commands/agents.d.ts.map +1 -0
- package/dist/commands/browser.d.ts +11 -0
- package/dist/commands/browser.d.ts.map +1 -1
- package/dist/commands/dev.d.ts +1 -0
- package/dist/commands/dev.d.ts.map +1 -1
- package/dist/commands/reference.d.ts +15 -1
- package/dist/commands/reference.d.ts.map +1 -1
- package/dist/commands/runtime.d.ts.map +1 -1
- package/dist/commands/upgrade.d.ts +51 -0
- package/dist/commands/upgrade.d.ts.map +1 -0
- package/dist/contract.js +32 -0
- package/dist/contract.js.map +1 -1
- package/dist/guidance-refresh.d.ts +33 -0
- package/dist/guidance-refresh.d.ts.map +1 -0
- package/dist/help.d.ts +2 -0
- package/dist/help.d.ts.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4744 -135
- package/dist/index.js.map +1 -1
- package/dist/mcp-stdio.d.ts.map +1 -1
- package/dist/migrations/iwsdk-migrate-0-5/SKILL.md +413 -0
- package/dist/migrations.d.ts +36 -0
- package/dist/migrations.d.ts.map +1 -0
- package/dist/package-manager.d.ts +28 -0
- package/dist/package-manager.d.ts.map +1 -0
- package/dist/release-notes.d.ts +28 -0
- package/dist/release-notes.d.ts.map +1 -0
- package/dist/release-notes.json +1374 -0
- package/dist/runtime-contract.d.ts +8 -0
- package/dist/runtime-contract.d.ts.map +1 -1
- package/dist/runtime-telemetry.d.ts +8 -1
- package/dist/runtime-telemetry.d.ts.map +1 -1
- package/dist/version.d.ts +1 -1
- package/package.json +9 -3
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: iwsdk-depth-occlusion
|
|
3
|
+
description: Add or repair IWSDK WebXR depth sensing and real-world occlusion in AR. Use for DepthSensingSystem, DepthOccludable, occlusion modes, or passthrough depth troubleshooting.
|
|
4
|
+
argument-hint: '(use the current request)'
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# IWSDK Depth Occlusion
|
|
8
|
+
|
|
9
|
+
Depth occlusion has three independent requirements: the AR session requests
|
|
10
|
+
depth, one depth system is registered, and only intended virtual entities carry
|
|
11
|
+
`DepthOccludable`.
|
|
12
|
+
|
|
13
|
+
## Implement
|
|
14
|
+
|
|
15
|
+
1. Inspect `iwsdk.config.json`, `src/index.ts`, and the active scene in one
|
|
16
|
+
bounded pass, then make the complete config/system/scene edit before starting
|
|
17
|
+
the dev server. The contracts below are sufficient for the normal path: do
|
|
18
|
+
not call scene capabilities, CLI `--help`, inspect `node_modules`, or read
|
|
19
|
+
generated declarations unless a concrete build/runtime error remains.
|
|
20
|
+
2. Keep `world.xr.mode` as `"ar"`. Under `world.xr.features`, request:
|
|
21
|
+
|
|
22
|
+
```json
|
|
23
|
+
"depthSensing": {
|
|
24
|
+
"required": true,
|
|
25
|
+
"usage": "gpu-optimized",
|
|
26
|
+
"format": "float32"
|
|
27
|
+
}
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
Preserve other required AR features. Use the living-room emulator (or the
|
|
31
|
+
environment requested by the task) so runtime depth exists.
|
|
32
|
+
3. Import and register `DepthSensingSystem` exactly once after `World.create`:
|
|
33
|
+
|
|
34
|
+
```ts
|
|
35
|
+
world.registerSystem(DepthSensingSystem, {
|
|
36
|
+
configData: {
|
|
37
|
+
enableDepthTexture: true,
|
|
38
|
+
enableOcclusion: true,
|
|
39
|
+
useFloat32: true,
|
|
40
|
+
blurRadius: 20,
|
|
41
|
+
},
|
|
42
|
+
});
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
`DepthOccludable` is built in. Do not call `registerComponent` for it.
|
|
46
|
+
4. Add `DepthOccludable` only to the requested scene nodes. These scene payloads
|
|
47
|
+
are exact: `{}` means soft occlusion and `{ "mode": "HardOcclusion" }` means
|
|
48
|
+
sharp low-cost occlusion. Use `"MinMaxSoftOcclusion"` only when the task needs
|
|
49
|
+
the higher-quality path. Write the literal scene value directly; do not load
|
|
50
|
+
the scene-composer format reference, import `OcclusionShadersMode`, or inspect
|
|
51
|
+
its declaration to reconfirm it.
|
|
52
|
+
5. Leave a deliberate non-occludable reference object when comparison is part
|
|
53
|
+
of the request. Do not mark UI or guidance surfaces occludable by default.
|
|
54
|
+
|
|
55
|
+
## Verify
|
|
56
|
+
|
|
57
|
+
Run the production build once, start the AR app once, enter XR, and query the
|
|
58
|
+
named entities and registered systems. Check the console for missing
|
|
59
|
+
depth-sensing warnings. Capture one runtime screenshot in the configured room;
|
|
60
|
+
source inspection or an authored scene render alone cannot prove passthrough
|
|
61
|
+
occlusion. Make one focused correction if the measured runtime disagrees, then
|
|
62
|
+
stop. Do not repeatedly restart the emulator or tune blur from screenshots when
|
|
63
|
+
the session never exposed depth data.
|
|
64
|
+
|
|
65
|
+
Use one XR entry, one bounded entity/system query set, and one console check.
|
|
66
|
+
Save the final live screenshot but do not read it back when those runtime checks
|
|
67
|
+
already prove that depth was requested, the system is live, and the intended
|
|
68
|
+
entities carry the correct occlusion modes.
|
|
69
|
+
|
|
70
|
+
Use the CLI action names below; do not substitute MCP method names or probe
|
|
71
|
+
`--help` first:
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
npx @iwsdk/cli xr enter
|
|
75
|
+
npx @iwsdk/cli xr status
|
|
76
|
+
npx @iwsdk/cli ecs find --input-json '{"namePattern":"<requested node regex>"}'
|
|
77
|
+
npx @iwsdk/cli ecs query --input-json '{"entityIndex":<index from find>}'
|
|
78
|
+
npx @iwsdk/cli ecs systems
|
|
79
|
+
npx @iwsdk/cli browser logs --count 80
|
|
80
|
+
npx @iwsdk/cli browser screenshot --output-file artifacts/<name>.png
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
Use `npx @iwsdk/cli browser screenshot --output-file <path>` for file evidence. Do
|
|
84
|
+
not alter the project camera or render extra authored angles to manufacture an
|
|
85
|
+
occlusion view; stage the requested nodes once, then judge the live AR capture.
|
|
86
|
+
Do not inspect framework source when the build, registered-system query, entity
|
|
87
|
+
components, and console warnings already establish the failing layer.
|
|
88
|
+
<!-- iwsdk-agent-guidance version=1.2.0-rc.0 sha256=819e3f213766f12b567fa8ffd5e343f1a17f83973642067d82ebd7c5dee1dbe3 name=iwsdk-depth-occlusion (installed by IWSDK; `npx @iwsdk/cli@latest agents sync` refreshes it and leaves it alone once edited) -->
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: iwsdk-dev
|
|
3
|
+
description: Single entry point for IWSDK development. Invoke first for every IWSDK implementation request. Routes fresh builds to an internal planning playbook and bounded changes to an established app to an internal iteration playbook.
|
|
4
|
+
argument-hint: '[IWSDK development request]'
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# IWSDK Dev
|
|
8
|
+
|
|
9
|
+
Route the current request before inspecting files, planning, invoking a
|
|
10
|
+
specialist, or editing code. This file is only the entry point; after choosing,
|
|
11
|
+
load exactly one internal playbook and follow it for the rest of the task.
|
|
12
|
+
|
|
13
|
+
## Route
|
|
14
|
+
|
|
15
|
+
Choose the **iterate path** only when the workspace already contains an established
|
|
16
|
+
experience and the request asks to preserve that product while changing,
|
|
17
|
+
extending, fixing, tuning, or polishing a bounded part of it.
|
|
18
|
+
|
|
19
|
+
Choose the **planner path** for a fresh scaffold, a new experience, a replacement of
|
|
20
|
+
the current product loop, or a request whose implementation requires defining
|
|
21
|
+
the product rather than preserving it. A detailed acceptance contract does not
|
|
22
|
+
turn a greenfield build into an iteration.
|
|
23
|
+
|
|
24
|
+
Observable workspace state wins over wording:
|
|
25
|
+
|
|
26
|
+
- starter/demo files in a fresh generated scaffold are not an established user
|
|
27
|
+
product when the request asks to build a new named experience;
|
|
28
|
+
- an existing coherent scene/source/UI implementation that the request calls a
|
|
29
|
+
baseline, approved experience, or current app is an iteration;
|
|
30
|
+
- when the request replaces most of the loop, route to the planner even if files
|
|
31
|
+
already exist;
|
|
32
|
+
- explicit user selection of a child route overrides automatic routing.
|
|
33
|
+
|
|
34
|
+
## Internal handoff
|
|
35
|
+
|
|
36
|
+
1. State the selected route in one sentence.
|
|
37
|
+
2. Read exactly one internal playbook immediately:
|
|
38
|
+
- planner path: references/planner.md
|
|
39
|
+
- iterate path: references/iterate.md
|
|
40
|
+
3. Do not read project files, call Bash, create a plan, or invoke a specialist
|
|
41
|
+
between this router and the selected playbook.
|
|
42
|
+
4. Never load the other playbook later, including after context compaction.
|
|
43
|
+
|
|
44
|
+
iwsdk-dev does not add another implementation phase. The selected playbook owns
|
|
45
|
+
the work, evidence budget, specialist routing, verification, and stopping rule.
|
|
46
|
+
<!-- iwsdk-agent-guidance version=1.2.0-rc.0 sha256=07f4648993de9020eb6eee38c94ad442ac6b1ca8ede99e4d369de20e60e3af2f name=iwsdk-dev (installed by IWSDK; `npx @iwsdk/cli@latest agents sync` refreshes it and leaves it alone once edited) -->
|