create-caspian-app 0.2.0-beta.43 → 0.2.0-beta.44
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.
|
@@ -40,6 +40,13 @@
|
|
|
40
40
|
- Do not assume `StateManager` survives across requests unless `request.state.session` is explicitly bridged from `request.session`.
|
|
41
41
|
- Route, layout, and component HTML templates must keep a single top-level lowercase HTML element so Caspian can inject `pp-component`. Think React-style single parent wrapper: good one root containing the markup and any owned PulsePoint script, bad sibling top-level tags.
|
|
42
42
|
|
|
43
|
+
## BrowserSync URL Source Of Truth
|
|
44
|
+
|
|
45
|
+
- When AI needs to test or confirm whether a route, server response, or proxy-backed request is working, use `./settings/bs-config.json` as the source of truth for the current BrowserSync URLs.
|
|
46
|
+
- Do not assume the proxy stays on the default `http://localhost:5090`; if that port is busy, the active BrowserSync ports may change.
|
|
47
|
+
- Prefer confirming the current `local`, `external`, `ui`, and `uiExternal` values in `./settings/bs-config.json` before suggesting a test URL or opening the app in the browser.
|
|
48
|
+
- Use this file when frontend console errors or terminal output suggest the wrong local URL, proxy port, or BrowserSync UI port is being used during debugging.
|
|
49
|
+
|
|
43
50
|
## Path-Specific Rules
|
|
44
51
|
|
|
45
52
|
### `main.py`
|
package/dist/AGENTS.md
CHANGED
|
@@ -39,6 +39,17 @@ Treat `caspian.config.json` as the single source of truth for whether an optiona
|
|
|
39
39
|
|
|
40
40
|
When `.github/instructions/**/*.instructions.md` files exist, treat them as workspace-local instructions for specific third-party libraries, component kits, icon systems, integrations, and implementation rules. Read the matching instruction before deciding how to implement work on that surface, but do not let it override `caspian.config.json`, the project code, or the installed runtime.
|
|
41
41
|
|
|
42
|
+
## BrowserSync URL source of truth
|
|
43
|
+
|
|
44
|
+
When AI needs to test or confirm whether a page route, exposed function request, proxy-backed response, or local server workflow is working, check `./settings/bs-config.json` first.
|
|
45
|
+
|
|
46
|
+
Important rules:
|
|
47
|
+
|
|
48
|
+
- use `./settings/bs-config.json` as the source of truth for the active BrowserSync URLs in this app
|
|
49
|
+
- do **not** assume the proxy remains on the default `http://localhost:5090`; if that port is already in use, Caspian may use a different port
|
|
50
|
+
- confirm the current `local`, `external`, `ui`, and `uiExternal` values in `./settings/bs-config.json` before suggesting a browser URL, route test URL, or BrowserSync UI URL
|
|
51
|
+
- when frontend console logs, network errors, or terminal output suggest the app is being tested through the wrong URL or proxy port, re-check `./settings/bs-config.json` before changing app code
|
|
52
|
+
|
|
42
53
|
## Workspace Rules
|
|
43
54
|
|
|
44
55
|
- Local Caspian docs live under `node_modules/caspian-utils/dist/docs/`.
|