@packtory/cli 0.0.103 → 0.0.105

package/command-line-interface/runner/package-dependencies-handler.js

@@ -1,4 +1,5 @@
 import "packtory/packtory/packtory-results.js";
 import "../../report/terminal-renderer/terminal-package-dependencies-renderer.js";
+import "./package-inspection-handler.js";
 import "./terminal-error-chain.js";
 //# sourceMappingURL=package-dependencies-handler.js.map

package/command-line-interface/runner/package-dependencies-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"package-dependencies-handler.js","sourceRoot":"","sources":["../../../../../source/command-line-interface/runner/package-dependencies-handler.ts"],"names":[],"mappings":"AAAA,OAKO,uCAAoC,CAAC;AAE5C,OAEO,0EAA0E,CAAC;AAGlF,OAA0E,2BAA2B,CAAC"}
+{"version":3,"file":"package-dependencies-handler.js","sourceRoot":"","sources":["../../../../../source/command-line-interface/runner/package-dependencies-handler.ts"],"names":[],"mappings":"AAAA,OAKO,uCAAoC,CAAC;AAE5C,OAEO,0EAA0E,CAAC;AAGlF,OAA4C,iCAAiC,CAAC;AAC9E,OAA0E,2BAA2B,CAAC"}

package/command-line-interface/runner/package-inspection-handler.js

@@ -0,0 +1 @@
+//# sourceMappingURL=package-inspection-handler.js.map

package/command-line-interface/runner/package-inspection-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-inspection-handler.js","sourceRoot":"","sources":["../../../../../source/command-line-interface/runner/package-inspection-handler.ts"],"names":[],"mappings":""}

package/command-line-interface/runner/package-side-effects-handler.js

@@ -0,0 +1,6 @@
+import 'ts-pattern';
+import "packtory/packtory/packtory-results.js";
+import "../../report/terminal-renderer/terminal-package-side-effects-renderer.js";
+import "./package-inspection-handler.js";
+import "./terminal-error-chain.js";
+//# sourceMappingURL=package-side-effects-handler.js.map

package/command-line-interface/runner/package-side-effects-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-side-effects-handler.js","sourceRoot":"","sources":["../../../../../source/command-line-interface/runner/package-side-effects-handler.ts"],"names":[],"mappings":"AAAA,OAAsB,YAAY,CAAC;AACnC,OAKO,uCAAoC,CAAC;AAE5C,OAEO,0EAA0E,CAAC;AAGlF,OAA4C,iCAAiC,CAAC;AAC9E,OAA0E,2BAA2B,CAAC"}

package/command-line-interface/runner/runner.js

@@ -5,6 +5,7 @@ import "./command-parsing.js";
 import "./config-inspect-handler.js";
 import "./pack-handler.js";
 import "./package-dependencies-handler.js";
+import "./package-side-effects-handler.js";
 import "./package-tree-handler.js";
 import "./preview-handler.js";
 import "./release-diff-handler.js";

package/command-line-interface/runner/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../../../source/command-line-interface/runner/runner.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAC7G,OAWO,QAAQ,CAAC;AAOhB,OAAoC,wBAAwB,CAAC;AAC7D,OAAiC,sBAAsB,CAAC;AACxD,OAAwC,6BAA6B,CAAC;AACtE,OAA+B,mBAAmB,CAAC;AACnD,OAA8C,mCAAmC,CAAC;AAClF,OAAsC,2BAA2B,CAAC;AAClE,OAAkC,sBAAsB,CAAC;AACzD,OAAsC,2BAA2B,CAAC;AAElE,OAAkC,sBAAsB,CAAC;AACzD,OAA0C,sBAAsB,CAAC;AACjE,OAAkC,sBAAsB,CAAC;AAEzD,OAA6C,mCAAmC,CAAC;AACjF,OAA8D,2BAA2B,CAAC"}
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../../../source/command-line-interface/runner/runner.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAC7G,OAWO,QAAQ,CAAC;AAOhB,OAAoC,wBAAwB,CAAC;AAC7D,OAAiC,sBAAsB,CAAC;AACxD,OAAwC,6BAA6B,CAAC;AACtE,OAA+B,mBAAmB,CAAC;AACnD,OAA8C,mCAAmC,CAAC;AAClF,OAA6C,mCAAmC,CAAC;AACjF,OAAsC,2BAA2B,CAAC;AAClE,OAAkC,sBAAsB,CAAC;AACzD,OAAsC,2BAA2B,CAAC;AAElE,OAAkC,sBAAsB,CAAC;AACzD,OAA0C,sBAAsB,CAAC;AACjE,OAAkC,sBAAsB,CAAC;AAEzD,OAA6C,mCAAmC,CAAC;AACjF,OAA8D,2BAA2B,CAAC"}

package/package.json

@@ -17,8 +17,8 @@
         "cmd-ts": "0.15.0",
         "diff": "9.0.0",
         "open": "11.0.1",
-        "packtory": "0.0.92",
-        "remeda": "2.43.0",
+        "packtory": "0.0.94",
+        "remeda": "2.45.0",
         "semver": "7.8.5",
         "true-myth": "9.4.0",
         "ts-pattern": "5.9.0",
@@ -59,5 +59,5 @@
         "./packages/command-line-interface/spinner-worker.entry-point.js"
     ],
     "type": "module",
-    "version": "0.0.103"
+    "version": "0.0.105"
 }

package/readme.md

@@ -21,6 +21,7 @@ packtory <command> [options]
 - **preview:** Runs a fresh dry-run build with report collection enabled and shows a human-oriented preview of the emitted package contents, file statuses, and changed-file diffs.
 - **tree:** Builds locally and prints one configured package's artifact tree without reading the registry or writing an artifact.
 - **inspect dependencies:** Builds locally and prints why one configured package emits final `dependencies` and `peerDependencies`.
+- **inspect side-effects:** Builds locally and prints why one configured package emits, lists, or omits `package.json` `sideEffects`.
 - **release-diff:** Runs the same dry-run build as `preview` and shows, per package, the changes between the latest version currently published on the configured registry and the bundle the next run would publish.
 - **changelog:** Builds the next release plan, attributes merged GitHub pull requests to changed packages, and prints grouped Markdown changelog output.
 - **config inspect:** Validates `packtory.config.js` and prints a compact package-shape summary without building packages.
@@ -36,6 +37,7 @@ packtory <command> [options]
 - **preview --open:** Generates the same fresh preview report as `packtory preview`, writes a temporary HTML file, and opens it with the platform opener.
 - **tree &lt;package&gt;:** Selects which package from the configuration to inspect. The output includes package-relative paths, file kind, byte size, status, and artifact badges.
 - **inspect dependencies &lt;package&gt;:** Selects which package from the configuration to inspect. The output groups final manifest dependencies by `dependencies`, `peerDependencies`, and unresolved version state, then lists source import specifiers and emitted import specifiers for each dependency.
+- **inspect side-effects &lt;package&gt;:** Selects which package from the configuration to inspect. The output shows the generated `sideEffects` decision and every impure runtime file with line-level side effect reasons.
 - **publish --report-json:** Writes `packtory-report.json`, the machine-readable `BuildReport`.
 - **publish --report-html:** Writes `packtory-report.html`, the rich HTML report used by `packtory preview --open`.
 - **publish --stage:** Uses npm staged publishing instead of a direct publish. Successful runs print the npm `stageId` per package. Approval still happens later via `npm stage approve <stage-id>` or npmjs.com. Stage mode is npm-only, and the package must already exist on npm.
@@ -79,6 +81,15 @@ packtory <command> [options]
 - An unknown `<package>` argument is reported as `package-not-found`.
 - `packtory inspect dependencies` exits with code `0` on a clean run and `1` on config errors, package failures, or an unknown package.
 
+**Side effects inspect behavior:**
+
+- `packtory inspect side-effects <package>` validates the local config, resolves and links all configured packages, and prints why the selected package's generated manifest would emit `"sideEffects": false`, emit a file list, or omit the field.
+- It reports the analyzer's generated decision even when `additionalPackageJsonAttributes.sideEffects` overrides the generated value.
+- Runtime side effects are shown by package path, repository-relative source path, line number, and analyzer reason.
+- It does not read registry metadata, publish, write artifacts, run package checks, open HTML, or use a pager.
+- An unknown `<package>` argument is reported as `package-not-found`.
+- `packtory inspect side-effects` exits with code `0` on a clean run and `1` on config errors, package failures, or an unknown package.
+
 **Release-diff behavior:**
 
 ![packtory release-diff showing per-file hunks between the published latest and the next bundle](../../../documentation/release-diff-example.gif)
@@ -89,6 +100,7 @@ packtory <command> [options]
 - Packages that have never been published are rendered with a `[first publish]` chip and every bundled file in the **Added** group.
 - Packages whose new build is byte-equal to the published version are rendered as a single dim `no changes` line.
 - A package that fails earlier in the dry-run build appears in the document `Issues` section rather than as a per-package diff entry.
+- A package whose selected target version already exists with different artifacts, or exists without being tagged `latest`, appears in `Issues` before publish can start.
 - Previewable runs are shown through `$PAGER` when possible, otherwise `less -R`, otherwise standard output. Failure-only runs go directly to standard output.
 - `packtory release-diff` exits with code `0` on a clean run and `1` on config errors, check failures, or partial failures.
 - `release-diff` is read-only: it never publishes and never writes to the registry. It is currently terminal-only; an HTML/`--open` variant and an `--against <version>` selector are not part of this release.
@@ -154,8 +166,8 @@ packtory <command> [options]
 
 **Preview vs release-diff:**
 
-- **What question does each answer?** `preview` answers _"what would the next publish actually bundle, and what did packtory's linker/DCE change about my source on the way?"_. `release-diff` answers _"what's in this release that wasn't in the previously published one?"_.
-- **What is each comparing?** Both run the same fresh dry-run build. `preview` diffs **source on disk** against the **linker/DCE-processed artifacts**. `release-diff` diffs the **latest tarball on the registry** against the **bundle that next run would publish**.
+- **What question does each answer?** `preview` answers _"what would the next publish actually bundle, and what did packtory's linker and dead code elimination change about my source on the way?"_. `release-diff` answers _"what's in this release that wasn't in the previously published one?"_.
+- **What is each comparing?** Both run the same fresh dry-run build. `preview` diffs **source on disk** against the **artifacts processed by the linker and dead code elimination**. `release-diff` diffs the **latest tarball on the registry** against the **bundle that next run would publish**.
 - A careful release flow runs both: `preview` to validate that the bundle is what you intended to build, `release-diff` to validate that the change set against the last release is what you intended to ship.
 
 **Report outputs:**

package/report/terminal-renderer/terminal-package-side-effects-renderer.js

@@ -0,0 +1,2 @@
+import "./terminal-preview-renderer-shared.js";
+//# sourceMappingURL=terminal-package-side-effects-renderer.js.map

package/report/terminal-renderer/terminal-package-side-effects-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-package-side-effects-renderer.js","sourceRoot":"","sources":["../../../../../source/report/terminal-renderer/terminal-package-side-effects-renderer.ts"],"names":[],"mappings":"AAMA,OAA0C,uCAAuC,CAAC"}

package/sbom.cdx.json

@@ -9,16 +9,16 @@
                 {
                     "type": "application",
                     "name": "packtory",
-                    "version": "0.0.98"
+                    "version": "0.0.99"
                 }
             ]
         },
         "component": {
             "type": "library",
             "name": "@packtory/cli",
-            "version": "0.0.103",
-            "bom-ref": "pkg:npm/@packtory/cli@0.0.103",
-            "purl": "pkg:npm/@packtory/cli@0.0.103"
+            "version": "0.0.105",
+            "bom-ref": "pkg:npm/@packtory/cli@0.0.105",
+            "purl": "pkg:npm/@packtory/cli@0.0.105"
         }
     },
     "components": [
@@ -116,28 +116,28 @@
         {
             "type": "library",
             "name": "packtory",
-            "version": "0.0.92",
-            "bom-ref": "pkg:npm/packtory@0.0.92",
+            "version": "0.0.94",
+            "bom-ref": "pkg:npm/packtory@0.0.94",
             "scope": "required",
             "licenses": [
                 {
                     "expression": "MIT"
                 }
             ],
-            "purl": "pkg:npm/packtory@0.0.92"
+            "purl": "pkg:npm/packtory@0.0.94"
         },
         {
             "type": "library",
             "name": "remeda",
-            "version": "2.43.0",
-            "bom-ref": "pkg:npm/remeda@2.43.0",
+            "version": "2.45.0",
+            "bom-ref": "pkg:npm/remeda@2.45.0",
             "scope": "required",
             "licenses": [
                 {
                     "expression": "MIT"
                 }
             ],
-            "purl": "pkg:npm/remeda@2.43.0"
+            "purl": "pkg:npm/remeda@2.45.0"
         },
         {
             "type": "library",
@@ -216,7 +216,7 @@
             "ref": "pkg:npm/@octokit/plugin-rest-endpoint-methods@18.0.0"
         },
         {
-            "ref": "pkg:npm/@packtory/cli@0.0.103",
+            "ref": "pkg:npm/@packtory/cli@0.0.105",
             "dependsOn": [
                 "pkg:npm/@octokit/core@7.0.7",
                 "pkg:npm/@octokit/plugin-paginate-rest@15.0.0",
@@ -225,8 +225,8 @@
                 "pkg:npm/cmd-ts@0.15.0",
                 "pkg:npm/diff@9.0.0",
                 "pkg:npm/open@11.0.1",
-                "pkg:npm/packtory@0.0.92",
-                "pkg:npm/remeda@2.43.0",
+                "pkg:npm/packtory@0.0.94",
+                "pkg:npm/remeda@2.45.0",
                 "pkg:npm/semver@7.8.5",
                 "pkg:npm/true-myth@9.4.0",
                 "pkg:npm/ts-pattern@5.9.0",
@@ -247,10 +247,10 @@
             "ref": "pkg:npm/open@11.0.1"
         },
         {
-            "ref": "pkg:npm/packtory@0.0.92"
+            "ref": "pkg:npm/packtory@0.0.94"
         },
         {
-            "ref": "pkg:npm/remeda@2.43.0"
+            "ref": "pkg:npm/remeda@2.45.0"
         },
         {
             "ref": "pkg:npm/semver@7.8.5"