Skip to content

chore: merge develop into main - #580

Merged
MaksymStoianov merged 51 commits into
mainfrom
develop
Nov 17, 2026
Merged

MaksymStoianov merged 51 commits into
mainfrom
develop

Conversation

@MaksymStoianov

Copy link
Copy Markdown
Member

Brings develop to main (49 commits), including breaking changes:

  • refactor!: rename the package to @bootgs/utils
  • fix(package)!: add exports and fully specified ESM specifiers
  • fix(sheet): schema stored under bootgs-utils:schema, the old key is still read
  • fix(json), fix(docs), fix(build) and more
  • CI: pull request checks, least-privilege release with npm publish and SBOM, Dependabot, OpenSSF Scorecard, REUSE, CodeQL on pull requests to develop, signed release assets
  • docs: NOTICE, SPDX headers, README in 19 languages under docs/readme, ordered badges

After this merge release-please opens a release PR on main with a major version (breaking changes). Before that release PR is merged:

  • the first publish of the new name @bootgs/utils is done by hand (npm publish), then a trusted publisher is added on npmjs.com for release-please.yml, environment npm; otherwise the publish job fails;
  • release-please-config.json still uses the component apps-script-utils, so the tag would be apps-script-utils-v3.0.0 — decide the tag format first.

🤖 Generated with Claude Code

MaksymStoianov and others added 30 commits September 24, 2026 02:24
The tracker classifies issues with Kind/* and Priority/* labels, but the
three issue templates still applied GitHub's default bug, enhancement and
documentation labels, and AGENTS.md told agents to do the same. The
templates now apply Kind/Bug, Kind/Feature and Kind/Documentation, and
the example in AGENTS.md names the same scheme.

Closes #562

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…oard

Section 2 only said that every change gets an issue and a commit closes
it. It now also states what a complete issue carries — a Kind/* and a
Priority/* label, a milestone chosen by the kind of change, the
maintainer as assignee and a card on the project board — and how that
card moves: Todo when filed, In progress when the branch starts, In
review when the pull request opens, Done when the issue closes.

Closes #564

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Add AI-assisted translations of README.md into eight languages, each with
a note naming the source version and pointing to the English README as
authoritative. Add an identical language switcher under the banner of
every README. Ukrainian, Russian, German and French link to their own
documentation sites; the others link to the English documentation.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Add scripts/check-readme-translations.mjs, run by hand with
npm run docs:check-i18n. It fails when a README translation is missing,
lacks the language switcher, has a different number of ##/### headings
than README.md, or its translation note names a version other than the
one in package.json. Document in CONTRIBUTING.md how translations are
kept in step, and that the version note is updated when translations
are synced rather than on every release.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The repository moved from MaksymStoianov to the bootgs organisation and
the docs site to bootgs.github.io (the old GitHub Pages address returns
404). Repository, issue, discussion, source and docs links are updated in
README files, docs, JSDoc @see links, docs generators and package.json;
CHANGELOG history is left as is (GitHub redirects those links).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The repository moved to bootgs/utils and the docs site to
bootgs.github.io/utils. The npm package becomes @bootgs/utils, in line
with the @bootgs scope of the ecosystem; apps-script-utils will be
deprecated in favour of it after the first release.

- package.json/package-lock name, release-please package-name (tag
  component kept as apps-script-utils so release-please finds 2.1.1);
- import specifiers, install commands, npm badges and links, product
  name in README files, docs (5 languages) and the docs generators;
- the developer-metadata key apps-script-utils:schema is unchanged: it
  is stored in users' spreadsheets.

BREAKING CHANGE: install and import the package as @bootgs/utils.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…the old key

insertSchema writes the schema to developer metadata under
bootgs-utils:schema. getSchema and removeSchema also accept the key used
by apps-script-utils 2.x and older (apps-script-utils:schema), the
current key winning when both exist, and insertSchema removes the old
entry when it writes, so existing spreadsheets migrate on their own.
LEGACY_SCHEMA_METADATA_KEYS lists the old keys.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
refactor!: rename to @bootgs/utils; README translations; links after the move
fix(sheet): store the schema under bootgs-utils:schema, keep reading the old key
chore: apply the Kind/* labels from the templates and document the issue workflow
The package was renamed, but config/tsconfig.docs.json still mapped the
old name, so `npm run type:check` failed on every documentation snippet.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
Type-check, lint, format check, tests with coverage, build, generated
docs and README translation checks, production dependency audit and a
production licence allow-list. Adds the test:cov script.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
Permissions are declared per job. Restores the trusted-publishing job for
@bootgs/utils (repository bootgs/utils, environment npm) and attaches a
CycloneDX SBOM of the production tree to each release. Actions are pinned
by commit SHA.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
The workflow token is read-only; only the deploy job gets contents,
pages and id-token write. Every action is pinned by commit SHA and
checkouts no longer persist credentials.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
Dependabot updates npm and GitHub Actions weekly against develop.
Scorecard runs weekly and on pushes to main, uploading SARIF to code
scanning.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
A double quote inside a single-quoted string was copied into the
double-quoted result unescaped, and an escaped single quote kept a
backslash JSON does not accept, so such input threw. Quoted keys no
longer lose their inner quotes either. Fixes CodeQL
js/incomplete-sanitization alerts 7 and 8.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
escapeCell escapes backslashes before pipes, and the translated reference
tables use it too. The link fix-up in sync-jsdoc-links compares the
literal URL instead of building a regexp from it. Generated output is
unchanged. Fixes CodeQL alerts 12, 13 (js/incomplete-sanitization) and
17 (js/incomplete-hostname-regexp).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
package.json declares exports (types, import, default and
./package.json), and a post-build step, scripts/fix-esm-specifiers.mjs,
rewrites the relative specifiers in dist to ./x.js and ./x/index.js, so
the package loads in Node.js ESM without a bundler. The Apps Script
bundler maps those specifiers back; its output is byte-for-byte the same.

BREAKING CHANGE: only the package root and ./package.json can be
imported; deep imports such as @bootgs/utils/dist/... are no longer
resolvable.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
The maps referenced src/, which is not published, so every one of them
was broken. tsconfig.json no longer emits .js.map or .d.ts.map files;
the Apps Script bundle loses only the empty chunks of type-only modules.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
The runtime page named six service-bound functions; the library has
more (createFolder, getTriggerById, the slide lookups, the Admin SDK
guards, the locking writers). The table now lists each of them with the
global it calls and the scope that global needs, and a new section
recommends explicit oauthScopes in appsscript.json, with the narrow
*.currentonly scopes, when drive.file is and is not enough, and the
Admin SDK requirements. Updated in all five languages.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
2.0.0 listed getSlideIndex as both (slide, presentation?) and
(presentation, slide). The released signature is
getSlideIndex(slide, presentation?), with the slide first as in 1.x.
The breaking-change note now says so, and the entries for the
intermediate presentation-first order, reverted before the release,
are removed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
Records the copyright, the Apache-2.0 licence, the separate terms of the
banner artwork and the trademark notice. package.json now publishes it
next to dist.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
Every file under src/ starts with // SPDX-License-Identifier: Apache-2.0.
The line is not JSDoc, so the generated documentation is unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
Supported versions follow the rename: 3.x as @bootgs/utils once 3.0.0
is released, and security fixes for the 2.x line of apps-script-utils
for 3 months after that. Reports go through GitHub private
vulnerability reporting or security@maksymstoianov.com, with response
targets of 5 business days, 14 days and 30 days.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
CONTRIBUTING.md quotes the Developer Certificate of Origin 1.1 and
explains git commit -s. The dco workflow fails a pull request whose
commits lack a Signed-off-by trailer matching their author; bot commits
and merges are skipped.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
GOVERNANCE.md covers decisions, releases and continuity; MAINTAINERS.md
and .github/CODEOWNERS name the lead maintainer; SUPPORT.md gives the
support policy and tells 2.x users of apps-script-utils how to move to
@bootgs/utils 3.x.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
Replaces version 1.4 with the verbatim text of version 2.1; the
enforcement contact stays the same.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
docs/tools-and-ai.md describes how AI assistants are used and the rules
for them; docs/privacy.md states that the library makes no network
calls of its own and collects no data; TRADEMARKS.md adds guidance on
the Boot.gs and @bootgs names.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
npm audit fix moves vite to 8.3.5 and source-map-js and brace-expansion
to patched releases; vitest and @vitest/coverage-v8 go to 4.1.12. No
high or critical advisory is left. The remaining moderate ones come
from minimatch below 11 inside the eslint 9 toolchain, which has no fix
that eslint 9 accepts.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
An Arabic translation wraps its prose in <div dir="rtl"> blocks, so the
translation note may follow such a wrapper line instead of the switcher
directly. Headings inside the wrappers keep counting as before.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
MaksymStoianov and others added 20 commits November 3, 2026 17:25
ci: pull request checks, least-privilege workflows, pinned actions, npm publish with SBOM, Dependabot, Scorecard
… cs)

Translate the current README.md into Korean, Traditional Chinese (Taiwan),
Italian, Polish, Turkish, Dutch, Indonesian, Vietnamese, Arabic and Czech.
The switcher in every README now lists 19 languages, and the Simplified
Chinese entry is labelled 简体中文 next to 繁體中文. The Arabic README wraps
its prose in right-to-left blocks and keeps code, badges and the switcher
left to right.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
fix(json): re-quote single-quoted strings correctly in parseJson
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>

# Conflicts:
#	package.json
fix(package)!: exports map, fully specified ESM imports, no source maps in the package
docs: NOTICE, SPDX, security policy, DCO, governance, support and conduct
docs(runtime): complete function → service → OAuth scope table
chore(deps-dev): clear high-severity advisories in dev dependencies
docs(changelog): correct the getSlideIndex entries for 2.0.0
The 18 README translations move from the repository root to docs/readme/,
so the root keeps only README.md (English) next to the project files. The
language switcher in README.md now links docs/readme/README.<lang>.md;
inside docs/readme/ the translations link each other by file name and
English as ../../README.md, and every other relative link is rewritten to
resolve from the new folder.

npm always packs root README* files, so the published package shipped all
translations; after the move it carries only README.md.

check-readme-translations.mjs reads the translations from docs/readme/,
expects the new switcher links and fails on any relative link whose
target does not exist. CONTRIBUTING describes the new paths, the docs workflow no longer runs
for changes under docs/readme/, and a stale anchor in the README table of
contents is fixed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
REUSE.toml gives every file its copyright and licence (Apache-2.0); the
banner artwork, including its copies in docs/writerside*/images, keeps its
own terms as LicenseRef-Banner-Artwork, same as NOTICE and
docs/assets/images/README.md. LICENSES/ holds the texts. A new ci job runs
fsfe/reuse-action (pinned v6.0.0). README and its translations show the
OpenSSF Scorecard and REUSE status badges.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
ci: check REUSE compliance and show the Scorecard and REUSE badges
Keeps the moved translations in docs/readme and adds the OpenSSF Scorecard
and REUSE status badges from #577 to README.md and all 18 translations.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
docs: README translations into 10 more languages (19 in total), moved to docs/readme
Same four rows in README and every translation, in bootgs/boot and
bootgs/utils: status (CI, CodeQL, OpenSSF Scorecard, REUSE), package (npm
version, downloads, release, licence), project (clasp, security policy,
roadmap), social (stars, forks, sponsors).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
codeql.yml analyses JavaScript/TypeScript and Actions on every push and
pull request to main and develop and weekly; GitHub's default setup only
covered pull requests to main. The CodeQL badge links the new workflow.

The publish job packs the tarball once and publishes exactly that file;
the release job attaches it to the GitHub release together with its
Sigstore build provenance from actions/attest-build-provenance, next to
the SBOM.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
docs: order the README badges and add CI, CodeQL and npm badges
ci: CodeQL on develop pull requests and signed release assets
Brings the main-only commits of #565 into develop so develop can be merged
into main. develop's release-please.yml supersedes the main version (pinned
actions, @bootgs/utils, signed release assets), so it is kept as is.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Maksym Stoianov <stoianov.maksym@gmail.com>
@MaksymStoianov
MaksymStoianov merged commit 871d228 into main Nov 17, 2026
22 of 23 checks passed
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.

1 participant