@camstack/develop 0.1.36 → 0.1.38

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/CHANGELOG.md ADDED
@@ -0,0 +1,30 @@
1
+ # Changelog
2
+
3
+ All notable changes to this package are documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [Unreleased]
9
+
10
+ ## [0.1.38] - 2026-10-27
11
+
12
+ ### Changed
13
+
14
+ - The addon skill documents the standard session-lost alert for cloud integrations
15
+
16
+ ## [0.1.37] - 2026-10-27
17
+
18
+ ### Added
19
+
20
+ - The published package now includes its README and CHANGELOG.
21
+
22
+ ### Changed
23
+
24
+ - The camstack-addon skill explains how to write a changelog entry with changelog:add.
25
+
26
+ ## [0.1.36] - 2026-10-27
27
+
28
+ ### Added
29
+
30
+ - CamStack Develop: CamStack developer tooling — catalogue, scaffold, validate, and example lookup shared by the CLI and MCP server.
package/README.md ADDED
@@ -0,0 +1,15 @@
1
+ # CamStack Develop
2
+
3
+ CamStack developer tooling — catalogue, scaffold, validate, and example lookup shared by the CLI and MCP server.
4
+
5
+ <!-- readme:generated:start (derived from the manifest; edit outside this block) -->
6
+
7
+ Package `@camstack/develop` on npm.
8
+
9
+ ## Requirements
10
+
11
+ - Node.js >=24.
12
+
13
+ See [CHANGELOG.md](./CHANGELOG.md) for what changed in each version.
14
+
15
+ <!-- readme:generated:end -->
@@ -1 +1 @@
1
- {"version":3,"file":"addon.d.ts","sourceRoot":"","sources":["../../src/scaffold/addon.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAa5E;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAwFhF"}
1
+ {"version":3,"file":"addon.d.ts","sourceRoot":"","sources":["../../src/scaffold/addon.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAa5E;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CA0FhF"}
@@ -37,6 +37,8 @@ export function scaffoldAddon(options) {
37
37
  };
38
38
  const files = [
39
39
  { relative: 'package.json', content: renderTemplate(PACKAGE_JSON, vars) },
40
+ { relative: 'README.md', content: renderTemplate(README_MD, vars) },
41
+ { relative: 'CHANGELOG.md', content: CHANGELOG_MD },
40
42
  { relative: 'tsconfig.json', content: renderTemplate(TSCONFIG, vars) },
41
43
  { relative: 'vite.config.ts', content: renderTemplate(VITE_CONFIG, vars) },
42
44
  { relative: 'src/index.ts', content: renderTemplate(INDEX_TS, vars) },
@@ -137,7 +139,9 @@ const PACKAGE_JSON = `{
137
139
  ]
138
140
  },
139
141
  "files": [
140
- "dist"
142
+ "dist",
143
+ "README.md",
144
+ "CHANGELOG.md"
141
145
  ],
142
146
  "scripts": {
143
147
  "build": "vite build",
@@ -158,6 +162,26 @@ const PACKAGE_JSON = `{
158
162
  }
159
163
  }
160
164
  `;
165
+ const README_MD = `# <%= displayName %>
166
+
167
+ <%= description %>
168
+
169
+ <!-- readme:generated:start (derived from the manifest; edit outside this block) -->
170
+ <!-- readme:generated:end -->
171
+ `;
172
+ const CHANGELOG_MD = `# Changelog
173
+
174
+ All notable changes to this package are documented in this file.
175
+
176
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
177
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
178
+
179
+ ## [Unreleased]
180
+
181
+ ### Added
182
+
183
+ - Initial release.
184
+ `;
161
185
  const TSCONFIG = `{
162
186
  "extends": "../../tsconfig.base.json",
163
187
  "compilerOptions": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/develop",
3
- "version": "0.1.36",
3
+ "version": "0.1.38",
4
4
  "description": "CamStack developer tooling — catalogue, scaffold, validate, and example lookup shared by the CLI and MCP server.",
5
5
  "keywords": [
6
6
  "camstack",
@@ -37,7 +37,9 @@
37
37
  },
38
38
  "files": [
39
39
  "dist",
40
- "skills"
40
+ "skills",
41
+ "README.md",
42
+ "CHANGELOG.md"
41
43
  ],
42
44
  "scripts": {
43
45
  "build": "tsc -p tsconfig.build.json",
@@ -97,6 +97,14 @@ Rules that bite:
97
97
  - **Secrets** — any password, token or key field, `secretStatePaths`, a
98
98
  credential for a spawned child: the `camstack-secrets` skill. Never read a
99
99
  credential from the environment.
100
+ - **An addon that keeps a cloud session reports it, it does not alert by hand.**
101
+ Create an `IntegrationSessionReporter` (`@camstack/types`) with a `classify(err)`
102
+ that returns a `SessionLossReason` only when the cloud ended OUR session
103
+ (kicked, token refused, sign-in rejected) and `null` for network and per-device
104
+ errors; `bind()` it in `onInitialize`, call `failure(id, err)` / `ok(id)` from
105
+ the manager and the devices, `forget(id)` for a vanished integration and
106
+ `unbind()` on shutdown. One debounced alert per integration, resolved by the
107
+ next `ok` (D953).
100
108
 
101
109
  ## 3. Wire it — the four places, one of which is silent
102
110
 
@@ -179,6 +187,22 @@ rest (sessions entry, an ADR for a rejected alternative, a package
179
187
  `docs/addons/addon-provider-reolink.md`) follows the `camstack-docs`
180
188
  ladder. `npm run docs:check` fails on a dead path.
181
189
 
190
+ **README and CHANGELOG.** Every published package carries both, and both are
191
+ in `files`. The README's derived block (what it provides, settings, placement,
192
+ requirements, docs) is written by `npm run readme:generate` from the manifest;
193
+ write the paragraph at the top by hand and run the command again after a
194
+ manifest change. A change to the package adds one line to the CHANGELOG:
195
+
196
+ ```bash
197
+ npm run changelog:add -- <package> "<what changed for the operator>" --type fixed
198
+ ```
199
+
200
+ One line, English, from the operator's side ("Cameras reconnect after a hub
201
+ restart", not "refactor reconnect loop"). `--type` is `added`, `changed`,
202
+ `fixed` or `removed`. The line lands under `## [Unreleased]`; the publish moves
203
+ it under the new version. A publish of a changed package with no entry fails
204
+ (`scripts/check-changelog-unreleased.ts`) and prints this command.
205
+
182
206
  ## 7. Ship it — and prove the new code is the code running
183
207
 
184
208
  An addon runs from its DEPLOYED copy under `<dataDir>/addons/@camstack/<name>/`