instar 0.9.19 → 0.9.20
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/package.json +1 -1
- package/upgrades/0.9.20.md +24 -0
package/package.json
CHANGED
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# Package Completeness Tests and .npmignore Cleanup
|
|
2
|
+
|
|
3
|
+
## What Changed
|
|
4
|
+
|
|
5
|
+
Added a comprehensive test suite (`tests/unit/package-completeness.test.ts`) that catches the category of bug where files needed at runtime are silently excluded from the published npm package. This is the class of issue that caused the setup-wizard skill to be missing for months.
|
|
6
|
+
|
|
7
|
+
The test suite includes 6 checks:
|
|
8
|
+
- **Runtime file reference scan**: Parses source code for `path.join(findInstarRoot(), ...)` patterns and verifies every referenced path exists in `npm pack` output
|
|
9
|
+
- **Required directories guard**: Maintains a known-good list of directories that must be in the `files` field
|
|
10
|
+
- **Critical file presence check**: Verifies specific files (setup-wizard skill, dashboard, package.json) are packed
|
|
11
|
+
- **Dead .npmignore detection**: Catches negation patterns in `.npmignore` that are overridden by the `files` whitelist
|
|
12
|
+
- **Upgrade guide validation**: Ensures all published guides have required sections and minimum length
|
|
13
|
+
|
|
14
|
+
Also cleaned up `.npmignore` to remove dead skill inclusion rules that gave a false impression of controlling what ships. Added a comment clarifying that `package.json` `files` is the sole authority.
|
|
15
|
+
|
|
16
|
+
## What to Tell Your User
|
|
17
|
+
|
|
18
|
+
Nothing visible has changed. This is internal test infrastructure that prevents a repeat of the setup wizard not shipping — the kind of silent degradation where you get a worse experience and nobody notices.
|
|
19
|
+
|
|
20
|
+
## Summary of New Capabilities
|
|
21
|
+
|
|
22
|
+
- **Package completeness test suite**: 6 automated tests that verify every runtime-referenced file ships in the npm package
|
|
23
|
+
- **`.npmignore` dead code cleanup**: Removed misleading include patterns, added comment clarifying `files` is the authority
|
|
24
|
+
- **Regression prevention**: The exact bug that caused setup-wizard to be missing would now fail 4 out of 6 tests with specific, actionable error messages
|