diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index c9f471f..d7c149a 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -73,6 +73,10 @@ Changesets can be published with:
npm run release:changesets
```
+The GitHub release workflow publishes with npm provenance enabled. The local
+`npm run publish:package` command does not force provenance, because npm only
+supports automatic provenance generation in supported CI providers.
+
## Packaging Notes
- The package publishes built files from `dist/`.
diff --git a/README.md b/README.md
index cbe1be4..65f12ac 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,23 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Reusable TypeScript type guards for narrowing `unknown` values in application and library code.
## Installation
@@ -157,6 +174,6 @@ npm run test:coverage
- `npm run changeset` creates a release note entry for a package change.
- `npm run release:version` applies pending changesets and updates the changelog.
-- `npm run release:changesets` runs the full verification stack, coverage, and then publishes through Changesets.
+- `npm run release:changesets` runs the full verification stack, coverage, and then publishes through Changesets. In GitHub Actions, this release path also publishes with provenance.
- `npm run publish:package` performs a direct npm publish with a dry-run pack check first.
- `.github/workflows/release.yml` is a manual `workflow_dispatch` workflow for optional release publishing.
diff --git a/package.json b/package.json
index 567a050..38cc6b4 100644
--- a/package.json
+++ b/package.json
@@ -82,7 +82,7 @@
"package:quality": "npm run check:publint && npm run check:types:package",
"prepack": "npm run clean && npm run build && npm run test:package && npm run typecheck",
"prepublishOnly": "npm run verify && npm run test:coverage",
- "publish:package": "npm pack --dry-run && npm publish --access public --provenance",
+ "publish:package": "npm pack --dry-run && npm publish --access public",
"release:changesets": "npm run verify && npm run test:coverage && changeset publish",
"release:version": "changeset version",
"test": "vitest run --root . src/__tests__/runtime.test.ts --pool=threads --fileParallelism=false",