@fairgarden/distribution 0.1.0-alpha.1 → 0.1.0-alpha.3

package/dist/workflows.d.ts

@@ -8,6 +8,28 @@ import type { Files } from './scaffold.ts';
  * with a trusted publisher pointing at this repository and this file.
  */
 export declare const publishWorkflow: (packageName: string) => Files;
+/**
+ * The publishing workflow a distribution carries, for others to extend it.
+ *
+ * The same shape as a module's — a canary on every push to main, a release by
+ * hand — but checked out with its submodules, since `fg-dist canary` and
+ * `release --check` record every module's version, path, repository and
+ * commit in the manifest they publish. That is what an extension checks
+ * itself against and takes its own modules from.
+ */
+export declare const distributionWorkflow: (packageName: string) => Files;
+/**
+ * The pull request check that keeps a changelog current.
+ *
+ * Every pull request has to add a line linking itself under the version being
+ * worked on — or, in a distribution, every one that changes the
+ * organization's policy — so a release's notes are written, and committed,
+ * before it is released. A distribution is checked out with its submodules,
+ * without which its workspace does not install.
+ */
+export declare const changelogWorkflow: ({ submodules }: {
+    submodules: boolean;
+}) => Files;
 export interface WorkflowUpdate {
     relativePath: string;
     files: string[];
@@ -50,8 +72,31 @@ export declare const updateManifest: (moduleRoot: string, packageName: string, v
  * A module that already has one is left alone: it may have been changed on
  * purpose, and overwriting it would be the kind of help nobody asked for.
  */
-export declare const writeWorkflows: (root: string, { force, dryRun }?: {
+export declare const writeWorkflows: (root: string, { force, dryRun, names, }?: {
     force?: boolean;
     dryRun?: boolean;
+    /** Only these modules, by name or path; every one when empty. */
+    names?: string[];
 }) => Promise<WorkflowUpdate[]>;
+/**
+ * Give the distribution itself a publishing workflow, so others can extend it.
+ *
+ * Asked for rather than done by `writeWorkflows`: it makes the distribution
+ * public on npm, which a distribution only its owner deploys has no need to be.
+ * The tarball is the manifest and the organization's policy, which is what an
+ * extension builds its own on.
+ */
+export declare const writeDistributionWorkflow: (root: string, { force, dryRun }?: {
+    force?: boolean;
+    dryRun?: boolean;
+}) => Promise<WorkflowUpdate>;
+/**
+ * Give the distribution itself the changelog check, for pull requests that
+ * change the organization's policy — what else changes in it, fg-dist notes
+ * itself. Unlike its publishing, this makes nothing public.
+ */
+export declare const writeDistributionChangelogCheck: (root: string, { force, dryRun }?: {
+    force?: boolean;
+    dryRun?: boolean;
+}) => Promise<WorkflowUpdate>;
 //# sourceMappingURL=workflows.d.ts.map

package/dist/workflows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../src/workflows.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,aAAa,MAAM,KAAG,KAmLpD,CAAA;AAEF,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,+EAA+E;IAC/E,UAAU,EAAE,OAAO,CAAA;IACnB,8EAA8E;IAC9E,YAAY,EAAE,OAAO,CAAA;IACrB,qEAAqE;IACrE,aAAa,EAAE,OAAO,CAAA;CACvB;AA2BD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAQzE,CAAA;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,YAAY,EAAE,OAAO,CAAA;IACrB,aAAa,EAAE,OAAO,CAAA;CACvB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,YAAY,MAAM,EAClB,aAAa,MAAM,EACnB,SAAS,MAAM,GAAG,SAAS,EAC3B,gBAAgB,MAAM,GAAG,SAAS,EAClC,YAAkB;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,KACzC,OAAO,CAAC,cAAc,CA8DxB,CAAA;AAGD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,oBAAmC;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,KAC5E,OAAO,CAAC,cAAc,EAAE,CAiE1B,CAAA"}
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../src/workflows.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,aAAa,MAAM,KAAG,KA+MpD,CAAA;AAsCF;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAAI,aAAa,MAAM,KAAG,KAoHzD,CAAA;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAI,gBAAgB;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,KAAG,KAoD1E,CAAA;AAEF,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,+EAA+E;IAC/E,UAAU,EAAE,OAAO,CAAA;IACnB,8EAA8E;IAC9E,YAAY,EAAE,OAAO,CAAA;IACrB,qEAAqE;IACrE,aAAa,EAAE,OAAO,CAAA;CACvB;AA2BD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CASzE,CAAA;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,YAAY,EAAE,OAAO,CAAA;IACrB,aAAa,EAAE,OAAO,CAAA;CACvB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,YAAY,MAAM,EAClB,aAAa,MAAM,EACnB,SAAS,MAAM,GAAG,SAAS,EAC3B,gBAAgB,MAAM,GAAG,SAAS,EAClC,YAAkB;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,KACzC,OAAO,CAAC,cAAc,CAyExB,CAAA;AAGD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,4BAIG;IACD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CACZ,KACL,OAAO,CAAC,cAAc,EAAE,CA+D1B,CAAA;AAGD;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,GACpC,MAAM,MAAM,EACZ,oBAAmC;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,KAC5E,OAAO,CAAC,cAAc,CA4CxB,CAAA;AAeD;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,GAC1C,MAAM,MAAM,EACZ,oBAAmC;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,KAC5E,OAAO,CAAC,cAAc,CAgDxB,CAAA"}

package/dist/workflows.js

@@ -2,8 +2,10 @@ import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { existsSync } from 'node:fs';
 import { rm } from 'node:fs/promises';
 import path from 'node:path';
+import semver from 'semver';
 import { fileURLToPath } from 'node:url';
 import { submodules } from "./submodules.js";
+import { CHANGELOG, newChangelog } from "./changelog.js";
 /**
  * The publishing workflow a module carries.
  *
@@ -99,6 +101,8 @@ jobs:
     permissions:
       contents: write # Required for pushing the tag and creating the release
       id-token: write # Required for provenance and trusted publishing
+      actions: write # Required to run open pull requests' changelog check again
+      pull-requests: read # Required to find them
     environment:
       name: npm-publish
     steps:
@@ -137,14 +141,29 @@ jobs:
         run: |
           git tag "\$TAG"
           git push origin "\$TAG"
-          gh release create "\$TAG" \\
-            --title "\$TAG" \\
-            --generate-notes \\
-            --verify-tag
+          # The notes are the changelog's section for this version, written as
+          # each pull request merged; GitHub's own where there is none.
+          if pnpm run --silent changelog notes > "\$RUNNER_TEMP/notes.md"; then
+            notes="--notes-file \$RUNNER_TEMP/notes.md"
+          else
+            notes="--generate-notes"
+          fi
+          gh release create "\$TAG" --title "\$TAG" \$notes --verify-tag
+
+      - name: Hold pull requests until the next version
+        if: inputs.dry-run != true
+        env:
+          GH_TOKEN: \${{ secrets.GITHUB_TOKEN }}
+        # Anything merged now would be noted under a version already out. Each
+        # open pull request's changelog check runs again, sees the release and
+        # refuses it — until \`fg-dist release\` starts the next version and the
+        # branch catches up with it.
+        run: pnpm run changelog hold
 
       - name: Summary
         run: |
           echo "Published \\\`${packageName}@\${{ steps.version.outputs.version }}\\\` to the \\\`\${{ inputs.dist-tag }}\\\` tag." >> "\$GITHUB_STEP_SUMMARY"
+          echo "Pull requests are held until the next version starts: run \\\`fg-dist release\\\` and merge what it opens." >> "\$GITHUB_STEP_SUMMARY"
 `,
     '.github/actions/publish-prepare/action.yml': `name: Prepare for publishing
 description: Install dependencies and build, so the package is ready to publish.
@@ -170,7 +189,18 @@ runs:
         node-version: 22
         # No \`cache: pnpm\`: it needs a lockfile to hash, and a module developed
         # inside a distribution keeps its lockfile in the distribution.
-        registry-url: https://registry.npmjs.org
+        #
+        # No \`registry-url\` either. Given one, setup-node writes an .npmrc
+        # with \`_authToken=\${NODE_AUTH_TOKEN}\` and, with no token to put
+        # there, exports a placeholder. npm then publishes with that instead of
+        # exchanging the Actions OIDC token, and the registry answers
+        # \`E404 Not Found - PUT\`. Trusted publishing needs npm to find no
+        # credentials at all; npmjs.org is the default registry anyway.
+
+    # Trusted publishing needs npm 11.5.1 or later, which Node 22 does not ship.
+    - name: Update npm
+      shell: bash
+      run: npm install -g npm@^11.5.1
 
     - name: Install
       shell: bash
@@ -190,6 +220,227 @@ runs:
       run: pnpm run --if-present build
 `,
 });
+/** Steps both of a distribution's publishing jobs start with. */
+const distributionSetup = (release) => `      - name: Checkout
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+        with:
+          # What it publishes is read from its modules: their versions, and
+          # the commits it pins.
+          submodules: true${release
+    ? '\n          fetch-depth: 0 # `gh release create --generate-notes` needs history' +
+        '\n          # Kept, to push the tag and move main on.'
+    : '\n          persist-credentials: false'}
+
+      # No build: what a distribution publishes is its manifest and its
+      # policy, not its apps.
+      - uses: pnpm/action-setup@v4
+
+      # No \`registry-url\`, and npm new enough for trusted publishing: see
+      # .github/actions/publish-prepare in any module for why.
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Update npm
+        run: npm install -g npm@^11.5.1
+
+      - name: Install
+        run: pnpm install --frozen-lockfile
+
+      # Only where fg-dist is developed in this workspace, as a module of the
+      # distribution: then it is linked from its checkout, which is not built.
+      # Everywhere else it is installed from npm, and this matches nothing.
+      - name: Build fg-dist
+        run: pnpm --filter @fairgarden/distribution --include-workspace-root run --if-present build
+`;
+/**
+ * The publishing workflow a distribution carries, for others to extend it.
+ *
+ * The same shape as a module's — a canary on every push to main, a release by
+ * hand — but checked out with its submodules, since `fg-dist canary` and
+ * `release --check` record every module's version, path, repository and
+ * commit in the manifest they publish. That is what an extension checks
+ * itself against and takes its own modules from.
+ */
+export const distributionWorkflow = (packageName) => ({
+    '.github/workflows/publish.yml': `name: Publish
+
+# Publishes this distribution for others to extend. As for a module, npm
+# trusted publishing is configured against this one workflow file, and there is
+# no npm token: publish once from a workstation, then configure it on npmjs.com.
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+    inputs:
+      dist-tag:
+        description: 'npm dist tag to publish the release to'
+        required: false
+        type: string
+        default: 'latest'
+      dry-run:
+        description: 'Pack and validate without publishing'
+        required: false
+        type: boolean
+        default: false
+
+permissions: {}
+
+concurrency:
+  group: publish-\${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  canary:
+    name: Publish canary
+    if: github.event_name == 'push' && github.event.head_commit.author.name != 'renovate[bot]'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write # Required for provenance and trusted publishing
+    steps:
+${distributionSetup(false)}
+      - name: Stamp the canary version and what it ships
+        id: canary
+        run: pnpm run canary
+
+      - name: Publish to npm
+        if: steps.canary.outputs.skip != 'true'
+        run: |
+          if [ "\${{ steps.canary.outputs.provenance }}" = "true" ]; then
+            npm publish --tag canary --provenance
+          else
+            npm publish --tag canary
+          fi
+
+  release:
+    name: Publish release
+    if: github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write # Required for pushing the tag and creating the release
+      id-token: write # Required for provenance and trusted publishing
+      actions: write # Required to run open pull requests' changelog check again
+      pull-requests: read # Required to find them
+    environment:
+      name: npm-publish
+    steps:
+${distributionSetup(true)}
+      - name: Stamp what it ships
+        id: version
+        # Refuses when this version is on npm already, or names a month that
+        # is over: \`fg-dist release\` moves the distribution on.
+        run: pnpm run release:check
+
+      - name: Publish to npm
+        env:
+          DIST_TAG: \${{ inputs.dist-tag }}
+          PROVENANCE: \${{ steps.version.outputs.provenance }}
+          DRY_RUN: \${{ inputs.dry-run }}
+        run: |
+          flags="--tag \$DIST_TAG"
+          [ "\$PROVENANCE" = "true" ] && flags="\$flags --provenance"
+          [ "\$DRY_RUN" = "true" ] && flags="\$flags --dry-run"
+          npm publish \$flags
+
+      - name: Tag and create the GitHub release
+        if: inputs.dry-run != true
+        env:
+          GH_TOKEN: \${{ secrets.GITHUB_TOKEN }}
+          TAG: \${{ steps.version.outputs.tag }}
+        run: |
+          git tag "\$TAG"
+          git push origin "\$TAG"
+          # The changelog's section for this version: the modules it moved,
+          # and what changed in the organization's policy.
+          if pnpm run --silent changelog notes > "\$RUNNER_TEMP/notes.md"; then
+            notes="--notes-file \$RUNNER_TEMP/notes.md"
+          else
+            notes="--generate-notes"
+          fi
+          gh release create "\$TAG" --title "\$TAG" \$notes --verify-tag
+
+      - name: Hold pull requests until the next version
+        if: inputs.dry-run != true
+        env:
+          GH_TOKEN: \${{ secrets.GITHUB_TOKEN }}
+        # Anything merged now would be noted under a version already out. Each
+        # open pull request's changelog check runs again, sees the release and
+        # refuses it — until \`fg-dist release\` starts the next version and the
+        # branch catches up with it.
+        run: pnpm run changelog hold
+
+      - name: Summary
+        run: |
+          echo "Published \\\`${packageName}@\${{ steps.version.outputs.version }}\\\`." >> "\$GITHUB_STEP_SUMMARY"
+          echo "Pull requests are held until the next version starts: run \\\`fg-dist release\\\` and merge what it opens." >> "\$GITHUB_STEP_SUMMARY"
+`,
+    ...changelogWorkflow({ submodules: true }),
+});
+/**
+ * The pull request check that keeps a changelog current.
+ *
+ * Every pull request has to add a line linking itself under the version being
+ * worked on — or, in a distribution, every one that changes the
+ * organization's policy — so a release's notes are written, and committed,
+ * before it is released. A distribution is checked out with its submodules,
+ * without which its workspace does not install.
+ */
+export const changelogWorkflow = ({ submodules }) => ({
+    '.github/workflows/changelog.yml': `name: Changelog
+
+# Every pull request says what it changes in CHANGELOG.md, under the version
+# being worked on, with a link to itself — so that version's notes are written,
+# and committed, before it is released: whoever makes the change writes the
+# line, and review sees it with the change. Make this job a required status
+# check on main, or it only advises.
+#
+# A pull request that changes nothing anyone would read about — a lockfile
+# bump — is labelled "skip changelog".
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, labeled, unlabeled]
+
+permissions:
+  contents: read
+
+jobs:
+  changelog:
+    name: Changelog entry
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+        with:
+          persist-credentials: false
+          fetch-depth: 0 # to compare with what it merges into${submodules ? '\n          submodules: true # a distribution does not install without them' : ''}
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install
+        run: |
+          if [ -f pnpm-lock.yaml ]; then
+            pnpm install --frozen-lockfile
+          else
+            pnpm install --no-frozen-lockfile
+          fi
+
+      # Only where fg-dist is developed in this workspace — its own repository,
+      # where it is the root pnpm otherwise leaves out, or a distribution's.
+      - name: Build fg-dist
+        run: pnpm --filter @fairgarden/distribution --include-workspace-root run --if-present build
+
+      - name: Check for a line linking this pull request
+        run: pnpm run changelog check
+`,
+});
 const readManifest = async (root) => {
     try {
         return JSON.parse(await readFile(path.join(root, 'package.json'), 'utf8'));
@@ -225,6 +476,7 @@ export const releaseScripts = (packageName) => {
         canary: `${cli} canary`,
         release: `${cli} release`,
         'release:check': `${cli} release --check`,
+        changelog: `${cli} changelog`,
     };
 };
 /**
@@ -267,6 +519,17 @@ export const updateManifest = async (moduleRoot, packageName, version, packageMa
     if (packageName !== TOOL && !dependencies?.[TOOL] && !devDependencies?.[TOOL] && version) {
         updated.devDependencies = { ...devDependencies, [TOOL]: `^${version}` };
     }
+    // One that does is moved up to this version at least: the workflows written
+    // here call commands it has, and an older one — resolved from npm in the
+    // module's own CI — would not know them.
+    for (const key of ['dependencies', 'devDependencies']) {
+        const list = updated[key];
+        const range = list?.[TOOL];
+        const floor = range ? semver.minVersion(range, { loose: true }) : null;
+        if (packageName !== TOOL && version && floor && semver.lt(floor, version)) {
+            updated[key] = { ...list, [TOOL]: `^${version}` };
+        }
+    }
     const changed = JSON.stringify(updated) !== before;
     if (changed && write) {
         await writeFile(path.join(moduleRoot, 'package.json'), `${JSON.stringify(updated, null, 2)}\n`);
@@ -294,38 +557,38 @@ export const updateManifest = async (moduleRoot, packageName, version, packageMa
  * A module that already has one is left alone: it may have been changed on
  * purpose, and overwriting it would be the kind of help nobody asked for.
  */
-export const writeWorkflows = async (root, { force = false, dryRun = false } = {}) => {
+export const writeWorkflows = async (root, { force = false, dryRun = false, names = [], } = {}) => {
     const updates = [];
     // What the distribution builds with, which is what its modules are developed
     // against whether or not they say so themselves.
     const packageManager = (await readManifest(root))?.packageManager;
     const spec = typeof packageManager === 'string' ? packageManager : undefined;
     const tool = await toolVersion();
+    const unknown = names.filter((name) => !submodules(root).some((submodule) => submodule.name === name || submodule.relativePath === name));
+    if (unknown.length > 0)
+        throw new Error(`No such module: ${unknown.join(', ')}.`);
     for (const submodule of submodules(root)) {
+        if (names.length > 0 && !names.includes(submodule.name) && !names.includes(submodule.relativePath))
+            continue;
         const name = (await readManifest(submodule.path))?.name;
         if (typeof name !== 'string')
             continue;
-        const workflow = path.join(submodule.path, '.github/workflows/publish.yml');
-        if (existsSync(workflow) && !force) {
-            updates.push({
-                relativePath: submodule.relativePath,
-                files: [],
-                skipped: true,
-                unprivated: false,
-                missingFiles: false,
-                missingAccess: false,
-            });
-            continue;
-        }
+        // File by file: a module that publishes already still gets the changelog
+        // check it lacks, and what it has is only replaced when forced.
         const written = [];
-        for (const [relative, contents] of Object.entries(publishWorkflow(name))) {
+        const files = { ...publishWorkflow(name), ...changelogWorkflow({ submodules: false }) };
+        for (const [relative, contents] of Object.entries(files)) {
             const full = path.join(submodule.path, relative);
+            if (existsSync(full) && !force)
+                continue;
             if (!dryRun) {
                 await mkdir(path.dirname(full), { recursive: true });
                 await writeFile(full, contents);
             }
             written.push(relative);
         }
+        if (await startChangelog(submodule.path, dryRun))
+            written.push(CHANGELOG);
         // An earlier version of this command shipped the canary stamper as a file
         // in the module. It is a CLI command now, and a stale copy of it would go
         // on being the thing anyone reads.
@@ -347,7 +610,7 @@ export const writeWorkflows = async (root, { force = false, dryRun = false } = {
         updates.push({
             relativePath: submodule.relativePath,
             files: written.sort(),
-            skipped: false,
+            skipped: written.length === 0,
             unprivated: manifest.unprivated,
             missingFiles: manifest.missingFiles,
             missingAccess: manifest.missingAccess,
@@ -355,4 +618,122 @@ export const writeWorkflows = async (root, { force = false, dryRun = false } = {
     }
     return updates;
 };
+/**
+ * Give the distribution itself a publishing workflow, so others can extend it.
+ *
+ * Asked for rather than done by `writeWorkflows`: it makes the distribution
+ * public on npm, which a distribution only its owner deploys has no need to be.
+ * The tarball is the manifest and the organization's policy, which is what an
+ * extension builds its own on.
+ */
+export const writeDistributionWorkflow = async (root, { force = false, dryRun = false } = {}) => {
+    const manifest = await readManifest(root);
+    const name = manifest?.name;
+    if (typeof name !== 'string')
+        throw new Error('The distribution needs a name in package.json to publish.');
+    const relativePath = '.';
+    const workflow = path.join(root, '.github/workflows/publish.yml');
+    if (existsSync(workflow) && !force) {
+        return { relativePath, files: [], skipped: true, unprivated: false, missingFiles: false, missingAccess: false };
+    }
+    const written = [];
+    for (const [relative, contents] of Object.entries(distributionWorkflow(name))) {
+        if (!dryRun) {
+            await mkdir(path.dirname(path.join(root, relative)), { recursive: true });
+            await writeFile(path.join(root, relative), contents);
+        }
+        written.push(relative);
+    }
+    if (await startChangelog(root, dryRun))
+        written.push(CHANGELOG);
+    const packageManager = typeof manifest?.packageManager === 'string' ? manifest.packageManager : undefined;
+    const change = await updateManifest(root, name, await toolVersion(), packageManager, { write: !dryRun });
+    if (change.changed)
+        written.push('package.json');
+    // Its policy is what an extension layers its own on; nothing else is needed.
+    let missingFiles = change.missingFiles;
+    if (missingFiles) {
+        const updated = (await readManifest(root)) ?? {};
+        const files = existsSync(path.join(root, 'policies')) ? ['policies'] : [];
+        if (!dryRun)
+            await writeFile(path.join(root, 'package.json'), `${JSON.stringify({ ...updated, files }, null, 2)}\n`);
+        if (!written.includes('package.json'))
+            written.push('package.json');
+        missingFiles = false;
+    }
+    return {
+        relativePath,
+        files: written.sort(),
+        skipped: false,
+        unprivated: change.unprivated,
+        missingFiles,
+        missingAccess: change.missingAccess,
+    };
+};
+/**
+ * Start a repository's changelog at the version it carries, unless it keeps one
+ * already: a changelog is history, and is never written over.
+ */
+const startChangelog = async (root, dryRun) => {
+    const file = path.join(root, CHANGELOG);
+    if (existsSync(file))
+        return false;
+    const version = (await readManifest(root))?.version;
+    if (typeof version !== 'string')
+        return false;
+    if (!dryRun)
+        await writeFile(file, newChangelog(version));
+    return true;
+};
+/**
+ * Give the distribution itself the changelog check, for pull requests that
+ * change the organization's policy — what else changes in it, fg-dist notes
+ * itself. Unlike its publishing, this makes nothing public.
+ */
+export const writeDistributionChangelogCheck = async (root, { force = false, dryRun = false } = {}) => {
+    const written = [];
+    for (const [relative, contents] of Object.entries(changelogWorkflow({ submodules: true }))) {
+        const full = path.join(root, relative);
+        if (existsSync(full) && !force)
+            continue;
+        if (!dryRun) {
+            await mkdir(path.dirname(full), { recursive: true });
+            await writeFile(full, contents);
+        }
+        written.push(relative);
+    }
+    if (await startChangelog(root, dryRun))
+        written.push(CHANGELOG);
+    // The script the check runs, and the tool it runs — nothing that publishes.
+    const manifest = await readManifest(root);
+    if (manifest) {
+        const scripts = { ...manifest.scripts };
+        const dev = { ...manifest.devDependencies };
+        const deps = manifest.dependencies;
+        const tool = await toolVersion();
+        let changed = false;
+        if (!scripts.changelog) {
+            scripts.changelog = releaseScripts(String(manifest.name ?? '')).changelog;
+            changed = true;
+        }
+        if (!dev[TOOL] && !deps?.[TOOL] && tool) {
+            dev[TOOL] = `^${tool}`;
+            changed = true;
+        }
+        if (changed) {
+            if (!dryRun) {
+                await writeFile(path.join(root, 'package.json'), `${JSON.stringify({ ...manifest, scripts, devDependencies: dev }, null, 2)}\n`);
+            }
+            written.push('package.json');
+        }
+    }
+    return {
+        relativePath: '.',
+        files: written.sort(),
+        skipped: written.length === 0,
+        unprivated: false,
+        missingFiles: false,
+        missingAccess: false,
+    };
+};
 //# sourceMappingURL=workflows.js.map

package/dist/workflows.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../src/workflows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAA;AACrC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAG5C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,WAAmB,EAAS,EAAE,CAAC,CAAC;IAC9D,+BAA+B,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCA4ED,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAuDb,WAAW;CAC1C;IAEC,4CAA4C,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0C/C;CAEA,CAAC,CAAA;AAcF,MAAM,YAAY,GAAG,KAAK,EACxB,IAAY,EACkC,EAAE;IAChD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC,CAAA;AAED,oDAAoD;AACpD,MAAM,IAAI,GAAG,0BAA0B,CAAA;AAEvC;;;;;GAKG;AACH,MAAM,WAAW,GAAG,KAAK,IAAiC,EAAE;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IACzD,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IACrD,OAAO,OAAO,GAAG,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;AACnE,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,WAAmB,EAA0B,EAAE;IAC5E,sEAAsE;IACtE,MAAM,GAAG,GAAG,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAA;IACjE,OAAO;QACL,MAAM,EAAE,GAAG,GAAG,SAAS;QACvB,OAAO,EAAE,GAAG,GAAG,UAAU;QACzB,eAAe,EAAE,GAAG,GAAG,kBAAkB;KAC1C,CAAA;AACH,CAAC,CAAA;AASD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,UAAkB,EAClB,WAAmB,EACnB,OAA2B,EAC3B,cAAkC,EAClC,EAAE,KAAK,GAAG,IAAI,KAA0B,EAAE,EACjB,EAAE;IAC3B,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAA;IAC/C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAA;IACzF,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;IACvC,MAAM,OAAO,GAA4B,EAAE,GAAG,QAAQ,EAAE,CAAA;IAExD,6EAA6E;IAC7E,2BAA2B;IAC3B,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,KAAK,IAAI,CAAA;IAC3C,IAAI,UAAU;QAAE,OAAO,OAAO,CAAC,OAAO,CAAA;IAEtC,yEAAyE;IACzE,yDAAyD;IACzD,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,cAAc,EAAE,CAAC;QAC9C,OAAO,CAAC,cAAc,GAAG,cAAc,CAAA;IACzC,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,GAAI,OAAO,CAAC,OAA8C,EAAE,CAAA;IAC9E,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QAC1E,uEAAuE;QACvE,WAAW;QACX,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAA;IAC7C,CAAC;IACD,OAAO,CAAC,OAAO,GAAG,OAAO,CAAA;IAEzB,MAAM,YAAY,GAAG,OAAO,CAAC,YAAkD,CAAA;IAC/E,MAAM,eAAe,GAAG,OAAO,CAAC,eAAqD,CAAA;IAErF,6EAA6E;IAC7E,0EAA0E;IAC1E,IAAI,WAAW,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;QACzF,OAAO,CAAC,eAAe,GAAG,EAAE,GAAG,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,EAAE,CAAA;IACzE,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,MAAM,CAAA;IAClD,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;QACrB,MAAM,SAAS,CACb,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EACrC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CACxC,CAAA;IACH,CAAC;IAED,2EAA2E;IAC3E,6EAA6E;IAC7E,oDAAoD;IACpD,2EAA2E;IAC3E,uEAAuE;IACvE,2EAA2E;IAC3E,qEAAqE;IACrE,2EAA2E;IAC3E,qDAAqD;IACrD,OAAO;QACL,OAAO;QACP,UAAU;QACV,YAAY,EAAE,CAAC,OAAO,CAAC,KAAK;QAC5B,aAAa,EACX,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC;YAC1B,OAAO,CAAC,aAAkD,EAAE,MAAM,KAAK,SAAS;KACpF,CAAA;AACH,CAAC,CAAA;AAGD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,IAAY,EACZ,EAAE,KAAK,GAAG,KAAK,EAAE,MAAM,GAAG,KAAK,KAA4C,EAAE,EAClD,EAAE;IAC7B,MAAM,OAAO,GAAqB,EAAE,CAAA;IACpC,6EAA6E;IAC7E,iDAAiD;IACjD,MAAM,cAAc,GAAG,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,cAAc,CAAA;IACjE,MAAM,IAAI,GAAG,OAAO,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAA;IAC5E,MAAM,IAAI,GAAG,MAAM,WAAW,EAAE,CAAA;IAEhC,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,CAAC,MAAM,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAA;QACvD,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAQ;QAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,+BAA+B,CAAC,CAAA;QAC3E,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC;gBACX,YAAY,EAAE,SAAS,CAAC,YAAY;gBACpC,KAAK,EAAE,EAAE;gBACT,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,KAAK;gBACjB,YAAY,EAAE,KAAK;gBACnB,aAAa,EAAE,KAAK;aACrB,CAAC,CAAA;YACF,SAAQ;QACV,CAAC;QAED,MAAM,OAAO,GAAa,EAAE,CAAA;QAC5B,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACzE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;YAChD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;gBACpD,MAAM,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;YACjC,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACxB,CAAC;QAED,0EAA0E;QAC1E,0EAA0E;QAC1E,mCAAmC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,gCAAgC,CAAC,CAAA;QACzE,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,EAAE,CAAC,KAAK,CAAC,CAAA;gBACf,qEAAqE;gBACrE,iCAAiC;gBACjC,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YACrE,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAA;QAC1D,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;YACtE,KAAK,EAAE,CAAC,MAAM;SACf,CAAC,CAAA;QACF,IAAI,QAAQ,CAAC,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QAElD,OAAO,CAAC,IAAI,CAAC;YACX,YAAY,EAAE,SAAS,CAAC,YAAY;YACpC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE;YACrB,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,aAAa,EAAE,QAAQ,CAAC,aAAa;SACtC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}
+{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../src/workflows.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fairgarden/distribution",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.3",
   "description": "Compose versioned modules into a distribution, and extend one distribution from another",
   "repository": {
     "type": "git",
@@ -20,11 +20,21 @@
     }
   },
   "bin": {
-    "fg-dist": "./dist/cli.js"
+    "fg-dist": "dist/cli.js"
   },
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch --preserveWatchOutput",
+    "lint": "eslint",
+    "test": "node --test test/*.test.js",
+    "canary": "node dist/cli.js canary",
+    "release": "node dist/cli.js release",
+    "release:check": "node dist/cli.js release --check",
+    "changelog": "node dist/cli.js changelog"
+  },
   "dependencies": {
     "@babel/parser": "^7.29.9",
     "mdast-util-from-markdown": "^2.0.3",
@@ -39,13 +49,5 @@
     "eslint": "^9.39.5",
     "typescript": "^6.0.3"
   },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch --preserveWatchOutput",
-    "lint": "eslint",
-    "test": "node --test test/*.test.js",
-    "canary": "node dist/cli.js canary",
-    "release": "node dist/cli.js release",
-    "release:check": "node dist/cli.js release --check"
-  }
-}
+  "packageManager": "pnpm@10.28.0+sha512.05df71d1421f21399e053fde567cea34d446fa02c76571441bfc1c7956e98e363088982d940465fd34480d4d90a0668bc12362f8aa88000a64e83d0b0e47be48"
+}