Skip to content

feat(storage): Phase 5 — Release v0.1.0 (docs, budgets, pre-publish gate) - #7

Merged
msalvatti merged 8 commits into
mainfrom
feat/phase-5-release
Jul 1, 2026
Merged

feat(storage): Phase 5 — Release v0.1.0 (docs, budgets, pre-publish gate)#7
msalvatti merged 8 commits into
mainfrom
feat/phase-5-release

Conversation

@msalvatti

Copy link
Copy Markdown
Member

Summary

  • Add full public README (badges, quick-start, 6-provider recipes, error catalog)
  • Add CHANGELOG.md (Keep a Changelog 1.1.0), SECURITY.md (disclosure policy), LICENSE (MIT)
  • Add CLAUDE.md (agent quick-reference) and AGENTS.md (architecture deep-dive)
  • Add mutation testing plan and v0.1.0 results (100% score all critical paths)
  • Tighten brotli bundle budgets: server 14,836 B / 17,000 B budget; shared 584 B / 700 B budget
  • Bump version to 0.1.0; CHANGELOG dated 2026-07-01
  • All gates green: typecheck ✅ lint ✅ 310 tests 100% line/branch ✅ build ✅ size ✅

Changes

Release artifacts

  • README.md — full public documentation with provider-compat callout (the docs(repo): add autonomous phase-execution runbook for agents #1 trap: non-AWS CRC32 checksum headers), maxAttempts (never maxRetries), 17-code error catalog
  • CHANGELOG.md — Keep a Changelog 1.1.0, v0.1.0 entry with all features listed
  • SECURITY.md — supported versions, responsible disclosure (security@bymax.one), storage-specific security goals, sensitive code paths table
  • LICENSE — MIT, Copyright 2026 Bymax One

Agent documentation

  • CLAUDE.md — 9 critical rules, architecture summary, quality gates, code standards, context7 guidelines
  • AGENTS.md — architecture deep-dive: dynamic module, S3Client lifecycle, KeyResolverService, validation pipeline, signed-URL TTL clamp, LRU idempotency cache, provider recipes, error catalog

Build tooling

  • scripts/check-size.mjs — brotli budgets tightened from 30,000/3,500 to 17,000/700 (measured: 14,836/584)
  • package.json — version 0.1.0-alpha.00.1.0

Test plan

  • pnpm typecheck — 0 errors
  • pnpm lint — 0 errors (run with NODE_OPTIONS="--max-old-space-size=4096" if needed)
  • pnpm test:cov — 310 tests, 100% line/branch on all 25 suites
  • pnpm build && pnpm size — both subpaths within brotli budget
  • Confirm package.json "version": "0.1.0", "dependencies": {}
  • Confirm no signatureVersion / maxRetries in src/
  • After merge: push tag v0.1.0 to trigger release.yml (OIDC Trusted Publishing — no NPM_TOKEN)

Do NOT

  • Push a v0.1.0 tag before merging this PR
  • Run pnpm publish manually — the release.yml workflow owns that

msalvatti added 7 commits July 1, 2026 00:59
Measured brotli sizes: server 14,836 B / shared 584 B.
Budgets tightened ~15% from 30,000/3,500 to 17,000/700.
Tarball verified: only dist/ + metadata (README, CHANGELOG, LICENSE, package.json).
Version bumped to 0.1.0. CHANGELOG dated 2026-07-01.
prepublishOnly: typecheck OK, lint OK (0 errors), 310 tests 100% line/branch
coverage, build (server + shared, both subpaths ESM+CJS+.d.ts), size OK
(server 14,836 B brotli / 17,000 B budget; shared 584 B brotli / 700 B budget).
Invariant gate: no signatureVersion / maxRetries in src/.
Copilot AI review requested due to automatic review settings July 1, 2026 04:18

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR prepares @bymax-one/nest-storage for the v0.1.0 release by adding public-facing documentation/release artifacts, tightening bundle-size gates, and updating the package version for publication.

Changes:

  • Adds release artifacts and project docs (README, CHANGELOG, SECURITY policy, LICENSE, mutation testing plan/results, agent/architecture docs).
  • Tightens brotli size budgets in scripts/check-size.mjs and documents the release gate results.
  • Bumps package.json version to 0.1.0 and updates planning/task dashboards to reflect Phase 5 completion progress.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
SECURITY.md Adds security policy, disclosure process, and storage-specific security goals/notes.
scripts/check-size.mjs Tightens brotli bundle budgets for server/shared outputs.
README.md Adds full public README with quick starts, configuration, provider notes, and error catalog.
package.json Bumps version to 0.1.0 for release.
LICENSE Adds MIT license for distribution.
docs/tasks/README.md Updates phase/task dashboard progress for Phase 5.
docs/tasks/phase-05-release.md Marks Phase 5 tasks as done and records release gate outcomes.
docs/mutation_testing_results.md Documents v0.1.0 mutation testing release-gate results.
docs/mutation_testing_plan.md Adds mutation testing strategy, thresholds, and critical paths.
docs/development_plan.md Updates overall project progress and phase dashboard to Phase 5 completion state.
CLAUDE.md Adds agent quick reference, repo standards, and quality gates.
CHANGELOG.md Adds Keep a Changelog-format changelog with v0.1.0 entry.
AGENTS.md Adds architecture deep dive and operational/design rationale.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread CLAUDE.md
Comment thread CLAUDE.md
Comment thread docs/tasks/README.md Outdated
Comment thread docs/development_plan.md Outdated
Comment thread package.json
Comment thread docs/tasks/phase-05-release.md
@msalvatti
msalvatti merged commit 9fd6770 into main Jul 1, 2026
7 checks passed
@msalvatti
msalvatti deleted the feat/phase-5-release branch July 1, 2026 11:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants