@packtory/cli 0.0.37 → 0.0.39

package/packtory/packtory-changelog.js

@@ -1,19 +1,29 @@
+import path from 'node:path';
+import { compareValues } from "packtory/common/sort-values.js";
 const changelogFileName = 'CHANGELOG.md';
-const changelogFileSuffix = `/${changelogFileName}`;
-function changedPackagesFrom(packages) {
+function selectChangedPackages(packages) {
     return packages.filter((packagePlan) => {
         return packagePlan.changed;
     });
 }
-function changelogPathsFrom(packages) {
-    return Array.from(new Set(packages.flatMap((packagePlan) => {
-        return packagePlan.changelogSourceFiles.filter((filePath) => {
-            return filePath === changelogFileName || filePath.endsWith(changelogFileSuffix);
-        });
+function sortUniqueValues(values) {
+    return Array.from(values).toSorted(compareValues);
+}
+function isChangelogFilePath(filePath) {
+    return path.posix.basename(filePath) === changelogFileName;
+}
+function collectChangelogPaths(packages) {
+    return sortUniqueValues(new Set(packages.flatMap((packagePlan) => {
+        return packagePlan.changelogSourceFiles.filter(isChangelogFilePath);
     })));
 }
-async function baseRefFor(prLogEngine, packagePlan) {
-    if (packagePlan.previousVersion === undefined && packagePlan.previousGitHead === undefined) {
+function mergeIgnoredAttributionPaths(packages, configuredPaths) {
+    return sortUniqueValues(new Set([...collectChangelogPaths(packages), ...configuredPaths]));
+}
+async function resolveBaseRefFor(prLogEngine, packagePlan, input) {
+    if (input.explicitBaseRef === undefined &&
+        packagePlan.previousVersion === undefined &&
+        packagePlan.previousGitHead === undefined) {
         const baseRef = await prLogEngine.resolveLatestSemverChangelogBaseRef();
         return baseRef.ref;
     }
@@ -21,13 +31,13 @@ async function baseRefFor(prLogEngine, packagePlan) {
         packageName: packagePlan.name,
         previousVersion: packagePlan.previousVersion,
         previousGitHead: packagePlan.previousGitHead,
-        packageTagFormat: undefined,
-        explicitBaseRef: undefined
+        packageTagFormat: input.packageTagFormat,
+        explicitBaseRef: input.explicitBaseRef
     });
     return baseRef.ref;
 }
-async function targetPullRequestsFor(input, packagePlan, ignoredAttributionPaths) {
-    const baseRef = await baseRefFor(input.prLogEngine, packagePlan);
+async function collectTargetPullRequests(input, packagePlan, ignoredAttributionPaths) {
+    const baseRef = await resolveBaseRefFor(input.prLogEngine, packagePlan, input);
     const pullRequests = await input.prLogEngine.collectMergedPullRequests({
         githubRepo: input.githubRepo,
         baseRef
@@ -46,18 +56,19 @@ async function targetPullRequestsFor(input, packagePlan, ignoredAttributionPaths
     return input.prLogEngine.resolvePullRequestLabels({
         githubRepo: input.githubRepo,
         validLabels: input.validLabels,
+        ignoredLabels: [],
         pullRequests: packagePullRequests,
         targetName: packagePlan.name,
-        targetScopedLabelPattern: undefined
+        targetScopedLabelPattern: input.targetScopedLabelPattern
     });
 }
-async function changelogTargetFor(input, packagePlan, ignoredAttributionPaths) {
+async function createChangelogTarget(input, packagePlan, ignoredAttributionPaths) {
     return {
         packagePlan,
-        pullRequests: await targetPullRequestsFor(input, packagePlan, ignoredAttributionPaths)
+        pullRequests: await collectTargetPullRequests(input, packagePlan, ignoredAttributionPaths)
     };
 }
-function targetSectionFrom(target) {
+function createTargetSection(target) {
     return {
         targetName: target.packagePlan.name,
         unreleased: false,
@@ -65,18 +76,36 @@ function targetSectionFrom(target) {
         mergedPullRequests: target.pullRequests
     };
 }
-export async function generateChangelog(input) {
-    const packages = changedPackagesFrom(input.packages);
-    const ignoredAttributionPaths = changelogPathsFrom(packages);
+function createPackageMarkdownByName(input, targets) {
+    return new Map(targets.map((target) => {
+        const targetSection = createTargetSection(target);
+        return [
+            target.packagePlan.name,
+            input.prLogEngine.renderTargetChangelog({
+                packageInfo: input.packageInfo,
+                currentDate: input.currentDate,
+                validLabels: input.validLabels,
+                githubRepo: input.githubRepo,
+                ...targetSection
+            })
+        ];
+    }));
+}
+export async function generateChangelogOutputs(input) {
+    const packages = selectChangedPackages(input.packages);
+    const ignoredAttributionPaths = mergeIgnoredAttributionPaths(packages, input.ignoredAttributionPaths);
     const targets = await Promise.all(packages.map(async (packagePlan) => {
-        return changelogTargetFor(input, packagePlan, ignoredAttributionPaths);
+        return createChangelogTarget(input, packagePlan, ignoredAttributionPaths);
     }));
-    return input.prLogEngine.renderGroupedTargetChangelog({
-        packageInfo: input.packageInfo,
-        currentDate: input.currentDate,
-        validLabels: input.validLabels,
-        githubRepo: input.githubRepo,
-        targets: targets.map(targetSectionFrom)
-    });
+    return {
+        groupedMarkdown: input.prLogEngine.renderGroupedTargetChangelog({
+            packageInfo: input.packageInfo,
+            currentDate: input.currentDate,
+            validLabels: input.validLabels,
+            githubRepo: input.githubRepo,
+            targets: targets.map(createTargetSection)
+        }),
+        packageMarkdownByName: createPackageMarkdownByName(input, targets)
+    };
 }
 //# sourceMappingURL=packtory-changelog.js.map

package/packtory/packtory-changelog.js.map

@@ -1 +1 @@
-{"version":3,"file":"packtory-changelog.js","sourceRoot":"","sources":["../../../../source/packtory/packtory-changelog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"packtory-changelog.js","sourceRoot":"","sources":["../../../../source/packtory/packtory-changelog.ts"],"names":[],"mappings":"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"}

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.
 - **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.
+- **release:** Prints the next release plan by default, or runs one explicit release workflow when action flags and `--no-dry-run` are set.
 - **publish:** Bundles and publishes npm packages based on the configuration in `packtory.config.js`.
 - **pack:** Builds a single configured package and writes it to disk as a zip archive, tarball, or expanded folder. Intended for ad-hoc artifact use cases such as AWS Lambda deployments, container builds, or local inspection — `pack` never talks to a registry.
 
@@ -31,6 +32,12 @@ packtory <command> [options]
 - **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.
+- **release --write-changelog:** Writes configured changelog file outputs for packages in the release plan.
+- **release --commit:** Commits written changelog files. Requires `--write-changelog`.
+- **release --publish:** Publishes changed packages directly to npm. Staged publishing is not used by `release`.
+- **release --tag:** Creates one annotated tag per released package, named `{packageName}@{version}`.
+- **release --push:** Runs `git push --follow-tags`. Requires `--commit` or `--tag`.
+- **release --github-release:** Creates one GitHub Release per package tag. Requires `--tag --push`.
 - **pack &lt;package&gt; --format &lt;zip|tar|folder&gt; --out &lt;path&gt;:** Selects which package from the configuration to build and where to write it. `--format` and `--out` are required.
 - **pack --version &lt;version&gt;:** Stamps the produced manifest with the given version. Defaults to `0.0.0` when omitted, since `pack` is decoupled from the registry-driven automatic versioning used by `publish`.
 - **pack --vendor-dependencies:** Resolves every external (and bundle) dependency from the local `node_modules` and materializes them next to the package files inside the artifact. Use this for self-contained deployments where the runtime cannot run `npm install` (e.g. AWS Lambda zips). Without the flag, dependencies are recorded in the generated `package.json` only.
@@ -61,13 +68,32 @@ packtory <command> [options]
 
 **Changelog behavior:**
 
-- `packtory changelog` computes the same release plan used by Packtory's release planning API, skips unchanged packages, and prints one grouped Markdown changelog for packages that would publish a changed artifact.
-- Pull requests are attributed by comparing GitHub changed files against each package's attributed source files. Changelog files named `CHANGELOG.md` are ignored as attribution inputs.
+- `packtory changelog` computes the same release plan used by Packtory's release planning API and skips unchanged packages.
+- Without `changelog.outputs`, it prints one grouped Markdown changelog for packages that would publish a changed artifact.
+- `changelog.outputs` can write a grouped repository file with `{ kind: 'repository-file', path }`, write package-specific files below each changed package's effective `sourcesFolder` with `{ kind: 'package-file', path }`, write package-specific files to explicit repository-relative paths with `{ kind: 'package-file', paths }`, and print grouped release-body Markdown with `{ kind: 'github-release' }`.
+- `changelog.labels` extends or overrides the default pull request label mapping. `changelog.targetScopedLabelPattern` customizes package-specific labels and must contain `{targetName}` and `{label}`.
+- `changelog.packageTagFormat` customizes package tag lookup for changelog base refs. `changelog.explicitBaseRef` uses one fixed base ref instead.
+- Pull requests are attributed by comparing GitHub changed files against each package's attributed source files. Changelog files named `CHANGELOG.md` and configured generated changelog output paths are ignored as attribution inputs.
+- JavaScript files are attributed through referenced source maps when they have a `sourceMappingURL`. Without that reference, the JavaScript file itself is attributed.
 - The GitHub repository is read from the root `package.json` `repository` field.
 - GitHub API requests use `GH_TOKEN` when set, otherwise `GITHUB_TOKEN`.
-- Output is shown through `$PAGER` when possible, otherwise `less -R`, otherwise standard output.
+- Pager output is shown through `$PAGER` when possible, otherwise `less -R`, otherwise standard output.
+- Generated changelog files are not automatically added to package artifacts. Use `additionalFiles` when a package artifact should include a changelog.
 - `packtory changelog` exits with code `0` on a clean run and `1` on config, release-plan, Git, GitHub, or changelog generation failures. Partial release-plan failures still render succeeded changed packages when changelog generation succeeds.
-- `changelog` is read-only: it never writes changelog files, commits, tags, releases, deployments, registry data, or packages.
+- `changelog` never commits, tags, creates releases, creates deployments, writes registry data, or publishes packages.
+
+**Release behavior:**
+
+- `packtory release` prints the computed release plan and exits without writing.
+- Any action flag requires `--no-dry-run`.
+- Invalid combinations fail before writing: `--commit` requires `--write-changelog`; `--write-changelog --publish` requires `--commit`; `--push` requires `--commit` or `--tag`; `--github-release` requires `--tag --push`.
+- `--tag` requires `--publish` in the same run unless the registry latest `gitHead` already matches the current Git head. This allows retrying tag and GitHub Release creation after a publish succeeded.
+- Non-dry-run release writes require a clean Git index and worktree before the first write.
+- The write order is changelog files, commit, final release-plan recomputation, direct npm publish, annotated tags, `git push --follow-tags`, then GitHub Releases.
+- Existing package tags at the current head are accepted. Existing tags at another head fail.
+- Existing GitHub Releases for verified package tags are accepted and their notes are not rewritten.
+- Packtory uses inherited Git configuration, environment, and credentials. In CI, configure commit identity with standard variables such as `GIT_AUTHOR_NAME`, `GIT_AUTHOR_EMAIL`, `GIT_COMMITTER_NAME`, and `GIT_COMMITTER_EMAIL`, and configure push credentials outside Packtory.
+- GitHub Release creation reads `GH_TOKEN` first, then `GITHUB_TOKEN`.
 
 **Pack behavior:**
 

package/sbom.cdx.json

@@ -9,31 +9,57 @@
                 {
                     "type": "application",
                     "name": "packtory",
-                    "version": "0.0.36"
+                    "version": "0.0.38"
                 }
             ]
         },
         "component": {
             "type": "library",
             "name": "@packtory/cli",
-            "version": "0.0.37",
-            "bom-ref": "pkg:npm/@packtory/cli@0.0.37",
-            "purl": "pkg:npm/@packtory/cli@0.0.37"
+            "version": "0.0.39",
+            "bom-ref": "pkg:npm/@packtory/cli@0.0.39",
+            "purl": "pkg:npm/@packtory/cli@0.0.39"
         }
     },
     "components": [
+        {
+            "type": "library",
+            "name": "@octokit/core",
+            "version": "7.0.6",
+            "bom-ref": "pkg:npm/@octokit/core@7.0.6",
+            "scope": "required",
+            "licenses": [
+                {
+                    "expression": "MIT"
+                }
+            ],
+            "purl": "pkg:npm/@octokit/core@7.0.6"
+        },
         {
             "type": "library",
             "name": "@pr-log/core",
-            "version": "0.0.1",
-            "bom-ref": "pkg:npm/@pr-log/core@0.0.1",
+            "version": "0.0.2",
+            "bom-ref": "pkg:npm/@pr-log/core@0.0.2",
+            "scope": "required",
+            "licenses": [
+                {
+                    "expression": "MIT"
+                }
+            ],
+            "purl": "pkg:npm/@pr-log/core@0.0.2"
+        },
+        {
+            "type": "library",
+            "name": "@schema-hub/zod-error-formatter",
+            "version": "0.0.11",
+            "bom-ref": "pkg:npm/@schema-hub/zod-error-formatter@0.0.11",
             "scope": "required",
             "licenses": [
                 {
                     "expression": "MIT"
                 }
             ],
-            "purl": "pkg:npm/@pr-log/core@0.0.1"
+            "purl": "pkg:npm/@schema-hub/zod-error-formatter@0.0.11"
         },
         {
             "type": "library",
@@ -64,15 +90,15 @@
         {
             "type": "library",
             "name": "packtory",
-            "version": "0.0.37",
-            "bom-ref": "pkg:npm/packtory@0.0.37",
+            "version": "0.0.39",
+            "bom-ref": "pkg:npm/packtory@0.0.39",
             "scope": "required",
             "licenses": [
                 {
                     "expression": "MIT"
                 }
             ],
-            "purl": "pkg:npm/packtory@0.0.37"
+            "purl": "pkg:npm/packtory@0.0.39"
         },
         {
             "type": "library",
@@ -116,19 +142,27 @@
     ],
     "dependencies": [
         {
-            "ref": "pkg:npm/@packtory/cli@0.0.37",
+            "ref": "pkg:npm/@octokit/core@7.0.6"
+        },
+        {
+            "ref": "pkg:npm/@packtory/cli@0.0.39",
             "dependsOn": [
-                "pkg:npm/@pr-log/core@0.0.1",
+                "pkg:npm/@octokit/core@7.0.6",
+                "pkg:npm/@pr-log/core@0.0.2",
+                "pkg:npm/@schema-hub/zod-error-formatter@0.0.11",
                 "pkg:npm/cmd-ts@0.15.0",
                 "pkg:npm/open@11.0.0",
-                "pkg:npm/packtory@0.0.37",
+                "pkg:npm/packtory@0.0.39",
                 "pkg:npm/remeda@2.39.0",
                 "pkg:npm/ts-pattern@5.9.0",
                 "pkg:npm/yoctocolors@2.1.2"
             ]
         },
         {
-            "ref": "pkg:npm/@pr-log/core@0.0.1"
+            "ref": "pkg:npm/@pr-log/core@0.0.2"
+        },
+        {
+            "ref": "pkg:npm/@schema-hub/zod-error-formatter@0.0.11"
         },
         {
             "ref": "pkg:npm/cmd-ts@0.15.0"
@@ -137,7 +171,7 @@
             "ref": "pkg:npm/open@11.0.0"
         },
         {
-            "ref": "pkg:npm/packtory@0.0.37"
+            "ref": "pkg:npm/packtory@0.0.39"
         },
         {
             "ref": "pkg:npm/remeda@2.39.0"