sentinelayer-cli 0.32.1 → 0.32.2
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/README.md +17 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -929,6 +929,18 @@ Ledger contract:
|
|
|
929
929
|
- network access to Sentinelayer API/web
|
|
930
930
|
- optional: GitHub CLI (`gh`) authenticated for secret injection
|
|
931
931
|
|
|
932
|
+
## Operator and architecture references
|
|
933
|
+
|
|
934
|
+
- First-run engineering onboarding: `docs/ENGINEERING_ONBOARDING.md`
|
|
935
|
+
- Senti session operations, coordination, kill, and rollback conventions: `docs/sessions.md`
|
|
936
|
+
- Release workflow map and rollback drill ownership: `docs/workflow-matrix.md`
|
|
937
|
+
- Release rollback execution: `.github/workflows/rollback.yml` and `.github/scripts/release-rollback-readiness.sh`
|
|
938
|
+
- Architecture and decision records for major surfaces:
|
|
939
|
+
- Hosted MCP connector boundary: `docs/mcp-hosted-connector.md`
|
|
940
|
+
- MCP local/runtime entry points: `docs/mcp.md`
|
|
941
|
+
- Investor-DD architecture: `docs/INVESTOR_DD_ARCHITECTURE.md`
|
|
942
|
+
- CI/CD acknowledged release risks: `.github/policies/cicd-acknowledged-risks.md`
|
|
943
|
+
|
|
932
944
|
## Release to npm
|
|
933
945
|
|
|
934
946
|
This repo includes `.github/workflows/release.yml`.
|
|
@@ -949,14 +961,15 @@ Release flow:
|
|
|
949
961
|
|
|
950
962
|
1. Merge to `main` and let `Release Please` open/update the release PR.
|
|
951
963
|
2. Merge the release PR after Omar, Quality Gates, and Attestation are green.
|
|
952
|
-
3.
|
|
964
|
+
3. Wait for the main-branch `Release Please` workflow run on that merge commit to complete successfully.
|
|
965
|
+
4. From a clean checkout of the release commit, run the guarded release command:
|
|
953
966
|
```bash
|
|
954
967
|
git fetch origin main --tags
|
|
955
968
|
git checkout main && git pull --ff-only
|
|
956
969
|
npm run release:publish -- --tag v0.1.1 --notes-file release-notes.md
|
|
957
970
|
```
|
|
958
|
-
|
|
959
|
-
|
|
971
|
+
5. The guarded command confirms the exact release commit has one successful main `Release Please` run, creates the tag with `git tag -s`, verifies it with `git tag -v`, pushes it, confirms the remote GitHub tag object is annotated and cryptographically verified by an allowlisted signer, then creates the GitHub release with `gh release create --verify-tag`.
|
|
972
|
+
6. The tag push triggers `Release`, which re-verifies upstream checks, release artifact attestations, rollback readiness, protected `package-release` approval, and npm trusted publishing OIDC before publishing.
|
|
960
973
|
|
|
961
974
|
Do not run `gh release create v0.1.1` before pushing the signed tag. GitHub release creation creates a lightweight tag when the tag does not already exist, and the Release workflow intentionally fails closed for lightweight tags. If a remote tag already exists as a lightweight tag, `npm run release:publish` refuses to create the GitHub release.
|
|
962
975
|
|
|
@@ -964,6 +977,7 @@ Release publish now enforces tarball checksum-manifest validation and attestatio
|
|
|
964
977
|
|
|
965
978
|
Release guardrails now require successful upstream checks on the target commit:
|
|
966
979
|
|
|
980
|
+
- `Release Please`
|
|
967
981
|
- `Quality Summary`
|
|
968
982
|
- `Omar Gate`
|
|
969
983
|
- `Attestation Summary`
|